Expose function to determine if a global JVM is available

Summary: This is useful in pure C++ environments. Useful to write tests for cross platform code that uses libraries that conditionally use JNI.

Differential Revision: D21758426

fbshipit-source-id: 8c252b9e90a456eba06e6634b437da4cbfc40965
2 files changed
tree: bb0e385b5c6f48bc6efc4b67c3fca19ccb00611c
  1. .github/
  2. cxx/
  3. docs/
  4. gradle/
  5. java/
  6. scripts/
  7. test/
  8. .gitignore
  9. build.gradle
  10. CMakeLists.txt
  11. CODE_OF_CONDUCT.md
  12. CONTRIBUTING.md
  13. googletest-CMakeLists.txt.in
  14. gradle.properties
  15. gradlew
  16. gradlew.bat
  17. host.gradle
  18. LICENSE
  19. README.md
  20. settings.gradle
README.md

fbjni

The Facebook JNI helpers library is designed to simplify usage of the Java Native Interface. The helpers were implemented to ease the integration of cross-platform mobile code on Android, but there are no Android specifics in the design. It can be used with any Java VM that supports JNI.

struct JMyClass : JavaClass<JMyClass> {
  static constexpr auto kJavaDescriptor = "Lcom/example/MyClass;";

  // Automatic inference of Java method descriptors.
  static std::string concatenate(
      alias_ref<JClass> clazz,
      // Automatic conversion to std::string.
      std::string prefix) {
    // Call methods easily.
    static const auto getSuffix = clazz->getStaticMethod<JString()>("getSuffix");
    // Manage JNI references automatically.
    local_ref<JString> jstr = getSuffix(clazz);
    // Automatic exception translation between Java and C++ (both ways).
    // No need to check exception state after each call.
    result += jstr->toStdString();
    // Automatic conversion from std::string.
    return result;
  }
};

Documentation

License

fbjni is Apache-2 licensed, as found in the LICENSE file.