Return-Path: 
 <ace-commits-return-648-apmail-incubator-ace-commits-archive=incubator.apache.org@incubator.apache.org>
Delivered-To: apmail-incubator-ace-commits-archive@minotaur.apache.org
Received: (qmail 96668 invoked from network); 20 Mar 2011 17:59:07 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3)
  by minotaur.apache.org with SMTP; 20 Mar 2011 17:59:07 -0000
Received: (qmail 45567 invoked by uid 500); 20 Mar 2011 17:59:07 -0000
Delivered-To: apmail-incubator-ace-commits-archive@incubator.apache.org
Received: (qmail 45549 invoked by uid 500); 20 Mar 2011 17:59:07 -0000
Mailing-List: contact ace-commits-help@incubator.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:ace-commits-help@incubator.apache.org>
List-Unsubscribe: <mailto:ace-commits-unsubscribe@incubator.apache.org>
List-Post: <mailto:ace-commits@incubator.apache.org>
List-Id: <ace-commits.incubator.apache.org>
Reply-To: ace-dev@incubator.apache.org
Delivered-To: mailing list ace-commits@incubator.apache.org
Received: (qmail 45541 invoked by uid 99); 20 Mar 2011 17:59:07 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 20 Mar 2011 17:59:07 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=5.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 20 Mar 2011 17:59:06 +0000
Received: by eris.apache.org (Postfix, from userid 65534)
	id 115EF23888E7; Sun, 20 Mar 2011 17:58:44 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
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 -0000
To: ace-commits@incubator.apache.org
From: angelos@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20110320175844.115EF23888E7@eris.apache.org>

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>
         -->