org.ow2.jonas.ws.jaxws
Interface IWebServiceDeploymentManager

All Known Implementing Classes:

WSDeployment

public interface IWebServiceDeploymentManager

An IWebServiceDeploymentManager is an object that knows how to expose an IWebServiceEndpoint using some protocol. It is also responsible of its undeployment.
For example, a deployment manager that we will probably have to implement is a web container based deployment manager: It will know what to do with the given endpoint to expose it through HTTP (by using a Servlet or anything else that can intercept the request/response flow and invoke the endpoint).

Author:

Guillaume Sauthier

Method Summary

void	registerWSEndpoint(IWebServiceEndpoint endpoint) Add support for a given IWebServiceEndpoint (i.e.
void	unregisterWSEndpoint(IWebServiceEndpoint endpoint) Remove support for the given IWebServiceEndpoint.

Method Detail

registerWSEndpoint

void registerWSEndpoint(IWebServiceEndpoint endpoint)
                        throws WSException

Add support for a given IWebServiceEndpoint (i.e. deploy). POJO based web services deployment example:
As POJO web services are located inside a web-application (.war), a Context needs to be configured or updated to allow execution of the POJO web service.
For example, if a POJO webservice is declared using the WEB-INF/web.xml:

   <servlet>
     <servlet-name>My POJO WebService</servlet-name>
     <servlet-class>my.company.app.ServiceImplementationBean</servlet-class>
   </servlet>
 

Then the servlet element's value has to be replaced by a real Servlet implementation. Some other changes are probably needed but not described here as they are implementation specific.
EJB based web service deployment example:
The web service has to be deployed in a web container (servlet container), an implementation of this method will create a new Context for the endpoint and then will configure it.

Parameters:

endpoint - the IWebServiceEndpoint to deploy.

Throws:

WSException - if deployment fails or if the IWebServiceEndpoint is already registered.

unregisterWSEndpoint

void unregisterWSEndpoint(IWebServiceEndpoint endpoint)
                          throws WSException

Remove support for the given IWebServiceEndpoint. After a call to this method, the given IWebServiceEndpoint will not be accessible anymore.

Parameters:

endpoint - the IWebServiceEndpoint to undeploy.

Throws:

WSException - if undeployment fails or if the IWebServiceEndpoint is not registered.