All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface oracle.soap.server.ProviderManager

public interface ProviderManager

Provider Manager defines the interface to manage providers. The provider manager is used by the SOAP engine to deploy providers, undeploy providers, and access provider deployment information. The provider manager may cache deployment information and is responsible to maintain the cache.

The HTTP server provides security for the provider manager. The provider manager can be configured with a URL that requests must be made to in order for the request to be accepted. If a SOAP request for the provider manager is made to any other URL, the request will be rejected. This URL should be an alias to the SOAP servlet, and HTTP security can be set to control which users can post to the URL.

Method Index

o deploy(ProviderDeploymentDescriptor)
Deploy the given provider.
o destroy()
Cleanup the provider manager.
o getRequiredRequestURI()
Get the URI that provider manager requests must be made to in order to be accepted.
o init(Properties)
Initialize the provider manager.
o list()
Get a list of provider ids for all providers that have been deployed.
o query(String)
Get the deployment descriptor for the given provider.
o setServiceManager(ServiceManager)
Make the service manager that is being used to manage service deployment information available to the provider manager.
o undeploy(String)
Undeploy the given provider, and return its descriptor.

Methods

o init 
 public abstract void init(Properties options) throws SOAPException
Initialize the provider manager.

Parameters:
options - The options required to setup access to the deployment information.
Throws: SOAPException
Unable to access the deployment information.
o destroy 
 public abstract void destroy() throws SOAPException
Cleanup the provider manager.

Throws: SOAPException
Unable to cleanup the provider manager.
o setServiceManager 
 public abstract void setServiceManager(ServiceManager serviceManager)
Make the service manager that is being used to manage service deployment information available to the provider manager. The provider manager may use the service manager to ensure that a provider is not undeployed as long as any services are deployed under that provider.

Parameters:
providerManager - The provider manager that is managing provider deployment information for the SOAP server.
o getRequiredRequestURI 
 public abstract String getRequiredRequestURI()
Get the URI that provider manager requests must be made to in order to be accepted. Requests made to any other URI must be rejected.

Returns:
The request URI for provider manager requests, or null if any URI can be used.
o undeploy 
 public abstract ProviderDeploymentDescriptor undeploy(String providerId) throws SOAPException
Undeploy the given provider, and return its descriptor.

Parameters:
providerId - The id of the provider to undeploy.
Returns:
The descriptor containing the deployment information for the provider that has been undeployed.
Throws: SOAPException
If the provider is not found or failed to undeploy.
o deploy 
 public abstract void deploy(ProviderDeploymentDescriptor pd) throws SOAPException
Deploy the given provider.

Parameters:
pd - The provider descriptor for the provider to deploy.
Throws: SOAPException
If unable to deploy.
o query 
 public abstract ProviderDeploymentDescriptor query(String providerId) throws SOAPException
Get the deployment descriptor for the given provider.

Parameters:
providerId - The id of the provider.
Returns:
The descriptor containing the deployment information for the given provider.
Throws: SOAPException
If the provider is not found.
o list 
 public abstract String[] list() throws SOAPException
Get a list of provider ids for all providers that have been deployed.

Returns:
An array of deployed provider ids.
Throws: SOAPException
Unable to list provider ids. 
All Packages  Class Hierarchy  This Package  Previous  Next  Index