19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 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.content.pm; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.ComponentName; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcel; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcelable; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 23de0ff63700c1836771d797e6c7340b18cb814484Kenny Rootimport java.lang.ref.SoftReference; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.Arrays; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Opaque, immutable representation of a signature associated with an 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * application package. 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class Signature implements Parcelable { 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final byte[] mSignature; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mHashCode; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mHaveHashCode; 34de0ff63700c1836771d797e6c7340b18cb814484Kenny Root private SoftReference<String> mStringRef; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create Signature from an existing raw byte array. 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Signature(byte[] signature) { 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSignature = signature.clone(); 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create Signature from a text representation previously returned by 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #toChars} or {@link #toCharsString()}. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Signature(String text) { 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int N = text.length()/2; 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] sig = new byte[N]; 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char c = text.charAt(i*2); 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte b = (byte)( 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (c >= 'a' ? (c - 'a' + 10) : (c - '0'))<<4); 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project c = text.charAt(i*2 + 1); 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project b |= (byte)(c >= 'a' ? (c - 'a' + 10) : (c - '0')); 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sig[i] = b; 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSignature = sig; 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Encode the Signature as ASCII text. 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public char[] toChars() { 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return toChars(null, null); 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Encode the Signature as ASCII text in to an existing array. 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param existingArray Existing char array or null. 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param outLen Output parameter for the number of characters written in 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the array. 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns either <var>existingArray</var> if it was large enough 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to hold the ASCII representation, or a newly created char[] array if 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * needed. 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public char[] toChars(char[] existingArray, int[] outLen) { 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] sig = mSignature; 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int N = sig.length; 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int N2 = N*2; 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text = existingArray == null || N2 > existingArray.length 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ? new char[N2] : existingArray; 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int j=0; j<N; j++) { 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte v = sig[j]; 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int d = (v>>4)&0xf; 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text[j*2] = (char)(d >= 10 ? ('a' + d - 10) : ('0' + d)); 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project d = v&0xf; 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text[j*2+1] = (char)(d >= 10 ? ('a' + d - 10) : ('0' + d)); 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (outLen != null) outLen[0] = N; 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return text; 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the result of {@link #toChars()} as a String. This result is 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * cached so future calls will return the same String. 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toCharsString() { 100de0ff63700c1836771d797e6c7340b18cb814484Kenny Root String str = mStringRef == null ? null : mStringRef.get(); 101de0ff63700c1836771d797e6c7340b18cb814484Kenny Root if (str != null) { 102de0ff63700c1836771d797e6c7340b18cb814484Kenny Root return str; 103de0ff63700c1836771d797e6c7340b18cb814484Kenny Root } 104de0ff63700c1836771d797e6c7340b18cb814484Kenny Root str = new String(toChars()); 105de0ff63700c1836771d797e6c7340b18cb814484Kenny Root mStringRef = new SoftReference<String>(str); 106de0ff63700c1836771d797e6c7340b18cb814484Kenny Root return str; 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the contents of this signature as a byte array. 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public byte[] toByteArray() { 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] bytes = new byte[mSignature.length]; 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project System.arraycopy(mSignature, 0, bytes, 0, mSignature.length); 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bytes; 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object obj) { 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (obj != null) { 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Signature other = (Signature)obj; 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Arrays.equals(mSignature, other.mSignature); 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (ClassCastException e) { 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHaveHashCode) { 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHashCode; 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHashCode = Arrays.hashCode(mSignature); 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHaveHashCode = true; 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHashCode; 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel dest, int parcelableFlags) { 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeByteArray(mSignature); 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<Signature> CREATOR 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<Signature>() { 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Signature createFromParcel(Parcel source) { 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Signature(source); 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Signature[] newArray(int size) { 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Signature[size]; 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Signature(Parcel source) { 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSignature = source.createByteArray(); 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 163