Add Gson codecs for WebFlux

This commit adds new `GsonEncoder` and `GsonDecoder` for serializing and
deserializing JSON in a reactive fashion.

Because `Gson` itslef does not support decoding JSON in a non-blocking
way, the `GsonDecoder` does not support decoding to `Flux<*>` types.

Closes gh-27131

spring-web/src/main/java/org/springframework/http/codec/CodecConfigurer.java

@@ -142,6 +142,20 @@ public interface CodecConfigurer {
 		 */
 		void jackson2JsonEncoder(Encoder<?> encoder);
 
+		/**
+		 * Override the default Gson {@code Decoder}.
+		 * @param decoder the decoder instance to use
+		 * @see org.springframework.http.codec.json.GsonDecoder
+		 */
+		void gsonDecoder(Decoder<?> decoder);
+
+		/**
+		 * Override the default Gson {@code Encoder}.
+		 * @param encoder the encoder instance to use
+		 * @see org.springframework.http.codec.json.GsonEncoder
+		 */
+		void gsonEncoder(Encoder<?> encoder);
+
 		/**
 		 * Override the default Jackson 3.x Smile {@code Decoder}.
 		 * <p>Note that {@link #maxInMemorySize(int)}, if configured, will be

spring-web/src/main/java/org/springframework/http/codec/json/GsonDecoder.java

@@ -0,0 +1,101 @@
+/*
+ * Copyright 2002-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.http.codec.json;
+
+import java.io.InputStreamReader;
+import java.util.Map;
+
+import com.google.gson.Gson;
+import org.jspecify.annotations.Nullable;
+import org.reactivestreams.Publisher;
+import reactor.core.publisher.Flux;
+
+import org.springframework.core.ResolvableType;
+import org.springframework.core.codec.AbstractDataBufferDecoder;
+import org.springframework.core.codec.Decoder;
+import org.springframework.core.codec.DecodingException;
+import org.springframework.core.io.buffer.DataBuffer;
+import org.springframework.core.io.buffer.DataBufferUtils;
+import org.springframework.http.MediaType;
+import org.springframework.util.Assert;
+import org.springframework.util.MimeType;
+
+/**
+ * {@link Decoder} that reads a byte stream into JSON and converts it to Objects with
+ * <a href="https://google.github.io/gson/">Google Gson</a>.
+ * <p>{@code Flux<*>} target types are not available because non-blocking parsing is not supported,
+ * so this decoder targets only {@code Mono<*>} types. Attempting to decode to a {@code Flux<*>} will
+ * result in a {@link UnsupportedOperationException} being thrown at runtime.
+ *
+ * @author Brian Clozel
+ * @since 7.0
+ */
+public class GsonDecoder extends AbstractDataBufferDecoder<Object> {
+
+	private static final MimeType[] DEFAULT_JSON_MIME_TYPES = new MimeType[] {
+			MediaType.APPLICATION_JSON,
+			new MediaType("application", "*+json"),
+	};
+
+	private final Gson gson;
+
+	/**
+	 * Construct a new decoder using a default {@link Gson} instance
+	 * and the {@code "application/json"} and {@code "application/*+json"}
+	 * MIME types.
+	 */
+	public GsonDecoder() {
+		this(new Gson(), DEFAULT_JSON_MIME_TYPES);
+	}
+
+	/**
+	 * Construct a new decoder using the given {@link Gson} instance
+	 * and the provided MIME types.
+	 * @param gson the gson instance to use
+	 * @param mimeTypes the mime types the decoder should support
+	 */
+	public GsonDecoder(Gson gson, MimeType... mimeTypes) {
+		super(mimeTypes);
+		Assert.notNull(gson, "A Gson instance is required");
+		this.gson = gson;
+	}
+
+
+	@Override
+	public boolean canDecode(ResolvableType elementType, @Nullable MimeType mimeType) {
+		if (!super.canDecode(elementType, mimeType)) {
+			return false;
+		}
+		return !CharSequence.class.isAssignableFrom(elementType.toClass());
+	}
+
+	@Override
+	public Flux<Object> decode(Publisher<DataBuffer> inputStream, ResolvableType elementType, @Nullable MimeType mimeType, @Nullable Map<String, Object> hints) {
+		throw new UnsupportedOperationException("Stream decoding is currently not supported");
+	}
+
+	@Override
+	public @Nullable Object decode(DataBuffer buffer, ResolvableType targetType, @Nullable MimeType mimeType, @Nullable Map<String, Object> hints) throws DecodingException {
+		try {
+			return this.gson.fromJson(new InputStreamReader(buffer.asInputStream()), targetType.getType());
+		}
+		finally {
+			DataBufferUtils.release(buffer);
+		}
+	}
+
+}

spring-web/src/main/java/org/springframework/http/codec/json/GsonEncoder.java

@@ -0,0 +1,205 @@
+/*
+ * Copyright 2002-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.http.codec.json;
+
+import java.io.IOException;
+import java.io.OutputStreamWriter;
+import java.nio.charset.StandardCharsets;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import com.google.gson.Gson;
+import org.jspecify.annotations.Nullable;
+import org.reactivestreams.Publisher;
+import reactor.core.publisher.Flux;
+import reactor.core.publisher.Mono;
+
+import org.springframework.core.ResolvableType;
+import org.springframework.core.codec.AbstractEncoder;
+import org.springframework.core.codec.EncodingException;
+import org.springframework.core.io.buffer.DataBuffer;
+import org.springframework.core.io.buffer.DataBufferFactory;
+import org.springframework.http.MediaType;
+import org.springframework.http.codec.HttpMessageEncoder;
+import org.springframework.util.Assert;
+import org.springframework.util.FastByteArrayOutputStream;
+import org.springframework.util.MimeType;
+
+/**
+ * Encode from an {@code Object} stream to a byte stream of JSON objects using
+ * <a href="https://google.github.io/gson/">Google Gson</a>.
+ *
+ * @author Brian Clozel
+ * @since 7.0
+ */
+public class GsonEncoder extends AbstractEncoder<Object> implements HttpMessageEncoder<Object> {
+
+	private static final byte[] NEWLINE_SEPARATOR = {'\n'};
+
+	private static final byte[] EMPTY_BYTES = new byte[0];
+
+	private static final MimeType[] DEFAULT_JSON_MIME_TYPES = new MimeType[] {
+			MediaType.APPLICATION_JSON,
+			new MediaType("application", "*+json"),
+			MediaType.APPLICATION_NDJSON
+	};
+
+	private final Gson gson;
+
+	private final List<MediaType> streamingMediaTypes = new ArrayList<>(1);
+
+	/**
+	 * Construct a new encoder using a default {@link Gson} instance
+	 * and the {@code "application/json"} and {@code "application/*+json"}
+	 * MIME types. The {@code "application/x-ndjson"} is configured for streaming.
+	 */
+	public GsonEncoder() {
+		this(new Gson(), DEFAULT_JSON_MIME_TYPES);
+		setStreamingMediaTypes(List.of(MediaType.APPLICATION_NDJSON));
+	}
+
+	/**
+	 * Construct a new encoder using the given {@link Gson} instance
+	 * and the provided MIME types. Use {@link #setStreamingMediaTypes(List)}
+	 * for configuring streaming media types.
+	 * @param gson the gson instance to use
+	 * @param mimeTypes the mime types the decoder should support
+	 */
+	public GsonEncoder(Gson gson, MimeType... mimeTypes) {
+		super(mimeTypes);
+		Assert.notNull(gson, "A Gson instance is required");
+		this.gson = gson;
+	}
+
+	/**
+	 * Configure "streaming" media types for which flushing should be performed
+	 * automatically vs at the end of the stream.
+	 */
+	public void setStreamingMediaTypes(List<MediaType> mediaTypes) {
+		this.streamingMediaTypes.clear();
+		this.streamingMediaTypes.addAll(mediaTypes);
+	}
+
+	@Override
+	public List<MediaType> getStreamingMediaTypes() {
+		return Collections.unmodifiableList(this.streamingMediaTypes);
+	}
+
+	@Override
+	public boolean canEncode(ResolvableType elementType, @Nullable MimeType mimeType) {
+		if (!super.canEncode(elementType, mimeType)) {
+			return false;
+		}
+		Class<?> clazz = elementType.toClass();
+		return !String.class.isAssignableFrom(elementType.resolve(clazz));
+	}
+
+	@Override
+	public Flux<DataBuffer> encode(Publisher<?> inputStream, DataBufferFactory bufferFactory, ResolvableType elementType,
+					@Nullable MimeType mimeType, @Nullable Map<String, Object> hints) {
+
+		boolean isStreaming = isStreamingMediaType(mimeType);
+		if (isStreaming) {
+			return Flux.from(inputStream).map(message -> encodeValue(message, bufferFactory, EMPTY_BYTES, NEWLINE_SEPARATOR));
+		}
+		else {
+			JsonArrayJoinHelper helper = new JsonArrayJoinHelper();
+			// Do not prepend JSON array prefix until first signal is known, onNext vs onError
+			// Keeps response not committed for error handling
+			return Flux.from(inputStream)
+					.map(value -> {
+						byte[] prefix = helper.getPrefix();
+						byte[] delimiter = helper.getDelimiter();
+						DataBuffer dataBuffer = encodeValue(value, bufferFactory, delimiter, EMPTY_BYTES);
+						return (prefix.length > 0 ?
+								bufferFactory.join(List.of(bufferFactory.wrap(prefix), dataBuffer)) :
+								dataBuffer);
+					})
+					.switchIfEmpty(Mono.fromCallable(() -> bufferFactory.wrap(helper.getPrefix())))
+					.concatWith(Mono.fromCallable(() -> bufferFactory.wrap(helper.getSuffix())));
+		}
+	}
+
+	@Override
+	public DataBuffer encodeValue(Object value, DataBufferFactory bufferFactory, ResolvableType valueType,
+					@Nullable MimeType mimeType, @Nullable Map<String, Object> hints) {
+		return encodeValue(value, bufferFactory, EMPTY_BYTES, EMPTY_BYTES);
+	}
+
+	private DataBuffer encodeValue(Object value, DataBufferFactory bufferFactory,
+					byte[] prefix, byte[] suffix) {
+		try {
+			FastByteArrayOutputStream bos = new FastByteArrayOutputStream();
+			OutputStreamWriter writer = new OutputStreamWriter(bos, StandardCharsets.UTF_8);
+			bos.write(prefix);
+			this.gson.toJson(value, writer);
+			writer.flush();
+			bos.write(suffix);
+			byte[] bytes = bos.toByteArrayUnsafe();
+			return bufferFactory.wrap(bytes);
+		}
+		catch (IOException ex) {
+			throw new EncodingException("JSON encoding error: " + ex.getMessage(), ex);
+		}
+	}
+
+	/**
+	 * Return the separator to use for the given mime type.
+	 * <p>By default, this method returns new line {@code "\n"} if the given
+	 * mime type is one of the configured {@link #setStreamingMediaTypes(List)
+	 * streaming} mime types.
+	 */
+	protected boolean isStreamingMediaType(@Nullable MimeType mimeType) {
+		for (MediaType streamingMediaType : this.streamingMediaTypes) {
+			if (streamingMediaType.isCompatibleWith(mimeType)) {
+				return true;
+			}
+		}
+		return false;
+	}
+
+
+	private static class JsonArrayJoinHelper {
+
+		private static final byte[] COMMA_SEPARATOR = {','};
+
+		private static final byte[] OPEN_BRACKET = {'['};
+
+		private static final byte[] CLOSE_BRACKET = {']'};
+
+		private boolean firstItemEmitted;
+
+		public byte[] getDelimiter() {
+			if (this.firstItemEmitted) {
+				return COMMA_SEPARATOR;
+			}
+			this.firstItemEmitted = true;
+			return EMPTY_BYTES;
+		}
+
+		public byte[] getPrefix() {
+			return (this.firstItemEmitted ? EMPTY_BYTES : OPEN_BRACKET);
+		}
+
+		public byte[] getSuffix() {
+			return CLOSE_BRACKET;
+		}
+	}
+
+}

spring-web/src/main/java/org/springframework/http/codec/support/BaseDefaultCodecs.java

@@ -54,6 +54,8 @@ import org.springframework.http.codec.ServerSentEventHttpMessageWriter;
 import org.springframework.http.codec.cbor.KotlinSerializationCborDecoder;
 import org.springframework.http.codec.cbor.KotlinSerializationCborEncoder;
 import org.springframework.http.codec.json.AbstractJackson2Decoder;
+import org.springframework.http.codec.json.GsonDecoder;
+import org.springframework.http.codec.json.GsonEncoder;
 import org.springframework.http.codec.json.Jackson2JsonDecoder;
 import org.springframework.http.codec.json.Jackson2JsonEncoder;
 import org.springframework.http.codec.json.Jackson2SmileDecoder;
@@ -93,6 +95,8 @@ class BaseDefaultCodecs implements CodecConfigurer.DefaultCodecs, CodecConfigure
 
 	static final boolean JACKSON_2_PRESENT;
 
+	static final boolean GSON_PRESENT;
+
 	private static final boolean JACKSON_SMILE_PRESENT;
 
 	private static final boolean JACKSON_2_SMILE_PRESENT;
@@ -114,6 +118,7 @@ class BaseDefaultCodecs implements CodecConfigurer.DefaultCodecs, CodecConfigure
 		JACKSON_PRESENT = ClassUtils.isPresent("tools.jackson.databind.ObjectMapper", classLoader);
 		JACKSON_2_PRESENT = ClassUtils.isPresent("com.fasterxml.jackson.databind.ObjectMapper", classLoader) &&
 						ClassUtils.isPresent("com.fasterxml.jackson.core.JsonGenerator", classLoader);
+		GSON_PRESENT = ClassUtils.isPresent("com.google.gson.Gson", classLoader);
 		JACKSON_SMILE_PRESENT = JACKSON_PRESENT && ClassUtils.isPresent("tools.jackson.dataformat.smile.SmileMapper", classLoader);
 		JACKSON_2_SMILE_PRESENT = JACKSON_2_PRESENT && ClassUtils.isPresent("com.fasterxml.jackson.dataformat.smile.SmileFactory", classLoader);
 		JAXB_2_PRESENT = ClassUtils.isPresent("jakarta.xml.bind.Binder", classLoader);
@@ -133,6 +138,10 @@ class BaseDefaultCodecs implements CodecConfigurer.DefaultCodecs, CodecConfigure
 
 	private @Nullable Encoder<?> jackson2JsonEncoder;
 
+	private @Nullable Decoder<?> gsonDecoder;
+
+	private @Nullable Encoder<?> gsonEncoder;
+
 	private @Nullable Encoder<?> jacksonSmileEncoder;
 
 	private @Nullable Encoder<?> jackson2SmileEncoder;
@@ -218,6 +227,8 @@ class BaseDefaultCodecs implements CodecConfigurer.DefaultCodecs, CodecConfigure
 		this.jackson2JsonDecoder = other.jackson2JsonDecoder;
 		this.jacksonJsonEncoder = other.jacksonJsonEncoder;
 		this.jackson2JsonEncoder = other.jackson2JsonEncoder;
+		this.gsonDecoder = other.gsonDecoder;
+		this.gsonEncoder = other.gsonEncoder;
 		this.jacksonSmileDecoder = other.jacksonSmileDecoder;
 		this.jackson2SmileDecoder = other.jackson2SmileDecoder;
 		this.jacksonSmileEncoder = other.jacksonSmileEncoder;
@@ -271,6 +282,19 @@ class BaseDefaultCodecs implements CodecConfigurer.DefaultCodecs, CodecConfigure
 		initTypedWriters();
 	}
 
+	@Override
+	public void gsonDecoder(Decoder<?> decoder) {
+		this.gsonDecoder = decoder;
+		initObjectReaders();
+	}
+
+	@Override
+	public void gsonEncoder(Encoder<?> encoder) {
+		this.gsonEncoder = encoder;
+		initObjectWriters();
+		initTypedWriters();
+	}
+
 	@Override
 	public void jacksonSmileDecoder(Decoder<?> decoder) {
 		this.jacksonSmileDecoder = decoder;
@@ -636,6 +660,9 @@ class BaseDefaultCodecs implements CodecConfigurer.DefaultCodecs, CodecConfigure
 		else if (JACKSON_2_PRESENT) {
 			addCodec(this.objectReaders, new DecoderHttpMessageReader<>(getJackson2JsonDecoder()));
 		}
+		else if (GSON_PRESENT) {
+			addCodec(this.objectReaders, new DecoderHttpMessageReader<>(getGsonDecoder()));
+		}
 		else if (KOTLIN_SERIALIZATION_JSON_PRESENT) {
 			addCodec(this.objectReaders, new DecoderHttpMessageReader<>(getKotlinSerializationJsonDecoder()));
 		}
@@ -781,6 +808,9 @@ class BaseDefaultCodecs implements CodecConfigurer.DefaultCodecs, CodecConfigure
 		else if (JACKSON_2_PRESENT) {
 			addCodec(writers, new EncoderHttpMessageWriter<>(getJackson2JsonEncoder()));
 		}
+		else if (GSON_PRESENT) {
+			addCodec(writers, new EncoderHttpMessageWriter<>(getGsonEncoder()));
+		}
 		else if (KOTLIN_SERIALIZATION_JSON_PRESENT) {
 			addCodec(writers, new EncoderHttpMessageWriter<>(getKotlinSerializationJsonEncoder()));
 		}
@@ -865,6 +895,20 @@ class BaseDefaultCodecs implements CodecConfigurer.DefaultCodecs, CodecConfigure
 		return this.jackson2JsonEncoder;
 	}
 
+	protected Decoder<?> getGsonDecoder() {
+		if (this.gsonDecoder == null) {
+			this.gsonDecoder = new GsonDecoder();
+		}
+		return this.gsonDecoder;
+	}
+
+	protected Encoder<?> getGsonEncoder() {
+		if (this.gsonEncoder == null) {
+			this.gsonEncoder = new GsonEncoder();
+		}
+		return this.gsonEncoder;
+	}
+
 	protected Decoder<?> getKotlinSerializationJsonDecoder() {
 		if (this.kotlinSerializationJsonDecoder == null) {
 			this.kotlinSerializationJsonDecoder = new KotlinSerializationJsonDecoder();

spring-web/src/main/java/org/springframework/http/codec/support/ClientDefaultCodecsImpl.java

@@ -55,6 +55,7 @@ class ClientDefaultCodecsImpl extends BaseDefaultCodecs implements ClientCodecCo
 		Decoder<?> decoder = (this.sseDecoder != null ? this.sseDecoder :
 				JACKSON_PRESENT ? getJacksonJsonDecoder() :
 				JACKSON_2_PRESENT ? getJackson2JsonDecoder() :
+				GSON_PRESENT ? getGsonDecoder() :
 				KOTLIN_SERIALIZATION_JSON_PRESENT ? getKotlinSerializationJsonDecoder() :
 				null);