JavaTM 2 Platform Std. Ed. v1.4.2
java.security
Class CodeSource
java.lang.Object
java.security.CodeSource
- All Implemented Interfaces:
- Serializable
- public class CodeSource
- extends Object
- implements Serializable
This class extends the concept of a codebase to
encapsulate not only the location (URL) but also the certificate(s)
that were used to verify signed code originating from that
location.
- See Also:
- Serialized Form
Constructor Summary |
CodeSource(URL url,
Certificate[] certs)
Constructs a CodeSource and associates it with the specified
location and set of certificates. |
Method Summary |
boolean |
equals(Object obj)
Tests for equality between the specified object and this
object. |
Certificate[] |
getCertificates()
Returns the certificates associated with this CodeSource. |
URL |
getLocation()
Returns the location associated with this CodeSource. |
int |
hashCode()
Returns the hash code value for this object. |
boolean |
implies(CodeSource codesource)
Returns true if this CodeSource object "implies" the specified CodeSource. |
String |
toString()
Returns a string describing this CodeSource, telling its
URL and certificates. |
CodeSource
public CodeSource(URL url,
Certificate[] certs)
- Constructs a CodeSource and associates it with the specified
location and set of certificates.
- Parameters:
url - the location (URL).certs - the certificate(s).
hashCode
public int hashCode()
- Returns the hash code value for this object.
- Overrides:
hashCode in class Object
- Returns:
- a hash code value for this object.
- See Also:
Object.equals(java.lang.Object) ,
Hashtable
equals
public boolean equals(Object obj)
- Tests for equality between the specified object and this
object. Two CodeSource objects are considered equal if their
locations are of identical value and if the two sets of
certificates are of identical values. It is not required that
the certificates be in the same order.
- Overrides:
equals in class Object
- Parameters:
obj - the object to test for equality with this object.
- Returns:
- true if the objects are considered equal, false otherwise.
- See Also:
Object.hashCode() ,
Hashtable
getLocation
public final URL getLocation()
- Returns the location associated with this CodeSource.
- Returns:
- the location (URL).
getCertificates
public final Certificate[] getCertificates()
- Returns the certificates associated with this CodeSource.
- Returns:
- the certificates
implies
public boolean implies(CodeSource codesource)
- Returns true if this CodeSource object "implies" the specified CodeSource.
More specifically, this method makes the following checks, in order.
If any fail, it returns false. If they all succeed, it returns true.
- codesource must not be null.
- If this object's certificates are not null, then all
of this object's certificates must be present in codesource's
certificates.
- If this object's location (getLocation()) is not null, then the
following checks are made against this object's location and
codesource's:
- codesource's location must not be null.
- If this object's location
equals codesource's location, then return true.
- This object's protocol (getLocation().getProtocol()) must be
equal to codesource's protocol.
- If this object's host (getLocation().getHost()) is not null,
then the SocketPermission
constructed with this object's host must imply the
SocketPermission constructed with codesource's host.
- If this object's port (getLocation().getPort()) is not
equal to -1 (that is, if a port is specified), it must equal
codesource's port.
- If this object's file (getLocation().getFile()) doesn't equal
codesource's file, then the following checks are made:
If this object's file ends with "/-",
then codesource's file must start with this object's
file (exclusive the trailing "-").
If this object's file ends with a "/*",
then codesource's file must start with this object's
file and must not have any further "/" separators.
If this object's file doesn't end with a "/",
then codesource's file must match this object's
file with a '/' appended.
- If this object's reference (getLocation().getRef()) is
not null, it must equal codesource's reference.
For example, the codesource objects with the following locations
and null certificates all imply
the codesource with the location "http://java.sun.com/classes/foo.jar"
and null certificates:
http:
http://*.sun.com/classes/*
http://java.sun.com/classes/-
http://java.sun.com/classes/foo.jar
Note that if this CodeSource has a null location and a null
certificate chain, then it implies every other CodeSource.
- Parameters:
codesource - CodeSource to compare against.
- Returns:
- true if the specified codesource is implied by this codesource,
false if not.
toString
public String toString()
- Returns a string describing this CodeSource, telling its
URL and certificates.
- Overrides:
toString in class Object
- Returns:
- information about this CodeSource.
Copyright 2003 Sun Microsystems, Inc. All rights reserved
|