Class CodeSource

public CodeSource(URL location,
                  Certificate[] certs)

This creates a new instance of CodeSource that loads code from the specified URL location and which uses the specified certificates for verifying signatures.

Parameters:

location - the location from which code will be loaded

certs - the list of certificates

public boolean equals(Object obj)

This method tests the specified Object for equality with this object. This will be true if and only if the locations are equal and the certificate sets are identical (ignoring order).

Overrides:

equals in interface Object

Parameters:

obj - the Object to test against

Returns:

true if the specified object is equal to this one

public final Certificate[] getCertificates()

This method returns the list of digital certificates that can be used to verify the signatures of code loaded under this CodeSource.

Returns:

the certifcate list for this CodeSource

public final URL getLocation()

This method returns the URL specifying the location from which code will be loaded under this CodeSource.

Returns:

the code location for this CodeSource

public int hashCode()

This method returns a hash value for this object.

Overrides:

hashCode in interface Object

Returns:

a hash value for this object

public boolean implies(CodeSource cs)

This method tests to see if a specified CodeSource is implied by this object. Effectively, to meet this test, the specified object must have all the certifcates this object has (but may have more), and must have a location that is a subset of this object's. In order for this object to imply the specified object, the following must be true:

1. codesource must not be null.
2. If codesource has a certificate list, all of it's certificates must be present in the certificate list of this code source.
3. If this object does not have a null location, then the following addtional tests must be passed.
4. codesource must not have a null location.
5. codesource's location must be equal to this object's location, or
6. codesource's location protocol, port, and ref (aka, anchor) must equal this objects
7. codesource's location host must imply this object's location host, as determined by contructing SocketPermission objects from each with no action list and using that classes's implies method
8. If this object's location file ends with a '/', then the specified object's location file must start with this object's location file. Otherwise, the specified object's location file must start with this object's location file with the '/' character appended to it.

For example, each of these locations imply the location "http://java.sun.com/classes/foo.jar":

 http:
 http://*.sun.com/classes/*
 http://java.sun.com/classes/-
 http://java.sun.com/classes/foo.jar
 

Note that the code source with null location and null certificates implies all other code sources.

Parameters:

cs - the CodeSource to test against this object

Returns:

true if this specified CodeSource is implied

public String toString()

This method returns a String that represents this object. The result is in the format "(" + getLocation() followed by a space separated list of certificates (or "<no certificates>"), followed by ")".

Overrides:

toString in interface Object

Returns:

a String for this object