/*
 * 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.
 *
 * Other licenses:
 * -----------------------------------------------------------------------------
 * Commercial licenses for this work are available. These replace the above
 * ASL 2.0 and offer limited warranties, support, maintenance, and commercial
 * database integrations.
 *
 * For more information, please visit: http://www.jooq.org/licenses
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 */
package org.jooq;

import java.sql.Statement;
import java.util.stream.Stream;

import org.jooq.exception.DetachedException;
import org.jooq.impl.DSL;

import org.jetbrains.annotations.NotNull;

A wrapper for a collection of queries.
 Instances can be created using DSL.queries(Query...) and overloads. 
Author:
Lukas Eder/**
 * A wrapper for a collection of queries.
 * <p>
 * Instances can be created using {@link DSL#queries(Query...)} and overloads.
 *
 * @author Lukas Eder
 */
public interface Queries extends QueryPart, Attachable, Iterable<Query> {

    // ------------------------------------------------------------------------
    // Access API
    // ------------------------------------------------------------------------

    
Return a new instance combining both sets of queries.
/**
     * Return a new instance combining both sets of queries.
     */
    @NotNull
    Queries concat(Queries other);

    
The wrapped collection of queries.
/**
     * The wrapped collection of queries.
     */
    @NotNull
    Query[] queries();

    
The wrapped collection of queries as a Block. /**
     * The wrapped collection of queries as a {@link Block}.
     */
    @NotNull
    Block block();


    
The wrapped collection of queries.
Deprecated:
- 3.10 - [#6143] - Use queryStream() instead./**
     * The wrapped collection of queries.
     *
     * @deprecated - 3.10 - [#6143] - Use {@link #queryStream()} instead.
     */
    @NotNull
    @Deprecated
    Stream<Query> stream();

    
The wrapped collection of queries.
/**
     * The wrapped collection of queries.
     */
    @NotNull
    Stream<Query> queryStream();


    // ------------------------------------------------------------------------
    // Execution API
    // ------------------------------------------------------------------------

    
Execute all queries one-by-one and return all results.
 This is a convenience method for executing individual queries(). 
 If this Queries reference is attached to a Configuration, then that configuration is used through DSLContext.fetchMany(ResultQuery<Record>) or DSLContext.execute(Query). If this queries reference is unattached, then each individual ResultQuery.fetchMany() or Query.execute() method is called. 
Throws:
DetachedException – If this queries reference is unattached and at least one of the contained queries() is also unattached./**
     * Execute all queries one-by-one and return all results.
     * <p>
     * This is a convenience method for executing individual {@link #queries()}.
     * <p>
     * If this {@link Queries} reference is attached to a {@link Configuration},
     * then that <code>configuration</code> is used through
     * {@link DSLContext#fetchMany(ResultQuery)} or
     * {@link DSLContext#execute(Query)}. If this <code>queries</code> reference
     * is unattached, then each individual {@link ResultQuery#fetchMany()} or
     * {@link Query#execute()} method is called.
     *
     * @throws DetachedException If this <code>queries</code> reference is
     *             unattached and at least one of the contained
     *             {@link #queries()} is also unattached.
     */
    @NotNull
    Results fetchMany();

    
Sends the entire batch of queries to the server and executes them using a JDBC Statement.executeBatch() operation. 
 This Queries reference must be attached to a Configuration. 
Throws:
DetachedException – If this queries reference is
            unattached.
See Also:
DSLContext.batch(Queries)/**
     * Sends the entire batch of queries to the server and executes them using a
     * JDBC {@link Statement#executeBatch()} operation.
     * <p>
     * This {@link Queries} reference must be attached to a
     * {@link Configuration}.
     *
     * @throws DetachedException If this <code>queries</code> reference is
     *             unattached.
     * @see DSLContext#batch(Queries)
     */
    @NotNull
    int[] executeBatch();
}