/*
* Copyright (C) 2012 The Android Open Source Project
*
* 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 com.squareup.okhttp;
import com.squareup.okhttp.internal.Util;
import java.net.Proxy;
import java.net.ProxySelector;
import java.util.List;
import javax.net.SocketFactory;
import javax.net.ssl.HostnameVerifier;
import javax.net.ssl.SSLSocketFactory;
import static com.squareup.okhttp.internal.Util.equal;
/**
* A specification for a connection to an origin server. For simple connections,
* this is the server's hostname and port. If an explicit proxy is requested (or
* {@linkplain Proxy#NO_PROXY no proxy} is explicitly requested), this also includes
* that proxy information. For secure connections the address also includes the
* SSL socket factory and hostname verifier.
*
*
HTTP requests that share the same {@code Address} may also share the same
* {@link Connection}.
*/
public final class Address {
final Proxy proxy;
final String uriHost;
final int uriPort;
final SocketFactory socketFactory;
final SSLSocketFactory sslSocketFactory;
final HostnameVerifier hostnameVerifier;
final CertificatePinner certificatePinner;
final Authenticator authenticator;
final List protocols;
final List connectionSpecs;
final ProxySelector proxySelector;
public Address(String uriHost, int uriPort, SocketFactory socketFactory,
SSLSocketFactory sslSocketFactory, HostnameVerifier hostnameVerifier,
CertificatePinner certificatePinner, Authenticator authenticator, Proxy proxy,
List protocols, List connectionSpecs, ProxySelector proxySelector) {
if (uriHost == null) throw new NullPointerException("uriHost == null");
if (uriPort <= 0) throw new IllegalArgumentException("uriPort <= 0: " + uriPort);
if (authenticator == null) throw new IllegalArgumentException("authenticator == null");
if (protocols == null) throw new IllegalArgumentException("protocols == null");
if (proxySelector == null) throw new IllegalArgumentException("proxySelector == null");
this.proxy = proxy;
this.uriHost = uriHost;
this.uriPort = uriPort;
this.socketFactory = socketFactory;
this.sslSocketFactory = sslSocketFactory;
this.hostnameVerifier = hostnameVerifier;
this.certificatePinner = certificatePinner;
this.authenticator = authenticator;
this.protocols = Util.immutableList(protocols);
this.connectionSpecs = Util.immutableList(connectionSpecs);
this.proxySelector = proxySelector;
}
/** Returns the hostname of the origin server. */
public String getRfc2732Host() {
return uriHost;
}
/**
* Returns the port of the origin server; typically 80 or 443. Unlike
* may {@code getPort()} accessors, this method never returns -1.
*/
public int getUriPort() {
return uriPort;
}
/** Returns the socket factory for new connections. */
public SocketFactory getSocketFactory() {
return socketFactory;
}
/**
* Returns the SSL socket factory, or null if this is not an HTTPS
* address.
*/
public SSLSocketFactory getSslSocketFactory() {
return sslSocketFactory;
}
/**
* Returns the hostname verifier, or null if this is not an HTTPS
* address.
*/
public HostnameVerifier getHostnameVerifier() {
return hostnameVerifier;
}
/**
* Returns the client's authenticator. This method never returns null.
*/
public Authenticator getAuthenticator() {
return authenticator;
}
/**
* Returns the protocols the client supports. This method always returns a
* non-null list that contains minimally {@link Protocol#HTTP_1_1}.
*/
public List getProtocols() {
return protocols;
}
public List getConnectionSpecs() {
return connectionSpecs;
}
/**
* Returns this address's explicitly-specified HTTP proxy, or null to
* delegate to the {@linkplain #getProxySelector proxy selector}.
*/
public Proxy getProxy() {
return proxy;
}
/**
* Returns this address's proxy selector. Only used if the proxy is null. If none of this
* selector's proxies are reachable, a direct connection will be attempted.
*/
public ProxySelector getProxySelector() {
return proxySelector;
}
/**
* Returns this address's certificate pinner. Only used for secure connections.
*/
public CertificatePinner getCertificatePinner() {
return certificatePinner;
}
@Override public boolean equals(Object other) {
if (other instanceof Address) {
Address that = (Address) other;
return equal(this.proxy, that.proxy)
&& this.uriHost.equals(that.uriHost)
&& this.uriPort == that.uriPort
&& equal(this.sslSocketFactory, that.sslSocketFactory)
&& equal(this.hostnameVerifier, that.hostnameVerifier)
&& equal(this.certificatePinner, that.certificatePinner)
&& equal(this.authenticator, that.authenticator)
&& equal(this.protocols, that.protocols)
&& equal(this.connectionSpecs, that.connectionSpecs)
&& equal(this.proxySelector, that.proxySelector);
}
return false;
}
@Override public int hashCode() {
int result = 17;
result = 31 * result + (proxy != null ? proxy.hashCode() : 0);
result = 31 * result + uriHost.hashCode();
result = 31 * result + uriPort;
result = 31 * result + (sslSocketFactory != null ? sslSocketFactory.hashCode() : 0);
result = 31 * result + (hostnameVerifier != null ? hostnameVerifier.hashCode() : 0);
result = 31 * result + (certificatePinner != null ? certificatePinner.hashCode() : 0);
result = 31 * result + authenticator.hashCode();
result = 31 * result + protocols.hashCode();
result = 31 * result + connectionSpecs.hashCode();
result = 31 * result + proxySelector.hashCode();
return result;
}
}