IInformant.h

Go to the documentation of this file.

/*========================================================== */ 
// header file automatically generated by PIDGEN - DO NOT MODIFY
/*========================================================== */ 

#ifndef SERVICES_IINFORMANT_H
#define SERVICES_IINFORMANT_H

#include <support/IInterface.h>
#include <support/Binder.h>
#include <support/Context.h>
#include <support/String.h>

/*
 * 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
 */
#include <support/IProcess.h>
#include <support/INode.h>

/* ============= Interface Class Declarations =========================== */

#if _SUPPORTS_NAMESPACE
namespace palmos {
namespace services {
using namespace palmos::support;
#endif /* _SUPPORTS_NAMESPACE */


class IInformant : public IInterface
{
public:
    B_DECLARE_META_INTERFACE(Informant)
    
    
    /* ------- Methods ------------------------ */
    
    

    virtual status_t                RegisterForCallback(const SValue& key, const sptr<IBinder>& target, const SValue& method, uint32_t flags = 0, const SValue& cookie = B_UNDEFINED_VALUE) = 0;
    

    // flags are the IBinder link flags (weak is for the team)
    virtual status_t                RegisterForCreation(const SValue& key, const sptr<INode>& context, const sptr<IProcess>& process, const SString& component, const SValue& inspect, const SValue& method, uint32_t flags = 0, const SValue& cookie = B_UNDEFINED_VALUE) = 0;
    

    virtual status_t                UnregisterForCallback(const SValue& key, const sptr<IBinder>& target, const SValue& method, uint32_t flags = 0) = 0;
    

    virtual status_t                UnregisterForCreation(const SValue& key, const sptr<INode>& context, const sptr<IProcess>& process, const SString& component, const SValue& inspect, const SValue& method, uint32_t flags = 0) = 0;
    

    virtual status_t                Inform(const SValue& key, const SValue& information) = 0;
    
    /* ------- inline helpers ------------------------- */
    status_t LinkInformant(const sptr<IBinder>& to, const SValue& mappings, uint32_t flags = 0)
    {
        return AsBinder()->Link(to, mappings, flags);
    }
    status_t UnlinkInformant(const sptr<IBinder>& to, const SValue& mappings, uint32_t flags = 0)
    {
        return AsBinder()->Unlink(to, mappings, flags);
    }

protected:
                                    IInformant() { }
    virtual                         ~IInformant();

private:
    /* ------- copy/assignment protection ------------------ */
                                    IInformant(const IInformant& o);
            IInformant&             operator=(const IInformant& o);
};


class IInformed : public IInterface
{
public:
    B_DECLARE_META_INTERFACE(Informed)
    
    
    /* ------- Methods ------------------------ */
    
    

    virtual void                    OnInform(const SValue& information, const SValue& cookie, const SValue& key) = 0;
    
    /* ------- inline helpers ------------------------- */
    status_t LinkInformed(const sptr<IBinder>& to, const SValue& mappings, uint32_t flags = 0)
    {
        return AsBinder()->Link(to, mappings, flags);
    }
    status_t UnlinkInformed(const sptr<IBinder>& to, const SValue& mappings, uint32_t flags = 0)
    {
        return AsBinder()->Unlink(to, mappings, flags);
    }

protected:
                                    IInformed() { }
    virtual                         ~IInformed();

private:
    /* ------- copy/assignment protection ------------------ */
                                    IInformed(const IInformed& o);
            IInformed&              operator=(const IInformed& o);
};


/* ============= Local Class Declarations =============================== */

class BnInformant : public IInformant, public BBinder
{
public:
    virtual SValue                  Inspect(const sptr<IBinder>& caller, const SValue& which, uint32_t flags = 0);
    virtual sptr<IInterface>        InterfaceFor(const SValue& descriptor, uint32_t flags = 0);

protected:
                                    BnInformant();
                                    BnInformant(const SContext& context);
    virtual                         ~BnInformant();
    
    virtual sptr<IBinder>           AsBinderImpl();
    virtual sptr<const IBinder>     AsBinderImpl() const;
    
    /* ------- Marshalling Details ------------ */
    virtual status_t                HandleEffect(const SValue &, const SValue &, const SValue &, SValue *);
    virtual status_t                Transact(uint32_t code, SParcel& data, SParcel* reply, uint32_t flags);

private:
                                    BnInformant(const BnInformant& o);
            BnInformant&            operator=(const BnInformant& o);
};


class BnInformed : public IInformed, public BBinder
{
public:
    virtual SValue                  Inspect(const sptr<IBinder>& caller, const SValue& which, uint32_t flags = 0);
    virtual sptr<IInterface>        InterfaceFor(const SValue& descriptor, uint32_t flags = 0);

protected:
                                    BnInformed();
                                    BnInformed(const SContext& context);
    virtual                         ~BnInformed();
    
    virtual sptr<IBinder>           AsBinderImpl();
    virtual sptr<const IBinder>     AsBinderImpl() const;
    
    /* ------- Marshalling Details ------------ */
    virtual status_t                HandleEffect(const SValue &, const SValue &, const SValue &, SValue *);
    virtual status_t                Transact(uint32_t code, SParcel& data, SParcel* reply, uint32_t flags);

private:
                                    BnInformed(const BnInformed& o);
            BnInformed&             operator=(const BnInformed& o);
};


#if _SUPPORTS_NAMESPACE
} } // namespace palmos::services
#endif /* _SUPPORTS_NAMESPACE */


// namespace palmos::services

#endif // SERVICES_IINFORMANT_H

---

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

PalmSource, Inc. © 2005