Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / libnativehelper / b366380916d4fc2ac69ff15df12b03acd6011ae9
commitb366380916d4fc2ac69ff15df12b03acd6011ae9[log] [tgz]
authorSorin Basca <sorinbasca@google.com>Thu Mar 04 14:41:10 2021 +0000
committerSorin Basca <sorinbasca@google.com>Tue Mar 09 15:18:32 2021 +0000
tree250bc03f2e3aa7f981f90c56227c447d8b8feb96
parent2cb627435a4ccca6e9d82bfdb37b4a19e1cce7b2 [diff]
Add jniThrowErrnoException in libnativehelper

Since a few places in frameworks and libcore implement their own
functions to throw android.system.ErrnoException, these have been
integrated in libnativehelper to avoid duplication.

As part of the change a more generic ThrowException function is
provided that can take a variable number of arguments, rather
than just a description string. Due to this, the code now
constructs the exception object itself and then passes it to the
JNIEnv.

A helper macro is also added to convert the C string to jstring
for the description parameter, which is usually the first
parameter in the exception constructors.

Bug: 180958753
Fix: 180958753
Test: atest MtsLibnativehelperTestCases
Test: atest MtsLibnativehelperLazyTestCases
Change-Id: I4841cf9924a48eaf0b6965c203c9ebe851e443ff
7 files changed
tree: 250bc03f2e3aa7f981f90c56227c447d8b8feb96
  1. header_only_include/
  2. include/
  3. include_jni/
  4. include_platform/
  5. include_platform_header_only/
  6. tests/
  7. tests_mts/
  8. ALog-priv.h
  9. Android.bp
  10. DlHelp.c
  11. DlHelp.h
  12. ExpandableString.c
  13. ExpandableString.h
  14. file_descriptor_jni.c
  15. JniConstants.c
  16. JniConstants.h
  17. JNIHelp.c
  18. JniInvocation-priv.h
  19. JniInvocation.c
  20. JNIPlatformHelp.c
  21. libnativehelper.map.txt
  22. libnativehelper_lazy.c
  23. libnativehelper_lazy.h
  24. NOTICE
  25. OWNERS
  26. PREUPLOAD.cfg
  27. README.md
  28. TEST_MAPPING
README.md

libnativehelper

libnativehelper is a collection of JNI related utilities used in Android.

There are several header and binary libraries here and not all of the functionality fits together well. The header libraries are mostly C++ based. The binary libraries are entirely written in C with no C++ dependencies. This is by design as the code here can be distributed in multiple ways, including mainline modules, so keeping the size down benefits everyone with smaller downloads and a stable ABI.

Header Libraries

jni_headers

This is a header library that contains provides the API represented in the JNI Specification 1.6. Any project in Android that depends on jni.h should depend on this.

See:

libnativehelper_header_only

These headers provide utilities that defined entirely within the headers. There are scoped resource classes that make common JNI patterns of acquiring and releasing resources safer to use than the JNI specification equivalents. Examples being ScopedLocalRef to manage the lifetime of local references and ScopedUtfChars to manage the lifetime of Java strings in native code and provide access to utf8 characters.

See:

jni_platform_headers

The jni_macros.h header provide compile time checking of JNI methods implemented in C++. They ensure the C++ method declaration match the Java signature they are associated with.

See:

Libraries

libnativehelper

A shared library distributed in the ART module that provides helper routines built on Java APIs. This library depends on details that are private to libcore and use should be restricted to platform code and within the ART module.

This library also contains the JNI invocation API from the JNI Specification and the glue that connects the ART runtime to the API implementation. The glue logic is platform only as it is used with the Zygote and the standalone dalvikvm.

See:

libnativehelper_compat_libc++

This shared and static library contains a subset of the helper routines in libnativehelper based on public Java API. This code can be statically linked as the Java APIs it depends on are considered stable. The name of this library is a misnomer since it contains no C++ code.

See: