Remove deprecated APIs

[gpl/argeo-slc.git] / runtime / org.argeo.slc.detached / src / main / java / org / argeo / slc / detached / DetachedRequest.java

diff --git a/runtime/org.argeo.slc.detached/src/main/java/org/argeo/slc/detached/DetachedRequest.java b/runtime/org.argeo.slc.detached/src/main/java/org/argeo/slc/detached/DetachedRequest.java
index 99427bf1d12c1f7d56187c4b936590e396cb0116..8b296d42662b58eef57b4d0ccc2faff3f4bb8f18 100644 (file)
--- a/runtime/org.argeo.slc.detached/src/main/java/org/argeo/slc/detached/DetachedRequest.java
+++ b/runtime/org.argeo.slc.detached/src/main/java/org/argeo/slc/detached/DetachedRequest.java
@@ -1,14 +1,31 @@
+/*
+ * Copyright (C) 2007-2012 Mathieu Baudier
+ *
+ * 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.detached;
 
 import java.util.Properties;
 
+/** A request sent to the detached server. */
 public class DetachedRequest implements DetachedCommunication {
        static final long serialVersionUID = 1l;
 
        private String uuid;
        private Properties properties = new Properties();
        private String ref;
-       private String path = "";
+
+       private Object cachedObject = null;
 
        public DetachedRequest() {
 
@@ -18,6 +35,7 @@ public class DetachedRequest implements DetachedCommunication {
                this.uuid = uuid;
        }
 
+       /** The properties configuring this request. */
        public Properties getProperties() {
                return properties;
        }
@@ -26,6 +44,10 @@ public class DetachedRequest implements DetachedCommunication {
                this.properties = inputParameters;
        }
 
+       /**
+        * A reference to the underlying implementation which will process the
+        * request.
+        */
        public String getRef() {
                return ref;
        }
@@ -34,14 +56,7 @@ public class DetachedRequest implements DetachedCommunication {
                this.ref = stepRef;
        }
 
-       public String getPath() {
-               return path;
-       }
-
-       public void setPath(String path) {
-               this.path = path;
-       }
-
+       /** The unique identifier of this request. */
        public String getUuid() {
                return uuid;
        }
@@ -49,4 +64,27 @@ public class DetachedRequest implements DetachedCommunication {
        public void setUuid(String uuid) {
                this.uuid = uuid;
        }
+
+       public String toString() {
+               StringBuffer buf = new StringBuffer("detached request for ref ");
+               buf.append(ref);
+               buf.append(" #").append(uuid);
+               buf.append(" cachedObject=").append((cachedObject != null));
+               buf.append(" properties=").append(properties);
+               return buf.toString();
+       }
+
+       /**
+        * Optimization. Allows the driver to eagerly cache the object in the
+        * request, in order to relieve the detached server of the task to look for
+        * it. No implementation should rely on this to be set.
+        */
+       public Object getCachedObject() {
+               return cachedObject;
+       }
+
+       public void setCachedObject(Object cachedObject) {
+               this.cachedObject = cachedObject;
+       }
+
 }