1 /* 2 * Copyright (C) 2008 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 17 package android.net; 18 19 import android.os.Parcel; 20 import android.os.Parcelable; 21 22 import com.google.android.collect.Sets; 23 24 import java.util.HashSet; 25 26 /** 27 * Configuration details for a network interface. 28 * 29 * @hide 30 */ 31 public class InterfaceConfiguration implements Parcelable { 32 private String mHwAddr; 33 private LinkAddress mAddr; 34 private HashSet<String> mFlags = Sets.newHashSet(); 35 36 private static final String FLAG_UP = "up"; 37 private static final String FLAG_DOWN = "down"; 38 39 @Override toString()40 public String toString() { 41 final StringBuilder builder = new StringBuilder(); 42 builder.append("mHwAddr=").append(mHwAddr); 43 builder.append(" mAddr=").append(String.valueOf(mAddr)); 44 builder.append(" mFlags=").append(getFlags()); 45 return builder.toString(); 46 } 47 getFlags()48 public Iterable<String> getFlags() { 49 return mFlags; 50 } 51 hasFlag(String flag)52 public boolean hasFlag(String flag) { 53 validateFlag(flag); 54 return mFlags.contains(flag); 55 } 56 clearFlag(String flag)57 public void clearFlag(String flag) { 58 validateFlag(flag); 59 mFlags.remove(flag); 60 } 61 setFlag(String flag)62 public void setFlag(String flag) { 63 validateFlag(flag); 64 mFlags.add(flag); 65 } 66 67 /** 68 * Set flags to mark interface as up. 69 */ setInterfaceUp()70 public void setInterfaceUp() { 71 mFlags.remove(FLAG_DOWN); 72 mFlags.add(FLAG_UP); 73 } 74 75 /** 76 * Set flags to mark interface as down. 77 */ setInterfaceDown()78 public void setInterfaceDown() { 79 mFlags.remove(FLAG_UP); 80 mFlags.add(FLAG_DOWN); 81 } 82 getLinkAddress()83 public LinkAddress getLinkAddress() { 84 return mAddr; 85 } 86 setLinkAddress(LinkAddress addr)87 public void setLinkAddress(LinkAddress addr) { 88 mAddr = addr; 89 } 90 getHardwareAddress()91 public String getHardwareAddress() { 92 return mHwAddr; 93 } 94 setHardwareAddress(String hwAddr)95 public void setHardwareAddress(String hwAddr) { 96 mHwAddr = hwAddr; 97 } 98 99 /** 100 * This function determines if the interface is up and has a valid IP 101 * configuration (IP address has a non zero octet). 102 * 103 * Note: It is supposed to be quick and hence should not initiate 104 * any network activity 105 */ isActive()106 public boolean isActive() { 107 try { 108 if (hasFlag(FLAG_UP)) { 109 for (byte b : mAddr.getAddress().getAddress()) { 110 if (b != 0) return true; 111 } 112 } 113 } catch (NullPointerException e) { 114 return false; 115 } 116 return false; 117 } 118 119 /** {@inheritDoc} */ describeContents()120 public int describeContents() { 121 return 0; 122 } 123 124 /** {@inheritDoc} */ writeToParcel(Parcel dest, int flags)125 public void writeToParcel(Parcel dest, int flags) { 126 dest.writeString(mHwAddr); 127 if (mAddr != null) { 128 dest.writeByte((byte)1); 129 dest.writeParcelable(mAddr, flags); 130 } else { 131 dest.writeByte((byte)0); 132 } 133 dest.writeInt(mFlags.size()); 134 for (String flag : mFlags) { 135 dest.writeString(flag); 136 } 137 } 138 139 public static final Creator<InterfaceConfiguration> CREATOR = new Creator< 140 InterfaceConfiguration>() { 141 public InterfaceConfiguration createFromParcel(Parcel in) { 142 InterfaceConfiguration info = new InterfaceConfiguration(); 143 info.mHwAddr = in.readString(); 144 if (in.readByte() == 1) { 145 info.mAddr = in.readParcelable(null); 146 } 147 final int size = in.readInt(); 148 for (int i = 0; i < size; i++) { 149 info.mFlags.add(in.readString()); 150 } 151 return info; 152 } 153 154 public InterfaceConfiguration[] newArray(int size) { 155 return new InterfaceConfiguration[size]; 156 } 157 }; 158 validateFlag(String flag)159 private static void validateFlag(String flag) { 160 if (flag.indexOf(' ') >= 0) { 161 throw new IllegalArgumentException("flag contains space: " + flag); 162 } 163 } 164 } 165