Signature.java revision d21d444426911d93c507a929a8223ebf63258954
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) { 48d21d444426911d93c507a929a8223ebf63258954Kenny Root final byte[] input = text.getBytes(); 49d21d444426911d93c507a929a8223ebf63258954Kenny Root final int N = input.length; 50d21d444426911d93c507a929a8223ebf63258954Kenny Root final byte[] sig = new byte[N / 2]; 51d21d444426911d93c507a929a8223ebf63258954Kenny Root int sigIndex = 0; 52d21d444426911d93c507a929a8223ebf63258954Kenny Root 53d21d444426911d93c507a929a8223ebf63258954Kenny Root for (int i = 0; i < N;) { 54d21d444426911d93c507a929a8223ebf63258954Kenny Root int b; 55d21d444426911d93c507a929a8223ebf63258954Kenny Root 56d21d444426911d93c507a929a8223ebf63258954Kenny Root final int hi = input[i++]; 57d21d444426911d93c507a929a8223ebf63258954Kenny Root b = (hi >= 'a' ? (hi - 'a' + 10) : (hi - '0')) << 4; 58d21d444426911d93c507a929a8223ebf63258954Kenny Root 59d21d444426911d93c507a929a8223ebf63258954Kenny Root final int lo = input[i++]; 60d21d444426911d93c507a929a8223ebf63258954Kenny Root b |= (lo >= 'a' ? (lo - 'a' + 10) : (lo - '0')) & 0x0F; 61d21d444426911d93c507a929a8223ebf63258954Kenny Root 62d21d444426911d93c507a929a8223ebf63258954Kenny Root sig[sigIndex++] = (byte) (b & 0xFF); 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 64d21d444426911d93c507a929a8223ebf63258954Kenny Root 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSignature = sig; 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. 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public char[] toChars() { 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return toChars(null, null); 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Encode the Signature as ASCII text in to an existing array. 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param existingArray Existing char array or null. 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param outLen Output parameter for the number of characters written in 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the array. 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns either <var>existingArray</var> if it was large enough 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to hold the ASCII representation, or a newly created char[] array if 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * needed. 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public char[] toChars(char[] existingArray, int[] outLen) { 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] sig = mSignature; 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int N = sig.length; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int N2 = N*2; 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text = existingArray == null || N2 > existingArray.length 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ? new char[N2] : existingArray; 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int j=0; j<N; j++) { 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte v = sig[j]; 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int d = (v>>4)&0xf; 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text[j*2] = (char)(d >= 10 ? ('a' + d - 10) : ('0' + d)); 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project d = v&0xf; 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text[j*2+1] = (char)(d >= 10 ? ('a' + d - 10) : ('0' + d)); 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (outLen != null) outLen[0] = N; 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return text; 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the result of {@link #toChars()} as a String. This result is 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * cached so future calls will return the same String. 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toCharsString() { 107de0ff63700c1836771d797e6c7340b18cb814484Kenny Root String str = mStringRef == null ? null : mStringRef.get(); 108de0ff63700c1836771d797e6c7340b18cb814484Kenny Root if (str != null) { 109de0ff63700c1836771d797e6c7340b18cb814484Kenny Root return str; 110de0ff63700c1836771d797e6c7340b18cb814484Kenny Root } 111de0ff63700c1836771d797e6c7340b18cb814484Kenny Root str = new String(toChars()); 112de0ff63700c1836771d797e6c7340b18cb814484Kenny Root mStringRef = new SoftReference<String>(str); 113de0ff63700c1836771d797e6c7340b18cb814484Kenny Root return str; 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the contents of this signature as a byte array. 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public byte[] toByteArray() { 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] bytes = new byte[mSignature.length]; 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project System.arraycopy(mSignature, 0, bytes, 0, mSignature.length); 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bytes; 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object obj) { 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (obj != null) { 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Signature other = (Signature)obj; 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Arrays.equals(mSignature, other.mSignature); 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (ClassCastException e) { 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHaveHashCode) { 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHashCode; 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHashCode = Arrays.hashCode(mSignature); 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHaveHashCode = true; 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHashCode; 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel dest, int parcelableFlags) { 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeByteArray(mSignature); 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<Signature> CREATOR 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<Signature>() { 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Signature createFromParcel(Parcel source) { 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Signature(source); 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Signature[] newArray(int size) { 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Signature[size]; 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Signature(Parcel source) { 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSignature = source.createByteArray(); 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 170