// Licensed to the Apache Software Foundation (ASF) under one

// or more contributor license agreements.  See the NOTICE file

// distributed with this work for additional information

// regarding copyright ownership.  The ASF licenses this file

// to you 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.

#pragma once

#include <cstddef>

#include <map>

#include <memory>

#include <string>

#include <unordered_map>

#include <unordered_set>

#include <vector>

#include "common/status.h"

#include "format/generic_reader.h"

#include "format/jni/jni_data_bridge.h"

#include "runtime/runtime_profile.h"

#include "util/jni-util.h"

#include "util/jni_plugin_registry.h"

#include "util/profile_collector.h"

#include "util/string_util.h"

namespace doris {

class RuntimeProfile;

class RuntimeState;

class SlotDescriptor;

class Block;

} // namespace doris

namespace doris {

/**

 * JniReader is the base class for all JNI-based readers. It directly manages

 * the JNI lifecycle (open/read/close) for Java scanners that extend

 * org.apache.doris.jni.spi.JniScanner.

 *

 * Subclasses only need to:

 * 1. Build scanner_params/column_names in their constructor

 * 2. Pass them to JniReader's constructor

 * 3. Call open() in their init_reader()

 *

 * This class replaces the old JniConnector intermediary.

 */

class JniReader : public GenericReader {

public:

    /**

     * Constructor for scan mode.

     * @param file_slot_descs  Slot descriptors for the output columns

     * @param state            Runtime state

     * @param profile          Runtime profile for metrics

     * @param plugin_ref       Plugin and factory that build the Java scanner (e.g. {"paimon", "paimon"})

     * @param scanner_params   Configuration map passed to the Java scanner factory

     * @param column_names     Fields to read (also the required_fields in scanner_params)

     * @param self_split_weight  Weight for this split (for profile conditition counter)

     */

    JniReader(const std::vector<SlotDescriptor*>& file_slot_descs, RuntimeState* state,

              RuntimeProfile* profile, Jni::PluginRef plugin_ref,

              std::map<std::string, std::string> scanner_params,

              std::vector<std::string> column_names, int64_t self_split_weight = -1);

    /**

     * Constructor for table-schema-only mode (no data reading).

     * @param plugin_ref       Plugin and factory that build the Java scanner

     * @param scanner_params   Configuration map passed to the Java scanner factory

     */

    JniReader(Jni::PluginRef plugin_ref, std::map<std::string, std::string> scanner_params);

    ~JniReader() override = default;

    /**

     * Open the java scanner: set up profile counters, create Java object,

     * get method IDs, and call JniScanner#open.

     */

    Status open(RuntimeState* state, RuntimeProfile* profile);

    void set_batch_size(size_t batch_size) override;

    size_t get_batch_size() const override { return _batch_size; }

    /**

     * Read next batch from Java scanner and fill the block.

     */

    Status _do_get_next_block(Block* block, size_t* read_rows, bool* eof) override;

    /**

     * Close the scanner and release JNI resources.

     */

    Status close() override;

protected:

    void _collect_profile_before_close() override;

    /**

     * Update scanner params and column names after construction.

     * Used by Avro which builds params in init_reader/init_schema_reader

     * rather than in the constructor.

     */

    void _update_scanner_params(std::map<std::string, std::string> params,

                                std::vector<std::string> column_names) {

        _scanner_params = std::move(params);

        _column_names = std::move(column_names);

    }

    const std::vector<SlotDescriptor*>& _file_slot_descs;

    RuntimeState* _state = nullptr;

    RuntimeProfile* _profile = nullptr;

private:

    static const std::vector<SlotDescriptor*> _s_empty_slot_descs;

    Status _init_jni_scanner(JNIEnv* env, int batch_size);

    Status _fill_block(Block* block, size_t num_rows);

    Status _get_statistics(JNIEnv* env, std::map<std::string, std::string>* result);

    Jni::PluginRef _plugin_ref;

    std::string _connector_name;

    std::map<std::string, std::string> _scanner_params;

    std::vector<std::string> _column_names;

    int32_t _self_split_weight = -1;

    bool _is_table_schema = false;

    RuntimeProfile::Counter* _open_scanner_time = nullptr;

    RuntimeProfile::Counter* _java_scan_time = nullptr;

    RuntimeProfile::Counter* _java_append_data_time = nullptr;

    RuntimeProfile::Counter* _java_create_vector_table_time = nullptr;

    RuntimeProfile::Counter* _fill_block_time = nullptr;

    RuntimeProfile::ConditionCounter* _max_time_split_weight_counter = nullptr;

    int64_t _jni_scanner_open_watcher = 0;

    int64_t _java_scan_watcher = 0;

    int64_t _fill_block_watcher = 0;

    size_t _has_read = 0;

    bool _closed = false;

    bool _scanner_opened = false;

    Jni::GlobalObject _jni_scanner_obj;

    // Resolved on the SPI base class and shared by every reader in the process, so this is a

    // borrowed pointer into storage that outlives any reader.

    const Jni::ScannerApi* _scanner_api = nullptr;

    JniDataBridge::TableMetaAddress _table_meta;

    size_t _batch_size = 0;

    void _set_meta(long meta_addr) { _table_meta.set_meta(meta_addr); }

};

} // namespace doris