Activity - deliverToNull

Activity Type: Delivery

Description

Throws away the input stream. If an input stream is passed to this activity there will be no way to retrieve the data.

The activity is useful in the odd occassions when the client is not interested in one of multiple outputs produed by an activity or the client is only insterested in the side-effects of an activity rather than its output. For example, the sqlBulkLoadRowSet activity inserts rows into a database base and outputs the number of rows inserted. If you are not interested in the number of rows inserted then deliverToNull can be used to throw away this result. By throwning away an unrequired output using deliverToNull it is sometimes possible for a perform document is be executed asynchronously rather than synchronously - this may be useful for long running perform documents.

See also deliverToResourceProperty which is similar but allows the results to be retrieved via a resource property.

Example

<deliverToNull name="delivery">
  <input from="dataSource"/>
</deliverToNull>

Specification

Element deliverToNull:

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

Input and Output Types

• Input: input - any Java object
• Outputs: none

Data Resource Accessor

This activity can operate with any data resource accessor.

XML Schema

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

Class

uk.org.ogsadai.activity.delivery.DeliverToNullActivity

Client Toolkit Class

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