Package org.apache.torque.om

# Klasse ComboKey

java.lang.Object
org.apache.torque.om.ObjectKey<SimpleKey<?>[]>
org.apache.torque.om.ComboKey

Alle implementierten Schnittstellen:
  `Serializable`, `Comparable<Object>`

public class ComboKey extends ObjectKey<SimpleKey<?>[]>
This class can be used as an ObjectKey to uniquely identify an object within an application where the key consists of multiple entities (such a String[] representing a multi-column primary key).

Version:
  $Id: ComboKey.java 1917245 2024-04-21 14:06:23Z tv $
Autor:
  John McNally, Daniel Rall, J. Russell Smyth
Siehe auch:
  - Serialisierte Form

- ## Feldübersicht

  Felder
  Modifizierer und Typ
  Feld
  Beschreibung
  `static final char`
  `SEPARATOR`
  The single character used to separate key values in a string.
  `static final String`
  `SEPARATOR_STRING`
  The single character used to separate key values in a string.

- ## Konstruktorübersicht

  Konstruktoren
  Konstruktor
  Beschreibung
  `ComboKey()`
  Initializes the internal key value to `null`.
  `ComboKey(String key)`
  Creates an ComboKey and set its internal representation
  `ComboKey(ComboKey key)`
  Creates a ComboKey that is equivalent to key.
  `ComboKey(SimpleKey<?>[] key)`
  Creates an ComboKey and set its internal representation

- ## Methodenübersicht

  Modifizierer und Typ
  Methode
  Beschreibung
  `void`
  `appendTo(StringBuilder sb)`
  Appends a String representation of the key to a buffer.
  `boolean`
  `equals(Object keyObj)`
  This method will return true if the conditions for a looseEquals are met and in addition no parts of the keys are null.
  `int`
  `getJdbcType()`
  Returns the JDBC type of the key as defined in `java.sql.Types`.
  `int`
  `hashCode()`
  if the underlying key array is not null and the first element is not null this method returns the hashcode of the first element in the key.
  `boolean`
  `looseEquals(Object keyObj)`
  keyObj is equal to this ComboKey if keyObj is a ComboKey, String, ObjectKey[], or String[] that contains the same information this key contains.
  `void`
  `setValue(String keys)`
  Sets the internal representation using a String of the form produced by the toString method.
  `String`
  `toString()`
  A String that may consist of one section or multiple sections separated by a colon.

  ### Von Klasse geerbte Methoden org.apache.torque.om.ObjectKey

  `compareTo, getValue, setValue, setValue`

  ### Von Klasse geerbte Methoden java.lang.Object

  `clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

- ## Felddetails

  - ### SEPARATOR

    public static final char SEPARATOR
    The single character used to separate key values in a string.
    Siehe auch:
      - Konstantenfeldwerte

  - ### SEPARATOR_STRING

    public static final String SEPARATOR_STRING
    The single character used to separate key values in a string.
    Siehe auch:
      - Konstantenfeldwerte

- ## Konstruktordetails

  - ### ComboKey

    public ComboKey()
    Initializes the internal key value to `null`.

  - ### ComboKey

    public ComboKey(String key)
    Creates an ComboKey and set its internal representation
    Parameter:
      `key` - the key value as String

  - ### ComboKey

    public ComboKey(SimpleKey<?>[] key)
    Creates an ComboKey and set its internal representation
    Parameter:
      `key` - the key value

  - ### ComboKey

    public ComboKey(ComboKey key)
    Creates a ComboKey that is equivalent to key.
    Parameter:
      `key` - the key value

- ## Methodendetails

  - ### setValue

    public void setValue(String keys)
    Sets the internal representation using a String of the form produced by the toString method.
    Parameter:
      `keys` - the key values

  - ### getJdbcType

    public int getJdbcType()
    Returns the JDBC type of the key as defined in `java.sql.Types`.
    Angegeben von:
      `getJdbcType` in Klasse `ObjectKey<SimpleKey<?>[]>`
    Gibt zurück:
      `Types.ARRAY`.

  - ### equals

    public boolean equals(Object keyObj)
    This method will return true if the conditions for a looseEquals are met and in addition no parts of the keys are null.
    Setzt außer Kraft:
      `equals` in Klasse `ObjectKey<SimpleKey<?>[]>`
    Parameter:
      `keyObj` - the comparison value
    Gibt zurück:
      whether the two objects are equal

  - ### looseEquals

    public boolean looseEquals(Object keyObj)
    keyObj is equal to this ComboKey if keyObj is a ComboKey, String, ObjectKey[], or String[] that contains the same information this key contains. For example A String[] might be equal to this key, if this key was instantiated with a String[] and the arrays contain equal Strings. Another example, would be if keyObj is an ComboKey that was instantiated with a ObjectKey[] and this ComboKey was instantiated with a String[], but the ObjectKeys in the ObjectKey[] were instantiated with Strings that equal the Strings in this KeyObject's String[] This method is not as strict as the equals method which does not allow any null keys parts, while the internal key may not be null portions may be, and the two object will be considered equal if their null portions match.
    Parameter:
      `keyObj` - the comparison value
    Gibt zurück:
      whether the two objects are equal

  - ### appendTo

    public void appendTo(StringBuilder sb)
    Beschreibung aus Klasse kopiert: `ObjectKey`
    Appends a String representation of the key to a buffer.
    Setzt außer Kraft:
      `appendTo` in Klasse `ObjectKey<SimpleKey<?>[]>`
    Parameter:
      `sb` - the StringBuilder to append
    Siehe auch:
      - `toString()`

  - ### hashCode

    public int hashCode()
    if the underlying key array is not null and the first element is not null this method returns the hashcode of the first element in the key. Otherwise calls ObjectKey.hashCode()
    Setzt außer Kraft:
      `hashCode` in Klasse `ObjectKey<SimpleKey<?>[]>`
    Gibt zurück:
      an `int` value

  - ### toString

    public String toString()
    A String that may consist of one section or multiple sections separated by a colon.

    Each Key is represented by `[type N|S|D][value][:]`.

    Example:

    the ComboKey(StringKey("key1"), NumberKey(2)) is represented as `Skey1:N2:`

    Setzt außer Kraft:
      `toString` in Klasse `ObjectKey<SimpleKey<?>[]>`
    Gibt zurück:
      a String representation