Clarify in which situations MBW/MBR pipelines are executed (jakartaee…

…#711)
mkarg · Jul 11, 2019 · ca61670 · ca61670
1 parent e4e4971
commit ca61670
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 4 deletions.
diff --git a/jaxrs-api/src/main/java/javax/ws/rs/ext/MessageBodyReader.java b/jaxrs-api/src/main/java/javax/ws/rs/ext/MessageBodyReader.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2010, 2017 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2010, 2019 Oracle and/or its affiliates. All rights reserved.
  *
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v. 2.0, which is available at
@@ -28,7 +28,8 @@
  *
  * A {@code MessageBodyReader} implementation may be annotated
  * with {@link javax.ws.rs.Consumes} to restrict the media types for which it will
- * be considered suitable.
+ * be considered suitable. The {@code MessageBodyReader} pipeline is executed if the matching 
+ * resource method declares an entity parameter or uses at least one {@link javax.ws.rs.FormParam}.
  * <p>
  * Providers implementing {@code MessageBodyReader} contract must be either programmatically
  * registered in an API runtime or must be annotated with

diff --git a/jaxrs-api/src/main/java/javax/ws/rs/ext/MessageBodyWriter.java b/jaxrs-api/src/main/java/javax/ws/rs/ext/MessageBodyWriter.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2010, 2017 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2010, 2019 Oracle and/or its affiliates. All rights reserved.
  *
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v. 2.0, which is available at
@@ -28,7 +28,8 @@
  *
  * A {@code MessageBodyWriter} implementation may be annotated
  * with {@link javax.ws.rs.Produces} to restrict the media types for which it will
- * be considered suitable.
+ * be considered suitable. The {@code MessageBodyWriter} pipeline is only invoked if there is 
+ * a non-null response entity.
  * <p>
  * Providers implementing {@code MessageBodyWriter} contract must be either programmatically
  * registered in an API runtime or must be annotated with