org.objectweb.jonas.ws
Interface WebServicesService

All Superinterfaces:

Service

All Known Implementing Classes:

AbsWebServicesServiceImpl

public interface WebServicesService

extends Service

WebServices Service interface.

Author:

Guillaume Sauthier

Field Summary

static java.lang.String	CLASSLOADER_CTX_PARAM classloader Context param
static java.lang.String	ISINEAR_CTX_PARAM isInEar Context Param
static java.lang.String	PARENT_OBJECTNAME_CTX_PARAM parentObjectName Context Param
static java.lang.String	WARURL_CTX_PARAM warURL Context Param

Method Summary

void	completeWSDeployment(javax.naming.Context ctx) Complete the WebServices Deployment (add informations in web environment)
void	deployWebServices(javax.naming.Context ctx) explore the context classloader to find Web service deployment descriptor (for endpoints) and service-ref element within standard deployment descriptor (for clients).
void	removeCache(java.lang.ClassLoader cl) Remove the WebServices descriptors associated to the given ClassLoader.
void	undeployWebServices(javax.naming.Context ctx) Undeploy the WebServices : unpublish WSDL + unregister MBeans

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

getName, init, isStarted, setName, start, stop

Field Detail

CLASSLOADER_CTX_PARAM

public static final java.lang.String CLASSLOADER_CTX_PARAM

classloader Context param

See Also:

Constant Field Values

PARENT_OBJECTNAME_CTX_PARAM

public static final java.lang.String PARENT_OBJECTNAME_CTX_PARAM

parentObjectName Context Param

See Also:

Constant Field Values

ISINEAR_CTX_PARAM

public static final java.lang.String ISINEAR_CTX_PARAM

isInEar Context Param

See Also:

Constant Field Values

WARURL_CTX_PARAM

public static final java.lang.String WARURL_CTX_PARAM

warURL Context Param

See Also:

Constant Field Values

Method Detail

deployWebServices

public void deployWebServices(javax.naming.Context ctx)
                       throws WSServiceException

explore the context classloader to find Web service deployment descriptor (for endpoints) and service-ref element within standard deployment descriptor (for clients). It registers each endpoints in WS engine publishing relative WSDLs, and it instanciates and binds in the registry each clients classes.

Parameters:

ctx - the context containing the configuration to deploy the wars.
This context contains the following parameters :
- jarUrls the list of the urls of the jars to deploy.
- warUrls the list of the urls of the wars to deploy.
- parentClassLoader the parent classLoader of the wars.
- earClassLoader the ear classLoader of the j2ee app.
- altDDs the optional URI of deployment descriptor.

Throws:

WSServiceException - if an error occurs during the deployment.

removeCache

public void removeCache(java.lang.ClassLoader cl)

Remove the WebServices descriptors associated to the given ClassLoader.

Parameters:

cl - the key ClassLoader

completeWSDeployment

public void completeWSDeployment(javax.naming.Context ctx)
                          throws WSServiceException

Complete the WebServices Deployment (add informations in web environment)

Parameters:

ctx - Context containing the key ClassLoader

Throws:

WSServiceException - When Endpoints URLs binding fails

undeployWebServices

public void undeployWebServices(javax.naming.Context ctx)
                         throws WSServiceException

Undeploy the WebServices : unpublish WSDL + unregister MBeans

Parameters:

ctx - Context containing undeployment informations

Throws:

WSServiceException - When undeployment fails