things.thinger.service.thing
Interface Thinger

public interface Thinger

Interface to a thinger.

Version:

1.0

Version History

EPG - Initial - 22 MAY 06
 

Author:

Erich P. Gatejen

Method Summary

void	dispose(Receipt thingReceipt) Dispose of a thing.
Receipt	issueThing(java.lang.String thingName, ThingsPropertyView localProperties) This will issue a thing.
RESULT	queryResult(Receipt thingReceipt) Query the RESULT for a thing.

Method Detail

issueThing

Receipt issueThing(java.lang.String thingName,
                   ThingsPropertyView localProperties)
                   throws SystemException

This will issue a thing. It returns a receipt for the issuance, not for the other all interaction.

Parameters:

thingName - The command to issue.

localProperties - local properties for the thing

Throws:

SystemException

queryResult

RESULT queryResult(Receipt thingReceipt)
                   throws SystemException

Query the RESULT for a thing. It maybe done or in progress.

Parameters:

thingReceipt - The issuance receipt.

Returns:

RESULT.

Throws:

SystemException

dispose

void dispose(Receipt thingReceipt)
             throws SystemException

Dispose of a thing. Tell the system we are done with it regardless of status. Note that it is up to the specific implementations to either kill the thing or not. Either way, this interface will lose all knowledge of it.

Parameters:

thingReceipt - The issuance receipt.

Throws:

SystemException