ace-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ange...@apache.org
Subject 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/...
Date Sun, 20 Mar 2011 17:58:44 GMT
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>
         -->



Mime
View raw message