Package org.jdbi.v3.core.statement

Class Binding

java.lang.Object

org.jdbi.v3.core.statement.Binding

Direct Known Subclasses:

PreparedBinding

public class Binding
extends Object

Represents the arguments bound to a particular statement.

Field Summary

Fields

Modifier and Type	Field	Description
protected Map<String,Object>	named
protected List<NamedArgumentFinder>	namedArgumentFinder
protected Map<Integer,Object>	positionals

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Binding(StatementContext ctx)

Method Summary

Modifier and Type	Method	Description
void	addNamed(String name, Object argument)	Bind a named parameter for the given name.
void	addNamed(String name, Object argument, QualifiedType<?> type)	Bind a named parameter for the given name.
void	addNamed(String name, Argument argument)	Bind a named parameter for the given name.
void	addNamedArgumentFinder(NamedArgumentFinder args)	Bind a named argument finder.
void	addPositional(int position, Object argument)	Bind a positional parameter at the given index (0-based).
void	addPositional(int position, Object argument, QualifiedType<?> type)	Bind a positional parameter at the given index (0-based).
void	addPositional(int position, Argument argument)	Bind a positional parameter at the given index (0-based).
void	clear()	Remove all bindings from this Binding.
Optional<Argument>	findForName(String name, StatementContext ctx2)	Deprecated. don't inspect a Binding: keep your own state!
Optional<Argument>	findForPosition(int position)	Deprecated. don't inspect a Binding: keep your own state!
Collection<String>	getNames()	Deprecated. this is expensive to compute, and it's bad practice to inspect a Binding: keep track of your own state!
boolean	isEmpty()
String	toString()

Methods inherited from class java.lang.Object

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

Field Details

positionals

protected final Map<Integer,Object> positionals

named

protected final Map<String,Object> named

namedArgumentFinder

protected final List<NamedArgumentFinder> namedArgumentFinder

Constructor Details

Binding

protected Binding(StatementContext ctx)

Method Details

addPositional

public void addPositional(int position,
 Argument argument)

Bind a positional parameter at the given index (0-based).

Parameters:

position - binding position

argument - the argument to bind

addNamed

public void addNamed(String name,
 Argument argument)

Bind a named parameter for the given name.

Parameters:

name - bound argument name

argument - the argument to bind

addPositional

public void addPositional(int position,
 Object argument)

Bind a positional parameter at the given index (0-based).

Parameters:

position - binding position

argument - the argument to bind

addNamed

public void addNamed(String name,
 Object argument)

Bind a named parameter for the given name.

Parameters:

name - bound argument name

argument - the argument to bind

addPositional

public void addPositional(int position,
 Object argument,
 QualifiedType<?> type)

Bind a positional parameter at the given index (0-based).

Parameters:

position - binding position

argument - the argument to bind

addNamed

public void addNamed(String name,
 Object argument,
 QualifiedType<?> type)

Bind a named parameter for the given name.

Parameters:

name - bound argument name

argument - the argument to bind

addNamedArgumentFinder

public void addNamedArgumentFinder(NamedArgumentFinder args)

Bind a named argument finder.

Parameters:

args - the argument finder to bind

findForName

@Deprecated
public Optional<Argument> findForName(String name,
 StatementContext ctx2)

Deprecated.

don't inspect a Binding: keep your own state!

Look up an argument by name.

Parameters:

name - the key to lookup the value of

ctx2 - the statement context

Returns:

the bound Argument

getNames

@Deprecated
public Collection<String> getNames()

Deprecated.

this is expensive to compute, and it's bad practice to inspect a Binding: keep track of your own state!

Returns:

the set of known binding names

findForPosition

@Deprecated
public Optional<Argument> findForPosition(int position)

Deprecated.

don't inspect a Binding: keep your own state!

Look up an argument by position.

Parameters:

position - starts at 0, not 1

Returns:

argument bound to that position

toString

public String toString()

Overrides:

toString in class Object

clear

public void clear()

Remove all bindings from this Binding.

isEmpty

public boolean isEmpty()

Returns:

true if there are no bindings yet