/* * Copyright (C) 2014 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 android.net; import android.net.LinkAddress; import android.os.Parcelable; import android.os.Parcel; import java.net.InetAddress; import java.net.UnknownHostException; import java.util.ArrayList; import java.util.List; import java.util.Objects; /** * Class that describes static IP configuration. * * This class is different from LinkProperties because it represents * configuration intent. The general contract is that if we can represent * a configuration here, then we should be able to configure it on a network. * The intent is that it closely match the UI we have for configuring networks. * * In contrast, LinkProperties represents current state. It is much more * expressive. For example, it supports multiple IP addresses, multiple routes, * stacked interfaces, and so on. Because LinkProperties is so expressive, * using it to represent configuration intent as well as current state causes * problems. For example, we could unknowingly save a configuration that we are * not in fact capable of applying, or we could save a configuration that the * UI cannot display, which has the potential for malicious code to hide * hostile or unexpected configuration from the user: see, for example, * http://b/12663469 and http://b/16893413 . * * @hide */ public class StaticIpConfiguration implements Parcelable { public LinkAddress ipAddress; public InetAddress gateway; public final ArrayList dnsServers; public String domains; public StaticIpConfiguration() { dnsServers = new ArrayList(); } public StaticIpConfiguration(StaticIpConfiguration source) { this(); if (source != null) { // All of these except dnsServers are immutable, so no need to make copies. ipAddress = source.ipAddress; gateway = source.gateway; dnsServers.addAll(source.dnsServers); domains = source.domains; } } public void clear() { ipAddress = null; gateway = null; dnsServers.clear(); domains = null; } /** * Returns the network routes specified by this object. Will typically include a * directly-connected route for the IP address's local subnet and a default route. */ public List getRoutes(String iface) { List routes = new ArrayList(2); if (ipAddress != null) { routes.add(new RouteInfo(ipAddress, null, iface)); } if (gateway != null) { routes.add(new RouteInfo((LinkAddress) null, gateway, iface)); } return routes; } /** * Returns a LinkProperties object expressing the data in this object. Note that the information * contained in the LinkProperties will not be a complete picture of the link's configuration, * because any configuration information that is obtained dynamically by the network (e.g., * IPv6 configuration) will not be included. */ public LinkProperties toLinkProperties(String iface) { LinkProperties lp = new LinkProperties(); lp.setInterfaceName(iface); if (ipAddress != null) { lp.addLinkAddress(ipAddress); } for (RouteInfo route : getRoutes(iface)) { lp.addRoute(route); } for (InetAddress dns : dnsServers) { lp.addDnsServer(dns); } return lp; } public String toString() { StringBuffer str = new StringBuffer(); str.append("IP address "); if (ipAddress != null ) str.append(ipAddress).append(" "); str.append("Gateway "); if (gateway != null) str.append(gateway.getHostAddress()).append(" "); str.append(" DNS servers: ["); for (InetAddress dnsServer : dnsServers) { str.append(" ").append(dnsServer.getHostAddress()); } str.append(" ] Domains"); if (domains != null) str.append(domains); return str.toString(); } public int hashCode() { int result = 13; result = 47 * result + (ipAddress == null ? 0 : ipAddress.hashCode()); result = 47 * result + (gateway == null ? 0 : gateway.hashCode()); result = 47 * result + (domains == null ? 0 : domains.hashCode()); result = 47 * result + dnsServers.hashCode(); return result; } @Override public boolean equals(Object obj) { if (this == obj) return true; if (!(obj instanceof StaticIpConfiguration)) return false; StaticIpConfiguration other = (StaticIpConfiguration) obj; return other != null && Objects.equals(ipAddress, other.ipAddress) && Objects.equals(gateway, other.gateway) && dnsServers.equals(other.dnsServers) && Objects.equals(domains, other.domains); } /** Implement the Parcelable interface */ public static Creator CREATOR = new Creator() { public StaticIpConfiguration createFromParcel(Parcel in) { StaticIpConfiguration s = new StaticIpConfiguration(); readFromParcel(s, in); return s; } public StaticIpConfiguration[] newArray(int size) { return new StaticIpConfiguration[size]; } }; /** Implement the Parcelable interface */ public int describeContents() { return 0; } /** Implement the Parcelable interface */ public void writeToParcel(Parcel dest, int flags) { dest.writeParcelable(ipAddress, flags); NetworkUtils.parcelInetAddress(dest, gateway, flags); dest.writeInt(dnsServers.size()); for (InetAddress dnsServer : dnsServers) { NetworkUtils.parcelInetAddress(dest, dnsServer, flags); } } protected static void readFromParcel(StaticIpConfiguration s, Parcel in) { s.ipAddress = in.readParcelable(null); s.gateway = NetworkUtils.unparcelInetAddress(in); s.dnsServers.clear(); int size = in.readInt(); for (int i = 0; i < size; i++) { s.dnsServers.add(NetworkUtils.unparcelInetAddress(in)); } } }