uk.ac.soton.ecs.iam.grid.client.staterepos
Class RemoteServiceImpl

java.lang.Object
  uk.ac.soton.ecs.iam.grid.client.staterepos.RemoteServiceImpl

All Implemented Interfaces:

Comparable<StorableInStateRepository>, RemoteService, StorableInStateRepository, GridService

Direct Known Subclasses:

RemoteReportAPIImpl, RemoteWSResourceLifetimeImpl

Deprecated. use StateRepository.getOrCreateObject(java.lang.Class, org.apache.axis.message.addressing.EndpointReferenceType) instead.

@Deprecated
public abstract class RemoteServiceImpl
extends Object
implements RemoteService

A proxy to a remote service.

Field Summary

protected static Transport

transport Deprecated. Used to send SOAP messages.

Constructor Summary

RemoteServiceImpl(StateRepository repository, org.apache.axis.message.addressing.EndpointReferenceType EPR)
Deprecated.

Method Summary

void	addTrustedAccountService(org.apache.axis.message.addressing.EndpointReferenceType service) Deprecated.
int	compareTo(StorableInStateRepository other) Deprecated.
protected SOAPHeaderElement	createBillingHeader(org.apache.axis.message.addressing.EndpointReferenceType info) Deprecated. Create a SOAP header to hold billing information.
protected SOAPHeaderElement[]	createBillingHeaders(org.apache.axis.message.addressing.EndpointReferenceType info) Deprecated. Create the SOAP headers to hold the billing information, if any.
MatchPattern	createMatchPattern() Deprecated. Create a MatchPattern that matches this service.
MatchRule	createMatchRule(String role) Deprecated. Create a match rule that will grant this service the given role.
abstract RemoteBoundMethod	createMethod(String operationName) Deprecated.
String	getDescription() Deprecated. Returns a textual description of the object.
URL	getEndpoint() Deprecated. Get the endpoint address of the service.
org.apache.axis.message.addressing.EndpointReferenceType	getEndpointRef() Deprecated. Return an EndpointReferenceType for this conversation.
RemoteBoundMethod	getMethod(String operation) Deprecated. Get a method bound to an operation on this service.
URL	getParentURL() Deprecated. Returns the URL of this object's parent.
StateRepository	getRepository() Deprecated. Get the StateRepository holding this object.
org.apache.axis.message.addressing.EndpointReferenceType[]	getResources() Deprecated. Query the service to find resources to which we have some access.
protected abstract String	getServiceName() Deprecated. Returns the name of the service.
SubjectDescription	getServiceProviderID() Deprecated. Query the remote service to discover its identity.
SubjectDescription	getServiceProviderIssuer() Deprecated. Query the remote service to discover the identity of the issuer of its certificate.
org.apache.axis.message.addressing.EndpointReferenceType[]	getTrustedAccountServices() Deprecated. Get the list of account services trusted by this service.
URL	getURL() Deprecated. Get a unique string that identifies this object.
Object	invoke(String operationName, Object... args) Deprecated. Invoke a SOAP operation.
Object	invokeWithHeaders(String operationName, SOAPHeaderElement[] headers, Object... args) Deprecated. Invoke a SOAP operation.
static Class<? extends RemoteService>	lookupService(QName portType) Deprecated. see ResourceTypeRegistry
static void	registerPortType(QName portType, Class<? extends RemoteService> remoteService) Deprecated.
void	removeTrustedAccountService(org.apache.axis.message.addressing.EndpointReferenceType service) Deprecated.
void	setDescription(String description) Deprecated. Change the textual description, as returned by getDescription.
void	setRepository(StateRepository repository) Deprecated.
String	toString() Deprecated.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface uk.ac.soton.ecs.iam.grid.comms.client.RemoteService

getBillingInfo, setBillingInfo

Methods inherited from interface uk.ac.soton.ecs.iam.grid.comms.client.StorableInStateRepository

getInterface

Field Detail

transport

protected static final Transport transport

Deprecated.

Used to send SOAP messages.

Constructor Detail

RemoteServiceImpl

public RemoteServiceImpl(StateRepository repository,
                         org.apache.axis.message.addressing.EndpointReferenceType EPR)
                  throws ObjectAlreadyExists

Deprecated.

Throws:

ObjectAlreadyExists

Method Detail

getServiceName

protected abstract String getServiceName()

Deprecated.

Returns the name of the service. Used by toString().

setRepository

public void setRepository(StateRepository repository)

Deprecated.

getRepository

public StateRepository getRepository()

Deprecated.

Description copied from interface: StorableInStateRepository

Get the StateRepository holding this object.

Specified by:

getRepository in interface StorableInStateRepository

getEndpointRef

public org.apache.axis.message.addressing.EndpointReferenceType getEndpointRef()

Deprecated.

Description copied from interface: StorableInStateRepository

Return an EndpointReferenceType for this conversation. This contains both the endpoint address of the service, and the resource itself.

Specified by:

getEndpointRef in interface StorableInStateRepository

getParentURL

public URL getParentURL()

Deprecated.

Description copied from interface: StorableInStateRepository

Returns the URL of this object's parent. Returns null if this is a top-level (service) object.

Specified by:

getParentURL in interface StorableInStateRepository

getDescription

public String getDescription()

Deprecated.

Description copied from interface: StorableInStateRepository

Returns a textual description of the object. This can be presented to the user when choosing from a list, for example.

Specified by:

getDescription in interface StorableInStateRepository

setDescription

public void setDescription(String description)

Deprecated.

Description copied from interface: StorableInStateRepository

Change the textual description, as returned by getDescription.

Specified by:

setDescription in interface StorableInStateRepository

createMethod

public abstract RemoteBoundMethod createMethod(String operationName)

Deprecated.

getMethod

public RemoteBoundMethod getMethod(String operation)

Deprecated.

Get a method bound to an operation on this service. This is a caching version of createMethod(). Normally you will call invoke(java.lang.String, java.lang.Object...) instead of using this method directly.

Specified by:

getMethod in interface RemoteService

Parameters:

operation - the name of the SOAP operation

Returns:

a method bound to the named operation at this service

invoke

public Object invoke(String operationName,
                     Object... args)
              throws RemoteException

Deprecated.

Invoke a SOAP operation.

Parameters:

operationName - the name of the operation

args - arguments for the operation

Returns:

the result of the invocation

Throws:

RemoteException

invokeWithHeaders

public Object invokeWithHeaders(String operationName,
                                SOAPHeaderElement[] headers,
                                Object... args)
                         throws RemoteException

Deprecated.

Invoke a SOAP operation.

Parameters:

operationName - the name of the operation

args - arguments for the operation

Returns:

the result of the invocation

Throws:

RemoteException

getServiceProviderID

public SubjectDescription getServiceProviderID()
                                        throws RemoteException

Deprecated.

Query the remote service to discover its identity. This is useful when creating a policy to allow this service access to some other service.

Specified by:

getServiceProviderID in interface GridService

Returns:

the identity of the service

Throws:

RemoteException

getServiceProviderIssuer

public SubjectDescription getServiceProviderIssuer()
                                            throws RemoteException

Deprecated.

Query the remote service to discover the identity of the issuer of its certificate. This is useful when creating a policy to allow this service access to some other service.

Specified by:

getServiceProviderIssuer in interface GridService

Returns:

the identity of the service's certificate's issuer

Throws:

RemoteException

getResources

public org.apache.axis.message.addressing.EndpointReferenceType[] getResources()
                                                                        throws RemoteException

Deprecated.

Query the service to find resources to which we have some access.

Specified by:

getResources in interface GridService

Returns:

an array of EPRs, one for each resource at the remove service

Throws:

RemoteException

getURL

public URL getURL()

Deprecated.

Get a unique string that identifies this object. We use the endpoint of the service.

Specified by:

getURL in interface StorableInStateRepository

getEndpoint

public URL getEndpoint()

Deprecated.

Get the endpoint address of the service.

Specified by:

getEndpoint in interface RemoteService

createMatchRule

public MatchRule createMatchRule(String role)
                          throws RemoteException

Deprecated.

Create a match rule that will grant this service the given role. This method queries the remote service to discover its details and contructs a rule from the results.

Specified by:

createMatchRule in interface RemoteService

Parameters:

role - the role to be granted

Returns:

a rule granting the service the given process role

Throws:

RemoteException

createMatchPattern

public MatchPattern createMatchPattern()
                                throws RemoteException

Deprecated.

Description copied from interface: RemoteService

Create a MatchPattern that matches this service. Invokes the service to get its identity.

Specified by:

createMatchPattern in interface RemoteService

Throws:

RemoteException

compareTo

public int compareTo(StorableInStateRepository other)

Deprecated.

Specified by:

compareTo in interface Comparable<StorableInStateRepository>

toString

public String toString()

Deprecated.

Overrides:

toString in class Object

getTrustedAccountServices

public org.apache.axis.message.addressing.EndpointReferenceType[] getTrustedAccountServices()
                                                                                     throws RemoteException

Deprecated.

Get the list of account services trusted by this service. Operations that create new resources can typically only be invoked if the client has an account at the service provider. This method queries the service to find out which services are acceptable.

Note: this API is likely to change for GRIA 5 to be more general.

Returns:

an array of account service EPRs

Throws:

RemoteException

addTrustedAccountService

public void addTrustedAccountService(org.apache.axis.message.addressing.EndpointReferenceType service)
                              throws RemoteException

Deprecated.

Throws:

RemoteException

removeTrustedAccountService

public void removeTrustedAccountService(org.apache.axis.message.addressing.EndpointReferenceType service)
                                 throws RemoteException

Deprecated.

Throws:

RemoteException

registerPortType

public static void registerPortType(QName portType,
                                    Class<? extends RemoteService> remoteService)

Deprecated.

lookupService

public static Class<? extends RemoteService> lookupService(QName portType)

Deprecated. see ResourceTypeRegistry

Find the RemoteService interface for a service with this port type.

Parameters:

portType - the port type in the WSDL

Returns:

an interface for the remote service

createBillingHeaders

protected SOAPHeaderElement[] createBillingHeaders(org.apache.axis.message.addressing.EndpointReferenceType info)

Deprecated.

Create the SOAP headers to hold the billing information, if any.

Parameters:

info - EPR of a management resource (trade account or SLA), or null if none is required

Returns:

an array of SOAP headers that should be added to the message

See Also:

createBillingHeader(org.apache.axis.message.addressing.EndpointReferenceType)

createBillingHeader

protected SOAPHeaderElement createBillingHeader(org.apache.axis.message.addressing.EndpointReferenceType info)

Deprecated.

Create a SOAP header to hold billing information.

Parameters:

info - EPR of a management resource (trade account or SLA), including any required security tokens

Returns:

a SOAP header containing a copy of the EPR

See Also:

invokeWithHeaders(java.lang.String, org.apache.axis.message.SOAPHeaderElement[], java.lang.Object...)