com.ibm.pdq.annotation
Annotation Type Format
@Target(value={METHOD,FIELD}) @Retention(value=RUNTIME) public @interface FormatThe Format anotation is used to specify a class that contains methods for converting field data between String format and JDBC Object, in both directions. When retrieving objects from a database ResultSet, JDBC objects can be formatted into Strings. When the annotated field is used as an input parameter for an SQL statement, the reverse operation can be performed - converting the contents of a String into the expected JDBC object type.
See the pureQuery Runtime documentation for more information about using the Format annotation.
Required Element Summary
Modifier and Type | Required Element and Description |
---|---|
|
formatterClass
Specifies a java class that will be used to do the formatting and parsing between java Object
and a formatted string.
|
formattingOptions
Specifies a string containing options directing the formattingClass how to do the formatting and
parsing between String and JDBC object.
|
Required Element Detail
formatterClass
public abstract Class<?> formatterClass
Specifies a java class that will be used to do the formatting and parsing between java Object
and a formatted string.
The class must provide
- A constructor method, that takes a single String argument. During execution,
this String argument will receive the formattingOptions string specified below.
the constructor should parse and process or store the input options as necessary for
later use by the format and parse methods
- A format() method, which will be used when retrieving data from a resultSet. The method should
take the java Object, as returned by the Resultset and format it into a String, then return the
String.
- A parse() method, which will be used when the annotated field is used as an input parameter.
The method will take a String argument, which is assumed to be in a certain format, then parse it
and create an appropriate Object for use as an input parameter on the associated SQL statement.
formattingOptions
public abstract String formattingOptions
Specifies a string containing options directing the formattingClass how to do the formatting and
parsing between String and JDBC object.