Merge changes from topic "ndk-binder-convert-java" (48ac1c65) · Commits · e / os / platform_frameworks_native

libs/binder/ndk/Android.bp

+2 −0

Original line number	Diff line number	Diff line
		@@ -25,6 +25,7 @@ cc_library {

		srcs: [
		"ibinder.cpp",
		"ibinder_jni.cpp",
		"parcel.cpp",
		"process.cpp",
		"status.cpp",
		@@ -32,6 +33,7 @@ cc_library {
		],

		shared_libs: [
		"libandroid_runtime",
		"libbase",
		"libbinder",
		"libutils",

libs/binder/ndk/ibinder_jni.cpp

0 → 100644

+42 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2018 The Android Open Source Project
		*
		* Licensed 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.
		*/

		#include <android/binder_ibinder_jni.h>
		#include "ibinder_internal.h"

		#include <android_util_Binder.h>

		using ::android::IBinder;
		using ::android::ibinderForJavaObject;
		using ::android::javaObjectForIBinder;
		using ::android::sp;

		AIBinder* AIBinder_fromJavaBinder(JNIEnv* env, jobject binder) {
		sp<IBinder> ibinder = ibinderForJavaObject(env, binder);

		sp<AIBinder> cbinder = ABpBinder::lookupOrCreateFromBinder(ibinder);
		AIBinder_incStrong(cbinder.get());

		return cbinder.get();
		}

		jobject AIBinder_toJavaBinder(JNIEnv* env, AIBinder* binder) {
		if (binder == nullptr) {
		return nullptr;
		}

		return javaObjectForIBinder(env, binder->getBinder());
		}

libs/binder/ndk/include_ndk/android/binder_ibinder.h

+27 −21

Original line number	Diff line number	Diff line
		@@ -33,6 +33,7 @@
		#include <android/binder_status.h>

		__BEGIN_DECLS
		#if __ANDROID_API__ >= __ANDROID_API_Q__

		// Also see TF_* in kernel's binder.h
		typedef uint32_t binder_flags_t;
		@@ -154,7 +155,8 @@ typedef binder_status_t (AIBinder_Class_onTransact)(AIBinder binder, transacti
		*/
		__attribute__((warn_unused_result)) AIBinder_Class* AIBinder_Class_define(
		const char* interfaceDescriptor, AIBinder_Class_onCreate onCreate,
		AIBinder_Class_onDestroy onDestroy, AIBinder_Class_onTransact onTransact);
		AIBinder_Class_onDestroy onDestroy, AIBinder_Class_onTransact onTransact)
		__INTRODUCED_IN(29);

		/**
		* Creates a new binder object of the appropriate class.
		@@ -173,12 +175,13 @@ __attribute__((warn_unused_result)) AIBinder_Class* AIBinder_Class_define(
		* these two objects are actually equal using the AIBinder pointer alone (which they should be able
		* to do). Also see the suggested memory ownership model suggested above.
		*/
		__attribute__((warn_unused_result)) AIBinder* AIBinder_new(const AIBinder_Class* clazz, void* args);
		__attribute__((warn_unused_result)) AIBinder* AIBinder_new(const AIBinder_Class* clazz, void* args)
		__INTRODUCED_IN(29);

		/**
		* If this is hosted in a process other than the current one.
		*/
		bool AIBinder_isRemote(const AIBinder* binder);
		bool AIBinder_isRemote(const AIBinder* binder) __INTRODUCED_IN(29);

		/**
		* If this binder is known to be alive. This will not send a transaction to a remote process and
		@@ -187,14 +190,14 @@ bool AIBinder_isRemote(const AIBinder* binder);
		* updated as the result of a transaction made using AIBinder_transact, but it will also be updated
		* based on the results of bookkeeping or other transactions made internally.
		*/
		bool AIBinder_isAlive(const AIBinder* binder);
		bool AIBinder_isAlive(const AIBinder* binder) __INTRODUCED_IN(29);

		/**
		* Built-in transaction for all binder objects. This sends a transaction which will immediately
		* return. Usually this is used to make sure that a binder is alive, as a placeholder call, or as a
		* sanity check.
		*/
		binder_status_t AIBinder_ping(AIBinder* binder);
		binder_status_t AIBinder_ping(AIBinder* binder) __INTRODUCED_IN(29);

		/**
		* Registers for notifications that the associated binder is dead. The same death recipient may be
		@@ -206,7 +209,7 @@ binder_status_t AIBinder_ping(AIBinder* binder);
		* identification and holding user data.
		*/
		binder_status_t AIBinder_linkToDeath(AIBinder* binder, AIBinder_DeathRecipient* recipient,
		void* cookie);
		void* cookie) __INTRODUCED_IN(29);

		/**
		* Stops registration for the associated binder dying. Does not delete the recipient. This function
		@@ -214,22 +217,22 @@ binder_status_t AIBinder_linkToDeath(AIBinder* binder, AIBinder_DeathRecipient*
		* returns STATUS_NAME_NOT_FOUND.
		*/
		binder_status_t AIBinder_unlinkToDeath(AIBinder* binder, AIBinder_DeathRecipient* recipient,
		void* cookie);
		void* cookie) __INTRODUCED_IN(29);

		/**
		* This can only be called if a strong reference to this object already exists in process.
		*/
		void AIBinder_incStrong(AIBinder* binder);
		void AIBinder_incStrong(AIBinder* binder) __INTRODUCED_IN(29);

		/**
		* This will delete the object and call onDestroy once the refcount reaches zero.
		*/
		void AIBinder_decStrong(AIBinder* binder);
		void AIBinder_decStrong(AIBinder* binder) __INTRODUCED_IN(29);

		/**
		* For debugging only!
		*/
		int32_t AIBinder_debugGetRefCount(AIBinder* binder);
		int32_t AIBinder_debugGetRefCount(AIBinder* binder) __INTRODUCED_IN(29);

		/**
		* This sets the class of an AIBinder object. This checks to make sure the remote object is of
		@@ -240,18 +243,18 @@ int32_t AIBinder_debugGetRefCount(AIBinder* binder);
		* This returns true if the class association succeeds. If it fails, no change is made to the
		* binder object.
		*/
		bool AIBinder_associateClass(AIBinder* binder, const AIBinder_Class* clazz);
		bool AIBinder_associateClass(AIBinder* binder, const AIBinder_Class* clazz) __INTRODUCED_IN(29);

		/**
		* Returns the class that this binder was constructed with or associated with.
		*/
		const AIBinder_Class* AIBinder_getClass(AIBinder* binder);
		const AIBinder_Class* AIBinder_getClass(AIBinder* binder) __INTRODUCED_IN(29);

		/**
		* Value returned by onCreate for a local binder. For stateless classes (if onCreate returns
		* nullptr), this also returns nullptr. For a remote binder, this will always return nullptr.
		*/
		void* AIBinder_getUserData(AIBinder* binder);
		void* AIBinder_getUserData(AIBinder* binder) __INTRODUCED_IN(29);

		/**
		* A transaction is a series of calls to these functions which looks this
		@@ -274,7 +277,7 @@ void* AIBinder_getUserData(AIBinder* binder);
		* AIBinder_transact. Alternatively, if there is an error while filling out the parcel, it can be
		* deleted with AParcel_delete.
		*/
		binder_status_t AIBinder_prepareTransaction(AIBinder* binder, AParcel** in);
		binder_status_t AIBinder_prepareTransaction(AIBinder* binder, AParcel** in) __INTRODUCED_IN(29);

		/**
		* Transact using a parcel created from AIBinder_prepareTransaction. This actually communicates with
		@@ -289,42 +292,45 @@ binder_status_t AIBinder_prepareTransaction(AIBinder* binder, AParcel** in);
		* and must be released with AParcel_delete when finished reading.
		*/
		binder_status_t AIBinder_transact(AIBinder* binder, transaction_code_t code, AParcel** in,
		AParcel** out, binder_flags_t flags);
		AParcel** out, binder_flags_t flags) __INTRODUCED_IN(29);

		/**
		* This does not take any ownership of the input binder, but it can be used to retrieve it if
		* something else in some process still holds a reference to it.
		*/
		__attribute__((warn_unused_result)) AIBinder_Weak* AIBinder_Weak_new(AIBinder* binder);
		__attribute__((warn_unused_result)) AIBinder_Weak* AIBinder_Weak_new(AIBinder* binder)
		__INTRODUCED_IN(29);

		/**
		* Deletes the weak reference. This will have no impact on the lifetime of the binder.
		*/
		void AIBinder_Weak_delete(AIBinder_Weak* weakBinder);
		void AIBinder_Weak_delete(AIBinder_Weak* weakBinder) __INTRODUCED_IN(29);

		/**
		* If promotion succeeds, result will have one strong refcount added to it. Otherwise, this returns
		* nullptr.
		*/
		__attribute__((warn_unused_result)) AIBinder* AIBinder_Weak_promote(AIBinder_Weak* weakBinder);
		__attribute__((warn_unused_result)) AIBinder* AIBinder_Weak_promote(AIBinder_Weak* weakBinder)
		__INTRODUCED_IN(29);

		/**
		* This function is executed on death receipt. See AIBinder_linkToDeath/AIBinder_unlinkToDeath.
		*/
		typedef void (AIBinder_DeathRecipient_onBinderDied)(void cookie);
		typedef void (AIBinder_DeathRecipient_onBinderDied)(void cookie) __INTRODUCED_IN(29);

		/**
		* Creates a new binder death recipient. This can be attached to multiple different binder objects.
		*/
		__attribute__((warn_unused_result)) AIBinder_DeathRecipient* AIBinder_DeathRecipient_new(
		AIBinder_DeathRecipient_onBinderDied onBinderDied);
		AIBinder_DeathRecipient_onBinderDied onBinderDied) __INTRODUCED_IN(29);

		/**
		* Deletes a binder death recipient. It is not necessary to call AIBinder_unlinkToDeath before
		* calling this as these will all be automatically unlinked.
		*/
		void AIBinder_DeathRecipient_delete(AIBinder_DeathRecipient* recipient);
		void AIBinder_DeathRecipient_delete(AIBinder_DeathRecipient* recipient) __INTRODUCED_IN(29);

		#endif //__ANDROID_API__ >= __ANDROID_API_Q__
		__END_DECLS

		/** @} */

libs/binder/ndk/include_ndk/android/binder_ibinder_jni.h

0 → 100644

+58 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2018 The Android Open Source Project
		*
		* Licensed 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.
		*/

		/**
		* @addtogroup NdkBinder
		* @{
		*/

		/**
		* @file binder_ibinder_jni.h
		* @brief Conversions between AIBinder and android.os.IBinder
		*/

		#pragma once

		#include <android/binder_ibinder.h>

		#include <jni.h>

		__BEGIN_DECLS
		#if __ANDROID_API__ >= __ANDROID_API_Q__

		/**
		* Converts an android.os.IBinder object into an AIBinder* object.
		*
		* If either env or the binder is null, null is returned. If this binder object was originally an
		* AIBinder object, the original object is returned. The returned object has one refcount
		* associated with it, and so this should be accompanied with an AIBinder_decStrong call.
		*/
		__attribute__((warn_unused_result)) AIBinder* AIBinder_fromJavaBinder(JNIEnv* env, jobject binder)
		__INTRODUCED_IN(29);

		/**
		* Converts an AIBinder* object into an android.os.IBinder object.
		*
		* If either env or the binder is null, null is returned. If this binder object was originally an
		* IBinder object, the original java object will be returned.
		*/
		__attribute__((warn_unused_result)) jobject AIBinder_toJavaBinder(JNIEnv* env, AIBinder* binder)
		__INTRODUCED_IN(29);

		#endif //__ANDROID_API__ >= __ANDROID_API_Q__
		__END_DECLS

		/** @} */

libs/binder/ndk/include_ndk/android/binder_parcel.h

+30 −24

Original line number	Diff line number	Diff line
		@@ -34,6 +34,7 @@ struct AIBinder;
		typedef struct AIBinder AIBinder;

		__BEGIN_DECLS
		#if __ANDROID_API__ >= __ANDROID_API_Q__

		/**
		* This object represents a package of data that can be sent between processes. When transacting, an
		@@ -47,24 +48,26 @@ typedef struct AParcel AParcel;
		/**
		* Cleans up a parcel.
		*/
		void AParcel_delete(AParcel* parcel);
		void AParcel_delete(AParcel* parcel) __INTRODUCED_IN(29);

		/**
		* Writes an AIBinder to the next location in a non-null parcel. Can be null.
		*/
		binder_status_t AParcel_writeStrongBinder(AParcel* parcel, AIBinder* binder);
		binder_status_t AParcel_writeStrongBinder(AParcel* parcel, AIBinder* binder) __INTRODUCED_IN(29);

		/**
		* Reads an AIBinder from the next location in a non-null parcel. This will fail if the binder is
		* non-null. One strong ref-count of ownership is passed to the caller of this function.
		*/
		binder_status_t AParcel_readStrongBinder(const AParcel* parcel, AIBinder** binder);
		binder_status_t AParcel_readStrongBinder(const AParcel* parcel, AIBinder** binder)
		__INTRODUCED_IN(29);

		/**
		* Reads an AIBinder from the next location in a non-null parcel. This may read a null. One strong
		* ref-count of ownership is passed to the caller of this function.
		*/
		binder_status_t AParcel_readNullableStrongBinder(const AParcel* parcel, AIBinder** binder);
		binder_status_t AParcel_readNullableStrongBinder(const AParcel* parcel, AIBinder** binder)
		__INTRODUCED_IN(29);

		/**
		* Writes an AStatus object to the next location in a non-null parcel.
		@@ -75,107 +78,110 @@ binder_status_t AParcel_readNullableStrongBinder(const AParcel* parcel, AIBinder
		* this happens or if writing the status object itself fails, the return value from this function
		* should be propagated to the client, and AParcel_readStatusHeader shouldn't be called.
		*/
		binder_status_t AParcel_writeStatusHeader(AParcel* parcel, const AStatus* status);
		binder_status_t AParcel_writeStatusHeader(AParcel* parcel, const AStatus* status)
		__INTRODUCED_IN(29);

		/**
		* Reads an AStatus from the next location in a non-null parcel. Ownership is passed to the caller
		* of this function.
		*/
		binder_status_t AParcel_readStatusHeader(const AParcel* parcel, AStatus** status);
		binder_status_t AParcel_readStatusHeader(const AParcel* parcel, AStatus** status)
		__INTRODUCED_IN(29);

		// @START
		/**
		* Writes int32_t value to the next location in a non-null parcel.
		*/
		binder_status_t AParcel_writeInt32(AParcel* parcel, int32_t value);
		binder_status_t AParcel_writeInt32(AParcel* parcel, int32_t value) __INTRODUCED_IN(29);

		/**
		* Writes uint32_t value to the next location in a non-null parcel.
		*/
		binder_status_t AParcel_writeUint32(AParcel* parcel, uint32_t value);
		binder_status_t AParcel_writeUint32(AParcel* parcel, uint32_t value) __INTRODUCED_IN(29);

		/**
		* Writes int64_t value to the next location in a non-null parcel.
		*/
		binder_status_t AParcel_writeInt64(AParcel* parcel, int64_t value);
		binder_status_t AParcel_writeInt64(AParcel* parcel, int64_t value) __INTRODUCED_IN(29);

		/**
		* Writes uint64_t value to the next location in a non-null parcel.
		*/
		binder_status_t AParcel_writeUint64(AParcel* parcel, uint64_t value);
		binder_status_t AParcel_writeUint64(AParcel* parcel, uint64_t value) __INTRODUCED_IN(29);

		/**
		* Writes float value to the next location in a non-null parcel.
		*/
		binder_status_t AParcel_writeFloat(AParcel* parcel, float value);
		binder_status_t AParcel_writeFloat(AParcel* parcel, float value) __INTRODUCED_IN(29);

		/**
		* Writes double value to the next location in a non-null parcel.
		*/
		binder_status_t AParcel_writeDouble(AParcel* parcel, double value);
		binder_status_t AParcel_writeDouble(AParcel* parcel, double value) __INTRODUCED_IN(29);

		/**
		* Writes bool value to the next location in a non-null parcel.
		*/
		binder_status_t AParcel_writeBool(AParcel* parcel, bool value);
		binder_status_t AParcel_writeBool(AParcel* parcel, bool value) __INTRODUCED_IN(29);

		/**
		* Writes char16_t value to the next location in a non-null parcel.
		*/
		binder_status_t AParcel_writeChar(AParcel* parcel, char16_t value);
		binder_status_t AParcel_writeChar(AParcel* parcel, char16_t value) __INTRODUCED_IN(29);

		/**
		* Writes int8_t value to the next location in a non-null parcel.
		*/
		binder_status_t AParcel_writeByte(AParcel* parcel, int8_t value);
		binder_status_t AParcel_writeByte(AParcel* parcel, int8_t value) __INTRODUCED_IN(29);

		/**
		* Reads into int32_t value from the next location in a non-null parcel.
		*/
		binder_status_t AParcel_readInt32(const AParcel* parcel, int32_t* value);
		binder_status_t AParcel_readInt32(const AParcel* parcel, int32_t* value) __INTRODUCED_IN(29);

		/**
		* Reads into uint32_t value from the next location in a non-null parcel.
		*/
		binder_status_t AParcel_readUint32(const AParcel* parcel, uint32_t* value);
		binder_status_t AParcel_readUint32(const AParcel* parcel, uint32_t* value) __INTRODUCED_IN(29);

		/**
		* Reads into int64_t value from the next location in a non-null parcel.
		*/
		binder_status_t AParcel_readInt64(const AParcel* parcel, int64_t* value);
		binder_status_t AParcel_readInt64(const AParcel* parcel, int64_t* value) __INTRODUCED_IN(29);

		/**
		* Reads into uint64_t value from the next location in a non-null parcel.
		*/
		binder_status_t AParcel_readUint64(const AParcel* parcel, uint64_t* value);
		binder_status_t AParcel_readUint64(const AParcel* parcel, uint64_t* value) __INTRODUCED_IN(29);

		/**
		* Reads into float value from the next location in a non-null parcel.
		*/
		binder_status_t AParcel_readFloat(const AParcel* parcel, float* value);
		binder_status_t AParcel_readFloat(const AParcel* parcel, float* value) __INTRODUCED_IN(29);

		/**
		* Reads into double value from the next location in a non-null parcel.
		*/
		binder_status_t AParcel_readDouble(const AParcel* parcel, double* value);
		binder_status_t AParcel_readDouble(const AParcel* parcel, double* value) __INTRODUCED_IN(29);

		/**
		* Reads into bool value from the next location in a non-null parcel.
		*/
		binder_status_t AParcel_readBool(const AParcel* parcel, bool* value);
		binder_status_t AParcel_readBool(const AParcel* parcel, bool* value) __INTRODUCED_IN(29);

		/**
		* Reads into char16_t value from the next location in a non-null parcel.
		*/
		binder_status_t AParcel_readChar(const AParcel* parcel, char16_t* value);
		binder_status_t AParcel_readChar(const AParcel* parcel, char16_t* value) __INTRODUCED_IN(29);

		/**
		* Reads into int8_t value from the next location in a non-null parcel.
		*/
		binder_status_t AParcel_readByte(const AParcel* parcel, int8_t* value);
		binder_status_t AParcel_readByte(const AParcel* parcel, int8_t* value) __INTRODUCED_IN(29);

		// @END

		#endif //__ANDROID_API__ >= __ANDROID_API_Q__
		__END_DECLS

		/** @} */