Interface Column<T>

    • Nested Class Summary

      • Nested classes/interfaces inherited from interface org.refcodes.mixin.KeyAccessor

        org.refcodes.mixin.KeyAccessor.KeyBuilder<K extends java.lang.Object,B extends org.refcodes.mixin.KeyAccessor.KeyBuilder<K,B>>, org.refcodes.mixin.KeyAccessor.KeyMutator<K extends java.lang.Object>, org.refcodes.mixin.KeyAccessor.KeyProperty<K extends java.lang.Object>
      • Nested classes/interfaces inherited from interface org.refcodes.mixin.TypeAccessor

        org.refcodes.mixin.TypeAccessor.TypeMutator<T extends java.lang.Object>, org.refcodes.mixin.TypeAccessor.TypeProperty<T extends java.lang.Object>
    • Method Summary

      All Methods Instance Methods Abstract Methods Default Methods 
      Modifier and Type Method Description
      boolean contains​(Record<?> aRecord)
      Tests whether the Record contains a value identified by the Column instance's key and where the value's type is assignable to the Column instance's type.
      T fromStorageString​(java.lang.String aStringValue)
      A Column implementation can provide its own text exchange format for the given objects.
      T fromStorageStrings​(java.lang.String[] aStringArray)
      A Column implementation can provide its own text exchange format for the given objects.
      T get​(Record<?> aRecord)
      Retrieves a type correct value from the Record identified by the Column instance's key.
      default T getValue​(Record<?> aRecord)
      Retrieves the corresponding value from the provided record.
      T remove​(Record<?> aRecord)
      Removes an entry (key and value pair) from the provided Record matching the key and the type of the Column.
      java.lang.String toPrintable​(T aValue)
      A Column implementation can provide its own printable format of the given objects; for example a human readable text representation of the value (or in very specialized cases even enriched with ANSI escape codes).
      java.lang.String toStorageString​(T aValue)
      A Column implementation can provide its own text exchange format for the given objects.
      default java.lang.String toStorageString_​(java.lang.Object aValue)
      A Column implementation can provide its own text exchange format for the given objects.
      java.lang.String[] toStorageStrings​(T aValue)
      A Column implementation can provide its own text exchange format for the given objects.
      • Methods inherited from interface org.refcodes.mixin.KeyAccessor

        getKey
      • Methods inherited from interface org.refcodes.mixin.TypeAccessor

        getType
    • Method Detail

      • toStorageString

        java.lang.String toStorageString​(T aValue)
        A Column implementation can provide its own text exchange format for the given objects. This method enables the Column to convert a value of the given type to a String and via fromStorageString(String) back to the value (bijective). This method supports data sinks (such as relational databases) which allow only a single value in a row's entry: In case T is an array type, then the storage String representation of the elements in that array are represented by a single returned String. TODO: Why does the detour through the method toStorageString(Object) not function?!? Having this snippet in the code seems to be fine for the compiler ... trying toStorageString_(Object) instead :-( In case a data sink (such as Amazon's SimpleDb) is to be addressed which provides dedicated support for multiple values in one row's entry, then the method toStorageStrings(Object) may be used instead.
        Parameters:
        aValue - the element to be converted to a String.
        Returns:
        The String representation of the value.
      • toStorageString_

        default java.lang.String toStorageString_​(java.lang.Object aValue)
                                           throws java.lang.ClassCastException
        A Column implementation can provide its own text exchange format for the given objects. This method enables the Column to convert a value of the given type to a String and via fromStorageString(String) back to the value (bijective). This method supports data sinks (such as relational databases) which allow only a single value in a row's entry: In case T is an array type, then the storage String representation of the elements in that array are represented by a single returned String. In case a data sink (such as Amazon's SimpleDb) is to be addressed which provides dedicated support for multiple values in one row's entry, then the method toStorageStrings(Object) may be used instead. TODO: Why does the detour through the method toStorageString(Object) not function?!? Having this snippet in the code seems to be fine for the compiler ... trying toStorageString_(Object) instead :-(
        Parameters:
        aValue - the element to be converted to a String.
        Returns:
        The String representation of the value.
        Throws:
        java.lang.ClassCastException - - if the object is not null and is not assignable to the type T.
      • toStorageStrings

        java.lang.String[] toStorageStrings​(T aValue)
        A Column implementation can provide its own text exchange format for the given objects. This method enables the Column to convert a value of the given type to a String array and via fromStorageStrings(String[]) back to the value (bijective). This method supports data sinks (such as Amazon's SimpleDb) which provide dedicated support for multiple values in a row's entry: In case T is an array type, then the storage String representations of the elements in that array may be placed in dedicated entries of the returned String array. In case T is not an array type then the returned String array may contain just one value. In case data sinks (such as relational databases) are to be addressed which allow only a single value in a row's entry, then the method toStorageString(Object) may be used instead.
        Parameters:
        aValue - the element to be converted to a String array.
        Returns:
        The String array representation of the value.
      • fromStorageString

        T fromStorageString​(java.lang.String aStringValue)
                     throws java.text.ParseException
        A Column implementation can provide its own text exchange format for the given objects. This method enables the Column to convert a String value to a value of the given type and via toStorageString(Object) back to the String (bijective). This method supports data sinks (such as relational databases) which allow only a single value in a row's entry: In case T is an array type, then the storage String representation of the elements in that array are represented by the single passed String. In case a data sink (such as Amazon's SimpleDb) is to be addressed which provides dedicated support for multiple values in one row's entry, then the method fromStorageStrings(String[]) may be used instead.
        Parameters:
        aStringValue - The value to be converted to a type instance.
        Returns:
        The type representation of the value.
        Throws:
        java.text.ParseException - in case parsing the String was not possible
      • fromStorageStrings

        T fromStorageStrings​(java.lang.String[] aStringArray)
                      throws java.text.ParseException
        A Column implementation can provide its own text exchange format for the given objects. This method enables the Column to convert a String array value to a value of the given type and via toStorageStrings(Object) back to the String array (bijective). This method supports data sinks (such as Amazon's SimpleDb) which provide dedicated support for multiple values in a row's entry: In case T is an array type, then the storage String representations of the elements in that array may be placed in dedicated entries of the provided String array. In case T is not an array type then the passed String array may contain just one value. In case data sinks (such as relational databases) are to be addressed which allow only a single value in a row's entry, then the method fromStorageString(String) may be used instead.
        Parameters:
        aStringArray - The value to be converted to a type instance.
        Returns:
        The type representation of the value.
        Throws:
        java.text.ParseException - in case parsing the String was not possible
      • toPrintable

        java.lang.String toPrintable​(T aValue)
        A Column implementation can provide its own printable format of the given objects; for example a human readable text representation of the value (or in very specialized cases even enriched with ANSI escape codes). This method enables the Column to convert a value of the given type to a human readable text. The human readable text, in comparison to the method Object.toString() (or toStorageString(Object)) is not intended to be converted back to the actual value (not bijective). This method may be used a Header instance's method HeaderRow.toPrintable(Record).
        Parameters:
        aValue - the element to be converted to a human readable text.
        Returns:
        The human readable representation of the value.
      • contains

        boolean contains​(Record<?> aRecord)
        Tests whether the Record contains a value identified by the Column instance's key and where the value's type is assignable to the Column instance's type. Only if them both criteria match, then true is returned. False is returned if there is no such value or the value is not assignable to the Column instance's type.
        Parameters:
        aRecord - The Record which to test if there is a value associated to the Column instance's key and if it can be casted to the Column instance's type.
        Returns:
        True in case the Record contains a value identified by the Column instance's key and where the value's type is assignable to the Column instance's type.
      • remove

        T remove​(Record<?> aRecord)
          throws ColumnMismatchException
        Removes an entry (key and value pair) from the provided Record matching the key and the type of the Column.
        Parameters:
        aRecord - The Record from which to remove the related entry.
        Returns:
        The value related to the given Column instance's key or null if there was none such value found.
        Throws:
        ColumnMismatchException - in case the value in the Record associated with the Column instance's key does not fit the Column instance's type.
      • getValue

        default T getValue​(Record<?> aRecord)
        Retrieves the corresponding value from the provided record.
        Parameters:
        aRecord - The record from which to get the value.
        Returns:
        The according value or null if there is none the such.