Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • write takes a serialized string representing the ncsa.service.vizier.tspace.ConfigurationEntry object (see below); returns the tuple entry id.
  • writeB is a batch method which does the same thing as write on multiple entries; returns array of tuple ids corresponding to each entry.
  • read and take are batch methods, both requiring a serialized string representing the ncsa.service.vizier.tspace.ConfigurationMatchRequest object (see below), along with an integer indicating the maximum number of tuples 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.ConfigurationEntry 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 tuples 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.

...