Red Hat Application Server, Manual

Page: 232 / 296

224 Chapter 29. Web Services with JOnAS
ß
!-- A list of SOAP actor definition that the Handler will play
as a role. A soap-role is a namespace URI. --
à
ß
soap-role
à
http://actor.soap.objectweb.org
ß
/soap-role
à
ß
!-- A list of port-name element defines the WSDL port-name
that a handler should be associated with. If no port-name is
specified, the handler is assumed to be associated with all ports
of the service-ref. --
à
ß
port-name
à
myWSDLPort
ß
/port-name
à
ß
/handler
à
ß
/service-ref
à
29.3.2. The jonas-service-ref Element
A jonas-service-ref must be specified for each service-ref declared in the standard Deployment De-
scriptor. The jonas-service-ref adds JOnAS-specific (and Web Service engine-specific) information to
service-ref elements.
Example of jonas-service-ref:
ß
jonas-service-ref
à
ß
!-- Define the service-ref contained in the component
deployment descriptor (web.xml, ejb-jar.xml, or
application-client.xml) used as a key to associate a
service-ref to its corresponding jonas-service-ref--
à
ß
service-ref-name
à
services/myService
ß
/service-ref-name
à
ß
!-- Define the physical name of the resource. --
à
ß
jndi-name
à
webservice_1
ß
/jndi-name
à
ß
!-- A list of init-param used for specific configuration of
the service --
à
ß
jonas-init-param
à
ß
param-name
à
param
ß
/param-name
à
ß
param-value
à
name
ß
/param-value
à
ß
/jonas-init-param
à
ß
/jonas-service-ref
à
29.4. WsGen
WsGen is a new JOnAS tool that works in the same way as GenIC. It takes an archive file (EJB-JAR,
WAR, JAR client, or EAR) and generates all the necessary Web Services files:
•
Creates vendor-specific Web Services deployment files for the server side and, when needed, the
client side (Axis will use its own WSDD format).
•
Creates a Web Application for each EJB-JAR exposing Web Service.
•
Generates and compiles client-side artifacts (Services and Port Bindings implementation classes).
For example, to provide an EJB-exposing method as a Web Service, a developer creates a
webservices.xml
file packaged in EJB-JAR’s META-INF directory. WsGen automatically creates
a configured Web Application (using an Axis servlet) and wraps it ( webapp) in an EAR file.
With a JaxRpc class, WsGen adds a servlet (an Axis servlet) inside the existing web deployment
descriptor and generates an Axis-specific configuration file.