* Scalar in the sense that the types are not compound types. Scalar types only * map to a single database column. - *
** These types fall into two categories. Types that are mapped natively to JDBC * types and the rest. Types that map to native JDBC types do not require any * data type conversion to be persisted to the database. These are java types * that map via java.sql.Types. - *
** Types that are not native to JDBC require some conversion. These include some * common java types such as java.util.Date, java.util.Calendar, * java.math.BigInteger. - *
** Note that Booleans may be native for some databases and require conversion on * other databases. - *
*/ public interface ScalarType* If a BeanProperty has no explicit length defined then this length should * be assigned. - *
- *- * This is primarily to support defining a length on Enum types (to - * supplement defining the length on the BeanProperty directly). - *
*/ - int getLength(); + default int getLength() { + return 0; + } /** * Return true if the type is native to JDBC. ** If it is native to JDBC then its values/instances do not need to be * converted to and from an associated JDBC type. - *
*/ boolean isJdbcNative(); @@ -83,16 +84,13 @@ public interface ScalarType* This type should be consistent with the toJdbcType() method in converting * the type to the appropriate type for binding to preparedStatements. - *
*/ int getJdbcType(); /** * Return the type that matches the bean property type. *- * This represents the 'logical' type rather than the JDBC type this maps - * to. - *
+ * This represents the 'logical' type rather than the JDBC type this maps to. */ Class* value may need to be converted from the logical bean property type to the * JDBC type. - *
*/ void bind(DataBinder binder, T value) throws SQLException; /** * Convert the value as necessary to the JDBC type. *- * Note that this should also match the type as per the getJdbcType() - * method. - *
+ * Note that this should also match the type as per the getJdbcType() method. ** This is typically used when the matching type is used in a where clause * and we use this to ensure it is an appropriate jdbc type. - *
*/ Object toJdbcType(Object value); @@ -135,19 +129,14 @@ public interface ScalarType* The type as per the bean property. - *
** This is used to automatically convert id values (typically from a string * to a int, long or UUID). - *
*/ T toBeanType(Object value); /** * Convert the type into a string representation. - *- * Reciprocal of parse(). - *
*/ String formatValue(T value); @@ -155,10 +144,8 @@ public interface ScalarType* This assumes the value is of the correct type. - *
** This is so that ScalarType also implements the StringFormatter interface. - *
*/ @Override String format(Object value); @@ -167,10 +154,6 @@ public interface ScalarType* Mostly used to support CSV, JSON and XML parsing. - *
- *- * Reciprocal of formatValue(). - *
*/ @Override T parse(String value); @@ -183,29 +166,32 @@ public interface ScalarType- * This is used to determine if is is sensible to use the + * This is used to determine if it is sensible to use the * {@link #convertFromMillis(long)} method. - *
** This includes the Date, Calendar, sql Date, Time, Timestamp, JODA types * as well as Long, BigDecimal and String (although it generally is not * expected to parse systemTimeMillis to a String or BigDecimal). - *
*/ - boolean isDateTimeCapable(); + default boolean isDateTimeCapable() { + return false; + } /** * Convert the value into a long version value. */ - long asVersion(T value); + default long asVersion(T value) { + throw new UnsupportedOperationException(); + } /** * Convert the systemTimeMillis into the appropriate java object. ** For non dateTime types this will throw an exception. - *
*/ - T convertFromMillis(long dateTime); + default T convertFromMillis(long dateTime) { + throw new UnsupportedOperationException(); + } /** * Read the value from binary input. @@ -215,7 +201,7 @@ public interface ScalarType