Activity - deliverToResourceProperty

Activity Type: Delivery

Description

Delivers the input stream to a resource property. The input stream consist of purely string blocks. Clients can subsequently obtain the data by accessing the resource property. This activity is useful to force asynchronous execution of perform documents and allow the final result to be collected by the client when the request has completed.

The resource property can be flagged as being session-specific. If this is done the local name of the resource property will be the specified local name appended with "-" followed by the session ID. For example, myResourceProperty-session-ogsadai-10823881a91.

Example

Delivers string data from the dataSource input to a session-specific resourse property:

<deliverToResourceProperty name="delivery">
  <input from="dataSource"/>
  <resourceProperty
    name="myResourceProperty"
    ns="http://mynamespace.com"
    sessionSpecific="true"/>
</deliverToResourceProperty>

Specification

Element deliverToResourceProperty:

• Attribute name - unique name for the activity within the scope of a request.
• input (required) - input stream.
  • Attribute from - name of an input stream providing the data to deliver.
• resourceProperty (required) - the resource property to write to.
  • Attribute name (required) - localname of the resource property.
  • Attribute ns (required) - namespace of the resource property.
  • Attribute sessionSpecific (required) - true if the resource property is to be specific to this session, false otherwise.

Input and Output Types

• Input: input — java.lang.String

Limitations

Currently only string blocks can be delivered to resource properties.

Data Resource Accessor

This activity can operate with any data resource accessor.

XML Schema

OGSA-DAI/schema/ogsadai/xsd/activities/deliver_to_resource_property.xsd

Class

uk.org.ogsadai.activity.delivery.DeliverToResourcePropertyActivity

Client Toolkit Class

uk.org.ogsadai.client.toolkit.activity.delivery.DeliverToResourceProperty