commit 75a25dbcdafa6345d9cbddeb19712a90d214bd6f
author mhadley <mhadley@localhost> Mon Jun 23 14:14:16 2008 +0000
committer mhadley <mhadley@localhost> Mon Jun 23 14:14:16 2008 +0000
tree 1a52e94c779e343e37d57fd3d9ce251cebe39715
parent 9a45310488b70a81dea7a7269e25cb5471f421b8

What to do if null

svn path=/trunk/; revision=381

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 2ab8c3d..984bcc4 100644
--- a/src/jsr311-api/src/javax/ws/rs/core/Response.java
+++ b/src/jsr311-api/src/javax/ws/rs/core/Response.java
@@ -489,11 +489,12 @@
         public abstract ResponseBuilder cacheControl(CacheControl cacheControl);
         
         /**
-         * Set the value of a specific header on the ResponseBuilder.
+         * Add a header to the ResponseBuilder.
          * 
          * @param name the name of the header
          * @param value the value of the header, the header will be serialized
-         * using its toString method
+         * using its toString method. If null then all current headers of the
+         * same name will be removed.
          * @return the updated ResponseBuilder
          */
         public abstract ResponseBuilder header(String name, Object value);
@@ -502,7 +503,8 @@
          * Add cookies to the ResponseBuilder. If more than one cookie with
          * the same is supplied, later ones overwrite earlier ones.
          * 
-         * @param cookies new cookies that will accompany the response.
+         * @param cookies new cookies that will accompany the response. A null
+         * value will remove all cookies.
          * @return the updated ResponseBuilder
          */
         public abstract ResponseBuilder cookie(NewCookie... cookies);