Activity - deliverToStream

Activity Type: Delivery

Description

Deliver data to the DeliverToStreamServlet to allow data to be pulled via http or https.

The data will be made available at a URL of form:

http://host:port/webapp/servlet/DeliverToStreamServlet?url=
service&resourceId=resource&sessionId=session&streamId=stream

where

• host is your container host.
• port is your container port number.
• webapp is the name of the Web Application in your container under which OGSA-DAI is deployed. Typically this is:
  • axis for OGSA-DAI WSI
  • wsrf for OGSA-DAI WSRF
• service is the relative path to your service.
• resourceID is the name of the data service resource to which the stream belongs i.e. the data service resource to which you send a request containing the deliverToStream activity.
• sessionId is the ID of the session within which the request containing the deliverToStream activity was executed. This will be contained in the response from the service when the request was origially submitted.
• streamId is the value of the name attribute of the deliverToStream activity.

For example:

http://localhost:8080/axis/servlet/DeliverToStreamServlet?url=
ogsadai/DataService&resourceId=One&sessionId=
session-ogsadai-106c06ab61c&streamId=delivery

http://localhost:8080/wsrf/servlet/DeliverToStreamServlet?url=
ogsadai/DataService&resourceId=One&sessionId=
session-ogsadai-106c06ab61c&streamId=delivery

Example

<deliverToStream name="delivery">
  <fromLocal from="dataSource"/>
</deliverToStream>

Specification

Element deliverToStream:

• Attribute name - unique name for the activity within the scope of a request.
• fromLocal (required) - input stream.
  • Attribute from - name of an input stream providing the data to deliver.

Input and Output Types

• Input: fromLocal:
  • java.lang.String,
  • byte[], or
  • org.w3c.dom.Node.
  • Other Java objects are treated as java.lang.Strings
• Outputs: none

Limitations

This activity only works with Tomcat.

Data Resource Accessor

This activity can operate with any data resource accessor.

XML Schema

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

Class

uk.org.ogsadai.activity.delivery.DeliverToStreamActivity

Client Toolkit Class

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