Query

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> org >> [ odbms overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

SOURCE |

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.odbms
Interface Query

public interface Query

handle to a query graph and reference to a specific node.

The query graph consists of multiple nodes, each representing a class or a member of a class. The structure can be linked in any way that the class model used allows. A Query object references a single node of this graph.

The graph can be traversed with the functions descendant() and parent() which return references to other nodes of the graph. These two functions will automatically extend the graph, if necessary.

execute() evaluates the entire graph against the objects stored in the data container. execute() can be called from any node of the graph and will create an ObjectSet filled with objects of the object type that the node, it was called from, represents. Objects for all descendant nodes of the caller Query object will be instantiated. Objects of parent nodes will not be visible in the ObjectSet if they are not referenced from the caller Query object.

Method Summary

Constraint constrain(java.lang.Object example)
          adds a constraint to this node.

Query descendant(java.lang.String path)
          returns a reference to a descendant node in the query graph.

ObjectSet execute()
          executes the query.

Query limitSize(int count)
          limits the maximum amount of objects returned.

Query orderAscending()
          adds an ascending order criteria to this node of the query graph.

Query orderDescending()
          adds a descending order criteria to this node of the query graph.

Query parent(java.lang.String path)
          returns a reference to a parent node in the query graph.

Method Detail

constrain

public Constraint constrain(java.lang.Object example)

adds a constraint to this node.
If the object parameter is deeper than the entire query graph, the query graph is extended accordingly.

execute

public ObjectSet execute()

executes the query.

descendant

public Query descendant(java.lang.String path)

returns a reference to a descendant node in the query graph. If the node does not exist, it will be created. Path notation:
"[membername].[membername].[membername]"
(any number of members)

To request references to elements of multi-element objects like arrays, lists, vectors, maps, hashMaps, ...:
"[membername].[membername].[membername]."
(Note the extra "." at the end.)

parent

public Query parent(java.lang.String path)

returns a reference to a parent node in the query graph. If the node does not exist, it will be created. Path notation:
"[classname].[membername].[membername]"
where the last member is this Query node.

limitSize

public Query limitSize(int count)

limits the maximum amount of objects returned. Especially for sorted queries, large performance advantages are possible.

orderAscending

public Query orderAscending()

adds an ascending order criteria to this node of the query graph. In case of multiple calls to ordering methods, the query graph is ordered by all criteria in the order they were called.

orderDescending

public Query orderDescending()

adds a descending order criteria to this node of the query graph. In case of multiple calls to ordering methods, the query graph is ordered by all criteria in the order they were called.