Move Tuscany from Incubator to top level.

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@668359 13f79535-47bb-0310-9956-ffa450edef68

4 files changed, 288 insertions, 0 deletions

diff --git a/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/NodeException.java b/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/NodeException.java
new file mode 100644
index 0000000000..336aa19ad8
--- /dev/null
+++ b/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/NodeException.java
@@ -0,0 +1,38 @@
+/*

+ * 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.node;

+

+

+/**

+ * Denotes an error starting the runtime

+ *

+ * @version $Rev: 568826 $ $Date: 2007-08-23 06:27:34 +0100 (Thu, 23 Aug 2007) $

+ */

+public class NodeException extends Exception {

+

+    static final long serialVersionUID = 2096658015909178325L;

+    

+    public NodeException(String message) {

+        super(message);

+    }

+

+    public NodeException(Throwable cause) {

+        super(cause);

+    }

+}

diff --git a/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/SCADomainFinder.java b/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/SCADomainFinder.java
new file mode 100644
index 0000000000..882c61dfcc
--- /dev/null
+++ b/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/SCADomainFinder.java
@@ -0,0 +1,78 @@
+/*

+ * 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.node;

+

+import java.lang.reflect.Constructor;

+

+import org.apache.tuscany.sca.domain.DomainException;

+import org.apache.tuscany.sca.domain.SCADomain;

+import org.osoa.sca.ServiceRuntimeException;

+

+/**

+ * A finder for SCA domains.

+ * 

+ * @version $Rev: 580520 $ $Date: 2007-09-29 00:50:25 +0100 (Sat, 29 Sep 2007) $

+ */

+public abstract class SCADomainFinder {

+    

+        

+    /**

+     * Returns a new SCA domain finder instance.

+     *  

+     * @return a new SCA domain finder

+     */

+    public static SCADomainFinder newInstance() {

+        SCADomainFinder scaDomainFinder = null;

+

+        try {

+            final ClassLoader classLoader = SCADomainFinder.class.getClassLoader();

+            String className =  "org.apache.tuscany.sca.node.impl.SCADomainFinderImpl";  

+                            

+            Class cls = Class.forName(className, true, classLoader);

+            

+            Constructor<?> constructor = null;

+            

+            try {

+                constructor = cls.getConstructor();

+            } catch (NoSuchMethodException e) {

+                // ignore

+            }

+            

+            if (constructor != null) {

+                scaDomainFinder = (SCADomainFinder)constructor.newInstance();

+            } 

+            

+            return scaDomainFinder;

+

+        } catch (Exception e) {

+            throw new ServiceRuntimeException(e);

+        }  

+    }

+

+    /**

+     * Finds an existing SCA domain.

+     * 

+     * @param domainURI the URI of the domain, this is the endpoint

+     * URI of the domain administration service

+     * @return the SCA domain

+     */

+    public abstract SCADomain getSCADomain(String domainURI) throws DomainException;

+    

+}

diff --git a/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/SCANode.java b/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/SCANode.java
new file mode 100644
index 0000000000..f5c439f3be
--- /dev/null
+++ b/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/SCANode.java
@@ -0,0 +1,79 @@
+/*

+ * 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.node;

+

+import java.net.URL;

+

+import javax.xml.namespace.QName;

+

+import org.apache.tuscany.sca.domain.SCADomain;

+

+/**

+ * Represents an SCA processing node. An SCA node belongs to an SCA domain.

+ * A node is loaded with one or mode SCA composites. It can start and stop that composite. 

+ * 

+ * @version $Rev: 580520 $ $Date: 2007-09-29 00:50:25 +0100 (Sat, 29 Sep 2007) $

+ */

+public interface SCANode {

+

+

+

+    /**

+     * Returns the URI of the SCA node. That URI is the endpoint of the

+     * SCA node administration service.

+     * 

+     * @return the URI of the SCA node

+     */

+    public String getURI();

+    

+    /**

+     * Returns the SCA domain that the node belongs to.

+     * 

+     * @return the SCA domain that the node belongs to 

+     */

+    public SCADomain getDomain(); 

+    

+    /**

+     * Add an SCA contribution into the node.

+     *  

+     * @param contributionURI the URI of the contribution

+     * @param contributionURL the URL of the contribution

+     */

+    public void addContribution(String contributionURI, URL contributionURL) throws NodeException;

+   

+    /**

+     * Deploy the named composite if it hasn't already been deployed

+     * 

+     * @param compositeQName the name of the composite to be deployed

+     */

+    public void deployComposite(QName compositeQName) throws NodeException;

+    

+    /**

+     * Start the SCA node service and all the deployed composites

+     */

+    public void start() throws NodeException;    

+    

+    /**

+     * Stop the SCA node service and all of the deployed composites

+     */

+    public void stop() throws NodeException;    

+

+        

+}

diff --git a/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/SCANodeFactory.java b/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/SCANodeFactory.java
new file mode 100644
index 0000000000..f1b675b4ea
--- /dev/null
+++ b/branches/sca-java-1.0.1/modules/node-api/src/main/java/org/apache/tuscany/sca/node/SCANodeFactory.java
@@ -0,0 +1,93 @@
+/*

+ * 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.node;

+

+import java.lang.reflect.Constructor;

+

+import org.osoa.sca.ServiceRuntimeException;

+

+/**

+ * A factory for SCA processing nodes. An SCA processing node can be loaded

+ * with an SCA composite.

+ * 

+ * @version $Rev: 579871 $ $Date: 2007-09-27 03:20:34 +0100 (Thu, 27 Sep 2007) $

+ */

+public abstract class SCANodeFactory {

+    

+        

+    /**

+     * Returns a new SCA node factory instance.

+     *  

+     * @return a new SCA node factory

+     */

+    public static SCANodeFactory newInstance() {

+        SCANodeFactory scaNodeFactory = null;

+        

+        try {

+            final ClassLoader classLoader = SCANodeFactory.class.getClassLoader();

+            String className =  "org.apache.tuscany.sca.node.impl.SCANodeFactoryImpl";  

+                            

+            Class cls = Class.forName(className, true, classLoader);

+            

+            Constructor<?> constructor = null;

+            

+            try {

+                constructor = cls.getConstructor();

+            } catch (NoSuchMethodException e) {

+                // ignore

+            }

+            

+            if (constructor != null) {

+                scaNodeFactory = (SCANodeFactory)constructor.newInstance();

+            } 

+            

+            return scaNodeFactory;

+

+        } catch (Exception e) {

+            throw new ServiceRuntimeException(e);

+        }  

+    }

+

+    /**

+     * Creates a new SCA node.

+     * 

+     * @param nodeURI the URI of the node, this is the endpoint URI of the

+     * node administration service

+     * @param domainURI the URI of the domain that the node belongs to

+     * @return a new SCA node.

+     */

+    public abstract SCANode createSCANode(String nodeURI, String domainURI) throws NodeException;

+    

+    /**

+     * Creates a new SCA node as part of a node group. Groups of nodes are used in load balancing

+     *  and failover scenarios where each node in the group runs the same contribution and 

+     *  active composites 

+     * 

+     * @param nodeURI the URI of the node, this is the endpoint URI of the

+     * node administration service

+     * @param domainURI the URI of the domain that the node belongs to

+     * @param nodeGroupURI the uri of the node group. This is the enpoint URI of the head of the

+     * group of nodes. For example, in load balancing scnearios this will be the loaded balancer itself

+     * @return a new SCA node.

+     */

+    public abstract SCANode createSCANode(String nodeURI, String domainURI, String nodeGroupURI) throws NodeException;

+    

+    

+}