From 8deb678af5d2d47af034efde85fc02614f7c37d9 Mon Sep 17 00:00:00 2001 From: Christian Kaltepoth Date: Sat, 16 Feb 2019 11:14:11 +0100 Subject: [PATCH] Clarify in which situations MBW/MBR pipelines are executed (#711) --- .../src/main/java/javax/ws/rs/ext/MessageBodyReader.java | 5 +++-- .../src/main/java/javax/ws/rs/ext/MessageBodyWriter.java | 5 +++-- 2 files changed, 6 insertions(+), 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 index b6398a562..fcb12f2c0 100644 --- 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 @@ -27,7 +27,8 @@ * Contract for a provider that supports the conversion of a stream to a Java type. * * 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. + * types for which it will 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}. *

* Providers implementing {@code MessageBodyReader} contract must be either programmatically registered in a JAX-RS * runtime or must be annotated with {@link javax.ws.rs.ext.Provider @Provider} annotation to be automatically 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 index 4e7d11f95..af62ba208 100644 --- 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 @@ -27,7 +27,8 @@ * Contract for a provider that supports the conversion of a Java type to a stream. * * 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. + * types for which it will be considered suitable. The {@code MessageBodyWriter} pipeline is only invoked if there is + * a non-null response entity. *

* Providers implementing {@code MessageBodyWriter} contract must be either programmatically registered in a JAX-RS * runtime or must be annotated with {@link javax.ws.rs.ext.Provider @Provider} annotation to be automatically