You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ace.apache.org by an...@apache.org on 2011/03/20 18:58:44 UTC
svn commit: r1083525 - in /incubator/ace/trunk: ./ ace-nodelauncher-api/
ace-nodelauncher-api/src/ ace-nodelauncher-api/src/main/
ace-nodelauncher-api/src/main/java/ ace-nodelauncher-api/src/main/java/org/
ace-nodelauncher-api/src/main/java/org/apache/...
Author: angelos
Date: Sun Mar 20 17:58:43 2011
New Revision: 1083525
URL: http://svn.apache.org/viewvc?rev=1083525&view=rev
Log:
Included the NodeLauncher API.
Added:
incubator/ace/trunk/ace-nodelauncher-api/
incubator/ace/trunk/ace-nodelauncher-api/pom.xml
incubator/ace/trunk/ace-nodelauncher-api/src/
incubator/ace/trunk/ace-nodelauncher-api/src/main/
incubator/ace/trunk/ace-nodelauncher-api/src/main/java/
incubator/ace/trunk/ace-nodelauncher-api/src/main/java/org/
incubator/ace/trunk/ace-nodelauncher-api/src/main/java/org/apache/
incubator/ace/trunk/ace-nodelauncher-api/src/main/java/org/apache/ace/
incubator/ace/trunk/ace-nodelauncher-api/src/main/java/org/apache/ace/nodelauncher/
incubator/ace/trunk/ace-nodelauncher-api/src/main/java/org/apache/ace/nodelauncher/NodeLauncher.java
Modified:
incubator/ace/trunk/pom.xml
Added: incubator/ace/trunk/ace-nodelauncher-api/pom.xml
URL: http://svn.apache.org/viewvc/incubator/ace/trunk/ace-nodelauncher-api/pom.xml?rev=1083525&view=auto
==============================================================================
--- incubator/ace/trunk/ace-nodelauncher-api/pom.xml (added)
+++ incubator/ace/trunk/ace-nodelauncher-api/pom.xml Sun Mar 20 17:58:43 2011
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+ <!--
+
+ 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.
+ -->
+
+ <modelVersion>4.0.0</modelVersion>
+
+ <parent>
+ <groupId>org.apache.ace</groupId>
+ <artifactId>ace-pom</artifactId>
+ <version>0.8.0-SNAPSHOT</version>
+ <relativePath>../pom/pom.xml</relativePath>
+ </parent>
+
+ <artifactId>org.apache.ace.nodelauncher.api</artifactId>
+ <packaging>bundle</packaging>
+
+ <name>Apache ACE :: NodeLauncher :: API</name>
+ <description></description>
+
+ <properties>
+ <export.package>
+ org.apache.ace.nodelauncher;version=${project.version}
+ </export.package>
+ <import.package>
+ !org.apache.ace.nodelauncher
+ </import.package>
+ </properties>
+
+</project>
\ No newline at end of file
Added: incubator/ace/trunk/ace-nodelauncher-api/src/main/java/org/apache/ace/nodelauncher/NodeLauncher.java
URL: http://svn.apache.org/viewvc/incubator/ace/trunk/ace-nodelauncher-api/src/main/java/org/apache/ace/nodelauncher/NodeLauncher.java?rev=1083525&view=auto
==============================================================================
--- incubator/ace/trunk/ace-nodelauncher-api/src/main/java/org/apache/ace/nodelauncher/NodeLauncher.java (added)
+++ incubator/ace/trunk/ace-nodelauncher-api/src/main/java/org/apache/ace/nodelauncher/NodeLauncher.java Sun Mar 20 17:58:43 2011
@@ -0,0 +1,39 @@
+package org.apache.ace.nodelauncher;
+
+import java.util.Properties;
+
+/**
+ * A TargetLauncher starts, stops and interrogates named nodes. These nodes
+ * represent running JVMs in some sense; they can be provided by some
+ * cloud-provider, or running JVMs on a single machine.<br>
+ * <br>
+ * It is up to the provider to decide what to run on the given Node. This can be
+ * either a single Management Agent, which can be identified by the <code>id</code>,
+ * or a Node Manager.
+ */
+public interface NodeLauncher {
+ /**
+ * Starts a new node with the given ID. Does not check whether this ID is already in use.
+ * @param id A textual ID for the node.
+ * @throws Exception Be aware that the implementation may pass through implementation-specific exceptions.
+ */
+ void start(String id) throws Exception;
+
+ /**
+ * Destroys the node with the given ID. Does not check whether this ID actually exists.
+ * @param id A textual ID for the node.
+ * @throws Exception Be aware that the implementation may pass through implementation-specific exceptions.
+ */
+ void stop(String id) throws Exception;
+
+ /**
+ * Retrieves properties from the node. These will include, at least
+ * <ul>
+ * <li><em>ip</em> The public IP address of the node.</li>
+ * </ul>
+ * @param id The textual ID for the node.
+ * @return the properties of the node, or <code>null</code> if this node cannot be found.
+ * @throws Exception Be aware that the implementation may pass through implementation-specific exceptions.
+ */
+ Properties getProperties(String id) throws Exception;
+}
Modified: incubator/ace/trunk/pom.xml
URL: http://svn.apache.org/viewvc/incubator/ace/trunk/pom.xml?rev=1083525&r1=1083524&r2=1083525&view=diff
==============================================================================
--- incubator/ace/trunk/pom.xml (original)
+++ incubator/ace/trunk/pom.xml Sun Mar 20 17:58:43 2011
@@ -114,6 +114,8 @@
<module>ace-target-devgateway</module>
<module>ace-target-devserver</module>
+ <module>ace-nodelauncher-api</module>
+
<!-- not ready yet
<module>ace-distribution-servlet</module>
-->