uk.org.ogsadai.activity.delivery.wsrf
Class DeliverFromGDTActivity

java.lang.Object
  |
  +--uk.org.ogsadai.activity.Activity
        |
        +--uk.org.ogsadai.activity.delivery.AbstractDTDeliveryActivity
              |
              +--uk.org.ogsadai.activity.delivery.AbstractDeliverFromDTActivity
                    |
                    +--uk.org.ogsadai.activity.delivery.wsrf.DeliverFromGDTActivity

public class DeliverFromGDTActivity

extends AbstractDeliverFromDTActivity

This activity gets data from a stream that is part of a currently active session within a data service resource exposed by a data service. The data transport get operations on the data service are used to pull the data to this activity.

Security attributes can be provided on the activity's XML definition provided to the constructor. These determine the security configured between the local and target services. See the following classes for more information.

Currently credentials are not used when communicating with the data service.

For information on this activity see the OGSA-DAI user doc: OGSA-DAI/doc/interaction/activities/delivery/deliverFromGDT.html

Author:

The OGSA-DAI Project Team

Field Summary

private static java.lang.String	COPYRIGHT_NOTICE Copyright statement
private static DAILogger	LOG Logger object for logging in this class.
private GSISecureConversationProperty	mSecurityProperties Security configuration.
private DataService	mServiceStub Stub for target service

Fields inherited from class uk.org.ogsadai.activity.delivery.AbstractDeliverFromDTActivity

mNumBlocks

Fields inherited from class uk.org.ogsadai.activity.delivery.AbstractDTDeliveryActivity

mBlockMode, mDeliveryNode, mLocalStream, mResourceID, mServiceType, mServiceURL, mStreamID

Fields inherited from class uk.org.ogsadai.activity.Activity

mContext, mExternalInputs, mExternalOutputs, mInternalInputs, mInternalOutputs

Constructor Summary

DeliverFromGDTActivity(org.w3c.dom.Element activity)

Method Summary

protected void	contactTargetService() Create a stub for the target service.
protected java.lang.Object	getFully() Retrieve data from the target data service.
protected java.lang.Object	getNBlocks(int numBlocks) Retrieve a number of blocks of data from the target data service.

Methods inherited from class uk.org.ogsadai.activity.delivery.AbstractDeliverFromDTActivity

initialise, processBlock

Methods inherited from class uk.org.ogsadai.activity.delivery.AbstractDTDeliveryActivity

getDeliverySettings, isServiceUnknown, isServiceWSI, isServiceWSRF, processFirst

Methods inherited from class uk.org.ogsadai.activity.Activity

cleanUp, connectsTo, createOutputPipe, getActivityConfiguration, getActivityName, getCause, getName, getObservableStatus, getProperties, getSession, getStatus, hasActivityConfiguration, hasProperties, process, setActivityName, setCompleted, setError

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 final DAILogger LOG

Logger object for logging in this class.

mServiceStub

private DataService mServiceStub

Stub for target service

mSecurityProperties

private GSISecureConversationProperty mSecurityProperties

Security configuration.

Constructor Detail

DeliverFromGDTActivity

public DeliverFromGDTActivity(org.w3c.dom.Element activity)
                       throws ActivityCreationException,
                              ActivitySpecificationException

Method Detail

getFully

protected java.lang.Object getFully()
                             throws ActivitySpecificationException,
                                    ActivityExecutionException

Description copied from class: AbstractDeliverFromDTActivity

Retrieve data from the target data service.

Specified by:

getFully in class AbstractDeliverFromDTActivity

Returns:

retrieved data.

Throws:

ActivitySpecificationException - If an error occurs that is caused by incorrect information in the request e.g. the URL is incorrect or cannot be contacted.

ActivityExecutionException - If some internal problem outwith the client's control occurs.

getNBlocks

protected java.lang.Object getNBlocks(int numBlocks)
                               throws ActivitySpecificationException,
                                      ActivityExecutionException

Description copied from class: AbstractDeliverFromDTActivity

Retrieve a number of blocks of data from the target data service.

Specified by:

getNBlocks in class AbstractDeliverFromDTActivity

Parameters:

numBlocks - Number of blocks to retrieve.

Returns:

retrieved data.

Throws:

ActivityExecutionException - If some internal problem outwith the client's control occurs.

ActivitySpecificationException - If an error occurs that is caused by incorrect information in the request e.g. the URL is incorrect or cannot be contacted.

contactTargetService

protected void contactTargetService()
                             throws ActivitySpecificationException,
                                    ActivityExecutionException

Description copied from class: AbstractDTDeliveryActivity

Create a stub for the target service.

Specified by:

contactTargetService in class AbstractDTDeliveryActivity

Throws:

ActivitySpecificationException - If an error occurs that is caused by incorrect information in the request e.g. the URL is incorrect or cannot be contacted.

ActivityExecutionException - If some internal problem outwith the client's control occurs.