1 /* 2 * Copyright (C) 2005 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef ANDROID_BPBINDER_H 18 #define ANDROID_BPBINDER_H 19 20 #include <binder/IBinder.h> 21 #include <utils/KeyedVector.h> 22 #include <utils/threads.h> 23 24 // --------------------------------------------------------------------------- 25 namespace android { 26 27 class BpBinder : public IBinder 28 { 29 public: 30 BpBinder(int32_t handle); 31 handle()32 inline int32_t handle() const { return mHandle; } 33 34 virtual const String16& getInterfaceDescriptor() const; 35 virtual bool isBinderAlive() const; 36 virtual status_t pingBinder(); 37 virtual status_t dump(int fd, const Vector<String16>& args); 38 39 virtual status_t transact( uint32_t code, 40 const Parcel& data, 41 Parcel* reply, 42 uint32_t flags = 0); 43 44 virtual status_t linkToDeath(const sp<DeathRecipient>& recipient, 45 void* cookie = NULL, 46 uint32_t flags = 0); 47 virtual status_t unlinkToDeath( const wp<DeathRecipient>& recipient, 48 void* cookie = NULL, 49 uint32_t flags = 0, 50 wp<DeathRecipient>* outRecipient = NULL); 51 52 virtual void attachObject( const void* objectID, 53 void* object, 54 void* cleanupCookie, 55 object_cleanup_func func); 56 virtual void* findObject(const void* objectID) const; 57 virtual void detachObject(const void* objectID); 58 59 virtual BpBinder* remoteBinder(); 60 61 status_t setConstantData(const void* data, size_t size); 62 void sendObituary(); 63 64 class ObjectManager 65 { 66 public: 67 ObjectManager(); 68 ~ObjectManager(); 69 70 void attach( const void* objectID, 71 void* object, 72 void* cleanupCookie, 73 IBinder::object_cleanup_func func); 74 void* find(const void* objectID) const; 75 void detach(const void* objectID); 76 77 void kill(); 78 79 private: 80 ObjectManager(const ObjectManager&); 81 ObjectManager& operator=(const ObjectManager&); 82 83 struct entry_t 84 { 85 void* object; 86 void* cleanupCookie; 87 IBinder::object_cleanup_func func; 88 }; 89 90 KeyedVector<const void*, entry_t> mObjects; 91 }; 92 93 protected: 94 virtual ~BpBinder(); 95 virtual void onFirstRef(); 96 virtual void onLastStrongRef(const void* id); 97 virtual bool onIncStrongAttempted(uint32_t flags, const void* id); 98 99 private: 100 const int32_t mHandle; 101 102 struct Obituary { 103 wp<DeathRecipient> recipient; 104 void* cookie; 105 uint32_t flags; 106 }; 107 108 void reportOneDeath(const Obituary& obit); 109 bool isDescriptorCached() const; 110 111 mutable Mutex mLock; 112 volatile int32_t mAlive; 113 volatile int32_t mObitsSent; 114 Vector<Obituary>* mObituaries; 115 ObjectManager mObjects; 116 Parcel* mConstantData; 117 mutable String16 mDescriptorCache; 118 }; 119 120 }; // namespace android 121 122 // --------------------------------------------------------------------------- 123 124 #endif // ANDROID_BPBINDER_H 125