java.rmi.server

Class UID

Inhoudsopgave
  • All Implemented Interfaces:
    Serializable

    public final class UID
extends Object
implements Serializable
    A UID represents an identifier that is unique over time with respect to the host it is generated on, or one of 216 "well-known" identifiers.

    The UID() constructor can be used to generate an identifier that is unique over time with respect to the host it is generated on. The UID(short) constructor can be used to create one of 216 well-known identifiers.

    A UID instance contains three primitive values:

    • unique, an int that uniquely identifies the VM that this UID was generated in, with respect to its host and at the time represented by the time value (an example implementation of the unique value would be a process identifier), or zero for a well-known UID
    • time, a long equal to a time (as returned by System.currentTimeMillis()) at which the VM that this UID was generated in was alive, or zero for a well-known UID
    • count, a short to distinguish UIDs generated in the same VM with the same time value

    An independently generated UID instance is unique over time with respect to the host it is generated on as long as the host requires more than one millisecond to reboot and its system clock is never set backward. A globally unique identifier can be constructed by pairing a UID instance with a unique host identifier, such as an IP address.

    Since:
    JDK1.1
    See Also:
    Serialized Form

    • Constructor Detail

      • UID

        public UID()
        Generates a UID that is unique over time with respect to the host that it was generated on.

      • UID

        public UID(short num)
        Creates a "well-known" UID. There are 216 possible such well-known ids.

        A UID created via this constructor will not clash with any UIDs generated via the no-arg constructor.

        Parameters:
        num - number for well-known UID

    • Method Detail

      • equals

        public boolean equals(Object obj)
        Compares the specified object with this UID for equality. This method returns true if and only if the specified object is a UID instance with the same unique, time, and count values as this one.
        Overrides:
        equals in class Object
        Parameters:
        obj - the object to compare this UID to
        Returns:
        true if the given object is equivalent to this one, and false otherwise
        See Also:
        Object.hashCode(), HashMap

      • toString

        public String toString()
        Returns a string representation of this UID.
        Overrides:
        toString in class Object
        Returns:
        a string representation of this UID

      • write

        public void write(DataOutput out)
           throws IOException
        Marshals a binary representation of this UID to a DataOutput instance.

        Specifically, this method first invokes the given stream's DataOutput.writeInt(int) method with this UID's unique value, then it invokes the stream's DataOutput.writeLong(long) method with this UID's time value, and then it invokes the stream's DataOutput.writeShort(int) method with this UID's count value.

        Parameters:
        out - the DataOutput instance to write this UID to
        Throws:
        IOException - if an I/O error occurs while performing this operation

      • read

        public static UID read(DataInput in)
                throws IOException
        Constructs and returns a new UID instance by unmarshalling a binary representation from an DataInput instance.

        Specifically, this method first invokes the given stream's DataInput.readInt() method to read a unique value, then it invoke's the stream's DataInput.readLong() method to read a time value, then it invoke's the stream's DataInput.readShort() method to read a count value, and then it creates and returns a new UID instance that contains the unique, time, and count values that were read from the stream.

        Parameters:
        in - the DataInput instance to read UID from
        Returns:
        unmarshalled UID instance
        Throws:
        IOException - if an I/O error occurs while performing this operation

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/rmi/server/UID.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/en/java/, Class UID

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