ICommand.h

Go to the documentation of this file.

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

#ifndef APP_ICOMMAND_H
#define APP_ICOMMAND_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/IByteStream.h>

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

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

class ICommand : public IInterface
{
public:
    B_DECLARE_META_INTERFACE(Command)
    
    
    /* ------- Typedefs --------------------- */
    typedef SVector<SValue> ArgList;
    
    /* ------- Properties --------------------- */
    
    virtual sptr<IByteInput>        ByteInput() const = 0;
    virtual void                    SetByteInput(const sptr<IByteInput>& value) = 0;
    
    virtual sptr<IByteOutput>       ByteOutput() const = 0;
    virtual void                    SetByteOutput(const sptr<IByteOutput>& value) = 0;
    
    virtual sptr<IByteOutput>       ByteError() const = 0;
    virtual void                    SetByteError(const sptr<IByteOutput>& value) = 0;
    
    virtual SValue                  Environment() const = 0;
    virtual void                    SetEnvironment(const SValue& value) = 0;
    
    virtual SString                 Documentation() const = 0;
    
    /* ------- Methods ------------------------ */
    
    virtual SValue                  Run(const ArgList& args) = 0;
    
    virtual sptr<ICommand>          Spawn(const SString& command) const = 0;
    
    virtual void                    SetProperty(const SValue& key, const SValue& value) = 0;
    
    virtual SValue                  GetProperty(const SValue& key) const = 0;
    
    virtual void                    RemoveProperty(const SValue& key) = 0;
    
    virtual void                    SetFileDescriptors(const SValue& fds) = 0;
    
    virtual void                    AddCommand(const SString& name, const sptr<ICommand>& command) = 0;
    
    virtual sptr<ICommand>          GetCommand(const SString& name) const = 0;
    
    virtual void                    RemoveCommand(const SString& name) = 0;
    
    /* ------- inline helpers ------------------------- */
    status_t LinkCommand(const sptr<IBinder>& to, const SValue& mappings, uint32_t flags = 0)
    {
        return AsBinder()->Link(to, mappings, flags);
    }
    status_t UnlinkCommand(const sptr<IBinder>& to, const SValue& mappings, uint32_t flags = 0)
    {
        return AsBinder()->Unlink(to, mappings, flags);
    }

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

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


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

class BnCommand : public ICommand, 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);
    
    /* ------- Push Properties ---------------- */
public:
            void                    PushByteInput(const sptr<IByteInput>& value);
            void                    PushByteOutput(const sptr<IByteOutput>& value);
            void                    PushByteError(const sptr<IByteOutput>& value);
            void                    PushEnvironment(const SValue& value);
            void                    PushDocumentation(const SString& value);

protected:
                                    BnCommand();
                                    BnCommand(const SContext& context);
    virtual                         ~BnCommand();
    
    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:
                                    BnCommand(const BnCommand& o);
            BnCommand&              operator=(const BnCommand& o);
};


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


// namespace palmos::app

#endif // APP_ICOMMAND_H

---

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

PalmSource, Inc. © 2005