public class Signature extends Object implements Parcelable
This class name is slightly misleading, since it's not actually a signature.
Parcelable.ClassLoaderCreator<T>, Parcelable.Creator<T>
Modifier and Type | Field and Description |
---|---|
static Parcelable.Creator<Signature> |
CREATOR |
CONTENTS_FILE_DESCRIPTOR, PARCELABLE_ELIDE_DUPLICATES, PARCELABLE_WRITE_RETURN_VALUE
Constructor and Description |
---|
Signature(byte[] signature)
Create Signature from an existing raw byte array.
|
Signature(Certificate[] certificateChain)
Create signature from a certificate chain.
|
Signature(String text)
Create Signature from a text representation previously returned by
toChars() or toCharsString() . |
Modifier and Type | Method and Description |
---|---|
static boolean |
areEffectiveMatch(Signature[] a,
Signature[] b)
Test if given
Signature sets are effectively equal. |
static boolean |
areExactMatch(Signature[] a,
Signature[] b)
Test if given
Signature sets are exactly equal. |
static Signature |
bounce(CertificateFactory cf,
Signature s)
Bounce the given
Signature through a decode/encode cycle. |
int |
describeContents()
Describe the kinds of special objects contained in this Parcelable
instance's marshaled representation.
|
boolean |
equals(Object obj)
Indicates whether some other object is "equal to" this one.
|
Signature[] |
getChainSignatures()
Used for compatibility code that needs to check the certificate chain
during upgrades.
|
PublicKey |
getPublicKey()
Returns the public key for this signature.
|
int |
hashCode()
Returns a hash code value for the object.
|
byte[] |
toByteArray() |
char[] |
toChars()
Encode the Signature as ASCII text.
|
char[] |
toChars(char[] existingArray,
int[] outLen)
Encode the Signature as ASCII text in to an existing array.
|
String |
toCharsString()
Return the result of
toChars() as a String. |
void |
writeToParcel(Parcel dest,
int parcelableFlags)
Flatten this object in to a Parcel.
|
public static final Parcelable.Creator<Signature> CREATOR
public Signature(byte[] signature)
public Signature(Certificate[] certificateChain) throws CertificateEncodingException
CertificateEncodingException
public Signature(String text)
toChars()
or toCharsString()
. Signatures are expected to
be a hex-encoded ASCII string.text
- hex-encoded string representing the signatureIllegalArgumentException
- when signature is odd-lengthpublic char[] toChars()
public char[] toChars(char[] existingArray, int[] outLen)
existingArray
- Existing char array or null.outLen
- Output parameter for the number of characters written in
to the array.public byte[] toByteArray()
public PublicKey getPublicKey() throws CertificateException
CertificateException
- when Signature isn't a valid X.509
certificate; shouldn't happen.public Signature[] getChainSignatures() throws CertificateEncodingException
CertificateEncodingException
public boolean equals(Object obj)
Object
The equals
method implements an equivalence relation
on non-null object references:
x
, x.equals(x)
should return
true
.
x
and y
, x.equals(y)
should return true
if and only if
y.equals(x)
returns true
.
x
, y
, and z
, if
x.equals(y)
returns true
and
y.equals(z)
returns true
, then
x.equals(z)
should return true
.
x
and y
, multiple invocations of
x.equals(y)
consistently return true
or consistently return false
, provided no
information used in equals
comparisons on the
objects is modified.
x
,
x.equals(null)
should return false
.
The equals
method for class Object
implements
the most discriminating possible equivalence relation on objects;
that is, for any non-null reference values x
and
y
, this method returns true
if and only
if x
and y
refer to the same object
(x == y
has the value true
).
Note that it is generally necessary to override the hashCode
method whenever this method is overridden, so as to maintain the
general contract for the hashCode
method, which states
that equal objects must have equal hash codes.
equals
in class Object
obj
- the reference object with which to compare.true
if this object is the same as the obj
argument; false
otherwise.Object.hashCode()
,
HashMap
public int hashCode()
Object
HashMap
.
The general contract of hashCode
is:
hashCode
method
must consistently return the same integer, provided no information
used in equals
comparisons on the object is modified.
This integer need not remain consistent from one execution of an
application to another execution of the same application.
equals(Object)
method, then calling the hashCode
method on each of
the two objects must produce the same integer result.
Object.equals(java.lang.Object)
method, then calling the hashCode
method on each of the
two objects must produce distinct integer results. However, the
programmer should be aware that producing distinct integer results
for unequal objects may improve the performance of hash tables.
As much as is reasonably practical, the hashCode method defined by
class Object
does return distinct integers for distinct
objects. (This is typically implemented by converting the internal
address of the object into an integer, but this implementation
technique is not required by the
JavaTM programming language.)
hashCode
in class Object
Object.equals(java.lang.Object)
,
System.identityHashCode(java.lang.Object)
public int describeContents()
Parcelable
Parcelable.writeToParcel(Parcel, int)
,
the return value of this method must include the
Parcelable.CONTENTS_FILE_DESCRIPTOR
bit.describeContents
in interface Parcelable
Parcelable.CONTENTS_FILE_DESCRIPTOR
public void writeToParcel(Parcel dest, int parcelableFlags)
Parcelable
writeToParcel
in interface Parcelable
dest
- The Parcel in which the object should be written.parcelableFlags
- Additional flags about how the object should be written.
May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE
.public static boolean areExactMatch(Signature[] a, Signature[] b)
Signature
sets are exactly equal.public static boolean areEffectiveMatch(Signature[] a, Signature[] b) throws CertificateException
Signature
sets are effectively equal. In rare
cases, certificates can have slightly malformed encoding which causes
exact-byte checks to fail.
To identify effective equality, we bounce the certificates through an decode/encode pass before doing the exact-byte check. To reduce attack surface area, we only allow a byte size delta of a few bytes.
CertificateException
- if the before/after length differs
substantially, usually a signal of something fishy going on.public static Signature bounce(CertificateFactory cf, Signature s) throws CertificateException
Signature
through a decode/encode cycle.CertificateException
- if the before/after length differs
substantially, usually a signal of something fishy going on.