org.jdbi.v3.sqlobject.Handler Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jdbi3-sqlobject Show documentation
Show all versions of jdbi3-sqlobject Show documentation
SqlObject is a declarative, annotation-driven API
for database access. It complements the core API.
Jdbi 3 is designed to provide convenient tabular data access in
Java(tm) and other JVM based languages.
It uses the Java collections framework for query results,
provides a convenient means of externalizing SQL statements, and
named parameter support for any database that supports JDBC.
/*
* 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.sqlobject;
import org.jdbi.v3.core.extension.ExtensionHandler;
import org.jdbi.v3.core.extension.HandleSupplier;
import org.jdbi.v3.core.internal.JdbiClassUtils;
/**
* Implements the contract of a SQL Object method.
*
* @deprecated Use {@link ExtensionHandler} directly.
*/
@FunctionalInterface
@Deprecated
public interface Handler extends ExtensionHandler {
/**
* Executes a SQL Object method, and returns the result.
*
* @param target the SQL Object instance being invoked
* @param args the arguments that were passed to the method.
* @param handleSupplier a (possibly lazy) Handle supplier.
* @return the method return value, or null if the method has a void return type.
* @throws Exception any exception thrown by the method.
*/
Object invoke(Object target, Object[] args, HandleSupplier handleSupplier) throws Exception;
@Override
default Object invoke(HandleSupplier handleSupplier, Object target, Object... args) throws Exception {
return invoke(target, JdbiClassUtils.safeVarargs(args), handleSupplier);
}
}