org.apache.openjpa.jdbc.sql
Class SelectImpl

java.lang.Object
  extended by org.apache.openjpa.jdbc.sql.SelectImpl
All Implemented Interfaces:
Select, SelectExecutor

public class SelectImpl
extends Object
implements Select

Standard Select implementation. Usage note: though this class implements Joins, it should not be used for joining directly. Instead, use the return value of newJoins().

Author:
Abe White

Nested Class Summary
static class SelectImpl.SelectResult
          A Result implementation wrapped around this select.
protected static class SelectImpl.Selects
          Helper class to track selected columns, with fast contains method.
 
Field Summary
protected  SelectImpl _outer
           
protected  SelectImpl.Selects _selects
           
 
Fields inherited from interface org.apache.openjpa.jdbc.sql.Select
EAGER_INNER, EAGER_OUTER, EAGER_PARALLEL, FROM_SELECT_ALIAS, SUBS_ANY_JOINABLE, SUBS_EXACT, SUBS_JOINABLE, SUBS_NONE, TYPE_JOINLESS, TYPE_TWO_PART
 
Constructor Summary
SelectImpl(JDBCConfiguration conf)
          Constructor.
 
Method Summary
 void addJoinClassConditions()
          Apply class conditions from relation joins.
 Joins and(Joins joins1, Joins joins2)
          AND the given joins together.
 void append(SQLBuffer buf, Joins joins)
          Append the given joins to the given buffer.
 void clearOrdering()
          Clear odering conditions.
 void clearPlaceholderSelects()
          Clear selected placeholders, and return removed select indexes.
 void clearSelects()
          Clear the existing column selects.
 Joins crossJoin(Table localTable, Table foreignTable)
          Perform a cross join on the given tables.
 SelectExecutor eagerClone(FieldMapping key, int eagerType, boolean toMany, int sels)
          Return a select that will be eagerly executed with this one, or null if the select cannot be created for the given key and join type.
 Result execute(JDBCStore store, JDBCFetchConfiguration fetch)
          Execute this select in the context of the given store manager.
 Result execute(JDBCStore store, JDBCFetchConfiguration fetch, int lockLevel)
          Execute this select in the context of the given store manager.
protected  Result execute(StoreContext ctx, JDBCStore store, JDBCFetchConfiguration fetch, int lockLevel)
          Execute this select in the context of the given store manager.
 SelectExecutor fullClone(int sels)
          Return a SELECT that is a complete clone of this one.
 Map getAliases()
           
 boolean getAutoDistinct()
          Whether to automatically make results distinct when relational joins would otherwise introduce duplicates.
 String getColumnAlias(Column col)
          Return the alias for the given column.
 String getColumnAlias(Column col, Joins joins)
          Return the alias for the given column.
 String getColumnAlias(String col, Table table)
          Return the alias for the given column.
 String getColumnAlias(String col, Table table, Joins joins)
          Return the alias for the given column.
 JDBCConfiguration getConfiguration()
          Return the select configuration.
 int getCount(JDBCStore store)
          Return the number of instances matching this select.
 SelectExecutor getEager(FieldMapping key)
          Return the eager select for the given key.
 Map getEagerMap()
          Return view of eager selects.
 long getEndIndex()
          The result end index.
 int getExpectedResultCount()
          The expected result count for the query.
 Select getFromSelect()
          Another select instance that creates a temporary table from which this select pulls data.
 SQLBuffer getGrouping()
          Return the grouping SQL for this select.
 SQLBuffer getHaving()
          Return the HAVING clause, or null if none.
 List getIdentifierAliases()
          Get the aliases for identifier columns that can be used in COUNT selects to find the number of matches.
 Iterator getJoinIterator()
          Return the top-level Join elements for this select.
 Joins getJoins()
          Return the top-level joins for this select.
 int getJoinSyntax()
          The join syntax for this select, as one of the syntax constants from JoinSyntaxes.
 SQLBuffer getOrdering()
          Return the ordering SQL for this select.
 Select getParent()
          Return the parent of this select, if it is a subselect.
 List getSelectAliases()
          Return the aliases of all selected columns and all selected buffers, in the order they were selected.
 long getStartIndex()
          The result start index.
 String getSubselectPath()
          Return the subselect path for this select, if it is a subselect.
 List getSubselects()
          Return this select's subselects, or empty collection if none.
 Collection getTableAliases()
          Return the set of all used table aliases.
 Map getTables()
           
 SQLBuffer getWhere()
          Return the WHERE clause, minus any necessary end joins.
 void groupBy(ClassMapping mapping, int subclasses, JDBCStore store, JDBCFetchConfiguration fetch)
          Group by the columns of the given mapping, possibly including subclasses.
 void groupBy(ClassMapping mapping, int subclasses, JDBCStore store, JDBCFetchConfiguration fetch, Joins joins)
          Group by the columns of the given mapping, possibly including subclasses.
 void groupBy(Column col)
          Group by the given column.
 void groupBy(Column[] cols)
          Group by the given columns.
 void groupBy(Column[] cols, Joins joins)
          Group by the given columns.
 void groupBy(Column col, Joins joins)
          Group by the given column.
 void groupBy(SQLBuffer sql)
          Add a GROUP BY clause.
 void groupBy(SQLBuffer sql, Joins joins)
          Add a GROUP BY clause.
 void groupBy(String sql)
          Add a GROUP BY clause.
 void groupBy(String sql, Joins joins)
          Add a GROUP BY clause.
 boolean hasEagerJoin(boolean toMany)
          Whether this select has an eager join of the specified type.
 boolean hasJoin(boolean toMany)
          Whether this select has a join of the specified type.
 void having(SQLBuffer sql)
          Add the given having conditions.
 void having(SQLBuffer sql, Joins joins)
          Add the given having conditions.
 void having(String sql)
          Add the given having conditions.
 void having(String sql, Joins joins)
          Add the given having conditions.
 int indexOf()
          The index of this select within the UNION, or 0.
 void insertPlaceholder(String sql, int pos)
          Insert a placeholder at the given index; use a negative index to count from the back of the select list.
 boolean isAggregate()
          Return true if this is an aggregate select.
 boolean isDirty()
          Return true if this instance has a path, any joins, or a variable.
 boolean isDistinct()
          Whether this is a SELECT DISTINCT / UNION ALL.
 boolean isEmpty()
          Whether we have any joins.
 boolean isLob()
          Return true if this select includes a LOB.
 boolean isLRS()
          Whether the result of this select should be treated as a large result set.
 boolean isOuter()
          Whether this joins path results in outer joins.
 boolean isSelected(Table table)
          Return whether the given table is being used in this select.
 Joins join(ForeignKey fk, boolean inverse, boolean toMany)
          Join the columns of the given foreign key.
 int joinCount()
          Return the maximum number of joins contained in this instance at any time.
 Joins joinRelation(String name, ForeignKey fk, ClassMapping target, int subs, boolean inverse, boolean toMany)
          Join the columns of the given foreign key, which represents a relation via the given field name.
 org.apache.openjpa.jdbc.sql.JoinSet joins()
          Return the set of Join elements, or null if none.
 Joins newJoins()
          Return a new instance to use for joining.
 Joins newOuterJoins()
          Return a new instance to use for outer joining.
protected  SelectImpl.Selects newSelects()
           
 void nullJoins()
          Null the set of Join elements.
 Joins or(Joins joins1, Joins joins2)
          OR the given joins together.
 int orderBy(Column[] cols, boolean asc, boolean sel)
          Order by the given columns.
 int orderBy(Column[] cols, boolean asc, Joins joins, boolean sel)
          Order by the given columns.
 boolean orderBy(Column col, boolean asc, boolean sel)
          Order by the given column.
 boolean orderBy(Column col, boolean asc, Joins joins, boolean sel)
          Order by the given column.
 boolean orderBy(SQLBuffer sql, boolean asc, boolean sel)
          Add an ORDER BY clause.
 boolean orderBy(SQLBuffer sql, boolean asc, Joins joins, boolean sel)
          Add an ORDER BY clause.
 boolean orderBy(String sql, boolean asc, boolean sel)
          Add an ORDER BY clause.
 boolean orderBy(String sql, boolean asc, Joins joins, boolean sel)
          Add an ORDER BY clause.
 int orderByPrimaryKey(ClassMapping mapping, boolean asc, boolean sel)
          Order on the primary key columns of the given mapping, joining to superclasses as necessary to get all columns needed to construct an object id.
 int orderByPrimaryKey(ClassMapping mapping, boolean asc, Joins joins, boolean sel)
          Select and order on the primary key columns of the given mapping, joining to superclasses as necessary to get all columns needed to construct an object id.
 int orderByPrimaryKey(ClassMapping mapping, boolean asc, Joins joins, boolean sel, boolean aliasOrder)
          Allow unions to set aliases on order columns.
 Joins outer(Joins joins)
          Return a join set making the given joins outer joins.
 Joins outerJoin(ForeignKey fk, boolean inverse, boolean toMany)
          Join the columns of the given foreign key.
 Joins outerJoinRelation(String name, ForeignKey fk, ClassMapping target, int subs, boolean inverse, boolean toMany)
          Join the columns of the given foreign key, which represents a relation via the given field name.
 StringBuffer path()
          Return the relation path traversed by these joins, or null if none.
 void removeAlias(Object key)
           
 void removeTable(Object key)
           
 void select(ClassMapping mapping, int subclasses, JDBCStore store, JDBCFetchConfiguration fetch, int eager)
          Select the columns of the given mapping, possibly including subclasses.
 void select(ClassMapping mapping, int subclasses, JDBCStore store, JDBCFetchConfiguration fetch, int eager, Joins joins)
          Select the columns of the given mapping, possibly including subclasses.
 boolean select(Column col)
          Select the given column.
 int select(Column[] cols)
          Select the given columns.
 int select(Column[] cols, Joins joins)
          Select the given columns.
 boolean select(Column col, Joins joins)
          Select the given column.
 boolean select(SQLBuffer sql, Object id)
          Select the given SQL; the given id object is an identifier to use when retrieving the corresponding value from a Result.
 boolean select(SQLBuffer sql, Object id, Joins joins)
          Select the given SQL; the given id object is an identifier to use when retrieving the corresponding value from a Result.
 boolean select(String sql, Object id)
          Select the given SQL; the given id object is an identifier to use when retrieving the corresponding value from a Result.
 boolean select(String sql, Object id, Joins joins)
          Select the given SQL; the given id object is an identifier to use when retrieving the corresponding value from a Result.
 void selectIdentifier(ClassMapping mapping, int subclasses, JDBCStore store, JDBCFetchConfiguration fetch, int eager)
          Select the columns of the given mapping, possibly including subclasses.
 void selectIdentifier(ClassMapping mapping, int subclasses, JDBCStore store, JDBCFetchConfiguration fetch, int eager, Joins joins)
          Select the columns of the given mapping, possibly including subclasses.
 boolean selectIdentifier(Column col)
          Select the given column as one that can be used to get a count of distinct matches.
 int selectIdentifier(Column[] cols)
          Select the given columns as ones that can be used to get a count of distinct matches.
 int selectIdentifier(Column[] cols, Joins joins)
          Select the given columns as ones that can be used to get a count of distinct matches.
 boolean selectIdentifier(Column col, Joins joins)
          Select the given column as one that can be used to get a count of distinct matches.
 void selectPlaceholder(String sql)
          Select the given SQL as a placeholder for a UNION element.
 int selectPrimaryKey(ClassMapping mapping)
          Select the primary key columns of the given mapping, joining to superclasses as necessary to get all columns needed to construct an object id.
 int selectPrimaryKey(ClassMapping mapping, Joins joins)
          Select the primary key columns of the given mapping, joining to superclasses as necessary to get all columns needed to construct an object id.
 void setAggregate(boolean agg)
          Set to true for aggregate selects.
 void setAutoDistinct(boolean val)
          Whether to automatically make results distinct when relational joins would otherwise introduce duplicates.
 void setDistinct(boolean distinct)
          Whether this is a SELECT DISTINCT / UNION ALL.
 void setExpectedResultCount(int expectedResultCount, boolean force)
          The expected result count for the query.
 void setFromSelect(Select sel)
          Another select instance that creates a temporary table from which this select pulls data.
 void setJoinSyntax(int joinSyntax)
          The join syntax for this select, as one of the syntax constants from JoinSyntaxes.
 void setLob(boolean lob)
          Set to true for selects that include LOB columns.
 void setLRS(boolean lrs)
          Whether the result of this select should be treated as a large result set.
 org.apache.openjpa.jdbc.sql.PathJoins setOuter(boolean outer)
          Mark this as an outer joins set.
 void setParent(Select parent, String path)
          Turn this select into a subselect of the given instance.
 void setRange(long start, long end)
          Set the result range for this select.
 Joins setSubselect(String alias)
          Set the subquery alias.
 Joins setVariable(String var)
          Set the variable name being traversed into with the next join.
 boolean supportsLocking()
          Whether this select can be executed for update.
 boolean supportsRandomAccess(boolean forUpdate)
          Return whether this select can support a random access result set type.
static String toOrderAlias(int index)
          Helper method to return the proper order alias for the given order column index.
 SQLBuffer toSelect(boolean forUpdate, JDBCFetchConfiguration fetch)
          Return this select as a SQL statement formatted for the current dictionary.
 SQLBuffer toSelectCount()
          Return this select as a COUNT SQL statement formatted for the current dictionary.
 String toString()
          Implement toString to generate SQL string for profiling/debuggging.
 void where(Joins joins)
          Add the given where conditions.
 void where(SQLBuffer sql)
          Add the given where conditions.
 void where(SQLBuffer sql, Joins joins)
          Add the given where conditions.
 void where(String sql)
          Add the given where conditions.
 void where(String sql, Joins joins)
          Add the given where conditions.
 SelectExecutor whereClone(int sels)
          Return a SELECT with the same joins and where conditions as this one.
 void whereForeignKey(ForeignKey fk, Object oid, ClassMapping mapping, JDBCStore store)
          Add where conditions setting the given foreign key to the given oid values.
 void wherePrimaryKey(Object oid, ClassMapping mapping, JDBCStore store)
          Add where conditions setting the mapping's primary key to the given oid values.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

_selects

protected final SelectImpl.Selects _selects

_outer

protected SelectImpl _outer
Constructor Detail

SelectImpl

public SelectImpl(JDBCConfiguration conf)
Constructor. Supply configuration.

Method Detail

toOrderAlias

public static String toOrderAlias(int index)
Helper method to return the proper order alias for the given order column index.


getConfiguration

public JDBCConfiguration getConfiguration()
Description copied from interface: SelectExecutor
Return the select configuration.

Specified by:
getConfiguration in interface SelectExecutor

toSelect

public SQLBuffer toSelect(boolean forUpdate,
                          JDBCFetchConfiguration fetch)
Description copied from interface: SelectExecutor
Return this select as a SQL statement formatted for the current dictionary.

Specified by:
toSelect in interface SelectExecutor

toSelectCount

public SQLBuffer toSelectCount()
Description copied from interface: SelectExecutor
Return this select as a COUNT SQL statement formatted for the current dictionary.

Specified by:
toSelectCount in interface SelectExecutor

getAutoDistinct

public boolean getAutoDistinct()
Description copied from interface: SelectExecutor
Whether to automatically make results distinct when relational joins would otherwise introduce duplicates.

Specified by:
getAutoDistinct in interface SelectExecutor

setAutoDistinct

public void setAutoDistinct(boolean val)
Description copied from interface: SelectExecutor
Whether to automatically make results distinct when relational joins would otherwise introduce duplicates.

Specified by:
setAutoDistinct in interface SelectExecutor

isDistinct

public boolean isDistinct()
Description copied from interface: SelectExecutor
Whether this is a SELECT DISTINCT / UNION ALL.

Specified by:
isDistinct in interface SelectExecutor

setDistinct

public void setDistinct(boolean distinct)
Description copied from interface: SelectExecutor
Whether this is a SELECT DISTINCT / UNION ALL.

Specified by:
setDistinct in interface SelectExecutor

isLRS

public boolean isLRS()
Description copied from interface: SelectExecutor
Whether the result of this select should be treated as a large result set.

Specified by:
isLRS in interface SelectExecutor

setLRS

public void setLRS(boolean lrs)
Description copied from interface: SelectExecutor
Whether the result of this select should be treated as a large result set.

Specified by:
setLRS in interface SelectExecutor

getExpectedResultCount

public int getExpectedResultCount()
Description copied from interface: SelectExecutor
The expected result count for the query.

Specified by:
getExpectedResultCount in interface SelectExecutor

setExpectedResultCount

public void setExpectedResultCount(int expectedResultCount,
                                   boolean force)
Description copied from interface: SelectExecutor
The expected result count for the query.

Specified by:
setExpectedResultCount in interface SelectExecutor
force - if false, the count will be discarded if this select has any to-many eager joins that would throw off the result count

getJoinSyntax

public int getJoinSyntax()
Description copied from interface: SelectExecutor
The join syntax for this select, as one of the syntax constants from JoinSyntaxes.

Specified by:
getJoinSyntax in interface SelectExecutor

setJoinSyntax

public void setJoinSyntax(int joinSyntax)
Description copied from interface: SelectExecutor
The join syntax for this select, as one of the syntax constants from JoinSyntaxes.

Specified by:
setJoinSyntax in interface SelectExecutor

supportsRandomAccess

public boolean supportsRandomAccess(boolean forUpdate)
Description copied from interface: SelectExecutor
Return whether this select can support a random access result set type.

Specified by:
supportsRandomAccess in interface SelectExecutor

supportsLocking

public boolean supportsLocking()
Description copied from interface: SelectExecutor
Whether this select can be executed for update.

Specified by:
supportsLocking in interface SelectExecutor

getCount

public int getCount(JDBCStore store)
             throws SQLException
Description copied from interface: SelectExecutor
Return the number of instances matching this select.

Specified by:
getCount in interface SelectExecutor
Throws:
SQLException

execute

public Result execute(JDBCStore store,
                      JDBCFetchConfiguration fetch)
               throws SQLException
Description copied from interface: SelectExecutor
Execute this select in the context of the given store manager.

Specified by:
execute in interface SelectExecutor
Throws:
SQLException

execute

public Result execute(JDBCStore store,
                      JDBCFetchConfiguration fetch,
                      int lockLevel)
               throws SQLException
Description copied from interface: SelectExecutor
Execute this select in the context of the given store manager.

Specified by:
execute in interface SelectExecutor
Throws:
SQLException

execute

protected Result execute(StoreContext ctx,
                         JDBCStore store,
                         JDBCFetchConfiguration fetch,
                         int lockLevel)
                  throws SQLException
Execute this select in the context of the given store manager. The context is passed in separately for profiling purposes.

Throws:
SQLException

indexOf

public int indexOf()
Description copied from interface: Select
The index of this select within the UNION, or 0.

Specified by:
indexOf in interface Select

getSubselects

public List getSubselects()
Description copied from interface: Select
Return this select's subselects, or empty collection if none.

Specified by:
getSubselects in interface Select

getParent

public Select getParent()
Description copied from interface: Select
Return the parent of this select, if it is a subselect.

Specified by:
getParent in interface Select

getSubselectPath

public String getSubselectPath()
Description copied from interface: Select
Return the subselect path for this select, if it is a subselect.

Specified by:
getSubselectPath in interface Select

setParent

public void setParent(Select parent,
                      String path)
Description copied from interface: Select
Turn this select into a subselect of the given instance.

Specified by:
setParent in interface Select

getAliases

public Map getAliases()

removeAlias

public void removeAlias(Object key)

getTables

public Map getTables()

removeTable

public void removeTable(Object key)

getFromSelect

public Select getFromSelect()
Description copied from interface: Select
Another select instance that creates a temporary table from which this select pulls data.

Specified by:
getFromSelect in interface Select

setFromSelect

public void setFromSelect(Select sel)
Description copied from interface: Select
Another select instance that creates a temporary table from which this select pulls data.

Specified by:
setFromSelect in interface Select

hasEagerJoin

public boolean hasEagerJoin(boolean toMany)
Description copied from interface: Select
Whether this select has an eager join of the specified type.

Specified by:
hasEagerJoin in interface Select

hasJoin

public boolean hasJoin(boolean toMany)
Description copied from interface: Select
Whether this select has a join of the specified type.

Specified by:
hasJoin in interface Select

isSelected

public boolean isSelected(Table table)
Description copied from interface: Select
Return whether the given table is being used in this select.

Specified by:
isSelected in interface Select

getTableAliases

public Collection getTableAliases()
Description copied from interface: Select
Return the set of all used table aliases.

Specified by:
getTableAliases in interface Select

getSelectAliases

public List getSelectAliases()
Description copied from interface: Select
Return the aliases of all selected columns and all selected buffers, in the order they were selected. Each alias may be either a string or a SQLBuffer.

Specified by:
getSelectAliases in interface Select

getIdentifierAliases

public List getIdentifierAliases()
Description copied from interface: Select
Get the aliases for identifier columns that can be used in COUNT selects to find the number of matches. Each alias will be a string. If no identifier columns have been nominated, then all column alises are returned.

Specified by:
getIdentifierAliases in interface Select

getOrdering

public SQLBuffer getOrdering()
Description copied from interface: Select
Return the ordering SQL for this select.

Specified by:
getOrdering in interface Select

getGrouping

public SQLBuffer getGrouping()
Description copied from interface: Select
Return the grouping SQL for this select.

Specified by:
getGrouping in interface Select

getWhere

public SQLBuffer getWhere()
Description copied from interface: Select
Return the WHERE clause, minus any necessary end joins.

Specified by:
getWhere in interface Select

getHaving

public SQLBuffer getHaving()
Description copied from interface: Select
Return the HAVING clause, or null if none.

Specified by:
getHaving in interface Select

addJoinClassConditions

public void addJoinClassConditions()
Description copied from interface: Select
Apply class conditions from relation joins. This may affect the return values of Select.getJoins(), Select.getJoinIterator(), and Select.getWhere().

Specified by:
addJoinClassConditions in interface Select

getJoins

public Joins getJoins()
Description copied from interface: Select
Return the top-level joins for this select.

Specified by:
getJoins in interface Select

getJoinIterator

public Iterator getJoinIterator()
Description copied from interface: Select
Return the top-level Join elements for this select.

Specified by:
getJoinIterator in interface Select

getStartIndex

public long getStartIndex()
Description copied from interface: Select
The result start index.

Specified by:
getStartIndex in interface Select

getEndIndex

public long getEndIndex()
Description copied from interface: Select
The result end index.

Specified by:
getEndIndex in interface Select

setRange

public void setRange(long start,
                     long end)
Description copied from interface: Select
Set the result range for this select.

Specified by:
setRange in interface Select

getColumnAlias

public String getColumnAlias(Column col)
Description copied from interface: Select
Return the alias for the given column.

Specified by:
getColumnAlias in interface Select

getColumnAlias

public String getColumnAlias(Column col,
                             Joins joins)
Description copied from interface: Select
Return the alias for the given column.

Specified by:
getColumnAlias in interface Select

getColumnAlias

public String getColumnAlias(String col,
                             Table table)
Description copied from interface: Select
Return the alias for the given column.

Specified by:
getColumnAlias in interface Select

getColumnAlias

public String getColumnAlias(String col,
                             Table table,
                             Joins joins)
Description copied from interface: Select
Return the alias for the given column.

Specified by:
getColumnAlias in interface Select

isAggregate

public boolean isAggregate()
Description copied from interface: Select
Return true if this is an aggregate select.

Specified by:
isAggregate in interface Select

setAggregate

public void setAggregate(boolean agg)
Description copied from interface: Select
Set to true for aggregate selects.

Specified by:
setAggregate in interface Select

isLob

public boolean isLob()
Description copied from interface: Select
Return true if this select includes a LOB.

Specified by:
isLob in interface Select

setLob

public void setLob(boolean lob)
Description copied from interface: Select
Set to true for selects that include LOB columns.

Specified by:
setLob in interface Select

clearSelects

public void clearSelects()
Description copied from interface: Select
Clear the existing column selects.

Specified by:
clearSelects in interface Select

select

public boolean select(SQLBuffer sql,
                      Object id)
Description copied from interface: Select
Select the given SQL; the given id object is an identifier to use when retrieving the corresponding value from a Result.

Specified by:
select in interface Select
Returns:
true if selected

select

public boolean select(SQLBuffer sql,
                      Object id,
                      Joins joins)
Description copied from interface: Select
Select the given SQL; the given id object is an identifier to use when retrieving the corresponding value from a Result.

Specified by:
select in interface Select
Returns:
true if selected

select

public boolean select(String sql,
                      Object id)
Description copied from interface: Select
Select the given SQL; the given id object is an identifier to use when retrieving the corresponding value from a Result.

Specified by:
select in interface Select
Returns:
true if selected

select

public boolean select(String sql,
                      Object id,
                      Joins joins)
Description copied from interface: Select
Select the given SQL; the given id object is an identifier to use when retrieving the corresponding value from a Result.

Specified by:
select in interface Select
Returns:
true if selected

selectPlaceholder

public void selectPlaceholder(String sql)
Description copied from interface: Select
Select the given SQL as a placeholder for a UNION element.

Specified by:
selectPlaceholder in interface Select

insertPlaceholder

public void insertPlaceholder(String sql,
                              int pos)
Insert a placeholder at the given index; use a negative index to count from the back of the select list.


clearPlaceholderSelects

public void clearPlaceholderSelects()
Clear selected placeholders, and return removed select indexes.


select

public boolean select(Column col)
Description copied from interface: Select
Select the given column.

Specified by:
select in interface Select
Returns:
true if selected

select

public boolean select(Column col,
                      Joins joins)
Description copied from interface: Select
Select the given column.

Specified by:
select in interface Select
Returns:
true if selected

select

public int select(Column[] cols)
Description copied from interface: Select
Select the given columns.

Specified by:
select in interface Select
Returns:
bit set of indexes of columns that were selected

select

public int select(Column[] cols,
                  Joins joins)
Description copied from interface: Select
Select the given columns.

Specified by:
select in interface Select
Returns:
bit set of indexes of columns that were selected

select

public void select(ClassMapping mapping,
                   int subclasses,
                   JDBCStore store,
                   JDBCFetchConfiguration fetch,
                   int eager)
Description copied from interface: Select
Select the columns of the given mapping, possibly including subclasses. This method should be called after all where conditions are added in case the given mapping batches other selects.

Specified by:
select in interface Select

select

public void select(ClassMapping mapping,
                   int subclasses,
                   JDBCStore store,
                   JDBCFetchConfiguration fetch,
                   int eager,
                   Joins joins)
Description copied from interface: Select
Select the columns of the given mapping, possibly including subclasses. This method should be called after all where conditions are added in case the given mapping batches other selects.

Specified by:
select in interface Select

selectIdentifier

public boolean selectIdentifier(Column col)
Description copied from interface: Select
Select the given column as one that can be used to get a count of distinct matches. It is not necessary to designate distinct identifiers when eagerly traversing the entire result of the select or when not using an LRSSize setting of count.

Specified by:
selectIdentifier in interface Select
Returns:
true if selected

selectIdentifier

public boolean selectIdentifier(Column col,
                                Joins joins)
Description copied from interface: Select
Select the given column as one that can be used to get a count of distinct matches. It is not necessary to designate distinct identifiers when eagerly traversing the entire result of the select or when not using an LRSSize setting of count.

Specified by:
selectIdentifier in interface Select
Returns:
true if selected

selectIdentifier

public int selectIdentifier(Column[] cols)
Description copied from interface: Select
Select the given columns as ones that can be used to get a count of distinct matches. It is not necessary to designate distinct identifiers when eagerly traversing the entire result of the select or when not using an LRSSize setting of count.

Specified by:
selectIdentifier in interface Select
Returns:
bit set of indexes of columns that were selected

selectIdentifier

public int selectIdentifier(Column[] cols,
                            Joins joins)
Description copied from interface: Select
Select the given columns as ones that can be used to get a count of distinct matches. It is not necessary to designate distinct identifiers when eagerly traversing the entire result of the select or when not using an LRSSize setting of count.

Specified by:
selectIdentifier in interface Select
Returns:
bit set of indexes of columns that were selected

selectIdentifier

public void selectIdentifier(ClassMapping mapping,
                             int subclasses,
                             JDBCStore store,
                             JDBCFetchConfiguration fetch,
                             int eager)
Description copied from interface: Select
Select the columns of the given mapping, possibly including subclasses. This method should be called after all where conditions are added in case the given mapping batches other selects. The primary key columns of the mapping can be used to get a count of distinct matches. It is not necessary to designate distinct identifiers when eagerly traversing the entire result of the select or when not using an LRSSize setting of count.

Specified by:
selectIdentifier in interface Select

selectIdentifier

public void selectIdentifier(ClassMapping mapping,
                             int subclasses,
                             JDBCStore store,
                             JDBCFetchConfiguration fetch,
                             int eager,
                             Joins joins)
Description copied from interface: Select
Select the columns of the given mapping, possibly including subclasses. This method should be called after all where conditions are added in case the given mapping batches other selects. The primary key columns of the mapping can be used to get a count of distinct matches. It is not necessary to designate distinct identifiers when eagerly traversing the entire result of the select or when not using an LRSSize setting of count.

Specified by:
selectIdentifier in interface Select

selectPrimaryKey

public int selectPrimaryKey(ClassMapping mapping)
Description copied from interface: Select
Select the primary key columns of the given mapping, joining to superclasses as necessary to get all columns needed to construct an object id.

Specified by:
selectPrimaryKey in interface Select
Returns:
bit set of indexes of pk columns that were selected

selectPrimaryKey

public int selectPrimaryKey(ClassMapping mapping,
                            Joins joins)
Description copied from interface: Select
Select the primary key columns of the given mapping, joining to superclasses as necessary to get all columns needed to construct an object id.

Specified by:
selectPrimaryKey in interface Select
Returns:
bit set of indexes of pk columns that were selected

orderByPrimaryKey

public int orderByPrimaryKey(ClassMapping mapping,
                             boolean asc,
                             boolean sel)
Description copied from interface: Select
Order on the primary key columns of the given mapping, joining to superclasses as necessary to get all columns needed to construct an object id. Optionally selects ordering data if not already selected.

Specified by:
orderByPrimaryKey in interface Select

orderByPrimaryKey

public int orderByPrimaryKey(ClassMapping mapping,
                             boolean asc,
                             Joins joins,
                             boolean sel)
Description copied from interface: Select
Select and order on the primary key columns of the given mapping, joining to superclasses as necessary to get all columns needed to construct an object id. Optionally selects ordering data if not already selected.

Specified by:
orderByPrimaryKey in interface Select

orderByPrimaryKey

public int orderByPrimaryKey(ClassMapping mapping,
                             boolean asc,
                             Joins joins,
                             boolean sel,
                             boolean aliasOrder)
Allow unions to set aliases on order columns.


orderBy

public boolean orderBy(Column col,
                       boolean asc,
                       boolean sel)
Description copied from interface: Select
Order by the given column. Optionally selects ordering data if not already selected.

Specified by:
orderBy in interface Select

orderBy

public boolean orderBy(Column col,
                       boolean asc,
                       Joins joins,
                       boolean sel)
Description copied from interface: Select
Order by the given column. Optionally selects ordering data if not already selected.

Specified by:
orderBy in interface Select

orderBy

public int orderBy(Column[] cols,
                   boolean asc,
                   boolean sel)
Description copied from interface: Select
Order by the given columns. Optionally selects ordering data if not already selected.

Specified by:
orderBy in interface Select

orderBy

public int orderBy(Column[] cols,
                   boolean asc,
                   Joins joins,
                   boolean sel)
Description copied from interface: Select
Order by the given columns. Optionally selects ordering data if not already selected.

Specified by:
orderBy in interface Select

orderBy

public boolean orderBy(SQLBuffer sql,
                       boolean asc,
                       boolean sel)
Description copied from interface: Select
Add an ORDER BY clause. Optionally selects ordering data if not already selected.

Specified by:
orderBy in interface Select

orderBy

public boolean orderBy(SQLBuffer sql,
                       boolean asc,
                       Joins joins,
                       boolean sel)
Description copied from interface: Select
Add an ORDER BY clause. Optionally selects ordering data if not already selected.

Specified by:
orderBy in interface Select

orderBy

public boolean orderBy(String sql,
                       boolean asc,
                       boolean sel)
Description copied from interface: Select
Add an ORDER BY clause. Optionally selects ordering data if not already selected.

Specified by:
orderBy in interface Select

orderBy

public boolean orderBy(String sql,
                       boolean asc,
                       Joins joins,
                       boolean sel)
Description copied from interface: Select
Add an ORDER BY clause. Optionally selects ordering data if not already selected.

Specified by:
orderBy in interface Select

clearOrdering

public void clearOrdering()
Description copied from interface: Select
Clear odering conditions.

Specified by:
clearOrdering in interface Select

wherePrimaryKey

public void wherePrimaryKey(Object oid,
                            ClassMapping mapping,
                            JDBCStore store)
Description copied from interface: Select
Add where conditions setting the mapping's primary key to the given oid values. If the given mapping does not use oid values for its primary key, we will recursively join to its superclass until we find an ancestor that does.

Specified by:
wherePrimaryKey in interface Select

whereForeignKey

public void whereForeignKey(ForeignKey fk,
                            Object oid,
                            ClassMapping mapping,
                            JDBCStore store)
Description copied from interface: Select
Add where conditions setting the given foreign key to the given oid values.

Specified by:
whereForeignKey in interface Select
See Also:
Select.wherePrimaryKey(java.lang.Object, org.apache.openjpa.jdbc.meta.ClassMapping, org.apache.openjpa.jdbc.kernel.JDBCStore)

where

public void where(Joins joins)
Description copied from interface: Select
Add the given where conditions.

Specified by:
where in interface Select

where

public void where(SQLBuffer sql)
Description copied from interface: Select
Add the given where conditions.

Specified by:
where in interface Select

where

public void where(SQLBuffer sql,
                  Joins joins)
Description copied from interface: Select
Add the given where conditions.

Specified by:
where in interface Select

where

public void where(String sql)
Description copied from interface: Select
Add the given where conditions.

Specified by:
where in interface Select

where

public void where(String sql,
                  Joins joins)
Description copied from interface: Select
Add the given where conditions.

Specified by:
where in interface Select

having

public void having(SQLBuffer sql)
Description copied from interface: Select
Add the given having conditions.

Specified by:
having in interface Select

having

public void having(SQLBuffer sql,
                   Joins joins)
Description copied from interface: Select
Add the given having conditions.

Specified by:
having in interface Select

having

public void having(String sql)
Description copied from interface: Select
Add the given having conditions.

Specified by:
having in interface Select

having

public void having(String sql,
                   Joins joins)
Description copied from interface: Select
Add the given having conditions.

Specified by:
having in interface Select

groupBy

public void groupBy(SQLBuffer sql)
Description copied from interface: Select
Add a GROUP BY clause.

Specified by:
groupBy in interface Select

groupBy

public void groupBy(SQLBuffer sql,
                    Joins joins)
Description copied from interface: Select
Add a GROUP BY clause.

Specified by:
groupBy in interface Select

groupBy

public void groupBy(String sql)
Description copied from interface: Select
Add a GROUP BY clause.

Specified by:
groupBy in interface Select

groupBy

public void groupBy(String sql,
                    Joins joins)
Description copied from interface: Select
Add a GROUP BY clause.

Specified by:
groupBy in interface Select

groupBy

public void groupBy(Column col)
Description copied from interface: Select
Group by the given column.

Specified by:
groupBy in interface Select

groupBy

public void groupBy(Column col,
                    Joins joins)
Description copied from interface: Select
Group by the given column.

Specified by:
groupBy in interface Select

groupBy

public void groupBy(Column[] cols)
Description copied from interface: Select
Group by the given columns.

Specified by:
groupBy in interface Select

groupBy

public void groupBy(Column[] cols,
                    Joins joins)
Description copied from interface: Select
Group by the given columns.

Specified by:
groupBy in interface Select

groupBy

public void groupBy(ClassMapping mapping,
                    int subclasses,
                    JDBCStore store,
                    JDBCFetchConfiguration fetch)
Description copied from interface: Select
Group by the columns of the given mapping, possibly including subclasses. Assumes EAGER_NONE.

Specified by:
groupBy in interface Select

groupBy

public void groupBy(ClassMapping mapping,
                    int subclasses,
                    JDBCStore store,
                    JDBCFetchConfiguration fetch,
                    Joins joins)
Description copied from interface: Select
Group by the columns of the given mapping, possibly including subclasses. Assumes EAGER_NONE.

Specified by:
groupBy in interface Select

whereClone

public SelectExecutor whereClone(int sels)
Description copied from interface: Select
Return a SELECT with the same joins and where conditions as this one.

Specified by:
whereClone in interface Select
Parameters:
sels - number of selects to UNION together; ignored if <= 1

fullClone

public SelectExecutor fullClone(int sels)
Description copied from interface: Select
Return a SELECT that is a complete clone of this one.

Specified by:
fullClone in interface Select
Parameters:
sels - number of selects to UNION together; ignored if <= 1

eagerClone

public SelectExecutor eagerClone(FieldMapping key,
                                 int eagerType,
                                 boolean toMany,
                                 int sels)
Description copied from interface: Select
Return a select that will be eagerly executed with this one, or null if the select cannot be created for the given key and join type. If the join type is inner or outer, then this select instance will be returned. Otherwise, the returned select will have a clone of this select's where conditions and joins but will be independent.

Specified by:
eagerClone in interface Select
Parameters:
key - the key for the eager select
eagerType - one of the EAGER_* constants
toMany - whether the eager join is to-many
sels - number of selects to UNION together; ignored if <= 1

getEagerMap

public Map getEagerMap()
Return view of eager selects. May be null.


getEager

public SelectExecutor getEager(FieldMapping key)
Description copied from interface: Select
Return the eager select for the given key.

Specified by:
getEager in interface Select

newJoins

public Joins newJoins()
Description copied from interface: Select
Return a new instance to use for joining.

Specified by:
newJoins in interface Select

newOuterJoins

public Joins newOuterJoins()
Description copied from interface: Select
Return a new instance to use for outer joining.

Specified by:
newOuterJoins in interface Select

append

public void append(SQLBuffer buf,
                   Joins joins)
Description copied from interface: Select
Append the given joins to the given buffer.

Specified by:
append in interface Select

and

public Joins and(Joins joins1,
                 Joins joins2)
Description copied from interface: Select
AND the given joins together. The given joins will be hollowed in the process.

Specified by:
and in interface Select

or

public Joins or(Joins joins1,
                Joins joins2)
Description copied from interface: Select
OR the given joins together. The common joins will be removed in the process.

Specified by:
or in interface Select

outer

public Joins outer(Joins joins)
Description copied from interface: Select
Return a join set making the given joins outer joins.

Specified by:
outer in interface Select

toString

public String toString()
Description copied from interface: Select
Implement toString to generate SQL string for profiling/debuggging.

Specified by:
toString in interface Select
Overrides:
toString in class Object

isOuter

public boolean isOuter()
Description copied from interface: Joins
Whether this joins path results in outer joins.


setOuter

public org.apache.openjpa.jdbc.sql.PathJoins setOuter(boolean outer)
Mark this as an outer joins set.


isDirty

public boolean isDirty()
Return true if this instance has a path, any joins, or a variable.


path

public StringBuffer path()
Return the relation path traversed by these joins, or null if none.


joins

public org.apache.openjpa.jdbc.sql.JoinSet joins()
Return the set of Join elements, or null if none.


joinCount

public int joinCount()
Return the maximum number of joins contained in this instance at any time.


nullJoins

public void nullJoins()
Null the set of Join elements.


isEmpty

public boolean isEmpty()
Description copied from interface: Joins
Whether we have any joins.


crossJoin

public Joins crossJoin(Table localTable,
                       Table foreignTable)
Description copied from interface: Joins
Perform a cross join on the given tables.


join

public Joins join(ForeignKey fk,
                  boolean inverse,
                  boolean toMany)
Description copied from interface: Joins
Join the columns of the given foreign key.


outerJoin

public Joins outerJoin(ForeignKey fk,
                       boolean inverse,
                       boolean toMany)
Description copied from interface: Joins
Join the columns of the given foreign key.


joinRelation

public Joins joinRelation(String name,
                          ForeignKey fk,
                          ClassMapping target,
                          int subs,
                          boolean inverse,
                          boolean toMany)
Description copied from interface: Joins
Join the columns of the given foreign key, which represents a relation via the given field name.


outerJoinRelation

public Joins outerJoinRelation(String name,
                               ForeignKey fk,
                               ClassMapping target,
                               int subs,
                               boolean inverse,
                               boolean toMany)
Description copied from interface: Joins
Join the columns of the given foreign key, which represents a relation via the given field name.


setVariable

public Joins setVariable(String var)
Description copied from interface: Joins
Set the variable name being traversed into with the next join.


setSubselect

public Joins setSubselect(String alias)
Description copied from interface: Joins
Set the subquery alias.


newSelects

protected SelectImpl.Selects newSelects()


Copyright © 2006-2010 Apache Software Foundation. All Rights Reserved.