org.hrorm

Class ColumnImpl<TYPE,ENTITY,BUILDER>

java.lang.Object

org.hrorm.ColumnImpl<TYPE,ENTITY,BUILDER>

Type Parameters:

TYPE - The type of the data element.

ENTITY - The type of the entity.

BUILDER - The class that is used to build new entity instances.

All Implemented Interfaces:

Column<ENTITY,BUILDER>

public class ColumnImpl<TYPE,ENTITY,BUILDER>
extends Object
implements Column<ENTITY,BUILDER>

A basic implementation of the Column interface for data elements.

Most users of hrorm will have no need to directly use this.

Constructor Summary

Constructors

Constructor and Description
ColumnImpl(GenericColumn<TYPE> genericColumn, String prefix, String name, Function<ENTITY,MODELTYPE> getter, BiConsumer<BUILDER,MODELTYPE> setter, String sqlTypeName, boolean nullable, Converter<MODELTYPE,TYPE> converter)
ColumnImpl(GenericColumn<TYPE> genericColumn, String prefix, String name, Function<ENTITY,TYPE> getter, BiConsumer<BUILDER,TYPE> setter, String sqlTypeName, boolean nullable)

Method Summary

Modifier and Type	Method and Description
String	getName() The name of the database column this instance represents.
String	getPrefix() The prefix that should be used for this column when generating SQL.
String	getSqlTypeName() Returns the name of the column type in SQL, e.g.
boolean	isNullable() Indicator of whether or not this column is nullable or not.
void	notNull() Calling this method will enforce a not-null constraint on this column.
PopulateResult	populate(BUILDER builder, ResultSet resultSet) Populates the object with the data read from the database.
void	setSqlTypeName(String sqlTypeName)
void	setValue(ENTITY item, int index, PreparedStatement preparedStatement) Sets a value onto the prepared statement based on the state of the object passed.
Set<Integer>	supportedTypes() The members of java.sql.Types that this column should support.
Column<ENTITY,BUILDER>	withPrefix(String newPrefix, Prefixer prefixer) Make a new instance of the column, identical to this instance, except with a new prefix.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.hrorm.Column

isParentColumn, isPrimaryKey

Constructor Detail

ColumnImpl

public ColumnImpl(GenericColumn<TYPE> genericColumn,
                  String prefix,
                  String name,
                  Function<ENTITY,TYPE> getter,
                  BiConsumer<BUILDER,TYPE> setter,
                  String sqlTypeName,
                  boolean nullable)

ColumnImpl

public ColumnImpl(GenericColumn<TYPE> genericColumn,
                  String prefix,
                  String name,
                  Function<ENTITY,MODELTYPE> getter,
                  BiConsumer<BUILDER,MODELTYPE> setter,
                  String sqlTypeName,
                  boolean nullable,
                  Converter<MODELTYPE,TYPE> converter)

Method Detail

setValue

public void setValue(ENTITY item,
                     int index,
                     PreparedStatement preparedStatement)
              throws SQLException

Description copied from interface: Column

Sets a value onto the prepared statement based on the state of the object passed.

Specified by:

setValue in interface Column<ENTITY,BUILDER>

Parameters:

item - The object to read the data from.

index - Where in the prepared statement to set the read value

preparedStatement - The statement being populated

Throws:

SQLException - allowed for PreparedStatement operations

populate

public PopulateResult populate(BUILDER builder,
                               ResultSet resultSet)
                        throws SQLException

Description copied from interface: Column

Populates the object with the data read from the database.

Specified by:

populate in interface Column<ENTITY,BUILDER>

Parameters:

builder - The object being populated

resultSet - The result said being read

Returns:

A coded value indicating information about what happened during population

Throws:

SQLException - allowed for ResultSet operations

getName

public String getName()

Description copied from interface: Column

The name of the database column this instance represents.

Specified by:

getName in interface Column<ENTITY,BUILDER>

Returns:

The name of the column in the underlying database.

getPrefix

public String getPrefix()

Description copied from interface: Column

The prefix that should be used for this column when generating SQL. This is necessary to prevent name clashes between columns of other tables that might be joined with this one.

Specified by:

getPrefix in interface Column<ENTITY,BUILDER>

Returns:

The prefix to use when generating SQL with this column instance.

notNull

public void notNull()

Description copied from interface: Column

Calling this method will enforce a not-null constraint on this column.

Specified by:

notNull in interface Column<ENTITY,BUILDER>

isNullable

public boolean isNullable()

Description copied from interface: Column

Indicator of whether or not this column is nullable or not.

Specified by:

isNullable in interface Column<ENTITY,BUILDER>

Returns:

true if this column is allowed to contain null values, false otherwise.

supportedTypes

public Set<Integer> supportedTypes()

Description copied from interface: Column

The members of java.sql.Types that this column should support.

Specified by:

supportedTypes in interface Column<ENTITY,BUILDER>

Returns:

The types that should be handled by this column type.

getSqlTypeName

public String getSqlTypeName()

Description copied from interface: Column

Returns the name of the column type in SQL, e.g. "text" for String, "decimal" for BigDecimal.

Specified by:

getSqlTypeName in interface Column<ENTITY,BUILDER>

Returns:

The SQL name of the type.

setSqlTypeName

public void setSqlTypeName(String sqlTypeName)

Specified by:

setSqlTypeName in interface Column<ENTITY,BUILDER>

withPrefix

public Column<ENTITY,BUILDER> withPrefix(String newPrefix,
                                         Prefixer prefixer)

Description copied from interface: Column

Make a new instance of the column, identical to this instance, except with a new prefix.

Specified by:

withPrefix in interface Column<ENTITY,BUILDER>

Parameters:

newPrefix - The new prefix

prefixer - The source for new prefixes

Returns:

A new instance of the column with the reset prefix