org.jdbi.v3.sqlobject.customizers

Annotation Type BindList

@Retention(value=RUNTIME)
 @Target(value=PARAMETER)
public @interface BindList

Binds each value in the annotated Iterable or array/varargs argument, and defines a named attribute as a comma-separated list of each bound parameter name. Common use cases:

 @SqlQuery("select * from things where id in (<ids>)")
 List<Thing> getThings(@BindList int... ids)

 @SqlQuery("insert into things (<columnNames>) values (<values>)")
 void insertThings(@DefineList List<String> columnNames, @BindList List<Object> values)
 

Throws IllegalArgumentException if the argument is not an array or Iterable. How null and empty collections are handled can be configured with onEmpty:EmptyHandling - throws IllegalArgumentException by default.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
BindList.EmptyHandling	onEmpty what to do when the argument is null or empty
String	value The attribute name to define.

Element Detail

value

public abstract String value

The attribute name to define. If omitted, the name of the annotated parameter is used. It is an error to omit the name when there is no parameter naming information in your class files.

Returns:

the attribute name.

Default:

""

onEmpty

public abstract BindList.EmptyHandling onEmpty

what to do when the argument is null or empty

Default:

org.jdbi.v3.sqlobject.customizers.BindList.EmptyHandling.THROW