forked from upstream-mirrors/quik
Made QKSMS open source
This commit is contained in:
@@ -0,0 +1,202 @@
|
||||
/*
|
||||
* Copyright (C) 2010 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.location;
|
||||
|
||||
import android.os.Parcel;
|
||||
import android.os.Parcelable;
|
||||
import android.os.SystemClock;
|
||||
|
||||
import java.util.Locale;
|
||||
|
||||
/**
|
||||
* This class wraps the country information.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public class Country implements Parcelable {
|
||||
/**
|
||||
* The country code came from the mobile network
|
||||
*/
|
||||
public static final int COUNTRY_SOURCE_NETWORK = 0;
|
||||
|
||||
/**
|
||||
* The country code came from the location service
|
||||
*/
|
||||
public static final int COUNTRY_SOURCE_LOCATION = 1;
|
||||
|
||||
/**
|
||||
* The country code was read from the SIM card
|
||||
*/
|
||||
public static final int COUNTRY_SOURCE_SIM = 2;
|
||||
|
||||
/**
|
||||
* The country code came from the system locale setting
|
||||
*/
|
||||
public static final int COUNTRY_SOURCE_LOCALE = 3;
|
||||
|
||||
/**
|
||||
* The ISO 3166-1 two letters country code.
|
||||
*/
|
||||
private final String mCountryIso;
|
||||
|
||||
/**
|
||||
* Where the country code came from.
|
||||
*/
|
||||
private final int mSource;
|
||||
|
||||
private int mHashCode;
|
||||
|
||||
/**
|
||||
* Time that this object was created (which we assume to be the time that the source was
|
||||
* consulted). This time is in milliseconds since boot up.
|
||||
*/
|
||||
private final long mTimestamp;
|
||||
|
||||
/**
|
||||
* @param countryIso the ISO 3166-1 two letters country code.
|
||||
* @param source where the countryIso came from, could be one of below
|
||||
* values
|
||||
* <p>
|
||||
* <ul>
|
||||
* <li>{@link #COUNTRY_SOURCE_NETWORK}</li>
|
||||
* <li>{@link #COUNTRY_SOURCE_LOCATION}</li>
|
||||
* <li>{@link #COUNTRY_SOURCE_SIM}</li>
|
||||
* <li>{@link #COUNTRY_SOURCE_LOCALE}</li>
|
||||
* </ul>
|
||||
*/
|
||||
public Country(final String countryIso, final int source) {
|
||||
if (countryIso == null || source < COUNTRY_SOURCE_NETWORK
|
||||
|| source > COUNTRY_SOURCE_LOCALE) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
mCountryIso = countryIso.toUpperCase(Locale.US);
|
||||
mSource = source;
|
||||
mTimestamp = SystemClock.elapsedRealtime();
|
||||
}
|
||||
|
||||
private Country(final String countryIso, final int source, long timestamp) {
|
||||
if (countryIso == null || source < COUNTRY_SOURCE_NETWORK
|
||||
|| source > COUNTRY_SOURCE_LOCALE) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
mCountryIso = countryIso.toUpperCase(Locale.US);
|
||||
mSource = source;
|
||||
mTimestamp = timestamp;
|
||||
}
|
||||
|
||||
public Country(Country country) {
|
||||
mCountryIso = country.mCountryIso;
|
||||
mSource = country.mSource;
|
||||
mTimestamp = country.mTimestamp;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return the ISO 3166-1 two letters country code
|
||||
*/
|
||||
public final String getCountryIso() {
|
||||
return mCountryIso;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return where the country code came from, could be one of below values
|
||||
* <p>
|
||||
* <ul>
|
||||
* <li>{@link #COUNTRY_SOURCE_NETWORK}</li>
|
||||
* <li>{@link #COUNTRY_SOURCE_LOCATION}</li>
|
||||
* <li>{@link #COUNTRY_SOURCE_SIM}</li>
|
||||
* <li>{@link #COUNTRY_SOURCE_LOCALE}</li>
|
||||
* </ul>
|
||||
*/
|
||||
public final int getSource() {
|
||||
return mSource;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the time that this object was created (which we assume to be the time that the source
|
||||
* was consulted).
|
||||
*/
|
||||
public final long getTimestamp() {
|
||||
return mTimestamp;
|
||||
}
|
||||
|
||||
public static final Parcelable.Creator<Country> CREATOR = new Parcelable.Creator<Country>() {
|
||||
public Country createFromParcel(Parcel in) {
|
||||
return new Country(in.readString(), in.readInt(), in.readLong());
|
||||
}
|
||||
|
||||
public Country[] newArray(int size) {
|
||||
return new Country[size];
|
||||
}
|
||||
};
|
||||
|
||||
public int describeContents() {
|
||||
return 0;
|
||||
}
|
||||
|
||||
public void writeToParcel(Parcel parcel, int flags) {
|
||||
parcel.writeString(mCountryIso);
|
||||
parcel.writeInt(mSource);
|
||||
parcel.writeLong(mTimestamp);
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns true if this {@link Country} is equivalent to the given object. This ignores
|
||||
* the timestamp value and just checks for equivalence of countryIso and source values.
|
||||
* Returns false otherwise.
|
||||
*/
|
||||
@Override
|
||||
public boolean equals(Object object) {
|
||||
if (object == this) {
|
||||
return true;
|
||||
}
|
||||
if (object instanceof Country) {
|
||||
Country c = (Country) object;
|
||||
// No need to check the equivalence of the timestamp
|
||||
return mCountryIso.equals(c.getCountryIso()) && mSource == c.getSource();
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
@Override
|
||||
public int hashCode() {
|
||||
int hash = mHashCode;
|
||||
if (hash == 0) {
|
||||
hash = 17;
|
||||
hash = hash * 13 + mCountryIso.hashCode();
|
||||
hash = hash * 13 + mSource;
|
||||
mHashCode = hash;
|
||||
}
|
||||
return mHashCode;
|
||||
}
|
||||
|
||||
/**
|
||||
* Compare the specified country to this country object ignoring the source
|
||||
* and timestamp fields, return true if the countryIso fields are equal
|
||||
*
|
||||
* @param country the country to compare
|
||||
* @return true if the specified country's countryIso field is equal to this
|
||||
* country's, false otherwise.
|
||||
*/
|
||||
public boolean equalsIgnoreSource(Country country) {
|
||||
return country != null && mCountryIso.equals(country.getCountryIso());
|
||||
}
|
||||
|
||||
@Override
|
||||
public String toString() {
|
||||
return "Country {ISO=" + mCountryIso + ", source=" + mSource + ", time=" + mTimestamp + "}";
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,137 @@
|
||||
/*
|
||||
* Copyright (C) 2010, 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.location;
|
||||
|
||||
import android.os.Handler;
|
||||
import android.os.Looper;
|
||||
|
||||
import java.util.HashMap;
|
||||
|
||||
/**
|
||||
* This class provides access to the system country detector service. This
|
||||
* service allows applications to obtain the country that the user is in.
|
||||
* <p>
|
||||
* The country will be detected in order of reliability, like
|
||||
* <ul>
|
||||
* <li>Mobile network</li>
|
||||
* <li>Location</li>
|
||||
* <li>SIM's country</li>
|
||||
* <li>Phone's locale</li>
|
||||
* </ul>
|
||||
* <p>
|
||||
* Call the {@link #detectCountry()} to get the available country immediately.
|
||||
* <p>
|
||||
* To be notified of the future country change, use the
|
||||
* {@link #addCountryListener}
|
||||
* <p>
|
||||
* <p>
|
||||
* You do not instantiate this class directly; instead, retrieve it through
|
||||
* {@link android.content.Context#getSystemService
|
||||
* Context.getSystemService(Context.COUNTRY_DETECTOR)}.
|
||||
* <p>
|
||||
* Both ACCESS_FINE_LOCATION and ACCESS_COARSE_LOCATION permissions are needed.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public class CountryDetector {
|
||||
|
||||
/**
|
||||
* The class to wrap the ICountryListener.Stub and CountryListener objects
|
||||
* together. The CountryListener will be notified through the specific
|
||||
* looper once the country changed and detected.
|
||||
*/
|
||||
private final static class ListenerTransport implements ICountryListener {
|
||||
|
||||
private final CountryListener mListener;
|
||||
|
||||
private final Handler mHandler;
|
||||
|
||||
public ListenerTransport(CountryListener listener, Looper looper) {
|
||||
mListener = listener;
|
||||
if (looper != null) {
|
||||
mHandler = new Handler(looper);
|
||||
} else {
|
||||
mHandler = new Handler();
|
||||
}
|
||||
}
|
||||
|
||||
public void onCountryDetected(final Country country) {
|
||||
mHandler.post(new Runnable() {
|
||||
public void run() {
|
||||
mListener.onCountryDetected(country);
|
||||
}
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
private final static String TAG = "CountryDetector";
|
||||
private final ICountryDetector mService;
|
||||
private final HashMap<CountryListener, ListenerTransport> mListeners;
|
||||
|
||||
/**
|
||||
* @hide - hide this constructor because it has a parameter of type
|
||||
* ICountryDetector, which is a system private class. The right way to
|
||||
* create an instance of this class is using the factory
|
||||
* Context.getSystemService.
|
||||
*/
|
||||
public CountryDetector(ICountryDetector service) {
|
||||
mService = service;
|
||||
mListeners = new HashMap<CountryListener, ListenerTransport>();
|
||||
}
|
||||
|
||||
/**
|
||||
* Start detecting the country that the user is in.
|
||||
*
|
||||
* @return the country if it is available immediately, otherwise null will
|
||||
* be returned.
|
||||
*/
|
||||
public Country detectCountry() {
|
||||
return mService.detectCountry();
|
||||
}
|
||||
|
||||
/**
|
||||
* Add a listener to receive the notification when the country is detected
|
||||
* or changed.
|
||||
*
|
||||
* @param listener will be called when the country is detected or changed.
|
||||
* @param looper a Looper object whose message queue will be used to
|
||||
* implement the callback mechanism. If looper is null then the
|
||||
* callbacks will be called on the main thread.
|
||||
*/
|
||||
public void addCountryListener(CountryListener listener, Looper looper) {
|
||||
synchronized (mListeners) {
|
||||
if (!mListeners.containsKey(listener)) {
|
||||
ListenerTransport transport = new ListenerTransport(listener, looper);
|
||||
mService.addCountryListener(transport);
|
||||
mListeners.put(listener, transport);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Remove the listener
|
||||
*/
|
||||
public void removeCountryListener(CountryListener listener) {
|
||||
synchronized (mListeners) {
|
||||
ListenerTransport transport = mListeners.get(listener);
|
||||
if (transport != null) {
|
||||
mListeners.remove(listener);
|
||||
mService.removeCountryListener(transport);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,30 @@
|
||||
/*
|
||||
* Copyright (C) 2010 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.location;
|
||||
|
||||
/**
|
||||
* The listener for receiving the notification when the country is detected or
|
||||
* changed
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public interface CountryListener {
|
||||
/**
|
||||
* @param country the changed or detected country.
|
||||
*/
|
||||
void onCountryDetected(Country country);
|
||||
}
|
||||
@@ -0,0 +1,41 @@
|
||||
/*
|
||||
* Copyright (C) 2010, 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.location;
|
||||
|
||||
/**
|
||||
* The API for detecting the country where the user is.
|
||||
*
|
||||
* {@hide}
|
||||
*/
|
||||
interface ICountryDetector
|
||||
{
|
||||
/**
|
||||
* Start detecting the country that the user is in.
|
||||
* @return the country if it is available immediately, otherwise null will be returned.
|
||||
*/
|
||||
Country detectCountry();
|
||||
|
||||
/**
|
||||
* Add a listener to receive the notification when the country is detected or changed.
|
||||
*/
|
||||
void addCountryListener(ICountryListener listener);
|
||||
|
||||
/**
|
||||
* Remove the listener
|
||||
*/
|
||||
void removeCountryListener(ICountryListener listener);
|
||||
}
|
||||
@@ -0,0 +1,26 @@
|
||||
/*
|
||||
* Copyright (C) 2010, 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.location;
|
||||
|
||||
/**
|
||||
* {@hide}
|
||||
*/
|
||||
|
||||
interface ICountryListener
|
||||
{
|
||||
void onCountryDetected(Country country);
|
||||
}
|
||||
Reference in New Issue
Block a user