Polish

Author: rstoyanchev

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

@@ -45,21 +45,24 @@
 import org.springframework.util.MimeType;
 
 /**
- * Base class providing support methods for Jackson 2.9 decoding.
+ * Abstract base class for Jackson JSON 2.9 decoding.
  *
  * @author Sebastien Deleuze
  * @author Rossen Stoyanchev
+ * @author Arjen Poutsma
  * @since 5.0
  */
 public abstract class AbstractJackson2Decoder extends Jackson2CodecSupport implements HttpMessageDecoder<Object> {
 
+
 	/**
 	 * Constructor with a Jackson {@link ObjectMapper} to use.
 	 */
 	protected AbstractJackson2Decoder(ObjectMapper mapper, MimeType... mimeTypes) {
 		super(mapper, mimeTypes);
 	}
 
+
 	@Override
 	public boolean canDecode(ResolvableType elementType, @Nullable MimeType mimeType) {
 		JavaType javaType = objectMapper().getTypeFactory().constructType(elementType.getType());
@@ -87,22 +90,17 @@ public Mono<Object> decodeToMono(Publisher<DataBuffer> input, ResolvableType ele
 	private Flux<TokenBuffer> tokenize(Publisher<DataBuffer> input, boolean tokenizeArrayElements) {
 		try {
 			JsonFactory factory = objectMapper().getFactory();
-			JsonParser nonBlockingParser = factory.createNonBlockingByteArrayParser();
-			Jackson2Tokenizer tokenizer = new Jackson2Tokenizer(nonBlockingParser,
-					tokenizeArrayElements);
-			return Flux.from(input)
-					.flatMap(tokenizer)
-					.doFinally(t -> tokenizer.endOfInput());
+			JsonParser parser = factory.createNonBlockingByteArrayParser();
+			Jackson2Tokenizer tokenizer = new Jackson2Tokenizer(parser, tokenizeArrayElements);
+			return Flux.from(input).flatMap(tokenizer).doFinally(t -> tokenizer.endOfInput());
 		}
 		catch (IOException ex) {
 			return Flux.error(new UncheckedIOException(ex));
 		}
-
 	}
 
-	private Flux<Object> decodeInternal(Flux<TokenBuffer> tokens,
-			ResolvableType elementType, @Nullable MimeType mimeType,
-			@Nullable Map<String, Object> hints) {
+	private Flux<Object> decodeInternal(Flux<TokenBuffer> tokens, ResolvableType elementType,
+			@Nullable MimeType mimeType, @Nullable Map<String, Object> hints) {
 
 		Assert.notNull(tokens, "'tokens' must not be null");
 		Assert.notNull(elementType, "'elementType' must not be null");

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

@@ -34,8 +34,9 @@
 import org.springframework.util.Assert;
 
 /**
- * Function that transforms an arbitrary split byte stream representing JSON objects into a
- * {@code Flux<TokenBuffer>}, where each token buffer is a well-formed JSON object.
+ * {@link Function} to transform a JSON stream of arbitrary size, byte array
+ * chunks into a {@code Flux<TokenBuffer>} where each token buffer is a
+ * well-formed JSON object.
  *
  * @author Arjen Poutsma
  * @since 5.0
@@ -53,14 +54,16 @@ class Jackson2Tokenizer implements Function<DataBuffer, Flux<TokenBuffer>> {
 	private int arrayDepth;
 
 	// TODO: change to ByteBufferFeeder when supported by Jackson
-	private ByteArrayFeeder inputFeeder;
+	private final ByteArrayFeeder inputFeeder;
+
 
 	/**
 	 * Create a new instance of the {@code Jackson2Tokenizer}.
 	 * @param parser the non-blocking parser, obtained via
 	 * {@link com.fasterxml.jackson.core.JsonFactory#createNonBlockingByteArrayParser}
-	 * @param tokenizeArrayElements if {@code true} and the "top level" JSON object is an array,
-	 * each of its elements is returned individually and immediately after it was fully received
+	 * @param tokenizeArrayElements if {@code true} and the "top level" JSON
+	 * object is an array, each element is returned individually, immediately
+	 * after it is received.
 	 */
 	public Jackson2Tokenizer(JsonParser parser, boolean tokenizeArrayElements) {
 		Assert.notNull(parser, "'parser' must not be null");
@@ -71,6 +74,7 @@ public Jackson2Tokenizer(JsonParser parser, boolean tokenizeArrayElements) {
 		this.inputFeeder = (ByteArrayFeeder) this.parser.getNonBlockingInputFeeder();
 	}
 
+
 	@Override
 	public Flux<TokenBuffer> apply(DataBuffer dataBuffer) {
 		byte[] bytes = new byte[dataBuffer.readableByteCount()];
@@ -86,7 +90,7 @@ public Flux<TokenBuffer> apply(DataBuffer dataBuffer) {
 				if (token == JsonToken.NOT_AVAILABLE) {
 					break;
 				}
-				calculateDepth(token);
+				updateDepth(token);
 
 				if (!this.tokenizeArrayElements) {
 					processTokenNormal(token, result);
@@ -106,11 +110,7 @@ public Flux<TokenBuffer> apply(DataBuffer dataBuffer) {
 		}
 	}
 
-	public void endOfInput() {
-		this.inputFeeder.endOfInput();
-	}
-
-	private void calculateDepth(JsonToken token) {
+	private void updateDepth(JsonToken token) {
 		switch (token) {
 			case START_OBJECT:
 				this.objectDepth++;
@@ -149,7 +149,10 @@ private void processTokenArray(JsonToken token, List<TokenBuffer> result) throws
 			result.add(this.tokenBuffer);
 			this.tokenBuffer = new TokenBuffer(this.parser);
 		}
+	}
 
+	public void endOfInput() {
+		this.inputFeeder.endOfInput();
 	}
 
 }