buckelieg.simpletools.db.Query Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of db-tools Show documentation

Simple-tools project for database: functional style programming with plain JDBC

There is a newer version: 1.0.5

/*
* Copyright 2016-2017 Anatoly Kutyakov
*
* 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 buckelieg.simpletools.db;

import javax.annotation.Nonnull;

/**
 * Query abstraction.
 *
 * @param  query execution results type
 */
public interface Query {

    /**
     * Executes this query with expected results of certain type.
     *
     * @return query execution result
     */
    @Nonnull
    R execute();

    /**
     * Updates query execution timeout
     *
     * @param timeout query timeout in seconds gt 0 (0 means no timeout)
     * @param      type bounds
     * @return query abstraction
     * @see java.sql.Statement#setQueryTimeout(int)
     */
    @Nonnull
    > Q timeout(int timeout);

}