org.broadleafcommerce.openadmin.server.service

Interface AdminEntityService

All Known Implementing Classes:

AdminEntityServiceImpl

public interface AdminEntityService

Author:

Andre Azzolini (apazzolini)

Method Summary

Methods

Modifier and Type	Method and Description
PersistenceResponse	addEntity(EntityForm entityForm, String[] customCriteria, List<SectionCrumb> sectionCrumb) Persists the given entity
PersistenceResponse	addSubCollectionEntity(EntityForm entityForm, ClassMetadata mainMetadata, Property field, Entity parentEntity, List<SectionCrumb> sectionCrumb) Adds an item into the specified collection
PersistenceResponse	getAdvancedCollectionRecord(ClassMetadata containingClassMetadata, Entity containingEntity, Property collectionProperty, String collectionItemId, List<SectionCrumb> sectionCrumb) Gets an Entity representing a specific collection item
PersistenceResponse	getClassMetadata(PersistencePackageRequest request) Returns class metadata for the given request object
String	getContextSpecificRelationshipId(ClassMetadata cmd, Entity entity, String propertyName) Returns the appropriate id to use for the given entity/metadata and prefix when dealing with collections.
String	getIdProperty(ClassMetadata cmd) Returns the name of the property in this ClassMetadata that has field type set to SupportedFieldType.ID
PersistenceResponse	getRecord(PersistencePackageRequest request, String id, ClassMetadata cmd, boolean isCollectionRequest) Returns a specific record for the given request and primary key id/property
PersistenceResponse	getRecords(PersistencePackageRequest request) Returns the DynamicResultSet containing the total records for the query and the currently fetched Entity[]
Map<String,DynamicResultSet>	getRecordsForAllSubCollections(PersistencePackageRequest ppr, Entity containingEntity, List<SectionCrumb> sectionCrumb) Returns all records for all subcollections of the specified request and its primary key
PersistenceResponse	getRecordsForCollection(ClassMetadata containingClassMetadata, Entity containingEntity, Property collectionProperty, FilterAndSortCriteria[] fascs, Integer startIndex, Integer maxIndex, List<SectionCrumb> sectionCrumb) Returns the DynamicResultSet representing the records that belong to the specified collectionProperty for the given containingClass and the primary key for the containingClass
PersistenceResponse	getRecordsForCollection(ClassMetadata containingClassMetadata, Entity containingEntity, Property collectionProperty, FilterAndSortCriteria[] fascs, Integer startIndex, Integer maxIndex, String idValueOverride, List<SectionCrumb> sectionCrumb) The same as the other getRecordsForCollection method, except that this one expects allow the caller to explicitly set the id value that will be used in the fetch instead of delegating to #getContextSpecificRelationshipId()
PersistenceResponse	removeEntity(EntityForm entityForm, String[] customCriteria, List<SectionCrumb> sectionCrumb) Removes the given entity
PersistenceResponse	removeSubCollectionEntity(ClassMetadata mainMetadata, Property field, Entity parentEntity, String itemId, String priorKey, List<SectionCrumb> sectionCrumb) Removes the given item from the specified collection.
PersistenceResponse	updateEntity(EntityForm entityForm, String[] customCriteria, List<SectionCrumb> sectionCrumb) Updates the given entity
PersistenceResponse	updateSubCollectionEntity(EntityForm entityForm, ClassMetadata mainMetadata, Property field, Entity parentEntity, String collectionItemId, List<SectionCrumb> sectionCrumb) Updates the specified collection item

Method Detail

getClassMetadata

PersistenceResponse getClassMetadata(PersistencePackageRequest request)
                                     throws ServiceException

Returns class metadata for the given request object

Parameters:

request -

Returns:

ClassMetadata for the given request

Throws:

ServiceException

getRecords

PersistenceResponse getRecords(PersistencePackageRequest request)
                               throws ServiceException

Returns the DynamicResultSet containing the total records for the query and the currently fetched Entity[]

Parameters:

request -

Returns:

DynamicResultSet

Throws:

ServiceException

getRecord

PersistenceResponse getRecord(PersistencePackageRequest request,
                            String id,
                            ClassMetadata cmd,
                            boolean isCollectionRequest)
                              throws ServiceException

Returns a specific record for the given request and primary key id/property

Parameters:

request -

id -

cmd -

isCollectionRequest - whether or not this record request was initiated from a collection on a parent entity

Returns:

the Entity

Throws:

ServiceException

addEntity

PersistenceResponse addEntity(EntityForm entityForm,
                            String[] customCriteria,
                            List<SectionCrumb> sectionCrumb)
                              throws ServiceException

Persists the given entity

Parameters:

entityForm -

customCriteria -

Returns:

the persisted Entity

Throws:

ServiceException

updateEntity

PersistenceResponse updateEntity(EntityForm entityForm,
                               String[] customCriteria,
                               List<SectionCrumb> sectionCrumb)
                                 throws ServiceException

Updates the given entity

Parameters:

entityForm -

customCriteria -

Returns:

the persisted Entity

Throws:

ServiceException

removeEntity

PersistenceResponse removeEntity(EntityForm entityForm,
                               String[] customCriteria,
                               List<SectionCrumb> sectionCrumb)
                                 throws ServiceException

Removes the given entity

Parameters:

entityForm -

customCriteria -

Throws:

ServiceException

getAdvancedCollectionRecord

PersistenceResponse getAdvancedCollectionRecord(ClassMetadata containingClassMetadata,
                                              Entity containingEntity,
                                              Property collectionProperty,
                                              String collectionItemId,
                                              List<SectionCrumb> sectionCrumb)
                                                throws ServiceException

Gets an Entity representing a specific collection item

Parameters:

containingClassMetadata -

containingEntity -

collectionProperty -

collectionItemId -

Returns:

the Entity

Throws:

ServiceException

getRecordsForCollection

PersistenceResponse getRecordsForCollection(ClassMetadata containingClassMetadata,
                                          Entity containingEntity,
                                          Property collectionProperty,
                                          FilterAndSortCriteria[] fascs,
                                          Integer startIndex,
                                          Integer maxIndex,
                                          List<SectionCrumb> sectionCrumb)
                                            throws ServiceException

Returns the DynamicResultSet representing the records that belong to the specified collectionProperty for the given containingClass and the primary key for the containingClass

Parameters:

containingClassMetadata -

containingEntity -

collectionProperty -

fascs -

startIndex -

maxIndex -

Returns:

the DynamicResultSet

Throws:

ServiceException

getRecordsForCollection

PersistenceResponse getRecordsForCollection(ClassMetadata containingClassMetadata,
                                          Entity containingEntity,
                                          Property collectionProperty,
                                          FilterAndSortCriteria[] fascs,
                                          Integer startIndex,
                                          Integer maxIndex,
                                          String idValueOverride,
                                          List<SectionCrumb> sectionCrumb)
                                            throws ServiceException

The same as the other getRecordsForCollection method, except that this one expects allow the caller to explicitly set the id value that will be used in the fetch instead of delegating to #getContextSpecificRelationshipId()

Parameters:

containingClassMetadata -

containingEntity -

collectionProperty -

fascs -

startIndex -

maxIndex -

idValueOverride -

Returns:

the PersistenceResponse

Throws:

ServiceException

getRecordsForAllSubCollections

Map<String,DynamicResultSet> getRecordsForAllSubCollections(PersistencePackageRequest ppr,
                                                          Entity containingEntity,
                                                          List<SectionCrumb> sectionCrumb)
                                                            throws ServiceException

Returns all records for all subcollections of the specified request and its primary key

Parameters:

ppr -

containingEntity -

Returns:

all Entity[] for all collections for the specified containingClass

Throws:

ServiceException

See Also:

#getRecordsForCollection(ClassMetadata, String, Property)

addSubCollectionEntity

PersistenceResponse addSubCollectionEntity(EntityForm entityForm,
                                         ClassMetadata mainMetadata,
                                         Property field,
                                         Entity parentEntity,
                                         List<SectionCrumb> sectionCrumb)
                                           throws ServiceException,
                                                  ClassNotFoundException

Adds an item into the specified collection

Parameters:

entityForm -

mainMetadata -

field -

parentEntity -

Returns:

the persisted Entity

Throws:

ServiceException

ClassNotFoundException

updateSubCollectionEntity

PersistenceResponse updateSubCollectionEntity(EntityForm entityForm,
                                            ClassMetadata mainMetadata,
                                            Property field,
                                            Entity parentEntity,
                                            String collectionItemId,
                                            List<SectionCrumb> sectionCrumb)
                                              throws ServiceException,
                                                     ClassNotFoundException

Updates the specified collection item

Parameters:

entityForm -

mainMetadata -

field -

parentEntity -

collectionItemId -

Returns:

the persisted Entity

Throws:

ServiceException

ClassNotFoundException

removeSubCollectionEntity

PersistenceResponse removeSubCollectionEntity(ClassMetadata mainMetadata,
                                            Property field,
                                            Entity parentEntity,
                                            String itemId,
                                            String priorKey,
                                            List<SectionCrumb> sectionCrumb)
                                              throws ServiceException

Removes the given item from the specified collection.

Parameters:

mainMetadata -

field -

parentId -

itemId -

priorKey - - only needed for Map type collections

Throws:

ServiceException

getContextSpecificRelationshipId

String getContextSpecificRelationshipId(ClassMetadata cmd,
                                      Entity entity,
                                      String propertyName)

Returns the appropriate id to use for the given entity/metadata and prefix when dealing with collections. For example, on the Product screen, we display associated media. However, this media is actually owned by the Sku entity, which means its property name is "defaultSku.skuMedia". In this case, when wanting to look up media for this product, we cannot use the id of the product. Instead, we need to use the id of the sku.

Parameters:

cmd -

entity -

propertyName -

Returns:

the id to be used for this relationship

getIdProperty

String getIdProperty(ClassMetadata cmd)
                     throws ServiceException

Returns the name of the property in this ClassMetadata that has field type set to SupportedFieldType.ID

Parameters:

cmd -

Returns:

the id property name

Throws:

ServiceException