Page History

...

public interface ITupleSpace
{
	Integer write( String entryXML ) throws Throwable;
        Integer[] writeB( String[] entryXML ) throws Throwable;
	String[] read( String matchXML, int max ) throws Throwable;
	String[] take( String matchXML, int max, long timeout ) throws Throwable;
	String[] takeNB( String matchXML, int max ) throws Throwable;
}

NOTES

• write takes a serialized string representing the ncsa.service.vizier.tspace.TspaceEntry object (see below); returns the entry id.
• writeB is a batch method which does the same thing as write on multiple entries; returns array of ids corresponding to each entry.
• read and take are batch methods, both requiring a serialized string representing the ncsa.service.vizier.tspace.TspaceMatchRequest object (see below), along with an integer indicating the maximum number of entries to return (default is 10; it is advisable not to set this number too high, as Axis will have trouble managing extremely large SOAP packets); the array returned contains serialized ncsa.service.vizier.tspace.TspaceEntry objects.
• take also requires a timeout (if set to t <= 0, the non-blocking method is called), whereas takeNB will return immediately subsequent to issuing the request against the data store.
  • takeNB can return null if no entries satisfy the request constraints.
  • take will not return null unless timeout <= 0.
  • take may return an empty array (length 0) if its timeout has been exceeded.

ncsa.service.vizier.tspace.TspaceEntry

...

• If id is null, the object will be added as a new entry.
• If id is not null, an attempt will be made to update an existing object with that id. The fields subject to update are:
  • timeTaken
  • timeCompleted
  • retried
  • ranOn

If the id is set, it is not necessary to provide a complete description of the entry; only the XML elements or attributes corresponding to the 4 updateable fields above will be processed. See further the ncsa.tools.ogrscript.tspace page.

...