zeroc-ice 3.6b1

data/slice/Glacier2/RouterF.ice

@@ -0,0 +1,20 @@
+// **********************************************************************
+//
+// Copyright (c) 2003-2014 ZeroC, Inc. All rights reserved.
+//
+// This copy of Ice is licensed to you under the terms described in the
+// ICE_LICENSE file included in this distribution.
+//
+// **********************************************************************
+
+#pragma once
+
+[["cpp:header-ext:h"]]
+
+module Glacier2
+{
+
+interface Router;
+
+};
+

data/slice/Glacier2/SSLInfo.ice

@@ -0,0 +1,50 @@
+// **********************************************************************
+//
+// Copyright (c) 2003-2014 ZeroC, Inc. All rights reserved.
+//
+// This copy of Ice is licensed to you under the terms described in the
+// ICE_LICENSE file included in this distribution.
+//
+// **********************************************************************
+
+#pragma once
+
+[["cpp:header-ext:h"]]
+[["cpp:include:Glacier2/Config.h"]]
+
+#include <Ice/BuiltinSequences.ice>
+
+module Glacier2
+{
+
+/**
+ *
+ * Information taken from an SSL connection used for permissions
+ * verification.
+ *
+ * @see PermissionsVerifier
+ *
+ */
+struct SSLInfo
+{
+    /** The remote host. */
+    string remoteHost;
+
+    /** The remote port. */
+    int remotePort;
+
+    /** The router's host. */
+    string localHost;
+
+    /** The router's port. */
+    int localPort;
+
+    /** The negotiated cipher suite. */
+    string cipher;
+
+    /** The certificate chain. */
+    Ice::StringSeq certs;
+};
+
+};
+

data/slice/Glacier2/Session.ice

@@ -0,0 +1,273 @@
+// **********************************************************************
+//
+// Copyright (c) 2003-2014 ZeroC, Inc. All rights reserved.
+//
+// This copy of Ice is licensed to you under the terms described in the
+// ICE_LICENSE file included in this distribution.
+//
+// **********************************************************************
+
+#pragma once
+
+[["cpp:header-ext:h"]]
+[["cpp:include:Glacier2/Config.h"]]
+
+#include <Ice/BuiltinSequences.ice>
+#include <Ice/Identity.ice>
+#include <Glacier2/SSLInfo.ice>
+
+module Glacier2
+{
+
+/**
+ *
+ * This exception is raised if an attempt to create a new session
+ * failed.
+ *
+ * @see Router#createSession
+ * @see Router#createSessionFromSecureConnection
+ * @see SessionManager#create
+ * @see SSLSessionManager#create
+ *
+ **/
+["preserve-slice"]
+exception CannotCreateSessionException
+{
+    /**
+     *
+     * The reason why session creation has failed.
+     *
+     **/
+    string reason;
+};
+
+/**
+ *
+ * A client-visible session object, which is tied to the lifecycle of
+ * a {@link Router}.
+ *
+ * @see Router
+ * @see SessionManager
+ *
+ **/
+interface Session
+{
+    /**
+     *
+     * Destroy the session. This is called automatically when the
+     * {@link Router} is destroyed.
+     *
+     **/
+    void destroy();
+};
+
+/**
+ *
+ * An object for managing the set of identity constraints for specific
+ * parts of object identity on a
+ * {@link Session}. 
+ *
+ * @see Session
+ * @see SessionControl
+ *
+ **/
+interface StringSet
+{
+    /**
+     *
+     * Add a sequence of strings to this set of constraints. Order is
+     * not preserved and duplicates are implicitly removed.
+     *
+     * @param additions The sequence of strings to be added.
+     *
+     **/
+    idempotent void add(Ice::StringSeq additions);
+
+    /**
+     *
+     * Remove a sequence of strings from this set of constraints. No
+     * errors are returned if an entry is not found.
+     *
+     * @param deletions The sequence of strings to be removed.
+     *
+     **/
+    idempotent void remove(Ice::StringSeq deletions);
+
+    /**
+     *
+     * Returns a sequence of strings describing the constraints in this
+     * set.
+     *
+     * @return The sequence of strings for this set. 
+     *
+     **/
+    idempotent Ice::StringSeq get();
+};
+
+/**
+ *
+ * An object for managing the set of object identity constraints on a
+ * {@link Session}. 
+ *
+ * @see Session
+ * @see SessionControl
+ *
+ **/
+interface IdentitySet
+{
+    /**
+     *
+     * Add a sequence of Ice identities to this set of constraints. Order is
+     * not preserved and duplicates are implicitly removed.
+     *
+     * @param additions The sequence of Ice identities to be added.
+     *
+     **/
+    idempotent void add(Ice::IdentitySeq additions);
+
+    /**
+     *
+     * Remove a sequence of identities from this set of constraints. No
+     * errors are returned if an entry is not found.
+     *
+     * @param deletions The sequence of Ice identities to be removed.
+     *
+     **/
+    idempotent void remove(Ice::IdentitySeq deletions);
+
+    /**
+     *
+     * Returns a sequence of identities describing the constraints in this
+     * set.
+     *
+     * @return The sequence of Ice identities for this set. 
+     *
+     **/
+    idempotent Ice::IdentitySeq get();
+};
+
+/**
+ *
+ * An administrative session control object, which is tied to the
+ * lifecycle of a {@link Session}.
+ *
+ * @see Session
+ *
+ **/
+interface SessionControl
+{
+    /**
+     *
+     * Access the object that manages the allowable categories
+     * for object identities for this session. 
+     *
+     * @return A StringSet object.
+     *
+     **/
+    StringSet* categories();
+
+    /**
+     *
+     * Access the object that manages the allowable adapter identities
+     * for objects for this session. 
+     *
+     * @return A StringSet object.
+     *
+     **/
+    StringSet* adapterIds();
+
+    /**
+     *
+     * Access the object that manages the allowable object identities
+     * for this session. 
+     *
+     * @return An IdentitySet object.
+     *
+     **/
+    IdentitySet* identities();
+
+    /**
+     *
+     * Get the session timeout.
+     *
+     * @return The timeout.
+     *
+     **/
+    idempotent int getSessionTimeout();
+    
+    /**
+     *
+     * Destroy the associated session.
+     *
+     **/
+    void destroy();
+};
+
+/**
+ *
+ * The session manager for username/password authenticated users that
+ * is responsible for managing {@link Session} objects. New session objects
+ * are created by the {@link Router} object calling on an application-provided
+ * session manager. If no session manager is provided by the application,
+ * no client-visible sessions are passed to the client.
+ *
+ * @see Router
+ * @see Session
+ *
+ **/
+interface SessionManager
+{
+    /**
+     *
+     * Create a new session.
+     *
+     * @param userId The user id for the session.
+     *
+     * @param control A proxy to the session control object.
+     *
+     * @return A proxy to the newly created session.
+     *
+     * @throws CannotCreateSessionException Raised if the session
+     * cannot be created.
+     *
+     **/
+    ["format:sliced"]
+    Session* create(string userId, SessionControl* control)
+        throws CannotCreateSessionException;
+};
+
+/**
+ *
+ * The session manager for SSL authenticated users that is
+ * responsible for managing {@link Session} objects. New session objects are
+ * created by the {@link Router} object calling on an application-provided
+ * session manager. If no session manager is provided by the
+ * application, no client-visible sessions are passed to the client.
+ *
+ * @see Router
+ * @see Session
+ *
+ **/
+interface SSLSessionManager
+{
+    /**
+     *
+     * Create a new session.
+     *
+     * @param info The SSL info.
+     *
+     * @param control A proxy to the session control object.
+     *
+     * @return A proxy to the newly created session.
+     *
+     * @throws CannotCreateSessionException Raised if the session
+     * cannot be created.
+     *
+     **/
+    ["format:sliced"] 
+    Session* create(SSLInfo info, SessionControl* control)
+        throws CannotCreateSessionException;
+};
+
+};
+

data/slice/Ice/BuiltinSequences.ice

@@ -0,0 +1,48 @@
+// **********************************************************************
+//
+// Copyright (c) 2003-2014 ZeroC, Inc. All rights reserved.
+//
+// This copy of Ice is licensed to you under the terms described in the
+// ICE_LICENSE file included in this distribution.
+//
+// **********************************************************************
+
+#pragma once
+
+[["cpp:header-ext:h"]]
+
+module Ice
+{
+
+/** A sequence of bools. **/
+sequence<bool> BoolSeq;
+
+/** A sequence of bytes. **/
+sequence<byte> ByteSeq;
+
+/** A sequence of shorts. **/
+sequence<short> ShortSeq;
+
+/** A sequence of ints. **/
+sequence<int> IntSeq;
+
+/** A sequence of longs. **/
+sequence<long> LongSeq;
+
+/** A sequence of floats. **/
+sequence<float> FloatSeq;
+
+/** A sequence of doubles. **/
+sequence<double> DoubleSeq;
+
+/** A sequence of strings. **/
+sequence<string> StringSeq;
+
+/** A sequence of objects. **/
+sequence<Object> ObjectSeq;
+    
+/** A sequence of object proxies. **/
+sequence<Object*> ObjectProxySeq;
+
+};
+

data/slice/Ice/Communicator.ice

@@ -0,0 +1,567 @@
+// **********************************************************************
+//
+// Copyright (c) 2003-2014 ZeroC, Inc. All rights reserved.
+//
+// This copy of Ice is licensed to you under the terms described in the
+// ICE_LICENSE file included in this distribution.
+//
+// **********************************************************************
+
+#pragma once
+
+[["cpp:header-ext:h"]]
+
+#include <Ice/LoggerF.ice>
+#include <Ice/InstrumentationF.ice>
+#include <Ice/ObjectAdapterF.ice>
+#include <Ice/ObjectFactoryF.ice>
+#include <Ice/RouterF.ice>
+#include <Ice/LocatorF.ice>
+#include <Ice/PluginF.ice>
+#include <Ice/ImplicitContextF.ice>
+#include <Ice/Current.ice>
+#include <Ice/Properties.ice>
+#include <Ice/FacetMap.ice>
+
+/**
+ *
+ * The Ice core library. Among many other features, the Ice core
+ * library manages all the communication tasks using an efficient
+ * protocol (including protocol compression and support for both TCP
+ * and UDP), provides a thread pool for multi-threaded servers, and
+ * additional functionality that supports high scalability.
+ *
+ **/
+module Ice
+{
+
+/**
+ *
+ * The central object in Ice. One or more communicators can be
+ * instantiated for an Ice application. Communicator instantiation
+ * is language-specific, and not specified in Slice code.
+ *
+ * @see Logger
+ * @see ObjectAdapter
+ * @see Properties
+ * @see ObjectFactory
+ *
+ **/
+["clr:implements:_System.IDisposable"]
+local interface Communicator
+{
+    /**
+     *
+     * Destroy the communicator. This operation calls {@link #shutdown}
+     * implicitly.  Calling {@link #destroy} cleans up memory, and shuts down
+     * this communicator's client functionality and destroys all object
+     * adapters. Subsequent calls to {@link #destroy} are ignored.
+     *
+     * @see #shutdown
+     * @see ObjectAdapter#destroy
+     *
+     **/
+    void destroy();
+
+    /**
+     *
+     * Shuts down this communicator's server functionality, which
+     * includes the deactivation of all object adapters. (Attempts to use
+     * a deactivated object adapter raise {@link ObjectAdapterDeactivatedException}.)
+     * Subsequent calls to {@link #shutdown} are ignored.</p>
+     *
+     * <p class="Note"> After {@link #shutdown} returns, no new requests are
+     * processed. However, requests that have been started before
+     * {@link #shutdown} was called might still be active. You can use
+     * {@link #waitForShutdown} to wait for the completion of all
+     * requests.
+     *
+     * @see #destroy
+     * @see #waitForShutdown
+     * @see ObjectAdapter#deactivate
+     *
+     **/
+    void shutdown();
+
+    /**
+     *
+     * Wait until the application has called {@link #shutdown} (or {@link #destroy}).
+     * On the server side, this operation blocks the calling thread
+     * until all currently-executing operations have completed.
+     * On the client side, the operation simply block until another
+     * thread has called {@link #shutdown} or {@link #destroy}.
+     *
+     * <p>A typical use of this operation is to call it
+     * from the main thread, which then waits until some other thread
+     * calls {@link #shutdown}. After shut-down is complete, the main thread
+     * returns and can do some cleanup work before it finally calls
+     * {@link #destroy} to shut down the client functionality, and then
+     * exits the application.
+     *
+     * @see #shutdown
+     * @see #destroy
+     * @see ObjectAdapter#waitForDeactivate
+     *
+     **/
+    void waitForShutdown();
+
+    /**
+     *
+     * Check whether communicator has been shut down.
+     *
+     * @return True if the communicator has been shut down; false otherwise.
+     *
+     * @see #shutdown
+     *
+     **/
+    ["cpp:const"] bool isShutdown();
+
+    /**
+     *
+     * Convert a stringified proxy into a proxy. For example,
+     * <tt>MyCategory/MyObject:tcp -h some_host -p
+     * 10000</tt> creates a proxy that refers to the Ice object
+     * having an identity with a name "MyObject" and a category
+     * "MyCategory", with the server running on host "some_host", port
+     * 10000. If the stringified proxy does not parse correctly, the
+     * operation throws one of {@link ProxyParseException},
+     * {@link EndpointParseException}, or {@link IdentityParseException}.
+     * An appendix in the Ice manual provides a detailed description
+     * of the syntax supported by stringified proxies.
+     *
+     * @param str The stringified proxy to convert into a proxy.
+     *
+     * @return The proxy, or nil if <tt>str</tt> is an empty string.
+     *
+     * @see #proxyToString
+     *
+     **/
+    ["cpp:const"] Object* stringToProxy(string str);
+
+    /**
+     *
+     * Convert a proxy into a string.
+     *
+     * @param obj The proxy to convert into a stringified proxy.
+     *
+     * @return The stringified proxy, or an empty string if
+     * <tt>obj</tt> is nil.
+     *
+     * @see #stringToProxy
+     *
+     **/
+    ["cpp:const"] string proxyToString(Object* obj);
+
+
+    /**
+     * 
+     * Convert a set of proxy properties into a proxy. The "base"
+     * name supplied in the <tt>property</tt> argument refers to a
+     * property containing a stringified proxy, such as
+     * <tt>MyProxy=id:tcp -h localhost -p 10000</tt>. Additional
+     * properties configure local settings for the proxy, such as
+     * <tt>MyProxy.PreferSecure=1</tt>. The "Properties"
+     * appendix in the Ice manual describes each of the supported
+     * proxy properties.
+     *
+     * @param property The base property name.
+     *
+     * @return The proxy.
+     *
+     **/
+    ["cpp:const"] Object* propertyToProxy(string property);
+
+    /**
+     * 
+     * Convert a proxy to a set of proxy properties.
+     *
+     * @param proxy The proxy.
+     *
+     * @param property The base property name.
+     * 
+     * @return The property set.
+     *
+     **/
+    ["cpp:const"] PropertyDict proxyToProperty(Object* proxy, string property);
+
+    /**
+     *
+     * Convert a string into an identity. If the string does not parse
+     * correctly, the operation throws {@link IdentityParseException}.
+     *
+     * @param str The string to convert into an identity.
+     *
+     * @return The identity.
+     *
+     * @see #identityToString
+     *
+     **/
+    ["cpp:const"] Identity stringToIdentity(string str);
+
+    /**
+     *
+     * Convert an identity into a string.
+     *
+     * @param ident The identity to convert into a string.
+     *
+     * @return The "stringified" identity.
+     *
+     * @see #stringToIdentity
+     *
+     **/
+    ["cpp:const"] string identityToString(Identity ident);
+
+    /**
+     *
+     * Create a new object adapter. The endpoints for the object
+     * adapter are taken from the property <tt><em>name</em>.Endpoints</tt>.</p>
+     *
+     * <p>It is legal to create an object adapter with the empty string as
+     * its name. Such an object adapter is accessible via bidirectional
+     * connections or by collocated invocations that originate from the
+     * same communicator as is used by the adapter.</p>
+     *
+     * <p>Attempts to create a named object adapter for which no configuration
+     * can be found raise {@link InitializationException}.
+     *
+     * @param name The object adapter name.
+     *
+     * @return The new object adapter.
+     *
+     * @see #createObjectAdapterWithEndpoints
+     * @see ObjectAdapter
+     * @see Properties
+     *
+     **/
+    ObjectAdapter createObjectAdapter(string name);
+
+    /**
+     *
+     * Create a new object adapter with endpoints. This operation sets
+     * the property <tt><em>name</em>.Endpoints</tt>,
+     * and then calls {@link createObjectAdapter}. It is provided as a
+     * convenience function.</p>
+     *
+     * <p>Calling this operation with an empty name will result in a
+     * UUID being generated for the name.
+     * 
+     * @param name The object adapter name.
+     *
+     * @param endpoints The endpoints for the object adapter.
+     *
+     * @return The new object adapter.
+     *
+     * @see #createObjectAdapter
+     * @see ObjectAdapter
+     * @see Properties
+     *
+     **/
+    ObjectAdapter createObjectAdapterWithEndpoints(string name, string endpoints);
+
+    /**
+     *
+     * Create a new object adapter with a router. This operation
+     * creates a routed object adapter.</p>
+     * 
+     * <p>Calling this operation with an empty name will result in a
+     * UUID being generated for the name.
+     *
+     * @param name The object adapter name.
+     *
+     * @param rtr The router.
+     *
+     * @return The new object adapter.
+     *
+     * @see #createObjectAdapter
+     * @see ObjectAdapter
+     * @see Properties
+     *
+     **/
+    ObjectAdapter createObjectAdapterWithRouter(string name, Router* rtr);
+
+    /**
+     *
+     * <p>Add an object factory to this communicator. Installing a 
+     * factory with an id for which a factory is already registered 
+     * throws {@link AlreadyRegisteredException}.</p>
+     *
+     * <p>When unmarshaling an Ice object, the Ice run time reads the
+     * most-derived type id off the wire and attempts to create an
+     * instance of the type using a factory. If no instance is created,
+     * either because no factory was found, or because all factories
+     * returned nil, the behavior of the Ice run time depends on the
+     * format with which the object was marshaled:</p>
+     *
+     * <p>If the object uses the "sliced" format, Ice ascends the class
+     * hierarchy until it finds a type that is recognized by a factory,
+     * or it reaches the least-derived type. If no factory is found that
+     * can create an instance, the run time throws
+     * {@link NoObjectFactoryException}.</p>
+     *
+     * <p>If the object uses the "compact" format, Ice immediately raises
+     * {@link NoObjectFactoryException}.</p>
+     *
+     * <p>The following order is used to locate a factory for a type:</p>
+     *
+     * <ol>
+     *
+     * <li>The Ice run-time looks for a factory registered
+     * specifically for the type.</li>
+     *
+     * <li>If no instance has been created, the Ice run-time looks
+     * for the default factory, which is registered with an empty type id.
+     * </li>
+     *
+     * <li>If no instance has been created by any of the preceding
+     * steps, the Ice run-time looks for a factory that may have been
+     * statically generated by the language mapping for non-abstract classes.
+     * </li>
+     *
+     * </ol>
+     *
+     * @param factory The factory to add.
+     *
+     * @param id The type id for which the factory can create instances, or
+     * an empty string for the default factory.
+     *
+     * @see #findObjectFactory
+     * @see ObjectFactory
+     *
+     **/
+    void addObjectFactory(ObjectFactory factory, string id);
+
+    /**
+     *
+     * Find an object factory registered with this communicator.
+     *
+     * @param id The type id for which the factory can create instances,
+     * or an empty string for the default factory.
+     *
+     * @return The object factory, or null if no object factory was
+     * found for the given id.
+     *
+     * @see #addObjectFactory
+     * @see ObjectFactory
+     *
+     **/
+    ["cpp:const"] ObjectFactory findObjectFactory(string id);
+
+
+    /**
+     * Get the implicit context associated with this communicator.
+     *
+     * @return The implicit context associated with this communicator;
+     * returns null when the property Ice.ImplicitContext is not set
+     * or is set to None.
+     *
+     **/
+    ["cpp:const"] ImplicitContext getImplicitContext();
+
+    /**
+     *
+     * Get the properties for this communicator.
+     *
+     * @return This communicator's properties.
+     *
+     * @see Properties
+     *
+     **/
+    ["cpp:const"] Properties getProperties();
+
+    /**
+     *
+     * Get the logger for this communicator.
+     *
+     * @return This communicator's logger.
+     *
+     * @see Logger
+     *
+     **/
+    ["cpp:const"] Logger getLogger();
+
+    /**
+     *
+     * Get the observer resolver object for this communicator.
+     *
+     * @return This communicator's observer resolver object.
+     *
+     **/
+    ["cpp:const"] Ice::Instrumentation::CommunicatorObserver getObserver();
+
+    /**
+     *
+     * Get the default router this communicator.
+     *
+     * @return The default router for this communicator.
+     *
+     * @see #setDefaultRouter
+     * @see Router
+     *
+     **/
+    ["cpp:const"] Router* getDefaultRouter();
+
+    /**
+     *
+     * Set a default router for this communicator. All newly
+     * created proxies will use this default router. To disable the
+     * default router, null can be used. Note that this
+     * operation has no effect on existing proxies.</p>
+     *
+     * <p class="Note">You can also set a router for an individual proxy
+     * by calling the operation <tt>ice_router</tt> on the proxy.
+     *
+     * @param rtr The default router to use for this communicator.
+     *
+     * @see #getDefaultRouter
+     * @see #createObjectAdapterWithRouter
+     * @see Router
+     *
+     **/
+    void setDefaultRouter(Router* rtr);
+
+    /**
+     *
+     * Get the default locator this communicator.
+     *
+     * @return The default locator for this communicator.
+     *
+     * @see #setDefaultLocator
+     * @see Locator
+     *
+     **/
+    ["cpp:const"] Locator* getDefaultLocator();
+
+    /**
+     *
+     * Set a default Ice locator for this communicator. All newly
+     * created proxy and object adapters will use this default
+     * locator. To disable the default locator, null can be used.
+     * Note that this operation has no effect on existing proxies or
+     * object adapters.</p>
+     *
+     * <p class="Note"> You can also set a locator for an individual proxy
+     * by calling the operation <tt>ice_locator</tt> on the proxy, or for an
+     * object adapter by calling the operation {@link setLocator} on the
+     * object adapter.
+     *
+     * @param loc The default locator to use for this communicator.
+     *
+     * @see #getDefaultLocator
+     * @see Locator
+     * @see ObjectAdapter#setLocator
+     *
+     **/
+    void setDefaultLocator(Locator* loc);
+
+    /**
+     *
+     * Get the plug-in manager for this communicator.
+     *
+     * @return This communicator's plug-in manager.
+     *
+     * @see PluginManager
+     *
+     **/
+    ["cpp:const"] PluginManager getPluginManager();
+
+    /**
+     *
+     * Flush any pending batch requests for this communicator.
+     * This causes all batch requests that were sent via proxies
+     * obtained via this communicator to be sent to the server.
+     *
+     **/
+    ["async"] void flushBatchRequests();
+
+
+    /**
+     *
+     * Add the Admin object with all its facets to the provided object adapter.
+     * If Ice.Admin.ServerId is set and the provided object adapter has a {@link Locator},
+     * createAdmin registers the Admin's Process facet with the {@link Locator}'s {@link LocatorRegistry}.
+     *
+     * <p>createAdmin call only be called once; subsequent calls raise {@link InitializationException}.</p>
+     *
+     * @param adminAdapter The object adapter used to host the Admin object; if null and
+     * Ice.Admin.Endpoints is set, create, activate and use the Ice.Admin object adapter.
+     *
+     * @param adminId The identity of the Admin object.
+     *
+     * @return A proxy to the main ("") facet of the Admin object. Never returns a null proxy.
+     *
+     * @see #getAdmin
+     * @see LocatorRegistry#setServerProcessProxy
+     *
+     **/
+    Object* createAdmin(ObjectAdapter adminAdapter, Identity adminId);
+
+    /**
+     *
+     * Get a proxy to the main facet of the Admin object.
+     *
+     * getAdmin also creates the Admin object and creates and activates the Ice.Admin object 
+     * adapter to host this Admin object if Ice.Admin.Enpoints is set. The identity of the Admin 
+     * object created by getAdmin is <value of Ice.Admin.InstanceName>/admin, or <UUID>/admin 
+     * when Ice.Admin.InstanceName is not set.
+     *
+     * <p>If Ice.Admin.DelayCreation is 0 or not set, getAdmin is called by the communicator
+     * initialization, after initialization of all plugins.</p>
+
+     * @return A proxy to the main ("") facet of the Admin object, or a null proxy if no 
+     * Admin object is configured.
+     *
+     * @see #createAdmin
+     **/
+    ["cpp:const"] Object* getAdmin();
+
+    /**
+     *
+     * Add a new facet to the Admin object.
+     * Adding a servant with a facet that is already registered 
+     * throws {@link AlreadyRegisteredException}.
+     *
+     * @param servant The servant that implements the new Admin facet.
+     * @param facet The name of the new Admin facet.
+     *
+     **/
+    void addAdminFacet(Object servant, string facet);
+
+    /**
+     *
+     * Remove the following facet to the Admin object.
+     * Removing a facet that was not previously registered throws 
+     * {@link NotRegisteredException}.
+     *
+     * @param facet The name of the Admin facet.
+     * @return The servant associated with this Admin facet.
+     *
+     **/
+    Object removeAdminFacet(string facet);
+
+    /**
+     *
+     * Returns a facet of the Admin object.
+     *
+     * @param facet The name of the Admin facet.
+     * @return The servant associated with this Admin facet, or
+     * null if no facet is registered with the given name.
+     *
+     **/
+    Object findAdminFacet(string facet);
+   
+    /**
+     *
+     * Returns a map of all facets of the Admin object.
+     *
+     * @return A collection containing all the facet names and
+     * servants of the Admin object.
+     *
+     * @see #findAdminFacet
+     *
+     **/
+    FacetMap findAllAdminFacets();
+
+};
+
+};
+