QueryWrapper.DefaultDelegate (P2J - Progress 4GL to Java Conversion and Runtime)

java.lang.Object
- com.goldencode.p2j.persist.QueryWrapper.DefaultDelegate

All Implemented Interfaces:

BufferCollection, IndexInformation, P2JQuery, Openable

Enclosing class:

QueryWrapper
```
private static class QueryWrapper.DefaultDelegate
extends java.lang.Object
implements P2JQuery
```
A no-op implementation of P2JQuery which is used as the default delegate for the enclosing QueryWrapper. This implementation behaves as a query which returns no results would, except that its isValid method returns false, as an indication that it is a "fake" query for those callers to whom this information is relevant.

Nested Class Summary
- Nested classes/interfaces inherited from interface com.goldencode.p2j.persist.P2JQuery
  P2JQuery.Parameter, P2JQuery.ParamResolver, P2JQuery.QueryEventListener, P2JQuery.QueryOpenedListener

Constructor Summary

Constructors
Modifier Constructor and Description

private DefaultDelegate()

Constructors
Modifier	Constructor and Description
`private`	`DefaultDelegate()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`_getNext()` Conversion of GET-NEXT method (KW_GET_NEXT).
`boolean`	`_isOffEnd()` Default implementation which reports the query is off-end.
`void`	`addAccumulator(Accumulator accum)` No-op.
`void`	`addAccumulator(Accumulator accum, boolean deferred)` No-op.
`logical`	`addBuffer(Buffer buf)` Adds one new buffer to a query object or dynamic DataSet object, without affecting the other buffers, if any.
`logical`	`addBuffer(handle bufHandle)` Adds one new buffer to a query object or dynamic DataSet object, without affecting the other buffers, if any.
`boolean`	`addDynamicFilter(FieldReference fr, BaseDataType val, java.lang.String format)` Adds a new constraint term to the where predicate of this query, effectively filtering out any rows whose referenced field does not match the requested value.
`P2JQuery`	`addExternalBuffers(DataModelObject... dmos)` Add one or more buffers to the list of those which this query references externally.
`void`	`addRepositionListener(RepositionListener listener)` No-op.
`boolean`	`backward(int rows)` No-op.
`boolean`	`backward(NumberType rows)` No-op.
`handle`	`bufferHandle()` Conversion of GET-BUFFER-HANDLE() method (KW_GET_BUFH).
`handle`	`bufferHandle(character bufferName)` Conversion of GET-BUFFER-HANDLE() method (KW_GET_BUFH).
`handle`	`bufferHandle(int bufferSequenceNumber)` Conversion of GET-BUFFER-HANDLE() method (KW_GET_BUFH).
`handle`	`bufferHandle(int64 bufferSequenceNumber)` Conversion of GET-BUFFER-HANDLE() method (KW_GET_BUFH).
`handle`	`bufferHandle(java.lang.String bufferName)` Conversion of GET-BUFFER-HANDLE() method (KW_GET_BUFH).
`void`	`changeForwardOnly(boolean forwardOnly)` Conversion of FORWARD-ONLY attribute (KW_FWD_ONLY).
`void`	`changeForwardOnly(logical forwardOnly)` Conversion of FORWARD-ONLY attribute (KW_FWD_ONLY).
`void`	`cleanup()` No-op.
`void`	`clearDynamicFilters()` Clears any dynamically filters added at runtime.
`void`	`clearResults()` No-op.
`void`	`close()` No-op.
`logical`	`createResultListEntry()` No-op.
`boolean`	`current()` No-op.
`boolean`	`current(LockType lockType)` No-op.
`integer`	`currentRow()` Default implementation which reports unknown value as the current row to indicate an empty results list.
`integer`	`currentRowImpl()` Default implementation which reports unknown value as the current row to indicate an empty results list.
`logical`	`deleteResultListEntry()` No-op.
`logical`	`deleteResultListEntry(boolean allowBetweenRows)` No-op.
`void`	`exclude(DataModelObject dmo, java.lang.String... fields)` No-op.
`boolean`	`first()` No-op.
`boolean`	`first(LockType lockType)` No-op.
`boolean`	`forward(int rows)` No-op.
`boolean`	`forward(NumberType rows)` No-op.
`logical`	`forwardOnly()` Conversion of FORWARD-ONLY attribute (KW_FWD_ONLY).
`integer`	`getCache()` Getter for the CACHE attribute.
`logical`	`getCurrent()` Conversion of GET-CURRENT() method (KW_GET_CUR).
`logical`	`getCurrent(LockType lockType)` Conversion of GET-CURRENT() method (KW_GET_CUR).
`logical`	`getCurrent(long lock)` Conversion of GET-CURRENT() method (KW_GET_CUR).
`logical`	`getCurrent(long lock, long nowait)` Conversion of GET-CURRENT() method (KW_GET_CUR).
`logical`	`getCurrent(long lock, NumberType nowait)` Conversion of GET-CURRENT() method (KW_GET_CUR).
`logical`	`getCurrent(NumberType lock)` Conversion of GET-CURRENT() method (KW_GET_CUR).
`logical`	`getCurrent(NumberType lock, long nowait)` Conversion of GET-CURRENT() method (KW_GET_CUR).
`logical`	`getCurrent(NumberType lock, NumberType nowait)` Conversion of GET-CURRENT() method (KW_GET_CUR).
`logical`	`getFirst()` Conversion of GET-FIRST method (KW_GET_1ST).
`logical`	`getFirst(LockType lockType)` Conversion of GET-FIRST method (KW_GET_1ST).
`logical`	`getFirst(long lock)` Conversion of GET-FIRST method (KW_GET_1ST).
`logical`	`getFirst(long lock, long nowait)` Conversion of GET-FIRST method (KW_GET_1ST).
`logical`	`getFirst(long lock, NumberType nowait)` Conversion of GET-FIRST method (KW_GET_1ST).
`logical`	`getFirst(NumberType lock)` Conversion of GET-FIRST method (KW_GET_1ST).
`logical`	`getFirst(NumberType lock, long nowait)` Conversion of GET-FIRST method (KW_GET_1ST).
`logical`	`getFirst(NumberType lock, NumberType nowait)` Conversion of GET-FIRST method (KW_GET_1ST).
`logical`	`getLast()` Conversion of GET-LAST method (KW_GET_LAST).
`logical`	`getLast(LockType lockType)` Conversion of GET-LAST method (KW_GET_LAST).
`logical`	`getLast(long lock)` Conversion of GET-LAST method (KW_GET_LAST).
`logical`	`getLast(long lock, long nowait)` Conversion of GET-LAST method (KW_GET_LAST).
`logical`	`getLast(long lock, NumberType nowait)` Conversion of GET-LAST method (KW_GET_LAST).
`logical`	`getLast(NumberType lock)` Conversion of GET-LAST method (KW_GET_LAST).
`logical`	`getLast(NumberType lock, long nowait)` Conversion of GET-LAST method (KW_GET_LAST).
`logical`	`getLast(NumberType lock, NumberType nowait)` Conversion of GET-LAST method (KW_GET_LAST).
`logical`	`getNext(LockType lockType)` Conversion of GET-NEXT method (KW_GET_NEXT).
`logical`	`getNext(long lock)` Conversion of GET-NEXT method (KW_GET_NEXT).
`logical`	`getNext(long lock, long nowait)` Conversion of GET-NEXT method (KW_GET_NEXT).
`logical`	`getNext(long lock, NumberType nowait)` Conversion of GET-NEXT method (KW_GET_NEXT).
`logical`	`getNext(NumberType lock)` Conversion of GET-NEXT method (KW_GET_NEXT).
`logical`	`getNext(NumberType lock, long nowait)` Conversion of GET-NEXT method (KW_GET_NEXT).
`logical`	`getNext(NumberType lock, NumberType nowait)` Conversion of GET-NEXT method (KW_GET_NEXT).
`integer`	`getNumResults()` Conversion of NUM-RESULTS attribute (KW_NUM_RES).
`OffEnd`	`getOffEnd()` Default implementation which reports that the query has the front off-end.
`java.util.ArrayList<QueryOffEndListener>`	`getOffEndListeners()` Get all the off-end listeners associated with this query.
`logical`	`getPrevious()` Conversion of GET-PREV method (KW_GET_PREV).
`logical`	`getPrevious(LockType lockType)` Conversion of GET-PREV method (KW_GET_PREV).
`logical`	`getPrevious(long lock)` Conversion of GET-PREV method (KW_GET_PREV).
`logical`	`getPrevious(long lock, long nowait)` Conversion of GET-PREV method (KW_GET_PREV).
`logical`	`getPrevious(long lock, NumberType nowait)` Conversion of GET-PREV method (KW_GET_PREV).
`logical`	`getPrevious(NumberType lock)` Conversion of GET-PREV method (KW_GET_PREV).
`logical`	`getPrevious(NumberType lock, long nowait)` Conversion of GET-PREV method (KW_GET_PREV).
`logical`	`getPrevious(NumberType lock, NumberType nowait)` Conversion of GET-PREV method (KW_GET_PREV).
`int`	`getTableCount()` Get the number of tables joined by this query.
`logical`	`hasAny()` Indicate whether a request to find the first result of this query would succeed or fail.
`logical`	`hasAny(LockType lockType)` Indicate whether a request to find the first result of this query would succeed or fail.
`logical`	`hasAny(java.lang.Object[] values)` Indicate whether a request to find the first result of this query would succeed or fail.
`logical`	`hasAny(java.lang.Object[] values, LockType lockType)` Indicate whether a request to find the first result of this query would succeed or fail.
`logical`	`hasOne()` Indicate whether this query would produce a unique result.
`logical`	`hasOne(LockType lockType)` Indicate whether this query would produce a unique result.
`logical`	`hasOne(java.lang.Object[] values)` Indicate whether this query would produce a unique result.
`logical`	`hasOne(java.lang.Object[] values, LockType lockType)` Indicate whether this query would produce a unique result.
`void`	`include(DataModelObject dmo, java.lang.String... fields)` No-op.
`character`	`indexInformation()` Conversion of INDEX-INFORMATION attribute (KW_IDX_INFO).
`character`	`indexInformation(int n)` Conversion of INDEX-INFORMATION attribute (KW_IDX_INFO).
`character`	`indexInformation(NumberType n)` Conversion of INDEX-INFORMATION attribute (KW_IDX_INFO).
`boolean`	`isBrowsed()` Is this query associated with a browse widget or not?
`boolean`	`isFetchOnReposition()` Default implementation which reports query is not set to fetch the next record after a reposition.
`boolean`	`isIndexedReposition()` Indicate whether this query is optimized using indexed reposition.
`boolean`	`isIterating()` Indicate whether the query is defined inside the scope of FOR EACH block.
`boolean`	`isNativelyPreselect()` Indicate whether this query is a preselect query by its nature.
`logical`	`isOffEnd()` Default implementation which reports the query is off-end.
`logical`	`isOpen()` Conversion of IS-OPEN attribute (KW_IS_OPEN).
`boolean`	`isPreselect()` Indicate whether this query preselects all of its results.
`boolean`	`isPresort()` Indicate whether the delegate query is of presort type.
`boolean`	`isScrolling()` Indicate whether this query was defined as SCROLLING.
`logical`	`isSkipDeletedRecord()` Get value of SKIP-DELETED-RECORD attribute of the query.
`boolean`	`isStandalone()` Indicate whether this query stands alone, or is the component of another query, or is wrapped by a query wrapper.
`boolean`	`last()` No-op.
`boolean`	`last(LockType lockType)` No-op.
`boolean`	`next()` No-op.
`boolean`	`next(LockType lockType)` No-op.
`void`	`notifyRepositionListeners(boolean closed, boolean error, int targetRepositionRow)` No-op.
`integer`	`numBuffers()` Conversion of NUM-BUFFERS() method (KW_NUM_BUFF).
`void`	`open()` No-op.
`logical`	`prepare(character predicate)` Compiles a predicate (query condition).
`logical`	`prepare(java.lang.String predicate)` Compiles a predicate (query condition).
`character`	`prepareString()` Conversion of PREPARE_STRING attribute (KW_PREP_STR).
`boolean`	`previous()` No-op.
`boolean`	`previous(LockType lockType)` No-op.
`logical`	`queryBackward(int rows)` Conversion of REPOSITION-BACKWARD() method (KW_REPOS_B).
`logical`	`queryBackward(NumberType rows)` Conversion of REPOSITION-BACKWARD() method (KW_REPOS_B).
`logical`	`queryClose()` Conversion of QUERY-CLOSE() method (KW_QRY_CLOS).
`logical`	`queryForward(int rows)` Conversion of REPOSITION-FORWARD() method (KW_REPOS_F).
`logical`	`queryForward(NumberType rows)` Conversion of REPOSITION-FORWARD() method (KW_REPOS_F).
`logical`	`queryOpen()` Opens a query object.
`logical`	`queryReposition(int n)` Conversion of REPOSITION-TO-ROW() method (KW_REPOS_2R).
`logical`	`queryReposition(NumberType n)` Conversion of REPOSITION-TO-ROW() method (KW_REPOS_2R).
`logical`	`queryRepositionByID(character rowId)` Conversion of REPOSITION-TO-ROWID() method (KW_REPOS_2I).
`logical`	`queryRepositionByID(rowid id1, rowid... joinIDs)` Conversion of REPOSITION-TO-ROWID() method (KW_REPOS_2I).
`void`	`releaseBuffers()` No-op.
`void`	`removeRepositionListener(RepositionListener listener)` No-op.
`void`	`reposition(int row)` No-op.
`void`	`reposition(NumberType row)` No-op.
`boolean`	`repositionByID(java.lang.Long... joinIDs)` No-op.
`void`	`repositionByID(recid id)` No-op.
`void`	`repositionByID(rowid id1, rowid... joinIDs)` No-op.
`void`	`setBrowsed(boolean browsed)` No-op.
`logical`	`setBuffers(Buffer... bufs)` Sets buffers for the query.
`logical`	`setBuffers(handle... hBuffers)` Sets buffers for the query.
`void`	`setCache(integer n)` Setter for the CACHE attribute.
`void`	`setCache(long n)` Setter for the CACHE attribute.
`void`	`setErrorIfNull(boolean errorIfNull)` No-op.
`void`	`setFetchOnReposition(boolean enable)` No-op.
`void`	`setIndexedReposition()` No-op.
`void`	`setIterating(boolean iterating)` Indicate whether the query is defined inside the scope of FOR EACH block.
`void`	`setLenientOffEnd(boolean lenientOffEnd)` Set the behavior of this query as a record retrieval request moves off the end of its results.
`void`	`setParameterFilter(ParameterFilter parameterFilter)` No-op.
`void`	`setPresort(boolean presort)` Indicate whether the delegate query is of presort type.
`void`	`setScrolling()` No-op.
`void`	`setSkipDeletedRecord(logical on)` Setter for SKIP-DELETED-RECORD query attribute.
`void`	`setStandalone(boolean standalone)` Change the standalone nature of this query.
`integer`	`size()` Default implementation which reports unknown value to indicate a closed query.
`boolean`	`unique()` No-op.
`boolean`	`unique(LockType lockType)` No-op.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.goldencode.p2j.persist.P2JQuery
addQueryEventListener, close, getBasicLogging, getDataRelation, getJoin, getNext, getRecordBuffers, hintFullResults, isDynamicPredicate, isFillingBrowseRows, isFindByRowid, isFirstOfGroup, isFirstOfGroup, isLastOfGroup, isLastOfGroup, notifyQueryCloseListeners, notifyQueryOpenListeners, resetQuery, setBasicLogging, setBasicLogging, setDataRelation, setDynamicPredicate, setFillingBrowseRows

Methods inherited from interface com.goldencode.p2j.persist.BufferCollection
addBuffer, addBuffer, setBuffers

- Constructor Detail
  - DefaultDelegate
```
private DefaultDelegate()
```
- Method Detail
  - clearResults
```
public void clearResults()
```
    No-op.
    
    Specified by:
    
    clearResults in interface P2JQuery
  - setScrolling
```
public void setScrolling()
```
    No-op.
    
    Specified by:
    
    setScrolling in interface P2JQuery
  - isScrolling
```
public boolean isScrolling()
```
    Indicate whether this query was defined as SCROLLING.
    
    Specified by:
    
    isScrolling in interface P2JQuery
    
    Returns:
    
    false.
  - setIndexedReposition
```
public void setIndexedReposition()
```
    No-op.
    
    Specified by:
    
    setIndexedReposition in interface P2JQuery
  - isIndexedReposition
```
public boolean isIndexedReposition()
```
    Indicate whether this query is optimized using indexed reposition.
    
    Specified by:
    
    isIndexedReposition in interface P2JQuery
    
    Returns:
    
    false.
  - open
```
public void open()
```
    No-op.
    
    Specified by:
    
    open in interface P2JQuery
  - close
```
public void close()
```
    No-op.
    
    Specified by:
    
    close in interface P2JQuery
  - getTableCount
```
public int getTableCount()
```
    Get the number of tables joined by this query.
    
    Specified by:
    
    getTableCount in interface P2JQuery
    
    Returns:
    
    0.
  - getOffEndListeners
```
public java.util.ArrayList<QueryOffEndListener> getOffEndListeners()
```
    Get all the off-end listeners associated with this query.
    
    Specified by:
    
    getOffEndListeners in interface P2JQuery
    
    Returns:
    
    the off-end listeners associated with this query.
  - addExternalBuffers
```
public P2JQuery addExternalBuffers(DataModelObject... dmos)
```
    Add one or more buffers to the list of those which this query references externally. These typically will be buffers referenced by converted CAN-FIND expressions embedded in the query's HQL expression, which are not the primary buffers associated with the query.
    No-op.
    
    Specified by:
    
    addExternalBuffers in interface P2JQuery
    
    Parameters:
    
    dmos - One or more external buffers.
    
    Returns:
    
    null.
  - setBrowsed
```
public void setBrowsed(boolean browsed)
```
    No-op.
    
    Specified by:
    
    setBrowsed in interface P2JQuery
    
    Parameters:
    
    browsed - Not used.
  - isBrowsed
```
public boolean isBrowsed()
```
    Is this query associated with a browse widget or not?
    
    Specified by:
    
    isBrowsed in interface P2JQuery
    
    Returns:
    
    false.
  - setErrorIfNull
```
public void setErrorIfNull(boolean errorIfNull)
```
    No-op.
    
    Specified by:
    
    setErrorIfNull in interface P2JQuery
    
    Parameters:
    
    errorIfNull - Not used.
  - addAccumulator
```
public void addAccumulator(Accumulator accum)
```
    No-op.
    
    Specified by:
    
    addAccumulator in interface P2JQuery
    
    Parameters:
    
    accum - Not used.
  - addAccumulator
```
public void addAccumulator(Accumulator accum,
                           boolean deferred)
```
    No-op.
    
    Specified by:
    
    addAccumulator in interface P2JQuery
    
    Parameters:
    
    accum - Not used.
    
    deferred - Not used.
  - first
```
public boolean first()
```
    No-op.
    
    Specified by:
    
    first in interface P2JQuery
    
    Returns:
    
    true if query could retrive the first record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - first
```
public boolean first(LockType lockType)
```
    No-op.
    
    Specified by:
    
    first in interface P2JQuery
    
    Parameters:
    
    lockType - Not used.
    
    Returns:
    
    true if query could retrive the first record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - last
```
public boolean last()
```
    No-op.
    
    Specified by:
    
    last in interface P2JQuery
    
    Returns:
    
    true if query could retrive the last record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - last
```
public boolean last(LockType lockType)
```
    No-op.
    
    Specified by:
    
    last in interface P2JQuery
    
    Parameters:
    
    lockType - Not used.
    
    Returns:
    
    true if query could retrive the last record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - next
```
public boolean next()
```
    No-op.
    
    Specified by:
    
    next in interface P2JQuery
    
    Returns:
    
    true if query could retrive the next record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - next
```
public boolean next(LockType lockType)
```
    No-op.
    
    Specified by:
    
    next in interface P2JQuery
    
    Parameters:
    
    lockType - Not used.
    
    Returns:
    
    true if query could retrive the next record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - previous
```
public boolean previous()
```
    No-op.
    
    Specified by:
    
    previous in interface P2JQuery
    
    Returns:
    
    true if query could retrive the previous record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - previous
```
public boolean previous(LockType lockType)
```
    No-op.
    
    Specified by:
    
    previous in interface P2JQuery
    
    Parameters:
    
    lockType - Not used.
    
    Returns:
    
    true if query could retrive the previous record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - unique
```
public boolean unique()
```
    No-op.
    
    Specified by:
    
    unique in interface P2JQuery
    
    Returns:
    
    true if query could retrive the unique record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - unique
```
public boolean unique(LockType lockType)
```
    No-op.
    
    Specified by:
    
    unique in interface P2JQuery
    
    Parameters:
    
    lockType - Not used.
    
    Returns:
    
    true if query could retrive the unique record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - current
```
public boolean current()
```
    No-op.
    
    Specified by:
    
    current in interface P2JQuery
    
    Returns:
    
    true if query could retrive the current record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - current
```
public boolean current(LockType lockType)
```
    No-op.
    
    Specified by:
    
    current in interface P2JQuery
    
    Parameters:
    
    lockType - Not used.
    
    Returns:
    
    true if query could retrive the current record succefully; false if unsuccessful and lenientOffEnd is set on true.
  - hasAny
```
public logical hasAny()
```
    Indicate whether a request to find the first result of this query would succeed or fail.
    Default substitution arguments and a lock type of NONE are used for this test.
    
    Specified by:
    
    hasAny in interface P2JQuery
    
    Returns:
    
    true if the first record exists, else false.
    
    Throws:
    
    java.lang.UnsupportedOperationException - always.
  - hasAny
```
public logical hasAny(java.lang.Object[] values)
```
    Indicate whether a request to find the first result of this query would succeed or fail.
    The specified substitution arguments and a lock type of NONE are used for this test.
    
    Specified by:
    
    hasAny in interface P2JQuery
    
    Parameters:
    
    values - Query substitution parameters.
    
    Returns:
    
    true if the first record exists, else false.
    
    Throws:
    
    java.lang.UnsupportedOperationException - always.
  - hasAny
```
public logical hasAny(LockType lockType)
```
    Indicate whether a request to find the first result of this query would succeed or fail.
    Default substitution arguments and the specified lock type are used for this test.
    
    Specified by:
    
    hasAny in interface P2JQuery
    
    Parameters:
    
    lockType - Lock type for the query. This lock is not actually acquired, only tested for availability.
    
    Returns:
    
    true if the first record exists, else false.
    
    Throws:
    
    java.lang.UnsupportedOperationException - always.
  - hasAny
```
public logical hasAny(java.lang.Object[] values,
                      LockType lockType)
```
    Indicate whether a request to find the first result of this query would succeed or fail.
    The specified substitution arguments and lock type are used for this test.
    
    Specified by:
    
    hasAny in interface P2JQuery
    
    Parameters:
    
    values - Query substitution parameters.
    
    lockType - Lock type for the query. This lock is not actually acquired, only tested for availability.
    
    Returns:
    
    true if the first record exists, else false.
    
    Throws:
    
    java.lang.UnsupportedOperationException - always.
  - hasOne
```
public logical hasOne()
```
    Indicate whether this query would produce a unique result.
    Default substitution arguments and a lock type of NONE are used for this test.
    
    Specified by:
    
    hasOne in interface P2JQuery
    
    Returns:
    
    true if any record matching the query's criteria exists, else false.
    
    Throws:
    
    java.lang.UnsupportedOperationException - always.
  - hasOne
```
public logical hasOne(java.lang.Object[] values)
```
    Indicate whether this query would produce a unique result.
    The specified substitution arguments and a lock type of NONE are used for this test.
    
    Specified by:
    
    hasOne in interface P2JQuery
    
    Parameters:
    
    values - Query substitution parameters.
    
    Returns:
    
    true if any record matching the query's criteria exists, else false.
    
    Throws:
    
    java.lang.UnsupportedOperationException - always.
  - hasOne
```
public logical hasOne(LockType lockType)
```
    Indicate whether this query would produce a unique result.
    Default substitution arguments and the specified lock type are used for this test.
    
    Specified by:
    
    hasOne in interface P2JQuery
    
    Parameters:
    
    lockType - Lock type for the query. This lock is not actually acquired, only tested for availability.
    
    Returns:
    
    true if any record matching the query's criteria exists, else false.
    
    Throws:
    
    java.lang.UnsupportedOperationException - always.
  - hasOne
```
public logical hasOne(java.lang.Object[] values,
                      LockType lockType)
```
    Indicate whether this query would produce a unique result.
    The specified substitution arguments and lock type are used for this test.
    
    Specified by:
    
    hasOne in interface P2JQuery
    
    Parameters:
    
    values - Query substitution parameters.
    
    lockType - Lock type for the query. This lock is not actually acquired, only tested for availability.
    
    Returns:
    
    true if any record matching the query's criteria exists, else false.
    
    Throws:
    
    java.lang.UnsupportedOperationException - always.
  - isFetchOnReposition
```
public boolean isFetchOnReposition()
```
    Default implementation which reports query is not set to fetch the next record after a reposition.
    
    Specified by:
    
    isFetchOnReposition in interface P2JQuery
    
    Returns:
    
    false.
  - setFetchOnReposition
```
public void setFetchOnReposition(boolean enable)
```
    No-op.
    
    Specified by:
    
    setFetchOnReposition in interface P2JQuery
    
    Parameters:
    
    enable - Not used.
  - addRepositionListener
```
public void addRepositionListener(RepositionListener listener)
```
    No-op.
    
    Specified by:
    
    addRepositionListener in interface P2JQuery
    
    Parameters:
    
    listener - Not used.
  - removeRepositionListener
```
public void removeRepositionListener(RepositionListener listener)
```
    No-op.
    
    Specified by:
    
    removeRepositionListener in interface P2JQuery
    
    Parameters:
    
    listener - Not used.
  - repositionByID
```
public void repositionByID(recid id)
```
    No-op.
    
    Specified by:
    
    repositionByID in interface P2JQuery
    
    Parameters:
    
    id - Not used.
  - repositionByID
```
public void repositionByID(rowid id1,
                           rowid... joinIDs)
```
    No-op.
    
    Specified by:
    
    repositionByID in interface P2JQuery
    
    Parameters:
    
    id1 - Not used.
    
    joinIDs - Not used.
  - repositionByID
```
public boolean repositionByID(java.lang.Long... joinIDs)
```
    No-op.
    
    Specified by:
    
    repositionByID in interface P2JQuery
    
    Parameters:
    
    joinIDs - Not used.
    
    Returns:
    
    Always true.
  - reposition
```
public void reposition(NumberType row)
```
    No-op.
    
    Specified by:
    
    reposition in interface P2JQuery
    
    Parameters:
    
    row - Not used.
  - reposition
```
public void reposition(int row)
```
    No-op.
    
    Specified by:
    
    reposition in interface P2JQuery
    
    Parameters:
    
    row - Not used.
  - forward
```
public boolean forward(NumberType rows)
```
    No-op.
    
    Specified by:
    
    forward in interface P2JQuery
    
    Parameters:
    
    rows - Not used.
    
    Returns:
    
    true if operation was successful and the cursor was moved the exact amount of rows as specified by the parameter. If false is returned then it is possible that cursor's position was moved but not with rows rows.
  - forward
```
public boolean forward(int rows)
```
    No-op.
    
    Specified by:
    
    forward in interface P2JQuery
    
    Parameters:
    
    rows - Not used.
    
    Returns:
    
    true if operation was successful and the cursor was moved the exact amount of rows as specified by the parameter. If false is returned then it is possible that cursor's position was moved but not with rows rows.
  - backward
```
public boolean backward(NumberType rows)
```
    No-op.
    
    Specified by:
    
    backward in interface P2JQuery
    
    Parameters:
    
    rows - Not used.
    
    Returns:
    
    true if operation was successful and the cursor was moved the exact amount of rows as specified by the parameter. If false is returned then it is possible that cursor's position was moved but not with rows rows.
  - backward
```
public boolean backward(int rows)
```
    No-op.
    
    Specified by:
    
    backward in interface P2JQuery
    
    Parameters:
    
    rows - Not used.
    
    Returns:
    
    true if operation was successful and the cursor was moved the exact amount of rows as specified by the parameter. If false is returned then it is possible that cursor's position was moved but not with rows rows.
  - size
```
public integer size()
```
    Default implementation which reports unknown value to indicate a closed query.
    
    Specified by:
    
    size in interface P2JQuery
    
    Returns:
    
    unknown value.
  - currentRow
```
public integer currentRow()
```
    Default implementation which reports unknown value as the current row to indicate an empty results list.
    
    Specified by:
    
    currentRow in interface P2JQuery
    
    Returns:
    
    Unknown value.
  - currentRowImpl
```
public integer currentRowImpl()
```
    Default implementation which reports unknown value as the current row to indicate an empty results list.
    
    Specified by:
    
    currentRowImpl in interface P2JQuery
    
    Returns:
    
    Unknown value.
  - isOffEnd
```
public logical isOffEnd()
```
    Default implementation which reports the query is off-end.
    
    Specified by:
    
    isOffEnd in interface P2JQuery
    
    Returns:
    
    true.
  - _isOffEnd
```
public boolean _isOffEnd()
```
    Default implementation which reports the query is off-end.
    
    Specified by:
    
    _isOffEnd in interface P2JQuery
    
    Returns:
    
    true.
  - getOffEnd
```
public OffEnd getOffEnd()
```
    Default implementation which reports that the query has the front off-end.
    
    Specified by:
    
    getOffEnd in interface P2JQuery
    
    Returns:
    
    OffEnd.FRONT constant.
  - isPreselect
```
public boolean isPreselect()
```
    Indicate whether this query preselects all of its results.
    
    Specified by:
    
    isPreselect in interface P2JQuery
    
    Returns:
    
    false.
  - isNativelyPreselect
```
public boolean isNativelyPreselect()
```
    Indicate whether this query is a preselect query by its nature.
    
    Specified by:
    
    isNativelyPreselect in interface P2JQuery
    
    Returns:
    
    true.
  - notifyRepositionListeners
```
public void notifyRepositionListeners(boolean closed,
                                      boolean error,
                                      int targetRepositionRow)
```
    No-op.
    
    Specified by:
    
    notifyRepositionListeners in interface P2JQuery
    
    Parameters:
    
    closed - Not used.
    
    error - Not used.
    
    targetRepositionRow - Not used.
  - isStandalone
```
public boolean isStandalone()
```
    Indicate whether this query stands alone, or is the component of another query, or is wrapped by a query wrapper.
    
    Specified by:
    
    isStandalone in interface P2JQuery
    
    Returns:
    
    false.
  - setStandalone
```
public void setStandalone(boolean standalone)
```
    Change the standalone nature of this query. A query is standalone by default, but can be changed to non-standalone by the wrapper or container which contains it.
    This implementation is a no-op.
    
    Specified by:
    
    setStandalone in interface P2JQuery
    
    Parameters:
    
    standalone - true to set query as standalone; false to set query as contained.
  - cleanup
```
public void cleanup()
```
    No-op.
    
    Specified by:
    
    cleanup in interface P2JQuery
  - bufferHandle
```
public handle bufferHandle()
```
    Conversion of GET-BUFFER-HANDLE() method (KW_GET_BUFH). Returns a handle of the first buffer of a query object.
    
    Specified by:
    
    bufferHandle in interface BufferCollection
    
    Returns:
    
    unknown buffer handle
  - bufferHandle
```
public handle bufferHandle(java.lang.String bufferName)
```
    Conversion of GET-BUFFER-HANDLE() method (KW_GET_BUFH). Returns a handle of a particular buffer of a query object.
    
    Specified by:
    
    bufferHandle in interface BufferCollection
    
    Parameters:
    
    bufferName - buffer-name. A CHARACTER expression that evaluates to the name of a buffer in the query or DataSet object.
    
    Returns:
    
    Unknown buffer handle.
  - bufferHandle
```
public handle bufferHandle(character bufferName)
```
    Conversion of GET-BUFFER-HANDLE() method (KW_GET_BUFH). Returns a handle of a particular buffer of a query object.
    
    Specified by:
    
    bufferHandle in interface BufferCollection
    
    Parameters:
    
    bufferName - buffer-name. A CHARACTER expression that evaluates to the name of a buffer in the query or DataSet object.
    
    Returns:
    
    Unknown buffer handle.
  - bufferHandle
```
public handle bufferHandle(int bufferSequenceNumber)
```
    Conversion of GET-BUFFER-HANDLE() method (KW_GET_BUFH). Returns a handle of a particular buffer of a query object.
    
    Specified by:
    
    bufferHandle in interface BufferCollection
    
    Parameters:
    
    bufferSequenceNumber - buffer-sequence-number. An INTEGER that represents the sequence number of the desired buffer.
    
    Returns:
    
    Unknown buffer handle.
  - bufferHandle
```
public handle bufferHandle(int64 bufferSequenceNumber)
```
    Conversion of GET-BUFFER-HANDLE() method (KW_GET_BUFH). Returns a handle of a particular buffer of a query object.
    
    Specified by:
    
    bufferHandle in interface BufferCollection
    
    Parameters:
    
    bufferSequenceNumber - buffer-sequence-number. An INTEGER that represents the sequence number of the desired buffer.
    
    Returns:
    
    Unknown buffer handle.
  - queryClose
```
public logical queryClose()
```
    Conversion of QUERY-CLOSE() method (KW_QRY_CLOS). Closes a query object.
    
    Specified by:
    
    queryClose in interface P2JQuery
    
    Returns:
    
    false.
  - queryBackward
```
public logical queryBackward(int rows)
```
    Conversion of REPOSITION-BACKWARD() method (KW_REPOS_B). Moves a query object's result list pointer backward a particular number of rows.
    
    Specified by:
    
    queryBackward in interface P2JQuery
    
    Returns:
    
    false.
  - queryBackward
```
public logical queryBackward(NumberType rows)
```
    Conversion of REPOSITION-BACKWARD() method (KW_REPOS_B). Moves a query object's result list pointer backward a particular number of rows.
    
    Specified by:
    
    queryBackward in interface P2JQuery
    
    Returns:
    
    false.
  - queryForward
```
public logical queryForward(int rows)
```
    Conversion of REPOSITION-FORWARD() method (KW_REPOS_F). Moves a query object's result list pointer forward a particular number of rows.
    
    Specified by:
    
    queryForward in interface P2JQuery
    
    Returns:
    
    false.
  - queryForward
```
public logical queryForward(NumberType rows)
```
    Conversion of REPOSITION-FORWARD() method (KW_REPOS_F). Moves a query object's result list pointer forward a particular number of rows.
    
    Specified by:
    
    queryForward in interface P2JQuery
    
    Returns:
    
    false.
  - queryReposition
```
public logical queryReposition(int n)
```
    Conversion of REPOSITION-TO-ROW() method (KW_REPOS_2R). Moves a query object's result list pointer to the row corresponding to the specified sequence number.
    
    Specified by:
    
    queryReposition in interface P2JQuery
    
    Parameters:
    
    n - An integer expression representing the sequence number.
    
    Returns:
    
    false.
  - queryReposition
```
public logical queryReposition(NumberType n)
```
    Conversion of REPOSITION-TO-ROW() method (KW_REPOS_2R). Moves a query object's result list pointer to the row corresponding to the specified sequence number.
    
    Specified by:
    
    queryReposition in interface P2JQuery
    
    Parameters:
    
    n - An integer expression representing the sequence number.
    
    Returns:
    
    false.
  - queryRepositionByID
```
public logical queryRepositionByID(rowid id1,
                                   rowid... joinIDs)
```
    Conversion of REPOSITION-TO-ROWID() method (KW_REPOS_2I). Reposition the cursor such that a request to retrieve the next result will retrieve the result which matches the specified array of primary key IDs. A request to retrieve the previous result will retrieve the result immediately previous to this, if any, in the results list.
    
    Specified by:
    
    queryRepositionByID in interface P2JQuery
    
    Parameters:
    
    id1 - A primary key ID, representing the target record (in the case of a join, this ID is associated with the left-most record in the join).
    
    joinIDs - All remaining primary key IDs, if any, arranged from left to right to coincide with the records being joined by the underlying query.
    
    Returns:
    
    false.
  - queryRepositionByID
```
public logical queryRepositionByID(character rowId)
```
    Conversion of REPOSITION-TO-ROWID() method (KW_REPOS_2I). Reposition the cursor such that a request to retrieve the next result will retrieve the result which matches the specified array of primary key IDs. A request to retrieve the previous result will retrieve the result immediately previous to this, if any, in the results list.
    
    Specified by:
    
    queryRepositionByID in interface P2JQuery
    
    Parameters:
    
    rowId - A character representation of this rowid.
    
    Returns:
    
    true if REPOSITION-TO-ROWID() succeeds, else false.
  - getNumResults
```
public integer getNumResults()
```
    Conversion of NUM-RESULTS attribute (KW_NUM_RES). Getter of NUM-RESULTS attribute
    
    Specified by:
    
    getNumResults in interface P2JQuery
    
    Returns:
    
    Unknown value.
  - addBuffer
```
public logical addBuffer(handle bufHandle)
```
    Adds one new buffer to a query object or dynamic DataSet object, without affecting the other buffers, if any. Use the SET-BUFFERS( ) method to remove all prior buffers and set all buffers for the object at the same time.
    
    Specified by:
    
    addBuffer in interface BufferCollection
    
    Parameters:
    
    bufHandle - A buffer handle to add.
    
    Returns:
    
    false.
  - addBuffer
```
public logical addBuffer(Buffer buf)
```
    Adds one new buffer to a query object or dynamic DataSet object, without affecting the other buffers, if any. Use the SET-BUFFERS( ) method to remove all prior buffers and set all buffers for the object at the same time.
    
    Specified by:
    
    addBuffer in interface BufferCollection
    
    Parameters:
    
    buf - A buffer to add.
    
    Returns:
    
    false.
  - setBuffers
```
public logical setBuffers(handle... hBuffers)
```
    Sets buffers for the query. Any buffers previously added or set are removed. Use the addBuffer() method to add one buffer to the object, without affecting the other buffers, if any. This method is the equivalent of SET-BUFFERS() method from 4GL.
    
    Specified by:
    
    setBuffers in interface BufferCollection
    
    Parameters:
    
    hBuffers - Variable argument list of buffer handles to be set. In 4GL, the maximum number of buffers per query is 18.
    
    Returns:
    
    false.
  - setBuffers
```
public logical setBuffers(Buffer... bufs)
```
    Sets buffers for the query. Any buffers previously added or set are removed. Use the addBuffer() method to add one buffer to the object, without affecting the other buffers, if any. This method is the equivalent of SET-BUFFERS() method from 4GL.
    
    Specified by:
    
    setBuffers in interface BufferCollection
    
    Parameters:
    
    bufs - Variable argument list of Buffer to be set. In 4GL, the maximum number of buffers per query is 18.
    
    Returns:
    
    true on success
  - prepare
```
public logical prepare(java.lang.String predicate)
```
    Compiles a predicate (query condition). This method is the equivalent of QUERY-PREPARE() method from 4GL.
    
    Specified by:
    
    prepare in interface P2JQuery
    
    Parameters:
    
    predicate - The predicate to be prepared by this query.
    
    Returns:
    
    false.
  - prepare
```
public logical prepare(character predicate)
```
    Compiles a predicate (query condition). This method is the equivalent of QUERY-PREPARE() method from 4GL.
    
    Specified by:
    
    prepare in interface P2JQuery
    
    Parameters:
    
    predicate - The predicate to be prepared by this query.
    
    Returns:
    
    false.
  - queryOpen
```
public logical queryOpen()
```
    Opens a query object. This method is the equivalent of QUERY-OPEN() method from 4GL. Note: You must perform prepare() on a query object before you perform queryOpen on it.
    
    Specified by:
    
    queryOpen in interface P2JQuery
    
    Returns:
    
    true on success
  - indexInformation
```
public character indexInformation()
```
    Conversion of INDEX-INFORMATION attribute (KW_IDX_INFO). Getter of INDEX-INFORMATION attribute.
    
    Specified by:
    
    indexInformation in interface IndexInformation
    
    Specified by:
    
    indexInformation in interface P2JQuery
    
    Returns:
    
    Unknown value.
  - indexInformation
```
public character indexInformation(int n)
```
    Conversion of INDEX-INFORMATION attribute (KW_IDX_INFO). Getter of INDEX-INFORMATION attribute
    
    Specified by:
    
    indexInformation in interface IndexInformation
    
    Specified by:
    
    indexInformation in interface P2JQuery
    
    Parameters:
    
    n - An integer expression that evaluates to the level of join for which you want index information.
    
    Returns:
    
    Unknown value.
  - indexInformation
```
public character indexInformation(NumberType n)
```
    Conversion of INDEX-INFORMATION attribute (KW_IDX_INFO). Getter of INDEX-INFORMATION attribute
    
    Specified by:
    
    indexInformation in interface IndexInformation
    
    Specified by:
    
    indexInformation in interface P2JQuery
    
    Parameters:
    
    n - An integer expression that evaluates to the level of join for which you want index information.
    
    Returns:
    
    Unknown value.
  - forwardOnly
```
public logical forwardOnly()
```
    Conversion of FORWARD-ONLY attribute (KW_FWD_ONLY). Getter of FORWARD-ONLY attribute.
    
    Specified by:
    
    forwardOnly in interface P2JQuery
    
    Returns:
    
    false.
  - changeForwardOnly
```
public void changeForwardOnly(logical forwardOnly)
```
    Conversion of FORWARD-ONLY attribute (KW_FWD_ONLY). Setter of FORWARD-ONLY attribute.
    
    Specified by:
    
    changeForwardOnly in interface P2JQuery
    
    Parameters:
    
    forwardOnly - New value of FORWARD-ONLY attribute.
  - changeForwardOnly
```
public void changeForwardOnly(boolean forwardOnly)
```
    Conversion of FORWARD-ONLY attribute (KW_FWD_ONLY). Setter of FORWARD-ONLY attribute.
    
    Specified by:
    
    changeForwardOnly in interface P2JQuery
    
    Parameters:
    
    forwardOnly - New value of FORWARD-ONLY attribute.
  - prepareString
```
public character prepareString()
```
    Conversion of PREPARE_STRING attribute (KW_PREP_STR). Getter of PREPARE_STRING attribute.
    
    Specified by:
    
    prepareString in interface P2JQuery
    
    Returns:
    
    Unknown value.
  - getCache
```
public integer getCache()
```
    Getter for the CACHE attribute.
    
    Specified by:
    
    getCache in interface P2JQuery
    
    Returns:
    
    See above.
  - setCache
```
public void setCache(integer n)
```
    Setter for the CACHE attribute.
    
    Specified by:
    
    setCache in interface P2JQuery
    
    Parameters:
    
    n - The cache value.
  - setCache
```
public void setCache(long n)
```
    Setter for the CACHE attribute.
    
    Specified by:
    
    setCache in interface P2JQuery
    
    Parameters:
    
    n - The cache value.
  - isOpen
```
public logical isOpen()
```
    Conversion of IS-OPEN attribute (KW_IS_OPEN). Getter of IS-OPEN attribute.
    
    Specified by:
    
    isOpen in interface Openable
    
    Returns:
    
    current value of IS-OPEN attribute.
  - _getNext
```
public boolean _getNext()
```
    Conversion of GET-NEXT method (KW_GET_NEXT). Moves a query object's result list pointer ahead one row.
    
    Specified by:
    
    _getNext in interface P2JQuery
    
    Returns:
    
    false.
  - getNext
```
public logical getNext(LockType lockType)
```
    Conversion of GET-NEXT method (KW_GET_NEXT). Moves a query object's result list pointer ahead one row.
    
    Specified by:
    
    getNext in interface P2JQuery
    
    Parameters:
    
    lockType - Lock type.
    
    Returns:
    
    false.
  - getNext
```
public logical getNext(long lock)
```
    Conversion of GET-NEXT method (KW_GET_NEXT). Moves a query object's result list pointer ahead one row.
    
    Specified by:
    
    getNext in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock has not valid internal value.
  - getNext
```
public logical getNext(NumberType lock)
```
    Conversion of GET-NEXT method (KW_GET_NEXT). Moves a query object's result list pointer ahead one row.
    
    Specified by:
    
    getNext in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock has not valid internal value.
  - getNext
```
public logical getNext(long lock,
                       long nowait)
```
    Conversion of GET-NEXT method (KW_GET_NEXT). Moves a query object's result list pointer ahead one row.
    
    Specified by:
    
    getNext in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getNext
```
public logical getNext(long lock,
                       NumberType nowait)
```
    Conversion of GET-NEXT method (KW_GET_NEXT). Moves a query object's result list pointer ahead one row.
    
    Specified by:
    
    getNext in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getNext
```
public logical getNext(NumberType lock,
                       long nowait)
```
    Conversion of GET-NEXT method (KW_GET_NEXT). Moves a query object's result list pointer ahead one row.
    
    Specified by:
    
    getNext in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getNext
```
public logical getNext(NumberType lock,
                       NumberType nowait)
```
    Conversion of GET-NEXT method (KW_GET_NEXT). Moves a query object's result list pointer ahead one row.
    
    Specified by:
    
    getNext in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getPrevious
```
public logical getPrevious()
```
    Conversion of GET-PREV method (KW_GET_PREV). Moves a query object's result list pointer back one row.
    
    Specified by:
    
    getPrevious in interface P2JQuery
    
    Returns:
    
    false.
  - getPrevious
```
public logical getPrevious(long lock)
```
    Conversion of GET-PREV method (KW_GET_PREV). Moves a query object's result list pointer back one row.
    
    Specified by:
    
    getPrevious in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock has not valid internal value.
  - getPrevious
```
public logical getPrevious(LockType lockType)
```
    Conversion of GET-PREV method (KW_GET_PREV). Moves a query object's result list pointer back one row.
    
    Specified by:
    
    getPrevious in interface P2JQuery
    
    Parameters:
    
    lockType - Lock type.
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock has not valid internal value.
  - getPrevious
```
public logical getPrevious(NumberType lock)
```
    Conversion of GET-PREV method (KW_GET_PREV). Moves a query object's result list pointer back one row.
    
    Specified by:
    
    getPrevious in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock has not valid internal value.
  - getPrevious
```
public logical getPrevious(long lock,
                           long nowait)
```
    Conversion of GET-PREV method (KW_GET_PREV). Moves a query object's result list pointer back one row.
    
    Specified by:
    
    getPrevious in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getPrevious
```
public logical getPrevious(NumberType lock,
                           long nowait)
```
    Conversion of GET-PREV method (KW_GET_PREV). Moves a query object's result list pointer back one row.
    
    Specified by:
    
    getPrevious in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getPrevious
```
public logical getPrevious(long lock,
                           NumberType nowait)
```
    Conversion of GET-PREV method (KW_GET_PREV). Moves a query object's result list pointer back one row.
    
    Specified by:
    
    getPrevious in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getPrevious
```
public logical getPrevious(NumberType lock,
                           NumberType nowait)
```
    Conversion of GET-PREV method (KW_GET_PREV). Moves a query object's result list pointer back one row.
    
    Specified by:
    
    getPrevious in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getFirst
```
public logical getFirst()
```
    Conversion of GET-FIRST method (KW_GET_1ST). Moves a query object's result list pointer to the first row.
    
    Specified by:
    
    getFirst in interface P2JQuery
    
    Returns:
    
    false.
  - getFirst
```
public logical getFirst(long lock)
```
    Conversion of GET-FIRST method (KW_GET_1ST). Moves a query object's result list pointer to the first row.
    
    Specified by:
    
    getFirst in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock has not valid internal value.
  - getFirst
```
public logical getFirst(NumberType lock)
```
    Conversion of GET-FIRST method (KW_GET_1ST). Moves a query object's result list pointer to the first row.
    
    Specified by:
    
    getFirst in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock has not valid internal value.
  - getFirst
```
public logical getFirst(LockType lockType)
```
    Conversion of GET-FIRST method (KW_GET_1ST). Moves a query object's result list pointer to the first row.
    
    Specified by:
    
    getFirst in interface P2JQuery
    
    Parameters:
    
    lockType - Lock type.
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock has not valid internal value.
  - getFirst
```
public logical getFirst(long lock,
                        long nowait)
```
    Conversion of GET-FIRST method (KW_GET_1ST). Moves a query object's result list pointer to the first row.
    
    Specified by:
    
    getFirst in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getFirst
```
public logical getFirst(NumberType lock,
                        long nowait)
```
    Conversion of GET-FIRST method (KW_GET_1ST). Moves a query object's result list pointer to the first row.
    
    Specified by:
    
    getFirst in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getFirst
```
public logical getFirst(long lock,
                        NumberType nowait)
```
    Conversion of GET-FIRST method (KW_GET_1ST). Moves a query object's result list pointer to the first row.
    
    Specified by:
    
    getFirst in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getFirst
```
public logical getFirst(NumberType lock,
                        NumberType nowait)
```
    Conversion of GET-FIRST method (KW_GET_1ST). Moves a query object's result list pointer to the first row.
    
    Specified by:
    
    getFirst in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getLast
```
public logical getLast()
```
    Conversion of GET-LAST method (KW_GET_LAST). Moves a query object's result list pointer to the last row.
    
    Specified by:
    
    getLast in interface P2JQuery
    
    Returns:
    
    false.
  - getLast
```
public logical getLast(long lock)
```
    Conversion of GET-LAST method (KW_GET_LAST). Moves a query object's result list pointer to the last row.
    
    Specified by:
    
    getLast in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock has not valid internal value.
  - getLast
```
public logical getLast(NumberType lock)
```
    Conversion of GET-LAST method (KW_GET_LAST). Moves a query object's result list pointer to the last row.
    
    Specified by:
    
    getLast in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock has not valid internal value.
  - getLast
```
public logical getLast(LockType lockType)
```
    Conversion of GET-LAST method (KW_GET_LAST). Moves a query object's result list pointer to the last row.
    
    Specified by:
    
    getLast in interface P2JQuery
    
    Parameters:
    
    lockType - Lock type.
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock has not valid internal value.
  - getLast
```
public logical getLast(long lock,
                       long nowait)
```
    Conversion of GET-LAST method (KW_GET_LAST). Moves a query object's result list pointer to the last row.
    
    Specified by:
    
    getLast in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getLast
```
public logical getLast(NumberType lock,
                       long nowait)
```
    Conversion of GET-LAST method (KW_GET_LAST). Moves a query object's result list pointer to the last row.
    
    Specified by:
    
    getLast in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getLast
```
public logical getLast(long lock,
                       NumberType nowait)
```
    Conversion of GET-LAST method (KW_GET_LAST). Moves a query object's result list pointer to the last row.
    
    Specified by:
    
    getLast in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getLast
```
public logical getLast(NumberType lock,
                       NumberType nowait)
```
    Conversion of GET-LAST method (KW_GET_LAST). Moves a query object's result list pointer to the last row.
    
    Specified by:
    
    getLast in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
    
    Throws:
    
    java.lang.IllegalArgumentException - if lock or nowait have not valid internal values.
  - getCurrent
```
public logical getCurrent()
```
    Conversion of GET-CURRENT() method (KW_GET_CUR). Refetches the current record or records associated with the query.
    
    Specified by:
    
    getCurrent in interface P2JQuery
    
    Returns:
    
    false.
  - getCurrent
```
public logical getCurrent(long lock)
```
    Conversion of GET-CURRENT() method (KW_GET_CUR). Refetches the current record or records associated with the query.
    
    Specified by:
    
    getCurrent in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    Returns:
    
    false.
  - getCurrent
```
public logical getCurrent(NumberType lock)
```
    Conversion of GET-CURRENT() method (KW_GET_CUR). Refetches the current record or records associated with the query.
    
    Specified by:
    
    getCurrent in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    Returns:
    
    false.
  - getCurrent
```
public logical getCurrent(LockType lockType)
```
    Conversion of GET-CURRENT() method (KW_GET_CUR). Refetches the current record or records associated with the query.
    
    Specified by:
    
    getCurrent in interface P2JQuery
    
    Parameters:
    
    lockType - Lock type.
    
    Returns:
    
    false.
  - getCurrent
```
public logical getCurrent(long lock,
                          long nowait)
```
    Conversion of GET-CURRENT() method (KW_GET_CUR). Refetches the current record or records associated with the query.
    
    Specified by:
    
    getCurrent in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
  - getCurrent
```
public logical getCurrent(NumberType lock,
                          long nowait)
```
    Conversion of GET-CURRENT() method (KW_GET_CUR). Refetches the current record or records associated with the query.
    
    Specified by:
    
    getCurrent in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
  - getCurrent
```
public logical getCurrent(long lock,
                          NumberType nowait)
```
    Conversion of GET-CURRENT() method (KW_GET_CUR). Refetches the current record or records associated with the query.
    
    Specified by:
    
    getCurrent in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
  - getCurrent
```
public logical getCurrent(NumberType lock,
                          NumberType nowait)
```
    Conversion of GET-CURRENT() method (KW_GET_CUR). Refetches the current record or records associated with the query.
    
    Specified by:
    
    getCurrent in interface P2JQuery
    
    Parameters:
    
    lock - SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCK
    
    nowait - NO-WAIT
    
    Returns:
    
    false.
  - numBuffers
```
public integer numBuffers()
```
    Conversion of NUM-BUFFERS() method (KW_NUM_BUFF).
    
    Specified by:
    
    numBuffers in interface BufferCollection
    
    Returns:
    
    the number of buffers in a query or DataSet object.
  - setSkipDeletedRecord
```
public void setSkipDeletedRecord(logical on)
```
    Setter for SKIP-DELETED-RECORD query attribute.
    
    Specified by:
    
    setSkipDeletedRecord in interface P2JQuery
    
    Parameters:
    
    on - New value for the attribute.
  - isSkipDeletedRecord
```
public logical isSkipDeletedRecord()
```
    Get value of SKIP-DELETED-RECORD attribute of the query.
    
    Specified by:
    
    isSkipDeletedRecord in interface P2JQuery
    
    Returns:
    
    the value of SKIP-DELETED-RECORD attribute of the query.
  - include
```
public void include(DataModelObject dmo,
                    java.lang.String... fields)
```
    No-op.
    
    Specified by:
    
    include in interface P2JQuery
    
    Parameters:
    
    dmo - Not used.
    
    fields - Not used.
  - exclude
```
public void exclude(DataModelObject dmo,
                    java.lang.String... fields)
```
    No-op.
    
    Specified by:
    
    exclude in interface P2JQuery
    
    Parameters:
    
    dmo - Not used.
    
    fields - Not used.
  - deleteResultListEntry
```
public logical deleteResultListEntry()
```
    No-op.
    
    Specified by:
    
    deleteResultListEntry in interface P2JQuery
    
    Returns:
    
    false.
  - deleteResultListEntry
```
public logical deleteResultListEntry(boolean allowBetweenRows)
```
    No-op.
    
    Specified by:
    
    deleteResultListEntry in interface P2JQuery
    
    Parameters:
    
    allowBetweenRows - If true then the cursor can be positioned between rows (the next row will be deleted). false for conventional DELETE-RESULT-LIST-ENTRY() mode where the cursor should be positioned on a row (otherwise false is returned).
    
    Returns:
    
    false.
  - createResultListEntry
```
public logical createResultListEntry()
```
    No-op.
    
    Specified by:
    
    createResultListEntry in interface P2JQuery
    
    Returns:
    
    false.
  - setParameterFilter
```
public void setParameterFilter(ParameterFilter parameterFilter)
```
    No-op.
    
    Specified by:
    
    setParameterFilter in interface P2JQuery
    
    Parameters:
    
    parameterFilter - Not used.
  - releaseBuffers
```
public void releaseBuffers()
```
    No-op.
    
    Specified by:
    
    releaseBuffers in interface P2JQuery
  - addDynamicFilter
```
public boolean addDynamicFilter(FieldReference fr,
                                BaseDataType val,
                                java.lang.String format)
```
    Adds a new constraint term to the where predicate of this query, effectively filtering out any rows whose referenced field does not match the requested value. Semantically, the query will select rows that match
    new-where := (fr = val) AND (old-query).
    Note: The constraints are exclusive meaning that if constraints will be added for same field of same buffer, the query will return an empty result because the field cannot be at the same time equals to two different values.
    Use clearDynamicFilters() to clean all dynamically added criteria and restore the sorting order of the query to its original form.
    
    Specified by:
    
    addDynamicFilter in interface P2JQuery
    
    Parameters:
    
    fr - A reference to field used as filtering criterion. Only the rows that matches the specified value for this field will be selected. Must not be null.
    
    val - The filtering value for this constraint. Can be null or unknown, in which case the SQL null value will be assumed. In this case the predicate will look like:
    new-where := (fr IS NULL) AND (old-query)
    
    format - The format to be used when comparing values. The reason for this parameter is that for some datatype (ex: decimal) the on-screen value can be different from the database (because of rounding).
    
    Returns:
    
    true if the filtering constraint was successfully added. If the field reference is not related to the buffer(s) of this query, false is returned.
  - clearDynamicFilters
```
public void clearDynamicFilters()
```
    Clears any dynamically filters added at runtime. The query predicate will be restored to its form from generated at conversion time.
    
    Specified by:
    
    clearDynamicFilters in interface P2JQuery
  - setLenientOffEnd
```
public void setLenientOffEnd(boolean lenientOffEnd)
```
    Description copied from interface: P2JQuery
    
    Set the behavior of this query as a record retrieval request moves off the end of its results. If set to lenient mode, invocations of next and previous which do not find a record do not raise a QueryOffEndException. By default, this would normally raise the exception.
    
    Specified by:
    
    setLenientOffEnd in interface P2JQuery
    
    Parameters:
    
    lenientOffEnd - true to suppress QueryOffEndException for next and previous requests; false to permit these exceptions.
  - setIterating
```
public void setIterating(boolean iterating)
```
    Indicate whether the query is defined inside the scope of FOR EACH block.
    
    Specified by:
    
    setIterating in interface P2JQuery
    
    Parameters:
    
    iterating - true indicating that a query is inside FOR EACH block; false is defined outside of a FOR EACH.
  - isIterating
```
public boolean isIterating()
```
    Indicate whether the query is defined inside the scope of FOR EACH block.
    
    Specified by:
    
    isIterating in interface P2JQuery
    
    Returns:
    
    true if the query was defined inside a FOR EACH block.
  - isPresort
```
public boolean isPresort()
```
    Indicate whether the delegate query is of presort type.
    
    Specified by:
    
    isPresort in interface P2JQuery
    
    Returns:
    
    true if the query is of presort type.
  - setPresort
```
public void setPresort(boolean presort)
```
    Indicate whether the delegate query is of presort type.
    
    Specified by:
    
    setPresort in interface P2JQuery
    
    Parameters:
    
    presort - true indicating that a query of presort type. false is not of presort type.

Class QueryWrapper.DefaultDelegate

Nested Class Summary

Nested classes/interfaces inherited from interface com.goldencode.p2j.persist.P2JQuery

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.goldencode.p2j.persist.P2JQuery

Methods inherited from interface com.goldencode.p2j.persist.BufferCollection

Constructor Detail

DefaultDelegate

Method Detail

clearResults

setScrolling

isScrolling

setIndexedReposition

isIndexedReposition

open

close

getTableCount

getOffEndListeners

addExternalBuffers

setBrowsed

isBrowsed

setErrorIfNull

addAccumulator

addAccumulator

first

first

last

last

next

next

previous

previous

unique

unique

current

current

hasAny

hasAny

hasAny

hasAny

hasOne

hasOne

hasOne

hasOne

isFetchOnReposition

setFetchOnReposition

addRepositionListener

removeRepositionListener

repositionByID

repositionByID

repositionByID

reposition

reposition

forward

forward

backward

backward

size

currentRow

currentRowImpl

isOffEnd

_isOffEnd

getOffEnd

isPreselect

isNativelyPreselect

notifyRepositionListeners

isStandalone

setStandalone

cleanup

bufferHandle

bufferHandle

bufferHandle

bufferHandle

bufferHandle

queryClose

queryBackward

queryBackward

queryForward