Update sca-api with latest OASIS code, these ones have only formatting and javadoc changes

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@931877 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 31 insertions, 20 deletions

diff --git a/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/ServiceUnavailableException.java b/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/ServiceUnavailableException.java
index 39cd6b1cac..355a84a4c3 100644
--- a/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/ServiceUnavailableException.java
+++ b/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/ServiceUnavailableException.java
@@ -1,51 +1,62 @@
 /*
- * Copyright(C) OASIS(R) 2005,2009. All Rights Reserved.
+ * Copyright(C) OASIS(R) 2005,2010. All Rights Reserved.
  * OASIS trademark, IPR and other policies apply.
  */
 package org.oasisopen.sca;
 
 /**
- * Exception used to indicate that a runtime exception occurred during the invocation of and external service.
+ * This exception signals problems in the interaction with remote
+ * services.
  *
- * @version $Rev$ $Date$
+ * These are exceptions that can be transient, so retrying is
+ * appropriate.  Any exception that is a ServiceRuntimeException
+ * that is not a ServiceUnavailableException is unlikely to be
+ * resolved by retrying the operation, since it most likely
+ * requires human intervention.
  */
 public class ServiceUnavailableException extends ServiceRuntimeException {
-
-    private static final long serialVersionUID = -5869397223249401047L;
-
     /**
-     * Constructs a new ServiceUnavailableException.
+     * Constructs a ServiceUnavailableException with no detail message. 
      */
     public ServiceUnavailableException() {
-        super((Throwable) null);
+        super();
     }
 
     /**
-     * Constructs a new ServiceUnavailableException with the specified detail message.
+     * Constructs a ServiceUnavailableException with the specified detail
+     * message. 
      *
-     * @param message The detail message (which is saved to later retrieval by the getMessage() method).
+     * @param     message the detail message
      */
     public ServiceUnavailableException(String message) {
         super(message);
     }
 
     /**
-     * Constructs a new ServiceUnavailableException with the specified cause.
+     * Constructs a ServiceUnavailableException with the specified detail
+     * message and cause.
+     *
+     * The detail message associated with <code>cause</code> is not
+     * automatically incorporated in this exception's detail message.
      *
-     * @param cause The cause (which is saved to later retrieval by the getCause() method).
+     * @param     message the detail message
+     * @param     cause the cause, or null if the cause is nonexistent
+     *            or unknown
      */
-    public ServiceUnavailableException(Throwable cause) {
-        super(cause);
+    public ServiceUnavailableException(String message, Throwable cause) {
+        super(message, cause);
     }
-
+ 
     /**
-     * Constructs a new ServiceUnavailableException with the specified detail message and cause.
+     * Constructs a ServiceUnavailableException with the specified cause and
+     * a detail message of <tt>(cause==null ? null : cause.toString())</tt>.
      *
-     * @param message The message (which is saved to later retrieval by the getMessage() method).
-     * @param cause   The cause (which is saved to later retrieval by the getCause() method).
+     * @param     cause the cause, or null if the cause is nonexistent
+     *            or unknown
      */
-    public ServiceUnavailableException(String message, Throwable cause) {
-        super(message, cause);
+    public ServiceUnavailableException(Throwable cause) {
+        super(cause);
     }
 
+    private static final long serialVersionUID = 5750303470949048271L;
 }