Home | History | Annotate | Download | only in binder
      1 /*
      2  * Copyright (C) 2008 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_BINDER_H
     18 #define ANDROID_BINDER_H
     19 
     20 #include <binder/IBinder.h>
     21 
     22 // ---------------------------------------------------------------------------
     23 namespace android {
     24 
     25 class BBinder : public IBinder
     26 {
     27 public:
     28                         BBinder();
     29 
     30     virtual const String16& getInterfaceDescriptor() const;
     31     virtual bool        isBinderAlive() const;
     32     virtual status_t    pingBinder();
     33     virtual status_t    dump(int fd, const Vector<String16>& args);
     34 
     35     virtual status_t    transact(   uint32_t code,
     36                                     const Parcel& data,
     37                                     Parcel* reply,
     38                                     uint32_t flags = 0);
     39 
     40     virtual status_t    linkToDeath(const sp<DeathRecipient>& recipient,
     41                                     void* cookie = NULL,
     42                                     uint32_t flags = 0);
     43 
     44     virtual status_t    unlinkToDeath(  const wp<DeathRecipient>& recipient,
     45                                         void* cookie = NULL,
     46                                         uint32_t flags = 0,
     47                                         wp<DeathRecipient>* outRecipient = NULL);
     48 
     49     virtual void        attachObject(   const void* objectID,
     50                                         void* object,
     51                                         void* cleanupCookie,
     52                                         object_cleanup_func func);
     53     virtual void*       findObject(const void* objectID) const;
     54     virtual void        detachObject(const void* objectID);
     55 
     56     virtual BBinder*    localBinder();
     57 
     58 protected:
     59     virtual             ~BBinder();
     60 
     61     virtual status_t    onTransact( uint32_t code,
     62                                     const Parcel& data,
     63                                     Parcel* reply,
     64                                     uint32_t flags = 0);
     65 
     66 private:
     67                         BBinder(const BBinder& o);
     68             BBinder&    operator=(const BBinder& o);
     69 
     70     class Extras;
     71 
     72             Extras*     mExtras;
     73             void*       mReserved0;
     74 };
     75 
     76 // ---------------------------------------------------------------------------
     77 
     78 class BpRefBase : public virtual RefBase
     79 {
     80 protected:
     81                             BpRefBase(const sp<IBinder>& o);
     82     virtual                 ~BpRefBase();
     83     virtual void            onFirstRef();
     84     virtual void            onLastStrongRef(const void* id);
     85     virtual bool            onIncStrongAttempted(uint32_t flags, const void* id);
     86 
     87     inline  IBinder*        remote()                { return mRemote; }
     88     inline  IBinder*        remote() const          { return mRemote; }
     89 
     90 private:
     91                             BpRefBase(const BpRefBase& o);
     92     BpRefBase&              operator=(const BpRefBase& o);
     93 
     94     IBinder* const          mRemote;
     95     RefBase::weakref_type*  mRefs;
     96     volatile int32_t        mState;
     97 };
     98 
     99 }; // namespace android
    100 
    101 // ---------------------------------------------------------------------------
    102 
    103 #endif // ANDROID_BINDER_H
    104