com.yahoo.bard.webservice.table.resolver

Class BasePhysicalTableResolver

java.lang.Object

com.yahoo.bard.webservice.table.resolver.BasePhysicalTableResolver

All Implemented Interfaces:

PhysicalTableResolver

Direct Known Subclasses:

DefaultPhysicalTableResolver

public abstract class BasePhysicalTableResolver
extends Object
implements PhysicalTableResolver

Abstract parent to with business rule agnostic implementations of core methods.

Constructor Summary

Constructors

Constructor and Description
BasePhysicalTableResolver()

Method Summary

Modifier and Type	Method and Description
Set<PhysicalTable>	filter(Collection<PhysicalTable> candidateTables, List<PhysicalTableMatcher> matchers) Filter a list of tables through each matcher using a list of matchers sequentially.
Set<PhysicalTable>	filter(Collection<PhysicalTable> candidateTables, QueryPlanningConstraint requestConstraint) Filter to a set of tables matching the rules of this resolver.
abstract BinaryOperator<PhysicalTable>	getBetterTableOperator(QueryPlanningConstraint requestConstraint) Create a binary operator which returns the 'better' of two physical table.
abstract List<PhysicalTableMatcher>	getMatchers(QueryPlanningConstraint requestConstraint) Create a list of matchers based on a request and query.
PhysicalTable	resolve(Collection<PhysicalTable> candidateTables, QueryPlanningConstraint requestConstraint) Choose the best fit Physical Table from a table group.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BasePhysicalTableResolver

public BasePhysicalTableResolver()

Method Detail

getMatchers

public abstract List<PhysicalTableMatcher> getMatchers(QueryPlanningConstraint requestConstraint)

Create a list of matchers based on a request and query.

Parameters:

requestConstraint - contains the request constraints extracted from DataApiRequest and TemplateDruidQuery

Returns:

a list of matchers to be applied, in order

getBetterTableOperator

public abstract BinaryOperator<PhysicalTable> getBetterTableOperator(QueryPlanningConstraint requestConstraint)

Create a binary operator which returns the 'better' of two physical table.

Parameters:

requestConstraint - contains the request constraints extracted from DataApiRequest and TemplateDruidQuery

Returns:

a list of matchers to be applied, in order

filter

public Set<PhysicalTable> filter(Collection<PhysicalTable> candidateTables,
                                 QueryPlanningConstraint requestConstraint)
                          throws NoMatchFoundException

Filter to a set of tables matching the rules of this resolver.

Parameters:

candidateTables - The physical tables being filtered

requestConstraint - contains the request constraints extracted from DataApiRequest and TemplateDruidQuery

Returns:

a set of physical tables which all match the criteria of a request and partial query

Throws:

NoMatchFoundException - if any of the filters reduce the filter set to empty

filter

public Set<PhysicalTable> filter(Collection<PhysicalTable> candidateTables,
                                 List<PhysicalTableMatcher> matchers)
                          throws NoMatchFoundException

Filter a list of tables through each matcher using a list of matchers sequentially.

Parameters:

candidateTables - The collection of tables to be filtered

matchers - The matchers to apply, in order

Returns:

A set of tables which satisfy all matchers

Throws:

NoMatchFoundException - if no tables match the filter

resolve

public PhysicalTable resolve(Collection<PhysicalTable> candidateTables,
                             QueryPlanningConstraint requestConstraint)
                      throws NoMatchFoundException

Description copied from interface: PhysicalTableResolver

Choose the best fit Physical Table from a table group.

Specified by:

resolve in interface PhysicalTableResolver

Parameters:

candidateTables - The tables being considered for match

requestConstraint - Contains the request constraints extracted from DataApiRequest and TemplateDruidQuery

Returns:

The table, if any, that satisfies all criteria and best matches the query

Throws:

NoMatchFoundException - if there is no matching physical table in the table group