io.micronaut.data.mongodb.repository.MongoReactiveQueryExecutor Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of micronaut-data-mongodb Show documentation
Data Repository Support for Micronaut
There is a newer version: 4.10.5
Show newest version
/*
 * Copyright 2017-2023 original authors
 *
 * 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
 *
 * https://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 io.micronaut.data.mongodb.repository;

import com.mongodb.client.model.DeleteOptions;
import com.mongodb.client.model.UpdateOptions;
import io.micronaut.core.annotation.NonNull;
import io.micronaut.core.annotation.Nullable;
import io.micronaut.data.model.Page;
import io.micronaut.data.model.Pageable;
import io.micronaut.data.mongodb.operations.options.MongoAggregationOptions;
import io.micronaut.data.mongodb.operations.options.MongoFindOptions;
import org.bson.conversions.Bson;
import reactor.core.publisher.Flux;
import reactor.core.publisher.Mono;


/**
 * MongoDB specific reactive repository that allows to use direct BSON objects reactive way.
 * Essentially, the same as {@link MongoQueryExecutor} just reactive implementation.
 *
 * @param  The entity type
 * @author radovanradic
 * @since 4.2
 */
public interface MongoReactiveQueryExecutor {

    /**
     * Finds one result.
     *
     * @param filter The filter to be applied
     * @return The single result
     */
    Mono findOne(@Nullable Bson filter);

    /**
     * Finds one result.
     *
     * @param options The options
     * @return The single result
     */
    Mono findOne(@NonNull MongoFindOptions options);

    /**
     * Finds all results.
     *
     * @param filter The filter to be applied
     * @return The records
     */
    @NonNull
    Flux findAll(@Nullable Bson filter);

    /**
     * Finds all results.
     *
     * @param options The options
     * @return The records
     */
    @NonNull
    Flux findAll(@NonNull MongoFindOptions options);

    /**
     * Finds a page of records.
     *
     * @param filter   The filter
     * @param pageable The pageable
     * @return The page
     */
    @NonNull
    Mono> findAll(@Nullable Bson filter, @NonNull Pageable pageable);

    /**
     * Finds a page of records.
     *
     * @param options  The options
     * @param pageable The pageable
     * @return The page
     */
    @NonNull
    Mono> findAll(@NonNull MongoFindOptions options, @NonNull Pageable pageable);

    /**
     * Finds a page of records.
     *
     * @param pipeline The pipeline to be applied
     * @return The single result
     */
    Mono findOne(@NonNull Iterable pipeline);

    /**
     * Finds one result.
     *
     * @param pipeline The pipeline to be applied
     * @param options  The aggregation options
     * @return The single result
     */
    Mono findOne(@NonNull Iterable pipeline, @NonNull MongoAggregationOptions options);

    /**
     * Finds all results.
     *
     * @param pipeline The pipeline to be applied
     * @return The results
     */
    @NonNull
    Flux findAll(@NonNull Iterable pipeline);

    /**
     * Finds all results.
     *
     * @param pipeline The pipeline to be applied
     * @param options  The options
     * @return The results
     */
    @NonNull
    Flux findAll(@NonNull Iterable pipeline, @NonNull MongoAggregationOptions options);

    /**
     * Count the records.
     *
     * @param filter The filter to be applied
     * @return The count
     */
    Mono count(@Nullable Bson filter);

    /**
     * Delete the records matching the filter.
     *
     * @param filter The filter to be applied
     * @return The deleted count
     */
    Mono deleteAll(@NonNull Bson filter);

    /**
     * Delete the records matching the filter.
     *
     * @param filter  The filter to be applied
     * @param options The delete options
     * @return The deleted count
     */
    Mono deleteAll(@NonNull Bson filter, @NonNull DeleteOptions options);

    /**
     * Update the records matching the filter.
     *
     * @param filter The filter to be applied
     * @param update The update modification
     * @return The updated count
     */
    Mono updateAll(@NonNull Bson filter, @NonNull Bson update);

    /**
     * Update the records matching the filter.
     *
     * @param filter  The filter to be applied
     * @param update  The update modification
     * @param options The update options
     * @return The updated count
     */
    Mono updateAll(@NonNull Bson filter, @NonNull Bson update, @NonNull UpdateOptions options);
}