GsmCellLocation.java revision 41a46718b3deec95661e149b3acea2a9e54016be
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.telephony.gsm; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.telephony.CellLocation; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Represents the cell location on a GSM phone. 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2504e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Savillepublic class GsmCellLocation extends CellLocation { 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mLac; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mCid; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Empty constructor. Initializes the LAC and CID to -1. 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GsmCellLocation() { 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLac = -1; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCid = -1; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Initialize the object from a bundle. 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GsmCellLocation(Bundle bundle) { 419384b145e625b3bb6ff8b829ddb1466e16a78f49Mark Vandevoorde mLac = bundle.getInt("lac", mLac); 429384b145e625b3bb6ff8b829ddb1466e16a78f49Mark Vandevoorde mCid = bundle.getInt("cid", mCid); 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return gsm location area code, -1 if unknown, 0xffff max legal value 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getLac() { 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mLac; 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return gsm cell id, -1 if unknown, 0xffff max legal value 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getCid() { 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mCid; 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Invalidate this object. The location area code and the cell id are set to -1. 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStateInvalid() { 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLac = -1; 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCid = -1; 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the location area code and the cell id. 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setLacAndCid(int lac, int cid) { 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLac = lac; 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCid = cid; 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mLac ^ mCid; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object o) { 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GsmCellLocation s; 8304e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s = (GsmCellLocation)o; 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (ClassCastException ex) { 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (o == null) { 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return equalsHandlesNulls(mLac, s.mLac) && equalsHandlesNulls(mCid, s.mCid); 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return "["+ mLac + "," + mCid + "]"; 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10104e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Test whether two objects hold the same data values or both are null 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param a first obj 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b second obj 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if two objects equal or both are null 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static boolean equalsHandlesNulls(Object a, Object b) { 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (a == null) ? (b == null) : a.equals (b); 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set intent notifier Bundle based on service state 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param m intent notifier Bundle 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void fillInNotifierBundle(Bundle m) { 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.putInt("lac", mLac); 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.putInt("cid", mCid); 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12241a46718b3deec95661e149b3acea2a9e54016beJohn Wang 12341a46718b3deec95661e149b3acea2a9e54016beJohn Wang /** 12441a46718b3deec95661e149b3acea2a9e54016beJohn Wang * @hide 12541a46718b3deec95661e149b3acea2a9e54016beJohn Wang */ 12641a46718b3deec95661e149b3acea2a9e54016beJohn Wang public boolean isEmpty() { 12741a46718b3deec95661e149b3acea2a9e54016beJohn Wang return (mLac == -1 && mCid == -1); 12841a46718b3deec95661e149b3acea2a9e54016beJohn Wang } 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 130