Package org.broadleafcommerce.openadmin.web.controller.entity

Class AdminBasicEntityController

java.lang.Object

org.broadleafcommerce.common.web.controller.BroadleafAbstractController

org.broadleafcommerce.openadmin.web.controller.AdminAbstractController

org.broadleafcommerce.openadmin.web.controller.entity.AdminBasicEntityController

Direct Known Subclasses:

AdminAssetController, AdminCategoryController, AdminFieldController, AdminOfferController, AdminOrderController, AdminPageController, AdminProductController, AdminStructuredContentController, AdminUserManagementController

@Controller("blAdminBasicEntityController")
@RequestMapping("/{sectionKey:.+}")
public class AdminBasicEntityController
extends AdminAbstractController

The default implementation of the AdminAbstractController. This delegates every call to super and does not provide any custom-tailored functionality. It is responsible for rendering the admin for every entity that is not explicitly customized by its own controller.

Author:

Andre Azzolini (apazzolini), Jeff Fischer

Field Summary

Fields

Modifier and Type	Field	Description
protected AdminUserDao	adminUserDao
protected AdornedTargetAutoPopulateExtensionManager	adornedTargetAutoPopulateExtensionManager
static final String	ALTERNATE_ID_PROPERTY
protected static final String	CURRENT_FOLDER_ID
static final String	CUSTOM_CRITERIA
protected EntityDuplicator	duplicator
protected DynamicEntityDao	dynamicEntityDao
protected GenericEntityService	genericEntityService
static final String	IS_SELECTIZE_REQUEST
protected static final org.apache.commons.logging.Log	LOG
protected MultipleCatalogExtensionManager	multipleCatalogExtensionManager
protected RowLevelSecurityService	rowLevelSecurityService
protected SandBoxHelper	sandBoxHelper

Fields inherited from class org.broadleafcommerce.openadmin.web.controller.AdminAbstractController

adminNavigationService, adminRemoteSecurityService, CURRENT_ADMIN_MODULE_ATTRIBUTE_NAME, CURRENT_ADMIN_SECTION_ATTRIBUTE_NAME, customCriteriaService, DEFAULT_CONTAINER_VIEW, entityConfiguration, entityFormValidator, eps, extensionManager, FILTER_VALUE_SEPARATOR, FILTER_VALUE_SEPARATOR_REGEX, filterProductTypeExtensionManager, formService, MODAL_CONTAINER_VIEW, service, validationService

Constructor Summary

Constructors

Constructor	Description
AdminBasicEntityController()

Method Summary

Modifier and Type	Method	Description
protected void	addAddActionIfAllowed(String sectionClassName, ClassMetadata cmd, List<EntityFormAction> mainActions)	Adds the "Add" button to the main entity form if the current user has permissions to create new instances of the entity and all of the fields in the entity aren't marked as read only.
protected void	addAuditableDisplayField(EntityForm entityForm, Field userField)
void	addAuditableDisplayFields(EntityForm entityForm)
Map<String,Object>	addCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId)
String	addCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, EntityForm entityForm, org.springframework.validation.BindingResult result)	Adds the requested collection item
String	addEmptyCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, EntityForm entityForm, org.springframework.validation.BindingResult result)
String	addEntity(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, EntityForm entityForm, org.springframework.validation.BindingResult result)	Processes the request to add a new entity.
Map<String,Object>	addSelectizeCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, EntityForm entityForm, org.springframework.validation.BindingResult result)	Adds the requested collection item via Selectize
protected String	buildAddCollectionItemModel(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, String id, String collectionField, String sectionKey, Property collectionProperty, FieldMetadata md, PersistencePackageRequest ppr, EntityForm entityForm, Entity entity)	Builds out all of the model information needed for showing the add modal for collection items on both the initial GET as well as after a POST with validation errors
protected Field	buildAuditableDisplayField(Field auditableField)
List<String>	buildDirtyList(Map<String,String> pathVars, jakarta.servlet.http.HttpServletRequest request, String id)
protected String[]	buildSelectizeCustomCriteria()
protected void	declareShouldIgnoreAdditionStatusFilter()
protected String	determineEntityType(String entityType, ClassMetadata cmd)
String	duplicateEntity(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, EntityForm entityForm, org.springframework.validation.BindingResult result)
String	getCollectionFieldRecords(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, org.springframework.util.MultiValueMap<String,String> requestParams)	Returns the records for a given collectionField filtered by a particular criteria
Map<String,String>	getCollectionValueDetails(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String collectionField, String ids, org.springframework.util.MultiValueMap<String,String> requestParams)
protected String	getCurrentFolderId(jakarta.servlet.http.HttpServletRequest request)
protected String	getCurrentTabName(Map<String,String> pathVars, ClassMetadata cmd)
protected String[]	getCustomCriteria(Map<String,List<String>> requestParams)	Obtains the requested criteria parameter
protected String	getErrorDuplicatingResponse(jakarta.servlet.http.HttpServletResponse response, String code)
protected String	getModalForBlankEntityType(jakarta.servlet.http.HttpServletRequest request, org.springframework.ui.Model model, String sectionKey, ClassMetadata cmd)
Map<String,Object>	getSelectizeCollectionOptions(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, org.springframework.util.MultiValueMap<String,String> requestParams)
protected Map<String,DynamicResultSet>	getViewSubRecords(jakarta.servlet.http.HttpServletRequest request, Map<String,String> pathVars, ClassMetadata cmd, Entity entity, List<SectionCrumb> crumbs)
void	initBinder(org.springframework.web.bind.WebDataBinder binder)	Invoked on every request to provide the ability to register specific binders for Spring's binding process.
protected boolean	isAddActionAllowed(String sectionClassName, ClassMetadata cmd)
protected boolean	isNotReadOnly(ClassMetadata cmd)
protected void	modifyEntityForm(Entity entity, EntityForm entityForm, Map<String,String> pathVars)
protected EntityForm	reinitializeEntityForm(EntityForm entityForm, ClassMetadata collectionMetadata, Entity entity, Map<String,DynamicResultSet> subRecordsMap, List<SectionCrumb> sectionCrumbs)
String	removeCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId)	Removes the requested collection item
String	removeCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, String alternateId)	Removes the requested collection item
String	removeEntity(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, EntityForm entityForm, org.springframework.validation.BindingResult result, org.springframework.web.servlet.mvc.support.RedirectAttributes ra)	Attempts to remove the given entity.
protected String	resolveAppropriateEntityView(jakarta.servlet.http.HttpServletRequest request, org.springframework.ui.Model model, EntityForm entityForm)
String	saveEntity(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, EntityForm entityForm, org.springframework.validation.BindingResult result, org.springframework.web.servlet.mvc.support.RedirectAttributes ra)	Attempts to save the given entity.
String	saveEntityJson(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, EntityForm entityForm, org.springframework.validation.BindingResult result, org.springframework.web.servlet.mvc.support.RedirectAttributes ra)	Builds JSON that looks like this:
protected void	setTypedEntityModelAttributes(jakarta.servlet.http.HttpServletRequest request, org.springframework.ui.Model model)
protected void	setupViewEntityListBasicModel(jakarta.servlet.http.HttpServletRequest request, ClassMetadata cmd, String sectionKey, String sectionClassName, org.springframework.ui.Model model, org.springframework.util.MultiValueMap<String,String> requestParams)
String	showAddCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, org.springframework.util.MultiValueMap<String,String> requestParams)	Shows the modal dialog that is used to add an item to a given collection.
String	showUpdateCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId)
String	showUpdateCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, String alternateId)	Shows the appropriate modal dialog to edit the selected collection item
String	showViewCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId)
String	showViewCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, String alternateId)	Shows the appropriate modal dialog to view the selected collection item.
protected String	showViewUpdateCollection(jakarta.servlet.http.HttpServletRequest request, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, String modalHeaderType)
protected String	showViewUpdateCollection(jakarta.servlet.http.HttpServletRequest request, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, String alternateId, String modalHeaderType)
protected String	showViewUpdateCollection(jakarta.servlet.http.HttpServletRequest request, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, String alternateId, String modalHeaderType, EntityForm entityForm, Entity entity)	Shows the view and populates the model for updating a collection item.
protected String	showViewUpdateCollection(jakarta.servlet.http.HttpServletRequest request, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, String modalHeaderType, EntityForm entityForm, Entity entity)
String	updateCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, EntityForm entityForm, String alternateId, org.springframework.validation.BindingResult result)	Updates the specified collection item
String	updateCollectionItem(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, EntityForm entityForm, org.springframework.validation.BindingResult result)	Updates the specified collection item
Map<String,Object>	updateCollectionItemSequence(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, String newSequence)
Map<String,Object>	updateCollectionItemSequence(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, String newSequence, String alternateId)	Updates the given collection item's sequence.
String	viewAddEntityForm(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String entityType)	Renders the modal form that is used to add a new parent level entity.
String	viewCollectionItemDetails(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String collectionField, String id)	Shows the modal popup for the current selected "to-one" field.
String	viewCollectionItemTab(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, String tabName, EntityForm entityForm)
String	viewEntityForm(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id)	Renders the main entity form for the specified entity
String	viewEntityList(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, org.springframework.util.MultiValueMap<String,String> requestParams)	Renders the main entity listing for the specified class, which is based on the current sectionKey with some optional criteria.
Map<String,Object>	viewEntityListSelectize(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, org.springframework.util.MultiValueMap<String,String> requestParams)
String	viewEntityTab(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String tabName, EntityForm entityForm, Entity entity)	Attempts to get the List Grid for the selected tab.
String	viewReadOnlyCollectionItemTab(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, org.springframework.ui.Model model, Map<String,String> pathVars, String id, String collectionField, String collectionItemId, String tabName, EntityForm entityForm)

Methods inherited from class org.broadleafcommerce.openadmin.web.controller.AdminAbstractController

attachSectionSpecificInfo, attachSectionSpecificInfo, createSectionCrumb, declareForceUseAdditionStatusFilter, extractDynamicFormFields, getAddEntityTypes, getClassNameForSection, getCollectionListGrid, getCollectionListGrid, getCriteria, getDefaultEntityType, getDynamicFieldTemplateForm, getDynamicForm, getEntityForm, getEntityForm, getEntityForm, getFirstId, getLastId, getLowerCount, getMaxIndex, getMaxResults, getPageSize, getPersistencePackageRequest, getSectionCrumbs, getSectionCustomCriteria, getSectionKey, getSectionPersistencePackageRequest, getSectionPersistencePackageRequest, getSectionPersistencePackageRequest, getSectionPersistencePackageRequest, getSortDirections, getSortPropertyNames, getStartIndex, getUpperCount, modifyAddEntityForm, modifyCriteria, modifyEntityForm, populateJsonValidationErrors, setModelAttributes, setSpecializedNameForFields, translateErrorMessage

Methods inherited from class org.broadleafcommerce.common.web.controller.BroadleafAbstractController

addDeepLink, getContextPath, isAjaxRequest, jsonResponse

Methods inherited from class java.lang.Object

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

Field Details

ALTERNATE_ID_PROPERTY

public static final String ALTERNATE_ID_PROPERTY

See Also:

• Constant Field Values

CUSTOM_CRITERIA

public static final String CUSTOM_CRITERIA

See Also:

• Constant Field Values

IS_SELECTIZE_REQUEST

public static final String IS_SELECTIZE_REQUEST

See Also:

• Constant Field Values

LOG

protected static final org.apache.commons.logging.Log LOG

CURRENT_FOLDER_ID

protected static final String CURRENT_FOLDER_ID

See Also:

• Constant Field Values

sandBoxHelper

protected SandBoxHelper sandBoxHelper

adminUserDao

protected AdminUserDao adminUserDao

dynamicEntityDao

protected DynamicEntityDao dynamicEntityDao

adornedTargetAutoPopulateExtensionManager

protected AdornedTargetAutoPopulateExtensionManager adornedTargetAutoPopulateExtensionManager

rowLevelSecurityService

protected RowLevelSecurityService rowLevelSecurityService

duplicator

protected EntityDuplicator duplicator

genericEntityService

protected GenericEntityService genericEntityService

multipleCatalogExtensionManager

protected MultipleCatalogExtensionManager multipleCatalogExtensionManager

Constructor Details

AdminBasicEntityController

public AdminBasicEntityController()

Method Details

viewEntityList

@RequestMapping(value="",
                method=GET)
public String viewEntityList(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @RequestParam
 org.springframework.util.MultiValueMap<String,String> requestParams)
                      throws Exception

Renders the main entity listing for the specified class, which is based on the current sectionKey with some optional criteria.

Parameters:

request -

response -

model -

pathVars -

requestParams - a Map of property name -> list critiera values

Returns:

the return view path

Throws:

Exception

setupViewEntityListBasicModel

protected void setupViewEntityListBasicModel(jakarta.servlet.http.HttpServletRequest request,
 ClassMetadata cmd,
 String sectionKey,
 String sectionClassName,
 org.springframework.ui.Model model,
 org.springframework.util.MultiValueMap<String,String> requestParams)

viewEntityListSelectize

@RequestMapping(value="/selectize",
                method=GET)
@ResponseBody
public Map<String,Object> viewEntityListSelectize(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @RequestParam
 org.springframework.util.MultiValueMap<String,String> requestParams)
                                           throws Exception

Throws:

Exception

getCustomCriteria

protected String[] getCustomCriteria(Map<String,List<String>> requestParams)

Obtains the requested criteria parameter

Parameters:

requestParams -

Returns:

addAddActionIfAllowed

protected void addAddActionIfAllowed(String sectionClassName,
 ClassMetadata cmd,
 List<EntityFormAction> mainActions)

Adds the "Add" button to the main entity form if the current user has permissions to create new instances of the entity and all of the fields in the entity aren't marked as read only.

Parameters:

sectionClassName -

cmd -

mainActions -

isAddActionAllowed

protected boolean isAddActionAllowed(String sectionClassName,
 ClassMetadata cmd)

isNotReadOnly

protected boolean isNotReadOnly(ClassMetadata cmd)

viewAddEntityForm

@RequestMapping(value="/add",
                method=GET)
public String viewAddEntityForm(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @RequestParam(defaultValue="")
 String entityType)
                         throws Exception

Renders the modal form that is used to add a new parent level entity. Note that this form cannot render any subcollections as operations on those collections require the parent level entity to first be saved and have and id. Once the entity is initially saved, we will redirect the user to the normal manage entity screen where they can then perform operations on sub collections.

Parameters:

request -

response -

model -

pathVars -

entityType -

Returns:

the return view path

Throws:

Exception

determineEntityType

protected String determineEntityType(String entityType,
 ClassMetadata cmd)
                              throws UnsupportedEncodingException

Throws:

UnsupportedEncodingException

addEntity

@RequestMapping(value="/add",
                method=POST)
public String addEntity(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @ModelAttribute("entityForm")
 EntityForm entityForm,
 org.springframework.validation.BindingResult result)
                 throws Exception

Processes the request to add a new entity. If successful, returns a redirect to the newly created entity.

Parameters:

request -

response -

model -

pathVars -

entityForm -

result -

Returns:

the return view path

Throws:

Exception

duplicateEntity

@RequestMapping(value="/{id}/duplicate",
                method=POST)
public String duplicateEntity(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @ModelAttribute("entityForm")
 EntityForm entityForm,
 org.springframework.validation.BindingResult result)
                       throws Exception

Throws:

Exception

getErrorDuplicatingResponse

protected String getErrorDuplicatingResponse(jakarta.servlet.http.HttpServletResponse response,
 String code)

viewEntityForm

@RequestMapping(value="/{id}",
                method=GET)
public String viewEntityForm(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id)
                      throws Exception

Renders the main entity form for the specified entity

Parameters:

request -

response -

model -

pathVars -

id -

Returns:

the return view path

Throws:

Exception

getViewSubRecords

protected Map<String,DynamicResultSet> getViewSubRecords(jakarta.servlet.http.HttpServletRequest request,
 Map<String,String> pathVars,
 ClassMetadata cmd,
 Entity entity,
 List<SectionCrumb> crumbs)
                                                  throws Exception

Throws:

Exception

viewEntityTab

@RequestMapping(value="/{id}/{tab:[0-9]+}/{tabName}",
                method=POST)
public String viewEntityTab(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("tabName")
 String tabName,
 @ModelAttribute("entityForm")
 EntityForm entityForm,
 @ModelAttribute("entity")
 Entity entity)
                     throws Exception

Attempts to get the List Grid for the selected tab.

Parameters:

request -

response -

model -

pathVars -

id -

tabName -

entityForm -

entity -

Returns:

the return view path

Throws:

Exception

saveEntityJson

@RequestMapping(value="/{id}",
                method=POST,
                produces="application/json")
public String saveEntityJson(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @ModelAttribute("entityForm")
 EntityForm entityForm,
 org.springframework.validation.BindingResult result,
 org.springframework.web.servlet.mvc.support.RedirectAttributes ra)
                      throws Exception

Builds JSON that looks like this:

 {"errors":
      [{"message":"This field is Required",
        "code": "requiredValidationFailure"
        "field":"defaultSku--name",
        "errorType", "field",
        "tab": "General"
        },
        {"message":"This field is Required",
        "code": "requiredValidationFailure"
        "field":"defaultSku--name",
        "errorType", "field",
        "tab": "General"
        }]
 }
 

Throws:

Exception

buildDirtyList

public List<String> buildDirtyList(Map<String,String> pathVars,
 jakarta.servlet.http.HttpServletRequest request,
 String id)
                            throws ServiceException

Throws:

ServiceException

saveEntity

@RequestMapping(value="/{id}",
                method=POST)
public String saveEntity(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @ModelAttribute("entityForm")
 EntityForm entityForm,
 org.springframework.validation.BindingResult result,
 org.springframework.web.servlet.mvc.support.RedirectAttributes ra)
                  throws Exception

Attempts to save the given entity. If validation is unsuccessful, it will re-render the entity form with error fields highlighted. On a successful save, it will refresh the entity page.

Parameters:

request -

response -

model -

pathVars -

id -

entityForm -

result -

Returns:

the return view path

Throws:

Exception

modifyEntityForm

protected void modifyEntityForm(Entity entity,
 EntityForm entityForm,
 Map<String,String> pathVars)
                         throws Exception

Throws:

Exception

resolveAppropriateEntityView

protected String resolveAppropriateEntityView(jakarta.servlet.http.HttpServletRequest request,
 org.springframework.ui.Model model,
 @ModelAttribute("entityForm")
 EntityForm entityForm)

removeEntity

@RequestMapping(value="/{id}/delete",
                method=POST)
public String removeEntity(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @ModelAttribute("entityForm")
 EntityForm entityForm,
 org.springframework.validation.BindingResult result,
 org.springframework.web.servlet.mvc.support.RedirectAttributes ra)
                    throws Exception

Attempts to remove the given entity.

Parameters:

request -

response -

model -

pathVars -

id -

Returns:

the return view path

Throws:

Exception

getCollectionValueDetails

@RequestMapping(value="/{collectionField:.*}/details",
                method=GET)
@ResponseBody
public Map<String,String> getCollectionValueDetails(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("collectionField")
 String collectionField,
 @RequestParam
 String ids,
 @RequestParam
 org.springframework.util.MultiValueMap<String,String> requestParams)
                                             throws Exception

Throws:

Exception

viewCollectionItemDetails

@RequestMapping(value="/{collectionField:.*}/{id}/view",
                method=GET)
public String viewCollectionItemDetails(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("id")
 String id)
                                 throws Exception

Shows the modal popup for the current selected "to-one" field. For instance, if you are viewing a list of products then this method is invoked when a user clicks on the name of the default category field.

Parameters:

request -

response -

model -

pathVars -

collectionField -

id -

Returns:

Throws:

Exception

viewCollectionItemTab

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}/{tab:[0-9]+}/{tabName}",
                method=POST)
public String viewCollectionItemTab(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId,
 @PathVariable("tabName")
 String tabName,
 @ModelAttribute("entityForm")
 EntityForm entityForm)
                             throws Exception

Throws:

Exception

viewReadOnlyCollectionItemTab

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}/view/{tab:[0-9]+}/{tabName}",
                method=POST)
public String viewReadOnlyCollectionItemTab(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId,
 @PathVariable("tabName")
 String tabName,
 @ModelAttribute("entityForm")
 EntityForm entityForm)
                                     throws Exception

Throws:

Exception

getCollectionFieldRecords

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}",
                method=GET)
public String getCollectionFieldRecords(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @RequestParam
 org.springframework.util.MultiValueMap<String,String> requestParams)
                                 throws Exception

Returns the records for a given collectionField filtered by a particular criteria

Parameters:

request -

response -

model -

pathVars -

collectionField -

requestParams -

Returns:

the return view path

Throws:

Exception

showAddCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/add",
                method=GET)
public String showAddCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @RequestParam
 org.springframework.util.MultiValueMap<String,String> requestParams)
                             throws Exception

Shows the modal dialog that is used to add an item to a given collection. There are several possible outcomes of this call depending on the type of the specified collection field.

• Basic Collection (Persist) - Renders a blank form for the specified target entity so that the user may enter information and associate the record with this collection. Used by fields such as ProductAttribute.
• Basic Collection (Lookup) - Renders a list grid that allows the user to click on an entity and select it. Used by fields such as "allParentCategories".
• Adorned Collection (without form) - Renders a list grid that allows the user to click on an entity and select it. The view rendered by this is identical to basic collection (lookup), but will perform the operation on an adorned field, which may carry extra meta-information about the created relationship, such as order.
• Adorned Collection (with form) - Renders a list grid that allows the user to click on an entity and select it. Once the user selects the entity, he will be presented with an empty form based on the specified "maintainedAdornedTargetFields" for this field. Used by fields such as "crossSellProducts", which in addition to linking an entity, provide extra fields, such as a promotional message.
• Map Collection - Renders a form for the target entity that has an additional key field. This field is populated either from the configured map keys, or as a result of a lookup in the case of a key based on another entity. Used by fields such as the mediaMap on a Sku.

Parameters:

request -

response -

model -

pathVars -

id -

collectionField -

requestParams -

Returns:

the return view path

Throws:

Exception

getModalForBlankEntityType

protected String getModalForBlankEntityType(jakarta.servlet.http.HttpServletRequest request,
 org.springframework.ui.Model model,
 String sectionKey,
 ClassMetadata cmd)

addCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/add/{collectionItemId}/verify",
                method=POST)
@ResponseBody
public Map<String,Object> addCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId)
                                     throws Exception

Throws:

Exception

getSelectizeCollectionOptions

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/selectize",
                method=GET)
@ResponseBody
public Map<String,Object> getSelectizeCollectionOptions(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @RequestParam
 org.springframework.util.MultiValueMap<String,String> requestParams)
                                                 throws Exception

Parameters:

request -

response -

model -

pathVars -

id -

collectionField -

requestParams -

Returns:

Json collection data

Throws:

Exception

buildSelectizeCustomCriteria

protected String[] buildSelectizeCustomCriteria()

addSelectizeCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/selectize-add",
                method=POST)
@ResponseBody
public Map<String,Object> addSelectizeCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @ModelAttribute("entityForm")
 EntityForm entityForm,
 org.springframework.validation.BindingResult result)
                                              throws Exception

Adds the requested collection item via Selectize

Parameters:

request -

response -

model -

pathVars -

id -

collectionField -

entityForm -

Returns:

the return view path

Throws:

Exception

declareShouldIgnoreAdditionStatusFilter

protected void declareShouldIgnoreAdditionStatusFilter()

addCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/add",
                method=POST)
public String addCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @ModelAttribute("entityForm")
 EntityForm entityForm,
 org.springframework.validation.BindingResult result)
                         throws Exception

Adds the requested collection item

Parameters:

request -

response -

model -

pathVars -

id -

collectionField -

entityForm -

Returns:

the return view path

Throws:

Exception

addEmptyCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/addEmpty",
                method=POST)
@ResponseBody
public String addEmptyCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @ModelAttribute("entityForm")
 EntityForm entityForm,
 org.springframework.validation.BindingResult result)
                              throws Exception

Throws:

Exception

buildAddCollectionItemModel

protected String buildAddCollectionItemModel(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 String id,
 String collectionField,
 String sectionKey,
 Property collectionProperty,
 FieldMetadata md,
 PersistencePackageRequest ppr,
 EntityForm entityForm,
 Entity entity)
                                      throws ServiceException

Builds out all of the model information needed for showing the add modal for collection items on both the initial GET as well as after a POST with validation errors

Parameters:

request -

model -

id -

collectionField -

sectionKey -

collectionProperty -

md -

ppr -

Returns:

the appropriate view to display for the modal

Throws:

ServiceException

showUpdateCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}/{alternateId}",
                method=GET)
public String showUpdateCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId,
 @PathVariable("alternateId")
 String alternateId)
                                throws Exception

Shows the appropriate modal dialog to edit the selected collection item

Parameters:

request -

response -

model -

pathVars -

id -

collectionField -

collectionItemId -

Returns:

the return view path

Throws:

Exception

showUpdateCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}",
                method=GET)
public String showUpdateCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId)
                                throws Exception

Throws:

Exception

showViewCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}/{alternateId}/view",
                method=GET)
public String showViewCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId,
 @PathVariable("alternateId")
 String alternateId)
                              throws Exception

Shows the appropriate modal dialog to view the selected collection item. This will display the modal as readonly

Parameters:

request -

response -

model -

pathVars -

id -

collectionField -

collectionItemId -

Returns:

the return view path

Throws:

Exception

showViewCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}/view",
                method=GET)
public String showViewCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId)
                              throws Exception

Throws:

Exception

showViewUpdateCollection

protected String showViewUpdateCollection(jakarta.servlet.http.HttpServletRequest request,
 org.springframework.ui.Model model,
 Map<String,String> pathVars,
 String id,
 String collectionField,
 String collectionItemId,
 String alternateId,
 String modalHeaderType)
                                   throws ServiceException

Throws:

ServiceException

showViewUpdateCollection

protected String showViewUpdateCollection(jakarta.servlet.http.HttpServletRequest request,
 org.springframework.ui.Model model,
 Map<String,String> pathVars,
 String id,
 String collectionField,
 String collectionItemId,
 String modalHeaderType)
                                   throws ServiceException

Throws:

ServiceException

showViewUpdateCollection

protected String showViewUpdateCollection(jakarta.servlet.http.HttpServletRequest request,
 org.springframework.ui.Model model,
 Map<String,String> pathVars,
 String id,
 String collectionField,
 String collectionItemId,
 String modalHeaderType,
 EntityForm entityForm,
 Entity entity)
                                   throws ServiceException

Throws:

ServiceException

showViewUpdateCollection

protected String showViewUpdateCollection(jakarta.servlet.http.HttpServletRequest request,
 org.springframework.ui.Model model,
 Map<String,String> pathVars,
 String id,
 String collectionField,
 String collectionItemId,
 String alternateId,
 String modalHeaderType,
 EntityForm entityForm,
 Entity entity)
                                   throws ServiceException

Shows the view and populates the model for updating a collection item. You can also pass in an entityform and entity which are optional. If they are not passed in then they are automatically looked up

Parameters:

request -

model -

pathVars -

id -

collectionField -

collectionItemId -

modalHeaderType -

entityForm -

entity -

Returns:

Throws:

ServiceException

reinitializeEntityForm

protected EntityForm reinitializeEntityForm(EntityForm entityForm,
 ClassMetadata collectionMetadata,
 Entity entity,
 Map<String,DynamicResultSet> subRecordsMap,
 List<SectionCrumb> sectionCrumbs)
                                     throws ServiceException

Throws:

ServiceException

updateCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}",
                method=POST)
public String updateCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId,
 @ModelAttribute("entityForm")
 EntityForm entityForm,
 org.springframework.validation.BindingResult result)
                            throws Exception

Updates the specified collection item

Parameters:

request -

response -

model -

pathVars -

id -

collectionField -

collectionItemId - the collection primary key value (in the case of adorned target collection, this is the primary key value of the target entity)

entityForm -

result -

Returns:

the return view path

Throws:

Exception

updateCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}/{alternateId}",
                method=POST)
public String updateCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId,
 @ModelAttribute("entityForm")
 EntityForm entityForm,
 @PathVariable("alternateId")
 String alternateId,
 org.springframework.validation.BindingResult result)
                            throws Exception

Updates the specified collection item

Parameters:

request -

response -

model -

pathVars -

id -

collectionField -

collectionItemId - the collection primary key value (in the case of adorned target collection, this is the primary key value of the target entity)

entityForm -

alternateId - in the case of adorned target collections, this is the primary key value of the collection member

result -

Returns:

the return view path

Throws:

Exception

updateCollectionItemSequence

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}/sequence",
                method=POST)
@ResponseBody
public Map<String,Object> updateCollectionItemSequence(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId,
 @RequestParam("newSequence")
 String newSequence)
                                                throws Exception

Throws:

Exception

updateCollectionItemSequence

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}/{alternateId}/sequence",
                method=POST)
@ResponseBody
public Map<String,Object> updateCollectionItemSequence(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId,
 @RequestParam("newSequence")
 String newSequence,
 @PathVariable("alternateId")
 String alternateId)
                                                throws Exception

Updates the given collection item's sequence. This should only be triggered for adorned target collections where a sort field is specified -- any other invocation is incorrect and will result in an exception.

Parameters:

request -

response -

model -

pathVars -

id -

collectionField -

collectionItemId -

Returns:

an object explaining the state of the operation

Throws:

Exception

removeCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}/delete",
                method=POST)
public String removeCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId)
                            throws Exception

Removes the requested collection item

Note that the request must contain a parameter called "key" when attempting to remove a collection item from a map collection.

Parameters:

request -

response -

model -

pathVars -

id -

collectionField -

collectionItemId -

Returns:

the return view path

Throws:

Exception

removeCollectionItem

@RequestMapping(value="/{id}/{collectionField:[^0-9].*}/{collectionItemId}/{alternateId}/delete",
                method=POST)
public String removeCollectionItem(jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 org.springframework.ui.Model model,
 @PathVariable
 Map<String,String> pathVars,
 @PathVariable("id")
 String id,
 @PathVariable("collectionField")
 String collectionField,
 @PathVariable("collectionItemId")
 String collectionItemId,
 @PathVariable("alternateId")
 String alternateId)
                            throws Exception

Removes the requested collection item

Note that the request must contain a parameter called "key" when attempting to remove a collection item from a map collection.

Parameters:

request -

response -

model -

pathVars -

id -

collectionField -

collectionItemId -

Returns:

the return view path

Throws:

Exception

addAuditableDisplayFields

public void addAuditableDisplayFields(EntityForm entityForm)

addAuditableDisplayField

protected void addAuditableDisplayField(EntityForm entityForm,
 Field userField)

buildAuditableDisplayField

protected Field buildAuditableDisplayField(Field auditableField)

getCurrentTabName

protected String getCurrentTabName(Map<String,String> pathVars,
 ClassMetadata cmd)

getCurrentFolderId

protected String getCurrentFolderId(jakarta.servlet.http.HttpServletRequest request)

setTypedEntityModelAttributes

protected void setTypedEntityModelAttributes(jakarta.servlet.http.HttpServletRequest request,
 org.springframework.ui.Model model)

initBinder

@InitBinder
public void initBinder(org.springframework.web.bind.WebDataBinder binder)

Invoked on every request to provide the ability to register specific binders for Spring's binding process. By default, we register a binder that treats empty Strings as null and a Boolean editor that supports either true or false. If the value is passed in as null, it will treat it as false.

Parameters:

binder -