X-Git-Url: http://git.argeo.org/?a=blobdiff_plain;f=runtime%2Forg.argeo.slc.specs%2Fsrc%2Fmain%2Fjava%2Forg%2Fargeo%2Fslc%2Fexecution%2FExecutionSpec.java;h=e437740eb43150e6cf0eb01d30a9544383dddac2;hb=3781dcd363f0f6265fae0ac758fd40cf4254ebc9;hp=c2c61daafd6945fc1b824f42b4164fd4e37af74d;hpb=1535eecc68ecbda4e67e158de6bcecd074db2545;p=gpl%2Fargeo-slc.git

diff --git a/runtime/org.argeo.slc.specs/src/main/java/org/argeo/slc/execution/ExecutionSpec.java b/runtime/org.argeo.slc.specs/src/main/java/org/argeo/slc/execution/ExecutionSpec.java
index c2c61daaf..e437740eb 100644
--- a/runtime/org.argeo.slc.specs/src/main/java/org/argeo/slc/execution/ExecutionSpec.java
+++ b/runtime/org.argeo.slc.specs/src/main/java/org/argeo/slc/execution/ExecutionSpec.java
@@ -1,11 +1,45 @@
+/*
+ * Copyright (C) 2010 Mathieu Baudier <mbaudier@argeo.org>
+ *
+ * Licensed 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.argeo.slc.execution;
 
 import java.util.Map;
 
+/**
+ * The class implementing this interface defines the map of attributes that are
+ * necessary for the corresponding ExecutionFlow.
+ */
 public interface ExecutionSpec {
-	public Map<String, ExecutionSpecAttribute> getAttributes();
+	/**
+	 * The name for an internal spec (for backward compatibility where a
+	 * non-null name is expected)
+	 */
+	public final static String INTERNAL_NAME = "__SLC_EXECUTION_SPEC_INTERNAL";
 
+	/**
+	 * The name identifying the execution spec within its application context.
+	 * Can be null. An execution spec can be referenced only if its name is not
+	 * null or different from {@link #INTERNAL_NAME}
+	 */
 	public String getName();
-	
+
+	/** An optional description. Can be null. */
 	public String getDescription();
+
+	/** The attributes managed by this execution spec */
+	public Map<String, ExecutionSpecAttribute> getAttributes();
+
 }