uk.ac.soton.itinnovation.grid.comms.ogsadai
Interface OgsaDaiDBSubscriptionI

All Superinterfaces:

IdentifiableResource, PolicyManagement, ResourceMetadata, WSResourceLifetime

All Known Subinterfaces:

OgsaDaiServiceSOAP

All Known Implementing Classes:

OgsaDaiServiceI2Impl, OgsaDaiServiceImpl

Deprecated. See OgsaDaiSubscription

@WebService(targetNamespace="http://www.it-innovation.soton.ac.uk/2004/grid/ogsadai-db-subscription",
            name="OgsaDaiDBSubscription",
            wsdlLocation="ogsadaidbsubscription.wsdl",
            serviceName="OgsaDaiDBSubscription")
@SoapBindingName(value="OgsaDaiDBSubscriptionSoapBinding")
public interface OgsaDaiDBSubscriptionI
extends WSResourceLifetime, ResourceMetadata, PolicyManagement, IdentifiableResource

The public interface for the database subscription objects. Specifies a list of methods supported by database subscription resources. Implemented by OgsaDaiSubscriptionConversation on the client side and OgsaDaiServiceSOAP on the service side.

Field Summary

static String	OGSADAI_DB_SUBSCRIPTION_RESOURCE_TYPE Deprecated. A unique string to represent a type of resource accessed through the service.
static QName	ownerRuleName Deprecated.

Method Summary

void	addDelegateRule(MatchRule rule) Deprecated. Replaced by PolicyManagement.addPolicyRule(uk.ac.soton.itinnovation.grid.types.PolicyRule)
void	addOwnerRule(MatchRule rule) Deprecated. Replaced by PolicyManagement.addPolicyRule(uk.ac.soton.itinnovation.grid.types.PolicyRule)
String	executeSelect(MatchRule rule, String sql) Deprecated. Users should now construct perform documents on the client side using OGSA-DAI libraries
String	executeUpdate(MatchRule rule, String sql) Deprecated. Users should now construct perform documents on the client side using OGSA-DAI libraries
ExtensibilityType	getBlock(String id) Deprecated. Replaced by OgsaDaiSubscription.getBlock(java.lang.String).
MatchRule[]	getDelegateRules() Deprecated. Replaced by PolicyManagement.getPolicyRules()
ExtensibilityType	getFully(String id) Deprecated. Replaced by OgsaDaiSubscription.getFully(java.lang.String).
ExtensibilityType	getNBlocks(String id, int numberOfBlocks) Deprecated. Replaced by OgsaDaiSubscription.getNBlocks(java.lang.String, int).
MatchRule[]	getOwnerRules() Deprecated. Replaced by PolicyManagement.getPolicyRules()
MatchRule[]	getRules() Deprecated. Replaced by PolicyManagement.getPolicyRules()
ExtensibilityType	perform(ExtensibilityType sql) Deprecated. Replaced by OgsaDaiSubscription.perform(uk.org.ogsadai.types.ExtensibilityType).
ExtensibilityType	performWithRule(MatchRule rule, ExtensibilityType sql) Deprecated. Replaced by OgsaDaiSubscription.performWithRule(uk.ac.soton.itinnovation.grid.types.MatchRule, uk.org.ogsadai.types.ExtensibilityType).
void	putBlock(String id, ExtensibilityType data) Deprecated. Replaced by OgsaDaiSubscription.putBlock(java.lang.String, uk.org.ogsadai.types.ExtensibilityType).
void	putFully(String id, ExtensibilityType data) Deprecated. Replaced by OgsaDaiSubscription.putFully(java.lang.String, uk.org.ogsadai.types.ExtensibilityType).
void	removeDelegateRule(MatchRule rule) Deprecated. Replaced by PolicyManagement.removePolicyRule(uk.ac.soton.itinnovation.grid.types.PolicyRule)
void	removeOwnerRule(MatchRule rule) Deprecated. Replaced by PolicyManagement.removePolicyRule(uk.ac.soton.itinnovation.grid.types.PolicyRule)

Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.wsrf.WSResourceLifetime

destroy

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.IdentifiableResource

getServiceMatchPattern

Field Detail

OGSADAI_DB_SUBSCRIPTION_RESOURCE_TYPE

static final String OGSADAI_DB_SUBSCRIPTION_RESOURCE_TYPE

Deprecated.

A unique string to represent a type of resource accessed through the service. The PBAC policy with this name is used to protect operations on the service which quote a context with this type. When discovering resources, they have this type in their metadata.

See Also:

ConversationID.getResourceType(org.apache.axis.message.addressing.EndpointReferenceType), Constant Field Values

ownerRuleName

static final QName ownerRuleName

Deprecated.

Method Detail

getOwnerRules

@WebMethod
@Deprecated
MatchRule[] getOwnerRules()
                          throws RemoteException

Deprecated. Replaced by PolicyManagement.getPolicyRules()

List the rules for the 'owner' role of this resource.

Throws:

RemoteException

addOwnerRule

@WebMethod
@Deprecated
void addOwnerRule(MatchRule rule)
                  throws RemoteException

Deprecated. Replaced by PolicyManagement.addPolicyRule(uk.ac.soton.itinnovation.grid.types.PolicyRule)

Add a MatchRule to the policy protecting this resource. The rule must be for the 'owner' process role.

Throws:

RemoteException

removeOwnerRule

@WebMethod
@Deprecated
void removeOwnerRule(MatchRule rule)
                     throws RemoteException

Deprecated. Replaced by PolicyManagement.removePolicyRule(uk.ac.soton.itinnovation.grid.types.PolicyRule)

Remove a MatchRule from the policy protecting this resource. The rule must be for the 'owner' process role.

Throws:

RemoteException

getDelegateRules

@WebMethod
@Deprecated
MatchRule[] getDelegateRules()
                             throws RemoteException

Deprecated. Replaced by PolicyManagement.getPolicyRules()

List the rules for the 'delegate' role of this resource.

Throws:

RemoteException

addDelegateRule

@WebMethod
@Deprecated
void addDelegateRule(MatchRule rule)
                     throws RemoteException

Deprecated. Replaced by PolicyManagement.addPolicyRule(uk.ac.soton.itinnovation.grid.types.PolicyRule)

Add a MatchRule to the policy protecting this resource. The rule must be for the 'delegate' process role.

Throws:

RemoteException

removeDelegateRule

@WebMethod
@Deprecated
void removeDelegateRule(MatchRule rule)
                        throws RemoteException

Deprecated. Replaced by PolicyManagement.removePolicyRule(uk.ac.soton.itinnovation.grid.types.PolicyRule)

Remove a MatchRule from the policy protecting this resource. The rule must be for the 'delegate' process role.

Throws:

RemoteException

getRules

@WebMethod
@Deprecated
MatchRule[] getRules()
                     throws RemoteException

Deprecated. Replaced by PolicyManagement.getPolicyRules()

List all the rules protecting access to this resource.

Throws:

RemoteException

executeSelect

@WebMethod
@Deprecated
String executeSelect(MatchRule rule,
                                          String sql)
                     throws RemoteException

Deprecated. Users should now construct perform documents on the client side using OGSA-DAI libraries

Convenience method that executes an SQL select query on the database. Internally this creates a perform document containing a SQLQuery, then calls perform(uk.org.ogsadai.types.ExtensibilityType)

Parameters:

rule - A match rule for the 'owner' role on any sessions that are created as a result of this call.

sql - An SQL SELECT query

Returns:

A serialised OGSA-DAI response document.

Throws:

RemoteException

executeUpdate

@WebMethod
@Deprecated
String executeUpdate(MatchRule rule,
                                          String sql)
                     throws RemoteException

Deprecated. Users should now construct perform documents on the client side using OGSA-DAI libraries

Convenience method that executes an SQL update or insert query on the database. Internally this creates a perform document containing a SQLUpdate, then calls perform(uk.org.ogsadai.types.ExtensibilityType)

Parameters:

rule - A match rule for the 'owner' role on any sessions that are created as a result of this call.

sql - An SQL UPDATE query

Returns:

A serialised OGSA-DAI response document.

Throws:

RemoteException

perform

@WebMethod
@Deprecated
ExtensibilityType perform(ExtensibilityType sql)
                          throws RemoteException,
                                 DAIException

Deprecated. Replaced by OgsaDaiSubscription.perform(uk.org.ogsadai.types.ExtensibilityType).

Executes a perform document on the database. Note that a MatchRule must be specified in the soap header.

Parameters:

sql - An OGSA-DAI perform document

Returns:

An OGSA-DAI response document

Throws:

RemoteException

DAIException

performWithRule

@WebMethod
@Deprecated
ExtensibilityType performWithRule(MatchRule rule,
                                                       ExtensibilityType sql)
                                  throws RemoteException,
                                         DAIException

Deprecated. Replaced by OgsaDaiSubscription.performWithRule(uk.ac.soton.itinnovation.grid.types.MatchRule, uk.org.ogsadai.types.ExtensibilityType).

Executes a perform document on the database.

Parameters:

rule - A match rule for the 'owner' role on any sessions that are created as a result of this call.

sql - An OGSA-DAI perform document

Returns:

An OGSA-DAI response document

Throws:

RemoteException

DAIException

putFully

@WebMethod
@Deprecated
void putFully(String id,
                                   ExtensibilityType data)
              throws RemoteException,
                     ResourceBusyFaultType,
                     ResourceUnknownFaultType,
                     InternalFaultType,
                     RequestFaultType,
                     AuthorisationFaultType

Deprecated. Replaced by OgsaDaiSubscription.putFully(java.lang.String, uk.org.ogsadai.types.ExtensibilityType).

Compatibility method for OGSA-DAI clients.

Throws:

RemoteException

ResourceBusyFaultType

ResourceUnknownFaultType

InternalFaultType

RequestFaultType

AuthorisationFaultType

putBlock

@WebMethod
@Deprecated
void putBlock(String id,
                                   ExtensibilityType data)
              throws RemoteException,
                     ResourceBusyFaultType,
                     ResourceUnknownFaultType,
                     InternalFaultType,
                     RequestFaultType,
                     AuthorisationFaultType

Deprecated. Replaced by OgsaDaiSubscription.putBlock(java.lang.String, uk.org.ogsadai.types.ExtensibilityType).

Compatibility method for OGSA-DAI clients.

Throws:

RemoteException

ResourceBusyFaultType

ResourceUnknownFaultType

InternalFaultType

RequestFaultType

AuthorisationFaultType

getFully

@WebMethod
@Deprecated
ExtensibilityType getFully(String id)
                           throws RemoteException,
                                  ResourceBusyFaultType,
                                  ResourceUnknownFaultType,
                                  InternalFaultType,
                                  RequestFaultType,
                                  AuthorisationFaultType

Deprecated. Replaced by OgsaDaiSubscription.getFully(java.lang.String).

Compatibility method for OGSA-DAI clients.

Throws:

RemoteException

ResourceBusyFaultType

ResourceUnknownFaultType

InternalFaultType

RequestFaultType

AuthorisationFaultType

getBlock

@WebMethod
@Deprecated
ExtensibilityType getBlock(String id)
                           throws RemoteException,
                                  ResourceBusyFaultType,
                                  ResourceUnknownFaultType,
                                  InternalFaultType,
                                  RequestFaultType,
                                  AuthorisationFaultType

Deprecated. Replaced by OgsaDaiSubscription.getBlock(java.lang.String).

Compatibility method for OGSA-DAI clients.

Throws:

RemoteException

ResourceBusyFaultType

ResourceUnknownFaultType

InternalFaultType

RequestFaultType

AuthorisationFaultType

getNBlocks

@WebMethod
@Deprecated
ExtensibilityType getNBlocks(String id,
                                                  int numberOfBlocks)
                             throws RemoteException,
                                    ResourceBusyFaultType,
                                    ResourceUnknownFaultType,
                                    InternalFaultType,
                                    RequestFaultType,
                                    AuthorisationFaultType

Deprecated. Replaced by OgsaDaiSubscription.getNBlocks(java.lang.String, int).

Compatibility method for OGSA-DAI clients.

Throws:

RemoteException

ResourceBusyFaultType

ResourceUnknownFaultType

InternalFaultType

RequestFaultType

AuthorisationFaultType