org.broadleafcommerce.common.extension

Class TemplateOnlyQueryExtensionManager

java.lang.Object

org.broadleafcommerce.common.extension.ExtensionManager<TemplateOnlyQueryExtensionHandler>

org.broadleafcommerce.common.extension.TemplateOnlyQueryExtensionManager

All Implemented Interfaces:

InvocationHandler, ExtensionHandler, TemplateOnlyQueryExtensionHandler

@Service(value="blTemplateOnlyQueryExtensionManager")
public class TemplateOnlyQueryExtensionManager
extends ExtensionManager<TemplateOnlyQueryExtensionHandler>
implements TemplateOnlyQueryExtensionHandler

Provides specialized filter and restriction behavior for template-related (MT concept) queries. This is only meaningful in a multi-tenant installation.

Author:

Jeff Fischer

See Also:

TemplateOnlyQueryExtensionHandler

Field Summary

Fields

Modifier and Type	Field and Description
static ExtensionManagerOperation	breakdown
static ExtensionManagerOperation	buildStatus
static ExtensionManagerOperation	filterResults
static ExtensionManagerOperation	isValidState
static ExtensionManagerOperation	refineOrder
static ExtensionManagerOperation	refineParameterRetrieve
static ExtensionManagerOperation	refineQuery
static ExtensionManagerOperation	setup

Fields inherited from class org.broadleafcommerce.common.extension.ExtensionManager

extensionHandler, handlers, handlersSorted, LOCK_OBJECT

Constructor Summary

Constructors

Constructor and Description
TemplateOnlyQueryExtensionManager()

Method Summary

Modifier and Type	Method and Description
ExtensionResultStatusType	breakdown(Class<?> type) Perform any breakdown operations.
ExtensionResultStatusType	buildStatus(Object entity, ExtensionResultHolder<ItemStatus> response)
ExtensionResultStatusType	filterResults(Class<?> type, Object testObject, List results) Validate and filter the results.
boolean	isEnabled() If false, the ExtensionManager should skip this Handler.
ExtensionResultStatusType	isValidState(ExtensionResultHolder<Boolean> response) Determine if the current thread is in a valid state for sparse cache handling
ExtensionResultStatusType	refineOrder(Class<?> type, javax.persistence.criteria.CriteriaBuilder builder, javax.persistence.criteria.CriteriaQuery criteria, javax.persistence.criteria.Root root, List<javax.persistence.criteria.Order> sorts) Add sorting to the fetch query
ExtensionResultStatusType	refineParameterRetrieve(Class<?> type, Object testObject, javax.persistence.criteria.CriteriaBuilder builder, javax.persistence.criteria.CriteriaQuery criteria, javax.persistence.criteria.Root root, List<javax.persistence.criteria.Predicate> restrictions) Add additional restrictions to the fetch query.
ExtensionResultStatusType	refineQuery(Class<?> type, Object testObject, javax.persistence.TypedQuery query) Finish the query - possibly setting parameters
ExtensionResultStatusType	setup(Class<?> type) Perform any setup operations.

Methods inherited from class org.broadleafcommerce.common.extension.ExtensionManager

continueOnHandled, execute, getHandlers, getPriority, getProxy, invoke, registerHandler, setHandlers, shouldContinue, sortHandlers

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.broadleafcommerce.common.extension.ExtensionHandler

getPriority

Field Detail

refineParameterRetrieve

public static final ExtensionManagerOperation refineParameterRetrieve

refineQuery

public static final ExtensionManagerOperation refineQuery

setup

public static final ExtensionManagerOperation setup

breakdown

public static final ExtensionManagerOperation breakdown

refineOrder

public static final ExtensionManagerOperation refineOrder

isValidState

public static final ExtensionManagerOperation isValidState

buildStatus

public static final ExtensionManagerOperation buildStatus

filterResults

public static final ExtensionManagerOperation filterResults

Constructor Detail

TemplateOnlyQueryExtensionManager

public TemplateOnlyQueryExtensionManager()

Method Detail

refineParameterRetrieve

public ExtensionResultStatusType refineParameterRetrieve(Class<?> type,
                                                         Object testObject,
                                                         javax.persistence.criteria.CriteriaBuilder builder,
                                                         javax.persistence.criteria.CriteriaQuery criteria,
                                                         javax.persistence.criteria.Root root,
                                                         List<javax.persistence.criteria.Predicate> restrictions)

Description copied from interface: TemplateOnlyQueryExtensionHandler

Add additional restrictions to the fetch query. Use in conjunction with TemplateOnlyQueryExtensionHandler.refineQuery(Class, Object, TypedQuery) to set actual parameter values before retrieving results.

Specified by:

refineParameterRetrieve in interface TemplateOnlyQueryExtensionHandler

Parameters:

type - the class type for the query

testObject - supporting implementations may use this object to test for possible catalog query optimizations. This value can be null, in which case it is ignored.

restrictions - any additional JPA criteria restrictions should be added here

Returns:

the status of the extension operation

refineQuery

public ExtensionResultStatusType refineQuery(Class<?> type,
                                             Object testObject,
                                             javax.persistence.TypedQuery query)

Description copied from interface: TemplateOnlyQueryExtensionHandler

Finish the query - possibly setting parameters

Specified by:

refineQuery in interface TemplateOnlyQueryExtensionHandler

Parameters:

type - the class type for the query

testObject - supporting implementations may use this object to test for possible catalog query optimizations. This value can be null, in which case it is ignored.

query - the final Query instance to embellish

Returns:

setup

public ExtensionResultStatusType setup(Class<?> type)

Description copied from interface: TemplateOnlyQueryExtensionHandler

Perform any setup operations. This is usually done before executing the query and can serve to prepare the BroadleafRequestContext (if applicable).

Specified by:

setup in interface TemplateOnlyQueryExtensionHandler

Parameters:

type - the class type for the query

Returns:

the status of the extension operation

isEnabled

public boolean isEnabled()

Description copied from interface: ExtensionHandler

If false, the ExtensionManager should skip this Handler.

Specified by:

isEnabled in interface ExtensionHandler

Returns:

boolean

breakdown

public ExtensionResultStatusType breakdown(Class<?> type)

Description copied from interface: TemplateOnlyQueryExtensionHandler

Perform any breakdown operations. This is usually done after executing the query and can serve to reset the BroadleafRequestContext (if applicable)

Specified by:

breakdown in interface TemplateOnlyQueryExtensionHandler

Parameters:

type - the class type for the query

Returns:

the status of the extension operation

refineOrder

public ExtensionResultStatusType refineOrder(Class<?> type,
                                             javax.persistence.criteria.CriteriaBuilder builder,
                                             javax.persistence.criteria.CriteriaQuery criteria,
                                             javax.persistence.criteria.Root root,
                                             List<javax.persistence.criteria.Order> sorts)

Description copied from interface: TemplateOnlyQueryExtensionHandler

Add sorting to the fetch query

Specified by:

refineOrder in interface TemplateOnlyQueryExtensionHandler

Parameters:

type - the class type for the query

sorts - any additional JPA order expressions should be added here

Returns:

the status of the extension operation

isValidState

public ExtensionResultStatusType isValidState(ExtensionResultHolder<Boolean> response)

Description copied from interface: TemplateOnlyQueryExtensionHandler

Determine if the current thread is in a valid state for sparse cache handling

Specified by:

isValidState in interface TemplateOnlyQueryExtensionHandler

Returns:

buildStatus

public ExtensionResultStatusType buildStatus(Object entity,
                                             ExtensionResultHolder<ItemStatus> response)

Specified by:

buildStatus in interface TemplateOnlyQueryExtensionHandler

filterResults

public ExtensionResultStatusType filterResults(Class<?> type,
                                               Object testObject,
                                               List results)

Description copied from interface: TemplateOnlyQueryExtensionHandler

Validate and filter the results. This can be interesting when you have restricted the query with a test object and need to confirm the validity of the results. A nuanced example of this would be translations associated with a profile entity (e.g. StructuredContent). If you filter by the StructuredContent, you will be filtering translations by owning site. However, the resulting translations are not profile entities and will not available necessarily to the requesting site. As a result, we filter here and check the translations based on catalog visibility (Translations are dual discriminated). This is primarily to handle edge cases and will generally have no impact on the results.

Specified by:

filterResults in interface TemplateOnlyQueryExtensionHandler

Returns: