diff options
author | dims <dims@13f79535-47bb-0310-9956-ffa450edef68> | 2008-06-17 00:23:01 +0000 |
---|---|---|
committer | dims <dims@13f79535-47bb-0310-9956-ffa450edef68> | 2008-06-17 00:23:01 +0000 |
commit | bdd0a41aed7edf21ec2a65cfa17a86af2ef8c48a (patch) | |
tree | 38a92061c0793434c4be189f1d70c3458b6bc41d /branches/sca-java-1.0/modules/node/src/main/java/org/apache |
Move Tuscany from Incubator to top level.
git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@668359 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'branches/sca-java-1.0/modules/node/src/main/java/org/apache')
10 files changed, 646 insertions, 0 deletions
diff --git a/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentInfo.java b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentInfo.java new file mode 100644 index 0000000000..e7cebc9ff2 --- /dev/null +++ b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentInfo.java @@ -0,0 +1,57 @@ +/*
+ * 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;
+
+/**
+ * A collection of information about a component
+ *
+ * @version $Rev: 552343 $ $Date: 2007-09-07 12:41:52 +0100 (Fri, 07 Sep 2007) $
+ */
+public interface ComponentInfo {
+
+ /**
+ * Get the component name
+ *
+ * @return component name
+ */
+ public String getName();
+
+ /**
+ * Set the component name
+ *
+ * @param name component name
+ */
+ public void setName(String name);
+
+ /**
+ * Set to true if the component has been started
+ *
+ * @return true if the component is started
+ */
+ public boolean isStarted();
+
+ /**
+ * Set the started status of the component
+ *
+ * @param started
+ */
+ public void setStarted(boolean started);
+
+}
diff --git a/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentListener.java b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentListener.java new file mode 100644 index 0000000000..a19e2ce361 --- /dev/null +++ b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentListener.java @@ -0,0 +1,47 @@ +/*
+ * 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.util.EventListener;
+
+import org.apache.tuscany.sca.assembly.Component;
+
+/**
+ * A listener interface for changes in component state
+ *
+ * @version $Rev: 552343 $ $Date: 2007-09-07 12:41:52 +0100 (Fri, 07 Sep 2007) $
+ */
+public interface ComponentListener extends EventListener {
+
+ /**
+ * Component has been started
+ *
+ * @param component
+ */
+ void componentStarted(Component component);
+
+ /**
+ * Compoent has been stopped
+ *
+ * @param component
+ */
+ void componentStopped(Component component);
+
+}
diff --git a/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentManager.java b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentManager.java new file mode 100644 index 0000000000..279842d6d6 --- /dev/null +++ b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentManager.java @@ -0,0 +1,85 @@ +/*
+ * 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.util.List;
+
+import org.apache.tuscany.sca.assembly.Component;
+import org.apache.tuscany.sca.core.assembly.ActivationException;
+
+/**
+ * A set of operations for managing the components in a node
+ *
+ * @version $Rev: 552343 $ $Date: 2007-09-07 12:41:52 +0100 (Fri, 07 Sep 2007) $
+ */
+public interface ComponentManager {
+
+ /**
+ * Get a list of component objects
+ *
+ * @return list of components
+ */
+ List<Component> getComponents();
+
+ /**
+ * Get a component object by name
+ *
+ * @param componentName
+ * @return component
+ */
+ Component getComponent(String componentName);
+
+ /**
+ * Returns true if the named component is started
+ * @param component
+ * @return true if component is started
+ */
+ boolean isComponentStarted(Component component);
+
+ /**
+ * Start a component. Makes it ready to receive messages
+ *
+ * @param component
+ * @throws ActivationException
+ */
+ void startComponent(Component component) throws ActivationException;
+
+ /**
+ * Stop component.
+ * @param component
+ * @throws ActivationException
+ */
+ void stopComponent(Component component) throws ActivationException;
+
+ /**
+ * Add a listener that will be called back when the component state changes
+ *
+ * @param listener
+ */
+ void addComponentListener(ComponentListener listener);
+
+ /**
+ * Remove a component listener
+ *
+ * @param listener
+ */
+ void removeComponentListener(ComponentListener listener);
+
+}
diff --git a/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentManagerService.java b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentManagerService.java new file mode 100644 index 0000000000..0e3c2779da --- /dev/null +++ b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentManagerService.java @@ -0,0 +1,66 @@ +/*
+ * 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.util.List;
+
+import org.apache.tuscany.sca.core.assembly.ActivationException;
+import org.osoa.sca.annotations.Remotable;
+
+/**
+ * A service interface for managing the components in a node
+ *
+ * @version $Rev: 552343 $ $Date: 2007-09-07 12:41:52 +0100 (Fri, 07 Sep 2007) $
+ */
+@Remotable
+public interface ComponentManagerService {
+
+ /**
+ * Get a list of component info. On for each component in the node
+ *
+ * @return
+ */
+ List<ComponentInfo> getComponentInfos();
+
+ /**
+ * The info for a named component
+ *
+ * @param componentName
+ * @return
+ */
+ ComponentInfo getComponentInfo(String componentName);
+
+ /**
+ * Start a component, making it ready to receive messages
+ *
+ * @param componentName
+ * @throws ActivationException
+ */
+ void startComponent(String componentName) throws ActivationException;
+
+ /**
+ * Stop a component
+ *
+ * @param componentName
+ * @throws ActivationException
+ */
+ void stopComponent(String componentName) throws ActivationException;
+
+}
diff --git a/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/CompositeManager.java b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/CompositeManager.java new file mode 100644 index 0000000000..2c6d579848 --- /dev/null +++ b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/CompositeManager.java @@ -0,0 +1,85 @@ +/*
+ * 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.io.IOException;
+import java.net.URL;
+
+import javax.xml.namespace.QName;
+
+import org.apache.tuscany.sca.assembly.builder.CompositeBuilderException;
+import org.apache.tuscany.sca.contribution.service.ContributionException;
+import org.apache.tuscany.sca.core.assembly.ActivationException;
+
+
+/**
+ * A management interface for composites in the distributed domain
+ *
+ *
+ * @version $Rev: 552343 $ $Date: 2007-09-07 12:41:52 +0100 (Fri, 07 Sep 2007) $
+ */
+public interface CompositeManager {
+
+ /**
+ * Add all composite in a contribution
+ *
+ * @param contributionURL
+ */
+ public abstract void addAllComposites(URL contributionURL)
+ throws ActivationException, ContributionException, IOException, CompositeBuilderException;
+
+ /**
+ * adds a named composite
+ *
+ * @param compositeName the name of the composite to be added
+ */
+ public abstract void addComposite(QName compositeName);
+
+ /**
+ * Removes a named composite
+ *
+ * @param compositeName the name of the composite to be added
+ */
+ public abstract void removeComposite(QName compositeName);
+
+ /**
+ * Starts all composites in a contribution
+ *
+ * @param contributionURL
+ */
+ public abstract void startAllComposites(URL contributionURL)
+ throws ActivationException;
+
+ /**
+ * Starts a named composite
+ *
+ * @param compositeName the name of the composite to be started
+ */
+ public abstract void startComposite(QName compositeName);
+
+ /**
+ * Stops a named composite
+ *
+ * @param compositeName the name of the composite to be stopped
+ */
+ public abstract void stopComposite(QName compositeName);
+
+
+}
diff --git a/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ContributionManager.java b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ContributionManager.java new file mode 100644 index 0000000000..58555b1822 --- /dev/null +++ b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ContributionManager.java @@ -0,0 +1,55 @@ +/*
+ * 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.io.IOException;
+import java.net.URL;
+
+import org.apache.tuscany.sca.assembly.builder.CompositeBuilderException;
+import org.apache.tuscany.sca.contribution.service.ContributionException;
+import org.apache.tuscany.sca.core.assembly.ActivationException;
+
+
+/**
+ * A management interface for contributions in the distributed domain
+ *
+ * @version $Rev: 552343 $ $Date: 2007-09-09 23:54:46 +0100 (Sun, 09 Sep 2007) $
+ */
+public interface ContributionManager {
+
+ /**
+ * Accepts a new contribution and passes it onto the domain implementation
+ *
+ * @param contributionLocation the URL location of the contribution
+ * @throws ActivationException
+ */
+ public void addContribution(URL contrubutionLocation)
+ throws ActivationException, ContributionException, IOException, CompositeBuilderException;
+
+ /**
+ * Removes the specified contribution from the domain
+ *
+ * @param contributionname
+ * throws ActivationException
+ */
+ public void removeContribution(URL contributionName)
+ throws ActivationException, ContributionException;
+
+}
diff --git a/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeFactory.java b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeFactory.java new file mode 100644 index 0000000000..45bdec91a0 --- /dev/null +++ b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeFactory.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;
+
+import org.apache.tuscany.sca.node.SCANode;
+
+/**
+ * A factory that always returns the same domain object
+ *
+ * @version $Rev: 556897 $ $Date: 2007-09-07 12:41:52 +0100 (Fri, 07 Sep 2007) $
+ */
+public interface NodeFactory {
+
+ /**
+ * Returns the domain object
+ *
+ * @return the domain
+ */
+ public SCANode getNode();
+
+}
diff --git a/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeManagerInitService.java b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeManagerInitService.java new file mode 100644 index 0000000000..dedf640416 --- /dev/null +++ b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeManagerInitService.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;
+
+
+
+/**
+ * Initializes the Node Management component
+ *
+ * @version $Rev: 552343 $ $Date: 2007-09-11 18:45:36 +0100 (Tue, 11 Sep 2007) $
+ */
+public interface NodeManagerInitService {
+
+ /**
+ * Set the node object into the NodeManagement component so that is can manage it
+ *
+ * @param node
+ */
+ public void setNode(SCANode node);
+
+}
diff --git a/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeManagerService.java b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeManagerService.java new file mode 100644 index 0000000000..9e87275849 --- /dev/null +++ b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeManagerService.java @@ -0,0 +1,49 @@ +/*
+ * 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 org.osoa.sca.annotations.Remotable;
+
+
+/**
+ * The management interface for a node
+ *
+ * @version $Rev: 552343 $ $Date: 2007-09-07 12:41:52 +0100 (Fri, 07 Sep 2007) $
+ */
+@Remotable
+public interface NodeManagerService {
+
+ /**
+ * Return the Uri that identifies the node
+ *
+ * @return
+ */
+ public String getNodeUri();
+
+ /**
+ * The configuration of a domain running on this node has changed.
+ * It is the responsibility of the node to respond to this and retrieve
+ * any relevent configuration changes
+ *
+ * @param domainUri the string uri for the distributed domain
+ */
+ // public void addContribution(String domainUri);
+
+}
diff --git a/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/SCANode.java b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/SCANode.java new file mode 100644 index 0000000000..c17f7480b9 --- /dev/null +++ b/branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/SCANode.java @@ -0,0 +1,126 @@ +/*
+ * 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 org.apache.tuscany.sca.domain.SCADomainService;
+import org.osoa.sca.CallableReference;
+import org.osoa.sca.ServiceReference;
+
+
+/**
+ * An SCA Node. Where a domain runs components
+ *
+ * @version $Rev: 556897 $ $Date: 2007-09-07 12:41:52 +0100 (Fri, 07 Sep 2007) $
+ */
+public interface SCANode {
+
+ /**
+ * Returns the name of the distributed domain that this node
+ * is part of.
+ *
+ * @return the domain URI
+ */
+ public String getDomainURI();
+
+ /**
+ * Returns the name of the name of this node
+ *
+ * @return the node name
+ */
+ public String getNodeURI();
+
+
+ /**
+ * Returns the URL of the distributed domain that this node
+ * is part of.
+ *
+ * @return the domain URL
+ */
+ public URL getDomainURL();
+
+ /**
+ * Returns the URL of the name of this node
+ *
+ * @return the node name
+ */
+ public URL getNodeURL();
+
+ /**
+ * Return an interface for registering and looking up remote services
+ *
+ * @return The service discovery interface
+ */
+ public SCADomainService getDomainService();
+
+ /**
+ * Return the nodes component manager
+ *
+ * @return component manager
+ */
+ public ComponentManager getComponentManager();
+
+ /**
+ * Return the nodes contribution manager
+ *
+ * @return contribution manager
+ */
+ public ContributionManager getContributionManager();
+
+ /**
+ * Cast a type-safe reference to a CallableReference. Converts a type-safe
+ * reference to an equivalent CallableReference; if the target refers to a
+ * service then a ServiceReference will be returned, if the target refers to
+ * a callback then a CallableReference will be returned.
+ *
+ * @param target a reference proxy provided by the SCA runtime
+ * @param <B> the Java type of the business interface for the reference
+ * @param <R> the type of reference to be returned
+ * @return a CallableReference equivalent for the proxy
+ * @throws IllegalArgumentException if the supplied instance is not a
+ * reference supplied by the SCA runtime
+ */
+ public abstract <B, R extends CallableReference<B>> R cast(B target) throws IllegalArgumentException;
+
+ /**
+ * Returns a proxy for a service provided by a component in the SCA domain.
+ *
+ * @param businessInterface the interface that will be used to invoke the
+ * service
+ * @param serviceName the name of the service
+ * @param <B> the Java type of the business interface for the service
+ * @return an object that implements the business interface
+ */
+ public abstract <B> B getService(Class<B> businessInterface, String serviceName);
+
+ /**
+ * Returns a ServiceReference for a service provided by a component in the
+ * SCA domain.
+ *
+ * @param businessInterface the interface that will be used to invoke the
+ * service
+ * @param serviceName the name of the service
+ * @param <B> the Java type of the business interface for the service
+ * @return a ServiceReference for the designated service
+ */
+ public abstract <B> ServiceReference<B> getServiceReference(Class<B> businessInterface, String referenceName);
+
+}
|