Interface CachedReader


  • public interface CachedReader
    Accessor for stored values. Although several data type accessor methods are provided, in general for a given instance of this class only one of these will give a non-error return (the same one for all rows); it is therefore the responsibility of the user of an instance of this class to keep track of what type is appropriate, since Java's type system will not enforce it. Attempting to retrieve the wrong type of data will give a result (it must not throw an exception), but this result may not be meaningful. This non-type-safe arrangement is used so that primitive objects can be accessed from this interface.

    Attempting to access a value with an index out of range for this reader will also result in undefined behaviour.

    Since:
    25 Apr 2017
    Author:
    Mark Taylor
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      boolean getBooleanValue​(long ix)
      Retrieve the value at a given index as a boolean value.
      double getDoubleValue​(long ix)
      Retrieve the value at a given index as a floating point number.
      int getIntValue​(long ix)
      Retrieve the value at a given index as an integer.
      long getLongValue​(long ix)
      Retrieve the value at a given index a long.
      java.lang.Object getObjectValue​(long ix)
      Retrieve the value at a given index as an object.
    • Method Detail

      • getObjectValue

        java.lang.Object getObjectValue​(long ix)
        Retrieve the value at a given index as an object. Note it is permitted for the same instance to be returned each time, if the object is mutable it may have different values each time (for instance an array with different contents for each row). Therefore the state or contents of the returned object must not be relied on to stay the same between calls to this method.
        Parameters:
        ix - value index
        Returns:
        value
      • getDoubleValue

        double getDoubleValue​(long ix)
        Retrieve the value at a given index as a floating point number.
        Parameters:
        ix - value index
        Returns:
        value
      • getIntValue

        int getIntValue​(long ix)
        Retrieve the value at a given index as an integer.
        Parameters:
        ix - value index
        Returns:
        value
      • getLongValue

        long getLongValue​(long ix)
        Retrieve the value at a given index a long.
        Parameters:
        ix - value index
        Returns:
        value
      • getBooleanValue

        boolean getBooleanValue​(long ix)
        Retrieve the value at a given index as a boolean value.
        Parameters:
        ix - value index
        Returns:
        value