1 files changed, 85 insertions, 0 deletions
diff --git a/sca-java-1.x/tags/java-stable-20060304/sca/core/src/main/java/org/apache/tuscany/core/context/AggregateContext.java b/sca-java-1.x/tags/java-stable-20060304/sca/core/src/main/java/org/apache/tuscany/core/context/AggregateContext.java
new file mode 100644
index 0000000000..0fab87358f
--- /dev/null
+++ b/sca-java-1.x/tags/java-stable-20060304/sca/core/src/main/java/org/apache/tuscany/core/context/AggregateContext.java
@@ -0,0 +1,85 @@
+package org.apache.tuscany.core.context;
+
+import java.util.List;
+
+import org.apache.tuscany.core.config.ConfigurationException;
+import org.apache.tuscany.model.assembly.Aggregate;
+import org.apache.tuscany.model.assembly.Extensible;
+import org.apache.tuscany.model.assembly.AggregatePart;
+
+/**
+ * A context which contains child component contexts.
+ * 
+ * @version $Rev$ $Date$
+ */
+public interface AggregateContext extends InstanceContext {
+
+    /**
+     * Propagates an event to registered listeners. All lifecycle events will be propagated to children in the order
+     * that they were registered. Listeners are expected to be well-behaved and if an exception is thrown the
+     * notification process will be aborted.
+     * 
+     * @param pEventType the type of event. Basic types are defined in {@link EventContext}
+     * @param pMessage the message associated with the event or null
+     * @throws EventException if an error occurs while sending the event
+     */
+    public void fireEvent(int pEventType, Object pMessage) throws EventException;
+
+    /**
+     * Registers a listener to receive notifications for the context
+     * 
+     * @throws ContextRuntimeException if an error occurs during registration
+     */
+    public void registerListener(RuntimeEventListener listener) throws ContextRuntimeException;
+
+    /**
+     * Adds runtime artifacts represented by the set of model objects to the aggregate context by merging them with
+     * existing artifacts. Implementing classes may support only a subset of {@link AggregatePart} types.
+     * 
+     * @see org.apache.tuscany.model.assembly.Component
+     * @see org.apache.tuscany.model.assembly.ModuleComponent
+     * @see org.apache.tuscany.model.assembly.SimpleComponent
+     * @see org.apache.tuscany.model.assembly.EntryPoint
+     * @see org.apache.tuscany.model.assembly.ExternalService
+     */
+    public void registerModelObjects(List<Extensible> models) throws ConfigurationException;
+
+    /**
+     * Adds a runtime artifact represented by the model object to the aggregate context by merging it with existing
+     * artifacts. Implementing classes may support only a subset of {@link AggregatePart} types.
+     * 
+     * @see org.apache.tuscany.model.assembly.Component
+     * @see org.apache.tuscany.model.assembly.ModuleComponent
+     * @see org.apache.tuscany.model.assembly.SimpleComponent
+     * @see org.apache.tuscany.model.assembly.EntryPoint
+     * @see org.apache.tuscany.model.assembly.ExternalService
+     */
+    public void registerModelObject(Extensible model) throws ConfigurationException;
+
+    /**
+     * Returns the child context associated with a given name
+     */
+    public InstanceContext getContext(String name);
+
+    /**
+     * Returns the parent context, or null if the context does not have one
+     */
+    public AggregateContext getParent();
+
+    /**
+     * Intended for internal use by the runtime, returns an implementation instance for the given context name, which
+     * may be a compound component/service form. Unlike {@link InstanceContext#getInstance(QualifiedName)}, which for aggregate contexts only returns
+     * entry point proxies, this method will return any type of contained implementation instance.
+     * 
+     * @throws TargetException if there was an error returning the instance
+     */
+    public Object locateInstance(String name) throws TargetException;
+
+    /**
+     * Returns the aggregate managed by this aggregate context 
+     * @return
+     */
+    @Deprecated
+    public Aggregate getAggregate();
+    
+}