me.saharnooby.lib.query.set

Class ResultSetWrapper

java.lang.Object

me.saharnooby.lib.query.set.ResultSetWrapper

All Implemented Interfaces:

AutoCloseable

public final class ResultSetWrapper
extends Object
implements AutoCloseable

A ResultSet wrapper allowing useful operations like mapping. If closed, underlying result set will be closed.

Since:

13:16 14.11.2019

Author:

saharNooby

Constructor Summary

Constructors

Constructor and Description
ResultSetWrapper(@NonNull ResultSet set) Constructs a new wrapper.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the underlying ResultSet.
<T> Optional<T>	map(@NonNull ResultSetMapper<T> mapper) Maps the first row in the result set, if it exists, using specified mapper and returns an optional value.
<T> List<T>	mapAll(@NonNull ResultSetMapper<T> mapper) Maps all rows in the result set using specified mapper and collects the results to a list.
ResultSet	set()

Methods inherited from class java.lang.Object

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

Constructor Detail

ResultSetWrapper

public ResultSetWrapper(@NonNull
                        @NonNull ResultSet set)

Constructs a new wrapper.

Parameters:

set - A result set.

Method Detail

set

public ResultSet set()

Returns:

Underlying ResultSet.

close

public void close()
           throws SQLException

Closes the underlying ResultSet.

Specified by:

close in interface AutoCloseable

Throws:

SQLException - On SQL error.

mapAll

public <T> List<T> mapAll(@NonNull
                          @NonNull ResultSetMapper<T> mapper)
                   throws SQLException

Maps all rows in the result set using specified mapper and collects the results to a list. Underlying result set will be closed after this method returns.

Type Parameters:

T - Mapped element type.

Parameters:

mapper - Mapper.

Returns:

List of mapped rows.

Throws:

SQLException - On SQL error.

map

public <T> Optional<T> map(@NonNull
                           @NonNull ResultSetMapper<T> mapper)
                    throws SQLException

Maps the first row in the result set, if it exists, using specified mapper and returns an optional value. Underlying result set will be closed after this method returns. The optional will be empty if the set contains no rows or if the mapper returned null.

Type Parameters:

T - Mapped element type.

Parameters:

mapper - Mapper.

Returns:

Optional value containing the mapped row.

Throws:

SQLException - On SQL error.