PreparedStatementCallback (aSQL-common 1.0.2 API)

Type Parameters:

T - The result type

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
```
@FunctionalInterface
public interface PreparedStatementCallback<T>
```
Represents a callback interface for code that operates on a PreparedStatement. This is internally used by the DataTemplate class but it's also useful for custom purposes.
Note: the passed-in PreparedStatement can have been created by aSQL or by a custom PreparedStatementCreator implementation. However, the latter is hardly ever necessary, as most custom callback actions will perform updates in which case a standard PreparedStatement is fine. Custom actions will always set parameter values themselves, so that PreparedStatementCreator capability is not needed either.

Implementations don't need to worry about handling exceptions: they will be handled by aSQL DataTemplate and passed to a CompletableFuture for further analysis by the user.

See Also:

DataTemplate.execute(String, PreparedStatementCallback), DataTemplate.execute(PreparedStatementCreator, PreparedStatementCallback)

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`T`	`doInPreparedStatement(PreparedStatement ps)`	Gets called by `DataTemplate.execute(String, PreparedStatementCallback)` or `DataTemplate.execute(PreparedStatementCreator, PreparedStatementCallback)`.

- Method Detail
  - doInPreparedStatement
```
@Nullable
T doInPreparedStatement(PreparedStatement ps)
                 throws SQLException
```
    Gets called by DataTemplate.execute(String, PreparedStatementCallback) or DataTemplate.execute(PreparedStatementCreator, PreparedStatementCallback).
    ATTENTION: any ResultSet should be closed within this callback implementation. This method doesn't imply that the ResultSet (as other resources) will be closed. Still, this method should grant (as shown in DataTemplate various implementations) that the statement will be closed at the end of the operations.
    
    Parameters:
    
    ps - an active PreparedStatement
    
    Returns:
    
    a result object or null if it's not available
    
    Throws:
    
    SQLException - if thrown by a DataTemplate's method (no need to catch).