Class Poco::Data::AbstractExtraction

Library: Data
Package: DataCore
Header: Poco/Data/AbstractExtraction.h

Description

AbstractExtraction is the interface class that connects output positions to concrete values retrieved via an AbstractExtractor.

Inheritance

Known Derived Classes: BulkExtraction, Extraction

Member Summary

Member Functions: canExtract, createPreparation, extract, getEmptyStringIsNull, getExtractor, getForceEmptyString, getHeldType, getLimit, isBulk, isNull, isValueNull, numOfColumnsHandled, numOfRowsAllowed, numOfRowsHandled, position, reset, setEmptyStringIsNull, setExtractor, setForceEmptyString, setHeldType, setLimit

Types Aliases

Constructors

AbstractExtraction

AbstractExtraction(
    Poco::UInt32 limit = Limit::LIMIT_UNLIMITED,
    Poco::UInt32 position = 0,
    bool bulk = false
);

Creates the AbstractExtraction. A limit value equal to EXTRACT_UNLIMITED (0xffffffffu) means that we extract as much data as possible during one execute. Otherwise the limit value is used to partition data extracting to a limited amount of rows.

Destructor

~AbstractExtraction

virtual ~AbstractExtraction();

Destroys the AbstractExtraction.

Member Functions

canExtract

virtual bool canExtract() const;

Returns true. Implementations should override it for different behavior.

createPreparation

virtual AbstractPreparation::Ptr createPreparation(
PreparatorPtr & pPrep,
std::size_t pos
) = 0;

Creates and returns shared pointer to Preparation object for the extracting object.

extract

virtual std::size_t extract(
std::size_t pos
) = 0;

Extracts a value from the param, starting at the given column position. Returns the number of rows extracted.

getEmptyStringIsNull

bool getEmptyStringIsNull() const;

Returns the empty string handling flag.

getExtractor

ExtractorPtr getExtractor() const;

Retrieves the extractor object

getForceEmptyString

bool getForceEmptyString() const;

Returns the force empty string flag.

getHeldType

std::string getHeldType() const;

Returns the held type name, if set. If held type name is not set, returns empty string. Held type is optionally set by calling setHeldType<T>() in child classes. Useful for dynamic_cast failure diagnostics.

getLimit

Poco::UInt32 getLimit() const;

Gets the limit.

isBulk

bool isBulk() const;

Returns true if this is bulk extraction.

isNull

virtual bool isNull(
std::size_t row
) const;

In implementations, this function returns true if value at row is null, false otherwise. Normal behavior is to replace nulls with default values. However, extraction implementations may remember the underlying database null values and be able to later provide information about them. Here, this function throws NotImplementedException.

isValueNull

template < typename T > bool isValueNull(
const T & param67,
bool deflt
);

Utility function to determine the nullness of the value. This generic version always returns default value (i.e. does nothing). The std::string overload does the actual work.