org.ujorm.tools

Class JdbcBuilder

java.lang.Object

org.ujorm.tools.JdbcBuilder

All Implemented Interfaces:

Serializable

public final class JdbcBuilder
extends Object
implements Serializable

PrepareStatement builder support

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected List<Object>	arguments Seznam argumentů
protected int	columnCounter Column counter
protected int	conditionCounter Condition counter
protected boolean	emptySql The SQL buffer has assigned an character
protected boolean	insertMode An insert sign for different rendering
protected static char	ITEM_SEPARATOR Separator of database columns
protected static char	SPACE A value marker for SQL
protected StringBuilder	sql Opening SQL string
protected static char	VALUE_MARKER A value marker for SQL

Constructor Summary

Constructors

Constructor and Description
JdbcBuilder() Default constructor
JdbcBuilder(StringBuilder sql) StringBuilder construcor

Method Summary

Modifier and Type	Method and Description
JdbcBuilder	andCondition(CharSequence sqlCondition, Object value) Add an condition for a valid argument joined by AND operator
JdbcBuilder	andCondition(CharSequence sqlCondition, String operator, Object value) Add an equals condition for a valid argument joined by AND operator
JdbcBuilder	column(CharSequence column) Add new column
JdbcBuilder	columnInsert(CharSequence column, Object value) Set new value to column by template {@code name = ?
JdbcBuilder	columnUpdate(CharSequence column, Object value) Set new value to column by template {@code name = ?
JdbcBuilder	concat(JdbcBuilder builder) Concatenates the specified statement to the end of this statement.
JdbcBuilder	condition(CharSequence sqlCondition, Object value, Boolean andOperator) Add an condition for an argument with length
JdbcBuilder	condition(CharSequence sqlCondition, String operator, Object value, Boolean andOperator) Add an condition for an argument with length
int	executeUpdate(Connection connection) Create statement and call PreparedStatement.executeUpdate() .
Object[]	getArguments() Array of JDBC argumets
String	getSql() Returns a SQL text
JdbcBuilder	orCondition(CharSequence sqlCondition, Object value) Add an condition for a valid argument joined by OR operator
JdbcBuilder	orCondition(CharSequence sqlCondition, String operator, Object value) Add an equals condition for a valid argument joined by OR operator
PreparedStatement	prepareStatement(Connection connection) Build the PreparedStatement with arguments
JdbcBuilder	rawArguments(Object... values) Add raw arguments for special use
JdbcBuilder	rawWrite(CharSequence sqlFragment) Write argument with no space
String	toString() Returns a SQL including values
<T> T	uniqueValue(Class<T> resultType, Connection connection) Return the first column value of a unique resultset, else returns null value
JdbcBuilder	value(Object param) Add new value
JdbcBuilder	write(CharSequence sqlFragment) If buffer is an empty, than the space is introduced

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

ITEM_SEPARATOR

protected static final char ITEM_SEPARATOR

Separator of database columns

See Also:

Constant Field Values

VALUE_MARKER

protected static final char VALUE_MARKER

A value marker for SQL

See Also:

Constant Field Values

SPACE

protected static final char SPACE

A value marker for SQL

See Also:

Constant Field Values

sql

@Nonnull
protected final StringBuilder sql

Opening SQL string

arguments

protected final List<Object> arguments

Seznam argumentů

emptySql

protected boolean emptySql

The SQL buffer has assigned an character

columnCounter

protected int columnCounter

Column counter

conditionCounter

protected int conditionCounter

Condition counter

insertMode

protected boolean insertMode

An insert sign for different rendering

Constructor Detail

JdbcBuilder

public JdbcBuilder()

Default constructor

JdbcBuilder

public JdbcBuilder(@Nonnull
                   StringBuilder sql)

StringBuilder construcor

Method Detail

concat

@Nonnull
public JdbcBuilder concat(@Nonnull
                                   JdbcBuilder builder)

Concatenates the specified statement to the end of this statement.

write

@Nonnull
public JdbcBuilder write(@Nonnull
                                  CharSequence sqlFragment)

If buffer is an empty, than the space is introduced

rawWrite

@Nonnull
public JdbcBuilder rawWrite(@Nonnull
                                     CharSequence sqlFragment)

Write argument with no space

column

@Nonnull
public JdbcBuilder column(@Nonnull
                                   CharSequence column)

Add new column

columnUpdate

@Nonnull
public JdbcBuilder columnUpdate(@Nonnull
                                         CharSequence column,
                                         @Nonnull
                                         Object value)

Set new value to column by template {@code name = ?

columnInsert

@Nonnull
public JdbcBuilder columnInsert(@Nonnull
                                         CharSequence column,
                                         @Nonnull
                                         Object value)

Set new value to column by template {@code name = ?

value

@Nonnull
public JdbcBuilder value(@Nonnull
                                  Object param)

Add new value

andCondition

@Nonnull
public JdbcBuilder andCondition(@Nonnull
                                         CharSequence sqlCondition,
                                         @Nullable
                                         Object value)

Add an condition for a valid argument joined by AND operator

Parameters:

sqlCondition - A condition in the SQL format like the next: "table.id = ?"

value - The value od the condition (a replacement for the question character)

andCondition

@Nonnull
public JdbcBuilder andCondition(@Nonnull
                                         CharSequence sqlCondition,
                                         @Nullable
                                         String operator,
                                         @Nullable
                                         Object value)

Add an equals condition for a valid argument joined by AND operator

Parameters:

sqlCondition - A condition in the SQL format like the next: "table.id = ?"

operator - An optional operator is followed by the VALUE_MARKER automatically

value - The value od the condition (a replacement for the question character)

orCondition

@Nonnull
public JdbcBuilder orCondition(@Nonnull
                                        CharSequence sqlCondition,
                                        @Nullable
                                        Object value)

Add an condition for a valid argument joined by OR operator

Parameters:

sqlCondition - A condition in the SQL format like the next: "table.id = ?"

value - The value od the condition (a replacement for the question character)

orCondition

@Nonnull
public JdbcBuilder orCondition(@Nonnull
                                        CharSequence sqlCondition,
                                        @Nullable
                                        String operator,
                                        @Nullable
                                        Object value)

Add an equals condition for a valid argument joined by OR operator

Parameters:

sqlCondition - A condition in the SQL format like the next: "table.id = ?"

operator - An optional operator is followed by the VALUE_MARKER automatically

value - The value od the condition (a replacement for the question character)

condition

@Nonnull
public JdbcBuilder condition(@Nonnull
                                      CharSequence sqlCondition,
                                      @Nullable
                                      Object value,
                                      @Nullable
                                      Boolean andOperator)

Add an condition for an argument with length

Parameters:

sqlCondition - A condition in the SQL format like the next: "table.id = ?"

value - The value od the condition (a replacement for the question character)

condition

@Nonnull
public JdbcBuilder condition(@Nonnull
                                      CharSequence sqlCondition,
                                      @Nullable
                                      String operator,
                                      @Nullable
                                      Object value,
                                      @Nullable
                                      Boolean andOperator)

Add an condition for an argument with length

Parameters:

sqlCondition - A condition in the SQL format like the next: "table.id = ?"

operator - An optional operator is followed by the VALUE_MARKER automatically

value - The value od the condition (a replacement for the question character)

getArguments

@Nonnull
public Object[] getArguments()

Array of JDBC argumets

Returns:

Array of arguments

rawArguments

@Nonnull
public JdbcBuilder rawArguments(@Nonnull
                                         Object... values)

Add raw arguments for special use

See Also:

rawWrite(java.lang.CharSequence)

prepareStatement

@Nonnull
public PreparedStatement prepareStatement(@Nonnull
                                                   Connection connection)
                                            throws SQLException

Build the PreparedStatement with arguments

Throws:

SQLException

executeUpdate

public int executeUpdate(@Nonnull
                         Connection connection)
                  throws IllegalStateException

Create statement and call PreparedStatement.executeUpdate() . Supported SQL statements are: INSERT, UPDATE, DELETE .

Throws:

IllegalStateException

uniqueValue

public <T> T uniqueValue(@Nonnull
                         Class<T> resultType,
                         @Nonnull
                         Connection connection)
                  throws IllegalStateException

Return the first column value of a unique resultset, else returns null value

Throws:

IllegalStateException

getSql

@Nonnull
public String getSql()

Returns a SQL text

toString

@Nonnull
public String toString()

Returns a SQL including values

Overrides:

toString in class Object