/*
 * 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 org.jooq.impl.DefaultRecordListenerProvider;

import org.jetbrains.annotations.NotNull;

A provider for RecordListener instances. 

In order to facilitate the lifecycle management of
RecordListener instances that are provided to a jOOQ Configuration, clients can implement this API. To jOOQ, it is thus irrelevant, if execute listeners are stateful or stateless, local to a single record or record manipulation, or global to an application. 
Author:
Lukas Eder
See Also:
RecordListener
Configuration/**
 * A provider for {@link RecordListener} instances.
 * <p>
 * In order to facilitate the lifecycle management of
 * <code>RecordListener</code> instances that are provided to a jOOQ
 * {@link Configuration}, clients can implement this API. To jOOQ, it is thus
 * irrelevant, if execute listeners are stateful or stateless, local to a single
 * record or record manipulation, or global to an application.
 *
 * @author Lukas Eder
 * @see RecordListener
 * @see Configuration
 */
@FunctionalInterface
public interface RecordListenerProvider {

    
Provide a RecordListener instance.

Implementations are free to choose whether this method returns new
instances at every call or whether the same instance is returned
repetitively.

A RecordListener shall be provided exactly once per
UpdatableRecord manipulation, i.e. per
RecordContext.
See Also:
RecordListener
RecordContext
DefaultRecordListenerProvider
Returns:
An RecordListener instance./**
     * Provide a <code>RecordListener</code> instance.
     * <p>
     * Implementations are free to choose whether this method returns new
     * instances at every call or whether the same instance is returned
     * repetitively.
     * <p>
     * A <code>RecordListener</code> shall be provided exactly once per
     * <code>UpdatableRecord</code> manipulation, i.e. per
     * <code>RecordContext</code>.
     *
     * @return An <code>RecordListener</code> instance.
     * @see RecordListener
     * @see RecordContext
     * @see DefaultRecordListenerProvider
     */
    @NotNull
    RecordListener provide();
}