ls-standard-library/include/ls-std/core/jni/JniClass.hpp

/*
* Author:          Patrick-Christopher Mattulat
 * Co-Author:       Claude Sonnet 4.6 (LLM)
* Company:         Lynar Studios
* E-Mail:          webmaster@lynarstudios.com
* Created:         2023-04-07
* Changed:         2026-06-23
*
* */

#ifndef LS_STD_JNI_CLASS_HPP
#define LS_STD_JNI_CLASS_HPP

#include "JniClassParameter.hpp"
#include "JniMethod.hpp"
#include "JniReturnValue.hpp"
#include <jni.h>
#include <ls-std/core/interface/IJniApi.hpp>
#include <ls-std/os/dynamic-goal.hpp>
#include <memory>
#include <string>
#include <unordered_map>

/*
 * @doc: class(name: 'JniClass', package: 'core')
 * @doc: core.JniClass.description('This class represents a Java class within the Java Native Interface (JNI).')
 * */

namespace ls::standard::core::experimental
{
  class LS_STD_DYNAMIC_GOAL JniClass
  {
    public:

      explicit JniClass(const ::std::shared_ptr<ls::standard::core::experimental::JniClassParameter> &_parameter, const ::std::string &_path);
      virtual ~JniClass();

      [[nodiscard]] ls::standard::core::experimental::JniReturnValue callMethod(const ::std::string &_methodIdentifier);
      [[nodiscard]] bool hasMethod(const ::std::string &_methodIdentifier);
      bool load();                                                                                    // nodiscard is optional here
      bool loadMethod(const ::std::string &_methodIdentifier, const ::std::string &_methodSignature); // nodiscard is optional here

    private:

      jclass javaClass{};
      ::std::unordered_map<::std::string, ls::standard::core::experimental::JniMethod> methods{};
      ::std::shared_ptr<ls::standard::core::experimental::JniClassParameter> parameter{};
      ::std::string path{};

      void _callBooleanMethod(const ::std::string &_methodIdentifier, ls::standard::core::experimental::JniReturnValue &_returnValue);
      void _callByteMethod(const ::std::string &_methodIdentifier, ls::standard::core::experimental::JniReturnValue &_returnValue);
      void _callCharMethod(const ::std::string &_methodIdentifier, ls::standard::core::experimental::JniReturnValue &_returnValue);
      void _callDoubleMethod(const ::std::string &_methodIdentifier, ls::standard::core::experimental::JniReturnValue &_returnValue);
      void _callFloatMethod(const ::std::string &_methodIdentifier, ls::standard::core::experimental::JniReturnValue &_returnValue);
      void _callIntMethod(const ::std::string &_methodIdentifier, ls::standard::core::experimental::JniReturnValue &_returnValue);
      void _callLongMethod(const ::std::string &_methodIdentifier, ls::standard::core::experimental::JniReturnValue &_returnValue);
      void _callShortMethod(const ::std::string &_methodIdentifier, ls::standard::core::experimental::JniReturnValue &_returnValue);
      void _createJniApi() const;
      [[nodiscard]] bool _hasMethod(const ::std::string &_methodIdentifier);
  };
}

#endif