org.irenical.drowsy.query.builder

Interface QueryBuilder<BUILDER_CLASS extends QueryBuilder<BUILDER_CLASS>>

All Known Implementing Classes:

BaseQueryBuilder, DeleteBuilder, ExpressionBuilder, InsertBuilder, SelectBuilder, UpdateBuilder

public interface QueryBuilder<BUILDER_CLASS extends QueryBuilder<BUILDER_CLASS>>

Method Summary

Modifier and Type	Method and Description
Query	build() Returns a built query.
BUILDER_CLASS	literal(Object sql) Append literal value
BUILDER_CLASS	literals(Iterable<?> sql, String prefix, String suffix, String separator)
BUILDER_CLASS	param(Object param) Append a parameter.
BUILDER_CLASS	params(Iterable<?> params, String prefix, String suffix, String separator) Append multiple values.
BUILDER_CLASS	subquery(Query subquery) Appends the query's string value to this query builder, prefixed by ( and suffixed by ).

Method Detail

build

Query build()

Returns a built query. The returned Query is a snapshot of the current QueryBuilder state. That is to say that further changes to QueryBuilder should not affect it.

Returns:

Query - the query built so far

literal

BUILDER_CLASS literal(Object sql)

Append literal value

Parameters:

sql - - the SQL query fragment to be appended

Returns:

the builder

literals

BUILDER_CLASS literals(Iterable<?> sql,
                       String prefix,
                       String suffix,
                       String separator)

param

BUILDER_CLASS param(Object param)

Append a parameter. A ? will be appended to the query

Parameters:

param - - the object representing the value

Returns:

the builder

params

BUILDER_CLASS params(Iterable<?> params,
                     String prefix,
                     String suffix,
                     String separator)

Append multiple values. A ? will be appended to the query for each value Useful for IN expressions

Parameters:

params - - the objects representing the parameters

prefix - - a literal prepended to the parameters

suffix - - a literal postpended to the parameters

separator - - a literal separating each parameter

Returns:

the builder

subquery

BUILDER_CLASS subquery(Query subquery)

Appends the query's string value to this query builder, prefixed by ( and suffixed by ). Adds given query's parameters to the current builder parameter list.

Parameters:

subquery - - the subquery

Returns:

the builder