/*
* Copyright © 2012 The Feign Authors ([email protected])
*
* 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 feign;
import static feign.Util.*;
import feign.Request.ProtocolVersion;
import java.io.*;
import java.nio.charset.Charset;
import java.nio.charset.StandardCharsets;
import java.util.*;
/** An immutable response to an http invocation which only returns string content. */
public final class Response implements Closeable {
private final int status;
private final String reason;
private final Map See rfc2616
*/
public int status() {
return status;
}
/**
* Nullable and not set when using http/2 See ... See ...
*/
public String reason() {
return reason;
}
/** Returns a case-insensitive mapping of header names to their values. */
public Map
*
*
* Note
* This is an integer as most implementations cannot do bodies greater than 2GB.
*/
Integer length();
/** True if {@link #asInputStream()} and {@link #asReader()} can be called more than once. */
boolean isRepeatable();
/** It is the responsibility of the caller to close the stream. */
InputStream asInputStream() throws IOException;
/**
* It is the responsibility of the caller to close the stream.
*
* @deprecated favor {@link Body#asReader(Charset)}
*/
@Deprecated
default Reader asReader() throws IOException {
return asReader(StandardCharsets.UTF_8);
}
/** It is the responsibility of the caller to close the stream. */
Reader asReader(Charset charset) throws IOException;
}
private static final class InputStreamBody implements Response.Body {
private final InputStream inputStream;
private final Integer length;
private InputStreamBody(InputStream inputStream, Integer length) {
this.inputStream = inputStream;
this.length = length;
}
private static Body orNull(InputStream inputStream, Integer length) {
if (inputStream == null) {
return null;
}
return new InputStreamBody(inputStream, length);
}
@Override
public Integer length() {
return length;
}
@Override
public boolean isRepeatable() {
return false;
}
@Override
public InputStream asInputStream() {
return inputStream;
}
@SuppressWarnings("deprecation")
@Override
public Reader asReader() {
return new InputStreamReader(inputStream, UTF_8);
}
@Override
public Reader asReader(Charset charset) {
checkNotNull(charset, "charset should not be null");
return new InputStreamReader(inputStream, charset);
}
@Override
public void close() throws IOException {
inputStream.close();
}
}
private static final class ByteArrayBody implements Response.Body {
private final byte[] data;
public ByteArrayBody(byte[] data) {
this.data = data;
}
private static Body orNull(byte[] data) {
if (data == null) {
return null;
}
return new ByteArrayBody(data);
}
private static Body orNull(String text, Charset charset) {
if (text == null) {
return null;
}
checkNotNull(charset, "charset");
return new ByteArrayBody(text.getBytes(charset));
}
@Override
public Integer length() {
return data.length;
}
@Override
public boolean isRepeatable() {
return true;
}
@Override
public InputStream asInputStream() {
return new ByteArrayInputStream(data);
}
@SuppressWarnings("deprecation")
@Override
public Reader asReader() {
return new InputStreamReader(asInputStream(), UTF_8);
}
@Override
public Reader asReader(Charset charset) {
checkNotNull(charset, "charset should not be null");
return new InputStreamReader(asInputStream(), charset);
}
@Override
public void close() {}
}
}