- All Implemented Interfaces:
ContentDescriptor,
AbstractReadHandle,
TuplesReadHandle,
TuplesResults
A TuplesHandle represents a set of tuples
returned by a query on the server.
-
Field Summary
-
Constructor Summary
Constructors
-
Method Summary
Returns the aggregate result for the named
aggregate function.
Returns an array of the aggregates.
Returns performance metrics about the
query.
Returns the name of the tuples.
Returns the tuples query definition used to
identify this set of tuples.
Returns an array of the Tuples returned by this
query.
protected void
void
Sets the format associated with this
handle.
void
Specifies the tuples query definition used to
identify this set of tuples.
Fluent setter for the format associated with
this handle.
Methods inherited from
class com.marklogic.client.impl.HandleImplementation
getPointInTimeQueryTimestamp, isResendable, sendContent,
setPointInTimeQueryTimestamp, setResendable,
setResponseServerTimestamp
Methods
inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Constructor Details
-
TuplesHandle
public TuplesHandle()
-
Method Details
-
setFormat
public void setFormat(Format format)
Sets the format associated with this handle.
This handle only supports XML.
- Specified by:
setFormat in interface ContentDescriptor
- Overrides:
setFormat in
class BaseHandle<InputStream,OperationNotSupported>
- Parameters:
format - The format, which must be Format.XML or
an exception will be raised.
-
withFormat
Fluent setter for the format associated with
this handle. This handle only supports XML.
- Parameters:
format - The format, which must be Format.XML or
an exception will be raised.
- Returns:
- The TuplesHandle instance on which this method was called.
-
receiveAs
- Overrides:
receiveAs in
class com.marklogic.client.impl.HandleImplementation<InputStream,OperationNotSupported>
-
receiveContent
- Overrides:
receiveContent in
class com.marklogic.client.impl.HandleImplementation<InputStream,OperationNotSupported>
-
getQueryCriteria
Returns the tuples query definition used to
identify this set of tuples.
- Specified by:
getQueryCriteria in
interface TuplesResults
- Returns:
- The query criteria.
-
setQueryCriteria
Specifies the tuples query definition used to
identify this set of tuples.
- Parameters:
vdef - The query criteria.
-
getName
Returns the name of the tuples.
- Specified by:
getName in
interface TuplesResults
- Returns:
- The name.
-
getTuples
public Tuple[] getTuples()
Returns an array of the Tuples returned by this
query.
- Specified by:
getTuples in
interface TuplesResults
- Returns:
- The tuples array.
-
getAggregates
Returns an array of the aggregates.
- Specified by:
getAggregates in
interface TuplesResults
- Returns:
- The array of aggrgates.
-
getAggregate
Returns the aggregate result for the named
aggregate function.
- Specified by:
getAggregate in
interface TuplesResults
- Parameters:
name - The name of the aggregate function.
- Returns:
- The corresponding aggregate, or null if no such aggregate
exists.
-
getMetrics
Returns performance metrics about the
query.
- Specified by:
getMetrics in
interface TuplesResults
- Returns:
- The metrics
Copyright (c) 2010-2025 Progress
Software Corporation and/or its subsidiaries or affiliates. All
Rights Reserved.