com.endeca.portal.data

Class DataSource

java.lang.Object

com.endeca.portal.data.DataSource

public class DataSource
extends java.lang.Object

DataSource instances encapsulate a connection to an MDEX Engine, a current QueryState on the connection, handles the logic of executing a query on an MDEX to get results, and handles the logic of altering the QueryState.

See Also:

QueryState

Constructor Summary

Constructors

Constructor and Description
DataSource(javax.portlet.PortletRequest request)
DataSource(javax.portlet.PortletRequest request, long groupId)
DataSource(javax.portlet.PortletRequest request, com.oracle.endeca.pdi.concepts.mdex.MdexCollectionIdentifier collectionId)
DataSource(javax.portlet.PortletRequest request, MDEXState mdexState)
DataSource(javax.portlet.PortletRequest request, java.lang.String[] boundDataSets)

Method Summary

Methods

Modifier and Type	Method and Description
void	addCollectionData(java.lang.String collectionKey, java.util.List<Record> recordList) Add records to a collection One of the assignments in each 'Record' object should have the unique identifier property key/value.
void	clearMetadataCaches() Clears the caches associated with this datasource.
void	clearMetadataCaches(boolean refresh)
void	clearViewCache() Deprecated. components shouldn't need to manually clear caches anymore
boolean	collectionExists(java.lang.String collectionKey)
java.lang.String	convertEQLToString(com.endeca.mdex.eql_parser.types.Query queryAST) Converts a full EQL Query AST into a readable EQL string.
java.lang.String	convertEQLToString(com.endeca.mdex.eql_parser.types.StandaloneFilter filterAST) Converts an EQL Filter AST into a readable EQL string.
java.lang.String	convertEQLToString(com.endeca.mdex.eql_parser.types.Statement eqlStatement) Converts an single EQL Statement into a readable EQL string.
com.endeca.mdex.conversation.types.Request	createDiscoveryServiceQuery(QueryState state) This method returns a query based on query state.
int	deleteView(java.lang.String viewKey) Deletes the view referenced by the passed keys.
java.lang.String	determineStateName(QueryFunction f) Determines the correct state name for the given QueryFunction for use when applying the QueryFunction to the Request.
QueryResults	execute() Executes a query representing the data source's QueryState.
QueryResults	execute(QueryState queryState) Executes a query representing the QueryState.
QueryResults	execute(QueryState queryState, java.lang.String logMsg) Executes a query representing the QueryState.
com.endeca.mdex.conversation.types.Results	execute(com.endeca.mdex.conversation.types.Request query) Applies security and executes query against the current request's State.
com.endeca.mdex.conversation.types.Results	execute(com.endeca.mdex.conversation.types.Request query, java.lang.String logMsg) Applies security and executes query against the current request's State.
QueryResults	execute(java.lang.String logMsg) Executes a query representing the data source's QueryState.
com.endeca.mdex.config.services.types.Results	executeConfigServiceOperation(com.endeca.mdex.config.services.types.Request configRequest) Executes config service operations
java.util.Collection<CollectionBaseView>	getAllCollections()
java.util.Collection<SemanticView>	getAllCollectionsAndSemanticViews() Get the full set of views, including both collection base views and custom semantic views.
java.util.Collection<SemanticView>	getAllCollectionsAndSemanticViews(boolean includeNonActive) Get the full set of views, including both collection base views and custom semantic views.
java.util.Set<java.lang.String>	getAllNativeCollectionIds()
java.util.Collection<SemanticView>	getAllSemanticViews()
java.util.Collection<SemanticView>	getAllSemanticViews(boolean includeNonActive)
CollectionBaseView	getCollection(com.oracle.endeca.pdi.concepts.mdex.MdexCollectionIdentifier collectionId) Get a CollectionBaseView from an MdexCollectionIdentifier.
CollectionBaseView	getCollection(java.lang.String collectionKey) Get a CollectionBaseView that represents a collection base view.
SemanticView	getCollectionOrSemanticView(java.lang.String viewKey) Get a named SemanticView, which could be either a collection base view or a custom semantic view.
long	getGroupId()
java.util.List<IncompleteCollectionState>	getIncompleteCollections()
QueryState	getInitialQueryState() Retrieve the base QueryState on this data source, which is the InitialQueryState + baseFilte
protected MDEXState	getMDEXState()
java.util.Collection<PredefinedMetric>	getPredefinedMetrics(java.lang.String viewKey) Get all predefined metrics for a given view.
QueryState	getQueryState() Retrieve the current query state on this data source.
protected RequestIds	getRequestIds()
SemanticView	getSemanticView(java.lang.String viewKey) Get a custom SemanticView by the specified viewKey.
java.lang.String	getServiceURL() Return the service URL state for this data source.
java.util.List<java.lang.String>	getTypeAheadTags() Returns list of tags for this project.
protected UserSession	getUserSession()
boolean	isAvailable()
boolean	isOnline() Returns the cached availability of this data domain.
com.endeca.mdex.eql_parser.types.ExpressionBase	parseLQLExpression(java.lang.String expression) Parse an LQL Filter string and return a parsed ExpressionBase object form of that string.
com.endeca.mdex.eql_parser.types.Query	parseLQLQuery(java.lang.String query, boolean validationEnabled) Parse an EQL Query string and return a parsed object form of that string.
int	putView(SemanticView sView) Adds or updates a custom semantic view or a collection.
void	resetQueryState() Reset the data source's query state to what it's initial state was.
void	resetVisibleQueryState() Removes only "visible" query filters from all collections.
void	resetVisibleQueryState(CollectionBaseView collection) Removes only "visible" query filters from a single collection.
boolean	semanticViewExists(java.lang.String viewKey)
void	setQueryState(QueryState newState) Set the state of this data source.
void	updateCollectionData(java.lang.String collectionKey, java.util.List<Record> recordList) Update records in a collection The 'recordSpecifier' in 'Record' objects should have the unique identifier property key/value.
com.endeca.endeca_server.sconfig.types.ValidateEntitiesResponse	validateView(SemanticView sView) Validates a custom semantic view.

Methods inherited from class java.lang.Object

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

Constructor Detail

DataSource

public DataSource(javax.portlet.PortletRequest request)
           throws DataSourceException

Throws:

DataSourceException

DataSource

public DataSource(javax.portlet.PortletRequest request,
          MDEXState mdexState)
           throws DataSourceException

Throws:

DataSourceException

DataSource

public DataSource(javax.portlet.PortletRequest request,
          java.lang.String[] boundDataSets)
           throws DataSourceException

Throws:

DataSourceException

DataSource

public DataSource(javax.portlet.PortletRequest request,
          com.oracle.endeca.pdi.concepts.mdex.MdexCollectionIdentifier collectionId)
           throws DataSourceException

Throws:

DataSourceException

DataSource

public DataSource(javax.portlet.PortletRequest request,
          long groupId)
           throws DataSourceException

Throws:

DataSourceException

Method Detail

getUserSession

protected UserSession getUserSession()
                              throws UserSessionException

Throws:

UserSessionException

getMDEXState

protected MDEXState getMDEXState()

getRequestIds

protected RequestIds getRequestIds()

getServiceURL

public java.lang.String getServiceURL()

Return the service URL state for this data source.

Returns:

The service URL state for this data source

isAvailable

public boolean isAvailable()

Returns:

true if this data source is up, false otherwise. This returns true, even if the datasource is in read only mode and config updates are not available.

isOnline

public boolean isOnline()

Returns the cached availability of this data domain. This call relied on the previously established availability status, and will not re-test or update the status. It will not result in waking an idle data domain. If status refresh is desired, use the isAvailable() method.

Returns:

true if the data domain was available at last check

See Also:

MDEXState.isOnline()

getQueryState

public QueryState getQueryState()
                         throws DataSourceException

Retrieve the current query state on this data source.

Returns:

the query state

Throws:

DataSourceException

setQueryState

public void setQueryState(QueryState newState)
                   throws DataSourceException

Set the state of this data source. The exact manner in which this method effects stored QueryState depends heavily on what MDEX State Manager you have configured.

Parameters:

newState - The new state to "push"

Throws:

DataSourceException

getInitialQueryState

public QueryState getInitialQueryState()
                                throws DataSourceException

Retrieve the base QueryState on this data source, which is the InitialQueryState + baseFilte

Returns:

The query state initially configured on this data source and base filter included

Throws:

DataSourceException

resetQueryState

public void resetQueryState()
                     throws DataSourceException

Reset the data source's query state to what it's initial state was.

Throws:

DataSourceException

resetVisibleQueryState

public void resetVisibleQueryState()
                            throws DataSourceException

Removes only "visible" query filters from all collections. Used, for example, for Searchbox when search within is unchecked and search is submitted against "All Data".

Throws:

DataSourceException

resetVisibleQueryState

public void resetVisibleQueryState(CollectionBaseView collection)
                            throws DataSourceException

Removes only "visible" query filters from a single collection. Used, for example, by Breadcrumbs Reset and Searchbox when search within is unchecked and search is submitted against a single data set. Requirements of this variant of reset are as follows: 1) Invoking this method will do the equivalent of clicking the delete "x" next to each item in the visible breadcrumbs. That is, it does NOT clear all of the filter state for all data sets. It clears the items you're seeing. 2) Invoking this method also resets base filter(s) to their default state. There is only one base filter per data set. 3) Only visible filters will be removed. Any filters in the query state that the breadcrumbs does not know how to display will be left alone. In other words, if a user created/deployed a custom query function (e.g. MySpecialFooBarLineItemFilter extends QueryFunction), that, too, would not be removed since it's not something we consider "visible" and know how to display. You'd have to deploy your own component to show those and allow adding/editing/removing those.

Parameters:

collection - the CollectionBaseView from whose query state to remove visible filters

Throws:

DataSourceException

execute

public QueryResults execute()
                     throws DataSourceException

Executes a query representing the data source's QueryState. This method applies security logic as managed by the MDEX Security Manager.

Returns:

The results of executing the query

Throws:

DataSourceException

execute

public QueryResults execute(java.lang.String logMsg)
                     throws DataSourceException

Executes a query representing the data source's QueryState. This method applies security logic as managed by the MDEX Security Manager.

Parameters:

logMsg - - additional message used for performance metrics log

Returns:

The results of executing the query

Throws:

DataSourceException

execute

public QueryResults execute(QueryState queryState)
                     throws DataSourceException

Executes a query representing the QueryState. This method applies security logic as managed by the MDEX Security Manager.

Parameters:

queryState -

Returns:

The results of executing the query

Throws:

DataSourceException

execute

public QueryResults execute(QueryState queryState,
                   java.lang.String logMsg)
                     throws DataSourceException

Executes a query representing the QueryState. This method applies security logic as managed by the MDEX Security Manager.

Parameters:

queryState -

logMsg - - additional message used for performance metrics log

Returns:

The results of executing the query

Throws:

DataSourceException

clearMetadataCaches

public void clearMetadataCaches()

Clears the caches associated with this datasource. Because attributes, attribute groups, and entities are inter-dependent, if you update attributes or attribute groups, you should use this method to update all three items so they are consistent with each other.

clearMetadataCaches

public void clearMetadataCaches(boolean refresh)
                         throws DataSourceAccessException,
                                DataSourceException

Throws:

DataSourceAccessException

DataSourceException

clearViewCache

@Deprecated
public void clearViewCache()

Deprecated. components shouldn't need to manually clear caches anymore

Clears any information that is cached related to the entity information for this data source. If you are modifying entity groups, you should call DataSource.clearMetadataCaches instead of this method so the attribute group cache is cleared in addition to the entity cache.

collectionExists

public boolean collectionExists(java.lang.String collectionKey)

semanticViewExists

public boolean semanticViewExists(java.lang.String viewKey)

getCollection

public CollectionBaseView getCollection(java.lang.String collectionKey)
                                 throws KeyNotFoundException,
                                        DataSourceAccessException,
                                        DataSourceException

Get a CollectionBaseView that represents a collection base view. The collection cache is initialized if necessary.

Parameters:

collectionKey - key of the mdex collection sought

Returns:

matching CollectionBaseView

Throws:

KeyNotFoundException - if the collection with the specified key is not found

DataSourceException - if there was a query error when getting collection metadata

DataSourceAccessException

getCollection

public CollectionBaseView getCollection(com.oracle.endeca.pdi.concepts.mdex.MdexCollectionIdentifier collectionId)
                                 throws KeyNotFoundException,
                                        DataSourceException

Get a CollectionBaseView from an MdexCollectionIdentifier.

Parameters:

collectionId -

Returns:

Throws:

KeyNotFoundException

DataSourceException

getAllCollections

public java.util.Collection<CollectionBaseView> getAllCollections()
                                                           throws DataSourceAccessException,
                                                                  DataSourceException

Returns:

a Collection of all the cached CollectionBaseViews

Throws:

DataSourceException - if there was a query error when getting collection metadata

DataSourceAccessException

getAllNativeCollectionIds

public java.util.Set<java.lang.String> getAllNativeCollectionIds()

Returns:

all the native collection ids of the collections bound this datasource

getSemanticView

public SemanticView getSemanticView(java.lang.String viewKey)
                             throws KeyNotFoundException,
                                    DataSourceException

Get a custom SemanticView by the specified viewKey. The cache of view information is initialized if necessary.

Parameters:

request - TODO

viewKey - key of the mdex view sought

Returns:

matching semantic view

Throws:

KeyNotFoundException - if the view with the specified key is not found

DataSourceExcpetion - if there was a query error when getting view metadata

DataSourceException

getAllSemanticViews

public java.util.Collection<SemanticView> getAllSemanticViews()
                                                       throws DataSourceAccessException,
                                                              DataSourceException

Returns:

a Collection of all the cached custom SemanticViews, including active and non-active views.

Throws:

DataSourceException - if there was a query error when getting view metadata

DataSourceAccessException

getAllSemanticViews

public java.util.Collection<SemanticView> getAllSemanticViews(boolean includeNonActive)
                                                       throws DataSourceAccessException,
                                                              DataSourceException

Parameters:

Whether - to include non-active views or not.

Returns:

a Collection of all the cached custom SemanticViews

Throws:

DataSourceException - if there was a query error when getting view metadata

DataSourceAccessException

getCollectionOrSemanticView

public SemanticView getCollectionOrSemanticView(java.lang.String viewKey)
                                         throws KeyNotFoundException,
                                                DataSourceException

Get a named SemanticView, which could be either a collection base view or a custom semantic view.

Parameters:

viewKey - key of the collection or semantic view sought

Returns:

matching view

Throws:

KeyNotFoundException - if the view with the specified key is not found

DataSourceExcpetion - if there was a query error when getting view metadata

DataSourceException

getAllCollectionsAndSemanticViews

public java.util.Collection<SemanticView> getAllCollectionsAndSemanticViews()
                                                                     throws DataSourceException

Get the full set of views, including both collection base views and custom semantic views.

Returns:

a Collection a SemanticViews

Throws:

DataSourceExcpetion - if there was a query error when getting view metadata

DataSourceException

getAllCollectionsAndSemanticViews

public java.util.Collection<SemanticView> getAllCollectionsAndSemanticViews(boolean includeNonActive)
                                                                     throws DataSourceException

Get the full set of views, including both collection base views and custom semantic views.

Parameters:

Whether - to include non-active views or not.

Returns:

a Collection a SemanticViews

Throws:

DataSourceExcpetion - if there was a query error when getting view metadata

DataSourceException

execute

public com.endeca.mdex.conversation.types.Results execute(com.endeca.mdex.conversation.types.Request query)
                                                   throws DataSourceException

Applies security and executes query against the current request's State.

Parameters:

query - The query to execute

Returns:

The results of executing the query

Throws:

DataSourceException

execute

public com.endeca.mdex.conversation.types.Results execute(com.endeca.mdex.conversation.types.Request query,
                                                 java.lang.String logMsg)
                                                   throws DataSourceException

Applies security and executes query against the current request's State.

Parameters:

query - The query to execute

logMsg - additional log message for performance metrics log

Returns:

The results of executing the query

Throws:

DataSourceException

executeConfigServiceOperation

public com.endeca.mdex.config.services.types.Results executeConfigServiceOperation(com.endeca.mdex.config.services.types.Request configRequest)
                                                                            throws DataSourceException

Executes config service operations

Parameters:

configRequest - the Request to execute

Returns:

The results of executing the request

Throws:

DataSourceException

deleteView

public int deleteView(java.lang.String viewKey)
               throws KeyNotFoundException,
                      DataSourceException

Deletes the view referenced by the passed keys. Available only on updatable MDEXes. Passing in locale from current request so any error messages come back in the user's current language.

Parameters:

viewKey - references the view to delete

Returns:

number of views deleted

Throws:

KeyNotFoundException

DataSourceException

updateCollectionData

public void updateCollectionData(java.lang.String collectionKey,
                        java.util.List<Record> recordList)
                          throws KeyNotFoundException,
                                 DataSourceException

Update records in a collection The 'recordSpecifier' in 'Record' objects should have the unique identifier property key/value.

Parameters:

collectionKey -

recordList -

Throws:

KeyNotFoundException

DataSourceException

addCollectionData

public void addCollectionData(java.lang.String collectionKey,
                     java.util.List<Record> recordList)
                       throws KeyNotFoundException,
                              DataSourceException

Add records to a collection One of the assignments in each 'Record' object should have the unique identifier property key/value.

Parameters:

collectionKey -

recordList -

Throws:

KeyNotFoundException

DataSourceException

putView

public int putView(SemanticView sView)
            throws DataSourceException

Adds or updates a custom semantic view or a collection.

Parameters:

sView - a SemanticView or CollectionBaseView to add or update

Returns:

number of added or updated views

Throws:

DataSourceException

validateView

public com.endeca.endeca_server.sconfig.types.ValidateEntitiesResponse validateView(SemanticView sView)
                                                                             throws DataSourceException

Validates a custom semantic view.

Parameters:

sView - a SemanticView to validate

Returns:

the ValidateEntityResponse

Throws:

DataSourceException

parseLQLExpression

public com.endeca.mdex.eql_parser.types.ExpressionBase parseLQLExpression(java.lang.String expression)
                                                                   throws LQLException

Parse an LQL Filter string and return a parsed ExpressionBase object form of that string. An example of a filter is "P_Price < 50". The syntax matches the syntax in the WHERE clause of an LQL Query expression, without the "WHERE". This method should parse and type-check the expression, so if you use an attribute that does not exist, it will throw a ParserFault. The returned objects can be used in the DataSourceFilter and SelectionFilter QueryFunctions. This method internally calls parseLQLFilter(String).

Parameters:

expression - String that represents the filter

Returns:

ExpressionBase object representation of the filter

Throws:

LqlException

LQLException

parseLQLQuery

public com.endeca.mdex.eql_parser.types.Query parseLQLQuery(java.lang.String query,
                                                   boolean validationEnabled)
                                                     throws DataSourceException,
                                                            LQLException

Parse an EQL Query string and return a parsed object form of that string. An example of a query is "RETURN results as SELECT AVG(P_Cost) as P_Cost WHERE P_Price < 50 GROUP BY P_Year". When validationEnabled is set to true, this method should parse and type-check the expression. So if you use an attribute that does not exist or do a comparison that using the wrong types it will throw a ParserFault. When validationEnabled is set to false, type-checking is disabled.

Parameters:

query - String that represents the query

validationEnabled - boolean to enable/disable query validation

Returns:

Query object containing the parsed EQLQuery AST

Throws:

LQLException - if the filter has a syntax or type-checking error a LQLException will be thrown

DataSourceException - any non-expected exception

convertEQLToString

public java.lang.String convertEQLToString(com.endeca.mdex.eql_parser.types.Query queryAST)

Converts a full EQL Query AST into a readable EQL string.

Parameters:

queryAST - a full EQL Query (list of Statements)

Returns:

EQL string

Throws:

com.endeca.mdex.eql_parser.EqlException

convertEQLToString

public java.lang.String convertEQLToString(com.endeca.mdex.eql_parser.types.Statement eqlStatement)

Converts an single EQL Statement into a readable EQL string.

Parameters:

eqlStatement -

Returns:

EQL string

convertEQLToString

public java.lang.String convertEQLToString(com.endeca.mdex.eql_parser.types.StandaloneFilter filterAST)

Converts an EQL Filter AST into a readable EQL string.

Parameters:

filterAST - a filter expression

Returns:

EQL string

getPredefinedMetrics

public java.util.Collection<PredefinedMetric> getPredefinedMetrics(java.lang.String viewKey)
                                                            throws KeyNotFoundException,
                                                                   DataSourceException

Get all predefined metrics for a given view.

Parameters:

viewKey - key of a view whose metrics are sought

Returns:

the List of PredefinedMetric objects

Throws:

KeyNotFoundException - if there is no semantic view matching the provided key

DataSourceException - if a query error is encountered loading view metadata

createDiscoveryServiceQuery

public com.endeca.mdex.conversation.types.Request createDiscoveryServiceQuery(QueryState state)
                                                                       throws DataSourceException

This method returns a query based on query state.

Parameters:

state -

Returns:

Request

Throws:

DataSourceException

determineStateName

public java.lang.String determineStateName(QueryFunction f)
                                    throws DataSourceException,
                                           KeyNotFoundException

Determines the correct state name for the given QueryFunction for use when applying the QueryFunction to the Request.

Parameters:

f - a QueryFunction to potentially associate with a named state

Returns:

the name of the state appropriate for this QueryFunction or null if no state name should be set

Throws:

DataSourceException - if there was a problem retrieving Collections or SemanticViews underpinning this DataSource

KeyNotFoundException - if the QueryFunction references an unknown view key

getIncompleteCollections

public java.util.List<IncompleteCollectionState> getIncompleteCollections()

getTypeAheadTags

public java.util.List<java.lang.String> getTypeAheadTags()
                                                  throws DataSourceException

Returns list of tags for this project. This includes data set tags and tags for all attributes for the data sets bound to this project. This is used in typeahead for attribute details tag panel.

Returns:

Throws:

DataSourceException

getGroupId

public long getGroupId()