/*
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.jdbi.v3.core.mapper;

import java.sql.ResultSet;
import java.sql.SQLException;

import org.jdbi.v3.core.statement.StatementContext;

Maps result set columns to objects.
Type parameters:
<T> – The mapped type
See Also:
ColumnMapperFactory
ColumnMappers
ResultBearing.map(ColumnMapper<Object>)
Configurable.registerColumnMapper(ColumnMapper)
Configurable.registerColumnMapper(Type, ColumnMapper)
StatementContext.findColumnMapperFor(Type)/**
 * Maps result set columns to objects.
 *
 * @param <T> The mapped type
 * @see ColumnMapperFactory
 * @see ColumnMappers
 * @see org.jdbi.v3.core.result.ResultBearing#map(ColumnMapper)
 * @see org.jdbi.v3.core.config.Configurable#registerColumnMapper(ColumnMapper)
 * @see org.jdbi.v3.core.config.Configurable#registerColumnMapper(java.lang.reflect.Type, ColumnMapper)
 * @see StatementContext#findColumnMapperFor(java.lang.reflect.Type)
 */
@FunctionalInterface
public interface ColumnMapper<T> {
    
Map the given column of the current row of the result set to an Object. This method should not cause the result
set to advance; allow Jdbi to do that, please.
Params:
r –            the result set being iterated
columnNumber – the column number to map (starts at 1)
ctx –          the statement context
Throws:
SQLException – if anything goes wrong go ahead and let this percolate; Jdbi will handle it
Returns:
the value to return for this column/**
     * Map the given column of the current row of the result set to an Object. This method should not cause the result
     * set to advance; allow Jdbi to do that, please.
     *
     * @param r            the result set being iterated
     * @param columnNumber the column number to map (starts at 1)
     * @param ctx          the statement context
     * @return the value to return for this column
     * @throws SQLException if anything goes wrong go ahead and let this percolate; Jdbi will handle it
     */
    T map(ResultSet r, int columnNumber, StatementContext ctx) throws SQLException;

    
Map the given column of the current row of the result set to an Object. This method should not cause the result
set to advance; allow Jdbi to do that, please.
Params:
r –           the result set being iterated
columnLabel – the column label to map
ctx –         the statement context
Throws:
SQLException – if anything goes wrong go ahead and let this percolate; Jdbi will handle it
Returns:
the value to return for this column/**
     * Map the given column of the current row of the result set to an Object. This method should not cause the result
     * set to advance; allow Jdbi to do that, please.
     *
     * @param r           the result set being iterated
     * @param columnLabel the column label to map
     * @param ctx         the statement context
     * @return the value to return for this column
     * @throws SQLException if anything goes wrong go ahead and let this percolate; Jdbi will handle it
     */
    default T map(ResultSet r, String columnLabel, StatementContext ctx) throws SQLException {
        return map(r, r.findColumn(columnLabel), ctx);
    }
}