2 * Copyright (C) 2014 The Android Open Source Project
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
8 * http://www.apache.org/licenses/LICENSE-2.0
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
19 import android.os.Parcel;
20 import android.os.Parcelable;
22 import java.util.Objects;
23 import java.util.regex.Pattern;
26 * Information identifying a Wi-Fi network.
31 public class WifiKey implements Parcelable {
33 // Patterns used for validation.
34 private static final Pattern SSID_PATTERN = Pattern.compile("(\".*\")|(0x[\\p{XDigit}]+)");
35 private static final Pattern BSSID_PATTERN =
36 Pattern.compile("([\\p{XDigit}]{2}:){5}[\\p{XDigit}]{2}");
39 * The service set identifier (SSID) of an 802.11 network. If the SSID can be decoded as
40 * UTF-8, it will be surrounded by double quotation marks. Otherwise, it will be a string of
41 * hex digits starting with 0x.
43 public final String ssid;
46 * The basic service set identifier (BSSID) of an access point for this network. This will
47 * be in the form of a six-byte MAC address: {@code XX:XX:XX:XX:XX:XX}, where each X is a
50 public final String bssid;
53 * Construct a new {@link WifiKey} for the given Wi-Fi SSID/BSSID pair.
55 * @param ssid the service set identifier (SSID) of an 802.11 network. If the SSID can be
56 * decoded as UTF-8, it should be surrounded by double quotation marks. Otherwise,
57 * it should be a string of hex digits starting with 0x.
58 * @param bssid the basic service set identifier (BSSID) of this network's access point.
59 * This should be in the form of a six-byte MAC address: {@code XX:XX:XX:XX:XX:XX},
60 * where each X is a hexadecimal digit.
61 * @throws IllegalArgumentException if either the SSID or BSSID is invalid.
63 public WifiKey(String ssid, String bssid) {
64 if (!SSID_PATTERN.matcher(ssid).matches()) {
65 throw new IllegalArgumentException("Invalid ssid: " + ssid);
67 if (!BSSID_PATTERN.matcher(bssid).matches()) {
68 throw new IllegalArgumentException("Invalid bssid: " + bssid);
74 private WifiKey(Parcel in) {
75 ssid = in.readString();
76 bssid = in.readString();
80 public int describeContents() {
85 public void writeToParcel(Parcel out, int flags) {
86 out.writeString(ssid);
87 out.writeString(bssid);
91 public boolean equals(Object o) {
92 if (this == o) return true;
93 if (o == null || getClass() != o.getClass()) return false;
95 WifiKey wifiKey = (WifiKey) o;
97 return Objects.equals(ssid, wifiKey.ssid) && Objects.equals(bssid, wifiKey.bssid);
101 public int hashCode() {
102 return Objects.hash(ssid, bssid);
106 public String toString() {
107 return "WifiKey[SSID=" + ssid + ",BSSID=" + bssid + "]";
110 public static final Creator<WifiKey> CREATOR =
111 new Creator<WifiKey>() {
113 public WifiKey createFromParcel(Parcel in) {
114 return new WifiKey(in);
118 public WifiKey[] newArray(int size) {
119 return new WifiKey[size];