org.cristalise.kernel.entity

Class ItemImplementation

java.lang.Object

org.cristalise.kernel.entity.ItemImplementation

All Implemented Interfaces:

ItemOperations

Direct Known Subclasses:

AgentImplementation

public class ItemImplementation
extends Object
implements ItemOperations

Field Summary

Fields

Modifier and Type	Field and Description
protected ItemPath	mItemPath
protected TransactionManager	mStorage

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ItemImplementation(ItemPath key)

Method Summary

Modifier and Type	Method and Description
String	delegatedAction(SystemKey agentId, SystemKey delegateId, String stepPath, int transitionID, String requestData, String attachmentType, byte[] attachment)
protected void	finalize()
protected PredefinedStepContainer	getNewPredefStepContainer()
SystemKey	getSystemKey() System generated unique key of the Entity.
UUID	getUUID()
void	initialise(SystemKey agentId, String propString, String initWfString, String initCollsString, String initViewpointString, String initOutcomeString) Initialises a new Item.
String	queryData(String path) Returns a chunk of XML which may be a serialized C2KLocalObject, or in the case of Outcomes is merely a fragment of XML.
String	queryLifeCycle(SystemKey agentId, boolean filter) Returns a set of Jobs for this Agent on this Item.
String	requestAction(SystemKey agentId, String stepPath, int transitionID, String requestData, String attachmentType, byte[] attachment) Requests a transition of an Activity in this Item's workflow.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

mStorage

protected final TransactionManager mStorage

mItemPath

protected final ItemPath mItemPath

Constructor Detail

ItemImplementation

protected ItemImplementation(ItemPath key)

Method Detail

getSystemKey

public SystemKey getSystemKey()

Description copied from interface: ItemOperations

System generated unique key of the Entity. It is a 128 bit UUID, expressed as two 64 bit longs in the IDLs, but as a UUID object in the Java kernel. The ItemPath is used as the Item identifier in the kernel and its API, which can be derived from either a UUID object or a SystemKey structure.

Specified by:

getSystemKey in interface ItemOperations

getUUID

public UUID getUUID()

initialise

public void initialise(SystemKey agentId,
                       String propString,
                       String initWfString,
                       String initCollsString,
                       String initViewpointString,
                       String initOutcomeString)
                throws AccessRightsException,
                       InvalidDataException,
                       PersistencyException

Description copied from interface: ItemOperations

Initialises a new Item. Initial properties and the lifecycle are supplied. They should come from the Item's description.

Specified by:

initialise in interface ItemOperations

Parameters:

agentId - the Agent doing the initialisation

propString - The XML marshalled PropertyArrayList containing the initial Property objects of the Item

initWfString - The XML marshalled new lifecycle of the Item

initViewpointString - the XML marshalled Viewpoint to be stored to find the Outcome

initOutcomeString - the XML data to be stored

Throws:

AccessRightsException

InvalidDataException

PersistencyException

getNewPredefStepContainer

protected PredefinedStepContainer getNewPredefStepContainer()

requestAction

public String requestAction(SystemKey agentId,
                            String stepPath,
                            int transitionID,
                            String requestData,
                            String attachmentType,
                            byte[] attachment)
                     throws AccessRightsException,
                            InvalidTransitionException,
                            ObjectNotFoundException,
                            InvalidDataException,
                            PersistencyException,
                            ObjectAlreadyExistsException,
                            InvalidCollectionModification

Description copied from interface: ItemOperations

Requests a transition of an Activity in this Item's workflow. If possible and permitted, an Event is generated and stored, the Activity's state is updated, which may cause the Workflow to proceed. If this transition requires Outcome data, this is supplied and stored, and a Viewpoint will be created or updated to point to this latest version. In the case of PredefinedSteps, additional data changes may be performed in the server data. This method should not be called directly, as there is a large client side to activity execution implemented in the Proxy objects, such as script execution and schema validation.

Specified by:

requestAction in interface ItemOperations

Parameters:

agentId - The SystemKey of the Agent. Some activities may be restricted in which roles may execute them. Some transitions cause the activity to be assigned to the executing Agent.

stepPath - The path in the Workflow to the desired Activity

transitionID - The transition to be performed

requestData - The XML Outcome of the work defined by the Activity. Must be valid to the XML Schema, though this is not verified on the server, rather in the AgentProxy in the Client API.

attachmentType - the MimeType of the attachment (can be empty)

attachment - binary data associated with the Outcome (can be empty)

Throws:

AccessRightsException - The Agent is not permitted to perform the operation. Either it does not have the correct role, or the Activity is reserved by another Agent. Also thrown when the given Agent ID doesn't exist.

InvalidTransitionException - The Activity is not in the correct state to make the requested transition.

ObjectNotFoundException - The Activity or a container of it does not exist.

InvalidDataException - An activity property for the requested Activity was invalid e.g. SchemaVersion was not a number. Also thrown when an uncaught Java exception or error occurred.

PersistencyException - There was a problem committing the changes to storage.

ObjectAlreadyExistsException - Not normally thrown, but reserved for PredefinedSteps to throw if they need to.

InvalidCollectionModification

delegatedAction

public String delegatedAction(SystemKey agentId,
                              SystemKey delegateId,
                              String stepPath,
                              int transitionID,
                              String requestData,
                              String attachmentType,
                              byte[] attachment)
                       throws AccessRightsException,
                              InvalidTransitionException,
                              ObjectNotFoundException,
                              InvalidDataException,
                              PersistencyException,
                              ObjectAlreadyExistsException,
                              InvalidCollectionModification

Specified by:

delegatedAction in interface ItemOperations

Throws:

AccessRightsException

InvalidTransitionException

ObjectNotFoundException

InvalidDataException

PersistencyException

ObjectAlreadyExistsException

InvalidCollectionModification

queryLifeCycle

public String queryLifeCycle(SystemKey agentId,
                             boolean filter)
                      throws AccessRightsException,
                             ObjectNotFoundException,
                             PersistencyException

Description copied from interface: ItemOperations

Returns a set of Jobs for this Agent on this Item. Each Job represents a possible transition of a particular Activity in the Item's lifecycle. The list may be filtered to only refer to currently active activities.

Specified by:

queryLifeCycle in interface ItemOperations

Parameters:

agentId - The system key of the Agent requesting Jobs.

filter - If true, then only Activities which are currently active will be included.

Returns:

An XML marshalled JobArrayList

Throws:

AccessRightsException - - when the Agent doesn't exist

ObjectNotFoundException - - when the Item doesn't have a lifecycle

PersistencyException - - when there was a storage or other unknown error

queryData

public String queryData(String path)
                 throws AccessRightsException,
                        ObjectNotFoundException,
                        PersistencyException

Description copied from interface: ItemOperations

Returns a chunk of XML which may be a serialized C2KLocalObject, or in the case of Outcomes is merely a fragment of XML.

Specified by:

queryData in interface ItemOperations

Parameters:

path - - All Entity data is arranged in a tree structure which uniquely identifies that object within the Entity it is contained, according to the following scheme:

• LifeCycle/workflow (Items only): The Workflow object for this Item, containing the graph of activities defining the Item's lifecycle, and the Predefined Step container for data modification
• Collection/{Name} (Items only): Collection objects defining links between Items
• Property/{Name}: Name value pairs to idenfity this Entity, define its type, and hold any other oft-changing indicators that would be heavy to extract from Outcomes
• AuditTrail/{ID} (Items only): Events describing all activity state changes in this Item.
• Outcome/{Schema name}/{Schema version}/{Event ID} (Items only): XML fragments resulting from the execution of an Activity, validated against the XML Schema defined by that activity.
• ViewPoint/{Schema name}/{Name} (Items only): A named pointer to the latest version of an Outcome, defined by the Activity.
• Job/{ID} (Agents only): A persistent Job, reflecting a request for execution of an Activity to this Agent. Not all roles create persistent Jobs like this, only those specifically flagged to do so.

Returns:

The XML string of the data. All fragments except Outcomes will deserialize into objects with the kernel CastorXMLUtility available in the Gateway.

Throws:

AccessRightsException - Not currently implemented

ObjectNotFoundException - when the path is not present in this Entity

PersistencyException - when the path could not be loaded because of a problem with the storage subsystem.

See Also:

ClusterStorage.getPath(org.cristalise.kernel.entity.C2KLocalObject)

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable