uk.ac.soton.itinnovation.grid.service.ogsadai.impl
Class OgsaDaiServiceImpl

java.lang.Object
  extended by uk.ac.soton.itinnovation.grid.service.utils.gridservit.GridServiceLite
      extended by uk.ac.soton.itinnovation.grid.service.ogsadai.impl.ManagedDataResource
          extended by uk.ac.soton.itinnovation.grid.service.ogsadai.impl.OgsaDaiServiceImpl
All Implemented Interfaces:
DataResource, DataResourceLocal, DataResourceManagement, DataResourceRole, DataResourceRoleLocal, DataResourceSubscription, DataResourceSubscriptionLocal, ManagedGridService, OgsaDaiDBI, OgsaDaiDBRoleI, OgsaDaiDBSubscriptionI, OgsaDaiResource, OgsaDaiRole, OgsaDaiService, OgsaDaiServiceI2, OgsaDaiServiceSOAP, OgsaDaiSubscription, ReportAPI, WebAdmin, WSResourceLifetime, GridService, IdentifiableResource, PolicyManagement, ResourceMetadata
Direct Known Subclasses:
OgsaDaiServiceI2Impl

public class OgsaDaiServiceImpl
extends ManagedDataResource
implements OgsaDaiServiceSOAP, OgsaDaiServiceI2, OgsaDaiRole, OgsaDaiResource, OgsaDaiSubscription, WebAdmin

The implementation of OgsaDaiService.


Field Summary
static HashMap<String,SubjectDescription> activityClientMap
           
static String MANAGEMENT_ROLE
          The PBAC role a service must have to be able to manage this service: i.e.
static String MANAGEMENT_SERVICES
          The group of management services (that includes sla manager) that are allowed to call e.g.
static String OGSA_DAI_VERSION
           
static String SESSION_MATCH_RULE
           
 
Fields inherited from class uk.ac.soton.itinnovation.grid.service.ogsadai.impl.ManagedDataResource
dataResourceDAO, dataResourceManager, dataResourceRoleDAO, dataResourceSubscriptionDAO, METRIC_DATARESOURCE, METRIC_DATARESOURCE_URI, METRIC_ROLE, METRIC_ROLE_URI, METRIC_SUBSCRIBER, METRIC_SUBSCRIBER_URI, METRIC_SUBSCRIPTION, METRIC_SUBSCRIPTION_URI, OGSADAI_GROUP_RESOURCE_ADMINS, OGSADAI_GROUP_SERVICE_ADMINS, pullPoint
 
Fields inherited from class uk.ac.soton.itinnovation.grid.service.utils.gridservit.GridServiceLite
factory, groupUtils, management, NO_ACCOUNT_NEEDED, pbacUtils, pdp, proxyFactory, thisServiceAddress, wsdlCache
 
Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.ogsadai.OgsaDaiService
OGSADAI_SERVICE_RESOURCE_TYPE, OWNED_BY_SERVICE, OWNED_BY_USER
 
Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.management.ManagedGridService
FREE_SERVICE
 
Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.ogsadai.OgsaDaiDBI
OGSADAI_DB_RESOURCE_TYPE
 
Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.ogsadai.OgsaDaiDBRoleI
OGSADAI_DB_ROLE_RESOURCE_TYPE
 
Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.ogsadai.OgsaDaiDBSubscriptionI
OGSADAI_DB_SUBSCRIPTION_RESOURCE_TYPE, ownerRuleName
 
Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.ogsadai.OgsaDaiService
OGSADAI_SERVICE_RESOURCE_TYPE, OWNED_BY_SERVICE, OWNED_BY_USER
 
Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.management.ManagedGridService
FREE_SERVICE
 
Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.dataresource.DataResourceManagement
OWNED_BY_SERVICE, OWNED_BY_USER
 
Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.ogsadai.OgsaDaiRole
RESOURCE_TYPE
 
Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.ogsadai.OgsaDaiResource
RESOURCE_TYPE
 
Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.ogsadai.OgsaDaiSubscription
RESOURCE_TYPE
 
Constructor Summary
OgsaDaiServiceImpl()
           
OgsaDaiServiceImpl(String serviceName)
           
 
Method Summary
 void addClientRule(MatchRule rule)
          Deprecated.  
 void addDelegateRule(MatchRule rule)
          Deprecated.  
 void addOwnerRule(MatchRule rule)
          Deprecated.  
 void checkPolicyRule(SubjectDescription client, String action)
          The method first checks to see if the current user (the caller) is permitted to invoke the operation checkPolicyRule.
 org.apache.axis.message.addressing.EndpointReferenceType connectDatabase(MatchRule owner, String label, String jdbcURL)
          Deprecated. 
 org.apache.axis.message.addressing.EndpointReferenceType[] createDatabase(MatchRule owner, String label, String metricURI)
          Deprecated. 
 org.apache.axis.message.addressing.EndpointReferenceType createRole(MatchRule owner, String label, String username, String password, boolean own, String metricURI, String resourceID)
          Deprecated. 
 void createSession(MatchRule owner, String sessionID)
           
 void destroy()
          Destroys a resource.
 void destroyAllSessions()
           
 void destroySessionLocal(String conversationID)
           
 void ensurePoliciesDeployed()
          Ensure that any required PBAC policies are deployed.
 String executeSelect(MatchRule rule, String query)
          Deprecated. 
 String executeUpdate(MatchRule rule, String query)
          Deprecated. 
 List<String> getAdditionalFederationMethods()
           
 List<org.apache.axis.message.addressing.EndpointReferenceType> getAdditionalFederations()
           
 Document getAtomFeed(String atomFeed, String serviceBase)
          Return notices from the service as an Atom feed.
 ExtensibilityType getBlock(String id)
          Compatibility method for OGSA-DAI clients.
 MatchRule[] getClientRules()
          Deprecated.  
 String[] getDataResourceAttributeNames()
          Get a list of attribute names that are valid for data resources.
 String[] getDataResourceRoleAttributeNames()
          Get a list of attribute names that are valid for data resource roles.
 MatchRule[] getDelegateRules()
          Deprecated.  
 String[] getDetails()
          Deprecated. 
 List<String> getFederatedMethods()
           
 ExtensibilityType getFully(String id)
          Compatibility method for OGSA-DAI clients.
 String getJDBCUrl()
          Deprecated. 
 NotificationMessage[] getMessages()
          Returns all usage messages
 NotificationMessage[] getMessagesN(int MaximumNumber)
          Returns usage messages
 Document GetMultipleResourceProperties(GetMultipleResourcePropertiesRequest getMultipleResourcePropertiesRequest)
          Compatibility method for OGSA-DAI clients.
 ExtensibilityType getNBlocks(String id, int numberOfBlocks)
          Compatibility method for OGSA-DAI clients.
 MatchRule[] getOwnerRules()
          Deprecated.  
 Document GetResourceProperty(QName getResourcePropertyRequest)
          Compatibility method for OGSA-DAI clients.
 org.apache.axis.message.addressing.EndpointReferenceType[] getResources()
          List the resources for which the caller has some role.
 MatchRule[] getRules()
          Deprecated.  
 Class getServiceDatabaseKey()
          subclasses should overide this method to use a common key for to the hibernate database for number of interfaces on your service- ie in OGSA-DAI - OgsaDaiServiceI2 and OgsaDaiService
 String getVersion()
          Returns the OGSA-DAI version.
 boolean isCurrentUserOwner(String resourceID)
           
 String[] listResources(String listResourcesVoid)
          Returns a list of data resources.
 void modifyRole(String label, String username, String password, String metricURI)
          Deprecated. 
 Document perform(Document document)
          Executes a perform document.
 ExtensibilityType perform(ExtensibilityType performDocument)
          Executes a perform document.
 ExtensibilityType performWithRule(MatchRule rule, ExtensibilityType performDocument)
          Executes a perform document.
 void putBlock(String id, ExtensibilityType data)
          Compatibility method for OGSA-DAI clients.
 void putFully(String id, ExtensibilityType data)
          Compatibility method for OGSA-DAI clients.
 void removeClientRule(MatchRule rule)
          Deprecated.  
 void removeDelegateRule(MatchRule rule)
          Deprecated.  
 void removeOwnerRule(MatchRule rule)
          Deprecated.  
 void setAdditionalFederation(org.apache.axis.message.addressing.EndpointReferenceType[] federations, String[] method)
           
 void setJDBCUrl(String jdbcURL)
          Deprecated. 
 org.apache.axis.message.addressing.EndpointReferenceType subscribe(MatchRule owner, String label)
          Deprecated. 
 
Methods inherited from class uk.ac.soton.itinnovation.grid.service.ogsadai.impl.ManagedDataResource
checkCreationOK, checkRoleSubscriberCountOK, connectDataResource, connectDataResourceInternal, connectDataResourceLocal, connectDataResourceRole, connectDataResourceRoleLocal, createDataResource, createDataResourceInternal, createDataResourceLocal, createDataResourceRole, createDataResourceRoleInternal, createDataResourceRoleLocal, createSubscription, createSubscriptionLocal, createSubscriptionLocal, destroyDataResourceInternal, destroyDataResourceLocal, destroyDataResourceRoleInternal, destroyDataResourceRoleLocal, destroyDataResourceSubscriptionInternal, destroyDataResourceSubscriptionLocal, generateEPR, generateEPR, getCustomRoleMetric, getDataResourceAttributes, getDataResourceAttributesLocal, getDataResourceRoleAttributes, getDataResourceRoleAttributesLocal, getEPRForSLA, getManagingConversation, getResourceType, modifyDataResource, modifyDataResourceLocal, modifyDataResourceRole, modifyDataResourceRoleInternal, modifyDataResourceRoleLocal, modifyDataResourceSubscriptionInternal, setParent, setParentService, subscribeInternal
 
Methods inherited from class uk.ac.soton.itinnovation.grid.service.utils.gridservit.GridServiceLite
addHibernatedObject, addPolicyRule, addTrustedAccountService, deleteHibernatedObject, getAvailableSignals, getConversationFromContext, getCurrentUser, getEPR, getEPR, getManagingConversation, getPolicyRules, getPrivateKey, getResourceFromEPR, getResources, getResources, getResourcesFromEPRs, getSelectedRegistries, getServiceFromEPR, getServiceMatchPattern, getServiceProviderCertificate, getServiceProviderID, getServiceProviderIssuer, getTrustedAccountServices, getValidRoles, loadLocalRegistry, removePolicyRule, removeTrustedAccountService, RequestSecurityToken_Issuance, RequestSecurityToken_Validation, RequestSecurityToken, setLabel, setLabel, signal, toMatchRules, validateOwner
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.management.ManagedGridService
addTrustedAccountService, getTrustedAccountServices, removeTrustedAccountService
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.GridService
getServiceProviderID, getServiceProviderIssuer
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.ResourceMetadata
getEPR, setLabel
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.PolicyManagement
addPolicyRule, getPolicyRules, getValidRoles, removePolicyRule
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.ResourceMetadata
getEPR, setLabel
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.PolicyManagement
addPolicyRule, getPolicyRules, getValidRoles, removePolicyRule
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.ResourceMetadata
getEPR, setLabel
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.PolicyManagement
addPolicyRule, getPolicyRules, getValidRoles, removePolicyRule
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.management.ManagedGridService
addTrustedAccountService, getTrustedAccountServices, removeTrustedAccountService
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.GridService
getServiceProviderID, getServiceProviderIssuer
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.dataresource.DataResourceManagement
connectDataResource, createDataResource
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.dataresource.DataResourceRole
createSubscription, getDataResourceRoleAttributes, modifyDataResourceRole
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.ResourceMetadata
getEPR, setLabel
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.PolicyManagement
addPolicyRule, getPolicyRules, getValidRoles, removePolicyRule
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.dataresource.DataResource
connectDataResourceRole, createDataResourceRole, getDataResourceAttributes, modifyDataResource
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.ResourceMetadata
getEPR, setLabel
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.PolicyManagement
addPolicyRule, getPolicyRules, getValidRoles, removePolicyRule
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.ResourceMetadata
getEPR, setLabel
 
Methods inherited from interface uk.ac.soton.itinnovation.grid.types.PolicyManagement
addPolicyRule, getPolicyRules, getValidRoles, removePolicyRule
 

Field Detail

MANAGEMENT_SERVICES

public static final String MANAGEMENT_SERVICES
The group of management services (that includes sla manager) that are allowed to call e.g. getMessages()

See Also:
Constant Field Values

MANAGEMENT_ROLE

public static final String MANAGEMENT_ROLE
The PBAC role a service must have to be able to manage this service: i.e. call getMessages() etc.

See Also:
Constant Field Values

SESSION_MATCH_RULE

public static final String SESSION_MATCH_RULE
See Also:
Constant Field Values

OGSA_DAI_VERSION

public static final String OGSA_DAI_VERSION
See Also:
Constant Field Values

activityClientMap

public static HashMap<String,SubjectDescription> activityClientMap
Constructor Detail

OgsaDaiServiceImpl

public OgsaDaiServiceImpl(String serviceName)

OgsaDaiServiceImpl

public OgsaDaiServiceImpl()
Method Detail

getServiceDatabaseKey

public Class getServiceDatabaseKey()
Description copied from class: GridServiceLite
subclasses should overide this method to use a common key for to the hibernate database for number of interfaces on your service- ie in OGSA-DAI - OgsaDaiServiceI2 and OgsaDaiService

Overrides:
getServiceDatabaseKey in class ManagedDataResource
Returns:

ensurePoliciesDeployed

public void ensurePoliciesDeployed()
                            throws RemoteException
Description copied from interface: WebAdmin
Ensure that any required PBAC policies are deployed.

Specified by:
ensurePoliciesDeployed in interface WebAdmin
Specified by:
ensurePoliciesDeployed in class ManagedDataResource
Throws:
RemoteException

destroy

public void destroy()
             throws ResourceUnknownFault,
                    ResourceNotDestroyedFault
Destroys a resource. Called by SOAP clients.

Specified by:
destroy in interface WSResourceLifetime
Overrides:
destroy in class ManagedDataResource
Throws:
ResourceUnknownFault
ResourceNotDestroyedFault

destroySessionLocal

public void destroySessionLocal(String conversationID)
                         throws RemoteException
Throws:
RemoteException

getAtomFeed

public Document getAtomFeed(String atomFeed,
                            String serviceBase)
Return notices from the service as an Atom feed. These notices are displayed on the main admin page and can also be polled by the administrator using a news aggregator. The feed should be used to alert the admin to configuration problems and any other important issues that come up.

Specified by:
getAtomFeed in interface WebAdmin
Parameters:
atomFeed - the URL of the feed
serviceBase - the service administration URL (for creating hyperlinks)
See Also:
AtomUtils

checkPolicyRule

@AccessControl(disableCheck=true)
public void checkPolicyRule(SubjectDescription client,
                                                      String action)
                     throws RemoteException
Description copied from interface: OgsaDaiSubscription
The method first checks to see if the current user (the caller) is permitted to invoke the operation checkPolicyRule. However, it uses this system of adding in more context from the call's parameters, so we don't just check to see if they can checkPolicyRule but we see if they are permitted to e.g. checkPolicyRule:perform to see if they are permitted to check if someone else can use the perform method. Once that check passes then it goes on to check if the client (that the intermediary is acting on behalf of) is permitted to invoke the operation.

Specified by:
checkPolicyRule in interface OgsaDaiSubscription
Throws:
RemoteException

getMessagesN

public NotificationMessage[] getMessagesN(int MaximumNumber)
Description copied from interface: ReportAPI
Returns usage messages

Specified by:
getMessagesN in interface ReportAPI
Parameters:
MaximumNumber - of messages. If more available returns the first.
Returns:
an array containing usage messages.

getMessages

public NotificationMessage[] getMessages()
Description copied from interface: ReportAPI
Returns all usage messages

Specified by:
getMessages in interface ReportAPI
Returns:
an array containing all usage messages.

performWithRule

public ExtensibilityType performWithRule(MatchRule rule,
                                         ExtensibilityType performDocument)
                                  throws RemoteException,
                                         DAIException
Executes a perform document. This SOAP method is compatible with GRIA clients not OGSADAI clients. Use the Ogsa-Dai API instead. Calls perform(ExtensibilityType)

Specified by:
performWithRule in interface OgsaDaiDBSubscriptionI
Specified by:
performWithRule in interface OgsaDaiSubscription
Parameters:
performDocument - The perform document to be executed.
rule - A match rule for the 'owner' role on any sessions that are created as a result of this call.
Returns:
The response document.
Throws:
RemoteException
DAIException

perform

public ExtensibilityType perform(ExtensibilityType performDocument)
                          throws RemoteException,
                                 DAIException
Executes a perform document. This SOAP method is compatible with OGSA-DAI clients. Requires a match rule to be specified in the SOAP header. Calls perform(Document)

Specified by:
perform in interface OgsaDaiDBSubscriptionI
Specified by:
perform in interface OgsaDaiSubscription
Parameters:
performDocument - The perform document to be executed.
Returns:
The response document.
Throws:
RemoteException
DAIException

perform

public Document perform(Document document)
                 throws RemoteException
Executes a perform document.

Parameters:
document - The perform document to be executed.
Returns:
A response document.
Throws:
GridFailureException
RemoteException

listResources

public String[] listResources(String listResourcesVoid)
                       throws RemoteException
Returns a list of data resources. Called by OGSA-DAI clients.

Specified by:
listResources in interface OgsaDaiSubscription
Parameters:
listResourcesVoid - Unused.
Returns:
A string array containing resource IDs of all subscriptions available to the caller.
Throws:
RemoteException

GetResourceProperty

public Document GetResourceProperty(QName getResourcePropertyRequest)
                             throws RemoteException
Description copied from interface: OgsaDaiSubscription
Compatibility method for OGSA-DAI clients.

Specified by:
GetResourceProperty in interface OgsaDaiSubscription
Overrides:
GetResourceProperty in class GridServiceLite
Returns:
Document
Throws:
InvalidResourcePropertyQNameFaultType
ResourceUnknownFaultType
RemoteException

GetMultipleResourceProperties

public Document GetMultipleResourceProperties(GetMultipleResourcePropertiesRequest getMultipleResourcePropertiesRequest)
                                       throws RemoteException
Description copied from interface: OgsaDaiSubscription
Compatibility method for OGSA-DAI clients.

Specified by:
GetMultipleResourceProperties in interface OgsaDaiSubscription
Returns:
Document
Throws:
InvalidResourcePropertyQNameFaultType
ResourceUnknownFaultType
RemoteException

getVersion

public String getVersion()
                  throws RemoteException
Returns the OGSA-DAI version. Called by OGSA-DAI clients.

Specified by:
getVersion in interface OgsaDaiSubscription
Returns:
A version string
Throws:
RemoteException

putFully

public void putFully(String id,
                     ExtensibilityType data)
              throws RemoteException,
                     ResourceBusyFaultType,
                     ResourceUnknownFaultType,
                     InternalFaultType,
                     RequestFaultType,
                     AuthorisationFaultType
Description copied from interface: OgsaDaiDBSubscriptionI
Compatibility method for OGSA-DAI clients.

Specified by:
putFully in interface OgsaDaiDBSubscriptionI
Specified by:
putFully in interface OgsaDaiSubscription
Throws:
RemoteException
ResourceBusyFaultType
ResourceUnknownFaultType
InternalFaultType
RequestFaultType
AuthorisationFaultType

putBlock

public void putBlock(String id,
                     ExtensibilityType data)
              throws RemoteException,
                     ResourceBusyFaultType,
                     ResourceUnknownFaultType,
                     InternalFaultType,
                     RequestFaultType,
                     AuthorisationFaultType
Description copied from interface: OgsaDaiDBSubscriptionI
Compatibility method for OGSA-DAI clients.

Specified by:
putBlock in interface OgsaDaiDBSubscriptionI
Specified by:
putBlock in interface OgsaDaiSubscription
Throws:
RemoteException
ResourceBusyFaultType
ResourceUnknownFaultType
InternalFaultType
RequestFaultType
AuthorisationFaultType

getFully

public ExtensibilityType getFully(String id)
                           throws RemoteException,
                                  ResourceBusyFaultType,
                                  ResourceUnknownFaultType,
                                  InternalFaultType,
                                  RequestFaultType,
                                  AuthorisationFaultType
Description copied from interface: OgsaDaiDBSubscriptionI
Compatibility method for OGSA-DAI clients.

Specified by:
getFully in interface OgsaDaiDBSubscriptionI
Specified by:
getFully in interface OgsaDaiSubscription
Throws:
RemoteException
ResourceBusyFaultType
ResourceUnknownFaultType
InternalFaultType
RequestFaultType
AuthorisationFaultType

getBlock

public ExtensibilityType getBlock(String id)
                           throws RemoteException,
                                  ResourceBusyFaultType,
                                  ResourceUnknownFaultType,
                                  InternalFaultType,
                                  RequestFaultType,
                                  AuthorisationFaultType
Description copied from interface: OgsaDaiDBSubscriptionI
Compatibility method for OGSA-DAI clients.

Specified by:
getBlock in interface OgsaDaiDBSubscriptionI
Specified by:
getBlock in interface OgsaDaiSubscription
Throws:
RemoteException
ResourceBusyFaultType
ResourceUnknownFaultType
InternalFaultType
RequestFaultType
AuthorisationFaultType

getNBlocks

public ExtensibilityType getNBlocks(String id,
                                    int numberOfBlocks)
                             throws RemoteException,
                                    ResourceBusyFaultType,
                                    ResourceUnknownFaultType,
                                    InternalFaultType,
                                    RequestFaultType,
                                    AuthorisationFaultType
Description copied from interface: OgsaDaiDBSubscriptionI
Compatibility method for OGSA-DAI clients.

Specified by:
getNBlocks in interface OgsaDaiDBSubscriptionI
Specified by:
getNBlocks in interface OgsaDaiSubscription
Throws:
RemoteException
ResourceBusyFaultType
ResourceUnknownFaultType
InternalFaultType
RequestFaultType
AuthorisationFaultType

createSession

public void createSession(MatchRule owner,
                          String sessionID)
                   throws RemoteException
Throws:
RemoteException

destroyAllSessions

public void destroyAllSessions()

getResources

public org.apache.axis.message.addressing.EndpointReferenceType[] getResources()
                                                                        throws RemoteException
Description copied from interface: OgsaDaiService
List the resources for which the caller has some role.

Specified by:
getResources in interface OgsaDaiService
Specified by:
getResources in interface GridService
Returns:
an array of EPRs, including labels (if any)
Throws:
RemoteException

isCurrentUserOwner

public boolean isCurrentUserOwner(String resourceID)
                           throws RemoteException
Throws:
RemoteException

getDataResourceAttributeNames

public String[] getDataResourceAttributeNames()
Description copied from interface: DataResourceManagement
Get a list of attribute names that are valid for data resources. This method is useful for user interfaces that wish to provide users with a means to connect or edit data resources.

Specified by:
getDataResourceAttributeNames in interface DataResourceManagement

getDataResourceRoleAttributeNames

public String[] getDataResourceRoleAttributeNames()
Description copied from interface: DataResourceManagement
Get a list of attribute names that are valid for data resource roles. This method is useful for user interfaces that wish to provide users with a means to connect, create, or edit data resource roles.

Specified by:
getDataResourceRoleAttributeNames in interface DataResourceManagement

executeSelect

@Deprecated
public String executeSelect(MatchRule rule,
                                       String query)
                     throws RemoteException
Deprecated. 

Convenience method to execute an SQL SELECT query. Uses SQLQuery to create a perform document, and calls perform(Document)

Specified by:
executeSelect in interface OgsaDaiDBSubscriptionI
Specified by:
executeSelect in interface OgsaDaiSubscription
Parameters:
query - An SQL SELECT statement.
rule - A match rule for the 'owner' role on any sessions that are created as a result of this call.
Returns:
A string representation of the response document.
Throws:
RemoteException

executeUpdate

@Deprecated
public String executeUpdate(MatchRule rule,
                                       String query)
                     throws RemoteException
Deprecated. 

Convenience method to execute an SQL UPDATE query. Uses SQLUpdate to create a perform document, and calls perform(Document)

Specified by:
executeUpdate in interface OgsaDaiDBSubscriptionI
Specified by:
executeUpdate in interface OgsaDaiSubscription
Parameters:
query - An SQL UPDATE statement.
rule - A match rule for the 'owner' role on any sessions that are created as a result of this call.
Returns:
A string representation of the response document.
Throws:
RemoteException

addClientRule

@Deprecated
public void addClientRule(MatchRule rule)
                   throws RemoteException
Deprecated. 

Adds a new rule for the 'client' role. Users with the 'client' role can view this resource and open a subscription.

Specified by:
addClientRule in interface OgsaDaiDBRoleI
Throws:
RemoteException

removeClientRule

@Deprecated
public void removeClientRule(MatchRule rule)
                      throws RemoteException
Deprecated. 

Removes a rule for the 'client' role. Users with the 'client' role can view this resource and open a subscription.

Specified by:
removeClientRule in interface OgsaDaiDBRoleI
Throws:
RemoteException

getClientRules

@Deprecated
public MatchRule[] getClientRules()
                           throws RemoteException
Deprecated. 

Returns a list of rules for the 'client' role. Clients can open subscriptions to a database role.

Specified by:
getClientRules in interface OgsaDaiDBRoleI
Throws:
RemoteException

createRole

@Deprecated
public org.apache.axis.message.addressing.EndpointReferenceType createRole(MatchRule owner,
                                                                                      String label,
                                                                                      String username,
                                                                                      String password,
                                                                                      boolean own,
                                                                                      String metricURI,
                                                                                      String resourceID)
                                                                    throws RemoteException
Deprecated. 

Description copied from interface: OgsaDaiDBI
Create a new username/password combination for accessing this database. Note that this version of this method should not be used in client applications and will return null. Instead use the version in OgsaDaiConversation

Specified by:
createRole in interface OgsaDaiDBI
Parameters:
owner - A match rule for the owner role.
label - The label for the new resource.
username - The database username.
password - The database password.
own - If true, the username will be removed from the database backend when the role resource is destroyed.
metricURI - The URI of a custom metric to use for this role.
resourceID - This should usually be set to null. If it is not null, the new role will be added to the database specified by this ID.
Returns:
The EPR of the new role resource
Throws:
RemoteException

connectDatabase

@Deprecated
public org.apache.axis.message.addressing.EndpointReferenceType connectDatabase(MatchRule owner,
                                                                                           String label,
                                                                                           String jdbcURL)
                                                                         throws RemoteException
Deprecated. 

Description copied from interface: OgsaDaiServiceSOAP
Connects an existing database Note that this version of this method should not be used in client applications and will return null. Instead use the version in RemoteOgsaDaiService

Specified by:
connectDatabase in interface OgsaDaiServiceSOAP
Parameters:
owner - A rule to allow access for the 'owner' role
label - A label for the new resource
jdbcURL - The JDBC URL of the existing database
Returns:
The EPR of the new resource
Throws:
RemoteException

createDatabase

@Deprecated
public org.apache.axis.message.addressing.EndpointReferenceType[] createDatabase(MatchRule owner,
                                                                                            String label,
                                                                                            String metricURI)
                                                                          throws RemoteException
Deprecated. 

Description copied from interface: OgsaDaiServiceSOAP
Creates a new database This method will create a new database and three roles (DAA, DAU_RO, DAU_RW) Note that this version of this method should not be used in client applications and will return null. Instead use the version in RemoteOgsaDaiService

Specified by:
createDatabase in interface OgsaDaiServiceSOAP
Parameters:
owner - A rule to allow access for the 'owner' role
label - A label for the new resource
metricURI - The URI of a custom metric to use for this role
Returns:
An array of EPRs for the new resources
Throws:
RemoteException

addOwnerRule

@Deprecated
public void addOwnerRule(MatchRule rule)
                  throws RemoteException
Deprecated. 

Adds a new owner rule to the ACL.

Specified by:
addOwnerRule in interface OgsaDaiDBI
Specified by:
addOwnerRule in interface OgsaDaiDBRoleI
Specified by:
addOwnerRule in interface OgsaDaiDBSubscriptionI
Throws:
RemoteException

removeOwnerRule

@Deprecated
public void removeOwnerRule(MatchRule rule)
                     throws RemoteException
Deprecated. 

Removes an owner rule from the ACL.

Specified by:
removeOwnerRule in interface OgsaDaiDBI
Specified by:
removeOwnerRule in interface OgsaDaiDBRoleI
Specified by:
removeOwnerRule in interface OgsaDaiDBSubscriptionI
Throws:
RemoteException

getOwnerRules

@Deprecated
public MatchRule[] getOwnerRules()
                          throws RemoteException
Deprecated. 

Returns a list of owner rules for this resource.

Specified by:
getOwnerRules in interface OgsaDaiDBI
Specified by:
getOwnerRules in interface OgsaDaiDBRoleI
Specified by:
getOwnerRules in interface OgsaDaiDBSubscriptionI
Throws:
RemoteException

addDelegateRule

@Deprecated
public void addDelegateRule(MatchRule rule)
                     throws RemoteException
Deprecated. 

Adds a new delegate rule to the ACL.

Specified by:
addDelegateRule in interface OgsaDaiDBSubscriptionI
Throws:
RemoteException

removeDelegateRule

@Deprecated
public void removeDelegateRule(MatchRule rule)
                        throws RemoteException
Deprecated. 

Removes an delegate rule from the ACL.

Specified by:
removeDelegateRule in interface OgsaDaiDBSubscriptionI
Throws:
RemoteException

getDelegateRules

@Deprecated
public MatchRule[] getDelegateRules()
                             throws RemoteException
Deprecated. 

Returns a list of delegate rules for this resource.

Specified by:
getDelegateRules in interface OgsaDaiDBSubscriptionI
Throws:
RemoteException

getRules

@Deprecated
public MatchRule[] getRules()
                     throws RemoteException
Deprecated. 

Returns a list of all access control rules for this resource.

Specified by:
getRules in interface OgsaDaiDBRoleI
Specified by:
getRules in interface OgsaDaiDBSubscriptionI
Throws:
RemoteException

getJDBCUrl

@Deprecated
public String getJDBCUrl()
                  throws RemoteException
Deprecated. 

Description copied from interface: OgsaDaiDBI
Returns the JDBC URL of this resource.

Specified by:
getJDBCUrl in interface OgsaDaiDBI
Returns:
A JDBC URL
Throws:
RemoteException

setJDBCUrl

@Deprecated
public void setJDBCUrl(String jdbcURL)
                throws RemoteException
Deprecated. 

Description copied from interface: OgsaDaiDBI
Modifies the JDBC URL of this database resource. Note that this method is not available on automatically created databases as it would not make sense to change the JDBC URL.

Specified by:
setJDBCUrl in interface OgsaDaiDBI
Parameters:
jdbcURL - The new JDBC URL.
Throws:
RemoteException

getDetails

@Deprecated
public String[] getDetails()
                    throws RemoteException
Deprecated. 

Description copied from interface: OgsaDaiDBRoleI
Returns the username, password, and metric URI for this role resource.

Specified by:
getDetails in interface OgsaDaiDBRoleI
Returns:
A string array containing information about the role. Element 0 is the username, element 1 the password, and element 2 the metric URI.
Throws:
RemoteException

modifyRole

@Deprecated
public void modifyRole(String label,
                                  String username,
                                  String password,
                                  String metricURI)
                throws RemoteException
Deprecated. 

Description copied from interface: OgsaDaiDBRoleI
Modifies this role resource. Note that this method is not accessible on automatically created roles as it would not make sense to change the login information. If you want to change the label, use setLabel.

Specified by:
modifyRole in interface OgsaDaiDBRoleI
Parameters:
label - The new label.
username - The new RDBMS username.
password - The new RDBMS password.
metricURI - The new metric URI.
Throws:
RemoteException

subscribe

@Deprecated
public org.apache.axis.message.addressing.EndpointReferenceType subscribe(MatchRule owner,
                                                                                     String label)
                                                                   throws RemoteException
Deprecated. 

Description copied from interface: OgsaDaiDBRoleI
Creates a new subscription to this role resource. Note that this version of this method should not be used in client applications and will return null. Instead use the version in OgsaDaiRoleConversation

Specified by:
subscribe in interface OgsaDaiDBRoleI
Parameters:
owner - The new owner role for the subscription.
label - A label for the new subscription.
Returns:
An EPR describing the new subscription resource.
Throws:
RemoteException

getAdditionalFederations

public List<org.apache.axis.message.addressing.EndpointReferenceType> getAdditionalFederations()
Specified by:
getAdditionalFederations in interface ManagedGridService

getAdditionalFederationMethods

public List<String> getAdditionalFederationMethods()
Specified by:
getAdditionalFederationMethods in interface ManagedGridService

setAdditionalFederation

public void setAdditionalFederation(org.apache.axis.message.addressing.EndpointReferenceType[] federations,
                                    String[] method)
                             throws RemoteException
Specified by:
setAdditionalFederation in interface ManagedGridService
Throws:
RemoteException

getFederatedMethods

public List<String> getFederatedMethods()
Specified by:
getFederatedMethods in interface ManagedGridService


Copyright © 2001-2008 University of Southampton IT Innovation Centre. All Rights Reserved.