Constructor Summary

Method Summary

Constructor Details

• CodeSource

  public CodeSource(URL url,Certificate[] certs)

  Constructs aCodeSource and associates it with the specified location and set of certificates.

  Parameters:

  url - the location (URL). It may benull.

  certs - the certificate(s). It may benull. The contents of the array are copied to protect against subsequent modification.

• CodeSource

  public CodeSource(URL url,CodeSigner[] signers)

  Constructs aCodeSource and associates it with the specified location and set of code signers.

  Parameters:

  url - the location (URL). It may benull.

  signers - the code signers. It may benull. The contents of the array are copied to protect against subsequent modification.

  Since:

  1.5

Method Details

• hashCode

  public int hashCode()

  Returns the hash code value for this object.

  Overrides:

  hashCode in class Object

  Returns:

  the hash code value for this object

  See Also:

  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

• equals

  public boolean equals(Object obj)

  Tests for equality between the specified object and this object. TwoCodeSource objects are considered equal if their locations are of identical value and if their signer certificate chains are of identical value. It is not required that the certificate chains 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()
  • HashMap

• getLocation

  public final URL getLocation()

  Returns the location associated with thisCodeSource.

  Returns:

  the location (URL), ornull if no URL was supplied during construction.

• getCertificates

  public final Certificate[] getCertificates()

  Returns the certificates associated with thisCodeSource.

  If thisCodeSource object was created using theCodeSource(URL url, CodeSigner[] signers) constructor then its certificate chains are extracted and used to create an array ofCertificate objects. Each signer certificate is followed by its supporting certificate chain (which may be empty). Each signer certificate and its supporting certificate chain is ordered bottom-to-top (i.e., with the signer certificate first and the (root) certificate authority last).

  Returns:

  a copy of the certificate array, ornull if there is none.

• getCodeSigners

  public final CodeSigner[] getCodeSigners()

  Returns the code signers associated with thisCodeSource.

  If thisCodeSource object was created using theCodeSource(URL url, java.security.cert.Certificate[] certs) constructor then its certificate chains are extracted and used to create an array ofCodeSigner objects. Note that only X.509 certificates are examined - all other certificate types are ignored.

  Returns:

  a copy of the code signer array, ornull if there is none.

  Since:

  1.5

• implies

  public boolean implies(CodeSource codesource)

  Returns true if thisCodeSource object "implies" the specifiedCodeSource.

  More specifically, this method makes the following checks. If any fail, it returnsfalse. If they all succeed, it returnstrue.

  • codesource must not be null.
  • If this object's certificates are not null, then all of this object's certificates must be present incodesource's certificates.
  • If this object's location (getLocation()) is not null, then the following checks are made against this object's location andcodesource's:
    • codesource's location must not be null.
    • If this object's location equalscodesource's location, then return true.
    • This object's protocol (getLocation().getProtocol()) must be equal tocodesource's protocol, ignoring case.
    • If this object's host (getLocation().getHost()) is not null, then the SocketPermission constructed with this object's host must imply the SocketPermission constructed withcodesource's host.
    • If this object's port (getLocation().getPort()) is not equal to -1 (that is, if a port is specified), it must equalcodesource's port or default port (codesource.getLocation().getDefaultPort()).
    • If this object's file (getLocation().getFile()) doesn't equalcodesource's file, then the following checks are made: If this object's file ends with "/-", thencodesource's file must start with this object's file (exclusive the trailing "-"). If this object's file ends with a "/*", thencodesource'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 "/", thencodesource's file must match this object's file with a '/' appended.
    • If this object's reference (getLocation().getRef()) is not null, it must equalcodesource's reference.

  For example, the codesource objects with the following locations andnull certificates all imply the codesource with the locationhttp://www.example.com/classes/foo.jar andnull certificates:

       http:     http://*.example.com/classes/*     http://www.example.com/classes/-     http://www.example.com/classes/foo.jar

  Note that if thisCodeSource has anull location and anull certificate chain, then it implies every otherCodeSource.

  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 thisCodeSource, telling its URL and certificates.

  Overrides:

  toString in class Object

  Returns:

  information about thisCodeSource.