IBinder.h

Go to the documentation of this file.

/*
 * Copyright (c) 2005 Palmsource, Inc.
 * 
 * This software is licensed as described in the file LICENSE, which
 * you should have received as part of this distribution. The terms
 * are also available at http://www.openbinder.org/license.html.
 * 
 * This software consists of voluntary contributions made by many
 * individuals. For the exact contribution history, see the revision
 * history and logs, available at http://www.openbinder.org
 */

#ifndef _SUPPORT_BINDER_INTERFACE_H_
#define _SUPPORT_BINDER_INTERFACE_H_

#include <support/Atom.h>

#if _SUPPORTS_NAMESPACE
namespace palmos { 
namespace osp { 
#endif
    class BpBinder; 
#if _SUPPORTS_NAMESPACE
} } // namespace palmos::osp
#endif

#if _SUPPORTS_NAMESPACE
namespace palmos {
namespace support {
#endif

struct BAutobinderDef;
class IInterface;
class BBinder;
class SParcel;
class SValue;

/*-------------------------------------------------------------*/
/*------- IBinder Interface -----------------------------------*/

enum {
    B_EFFECT_TRANSACTION    = 'efct',       
    B_INSPECT_TRANSACTION   = 'insp',       
    B_LINK_TRANSACTION      = 'link',       
    B_UNLINK_TRANSACTION    = 'unlk',       
    B_PING_TRANSACTION      = 'ping',       

    B_PUT_TRANSACTION       = '_put',       
    B_GET_TRANSACTION       = '_get',       
    B_INVOKE_TRANSACTION    = 'invk'        
};


enum {

    B_WEAK_BINDER_LINK      = 0x00000001,


    B_SYNC_BINDER_LINK      = 0x00000002,


    B_NO_TRANSLATE_LINK     = 0x00000004,


    B_UNLINK_ALL_TARGETS    = 0x00000008
};

class IBinder : virtual public SAtom
{
public:


            virtual SValue              Inspect(const sptr<IBinder>& caller,
                                                const SValue &which,
                                                uint32_t flags = 0) = 0;
            

    virtual sptr<IInterface>        InterfaceFor(   const SValue &descriptor,
                                                        uint32_t flags = 0) = 0;
            

    virtual status_t                    Link(   const sptr<IBinder>& target,
                                                const SValue &bindings,
                                                uint32_t flags = 0) = 0;
    virtual status_t                    Unlink( const wptr<IBinder>& target,
                                                const SValue &bindings,
                                                uint32_t flags = 0) = 0;
    

    virtual status_t                    Effect( const SValue &in,
                                                const SValue &inBindings,
                                                const SValue &outBindings,
                                                SValue *out) = 0;

        virtual status_t                AutobinderPut(  const BAutobinderDef* def,
                                                        const void* value) = 0;
        virtual status_t                AutobinderGet(  const BAutobinderDef* def,
                                                        void* result) = 0;
        virtual status_t                AutobinderInvoke(   const BAutobinderDef* def,
                                                            void** params,
                                                            void* result) = 0;

            status_t                    Put(const SValue &in);
            SValue                      Get(const SValue &bindings) const;
            SValue                      Get() const;
            SValue                      Invoke(const SValue &func, const SValue &args);
            SValue                      Invoke(const SValue &func);
    

    virtual status_t                    Transact(   uint32_t code,
                                                    SParcel& data,
                                                    SParcel* reply = NULL,
                                                    uint32_t flags = 0) = 0;
    

    virtual status_t                    LinkToDeath(    const sptr<BBinder>& target,
                                                        const SValue &method,
                                                        uint32_t flags = 0) = 0;


    virtual status_t                    UnlinkToDeath(  const wptr<BBinder>& target,
                                                        const SValue &method,
                                                        uint32_t flags = 0) = 0;

    virtual bool                        IsBinderAlive() const = 0;
    

    virtual status_t                    PingBinder() = 0;
    

    virtual BBinder*                    LocalBinder();

    virtual BNS(palmos::osp::) BpBinder*    RemoteBinder();

protected:
    inline                              IBinder() { }
    inline virtual                      ~IBinder() { }

private:
                                        IBinder(const IBinder& o);
};

/*-------------------------------------------------------------*/

#if _SUPPORTS_NAMESPACE
} } // namespace palmos::support
#endif

#endif  // _SUPPORT_BINDER_INTERFACE_H_

---

Generated on Wed Dec 28 22:33:27 2005 by Doxygen 1.4.4 for OpenBinder Documentation Version 1.0

PalmSource, Inc. © 2005