org.ow2.jonas.ws.jaxws
Interface IJAXWSService

All Superinterfaces:

Service

public interface IJAXWSService
extends Service

The JAX-WS Service is used to abstract endpoint (server side) and references (client side) creation. This interface needs to be implemented by any JAX-WS provider that we want to support in JOnAS. Warning, this interface is subject to changes.

Author:

Guillaume Sauthier

Field Summary

static String

KEY_WEB_SERVICES_METADATAS The key used to store the webservices related metadata in Context.

Method Summary

Reference	createNamingReference(org.ow2.util.ee.metadata.common.api.struct.IJaxwsWebServiceRef serviceRef) Construct a Reference dedicated to the given @WebServiceRef metadata.
IWebServiceEndpoint	createPOJOWebServiceEndpoint(org.ow2.util.ee.metadata.war.api.IWarClassMetadata metadata, ClassLoader loader, ServletContext servletContext) Creates a new POJO Web service endpoint from classes metadata.
void	finalizePOJODeployment(ServletContext context) Finalize the deployment of POJO endpoints contained in the given ServletContext.
SOAPHandler<SOAPMessageContext>	getClientAuditHandler()
SOAPHandler<SOAPMessageContext>	getEndpointAuditHandler()
void	undeployPOJOEndpoints(ServletContext context) Stop and undeploy the POJO endpoints contained in the given ServletContext.

Methods inherited from interface org.ow2.jonas.service.Service

getName, init, isStarted, setName, start, stop

Field Detail

KEY_WEB_SERVICES_METADATAS

static final String KEY_WEB_SERVICES_METADATAS

The key used to store the webservices related metadata in Context.

See Also:

Constant Field Values

Method Detail

createNamingReference

Reference createNamingReference(org.ow2.util.ee.metadata.common.api.struct.IJaxwsWebServiceRef serviceRef)
                                throws NamingException

Construct a Reference dedicated to the given @WebServiceRef metadata.

Parameters:

serviceRef - the reference described by the user.

Returns:

a JNDI Naming Reference that can be bound in a JNDI Context.

Throws:

NamingException

createPOJOWebServiceEndpoint

IWebServiceEndpoint createPOJOWebServiceEndpoint(org.ow2.util.ee.metadata.war.api.IWarClassMetadata metadata,
                                                 ClassLoader loader,
                                                 ServletContext servletContext)
                                                 throws WSException

Creates a new POJO Web service endpoint from classes metadata.

Parameters:

metadata - the class own metadata (annotation + XML)

loader - the ClassLoader to be used to load classes from the metadata

servletContext - the webapp ServletContext (used to locate web resource)

Returns:

A POJO typed IWebServiceEndpoint based on metadata

Throws:

WSException - if it was impossible to create the endpoint (CNFE, ...)

finalizePOJODeployment

void finalizePOJODeployment(ServletContext context)

Finalize the deployment of POJO endpoints contained in the given ServletContext.

Parameters:

context - ServletContext.

undeployPOJOEndpoints

void undeployPOJOEndpoints(ServletContext context)

Stop and undeploy the POJO endpoints contained in the given ServletContext.

Parameters:

context - ServletContext.

getClientAuditHandler

SOAPHandler<SOAPMessageContext> getClientAuditHandler()

getEndpointAuditHandler

SOAPHandler<SOAPMessageContext> getEndpointAuditHandler()