xflminterface IF_QueryValidator : public XF_RefCount

This class represents a query validation object.  XFLAIM does not provide an implementation of this interface.  It is up to the application to provide an implementation.  It is a way for an application to plug in a callback mechanism that can apply additional tests to a node or a document to determine if the node or document should be returned from a query.  These might be criteria that are difficult to express in the syntax of the query criteria language - such as whether or not a particular user should be given access to the node or document.  It may be that the policies and information which govern access control decisions are not accessible from within the database.

validateNode

    RCODE validateNode(

        IF_Db *                 pDb,

        IF_DOMNode *    pNode,

        FLMBOOL *         pbPassed);

Validate a node or document that has passed the query criteria.  This method allows an application to apply additional tests to a node or document (such as access control tests) to determine if the node or document should be returned from a query.

    Parameters In:

IF_Db * pDb	Pointer to database object being used during optimization.
IF_DOMNode * pNode	Node or document to be validated.

    Parameters Out

FLMBOOL * pbPassed

Returns a TRUE if the node or document passes the additional tests, FALSE otherwise.  In the case of FALSE, XFLAIM will not return the node or document out through the query object or include it in the query result set.

[Back to Top]