org.idoox.wasp.server
Interface ServiceManager


Deprecated. See the new Runtime Publishing API (Registry).

public interface ServiceManager

Represents the service manager in the WSO2 SOA Enablement Server runtime. It is used by the administrator tools to display and manage service instances and endpoints, and by the deployment mechanism or anything else to register and remove service endpoints and service instances.

Since:
4.0
Component:
Core

Method Summary
 WSContext addService(java.lang.String path, java.lang.Class serviceClass)
          Deprecated. Registers new service endpoint and service instance using default configuration and activate it.
 WSContext addService(java.lang.String path, java.lang.Object svc)
          Deprecated. Registers new service endpoint and service instance using default configuration and activate it.
 WSContext addServiceEndpoint(WebServiceContext svcInstance, java.lang.String path)
          Deprecated. Registers new service endpoint using default configuration and activate it.
 WSContext addServiceEndpoint(WebServiceContext svcInstance, java.lang.String path, Definition wsdl, QName serviceQName)
          Deprecated. Registers new service endpoint using default configuration and activate it.
 WSContext addServiceEndpoint(WebServiceContext svcInstance, java.lang.String path, java.lang.String wsdlURI, QName serviceQName)
          Deprecated. Registers new service endpoint using default configuration and activate it.
 WebServiceContext addServiceInstance(java.lang.Class serviceClass)
          Deprecated. Registers new service instance.
 WebServiceContext addServiceInstance(java.lang.Object serviceObject)
          Deprecated. Registers new service instance.
 WSContext getServiceEndpoint(java.lang.String path)
          Deprecated. Returns context of the particular service endpoint specified by its URI.
 WSContext getServiceEndpoint(java.lang.String path, TransportMethod transportMethod)
          Deprecated. Returns a context of the particular service endpoint specified by its URI and particular HTTP method.
 WSContext[] getServiceEndpoints(java.lang.String name)
          Deprecated. Gets the service endpoints (represented by their respective WSContext instances) using a service instance name represented by the parameter name.
 WSContext[] getServiceEndpoints(WebServiceContext svc)
          Deprecated. Gets the service endpoints (represented by their respective WSContext instances) using a service instance represented by the parameter svc.
 java.lang.String[] getServiceEndpointsPaths(java.lang.String name)
          Deprecated. Gets the service endpoints (represented by their paths) using a service instance name represented by the parameter name.
 java.lang.String[] getServiceEndpointsPaths(WebServiceContext svc)
          Deprecated. Gets the service endpoints (represented by their paths) using a service instance represented by the parameter svc.
 WebServiceContext getServiceInstance(java.lang.String serviceName)
          Deprecated. Returns context of the particular service instance specified by its name.
 java.lang.String[] getServiceInstanceNames()
          Deprecated. Returns set of known service instances.
 void removeServiceEndpoint(java.lang.String servicePath)
          Deprecated. Removes service endpoint.
 void removeServiceEndpoint(WSContext serviceContext)
          Deprecated. Removes service endpoint.
 void removeServiceInstance(java.lang.String name)
          Deprecated. Unregisters service instance along with all services using it.
 void removeServiceInstance(WebServiceContext svc)
          Deprecated. Unregisters a service instance along with all srevices using it.
 

Method Detail

getServiceInstanceNames

public java.lang.String[] getServiceInstanceNames()
Deprecated. 
Returns set of known service instances. The returned array contains names of the services.

Returns:
array of service names

addServiceInstance

public WebServiceContext addServiceInstance(java.lang.Class serviceClass)
Deprecated. 
Registers new service instance. The new service instance will be in the stopped mode.

Parameters:
serviceClass - the Java class that shall be the service.
Returns:
the WebServiceContext of the new service instance

addServiceInstance

public WebServiceContext addServiceInstance(java.lang.Object serviceObject)
Deprecated. 
Registers new service instance. The new service instance will be in the stopped mode.

Parameters:
serviceObject - the Java object that shall be the service.
Returns:
the WebServiceContext of the new service instance

removeServiceInstance

public void removeServiceInstance(java.lang.String name)
                           throws ServiceInstanceNotFoundException
Deprecated. 
Unregisters service instance along with all services using it. The service, if it was registered by deployment, will stay deployed and after a server restart it will be registered again.

Parameters:
name - the name of the service instance to unregister
Throws:
ServiceInstanceNotFoundException - when no such service instance exists

removeServiceInstance

public void removeServiceInstance(WebServiceContext svc)
Deprecated. 
Unregisters a service instance along with all srevices using it. The service, if it was registered by deployment, will stay deployed and after a server restart it will be registered again.

Parameters:
svc - the WebServiceContext that represents the service instance

addServiceEndpoint

public WSContext addServiceEndpoint(WebServiceContext svcInstance,
                                    java.lang.String path)
                             throws InvalidEndpointPathException
Deprecated. 
Registers new service endpoint using default configuration and activate it.

Parameters:
svcInstance - the WebServiceContext representing the service instance for which the new service is being created
path - the path on which the service endpoint is to be located in the server, usually something like "/myService/" (note the leading slash - it has to be used in all endpoint paths except e-mail adresses)
Returns:
the WSContext of the new service
Throws:
InvalidEndpointPathException - when the service URI already exists or is not formatted properly

addServiceEndpoint

public WSContext addServiceEndpoint(WebServiceContext svcInstance,
                                    java.lang.String path,
                                    java.lang.String wsdlURI,
                                    QName serviceQName)
                             throws InvalidEndpointPathException,
                                    WSDLException
Deprecated. 
Registers new service endpoint using default configuration and activate it.

Parameters:
svcInstance - the WebServiceContext representing the service instance for which the new service is being created
path - the path on which the service endpoint is to be located in the server, usually something like "/myService/" (note the leading slash - it has to be used in all endpoint paths except e-mail adresses)
wsdlURI - URI of your WSDL
serviceQName - QName of service chosen from WSDL, if null then the first service is chosen. Something like new QName("http://systinet.com/test/", "JavaService").
Returns:
the WSContext of the new service
Throws:
InvalidEndpointPathException - when the service URI already exists or is not formatted properly
WSDLException

addServiceEndpoint

public WSContext addServiceEndpoint(WebServiceContext svcInstance,
                                    java.lang.String path,
                                    Definition wsdl,
                                    QName serviceQName)
                             throws InvalidEndpointPathException
Deprecated. 
Registers new service endpoint using default configuration and activate it.

Parameters:
svcInstance - the WebServiceContext representing the service instance for which the new service is being created
path - the path on which the service endpoint is to be located in the server, usually something like "/myService/" (note the leading slash - it has to be used in all endpoint paths except e-mail adresses)
wsdl - Definition representing your WSDL
serviceQName - QName of service chosen from WSDL, if null then the first service is chosen. Something like new QName("http://systinet.com/test/", "JavaService").
Returns:
the WSContext of the new service
Throws:
InvalidEndpointPathException - when the service URI already exists or is not formatted properly

removeServiceEndpoint

public void removeServiceEndpoint(WSContext serviceContext)
Deprecated. 
Removes service endpoint. Even if this was the last service endpoint using its service instance, the service instance is not removed.

Parameters:
serviceContext - service endpoint's WSContext instance

removeServiceEndpoint

public void removeServiceEndpoint(java.lang.String servicePath)
                           throws InvalidEndpointPathException
Deprecated. 
Removes service endpoint. Even if this was the last service endpoint using its service instance, the service instance is not removed.

Parameters:
servicePath - path of the Service Endpoint
Throws:
InvalidEndpointPathException - when the service URI does not exist

addService

public WSContext addService(java.lang.String path,
                            java.lang.Class serviceClass)
                     throws InvalidEndpointPathException
Deprecated. 
Registers new service endpoint and service instance using default configuration and activate it. This is a shortcut method for first adding a service instance and then a service endpoint for that instance and finally activating the service.

Parameters:
path - the path on which the service endpoint is to be located in the server, usually something like "/myService/" (note the leading slash - it has to be used in all endpoint paths except e-mail adresses)
serviceClass - the class whose instance shall represent the new service instance
Returns:
the WSContext of the new service
Throws:
InvalidEndpointPathException - when the service endpoint path already exists or is not formatted properly

addService

public WSContext addService(java.lang.String path,
                            java.lang.Object svc)
                     throws InvalidEndpointPathException
Deprecated. 
Registers new service endpoint and service instance using default configuration and activate it. This is a shortcut method for first adding a service instance and then a service endpoint for that instance and finally activating the service.

Parameters:
path - the path on which the service is to be located in the server, usually something like "/myService/" (note the leading slash - it has to be used in all endpoint paths except e-mail adresses)
svc - the object that represents the service instance
Returns:
the WSContext of the new service
Throws:
InvalidEndpointPathException - when the service URI already exists or is not formatted properly

getServiceInstance

public WebServiceContext getServiceInstance(java.lang.String serviceName)
                                     throws ServiceInstanceNotFoundException
Deprecated. 
Returns context of the particular service instance specified by its name.

Parameters:
serviceName - name of the service instance
Returns:
the context of the service instance
Throws:
ServiceInstanceNotFoundException - when no such service instance exists

getServiceEndpoint

public WSContext getServiceEndpoint(java.lang.String path)
                             throws InvalidEndpointPathException
Deprecated. 
Returns context of the particular service endpoint specified by its URI.

Parameters:
path - path of the service endpoint
Returns:
the context of the service endpoint
Throws:
InvalidEndpointPathException - when no such service endpoint path exists

getServiceEndpoint

public WSContext getServiceEndpoint(java.lang.String path,
                                    TransportMethod transportMethod)
                             throws InvalidEndpointPathException
Deprecated. 
Returns a context of the particular service endpoint specified by its URI and particular HTTP method.

Parameters:
path - path of the service endpoint
transportMethod - TransportMethod.GET or TransportMethod.POST
Returns:
the context of the service endpoint
Throws:
InvalidEndpointPathException - when no such service endpoint path exists

getServiceEndpoints

public WSContext[] getServiceEndpoints(WebServiceContext svc)
Deprecated. 
Gets the service endpoints (represented by their respective WSContext instances) using a service instance represented by the parameter svc.

Parameters:
svc - the service instance's WebServiceContext
Returns:
an array of the service endpoints' WSContexts

getServiceEndpointsPaths

public java.lang.String[] getServiceEndpointsPaths(WebServiceContext svc)
Deprecated. 
Gets the service endpoints (represented by their paths) using a service instance represented by the parameter svc.

Parameters:
svc - the service instance's WebServiceContext
Returns:
an array of the service endpoints' paths

getServiceEndpoints

public WSContext[] getServiceEndpoints(java.lang.String name)
                                throws ServiceInstanceNotFoundException
Deprecated. 
Gets the service endpoints (represented by their respective WSContext instances) using a service instance name represented by the parameter name.

Parameters:
name - the name identifying the service instance
Returns:
an array of the service endpoints' WSContexts
Throws:
ServiceInstanceNotFoundException - when no such service exists

getServiceEndpointsPaths

public java.lang.String[] getServiceEndpointsPaths(java.lang.String name)
                                            throws ServiceInstanceNotFoundException
Deprecated. 
Gets the service endpoints (represented by their paths) using a service instance name represented by the parameter name.

Parameters:
name - name identifying the service instance
Returns:
an array of the service endpoints' paths
Throws:
ServiceInstanceNotFoundException - when no such service exists