ch.jalu.datasourcecolumns

Interface ColumnsHandler<C,I>

Type Parameters:

C - the context type

I - the identifier type

All Known Implementing Classes:

SqlColumnsHandler

public interface ColumnsHandler<C,I>

Handler which performs operations on the data source based on the given columns and values.

Method Summary

Modifier and Type	Method and Description
int	count(Predicate<C> predicate) Returns the number of rows that match the provided predicate.
<D> boolean	insert(D dependent, DependentColumn<?,C,D>... columns) Inserts the given values into a new row, as taken from the dependent object.
boolean	insert(UpdateValues<C> updateValues) Inserts the given values into a new row.
DataSourceValues	retrieve(I identifier, Column<?,C>... columns) Retrieves multiple values from a given row.
<T> DataSourceValue<T>	retrieve(I identifier, Column<T,C> column) Retrieves the given column from a given row.
List<DataSourceValues>	retrieve(Predicate<C> predicate, Column<?,C>... columns) Retrieves the given columns' values from all rows that satisfy the given predicate.
<T> List<T>	retrieve(Predicate<C> predicate, Column<T,C> column) Retrieves a column's value for all rows that satisfy the given predicate.
<T> boolean	update(I identifier, Column<T,C> column, T value) Changes a column from a specific row to the given value.
<D> boolean	update(I identifier, D dependent, DependentColumn<?,C,D>... columns) Updates a row to have the values as retrieved from the dependent object.
boolean	update(I identifier, UpdateValues<C> updateValues) Updates a row to have the given values.
<T> int	update(Predicate<C> predicate, Column<T,C> column, T value) Sets the given value to the provided column for all rows which match the predicate.
int	update(Predicate<C> predicate, UpdateValues<C> updateValues) Updates all rows that match the given predicate with the provided values.

Method Detail

retrieve

<T> DataSourceValue<T> retrieve(I identifier,
                                Column<T,C> column)
                         throws Exception

Retrieves the given column from a given row.

Type Parameters:

T - the column type

Parameters:

identifier - the id of the row to look up

column - the column whose value should be retrieved

Returns:

the result of the lookup

Throws:

Exception

retrieve

DataSourceValues retrieve(I identifier,
                          Column<?,C>... columns)
                   throws Exception

Retrieves multiple values from a given row.

Parameters:

identifier - the id of the row to look up

columns - the columns to retrieve

Returns:

map-like object with the requested values

Throws:

Exception

retrieve

<T> List<T> retrieve(Predicate<C> predicate,
                     Column<T,C> column)
              throws Exception

Retrieves a column's value for all rows that satisfy the given predicate.

Type Parameters:

T - the column's value type

Parameters:

predicate - the predicate to fulfill

column - the column to retrieve from the matching rows

Returns:

the values of the matching rows

Throws:

Exception

retrieve

List<DataSourceValues> retrieve(Predicate<C> predicate,
                                Column<?,C>... columns)
                         throws Exception

Retrieves the given columns' values from all rows that satisfy the given predicate.

Parameters:

predicate - the predicate to fulfill

columns - the columns to retrieve from the matching rows

Returns:

the values in the matching rows

Throws:

Exception

update

<T> boolean update(I identifier,
                   Column<T,C> column,
                   T value)
            throws Exception

Changes a column from a specific row to the given value.

Type Parameters:

T - the column type

Parameters:

identifier - the id of the row to modify

column - the column to modify

value - the value to set the column to

Returns:

true upon success, false otherwise

Throws:

Exception

update

boolean update(I identifier,
               UpdateValues<C> updateValues)
        throws Exception

Updates a row to have the given values.

Parameters:

identifier - the id of the row to modify

updateValues - the values to set on the row

Returns:

true upon success, false otherwise

Throws:

Exception

update

<D> boolean update(I identifier,
                   D dependent,
                   DependentColumn<?,C,D>... columns)
            throws Exception

Updates a row to have the values as retrieved from the dependent object.

Type Parameters:

D - the dependent type

Parameters:

identifier - the id of the row to modify

dependent - the dependent to get values from

columns - the columns to update in the row

Returns:

true upon success, false otherwise

Throws:

Exception

update

<T> int update(Predicate<C> predicate,
               Column<T,C> column,
               T value)
        throws Exception

Sets the given value to the provided column for all rows which match the predicate.

Type Parameters:

T - the column type

Parameters:

predicate - the predicate to filter rows by

column - the column to modify on the matched rows

value - the new value to set

Returns:

number of modified rows

Throws:

Exception

update

int update(Predicate<C> predicate,
           UpdateValues<C> updateValues)
    throws Exception

Updates all rows that match the given predicate with the provided values.

Parameters:

predicate - the predicate to filter rows by

updateValues - the values to set on the matched rows

Returns:

number of modified rows

Throws:

Exception

insert

boolean insert(UpdateValues<C> updateValues)
        throws Exception

Inserts the given values into a new row.

Parameters:

updateValues - the values to insert

Returns:

true upon success, false otherwise

Throws:

IllegalStateException - if there is not at least one column that is not skipped

Exception

insert

<D> boolean insert(D dependent,
                   DependentColumn<?,C,D>... columns)
            throws Exception

Inserts the given values into a new row, as taken from the dependent object.

Type Parameters:

D - the dependent type

Parameters:

dependent - the dependent to get values from

columns - the columns to insert

Returns:

true upon success, false otherwise

Throws:

IllegalStateException - if there is not at least one column that is not skipped

Exception

count

int count(Predicate<C> predicate)
   throws Exception

Returns the number of rows that match the provided predicate.

Parameters:

predicate - the predicate to test the rows for

Returns:

number of rows fulfilling the predicate

Throws:

Exception