/* * Copyright 2002-2016 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 * * http://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.core.codec; import java.nio.CharBuffer; import java.nio.charset.Charset; import java.nio.charset.StandardCharsets; import java.util.ArrayList; import java.util.List; import java.util.Map; import java.util.function.IntPredicate; import org.reactivestreams.Publisher; import reactor.core.publisher.Flux; import reactor.core.publisher.Mono; import org.springframework.core.ResolvableType; import org.springframework.core.io.buffer.DataBuffer; import org.springframework.core.io.buffer.DataBufferUtils; import org.springframework.util.MimeType; import org.springframework.util.MimeTypeUtils; /** * Decode from a bytes stream to a {@code String} stream. * * <p>By default, this decoder will split the received {@link DataBuffer}s * along newline characters ({@code \r\n}), but this can be changed by * passing {@code false} as a constructor argument. * * @author Sebastien Deleuze * @author Brian Clozel * @author Arjen Poutsma * @author Mark Paluch * @since 5.0 * @see CharSequenceEncoder */ public class StringDecoder extends AbstractDecoder<String> { public static final Charset DEFAULT_CHARSET = StandardCharsets.UTF_8; private static final IntPredicate NEWLINE_DELIMITER = b -> b == '\n' || b == '\r'; private final boolean splitOnNewline; /** * Create a {@code StringDecoder} that decodes a bytes stream to a String stream * @param splitOnNewline whether this decoder should split the received data buffers * along newline characters */ private StringDecoder(boolean splitOnNewline, MimeType... mimeTypes) { super(mimeTypes); this.splitOnNewline = splitOnNewline; } @Override public boolean canDecode(ResolvableType elementType, MimeType mimeType) { return (super.canDecode(elementType, mimeType) && String.class.equals(elementType.getRawClass())); } @Override public Flux<String> decode(Publisher<DataBuffer> inputStream, ResolvableType elementType, MimeType mimeType, Map<String, Object> hints) { Flux<DataBuffer> inputFlux = Flux.from(inputStream); if (this.splitOnNewline) { inputFlux = Flux.from(inputStream).flatMap(StringDecoder::splitOnNewline); } return inputFlux.map(buffer -> decodeDataBuffer(buffer, mimeType)); } @Override public Mono<String> decodeToMono(Publisher<DataBuffer> inputStream, ResolvableType elementType, MimeType mimeType, Map<String, Object> hints) { return Flux.from(inputStream) .reduce(DataBuffer::write) .map(buffer -> decodeDataBuffer(buffer, mimeType)); } private static Flux<DataBuffer> splitOnNewline(DataBuffer dataBuffer) { List<DataBuffer> results = new ArrayList<>(); int startIdx = 0; int endIdx; final int limit = dataBuffer.readableByteCount(); do { endIdx = dataBuffer.indexOf(NEWLINE_DELIMITER, startIdx); int length = endIdx != -1 ? endIdx - startIdx + 1 : limit - startIdx; DataBuffer token = dataBuffer.slice(startIdx, length); results.add(DataBufferUtils.retain(token)); startIdx = endIdx + 1; } while (startIdx < limit && endIdx != -1); DataBufferUtils.release(dataBuffer); return Flux.fromIterable(results); } private String decodeDataBuffer(DataBuffer dataBuffer, MimeType mimeType) { Charset charset = getCharset(mimeType); CharBuffer charBuffer = charset.decode(dataBuffer.asByteBuffer()); DataBufferUtils.release(dataBuffer); return charBuffer.toString(); } private Charset getCharset(MimeType mimeType) { if (mimeType != null && mimeType.getCharset() != null) { return mimeType.getCharset(); } else { return DEFAULT_CHARSET; } } /** * Create a {@code StringDecoder} for {@code "text/plain"}. * @param splitOnNewline whether to split the byte stream into lines */ public static StringDecoder textPlainOnly(boolean splitOnNewline) { return new StringDecoder(splitOnNewline, new MimeType("text", "plain", DEFAULT_CHARSET)); } /** * Create a {@code StringDecoder} that supports all MIME types. * @param splitOnNewline whether to split the byte stream into lines */ public static StringDecoder allMimeTypes(boolean splitOnNewline) { return new StringDecoder(splitOnNewline, new MimeType("text", "plain", DEFAULT_CHARSET), MimeTypeUtils.ALL); } }