get(int count) method

Format

ArrayList<StreamTuple> get(int count)

Explanation

Acquires the number of tuples specified by the count parameter from the SDP server.

If there is no result data in the SDP server, an empty ArrayList type object 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

count

Specifies the number of data items to be acquired from the SDP server. You can specify between 1 and 1,048,576 data items.

The actual number of data items that will be acquired varies as shown below, depending on the value specified in this parameter and the state of the output stream queue.

ConditionNumber that can be acquired
Value specified in count is less than or equal to the number of data items in the output stream queue.Value specified in the count parameter
Value specified in count is greater than the number of data items in the output stream queue.Number of data items in the output stream queue
Value specified in count is greater than the maximum size of the output stream queue.

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.
  • A parameter is invalid.
SDPClientQueryGroupHoldExceptionThe query group is held. (Detailed exception of SDPClientQueryGroupStateException)
SDPClientQueryGroupNotExistExceptionThe query group was deleted.
SDPClientQueryGroupStateExceptionThe query group is not being executed.
SDPClientQueryGroupStopExceptionThere is no result data or the query group is stopped. (Detailed exception of SDPClientQueryGroupStateException)

Return value

A tuple list (ArrayList<StreamTuple> type object)