/*
* Copyright 2013 Netflix, Inc.
*
* 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 java.util.Collection;
import java.util.Collections;
import java.util.LinkedHashMap;
import java.util.Map;
import static feign.Util.checkNotNull;
import static feign.Util.valuesOrEmpty;
/**
* An immutable request to an http server.
*
*
Note
*
* Since {@link Feign} is designed for non-binary apis, and expectations are
* that any request can be replayed, we only support a String body.
*/
public final class Request {
private final String method;
private final String url;
private final Map> headers;
private final String body;
Request(String method, String url, Map> headers, String body) {
this.method = checkNotNull(method, "method of %s", url);
this.url = checkNotNull(url, "url");
LinkedHashMap> copyOf = new LinkedHashMap>();
copyOf.putAll(checkNotNull(headers, "headers of %s %s", method, url));
this.headers = Collections.unmodifiableMap(copyOf);
this.body = body; // nullable
}
/* Method to invoke on the server. */
public String method() {
return method;
}
/* Fully resolved URL including query. */
public String url() {
return url;
}
/* Ordered list of headers that will be sent to the server. */
public Map> headers() {
return headers;
}
/* If present, this is the replayable body to send to the server. */
public String body() {
return body;
}
/* Controls the per-request settings currently required to be implemented by all {@link Client clients} */
public static class Options {
private final int connectTimeoutMillis;
private final int readTimeoutMillis;
public Options(int connectTimeoutMillis, int readTimeoutMillis) {
this.connectTimeoutMillis = connectTimeoutMillis;
this.readTimeoutMillis = readTimeoutMillis;
}
public Options() {
this(10 * 1000, 60 * 1000);
}
/**
* Defaults to 10 seconds. {@code 0} implies no timeout.
*
* @see java.net.HttpURLConnection#getConnectTimeout()
*/
public int connectTimeoutMillis() {
return connectTimeoutMillis;
}
/**
* Defaults to 60 seconds. {@code 0} implies no timeout.
*
* @see java.net.HttpURLConnection#getReadTimeout()
*/
public int readTimeoutMillis() {
return readTimeoutMillis;
}
}
@Override public String toString() {
StringBuilder builder = new StringBuilder();
builder.append(method).append(' ').append(url).append(" HTTP/1.1\n");
for (String field : headers.keySet()) {
for (String value : valuesOrEmpty(headers, field)) {
builder.append(field).append(": ").append(value).append('\n');
}
}
if (body != null) {
builder.append('\n').append(body);
}
return builder.toString();
}
}