com.neurosys.products.dao

Interface ProductDao<T extends Product>

All Superinterfaces:

FreeQuery, GenericDao<T>, QueryableDao<T>

All Known Subinterfaces:

ProductDao<T>, ProductService<T>

All Known Implementing Classes:

ProductDaoImpl, ProductDaoImpl, ProductServiceImpl

public interface ProductDao<T extends Product>
extends QueryableDao<T>

DAO for Product related data model

Author:

Arjun Dhar

Field Summary

Fields

Modifier and Type	Field and Description
static String	FILTER_PARENTS Special Query Attribute: Filter out parent nodes under this parent
static String	FILTER_PARENTS_IMMEDIATE Special Query Attribute: If filterParents is true then this attribute is used to check if we want to filter for immediate

Method Summary

Modifier and Type	Method and Description
void	convert(IHierarchialReference entity, Class to) If we wish to transform an entity type we should perform the transformation and then the update.
int	countFilterParents(T parent, boolean immediate) Return number of nodes that are parents under the specified parent Node The parent node must have a valid Product.getId() or HierarchialDomainObject.getHierarchy(); immediate is false.
Long	delete(Collection<Long> ids)
void	deleteSubHierarchy(T rootNode)
List<T>	filterParents(T parent, boolean immediate) Return List of nodes that are parents under the specified parent Node The parent node must have a valid Product.getId() or HierarchialDomainObject.getHierarchy(); immediate is false.
List<ProductAlias>	getAliasForProduct(T product) For a given Product (T) derive all its ProductAlias
String	getLastChildHierarchyCode(T parent) Get last childs hierarchy code
List<T>	getParents(T product, boolean includeThis, String DEFAULT_PRODUCT_NAME, QueryOptimizer queryOptimizer) Get parents for the product.
boolean	isExistsAsParent(T node)
Page<T>	loadPage(Query<T> query) Load data in paginated fashion.
String	makeSpaceForNodeInParent(T node, T parent, Integer sequence)
void	move(T product, T newParent, Integer order)
ProductAlias	save(ProductAlias alias) Save a ProductAlias
ProductAttribute	save(ProductAttribute attrib) Ability to update a single ProductAttribute without updating the whole Product Useful in Ajax situations where we want to save a partial aspect of the product only.

Methods inherited from interface com.neurosys.dao.jpa.QueryableDao

count, getEntityInstance, query, query, queryPage, queryPage

Methods inherited from interface com.neurosys.dao.GenericDao

delete, delete, load, load, save

Methods inherited from interface com.neurosys.dao.FreeQuery

query, query, update

Field Detail

FILTER_PARENTS

static final String FILTER_PARENTS

Special Query Attribute: Filter out parent nodes under this parent

See Also:

Constant Field Values

FILTER_PARENTS_IMMEDIATE

static final String FILTER_PARENTS_IMMEDIATE

Special Query Attribute: If filterParents is true then this attribute is used to check if we want to filter for immediate

See Also:

Constant Field Values

Method Detail

loadPage

Page<T> loadPage(Query<T> query)

Load data in paginated fashion. See the ProductDao for Query related supported Attributes.
the decision to put a a Query param within the Entity Vs a Related attribute is that, the attributes distinctly indicate that the query should consider that param and also, it supports other relations like "LIKE" etc.

An entity-attribute to be considered in a query would imply the closest match to the Object with the same exact values.

Parameters:

query -

Returns:

getLastChildHierarchyCode

String getLastChildHierarchyCode(T parent)

Get last childs hierarchy code

Parameters:

parent -

Returns:

makeSpaceForNodeInParent

String makeSpaceForNodeInParent(T node,
                                T parent,
                                Integer sequence)

move

void move(T product,
          T newParent,
          Integer order)
   throws Exception

Throws:

Exception

delete

Long delete(Collection<Long> ids)

deleteSubHierarchy

void deleteSubHierarchy(T rootNode)
                 throws Exception

Throws:

Exception

filterParents

List<T> filterParents(T parent,
                      boolean immediate)

Return List of nodes that are parents under the specified parent Node
The parent node must have a valid Product.getId() or HierarchialDomainObject.getHierarchy(); immediate is false.

Parameters:

parent - as T

immediate - as boolean; if true will fetch only parents immediately under the specified parent

Returns:

List of parent Ids that fit the criteria

countFilterParents

int countFilterParents(T parent,
                       boolean immediate)

Return number of nodes that are parents under the specified parent Node
The parent node must have a valid Product.getId() or HierarchialDomainObject.getHierarchy(); immediate is false.

Parameters:

parent - as T

immediate - as boolean; if true will fetch only parents immediately under the specified parent

Returns:

int

convert

void convert(IHierarchialReference entity,
             Class to)

If we wish to transform an entity type we should perform the transformation and then the update. This requires an InheritanceType.SINGLE_TABLE or oen where there is a shared DiscriminatorValue
Note this implementation Update the entity Discriminator in the DB directly : Hacking

save

ProductAttribute save(ProductAttribute attrib)

Ability to update a single ProductAttribute without updating the whole Product
Useful in Ajax situations where we want to save a partial aspect of the product only.

Parameters:

attrib - as ProductAttribute

Returns:

ProductAttribute

save

ProductAlias save(ProductAlias alias)

Save a ProductAlias

Parameters:

alias -

Returns:

getAliasForProduct

List<ProductAlias> getAliasForProduct(T product)

For a given Product (T) derive all its ProductAlias

Parameters:

product -

Returns:

TODO: Rename to getAlias(...)

isExistsAsParent

boolean isExistsAsParent(T node)

getParents

List<T> getParents(T product,
                   boolean includeThis,
                   String DEFAULT_PRODUCT_NAME,
                   QueryOptimizer queryOptimizer)

Get parents for the product.

Parameters:

product - as product

includeThis -

DEFAULT_PRODUCT_NAME - as String of the default product name. If empty, then its not included.

queryOptimizer - as QueryOptimizer

Returns: