Package org.daiitech.naftah.builtin.utils.tuple

Class ImmutablePair<L,R>

java.lang.Object
org.daiitech.naftah.builtin.utils.tuple.Pair<L,R>
org.daiitech.naftah.builtin.utils.tuple.ImmutablePair<L,R>
Type Parameters:
L - the left element type
R - the right element type
All Implemented Interfaces:
Serializable, Comparable<Pair<L,R>>, Map.Entry<L,R>, NTuple
public final class ImmutablePair<L,R> extends Pair<L,R>
An immutable pair consisting of two Object elements.

Although the implementation is immutable, there is no restriction on the objects that may be stored. If mutable objects are stored in the pair, then the pair itself effectively becomes mutable.

#ThreadSafe# if both paired objects are thread-safe

Author:
Chakib Daii
See Also:

  • Field Details

    • serialVersionUID

      private static final long serialVersionUID
      See Also:

    • NULL

      private static final ImmutablePair NULL
      An immutable pair of nulls.

    • left

      public final L left
      Left object.

  • Constructor Details

    • ImmutablePair

      public ImmutablePair(L left, R right)
      Create a new pair instance.
      Parameters:
      left - the left value, may be null
      right - the right value, may be null

  • Method Details

    • left

      public static <L, R> Pair<L,R> left(L left)
      Creates an immutable pair of two objects inferring the generic types.

      This factory allows the pair to be created using inference to obtain the generic types.

      Type Parameters:
      L - the left element type
      R - the right element type
      Parameters:
      left - the left element, may be null
      Returns:
      a pair formed from the two parameters, not null

    • nullPair

      public static <L, R> ImmutablePair<L,R> nullPair()
      Returns an immutable pair of nulls.
      Type Parameters:
      L - the left element of this pair. Value is null.
      R - the right element of this pair. Value is null.
      Returns:
      an immutable pair of nulls.

    • of

      public static <L, R> ImmutablePair<L,R> of(L left, R right)
      Creates an immutable pair of two objects inferring the generic types.

      This factory allows the pair to be created using inference to obtain the generic types.

      Type Parameters:
      L - the left element type
      R - the right element type
      Parameters:
      left - the left element, may be null
      right - the right element, may be null
      Returns:
      a pair formed from the two parameters, not null

    • of

      public static <L, R> ImmutablePair<L,R> of(Map.Entry<L,R> pair)
      Creates an immutable pair from a map entry.

      This factory allows the pair to be created using inference to obtain the generic types.

      Type Parameters:
      L - the left element type
      R - the right element type
      Parameters:
      pair - the existing map entry.
      Returns:
      a pair formed from the map entry

    • ofNonNull

      public static <L, R> ImmutablePair<L,R> ofNonNull(L left, R right)
      Creates an immutable pair of two non-null objects inferring the generic types.

      This factory allows the pair to be created using inference to obtain the generic types.

      Type Parameters:
      L - the left element type
      R - the right element type
      Parameters:
      left - the left element, may not be null
      right - the right element, may not be null
      Returns:
      a pair formed from the two parameters, not null
      Throws:
      NullPointerException - if any input is null

    • right

      public static <L, R> Pair<L,R> right(R right)
      Creates an immutable pair of two objects inferring the generic types.

      This factory allows the pair to be created using inference to obtain the generic types.

      Type Parameters:
      L - the left element type
      R - the right element type
      Parameters:
      right - the right element, may be null
      Returns:
      a pair formed from the two parameters, not null

    • getLeft

      public L getLeft()
      Gets the left element from this pair.

      When treated as a key-value pair, this is the key.

      Specified by:
      getLeft in class Pair<L,R>
      Returns:
      the left element, may be null

    • getRight

      public R getRight()
      Gets the right element from this pair.

      When treated as a key-value pair, this is the value.

      Specified by:
      getRight in class Pair<L,R>
      Returns:
      the right element, may be null

    • setValue

      public R setValue(R value)
      Throws UnsupportedOperationException.

      This pair is immutable, so this operation is not supported.

      Parameters:
      value - the value to set
      Returns:
      never
      Throws:
      UnsupportedOperationException - as this operation is not supported