Wsgen - Red Hat APPLICATION SERVER - JONAS Manual

224
!-- 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
a configured Web Application (using an Axis servlet) and wraps it (ejbjar + 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.
file packaged in EJB-JAR's META-INF directory. WsGen automatically creates
Chapter 29. Web Services with JOnAS