Context.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_CONTEXT_H_
#define SUPPORT_CONTEXT_H_

#include <support/String.h>
#include <support/Value.h>
#include <support/Vector.h>

#if _SUPPORTS_NAMESPACE
namespace palmos {
namespace support {
#endif

class INode;
class IProcess;

class SContext
{
public:
// SContext must exist, but only by name in bootstrap code
#if !LIBBE_BOOTSTRAP
    SContext();
    SContext(const sptr<INode>& node);
    SContext(const SContext& context);
    ~SContext();
    
    SContext& operator=(const SContext& o);
    
    bool operator==(const SContext& o) const;
    bool operator!=(const SContext& o) const;
    bool operator<(const SContext& o) const;
    bool operator<=(const SContext& o) const;
    bool operator>=(const SContext& o) const;
    bool operator>(const SContext& o) const;

    status_t InitCheck() const;

    enum new_flags_enum {
        PROCESS_MASK    = 0x000f,
        

        PREFER_LOCAL    = 0x0000,

        PREFER_REMOTE   = 0x0001,

        REQUIRE_LOCAL   = 0x0002,

        REQUIRE_REMOTE  = 0x0003
    };
    

    sptr<IBinder> New(  const SValue& component,
                        const SValue& args = B_UNDEFINED_VALUE,
                        uint32_t flags = PREFER_LOCAL,
                        status_t* outError = NULL) const;


    sptr<IBinder> RemoteNew(    const SValue& component,
                                const sptr<IProcess>& process,
                                const SValue& args = B_UNDEFINED_VALUE,
                                uint32_t flags = PREFER_LOCAL,
                                status_t* outError = NULL) const;
    

    sptr<IProcess> NewProcess(  const SString& name,
                                uint32_t flags = PREFER_REMOTE,
                                const SValue& env = B_UNDEFINED_VALUE,
                                status_t* outError = NULL) const;
    
    sptr<IBinder> NewCustomProcess( const SString& executable,
                                    const SVector<SString>& args = SVector<SString>(),
                                    uint32_t flags = 0,
                                    const SValue& env = B_UNDEFINED_VALUE,
                                    status_t* outError = NULL) const;
    
    SValue Lookup(const SString& location) const;
    sptr<IBinder> LookupService(const SString& name) const;
    template<class INTERFACE> sptr<INTERFACE> LookupServiceAs(const SString& name) const;
    
    status_t Publish(const SString& location, const SValue& val) const;
    status_t PublishService(const SString& name, const sptr<IBinder>& object) const;
    status_t Unpublish(const SString& location) const;
    
    sptr<INode> Root() const;

    status_t LookupComponent(const SString& id, SValue* out_info) const;
    SValue LookupComponentProperty(const SString& component, const SString& property) const;

    status_t RunScript(const SString &filename) const;


    static SContext UserContext();
    

    static SContext SystemContext();


    static SContext GetContext(const SString& name);
    

    static SContext GetContext(const SString& name, const sptr<IProcess>& caller);

private:
    mutable sptr<INode> m_root;

#endif
};

#if !LIBBE_BOOTSTRAP
template<class INTERFACE>
sptr<INTERFACE> SContext::LookupServiceAs(const SString& name) const
{
    return interface_cast<INTERFACE>(LookupService(name));
}   
#endif // !LIBBE_BOOTSTRAP

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

#endif // SUPPORT_CONTEXT_H_

---

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

PalmSource, Inc. © 2005