java.security

Class CodeSource

Inhoudsopgave
  • 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 chains that were used to verify signed code originating from that location.

    See Also:
    Serialized Form

    • Constructor Detail

      • 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). It may be null. The contents of the array are copied to protect against subsequent modification.

      • CodeSource

        public CodeSource(URL url,
          CodeSigner[] signers)
        Constructs a CodeSource and associates it with the specified location and set of code signers.
        Parameters:
        url - the location (URL).
        signers - the code signers. It may be null. The contents of the array are copied to protect against subsequent modification.
        Since:
        1.5

    • Method Detail

      • 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 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 this CodeSource.
        Returns:
        the location (URL).

      • getCertificates

        public final Certificate[] getCertificates()
        Returns the certificates associated with this CodeSource.

        If this CodeSource object was created using the CodeSource(URL url, CodeSigner[] signers) constructor then its certificate chains are extracted and used to create an array of Certificate 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 certificates array, or null if there is none.

      • getCodeSigners

        public final CodeSigner[] getCodeSigners()
        Returns the code signers associated with this CodeSource.

        If this CodeSource object was created using the CodeSource(URL url, Certificate[] certs) constructor then its certificate chains are extracted and used to create an array of CodeSigner objects. Note that only X.509 certificates are examined - all other certificate types are ignored.

        Returns:
        A copy of the code signer array, or null if there is none.
        Since:
        1.5

      • 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.

        1. codesource must not be null.
        2. If this object's certificates are not null, then all of this object's certificates must be present in codesource's certificates.
        3. If this object's location (getLocation()) is not null, then the following checks are made against this object's location and codesource's:

          1. codesource's location must not be null.
          2. If this object's location equals codesource's location, then return true.
          3. This object's protocol (getLocation().getProtocol()) must be equal to codesource's protocol.
          4. 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.
          5. 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.
          6. 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.
          7. 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.

Nederlandse vertaling

U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.

Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.

Bij voorbaat dank.

Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/security/CodeSource.html

De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.

Referenties

  1. Bekijk - html-document Taal van het document:fr Manuel PHP : https://docs.oracle.com

Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.

Inhoudsopgave Haut