Activity - deliverToFile

Activity Type: Delivery

Description

Consumes data from an input and delivers it to a file on the service container's local filesystem.

Example

Consumes data from an input named dataSource and delivers it to a file called C:/temp/file.txt:

<deliverToFile name="delivery">
  <fromLocal from="dataSource"/>
  <toFile>C:/temp/file.txt</toFile>
</deliverToFile>

Specification

Element deliverToFile:

• 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.
• Element toFile (required) - the file on the container's local filesystem to which the data is to be delivered

Input and Output Types

• Input: fromLocal — byte[], java.lang.String, org.w3c.dom.Node or java.lang.Object. Byte and string data is written straight to the file, nodes are serialized into XML strings and other types of objects are converted into strings by invoking the toString() method.

Warnings to Service Deployers

This activity is not deployed by default because it can potentially be used by clients to overwrite any file on your server. This activity is provided for developing and testing OGSA-DAI applications.

If you intend to use files as data resources then you should support access and manipulation of these only via the file activities.

Data Resource Accessor

This activity can operate with any data resource accessor.

XML Schema

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

Class

uk.org.ogsadai.activity.delivery.DeliverToFileActivity

Client Toolkit Class

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