AndroidJni.h

#pragma once
 
#if PL_ENABLED(PL_PLATFORM_ANDROID)
 
#  include <Foundation/Logging/Log.h>
#  include <Foundation/Strings/StringBuilder.h>
#  include <jni.h>
 
class plJniObject;
class plJniClass;
class plJniString;
 
enum class plJniErrorState
{
  SUCCESS = 0,
 
  PENDING_EXCEPTION,
 
  NO_MATCHING_METHOD,
 
  AMBIGUOUS_CALL,
 
  NO_MATCHING_FIELD,
 
  CALL_ON_NULL_OBJECT,
 
  CLASS_NOT_FOUND,
};
 
class PL_FOUNDATION_DLL plJniAttachment
{
public:
  plJniAttachment();
 
  ~plJniAttachment();
 
  static plJniObject GetActivity();
 
  static JNIEnv* GetEnv();
 
  static plJniErrorState GetLastError();
 
  static void ClearLastError();
 
  static bool HasPendingException();
 
  static plJniObject GetPendingException();
 
  static void ClearPendingException();
 
  static void SetLastError(plJniErrorState state);
 
  static bool FailOnPendingErrorOrException();
 
private:
  static thread_local JNIEnv* s_env;
  static thread_local bool s_ownsEnv;
  static thread_local int s_attachCount;
  static thread_local plJniErrorState s_lastError;
 
  plJniAttachment(const plJniAttachment&);
  plJniAttachment& operator=(const plJniAttachment&);
};
 
enum class plJniOwnerShip
{
  OWN,
 
  COPY,
 
  BORROW
};
 
class PL_FOUNDATION_DLL plJniObject
{
public:
  plJniObject();
 
  inline plJniObject(jobject object, plJniOwnerShip ownerShip);
 
  inline plJniObject(const plJniObject& other);
 
  inline plJniObject(plJniObject&& other);
 
  inline plJniObject& operator=(const plJniObject& other);
 
  inline plJniObject& operator=(plJniObject&& other);
 
  inline virtual ~plJniObject();
 
  inline bool operator==(const plJniObject& other) const;
 
  inline bool operator!=(const plJniObject& other) const;
 
  bool IsNull() const { return m_object == nullptr; }
 
  jobject GetHandle() const;
 
  plJniClass GetClass() const;
 
  plJniString ToString() const;
 
  bool IsInstanceOf(const plJniClass& clazz) const;
 
  template <typename Ret = void, typename... Args>
  Ret Call(const char* name, const Args&... args) const;
 
  template <typename Ret>
  Ret GetField(const char* name) const;
 
  template <typename T>
  void SetField(const char* name, const T& arg) const;
 
  template <typename Ret, typename... Args>
  Ret UnsafeCall(const char* name, const char* signature, const Args&... args) const;
 
  template <typename Ret>
  Ret UnsafeGetField(const char* name, const char* signature) const;
 
  template <typename T>
  void UnsafeSetField(const char* name, const char* signature, const T& arg) const;
 
protected:
  inline void Reset();
  inline jobject GetJObject() const;
 
  static void DumpTypes(const plJniClass* inputTypes, int N, const plJniClass* returnType);
 
  static int CompareMethodSpecificity(const plJniObject& method1, const plJniObject& method2);
  static bool IsMethodViable(bool bStatic, const plJniObject& candidateMethod, const plJniClass& returnType, plJniClass* inputTypes, int N);
  static plJniObject FindMethod(bool bStatic, const char* name, const plJniClass& type, const plJniClass& returnType, plJniClass* inputTypes, int N);
 
  static int CompareConstructorSpecificity(const plJniObject& method1, const plJniObject& method2);
  static bool IsConstructorViable(const plJniObject& candidateMethod, plJniClass* inputTypes, int N);
  static plJniObject FindConstructor(const plJniClass& type, plJniClass* inputTypes, int N);
 
private:
  jobject m_object;
  jclass m_class;
  bool m_own;
};
 
class PL_FOUNDATION_DLL plJniString : public plJniObject
{
public:
  plJniString();
 
  plJniString(const char* str);
 
  plJniString(jstring string, plJniOwnerShip ownerShip);
 
  plJniString(const plJniString& other);
 
  plJniString(plJniString&& other);
 
  plJniString& operator=(const plJniString& other);
 
  plJniString& operator=(plJniString&& other);
 
  virtual ~plJniString();
 
  const char* GetData() const;
 
private:
  const char* m_utf;
};
 
class PL_FOUNDATION_DLL plJniClass : public plJniObject
{
public:
  plJniClass();
 
  plJniClass(const char* className);
 
  plJniClass(jclass clazz, plJniOwnerShip ownerShip);
 
  plJniClass(const plJniClass& other);
 
  plJniClass(plJniClass&& other);
 
  plJniClass& operator=(const plJniClass& other);
 
  plJniClass& operator=(plJniClass&& other);
 
  jclass GetHandle() const;
 
  template <typename... Args>
  plJniObject CreateInstance(const Args&... args) const;
 
  bool IsAssignableFrom(const plJniClass& other) const;
 
  bool IsPrimitive();
 
  template <typename Ret = void, typename... Args>
  Ret CallStatic(const char* name, const Args&... args) const;
 
  template <typename Ret>
  Ret GetStaticField(const char* name) const;
 
  template <typename T>
  void SetStaticField(const char* name, const T& arg) const;
 
  template <typename Ret, typename... Args>
  Ret UnsafeCallStatic(const char* name, const char* signature, const Args&... args) const;
 
  template <typename Ret>
  Ret UnsafeGetStaticField(const char* name, const char* signature) const;
 
  template <typename T>
  void UnsafeSetStaticField(const char* name, const char* signature, const T& arg) const;
};
 
#  include <Foundation/Basics/Platform/Android/AndroidJni.inl>
 
#endif