uk.org.ogsadai.activity
Interface ActivityFactory

All Known Implementing Classes:
ActivityFactoryImpl

public interface ActivityFactory

An ActivityFactory is responsible for constructing the activities described in perform documents. An ActivityEngine is configured using an ActivityFactory.

Author:
The OGSA-DAI Project Team

Method Summary
 Activity[] createActivities(org.w3c.dom.Document document)
          Constructs the activity implementations for each of the activity elements contained in the given perform document.
 Property[] getProperties()
          Gets a array of Property objects associated with the activity list.
 

Method Detail

createActivities

public Activity[] createActivities(org.w3c.dom.Document document)
                            throws ActivitySpecificationException,
                                   ActivityCreationException,
                                   DocumentValidationException
Constructs the activity implementations for each of the activity elements contained in the given perform document.

Parameters:
document - The perform document containing the element to use to create the activities.
Returns:
an array of Activity objects.
Throws:
DocumentValidationException - If the perform document as a whole is in some way invalid e.g. contains unsupported pipes or unsupported activities.
ActivitySpecificationException - If a client mistake prevents one or more activities from being constructed successfully. This may be raised in either of the following circumstances:
  • one or more of the activities described in the perform document are unsupported by this factory
  • a required element or attribute has been omitted from an activity element in a perform document
ActivityCreationException - If there is some problem that prevents an activity being created. This is typically caused by a configuration or programming error.
java.lang.IllegalArgumentException - If the document is null.

getProperties

public Property[] getProperties()
Gets a array of Property objects associated with the activity list.

Returns:
the array.