javax.naming

Class BinaryRefAddr

Table des matières
  • All Implemented Interfaces:
    Serializable

    public class BinaryRefAddr
extends RefAddr
    This class represents the binary form of the address of a communications end-point.

    A BinaryRefAddr consists of a type that describes the communication mechanism and an opaque buffer containing the address description specific to that communication mechanism. The format and interpretation of the address type and the contents of the opaque buffer are based on the agreement of three parties: the client that uses the address, the object/server that can be reached using the address, and the administrator or program that creates the address.

    An example of a binary reference address is an BER X.500 presentation address. Another example of a binary reference address is a serialized form of a service's object handle.

    A binary reference address is immutable in the sense that its fields once created, cannot be replaced. However, it is possible to access the byte array used to hold the opaque buffer. Programs are strongly recommended against changing this byte array. Changes to this byte array need to be explicitly synchronized.

    Since:
    1.3
    See Also:
    RefAddr, StringRefAddr, Serialized Form

    • Field Summary

      • Fields inherited from class javax.naming.RefAddr

        addrType

    • Constructor Summary

      Constructors 
      Constructor and Description
      BinaryRefAddr(String addrType, byte[] src)
      Constructs a new instance of BinaryRefAddr using its address type and a byte array for contents.
      BinaryRefAddr(String addrType, byte[] src, int offset, int count)
      Constructs a new instance of BinaryRefAddr using its address type and a region of a byte array for contents.

        

    • Method Summary

      Methods 
      Modifier and Type Method and Description
      boolean equals(Object obj)
      Determines whether obj is equal to this address.
      Object getContent()
      Retrieves the contents of this address as an Object.
      int hashCode()
      Computes the hash code of this address using its address type and contents.
      String toString()
      Generates the string representation of this address.

        

      • Methods inherited from class javax.naming.RefAddr

        getType

    • Constructor Detail

      • BinaryRefAddr

        public BinaryRefAddr(String addrType,
             byte[] src)
        Constructs a new instance of BinaryRefAddr using its address type and a byte array for contents.
        Parameters:
        addrType - A non-null string describing the type of the address.
        src - The non-null contents of the address as a byte array. The contents of src is copied into the new BinaryRefAddr.

      • BinaryRefAddr

        public BinaryRefAddr(String addrType,
             byte[] src,
             int offset,
             int count)
        Constructs a new instance of BinaryRefAddr using its address type and a region of a byte array for contents.
        Parameters:
        addrType - A non-null string describing the type of the address.
        src - The non-null contents of the address as a byte array. The contents of src is copied into the new BinaryRefAddr.
        offset - The starting index in src to get the bytes. 0 <= offset <= src.length.
        count - The number of bytes to extract from src. 0 <= count <= src.length-offset.

    • Method Detail

      • getContent

        public Object getContent()
        Retrieves the contents of this address as an Object. The result is a byte array. Changes to this array will affect this BinaryRefAddr's contents. Programs are recommended against changing this array's contents and to lock the buffer if they need to change it.
        Specified by:
        getContent in class RefAddr
        Returns:
        The non-null buffer containing this address's contents.

      • equals

        public boolean equals(Object obj)
        Determines whether obj is equal to this address. It is equal if it contains the same address type and their contents are byte-wise equivalent.
        Overrides:
        equals in class RefAddr
        Parameters:
        obj - The possibly null object to check.
        Returns:
        true if the object is equal; false otherwise.
        See Also:
        RefAddr.getContent(), RefAddr.getType()

      • hashCode

        public int hashCode()
        Computes the hash code of this address using its address type and contents. Two BinaryRefAddrs have the same hash code if they have the same address type and the same contents. It is also possible for different BinaryRefAddrs to have the same hash code.
        Overrides:
        hashCode in class RefAddr
        Returns:
        The hash code of this address as an int.
        See Also:
        Object.hashCode()

      • toString

        public String toString()
        Generates the string representation of this address. The string consists of the address's type and contents with labels. The first 32 bytes of contents are displayed (in hexadecimal). If there are more than 32 bytes, "..." is used to indicate more. This string is meant to used for debugging purposes and not meant to be interpreted programmatically.
        Overrides:
        toString in class RefAddr
        Returns:
        The non-null string representation of this address.

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Version en cache

18/12/2024 11:32:06 Cette version de la page est en cache (à la date du 18/12/2024 11:32:06) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 29/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/naming/binaryrefaddr.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : https://docs.oracle.com, BinaryRefAddr

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut