Class COM.odi.coll.BoundQuery

java.lang.Object
   |
   +----COM.odi.jcpp.CPlusPlus
           |
           +----COM.odi.coll.BoundQuery

public class BoundQuery
extends CPlusPlus

A BoundQuery object represents a Query plus bindings for the values of the free variables. Every BoundQuery object is a transient Java peer object.

Call bind() on the bound query until values for all its free variables are specified. Then call Collection.query() and specify the bound query. After you call Collection.query(), you cannot modify the values associated with the bound query. At this point, the bound query is considered to be fully bound.

When you are finished with a BoundQuery object, call ObjectStore.destroy() on it to free the C++ transient storage. The application accesses the BoundQuery object through a Java peer object and the associated C++ object is not automatically garbage collected. You must explicitly delete it.

BoundQuery(): Create a hollow BoundQuery object

bind(String, int): Binds the specified free variable to the int value.
bind(String, long): Bind the specified free variable to the long value.
bind(String, Object): Bind the specified free variable to the Object value.
bind(String, String): Bind the specified free variable to the String value.
create(Query): Creates a BoundQuery object.

BoundQuery

  protected BoundQuery()

Create a hollow BoundQuery object

create

  public static BoundQuery create(Query query)

Creates a BoundQuery object.

Parameters:: query - The Query object.
Returns:: The new BoundQuery object.

bind

  public abstract BoundQuery bind(String variable,
                                  int value)

Binds the specified free variable to the int value.

Parameters:: variable - The name of a free variable in the query string of the underlying query.; value - The value for the free variable.
Returns:: This BoundQuery object.
Throws: CollectionException: If the bound query is already fully bound.

bind

  public abstract BoundQuery bind(String variable,
                                  long value)

Bind the specified free variable to the long value.

Parameters:: variable - The name of a free variable in the query string of the underlying query.; value - The value for the free variable.
Returns:: This BoundQuery object.
Throws: CollectionException: If the bound query is already fully bound.

bind

  public abstract BoundQuery bind(String variable,
                                  String value)

Bind the specified free variable to the String value.

Parameters:: variable - The name of a free variable in the query string of the underlying query.; value - The value for the free variable.
Returns:: This BoundQuery object.
Throws: CollectionException: If the bound query is already fully bound.

bind

  public abstract BoundQuery bind(String variable,
                                  Object value)

Bind the specified free variable to the Object value. The value must be a persistent object.

Parameters:: variable - The name of a free variable in the query string of the underlying query.; value - The value for the free variable.
Returns:: This BoundQuery object.
Throws: CollectionException: If the bound query is already fully bound.
Throws: ObjectNotPersistentException: If the location is not already a persistent object. Possibly the application should call ObjectStore.migrate.
Throws: ObjectNotPersistenceCapableException: If the location is an object of a class that's not persistence-capable.