commit 6c8442d73a12ee5418534c490f96521404be5b8e
author mhadley <mhadley@localhost> Tue Mar 10 20:09:14 2009 +0000
committer mhadley <mhadley@localhost> Tue Mar 10 20:09:14 2009 +0000
tree dbc0653f9d46f90717bb2f00b1a3b3967ebba568
parent d8feb068e6746240e5f1f0ef45525378fd254004

1.1MR C008

svn path=/trunk/; revision=552

src/jsr311-api/src/javax/ws/rs/core/Response.java

diff --git a/src/jsr311-api/src/javax/ws/rs/core/Response.java b/src/jsr311-api/src/javax/ws/rs/core/Response.java
index f1e79a3..6f55433 100644
--- a/src/jsr311-api/src/javax/ws/rs/core/Response.java
+++ b/src/jsr311-api/src/javax/ws/rs/core/Response.java
@@ -100,7 +100,7 @@
      * @return a new ResponseBuilder
      * @throws IllegalArgumentException if status is null
      */
-    public static ResponseBuilder status(Status status) {
+    public static ResponseBuilder status(StatusType status) {
         ResponseBuilder b = ResponseBuilder.newInstance();
         b.status(status);
         return b;
@@ -379,7 +379,7 @@
          * @return the updated ResponseBuilder
          * @throws IllegalArgumentException if status is null
          */
-        public ResponseBuilder status(Status status) {
+        public ResponseBuilder status(StatusType status) {
             if (status == null)
                 throw new IllegalArgumentException();
             return status(status.getStatusCode());
@@ -549,11 +549,41 @@
     }
     
     /**
+     * Base interface for statuses used in responses.
+     */
+    public interface StatusType {
+        /**
+         * An enumeration representing the class of status code. Family is used
+         * here since class is overloaded in Java.
+         */
+        public enum Family {INFORMATIONAL, SUCCESSFUL, REDIRECTION, CLIENT_ERROR, SERVER_ERROR, OTHER};
+        
+        /**
+         * Get the associated status code
+         * @return the status code
+         */
+        public int getStatusCode();
+
+        /**
+         * Get the class of status code
+         * @return the class of status code
+         */
+        public Family getFamily();
+
+        /**
+         * Get the reason phrase
+         * @return the reason phrase
+         */
+        public String getReasonPhrase();
+    }
+    
+    /**
      * Commonly used status codes defined by HTTP, see 
      * {@link <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10">HTTP/1.1 documentation</a>}
-     * for the complete list.
+     * for the complete list. Additional status codes can be added by applications
+     * by creating an implementation of {@link StatusType}.
      */
-    public enum Status {
+    public enum Status implements StatusType {
         /**
          * 200 OK, see {@link <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1">HTTP/1.1 documentation</a>}.
          */
@@ -635,12 +665,6 @@
         private final String reason;
         private Family family;
         
-        /**
-         * An enumeration representing the class of status code. Family is used
-         * here since class is overloaded in Java.
-         */
-        public enum Family {INFORMATIONAL, SUCCESSFUL, REDIRECTION, CLIENT_ERROR, SERVER_ERROR, OTHER};
-        
         Status(final int statusCode, final String reasonPhrase) {
             this.code = statusCode;
             this.reason = reasonPhrase;
@@ -674,6 +698,14 @@
          * Get the reason phrase
          * @return the reason phrase
          */
+        public String getReasonPhrase() {
+            return toString();
+        }
+        
+        /**
+         * Get the reason phrase
+         * @return the reason phrase
+         */
         @Override
         public String toString() {
             return reason;