Interface Record

  • All Superinterfaces:
    java.lang.Cloneable, java.io.Serializable
    All Known Subinterfaces:
    IndexedRecord, MappedRecord, ResultSet


    public interface Record
    extends java.lang.Cloneable, java.io.Serializable
    The javax.resource.cci.Record interface is the base interface for the representation of an input or output to the execute methods defined on an Interaction.

    The Record interface can be extended to form a one of the following representations:

    • MappedRecord: A key-value pair based collection represents a record. This interface is based on the java.util.Map
    • IndexedRecord:An ordered and indexed collection represents a record. This interface is based on the java.util.List.
    • JavaBean based representation of an EIS abstraction: An example is a custom record generated to represent a purchase order in an ERP system.
    • javax.resource.cci.ResultSet: This interface extends both java.sql.ResultSet and javax.resource.cci.Record. A ResultSet represents tabular data.

    A MappedRecord or IndexedRecord can contain another Record. This means that MappedRecord and IndexedRecord can be used to create a hierarchical structure of any arbitrary depth. A basic Java type is used as the leaf element of a hierarchical structure represented by a MappedRecord or IndexedRecord.

    See Also:
    Interaction, ResultSet
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      java.lang.Object clone​()
      Creates and returns a copy of this object.
      boolean equals​(java.lang.Object other)
      Check if this instance is equal to another Record.
      java.lang.String getRecordName​()
      Gets the name of the Record.
      java.lang.String getRecordShortDescription​()
      Gets a short description string for the Record.
      int hashCode​()
      Returns the hash code for the Record instance.
      void setRecordName​(java.lang.String name)
      Sets the name of the Record.
      void setRecordShortDescription​(java.lang.String description)
      Sets a short description string for the Record.
    • Method Detail

      • getRecordName

        java.lang.String getRecordName​()
        Gets the name of the Record.
        Returns:
        String representing name of the Record
      • setRecordName

        void setRecordName​(java.lang.String name)
        Sets the name of the Record.
        Parameters:
        name - Name of the Record
      • setRecordShortDescription

        void setRecordShortDescription​(java.lang.String description)
        Sets a short description string for the Record. This property is used primarily by application development tools.
        Parameters:
        description - Description of the Record
      • getRecordShortDescription

        java.lang.String getRecordShortDescription​()
        Gets a short description string for the Record. This property is used primarily by application development tools.
        Returns:
        String representing a short description of the Record
      • equals

        boolean equals​(java.lang.Object other)
        Check if this instance is equal to another Record.
        Overrides:
        equals in class java.lang.Object
        Returns:
        true if two instances are equal
      • hashCode

        int hashCode​()
        Returns the hash code for the Record instance.
        Overrides:
        hashCode in class java.lang.Object
        Returns:
        hash code
      • clone

        java.lang.Object clone​()
                        throws java.lang.CloneNotSupportedException
        Creates and returns a copy of this object. The precise meaning of "copy" may depend on the class of the object.
        Returns:
        a clone of this instance.
        Throws:
        java.lang.CloneNotSupportedException - If the object's class does not support the Cloneable interface Subclasses that override the clone method can also throw this exception to indicate that an instance cannot be cloned.