Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

uk.org.ogsadai.service.wsrf.dataservice.impl
Class ConfigurableDataServiceImpl

java.lang.Object
  |
  +--uk.org.ogsadai.service.wsrf.dataservice.impl.DataServiceImpl
        |
        +--uk.org.ogsadai.service.wsrf.dataservice.impl.ConfigurableDataServiceImpl
All Implemented Interfaces:
DataServiceResourceFactory, SecurityContextProvider
public class ConfigurableDataServiceImpl
extends DataServiceImpl

This class provides an implementation of a service for interacting with data service resources. It is an extension of the data service class DataServiceImpl and offers operations to request the deployment or undeployment of data service resources.

For deployment, it is assumed that additional configuration files are placed server-side within a directory within the directory specified by the dai.config.files.root property held within the service deployment descriptor. This is done via some out-of-band means. The deployer then invokes the deploy operation passing the name of the data service resource. It is assumed that this name matches the local name of the directory within which the configuration files are located.

Author:
The OGSA-DAI Project Team
See Also:
ConfigurableDataServicePortType

Field Summary
private static java.lang.String COPYRIGHT_NOTICE
          Copyright statement
private static DAILogger LOG
          Logger object for logging in this class
 
Fields inherited from class uk.org.ogsadai.service.wsrf.dataservice.impl.DataServiceImpl
mResourceFactoryUtil, mResourceHome, mResourcesFile, mURL, RESOURCE_ATTR, RESOURCE_ELT
 
Constructor Summary
ConfigurableDataServiceImpl()
          Create a new configurable data service.
 
Method Summary
 DeployResponse deploy(Deploy deploy)
          Expose a new data service resource with a given ID.
 UndeployResponse undeploy(Undeploy deploy)
          Instruct the service to no longer expose the named data service resource.
 
Methods inherited from class uk.org.ogsadai.service.wsrf.dataservice.impl.DataServiceImpl
createResource, createResource, createResourceFromComponentFactory, createResourceFromComponents, createResourceFromConfigDirectory, getBlock, getDataServiceResource, getFully, getNBlocks, getNewResourceName, getNewResourceName, getResourceConfigDirectory, getResourceHome, getSecurityContext, getVersion, listResources, perform, putBlock, putFully, registerResourceWithMDS, removeResource, removeResource, terminate, throwAuthorisationFault, throwInternalFault, throwRequestFault, throwResourceUnknownFault
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

COPYRIGHT_NOTICE

private static final java.lang.String COPYRIGHT_NOTICE
Copyright statement

See Also:
Constant Field Values

LOG

private static DAILogger LOG
Logger object for logging in this class

Constructor Detail

ConfigurableDataServiceImpl

public ConfigurableDataServiceImpl()
                            throws InternalFaultType
Create a new configurable data service.

The new object will initialise itself using information within its deployment descriptor if it has not already done so.

Throws:
InternalFaultType - if some internal problem occurs that is not under the client's control.
See Also:
DataServiceImpl
Method Detail

deploy

public DeployResponse deploy(Deploy deploy)
                      throws java.rmi.RemoteException,
                             RequestFaultType,
                             InternalFaultType,
                             AuthorisationFaultType
Expose a new data service resource with a given ID.

Invocations of this operation are not assumed to be directed at a specific data service resource.

The data service resources file of the service is updated.

Parameters:
deploy - ID of the new resource to deploy. Assumed to also be the name of a directory within which the resource configuration files reside on the server. ID is wrapped within a bean.
Returns:
empty bean.
Throws:
java.rmi.RemoteException - never.
AuthorisationFaultType - if the client is not authorised to deploy the resource.
InternalFaultType - if some internal problem occurs that is not under the client's control.
RequestFaultType - if there is already a resource with the given ID or there is a problem with the configuration files for the new resource.
See Also:
ConfigurableDataServicePortType.deploy(uk.org.ogsadai.service.config.types.Deploy)

undeploy

public UndeployResponse undeploy(Undeploy deploy)
                          throws java.rmi.RemoteException,
                                 ResourceBusyFaultType,
                                 ResourceUnknownFaultType,
                                 InternalFaultType,
                                 AuthorisationFaultType
Instruct the service to no longer expose the named data service resource.

Invocations of this operation are not assumed to be directed at a specific data service resource.

The data service resource configuration files are not removed. The data service resources file of the service is updated.

Parameters:
deploy - ID of the resource to undeploy in a bean.
Returns:
empty bean.
Throws:
java.rmi.RemoteException - never.
ResourceUnknownFaultType - if the resource is unknown to this service.
AuthorisationFaultType - if the client is not authorised to undeploy the resource.
InternalFaultType - if some internal problem occurs that is not under the client's control.
ResourceBusyFaultType - if the resource is processing a request and so cannot be undeployed just yet.
See Also:
ConfigurableDataServicePortType.undeploy(uk.org.ogsadai.service.config.types.Undeploy)
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD