Package app.babylon.table.column

Interface ColumnObject<T>

Type Parameters:
T - the runtime value type stored in the column
All Superinterfaces:
Column
All Known Subinterfaces:
ColumnCategorical<T>
All Known Implementing Classes:
ColumnCategorical.Renamed, ColumnObject.Renamed
public interface ColumnObject<T> extends Column
A column that stores object values, including strings, dates, decimals, and other reference types.

  • Method Details

    • builder

      static <T> ColumnObject.Builder<T> builder(ColumnName name, Column.Type type)
      Creates an object column builder using the default storage mode.
      Type Parameters:
      T - the value type
      Parameters:
      name - the column name
      type - the column type
      Returns:
      a builder for the supplied object type

    • builder

      static <T> ColumnObject.Builder<T> builder(ColumnName name, Column.Type type, ColumnObject.Mode mode)
      Creates an object column builder using the requested storage mode.
      Type Parameters:
      T - the value type
      Parameters:
      name - the column name
      type - the column type
      mode - the preferred storage strategy
      Returns:
      a builder for the supplied object type

    • builderDecimal

      static ColumnObject.Builder<BigDecimal> builderDecimal(ColumnName name)
      Creates a BigDecimal column builder.
      Parameters:
      name - the column name
      Returns:
      a decimal column builder

    • builder

      static ColumnObject.Builder<String> builder(ColumnName name)
      Creates a String column builder.
      Parameters:
      name - the column name
      Returns:
      a string column builder

    • copy

      default ColumnObject<T> copy(ColumnName x)
      Creates a copy of this object column with the supplied column name.
      Specified by:
      copy in interface Column
      Parameters:
      x - the name to assign to the copy
      Returns:
      an object column containing the same values under the new name

    • copy

      default ColumnObject<T> copy(ColumnName x, RowPredicate include)
      Description copied from interface: Column
      Creates a copy of this column with the supplied column name, only retaining rows included by the supplied row predicate.
      Specified by:
      copy in interface Column
      Parameters:
      x - the name to assign to the copy
      include - row predicate indicating which source rows to copy
      Returns:
      a column containing copied values for included rows and unset values elsewhere

    • selectRow

      ColumnObject<T> selectRow(int i)
      Returns a single-row object column containing the value from the supplied row.
      Specified by:
      selectRow in interface Column
      Parameters:
      i - the row to extract
      Returns:
      a single-row object column with the same column name

    • getKeyedValue

      default ColumnObject.KeyedObject<T> getKeyedValue(int i)
      Specified by:
      getKeyedValue in interface Column

    • firstKeyed

      default ColumnObject.KeyedObject<T> firstKeyed()
      Specified by:
      firstKeyed in interface Column

    • lastKeyed

      default ColumnObject.KeyedObject<T> lastKeyed()
      Specified by:
      lastKeyed in interface Column

    • view

      ColumnObject<T> view(ViewIndex rowIndex)
      Description copied from interface: Column
      Returns a projected view of this column using the supplied row mapping.
      Specified by:
      view in interface Column
      Parameters:
      rowIndex - the row mapping to apply
      Returns:
      a column view over the selected rows

    • get

      T get(int i)
      Returns the value at the supplied row.
      Parameters:
      i - the zero-based row index
      Returns:
      the row value, or null when unset

    • isSet

      default boolean isSet(int i)
      Description copied from interface: Column
      Indicates whether the value at the supplied row is present.
      Specified by:
      isSet in interface Column
      Parameters:
      i - the zero-based row index
      Returns:
      true when the row contains a value

    • first

      default T first()
      Returns the first row value.
      Returns:
      the first row value

    • last

      default T last()
      Returns the last row value.
      Returns:
      the last row value

    • max

      default T max()
      Returns the maximum set value in the column.
      Returns:
      maximum set value

    • min

      default T min()
      Returns the minimum set value in the column.
      Returns:
      minimum set value

    • getAll

      default Collection<T> getAll(Collection<T> x)
      Appends all set values to the supplied collection.
      Parameters:
      x - the destination collection, or null
      Returns:
      a collection containing all set values in row order

    • getUniques

      default Set<T> getUniques(Set<T> x)
      Collects the distinct set values from the column.
      Parameters:
      x - the destination set, or null
      Returns:
      a set containing the unique values

    • select

      default Selection select(Predicate<T> f)
      Selects rows whose values satisfy the supplied predicate.
      Parameters:
      f - the predicate to test against each set value
      Returns:
      a selection containing the predicate result for each row

    • predicate

      default RowPredicate predicate(Column.Operator operator, CharSequence... values)
      Description copied from interface: Column
      Creates a row predicate by parsing the supplied comparison values according to this column's type.
      Specified by:
      predicate in interface Column
      Parameters:
      operator - comparison operator
      values - comparison values as text
      Returns:
      predicate evaluated by row index

    • predicate

      default RowPredicate predicate(Column.Operator operator, T... values)
      Creates a row predicate from already-typed comparison values.

      This avoids the text parser used by predicate(Operator, CharSequence...) for object types such as BigDecimal, LocalDate, or Currency. For ColumnObject<String>, calls with string literals naturally bind to the CharSequence... overload because String is a CharSequence; that is equivalent for string columns because parsing a string value as a string returns the same value.

      Parameters:
      operator - comparison operator
      values - already-typed comparison values
      Returns:
      predicate evaluated by row index

    • transform

      default <S> ColumnObject<S> transform(Transformer<T,S> transformer)
      Transforms this column into another object column using the supplied transformer.
      Type Parameters:
      S - the transformed value type
      Parameters:
      transformer - the row transformation to apply
      Returns:
      a transformed column

    • toString

      default String toString(int i, ToStringSettings settings)
      Description copied from interface: Column
      Formats the value at the supplied row using the provided rendering settings.
      Specified by:
      toString in interface Column
      Parameters:
      i - the zero-based row index
      settings - formatting settings to apply
      Returns:
      the formatted row value

    • appendTo

      default void appendTo(int i, StringBuilder out, ToStringSettings settings)
      Description copied from interface: Column
      Appends the value at the supplied row using the provided rendering settings.
      Specified by:
      appendTo in interface Column
      Parameters:
      i - the zero-based row index
      out - the destination buffer
      settings - formatting settings to apply

    • equals

      static <T> boolean equals(ColumnObject<T> a, Object obj)
      Compares a column object with another object using column name, size, and row-by-row value equality.
      Type Parameters:
      T - the column value type
      Parameters:
      a - the column to compare
      obj - the comparison target
      Returns:
      true when the objects represent the same column contents