get() method

Format

StreamTuple get()

Explanation

Acquires a single tuple registered in the SDP server.

If there are no tuples in the output stream queue, null is returned.

If a stop notification has been issued to the query group when this method is called (a data transmission termination notification has been sent by a method, or a query group stop notification has been sent by a command), one of the following processes takes place:

This method is a polling method.

Parameters

None.

Exceptions

The following table shows the exceptions and the conditions for their generation.

ExceptionGeneration condition
SDPClientCommunicationExceptionA communication exception occurred during RMI connection.
SDPClientEndOfStreamExceptionProcessing of the transmitted data is finished.
SDPClientException
  • The output stream is already closed.
  • A listener object for callback is already registered.
SDPClientQueryGroupHoldExceptionThe query group is held.
SDPClientQueryGroupNotExistExceptionThe query group was deleted.
SDPClientQueryGroupStateExceptionThe query group is not being executed.
SDPClientQueryGroupStopExceptionThere is no result data or the query group is stopped.

Return value

Acquired tuple (StreamTuple type object)