Package org.queryman.builder.command

Interface Conditions

All Superinterfaces:

AstVisitor

All Known Implementing Classes:

ConditionsImpl

public interface Conditions
extends AstVisitor

This supplies a search condition. Conditions are used in different context, some of usual examples:

• SELECT .. FROM .. JOIN .. ON conditions
• SELECT .. WHERE conditions
• SELECT .. HAVING conditions
• DELETE .. WHERE conditions
• UPDATE .. WHERE conditions

Each condition is built from operands and operator returning a boolean type value (=, !=, IN, IS, IS NOT etc). Internally, any operator is being a Expression object. And operator is being Operator object. For convenience sake it's possible to use a String representation of them, which will convert into needful type. Example:

Queryman.conditions("id", "=", "1") .and("name", "=", "Alan") .and(condition("age", ">", "29") .and("gender", "!=", "male") .or("code", "=", "3") );

Conditions can be grouped:

// "id" = 1 AND (users.name = 'Alan' AND gender != 'male' OR code = 3) Queryman.conditions(asQuotedName("id"), operator("="), asNumber("1")) .and(asName("users.name"), "=", asString("Alan") .and(asName("gender"), "!=", asString("male")) .or(asName("code"), "=", asNumber("3")) );

See conditions' methods in Queryman:

See Also:

Queryman.condition(Object, Object, Object)

Method Summary

Modifier and Type	Method	Description
Conditions	and(Conditions conditions)	This function useful in a few case: When the conditions is a special case of condition, like Queryman.conditionBetween(Object, Object, Object), or Queryman.conditionSome(Object, Object, Query) etc.
<T> Conditions	and(T left, T operator, T right)	Example: // SELECT * FROM book WHERE year > 2010 AND "id" = 1 select("*") .from("book") .where("year", ">", "2010") .and(asQuotedName("id"), operator("="), asNumber(1)) .sql()
Conditions	andExists(Query query)	Example: // SELECT * FROM book WHERE year > 2010 AND EXISTS (SELECT * FROM author) select("*") .from("book") .where("year", ">", "2010") .andExists(select("*").from("authors")) .sql()
Conditions	andNot(Conditions conditions)	This function useful in a few case: When the conditions is a special case of condition, like Queryman.conditionBetween(Object, Object, Object), or Queryman.conditionSome(Object, Object, Query) etc.
<T> Conditions	andNot(T left, T operator, T right)	Example: // SELECT * FROM book WHERE year > 2010 AND NOT "id" = 1 select("*") .from("book") .where("year", ">", "2010") .andNot(asQuotedName("id"), operator("="), asNumber(1)) .sql()
Conditions	andNotExists(Query query)	Example: // SELECT * FROM book WHERE year > 2010 AND NOT EXISTS (SELECT * FROM author) select("*") .from("book") .where("year", ">", "2010") .andNotExists(select("*").from("authors")) .sql()
Node	getNode()
Conditions	or(Conditions conditions)	This function useful in a few case: When the conditions is a special case of condition, like Queryman.conditionBetween(Object, Object, Object), or Queryman.conditionSome(Object, Object, Query) etc.
<T> Conditions	or(T left, T operator, T right)	Example: // SELECT * FROM book WHERE year > 2010 OR id = 1 select("*") .from("book") .where("year", ">", "2010") .or("id", "=", "1") .sql()
Conditions	orExists(Query query)	Example: // SELECT * FROM book WHERE year > 2010 OR EXISTS (SELECT * FROM author) select("*") .from("book") .where("year", ">", "2010") .orExists(select("*").from("authors")) .sql()
Conditions	orNot(Conditions conditions)	This function useful in a few case: When the conditions is a special case of condition, like Queryman.conditionBetween(Object, Object, Object), or Queryman.conditionSome(Object, Object, Query) etc.
<T> Conditions	orNot(T left, T operator, T right)	Example: // SELECT * FROM book WHERE year > 2010 OR NOT "id" = 1 select("*") .from("book") .where("year", ">", "2010") .orNot(asQuotedName("id"), "=", 1) .sql()
Conditions	orNotExists(Query query)	Example: // SELECT * FROM book WHERE year > 2010 OR NOT EXISTS (SELECT * FROM author) select("*") .from("book") .where("year", ">", "2010") .orNotExists(select("*").from("authors")) .sql()

Methods inherited from interface org.queryman.builder.ast.AstVisitor

assemble

Method Detail

and

<T> Conditions and(T left,
                   T operator,
                   T right)

Example: // SELECT * FROM book WHERE year > 2010 AND "id" = 1 select("*") .from("book") .where("year", ">", "2010") .and(asQuotedName("id"), operator("="), asNumber(1)) .sql()

Type Parameters:

T - String, Expression, Operator or Query object

Parameters:

left - left operand

operator - operator

right - right operand

andExists

Conditions andExists(Query query)

Example: // SELECT * FROM book WHERE year > 2010 AND EXISTS (SELECT * FROM author) select("*") .from("book") .where("year", ">", "2010") .andExists(select("*").from("authors")) .sql()

Parameters:

query - subquery

Returns:

itself

and

Conditions and(Conditions conditions)

This function useful in a few case:

• When the conditions is a special case of condition, like Queryman.conditionBetween(Object, Object, Object), or Queryman.conditionSome(Object, Object, Query) etc. See the first example.
• When the conditions is conditions are joined by AND, AND NOT, OR and OR NOT operators. These conditions is being a grouped condition, and will be surrounded by parentheses. See the second example.

The first example: // SELECT * FROM book WHERE year > 2010 AND id BETWEEN 1 AND 10 select("*") .from("book") .where("year", ">", "2010") .and(conditionBetween("id", "1", "10")) .sql() The second example: // SELECT * FROM book WHERE year > 2010 AND (id BETWEEN 1 AND 10 AND name = 'Advanced SQL') select("*") .from("book") .where("year", ">", "2010") .and( conditionBetween("id", "1", "10") .and(asName("name"), operator("="), asString("Advanced SQL")) ) .sql()

Parameters:

conditions - condition

Returns:

itself Kind of conditions:

See Also:

Queryman.condition(Object, Object, Object)

andNot

<T> Conditions andNot(T left,
                      T operator,
                      T right)

Example: // SELECT * FROM book WHERE year > 2010 AND NOT "id" = 1 select("*") .from("book") .where("year", ">", "2010") .andNot(asQuotedName("id"), operator("="), asNumber(1)) .sql()

Type Parameters:

T - String, Expression, Operator or Query object

Parameters:

left - left operand

operator - operator

right - right operand

andNotExists

Conditions andNotExists(Query query)

Example: // SELECT * FROM book WHERE year > 2010 AND NOT EXISTS (SELECT * FROM author) select("*") .from("book") .where("year", ">", "2010") .andNotExists(select("*").from("authors")) .sql()

Parameters:

query - subquery

Returns:

itself

andNot

Conditions andNot(Conditions conditions)

This function useful in a few case:

• When the conditions is a special case of condition, like Queryman.conditionBetween(Object, Object, Object), or Queryman.conditionSome(Object, Object, Query) etc. See the first example.
• When the conditions is conditions are joined by AND, AND NOT, OR and OR NOT operators. These conditions is being a grouped condition, and will be surrounded by parentheses. See the second example.

The first example: // SELECT * FROM book WHERE year > 2010 AND NOT id BETWEEN 1 AND 10 select("*") .from("book") .where("year", ">", "2010") .andNot(conditionBetween("id", "1", "10")) .sql() The second example: // SELECT * FROM book WHERE year > 2010 AND NOT (id BETWEEN 1 AND 10 AND name = 'Advanced SQL') select("*") .from("book") .where("year", ">", "2010") .andNot( conditionBetween("id", "1", "10") ..and(asName("name"), operator("="), asString("Advanced SQL")) ) .sql()

Parameters:

conditions - condition

Returns:

itself Kind of conditions:

See Also:

Queryman.condition(Object, Object, Object)

or

<T> Conditions or(T left,
                  T operator,
                  T right)

Example: // SELECT * FROM book WHERE year > 2010 OR id = 1 select("*") .from("book") .where("year", ">", "2010") .or("id", "=", "1") .sql()

Type Parameters:

T - String, Expression, Operator or Query object

Parameters:

left - left operand

operator - operator

right - right operand

orExists

Conditions orExists(Query query)

Example: // SELECT * FROM book WHERE year > 2010 OR EXISTS (SELECT * FROM author) select("*") .from("book") .where("year", ">", "2010") .orExists(select("*").from("authors")) .sql()

Parameters:

query - subquery

Returns:

itself

or

Conditions or(Conditions conditions)

This function useful in a few case:

• When the conditions is a special case of condition, like Queryman.conditionBetween(Object, Object, Object), or Queryman.conditionSome(Object, Object, Query) etc. See the first example.
• When the conditions is conditions are joined by AND, AND NOT, OR and OR NOT operators. These conditions is being a grouped condition, and will be surrounded by parentheses. See the second example.

The first example: // SELECT * FROM book WHERE year > 2010 OR id BETWEEN 1 AND 10 select("*") .from("book") .where("year", ">", "2010") .or(conditionBetween("id", "1", "10")) .sql() The second example: // SELECT * FROM book WHERE year > 2010 OR (id BETWEEN 1 AND 10 AND name = 'Advanced SQL') select("*") .from("book") .where("year", ">", "2010") .ir( conditionBetween("id", "1", "10") ..and(asName("name"), operator("="), asString("Advanced SQL")) ) .sql()

Parameters:

conditions - condition

Returns:

itself Kind of conditions:

See Also:

Queryman.condition(Object, Object, Object)

orNot

<T> Conditions orNot(T left,
                     T operator,
                     T right)

Example: // SELECT * FROM book WHERE year > 2010 OR NOT "id" = 1 select("*") .from("book") .where("year", ">", "2010") .orNot(asQuotedName("id"), "=", 1) .sql()

Type Parameters:

T - String, Expression, Operator or Query object

Parameters:

left - left operand

operator - operator

right - right operand

orNotExists

Conditions orNotExists(Query query)

Example: // SELECT * FROM book WHERE year > 2010 OR NOT EXISTS (SELECT * FROM author) select("*") .from("book") .where("year", ">", "2010") .orNotExists(select("*").from("authors")) .sql()

Parameters:

query - subquery

Returns:

itself

orNot

Conditions orNot(Conditions conditions)

This function useful in a few case:

• When the conditions is a special case of condition, like Queryman.conditionBetween(Object, Object, Object), or Queryman.conditionSome(Object, Object, Query) etc. See the first example.
• When the conditions is conditions are joined by AND, AND NOT, OR and OR NOT operators. These conditions is being a grouped condition, and will be surrounded by parentheses. See the second example.

The first example: // SELECT * FROM book WHERE year > 2010 OR NOT id BETWEEN 1 AND 10 select("*") .from("book") .where("year", ">", "2010") .orNot(conditionBetween("id", "1", "10")) .sql() The second example: // SELECT * FROM book WHERE year > 2010 OR NOT (id BETWEEN 1 AND 10 AND name = 'Advanced SQL') select("*") .from("book") .where("year", ">", "2010") .orNot( conditionBetween("id", "1", "10") ..and(asName("name"), operator("="), asString("Advanced SQL")) ) .sql()

Parameters:

conditions - condition

Returns:

itself Kind of conditions:

See Also:

Queryman.condition(Object, Object, Object)

getNode

Node getNode()