Home | History | Annotate | Download | only in okhttp 
      1 /*
      2  * Copyright (C) 2012 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 package com.squareup.okhttp;
     17 
     18 import java.net.Proxy;
     19 import java.net.UnknownHostException;
     20 import javax.net.ssl.HostnameVerifier;
     21 import javax.net.ssl.SSLSocketFactory;
     22 
     23 import static com.squareup.okhttp.internal.Util.equal;
     24 
     25 /**
     26  * A specification for a connection to an origin server. For simple connections,
     27  * this is the server's hostname and port. If an explicit proxy is requested (or
     28  * {@link Proxy#NO_PROXY no proxy} is explicitly requested), this also includes
     29  * that proxy information. For secure connections the address also includes the
     30  * SSL socket factory and hostname verifier.
     31  *
     32  * <p>HTTP requests that share the same {@code Address} may also share the same
     33  * {@link Connection}.
     34  */
     35 public final class Address {
     36   final Proxy proxy;
     37   final String uriHost;
     38   final int uriPort;
     39   final SSLSocketFactory sslSocketFactory;
     40   final HostnameVerifier hostnameVerifier;
     41 
     42   public Address(String uriHost, int uriPort, SSLSocketFactory sslSocketFactory,
     43       HostnameVerifier hostnameVerifier, Proxy proxy) throws UnknownHostException {
     44     if (uriHost == null) throw new NullPointerException("uriHost == null");
     45     if (uriPort <= 0) throw new IllegalArgumentException("uriPort <= 0: " + uriPort);
     46     this.proxy = proxy;
     47     this.uriHost = uriHost;
     48     this.uriPort = uriPort;
     49     this.sslSocketFactory = sslSocketFactory;
     50     this.hostnameVerifier = hostnameVerifier;
     51   }
     52 
     53   /** Returns the hostname of the origin server. */
     54   public String getUriHost() {
     55     return uriHost;
     56   }
     57 
     58   /**
     59    * Returns the port of the origin server; typically 80 or 443. Unlike
     60    * may {@code getPort()} accessors, this method never returns -1.
     61    */
     62   public int getUriPort() {
     63     return uriPort;
     64   }
     65 
     66   /**
     67    * Returns the SSL socket factory, or null if this is not an HTTPS
     68    * address.
     69    */
     70   public SSLSocketFactory getSslSocketFactory() {
     71     return sslSocketFactory;
     72   }
     73 
     74   /**
     75    * Returns the hostname verifier, or null if this is not an HTTPS
     76    * address.
     77    */
     78   public HostnameVerifier getHostnameVerifier() {
     79     return hostnameVerifier;
     80   }
     81 
     82   /**
     83    * Returns this address's explicitly-specified HTTP proxy, or null to
     84    * delegate to the HTTP client's proxy selector.
     85    */
     86   public Proxy getProxy() {
     87     return proxy;
     88   }
     89 
     90   @Override public boolean equals(Object other) {
     91     if (other instanceof Address) {
     92       Address that = (Address) other;
     93       return equal(this.proxy, that.proxy)
     94           && this.uriHost.equals(that.uriHost)
     95           && this.uriPort == that.uriPort
     96           && equal(this.sslSocketFactory, that.sslSocketFactory)
     97           && equal(this.hostnameVerifier, that.hostnameVerifier);
     98     }
     99     return false;
    100   }
    101 
    102   @Override public int hashCode() {
    103     int result = 17;
    104     result = 31 * result + uriHost.hashCode();
    105     result = 31 * result + uriPort;
    106     result = 31 * result + (sslSocketFactory != null ? sslSocketFactory.hashCode() : 0);
    107     result = 31 * result + (hostnameVerifier != null ? hostnameVerifier.hashCode() : 0);
    108     result = 31 * result + (proxy != null ? proxy.hashCode() : 0);
    109     return result;
    110   }
    111 }
    112