|
Enhydra 5.1 API | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.webdocwf.util.genericstore.data.AttributeObjectValueQuery
AttributeObjectValueQuery is used to query the ATTRIBUTEOBJECTVALUE table in the database. It returns objects of type AttributeObjectValueDO.
General usage:
In DODS: Create a Data Object named "Dog", and create an Attribute named "Name", and set that Attribute to "Can be queried." DODS will then generate the method DogQuery.setQueryName().
In your Business Layer, prepare the query:
DogQuery dq = new DogQuery(); dq.setQueryName("Rex") if ( Rex is a reserved name ) dq.requireUniqueInstance();Then, get the query results one of two ways:
#1:
String names = ""; DogDO[] dogs = dq.getDOArray(); for ( int i = 0; i < dogs.length; i++ ) { names += dogs[i].getName() + " "; }or #2:
String names = ""; DogDO dog; while ( null != ( dog = dq.getNextDO() ) ) { names += dog.getName() + " "; }
Note: If requireUniqueInstance()
was called,
then getDOArray()
or getNextDO()
will throw an exception if more than one "Rex" was found.
Note: Results of the query will come from the Data Object cache if:
- The cache is available.
- Matches were found in the cache.
- No other tables (Data Objects of other types) were involved
in the query.
This can happen if you extend the DogQuery
class
and you make calls to the QueryBuilder
object
to add SQL involving other tables.
If any of these conditions is not true,
then any results from the query will come from the database.
To reuse the query object, call:
dq.reset();
Constructor Summary | |
AttributeObjectValueQuery()
Public constructor. |
|
AttributeObjectValueQuery(User usr)
Constructor for Query with security |
Method Summary | |
void |
addOrderByATTRIBUTEDEFINITIONOID()
Add ATTRIBUTEDEFINITIONOID to the ORDER BY clause. |
void |
addOrderByATTRIBUTEDEFINITIONOID(boolean direction_flag)
Add ATTRIBUTEDEFINITIONOID to the ORDER BY clause. |
void |
addOrderByGENERICOBJECTOID()
Add GENERICOBJECTOID to the ORDER BY clause. |
void |
addOrderByGENERICOBJECTOID(boolean direction_flag)
Add GENERICOBJECTOID to the ORDER BY clause. |
void |
addOrderByOBJECTVALUE()
Add OBJECTVALUE to the ORDER BY clause. |
void |
addOrderByOBJECTVALUE(boolean direction_flag)
Add OBJECTVALUE to the ORDER BY clause. |
static void |
assertQueryAccess(User usr)
Ensure that the given user is allowed to create a query |
void |
assertQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x,
boolean exact,
User usr)
Deprecated. Instead use assertQueryAttrATTRIBUTEDEFINITIONOIDAccess(org.webdocwf.util.genericstore.data.AttributeDefinitionDO x, String cmp_op, org.webdocwf.dods.access.User usr ) WebDocWf extension |
void |
assertQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x,
java.lang.String cmp_op,
User usr)
Ensure the given user is allowed to query the attribute |
void |
assertQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x,
User usr)
Ensure the given user is allowed to query the attribute |
void |
assertQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x,
boolean exact,
User usr)
Deprecated. Instead use assertQueryAttrGENERICOBJECTOIDAccess(org.webdocwf.util.genericstore.data.GenericObjectDO x, String cmp_op, org.webdocwf.dods.access.User usr ) WebDocWf extension |
void |
assertQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x,
java.lang.String cmp_op,
User usr)
Ensure the given user is allowed to query the attribute |
void |
assertQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x,
User usr)
Ensure the given user is allowed to query the attribute |
void |
assertQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x,
boolean exact,
User usr)
Deprecated. Instead use assertQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x, String cmp_op, org.webdocwf.dods.access.User usr ) WebDocWf extension |
void |
assertQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x,
java.lang.String cmp_op,
User usr)
Ensure the given user is allowed to query the attribute |
void |
assertQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x,
User usr)
Ensure the given user is allowed to query the attribute |
void |
closeParen()
Place a closing parenthesis in the WHERE clause. |
boolean |
containsWildcards(java.lang.String dbSearchValue)
Check whether a string contains DB wildcards |
java.lang.String |
convertUserSearchValue(java.lang.String userSearchValue)
Convert a String with user wildcards into a string with DB wildcards |
java.sql.ResultSet |
executeQuery(DBConnection conn)
Method to query objects from the database. |
int |
getCount()
Get the rowcount of the query If possible, do it without reading all rows |
int |
getDatabaseLimit()
Get the database limit of the query |
boolean |
getDatabaseLimitExceeded()
Get the database limit exceeded flag of the query |
AttributeObjectValueDO[] |
getDOArray()
Return array of DOs constructed from ResultSet returned by query. |
AttributeObjectValueDO |
getNextDO()
Return successive DOs from array built from ResultSet returned by query. |
QueryBuilder |
getQueryBuilder()
Returns the QueryBuilder that this AttributeObjectValueQuery
uses to construct and execute database queries. |
int |
getReadSkip()
Get the readSkip number of the query |
boolean |
getUnique()
Get the unique flag of the query |
User |
getUser()
Get the user of the query |
boolean |
getUserStringAppendWildcard()
|
java.lang.String |
getUserStringSingleWildcard()
|
java.lang.String |
getUserStringSingleWildcardEscape()
|
boolean |
getUserStringTrim()
|
java.lang.String |
getUserStringWildcard()
|
java.lang.String |
getUserStringWildcardEscape()
|
static boolean |
hasQueryAccess(User usr)
Check whether the given user is allowed to create a query |
boolean |
hasQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x,
boolean exact,
User usr)
Deprecated. Instead use hasQueryAttrATTRIBUTEDEFINITIONOIDAccess(org.webdocwf.util.genericstore.data.AttributeDefinitionDO x, String cmp_op, org.webdocwf.dods.access.User usr ) WebDocWf extension |
boolean |
hasQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x,
java.lang.String cmp_op,
User usr)
Check whether the given user is allowed to query the attribute |
boolean |
hasQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x,
User usr)
Check whether the given user is allowed to query the attribute |
boolean |
hasQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x,
boolean exact,
User usr)
Deprecated. Instead use hasQueryAttrGENERICOBJECTOIDAccess(org.webdocwf.util.genericstore.data.GenericObjectDO x, String cmp_op, org.webdocwf.dods.access.User usr ) WebDocWf extension |
boolean |
hasQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x,
java.lang.String cmp_op,
User usr)
Check whether the given user is allowed to query the attribute |
boolean |
hasQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x,
User usr)
Check whether the given user is allowed to query the attribute |
boolean |
hasQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x,
boolean exact,
User usr)
Deprecated. Instead use hasQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x, String cmp_op, org.webdocwf.dods.access.User usr ) WebDocWf extension |
boolean |
hasQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x,
java.lang.String cmp_op,
User usr)
Check whether the given user is allowed to query the attribute |
boolean |
hasQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x,
User usr)
Check whether the given user is allowed to query the attribute |
void |
hitDatabase()
|
java.lang.Object |
next(java.sql.ResultSet rs)
WARNING! This method is disabled. |
void |
openParen()
Place an open parenthesis in the WHERE clause. |
void |
or()
Insert an OR between WHERE clauses. |
void |
requireUniqueInstance()
Set "unique instance" assertion bit. |
void |
reset()
Reset the query parameters. |
int |
selectCount()
Get the rowcount of the query by using count(*) in the DB |
void |
setDatabaseLimit(int newLimit)
Set the database limit of the query |
void |
setMaxRows(int maxRows)
Limit the number of rows (DOs) returned. |
void |
setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x)
Set the ATTRIBUTEDEFINITIONOID to query |
void |
setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x,
boolean exact)
Deprecated. Instead use setQueryATTRIBUTEDEFINITIONOID(org.webdocwf.util.genericstore.data.AttributeDefinitionDO x,String cmp_op) |
void |
setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x,
boolean exact,
User usr)
Deprecated. Instead use setQueryATTRIBUTEDEFINITIONOID(org.webdocwf.util.genericstore.data.AttributeDefinitionDO x,String cmp_op, org.webdocwf.dods.access.User usr) WebDocWf extension |
void |
setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x,
java.lang.String cmp_op)
Set the ATTRIBUTEDEFINITIONOID to query, with a QueryBuilder comparison operator. |
void |
setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x,
java.lang.String cmp_op,
User usr)
Set the ATTRIBUTEDEFINITIONOID to query, with a QueryBuilder comparison operator. |
void |
setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x,
User usr)
Set the ATTRIBUTEDEFINITIONOID to query. |
void |
setQueryGENERICOBJECTOID(GenericObjectDO x)
Set the GENERICOBJECTOID to query |
void |
setQueryGENERICOBJECTOID(GenericObjectDO x,
boolean exact)
Deprecated. Instead use setQueryGENERICOBJECTOID(org.webdocwf.util.genericstore.data.GenericObjectDO x,String cmp_op) |
void |
setQueryGENERICOBJECTOID(GenericObjectDO x,
boolean exact,
User usr)
Deprecated. Instead use setQueryGENERICOBJECTOID(org.webdocwf.util.genericstore.data.GenericObjectDO x,String cmp_op, org.webdocwf.dods.access.User usr) WebDocWf extension |
void |
setQueryGENERICOBJECTOID(GenericObjectDO x,
java.lang.String cmp_op)
Set the GENERICOBJECTOID to query, with a QueryBuilder comparison operator. |
void |
setQueryGENERICOBJECTOID(GenericObjectDO x,
java.lang.String cmp_op,
User usr)
Set the GENERICOBJECTOID to query, with a QueryBuilder comparison operator. |
void |
setQueryGENERICOBJECTOID(GenericObjectDO x,
User usr)
Set the GENERICOBJECTOID to query. |
void |
setQueryHandle(java.lang.String handle)
Set the object handle to query. |
void |
setQueryOBJECTVALUE(java.math.BigDecimal x)
Set the OBJECTVALUE to query |
void |
setQueryOBJECTVALUE(java.math.BigDecimal x,
boolean exact)
Deprecated. Instead use setQueryOBJECTVALUE(java.math.BigDecimal x,String cmp_op) |
void |
setQueryOBJECTVALUE(java.math.BigDecimal x,
boolean exact,
User usr)
Deprecated. Instead use setQueryOBJECTVALUE(java.math.BigDecimal x,String cmp_op, org.webdocwf.dods.access.User usr) WebDocWf extension |
void |
setQueryOBJECTVALUE(java.math.BigDecimal x,
java.lang.String cmp_op)
Set the OBJECTVALUE to query, with a QueryBuilder comparison operator. |
void |
setQueryOBJECTVALUE(java.math.BigDecimal x,
java.lang.String cmp_op,
User usr)
Set the OBJECTVALUE to query, with a QueryBuilder comparison operator. |
void |
setQueryOBJECTVALUE(java.math.BigDecimal x,
User usr)
Set the OBJECTVALUE to query. |
void |
setQueryOId(ObjectId oid)
Set the OID to query. |
void |
setReadSkip(int newReadSkip)
Set the readSkip number of the query |
void |
setUnique(boolean newUnique)
Set the unique flag of the query |
void |
setUserStringAppendWildcard(boolean userStringAppendWildcard)
|
void |
setUserStringSingleWildcard(java.lang.String newUserStringSingleWildcard)
|
void |
setUserStringSingleWildcardEscape(java.lang.String newUserStringSingleWildcardEscape)
|
void |
setUserStringTrim(boolean userStringTrim)
|
void |
setUserStringWildcard(java.lang.String newUserStringWildcard)
|
void |
setUserStringWildcardEscape(java.lang.String newUserStringWildcardEscape)
|
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public AttributeObjectValueQuery()
public AttributeObjectValueQuery(User usr) throws AccessException
usr
- The user for security check
AccessException
- The user is not allowed to create a query
WebDocWf extensionMethod Detail |
public static void assertQueryAccess(User usr) throws AccessException
usr
- The user for security check
AccessException
- The user is not allowed to create a query
WebDocWf extensionpublic static boolean hasQueryAccess(User usr) throws AccessEvalException
usr
- The user for security check
AccessEvalException
public User getUser()
public void setUnique(boolean newUnique)
newUnique
- The unique flag for the query
WebDocWf extensionpublic boolean getUnique()
public void setReadSkip(int newReadSkip)
public int getReadSkip()
public void setDatabaseLimit(int newLimit)
newLimit
- The limit for the query
WebDocWf extensionpublic int getDatabaseLimit()
public boolean getDatabaseLimitExceeded()
public void hitDatabase()
public void setUserStringWildcard(java.lang.String newUserStringWildcard)
public void setUserStringSingleWildcard(java.lang.String newUserStringSingleWildcard)
public void setUserStringSingleWildcardEscape(java.lang.String newUserStringSingleWildcardEscape)
public void setUserStringWildcardEscape(java.lang.String newUserStringWildcardEscape)
public void setUserStringAppendWildcard(boolean userStringAppendWildcard)
public void setUserStringTrim(boolean userStringTrim)
public java.lang.String getUserStringWildcard()
public java.lang.String getUserStringSingleWildcard()
public java.lang.String getUserStringSingleWildcardEscape()
public java.lang.String getUserStringWildcardEscape()
public boolean getUserStringAppendWildcard()
public boolean getUserStringTrim()
public void setMaxRows(int maxRows) throws DataObjectException, NonUniqueQueryException
DataObjectException
- If a database access error occurs.
NonUniqueQueryException
- If too many rows were found.public AttributeObjectValueDO[] getDOArray() throws DataObjectException, NonUniqueQueryException
DataObjectException
- If a database access error occurs.
NonUniqueQueryException
- If too many rows were found.public AttributeObjectValueDO getNextDO() throws DataObjectException, NonUniqueQueryException
DataObjectException
- If a database access error occurs.
NonUniqueQueryException
- If too many rows were found.public void setQueryOId(ObjectId oid)
ATTRIBUTEOBJECTVALUE
has a column named "oid"
.
This method is called from the DO classes to retrieve an object by id.
oid
- The object id to query.public void setQueryHandle(java.lang.String handle) throws ObjectIdException
handle
- The string version of the id to query.
ObjectIdException
public void requireUniqueInstance()
public void reset()
public java.sql.ResultSet executeQuery(DBConnection conn) throws java.sql.SQLException
executeQuery
in interface Query
conn
- Handle to database connection.
java.sql.SQLException
- If a database access error occurs.public java.lang.Object next(java.sql.ResultSet rs) throws java.sql.SQLException, ObjectIdException
next
in interface Query
rs
- JDBC result set from which the next object
will be instantiated.
java.sql.SQLException
- If a database access error occurs.
ObjectIdException
- If an invalid object id was queried from the database.public java.lang.String convertUserSearchValue(java.lang.String userSearchValue)
userSearchValue
- The string with user wildcards
public boolean containsWildcards(java.lang.String dbSearchValue)
dbSearchValue
- The string with possible DB wildcards
public int getCount() throws NonUniqueQueryException, DataObjectException, java.sql.SQLException, DatabaseManagerException
NonUniqueQueryException
DataObjectException
java.sql.SQLException
DatabaseManagerException
public int selectCount() throws java.sql.SQLException, DatabaseManagerException
java.sql.SQLException
DatabaseManagerException
public void setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x, java.lang.String cmp_op) throws DataObjectException, QueryException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.
DataObjectException
- If a database access error occurs.
QueryException
- If comparison operator is inappropriate
(e.g. CASE_SENSITIVE_CONTAINS on an integer field).public void setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x, boolean exact) throws DataObjectException, QueryException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or not
DataObjectException
- If a database access error occurs.
QueryException
public void setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x) throws DataObjectException, QueryException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.
DataObjectException
- If a database access error occurs.
QueryException
public void addOrderByATTRIBUTEDEFINITIONOID(boolean direction_flag)
direction_flag
- True for ascending order, false for descendingpublic void addOrderByATTRIBUTEDEFINITIONOID()
public void setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x, boolean exact, User usr) throws DataObjectException, QueryException, AccessException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or notusr
- The user for security check
DataObjectException
- If a database access error occurs.
AccessException
- The user is not allowed to query this attribute
QueryException
public void setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x, User usr) throws DataObjectException, QueryException, AccessException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.usr
- The user for security check
DataObjectException
- If a database access error occurs.
AccessException
- The user is not allowed to query this attribute
WebDocWf extension
QueryException
public void setQueryATTRIBUTEDEFINITIONOID(AttributeDefinitionDO x, java.lang.String cmp_op, User usr) throws DataObjectException, QueryException, AccessException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.usr
- The user for security check
DataObjectException
- If a database access error occurs.
QueryException
- If comparison operator is inappropriate
(e.g. CASE_SENSITIVE_CONTAINS on an integer field).
WebDocWf extension
AccessException
public void assertQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x, boolean exact, User usr) throws AccessException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or notusr
- The user for security check
AccessException
- The user is not allowed to query this attributepublic void assertQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x, java.lang.String cmp_op, User usr) throws AccessException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.usr
- The user for security check
AccessException
- The user is not allowed to query this attribute
WebDocWf extensionpublic void assertQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x, User usr) throws AccessException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.usr
- The user for security check
AccessException
- The user is not allowed to query this attribute
WebDocWf extensionpublic boolean hasQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x, boolean exact, User usr) throws AccessEvalException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or notusr
- The user for security check
AccessEvalException
public boolean hasQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x, java.lang.String cmp_op, User usr) throws AccessEvalException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.usr
- The user for security check
AccessEvalException
public boolean hasQueryAttrATTRIBUTEDEFINITIONOIDAccess(AttributeDefinitionDO x, User usr) throws AccessEvalException
x
- The ATTRIBUTEDEFINITIONOID of the ATTRIBUTEOBJECTVALUE to query.usr
- The user for security check
AccessEvalException
public void setQueryOBJECTVALUE(java.math.BigDecimal x, java.lang.String cmp_op) throws DataObjectException, QueryException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.
DataObjectException
- If a database access error occurs.
QueryException
- If comparison operator is inappropriate
(e.g. CASE_SENSITIVE_CONTAINS on an integer field).public void setQueryOBJECTVALUE(java.math.BigDecimal x, boolean exact) throws DataObjectException, QueryException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or not
DataObjectException
- If a database access error occurs.
QueryException
public void setQueryOBJECTVALUE(java.math.BigDecimal x) throws DataObjectException, QueryException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.
DataObjectException
- If a database access error occurs.
QueryException
public void addOrderByOBJECTVALUE(boolean direction_flag)
direction_flag
- True for ascending order, false for descendingpublic void addOrderByOBJECTVALUE()
public void setQueryOBJECTVALUE(java.math.BigDecimal x, boolean exact, User usr) throws DataObjectException, QueryException, AccessException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or notusr
- The user for security check
DataObjectException
- If a database access error occurs.
AccessException
- The user is not allowed to query this attribute
QueryException
public void setQueryOBJECTVALUE(java.math.BigDecimal x, User usr) throws DataObjectException, QueryException, AccessException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.usr
- The user for security check
DataObjectException
- If a database access error occurs.
AccessException
- The user is not allowed to query this attribute
WebDocWf extension
QueryException
public void setQueryOBJECTVALUE(java.math.BigDecimal x, java.lang.String cmp_op, User usr) throws DataObjectException, QueryException, AccessException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.usr
- The user for security check
DataObjectException
- If a database access error occurs.
QueryException
- If comparison operator is inappropriate
(e.g. CASE_SENSITIVE_CONTAINS on an integer field).
WebDocWf extension
AccessException
public void assertQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x, boolean exact, User usr) throws AccessException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or notusr
- The user for security check
AccessException
- The user is not allowed to query this attributepublic void assertQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x, java.lang.String cmp_op, User usr) throws AccessException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.usr
- The user for security check
AccessException
- The user is not allowed to query this attribute
WebDocWf extensionpublic void assertQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x, User usr) throws AccessException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.usr
- The user for security check
AccessException
- The user is not allowed to query this attribute
WebDocWf extensionpublic boolean hasQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x, boolean exact, User usr) throws AccessEvalException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or notusr
- The user for security check
AccessEvalException
public boolean hasQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x, java.lang.String cmp_op, User usr) throws AccessEvalException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.usr
- The user for security check
AccessEvalException
public boolean hasQueryAttrOBJECTVALUEAccess(java.math.BigDecimal x, User usr) throws AccessEvalException
x
- The OBJECTVALUE of the ATTRIBUTEOBJECTVALUE to query.usr
- The user for security check
AccessEvalException
public void setQueryGENERICOBJECTOID(GenericObjectDO x, java.lang.String cmp_op) throws DataObjectException, QueryException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.
DataObjectException
- If a database access error occurs.
QueryException
- If comparison operator is inappropriate
(e.g. CASE_SENSITIVE_CONTAINS on an integer field).public void setQueryGENERICOBJECTOID(GenericObjectDO x, boolean exact) throws DataObjectException, QueryException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or not
DataObjectException
- If a database access error occurs.
QueryException
public void setQueryGENERICOBJECTOID(GenericObjectDO x) throws DataObjectException, QueryException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.
DataObjectException
- If a database access error occurs.
QueryException
public void addOrderByGENERICOBJECTOID(boolean direction_flag)
direction_flag
- True for ascending order, false for descendingpublic void addOrderByGENERICOBJECTOID()
public void setQueryGENERICOBJECTOID(GenericObjectDO x, boolean exact, User usr) throws DataObjectException, QueryException, AccessException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or notusr
- The user for security check
DataObjectException
- If a database access error occurs.
AccessException
- The user is not allowed to query this attribute
QueryException
public void setQueryGENERICOBJECTOID(GenericObjectDO x, User usr) throws DataObjectException, QueryException, AccessException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.usr
- The user for security check
DataObjectException
- If a database access error occurs.
AccessException
- The user is not allowed to query this attribute
WebDocWf extension
QueryException
public void setQueryGENERICOBJECTOID(GenericObjectDO x, java.lang.String cmp_op, User usr) throws DataObjectException, QueryException, AccessException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.usr
- The user for security check
DataObjectException
- If a database access error occurs.
QueryException
- If comparison operator is inappropriate
(e.g. CASE_SENSITIVE_CONTAINS on an integer field).
WebDocWf extension
AccessException
public void assertQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x, boolean exact, User usr) throws AccessException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or notusr
- The user for security check
AccessException
- The user is not allowed to query this attributepublic void assertQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x, java.lang.String cmp_op, User usr) throws AccessException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.usr
- The user for security check
AccessException
- The user is not allowed to query this attribute
WebDocWf extensionpublic void assertQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x, User usr) throws AccessException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.usr
- The user for security check
AccessException
- The user is not allowed to query this attribute
WebDocWf extensionpublic boolean hasQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x, boolean exact, User usr) throws AccessEvalException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.exact
- to use matches or notusr
- The user for security check
AccessEvalException
public boolean hasQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x, java.lang.String cmp_op, User usr) throws AccessEvalException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.cmp_op
- QueryBuilder comparison operator to use.usr
- The user for security check
AccessEvalException
public boolean hasQueryAttrGENERICOBJECTOIDAccess(GenericObjectDO x, User usr) throws AccessEvalException
x
- The GENERICOBJECTOID of the ATTRIBUTEOBJECTVALUE to query.usr
- The user for security check
AccessEvalException
public QueryBuilder getQueryBuilder()
QueryBuilder
that this AttributeObjectValueQuery
uses to construct and execute database queries.
AttributeObjectValueQuery.setQueryXXX
methods use
the QueryBuilder
to
append SQL expressions to the "WHERE"
clause to be executed.
The QueryBuilder.addEndClause method.
can be used to
append freeform SQL expressions to the WHERE
clause,
e.g. "ORDER BY name".
Notes regarding cache-enabled DO classes:
DO classes can be cache-enabled.
If when using a AttributeObjectValueQuery
, the application developer
does not call getQueryBuilder
,
then AttributeObjectValueQuery.setQueryXXX
methods
simply prune the DO cache and return the remaining results.
However, a QueryBuilder
builds
SELECT
statements for execution by the actual database,
and never searches the built-in cache for the DO.
So, if the DO class is cache-enabled, and getQueryBuilder
is called, this AttributeObjectValueQuery
object ignores the cache
and hits the actual database.
public void or()
OR
between WHERE
clauses.
Example: find all the persons named Bob or Robert:
PersonQuery pq = new PersonQuery();
pq.setQueryFirstName( "Bob" );
pq.or();
pq.setQueryFirstName( "Robert" );
Note: Calls to setQueryXxx
methods
are implicitly AND
ed together,
so the following example will always return nothing:
PersonQuery pq = new PersonQuery();
pq.setQueryFirstName( "Bob" );
// AND automatically inserted here.
pq.setQueryFirstName( "Robert" );
to construct more elaborate queries.
public void openParen()
WHERE
clause.
Example usage: find all the Bobs and Roberts who are 5 or 50 years old:
PersonQuery pq = new PersonQuery();
pq.openParen();
pq.setQueryFirstName( "Bob" );
pq.or();
pq.setQueryFirstName( "Robert" );
pq.closeParen();
// AND automatically inserted here.
pq.openParen();
pq.setQueryAge( 5 );
pq.or();
pq.setQueryAge( 50 );
pq.closeParen();
to construct more elaborate queries.
public void closeParen()
WHERE
clause.
|
Enhydra 5.1 API | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |