1 files changed, 114 insertions, 0 deletions
diff --git a/sca-java-1.x/tags/1.0.1/modules/domain/src/main/java/org/apache/tuscany/sca/domain/DomainManagerNodeEventService.java b/sca-java-1.x/tags/1.0.1/modules/domain/src/main/java/org/apache/tuscany/sca/domain/DomainManagerNodeEventService.java
new file mode 100644
index 0000000000..148b0dfc2f
--- /dev/null
+++ b/sca-java-1.x/tags/1.0.1/modules/domain/src/main/java/org/apache/tuscany/sca/domain/DomainManagerNodeEventService.java
@@ -0,0 +1,114 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ * 
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.    
+ */
+
+package org.apache.tuscany.sca.domain;
+
+import java.util.List;
+
+import org.osoa.sca.annotations.Remotable;
+
+
+/**
+ * The management interface for distributed domain. This is resposible for 
+ * creating appropriate configuration on all the nodes that are running 
+ * domain nodes for the distributed domain. 
+ * 
+ * @version $Rev: 552343 $ $Date: 2007-09-07 12:41:52 +0100 (Fri, 07 Sep 2007) $
+ */
+@Remotable
+public interface DomainManagerNodeEventService {
+
+    /**
+     * A node registers with the distributed domain manager. The mechanism whereby this
+     * registration interface is discovered is not defined. For example, JMS, JINI
+     * or a hard coded configuration could all be candidates in the java world. 
+     * 
+     * @param domainUri the string uri for the distributed domain
+     * @param nodeUri the string uri for the current node
+     * @param nodeManagementUrl the endpoint for the nodes management service
+     */
+    public String registerNode(String nodeURI, String nodeURL);
+    
+    /**
+     * A node registers with the distributed domain manager. The mechanism whereby this
+     * registration interface is discovered is not defined. For example, JMS, JINI
+     * or a hard coded configuration could all be candidates in the java world. 
+     * 
+     * @param domainUri the string uri for the distributed domain
+     * @param nodeUri the string uri for the current node
+     * @param nodeManagementUrl the endpoint for the nodes management service
+     */
+    public String removeNode(String nodeURI);  
+    
+
+    /**
+     * In the case where a contribution is added at a node this method is used to 
+     * record the relationship directly. This is different from adding a contribution
+     * to a domain as the contribution has alread been allocated to a node
+     * 
+     * @param nodeURI the string uri for the node
+     * @param contributionURI the string uri for the contribution
+     * @param nodeURL the location of the contribution
+     * @return
+     */
+    public void registerContribution(String nodeURI, String contributionURI, String contributionURL);
+    
+
+    /** 
+     * In the case where a contribution is removed from a node locally this method is
+     * used to remove the contribution from the domain
+     * 
+     * @param contributionURI the string uri for the contribution
+     * @return
+     */
+    public void unregisterContribution(String contributionURI);     
+     
+    /**
+     * Accepts information about a service endpoint and holds onto it
+     * 
+     * @param domainUri the string uri for the distributed domain
+     * @param nodeUri the string uri for the current node
+     * @param serviceName the name of the service that is exposed and the provided endpoint
+     * @param bindingName the remote binding that is providing the endpoint
+     * @param url the enpoint url
+     * @return TBD - information about the registration
+     */
+    public String registerServiceEndpoint(String domainUri, String nodeUri, String serviceName, String bindingName, String URL);
+    
+    /**
+     * Removes information about a service endpoint
+     * 
+     * @param domainUri the string uri for the distributed domain
+     * @param nodeUri the string uri for the current node
+     * @param serviceName the name of the service that is exposed and the provided endpoint
+     * @param bindingName the remote binding that is providing the endpoint
+     */    
+    public String removeServiceEndpoint(String domainUri, String nodeUri, String serviceName, String bindingName);
+        
+    /**
+     * Locates information about a service endpoint 
+     * 
+     * @param domainUri the string uri for the distributed domain
+     * @param serviceName the name of the service that is exposed and the provided endpoint
+     * @param bindingName the remote binding that we want to find an endpoint for
+     * @return url the endpoint url
+     */
+    public String findServiceEndpoint(String domainUri, String serviceName, String bindingName); 
+     
+}