com.konakartadmin.bl

Class AdminCategoryMgr

java.lang.Object

com.konakartadmin.bl.AdminBaseMgr

com.konakartadmin.bl.AdminCategoryMgr

All Implemented Interfaces:

AdminCategoryMgrIf

public class AdminCategoryMgr
extends AdminBaseMgr
implements AdminCategoryMgrIf

The AdminCategoryMgr - for Managing Category Objects for the Admin Application

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AdminCategoryMgr.CategoryStats Used to contain the number of categories and last modified category in order to determine whether the category tree has been modified.
protected class	AdminCategoryMgr.StaticData Used to store the static data of this manager

Field Summary

Fields

Modifier and Type	Field and Description
static int	ATTACH_CHILDREN_TO_PARENT Used by deleteCategoryTree
static int	DELETE_CHILDREN Used by deleteCategoryTree
protected static org.apache.commons.logging.Log	log the log
protected static java.lang.String	mutex
protected static java.util.Map<java.lang.String,AdminCategoryMgr.StaticData>	staticDataHM Hash Map that contains the static data

Fields inherited from class com.konakartadmin.bl.AdminBaseMgr

adminEng, baseMgrMutex, baseStaticDataHM, cDataEnd, cDataStart, debugStackTraceExclusions, kkAdminPropsFilePath, kkConf, kkInstanceId, mgrFactory, STORE_ID, templateBaseDir

Constructor Summary

Constructors

Constructor and Description
AdminCategoryMgr(KKAdminIf eng) Constructor

Method Summary

Modifier and Type	Method and Description
private void	addCatsToList(AdminCategory[] cats, java.util.List<AdminCategory> flatCatList) Recursive method to add all categories to the list
private void	addCatsToMap(AdminCategory[] cats, java.util.HashMap<java.lang.Integer,AdminCategory> hm) Recursive method to add all categories to the map
protected AdminCategory[]	cloneTree(AdminCategory[] tree)
protected AdminCategory[]	createCategoryTree(int languageId) Creates a category tree with a single query
protected void	deleteCatAndChildren(int categoryId) Deletes this category plus all of the child categories plus any products that exist.
void	deleteCategoryTree(int categoryId, int options) Delete the category referenced to by categoryId.
void	deleteSingleCategory(int categoryId) Delete a single category.
boolean	doesCategoryExist(int categoryId) Return true if the category exists.
boolean	doesCategoryExist(int categoryId, java.sql.Connection con) Return true if the category exists.
void	editCategory(AdminCategory cat) Edit the category.
protected void	fillCatTreeWithProductNumbers(AdminCategory[] catTree) Receives an array of Categories as input and compiles the numberOfProducts field for each Category
AdminCategory[]	getAllCategories(int languageId) Returns an array of all categories sparsely-populated with Id and name (in the specified language) only.
AdminCategory[]	getAllCategoryImages() Returns an array of all categories sparsely-populated with Id and image name only.
AdminCategory[]	getCategoriesPerProduct(int productId, int languageId) Returns all of the categories for the product
AdminCategory[]	getCategoriesPerPromotion(int promotionId, int languageId) Returns all of the categories for the promotion
int[]	getCategoriesPerTagGroup(int tagGroupId) Return an array of Category Ids linked to the specified tag group.
AdminCategoryToTagGroup[]	getCategoriesToTagGroups() Return an array of all of the AdminCategoryToTagGroup records.
AdminCategory	getCategory(int categoryId, boolean getChildren, int languageId)
AdminCategory	getCategory(int categoryId, boolean getChildren, int languageId, java.sql.Connection con)
AdminCategory	getCategory(int categoryId, boolean getChildren, int languageId, java.lang.String storeId)
AdminCategory	getCategory(int categoryId, boolean getChildren, int languageId, java.lang.String storeId, java.sql.Connection con)
AdminCategory	getCategoryFromCache(int catId, int languageId) It returns the category from a hash map created when building the category tree.
int	getCategoryLevel(AdminCategory cat) Method that calculates the level of the category where 0 is the top level, 1 is the first child level etc.
AdminCategory[]	getCategoryTree(int languageId, boolean getNumProducts) Returns an array of top level categories each of which includes an array of child categories etc.
AdminCategory[]	getCategoryTreeFlattenedList(AdminCategory[] catTree) Creates an array of all categories from the Category Tree specified.
AdminCategory[]	getCategoryTreeFromCache(int languageId) It returns the category tree from the cache.
int[]	getChildren(int categoryId) Returns an array of categoryId describing the children of the given category.
protected AdminCategory[]	getChildren(int parentId, int languageId) Returns an array of child categories, children of the input parameter, parent.
AdminCategoryMgr.CategoryStats	getLastModifiedData() Retrieves the date of the last modified category and the number of categories in the database.
AdminMiscItem[]	getMiscItems(AdminSearch search) Get the MiscItems associated with the specified search criteria
AdminMiscItem[]	getMiscItems(int catgeoryId) Get the MiscItems associated with the specified catgeoryId
protected int	getNumProductsPerCategory(int categoryId) Returns the number of products for a leaf category by doing a direct query on the database.
protected java.util.HashMap<java.lang.Integer,java.lang.Integer>	getProductIdsPerCategory() Returns a HashMap with CategoryId as the key and Number of Products for that category as the value.
AdminCategory[]	getTopLevelCategories(int languageId, AdminDataDescriptor dataDesc) Returns all of the top level categories which are those that have a parentId = 0.
protected void	initStaticVariables(AdminCategoryMgr.CategoryStats catStats) A synchronized method to initialise the static variables
int	insertCategory(AdminCategory cat) Insert a category as a child of the parent category.
protected void	manageDataDescriptor(AdminDataDescriptor dataDesc, com.konakart.db.KKCriteria c) Provides common code to deal with the management of the DataDescriptor.
void	moveCategory(int categoryId, int newParentId) Move this category to make it a child of the category identified by newParentId
protected com.konakart.db.KKCriteria	setAllCategoryAttrs(com.konakart.db.KKCriteria c)
protected com.konakart.db.KKCriteria	setAllCategoryAttrs(com.konakart.db.KKCriteria c, int languageId)
protected void	setChildrenProductNumbers(AdminCategory parent, java.util.HashMap<java.lang.Integer,java.lang.Integer> hm) Recurses through all of the category tree setting the numberOfProducts attribute.
protected void	validateCategory(AdminCategory cat) Used to validate a category before editing or inserting

Methods inherited from class com.konakartadmin.bl.AdminBaseMgr

addInsertAttr, addInsertAttr, addStringRuleConstraint, addStringRuleConstraint, checkAPICallEnabled, checkIntInRange, checkIntIsSet, checkRequired, executeQuery, executeQuery, getAdminAddressMgr, getAdminAuditMgr, getAdminBillingMgr, getAdminBookableProductMgr, getAdminCatMgr, getAdminConfigMgr, getAdminContentMgr, getAdminCurrMgr, getAdminCustMgr, getAdminCustPwdHistMgr, getAdminCustTagMgr, getAdminEmailMgr, getAdminEng, getAdminEngineCacheMgr, getAdminEventMgr, getAdminExecuteMgr, getAdminFileMgr, getAdminFilterMgr, getAdminHtmlMgr, getAdminImportMgr, getAdminLanguageMgr, getAdminManuMgr, getAdminMessageMgr, getAdminMiscItemMgr, getAdminMiscPriceMgr, getAdminModulesMgr, getAdminMultiStoreMgr, getAdminOrderMgr, getAdminPdfMgr, getAdminProdAttrMgr, getAdminProdMgr, getAdminPromMgr, getAdminReviewMgr, getAdminSearchRuleMgr, getAdminSecMgr, getAdminServletMgr, getAdminShipmentMgr, getAdminSolrMgr, getAdminStoreMgr, getAdminSuggestionMgr, getAdminTagMgr, getAdminTaxMgr, getAdminValidationMgr, getAdminVelocityContextMgr, getAdminWishListMgr, getBooleanFromString, getDebugStackTraceExclusions, getEmailThreadGracefulShutdownTimeout, getExportMgr, getExportMgr, getExportXMLData, getIntFromString, getKkAdminPropsFilePath, getKkConfig, getKkInstanceId, getMode, getModeString, getMqMgr, getNewCriteria, getNewCriteria, getNewCriteria, getNewCriteria, getOtherModuleByName, getPostSearchText, getPreSearchText, getProductsToCategoresCriteria, getPropertyValue, getPropertyValue, getPropertyValueAsBool, getPropertyValueAsInt, getPropertyValueAsLong, getRecordCount, getRecordCount, getRewardPointMgr, getSingleIntResult, getStoreId, getTemplate, getTemplateBase, getXml_io, init, insertKKEvent, insertKKEvent, isBusiness, isBusinessOrEnterprise, isCommunity, isConfigSet, isEnterprise, isMultiStoreLanguagesShared, isMultiStoreMode, isMultiStoreShareCategories, isMultiStoreShareCustomers, isMultiStoreShareCustomersOrProducts, isMultiStoreShareProducts, isMultiStoreSingleDBCSMode, isMultiStoreSingleDBMode, isMultiStoreSingleDBNonCSMode, isUnix, isWindows, manageException, manageThrowable, refreshConfigs, removeCData, sendMQMessages, setAdminEng, setDebugStackTraceExclusions, setKkAdminPropsFilePath, setupWildCardRules, setWildCardAfter, setWildCardBefore, shutdownGracefully, shutdownGracefully, timestampStr, updateStaticVariablesNow

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static org.apache.commons.logging.Log log

the log

DELETE_CHILDREN

public static final int DELETE_CHILDREN

Used by deleteCategoryTree

See Also:

Constant Field Values

ATTACH_CHILDREN_TO_PARENT

public static final int ATTACH_CHILDREN_TO_PARENT

Used by deleteCategoryTree

See Also:

Constant Field Values

mutex

protected static java.lang.String mutex

staticDataHM

protected static java.util.Map<java.lang.String,AdminCategoryMgr.StaticData> staticDataHM

Hash Map that contains the static data

Constructor Detail

AdminCategoryMgr

public AdminCategoryMgr(KKAdminIf eng)
                 throws java.lang.Exception

Constructor

Parameters:

eng - KKAdmin engine

Throws:

java.lang.Exception - an unexpected exception

Method Detail

getCategoryTree

public AdminCategory[] getCategoryTree(int languageId,
                                       boolean getNumProducts)
                                throws java.lang.Exception

Returns an array of top level categories each of which includes an array of child categories etc. so that the category tree structure can be navigated.

Each Category class contains a field that describes how many products exist for that category. This field is calculated if getNumProducts is set to true.

Specified by:

getCategoryTree in interface AdminCategoryMgrIf

Parameters:

languageId - the languageId

getNumProducts - the getNumProducts

Returns:

Array of Category Objects

Throws:

java.lang.Exception - an unexpected exception

addCatsToMap

private void addCatsToMap(AdminCategory[] cats,
                          java.util.HashMap<java.lang.Integer,AdminCategory> hm)

Recursive method to add all categories to the map

Parameters:

cats - the cats

hm - the hm

getCategoryTreeFlattenedList

public AdminCategory[] getCategoryTreeFlattenedList(AdminCategory[] catTree)

Description copied from interface: AdminCategoryMgrIf

Creates an array of all categories from the Category Tree specified. Rather than just having the top level categories (with their children, and their children's children) as elements it flattens the tree structure to show all categories.

Specified by:

getCategoryTreeFlattenedList in interface AdminCategoryMgrIf

Parameters:

catTree - the catTree

Returns:

Array of all Category Objects

addCatsToList

private void addCatsToList(AdminCategory[] cats,
                           java.util.List<AdminCategory> flatCatList)

Recursive method to add all categories to the list

Parameters:

cats - the categories / child categories

flatCatList - a flattened list of categories

getCategoryFromCache

public AdminCategory getCategoryFromCache(int catId,
                                          int languageId)
                                   throws java.lang.Exception

It returns the category from a hash map created when building the category tree. The category contains the children. It's not a clone and so shouldn't be modified.

Specified by:

getCategoryFromCache in interface AdminCategoryMgrIf

Parameters:

catId - the catId

languageId - the languageId

Returns:

An admin category object

Throws:

java.lang.Exception - an unexpected exception

getCategoryTreeFromCache

public AdminCategory[] getCategoryTreeFromCache(int languageId)
                                         throws java.lang.Exception

It returns the category tree from the cache. It's not a clone and so shouldn't be modified.

Specified by:

getCategoryTreeFromCache in interface AdminCategoryMgrIf

Parameters:

languageId - the languageId

Returns:

Returns the category tree

Throws:

java.lang.Exception - an unexpected exception

getCategoryLevel

public int getCategoryLevel(AdminCategory cat)
                     throws java.lang.Exception

Method that calculates the level of the category where 0 is the top level, 1 is the first child level etc.

Specified by:

getCategoryLevel in interface AdminCategoryMgrIf

Parameters:

cat - the cat

Returns:

Returns the category level

Throws:

java.lang.Exception - an unexpected exception

getAllCategories

public AdminCategory[] getAllCategories(int languageId)
                                 throws java.lang.Exception

Returns an array of all categories sparsely-populated with Id and name (in the specified language) only.

Specified by:

getAllCategories in interface AdminCategoryMgrIf

Parameters:

languageId - the languageId

Returns:

Array of sparsely-populated Category Objects

Throws:

java.lang.Exception - an unexpected exception

getAllCategoryImages

public AdminCategory[] getAllCategoryImages()
                                     throws java.lang.Exception

Returns an array of all categories sparsely-populated with Id and image name only.

Specified by:

getAllCategoryImages in interface AdminCategoryMgrIf

Returns:

Array of sparsely-populated Category Objects

Throws:

java.lang.Exception - an unexpected exception

getTopLevelCategories

public AdminCategory[] getTopLevelCategories(int languageId,
                                             AdminDataDescriptor dataDesc)
                                      throws java.lang.Exception

Returns all of the top level categories which are those that have a parentId = 0. An AdminDataDescriptor object may be supplied in order to add constraints and control the number of categories returned.

Specified by:

getTopLevelCategories in interface AdminCategoryMgrIf

Parameters:

languageId - the languageId

dataDesc - the dataDesc

Returns:

Array of Category Objects

Throws:

java.lang.Exception - an unexpected exception

getMiscItems

public AdminMiscItem[] getMiscItems(int catgeoryId)
                             throws org.apache.torque.TorqueException,
                                    KKAdminException,
                                    com.workingdogs.village.DataSetException,
                                    java.lang.Exception

Get the MiscItems associated with the specified catgeoryId

Parameters:

catgeoryId - the catgeoryId

Returns:

An array of MiscItems which could be null

Throws:

java.lang.Exception - an unexpected exception

com.workingdogs.village.DataSetException - an unexpected exception due to data in Torque (the database layer)

KKAdminException - an unexpected exception in the KonaKart Admin engine

org.apache.torque.TorqueException - an unexpected exception in Torque (the database layer)

getMiscItems

public AdminMiscItem[] getMiscItems(AdminSearch search)
                             throws org.apache.torque.TorqueException,
                                    KKAdminException,
                                    com.workingdogs.village.DataSetException,
                                    java.lang.Exception

Get the MiscItems associated with the specified search criteria

Parameters:

search - the search

Returns:

An array of MiscItems which could be null

Throws:

java.lang.Exception - an unexpected exception

com.workingdogs.village.DataSetException - an unexpected exception due to data in Torque (the database layer)

KKAdminException - an unexpected exception in the KonaKart Admin engine

org.apache.torque.TorqueException - an unexpected exception in Torque (the database layer)

createCategoryTree

protected AdminCategory[] createCategoryTree(int languageId)
                                      throws org.apache.torque.TorqueException,
                                             com.workingdogs.village.DataSetException,
                                             KKAdminException

Creates a category tree with a single query

Parameters:

languageId - the languageId

Returns:

Array of Category Objects

Throws:

org.apache.torque.TorqueException - an unexpected exception in Torque (the database layer)

com.workingdogs.village.DataSetException - an unexpected exception due to data in Torque (the database layer)

KKAdminException - an unexpected exception in the KonaKart Admin engine

getChildren

protected AdminCategory[] getChildren(int parentId,
                                      int languageId)
                               throws KKAdminException,
                                      java.lang.Exception

Returns an array of child categories, children of the input parameter, parent. It is recursive and so fetches the grandchildren etc.

Parameters:

parentId - the parentId

languageId - the languageId

Returns:

Array of Category Objects

Throws:

java.lang.Exception - an unexpected exception

KKAdminException - an unexpected exception in the KonaKart Admin engine

getChildren

public int[] getChildren(int categoryId)
                  throws java.lang.Exception

Returns an array of categoryId describing the children of the given category. Returns null if there are no children.

Specified by:

getChildren in interface AdminCategoryMgrIf

Parameters:

categoryId - the categoryId

Returns:

Return an array of categoryId

Throws:

java.lang.Exception - an unexpected exception

deleteCatAndChildren

protected void deleteCatAndChildren(int categoryId)
                             throws java.lang.Exception

Deletes this category plus all of the child categories plus any products that exist.

Parameters:

categoryId - the categoryId

Throws:

java.lang.Exception - an unexpected exception

getProductIdsPerCategory

protected java.util.HashMap<java.lang.Integer,java.lang.Integer> getProductIdsPerCategory()
                                                                                   throws org.apache.torque.TorqueException,
                                                                                          com.workingdogs.village.DataSetException,
                                                                                          KKAdminException

Returns a HashMap with CategoryId as the key and Number of Products for that category as the value. The products need to have a non 0 status to be considered.

Returns:

HashMap Contains number of products per category

Throws:

org.apache.torque.TorqueException - an unexpected exception in Torque (the database layer)

com.workingdogs.village.DataSetException - an unexpected exception due to data in Torque (the database layer)

KKAdminException - an unexpected exception in the KonaKart Admin engine

getNumProductsPerCategory

protected int getNumProductsPerCategory(int categoryId)
                                 throws org.apache.torque.TorqueException,
                                        com.workingdogs.village.DataSetException,
                                        KKAdminException

Returns the number of products for a leaf category by doing a direct query on the database. The products need to have a non 0 status to be considered.

Parameters:

categoryId - the categoryId

Returns:

Return an int defining the number of products per category

Throws:

org.apache.torque.TorqueException - an unexpected exception in Torque (the database layer)

com.workingdogs.village.DataSetException - an unexpected exception due to data in Torque (the database layer)

KKAdminException - an unexpected exception in the KonaKart Admin engine

fillCatTreeWithProductNumbers

protected void fillCatTreeWithProductNumbers(AdminCategory[] catTree)
                                      throws org.apache.torque.TorqueException,
                                             com.workingdogs.village.DataSetException,
                                             KKAdminException

Receives an array of Categories as input and compiles the numberOfProducts field for each Category

Parameters:

catTree - the catTree

Throws:

com.workingdogs.village.DataSetException - an unexpected exception due to data in Torque (the database layer)

org.apache.torque.TorqueException - an unexpected exception in Torque (the database layer)

KKAdminException - an unexpected exception in the KonaKart Admin engine

setChildrenProductNumbers

protected void setChildrenProductNumbers(AdminCategory parent,
                                         java.util.HashMap<java.lang.Integer,java.lang.Integer> hm)
                                  throws com.workingdogs.village.DataSetException

Recurses through all of the category tree setting the numberOfProducts attribute.

Parameters:

parent - The parent category.

hm - the hm

Throws:

com.workingdogs.village.DataSetException - an unexpected exception due to data in Torque (the database layer)

getCategory

public AdminCategory getCategory(int categoryId,
                                 boolean getChildren,
                                 int languageId)
                          throws java.lang.Exception

Specified by:

getCategory in interface AdminCategoryMgrIf

Parameters:

categoryId - the categoryId

getChildren - If true we get all of the children. Children don't have an array of descriptions.

languageId - Needed to determine the language Id of the children

Returns:

Return a fully populated single category object (no children) or null if the category does not exist

Throws:

java.lang.Exception - an unexpected exception

getCategory

public AdminCategory getCategory(int categoryId,
                                 boolean getChildren,
                                 int languageId,
                                 java.sql.Connection con)
                          throws java.lang.Exception

Specified by:

getCategory in interface AdminCategoryMgrIf

Parameters:

categoryId - the categoryId

getChildren - If true we get all of the children. Children don't have an array of descriptions.

languageId - Needed to determine the language Id of the children

con - Connection for transaction

Returns:

Return a fully populated single category object (no children) or null if the category does not exist

Throws:

java.lang.Exception - an unexpected exception

getCategory

public AdminCategory getCategory(int categoryId,
                                 boolean getChildren,
                                 int languageId,
                                 java.lang.String storeId)
                          throws java.lang.Exception

Specified by:

getCategory in interface AdminCategoryMgrIf

Parameters:

categoryId - the categoryId

getChildren - If true we get all of the children. Children don't have an array of descriptions.

languageId - Needed to determine the language Id of the children

storeId - The store id

Returns:

Return a fully populated single category object (no children) or null if the category does not exist

Throws:

java.lang.Exception - an unexpected exception

getCategory

public AdminCategory getCategory(int categoryId,
                                 boolean getChildren,
                                 int languageId,
                                 java.lang.String storeId,
                                 java.sql.Connection con)
                          throws java.lang.Exception

Specified by:

getCategory in interface AdminCategoryMgrIf

Parameters:

categoryId - the categoryId

getChildren - If true we get all of the children. Children don't have an array of descriptions.

languageId - Needed to determine the language Id of the children

storeId - The store id

con - Connection for Transaction

Returns:

Return a fully populated single category object (no children) or null if the category does not exist

Throws:

java.lang.Exception - an unexpected exception

doesCategoryExist

public boolean doesCategoryExist(int categoryId)
                          throws org.apache.torque.TorqueException,
                                 KKAdminException

Return true if the category exists.

Specified by:

doesCategoryExist in interface AdminCategoryMgrIf

Parameters:

categoryId - the categoryId

Returns:

True if the category exists

Throws:

org.apache.torque.TorqueException - an unexpected exception in Torque (the database layer)

KKAdminException - an unexpected exception in the KonaKart Admin engine

doesCategoryExist

public boolean doesCategoryExist(int categoryId,
                                 java.sql.Connection con)
                          throws org.apache.torque.TorqueException,
                                 KKAdminException

Return true if the category exists.

Specified by:

doesCategoryExist in interface AdminCategoryMgrIf

Parameters:

categoryId - the categoryId

con - Connection for transaction

Returns:

True if the category exists

Throws:

org.apache.torque.TorqueException - an unexpected exception in Torque (the database layer)

KKAdminException - an unexpected exception in the KonaKart Admin engine

insertCategory

public int insertCategory(AdminCategory cat)
                   throws java.lang.Exception

Insert a category as a child of the parent category. If parent category is 0, we make it a top level category.

Specified by:

insertCategory in interface AdminCategoryMgrIf

Parameters:

cat - the cat

Returns:

Returns the category Id

Throws:

java.lang.Exception - an unexpected exception

editCategory

public void editCategory(AdminCategory cat)
                  throws java.lang.Exception

Edit the category.

Specified by:

editCategory in interface AdminCategoryMgrIf

Parameters:

cat - the cat

Throws:

java.lang.Exception - an unexpected exception

validateCategory

protected void validateCategory(AdminCategory cat)
                         throws java.lang.Exception

Used to validate a category before editing or inserting

Parameters:

cat - the cat

Throws:

java.lang.Exception - an unexpected exception

deleteCategoryTree

public void deleteCategoryTree(int categoryId,
                               int options)
                        throws java.lang.Exception

Delete the category referenced to by categoryId. The child categories and products will either be moved up a level or deleted. If the category is a top level category, then the products will be deleted.

Specified by:

deleteCategoryTree in interface AdminCategoryMgrIf

Parameters:

categoryId - the categoryId

options - the options

Throws:

java.lang.Exception - an unexpected exception

deleteSingleCategory

public void deleteSingleCategory(int categoryId)
                          throws java.lang.Exception

Delete a single category.

Specified by:

deleteSingleCategory in interface AdminCategoryMgrIf

Parameters:

categoryId - the categoryId

Throws:

java.lang.Exception - an unexpected exception

moveCategory

public void moveCategory(int categoryId,
                         int newParentId)
                  throws java.lang.Exception

Move this category to make it a child of the category identified by newParentId

Specified by:

moveCategory in interface AdminCategoryMgrIf

Parameters:

categoryId - the categoryId

newParentId - the newParentId

Throws:

java.lang.Exception - an unexpected exception

getCategoriesPerPromotion

public AdminCategory[] getCategoriesPerPromotion(int promotionId,
                                                 int languageId)
                                          throws java.lang.Exception

Returns all of the categories for the promotion

Specified by:

getCategoriesPerPromotion in interface AdminCategoryMgrIf

Parameters:

promotionId - the promotionId

languageId - the languageId

Returns:

Array of Category Objects

Throws:

java.lang.Exception - an unexpected exception

getCategoriesPerProduct

public AdminCategory[] getCategoriesPerProduct(int productId,
                                               int languageId)
                                        throws java.lang.Exception

Returns all of the categories for the product

Specified by:

getCategoriesPerProduct in interface AdminCategoryMgrIf

Parameters:

productId - the productId

languageId - the languageId

Returns:

Array of Category Objects

Throws:

java.lang.Exception - an unexpected exception

setAllCategoryAttrs

protected com.konakart.db.KKCriteria setAllCategoryAttrs(com.konakart.db.KKCriteria c,
                                                         int languageId)

Parameters:

c - the c

languageId - the languageId

Returns:

Returns a criteria object

setAllCategoryAttrs

protected com.konakart.db.KKCriteria setAllCategoryAttrs(com.konakart.db.KKCriteria c)

Parameters:

c - the c

Returns:

Returns a criteria object

manageDataDescriptor

protected void manageDataDescriptor(AdminDataDescriptor dataDesc,
                                    com.konakart.db.KKCriteria c)

Provides common code to deal with the management of the DataDescriptor.

Parameters:

dataDesc - the dataDesc

c - the c

getCategoriesPerTagGroup

public int[] getCategoriesPerTagGroup(int tagGroupId)
                               throws java.lang.Exception

Return an array of Category Ids linked to the specified tag group. An empty array is returned if no linked Category objects exist.

Specified by:

getCategoriesPerTagGroup in interface AdminCategoryMgrIf

Parameters:

tagGroupId - The id of the tag Group

Returns:

Returns an array of Category ids

Throws:

java.lang.Exception - an unexpected exception

getCategoriesToTagGroups

public AdminCategoryToTagGroup[] getCategoriesToTagGroups()
                                                   throws java.lang.Exception

Return an array of all of the AdminCategoryToTagGroup records. An empty array is returned if no such records exist.

Specified by:

getCategoriesToTagGroups in interface AdminCategoryMgrIf

Returns:

Returns an array of AdminCategoryToTagGroups

Throws:

java.lang.Exception - an unexpected exception

cloneTree

protected AdminCategory[] cloneTree(AdminCategory[] tree)
                             throws java.lang.Exception

Throws:

java.lang.Exception

initStaticVariables

protected void initStaticVariables(AdminCategoryMgr.CategoryStats catStats)
                            throws KKAdminException

A synchronized method to initialise the static variables

Parameters:

catStats - the catStats

Throws:

KKAdminException - an unexpected exception in the KonaKart Admin engine

getLastModifiedData

public AdminCategoryMgr.CategoryStats getLastModifiedData()
                                                   throws org.apache.torque.TorqueException,
                                                          com.workingdogs.village.DataSetException,
                                                          KKAdminException

Retrieves the date of the last modified category and the number of categories in the database. It will be used to identify whether any category has been changed. If the last_modified column doesn't contain any valid dates, then we return the current date since we have to assume worst case that some category has been modified.

Returns:

CategoryStats An object containing last modification date and number of categories

Throws:

org.apache.torque.TorqueException - an unexpected exception in Torque (the database layer)

com.workingdogs.village.DataSetException - an unexpected exception due to data in Torque (the database layer)

KKAdminException - an unexpected exception in the KonaKart Admin engine