From bdd0a41aed7edf21ec2a65cfa17a86af2ef8c48a Mon Sep 17 00:00:00 2001 From: dims Date: Tue, 17 Jun 2008 00:23:01 +0000 Subject: Move Tuscany from Incubator to top level. git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@668359 13f79535-47bb-0310-9956-ffa450edef68 --- .../org/apache/tuscany/sca/node/ComponentInfo.java | 57 ++++++++++ .../apache/tuscany/sca/node/ComponentListener.java | 47 ++++++++ .../apache/tuscany/sca/node/ComponentManager.java | 85 ++++++++++++++ .../tuscany/sca/node/ComponentManagerService.java | 66 +++++++++++ .../apache/tuscany/sca/node/CompositeManager.java | 85 ++++++++++++++ .../tuscany/sca/node/ContributionManager.java | 55 +++++++++ .../org/apache/tuscany/sca/node/NodeFactory.java | 38 +++++++ .../tuscany/sca/node/NodeManagerInitService.java | 38 +++++++ .../tuscany/sca/node/NodeManagerService.java | 49 ++++++++ .../java/org/apache/tuscany/sca/node/SCANode.java | 126 +++++++++++++++++++++ 10 files changed, 646 insertions(+) create mode 100644 branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentInfo.java create mode 100644 branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentListener.java create mode 100644 branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentManager.java create mode 100644 branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ComponentManagerService.java create mode 100644 branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/CompositeManager.java create mode 100644 branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/ContributionManager.java create mode 100644 branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeFactory.java create mode 100644 branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeManagerInitService.java create mode 100644 branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/NodeManagerService.java create mode 100644 branches/sca-java-1.0/modules/node/src/main/java/org/apache/tuscany/sca/node/SCANode.java (limited to 'branches/sca-java-1.0/modules/node/src/main/java/org') 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 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 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 the Java type of the business interface for the reference + * @param 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 > 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 the Java type of the business interface for the service + * @return an object that implements the business interface + */ + public abstract B getService(Class 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 the Java type of the business interface for the service + * @return a ServiceReference for the designated service + */ + public abstract ServiceReference getServiceReference(Class businessInterface, String referenceName); + +} -- cgit v1.2.3