org.finra.herd.dao.impl

Class BusinessObjectDataDaoImpl

java.lang.Object

org.finra.herd.dao.impl.BaseJpaDaoImpl

org.finra.herd.dao.impl.AbstractHerdDao

org.finra.herd.dao.impl.BusinessObjectDataDaoImpl

All Implemented Interfaces:

BaseJpaDao, BusinessObjectDataDao

@Repository
public class BusinessObjectDataDaoImpl
extends AbstractHerdDao
implements BusinessObjectDataDao

Nested Class Summary

Nested classes/interfaces inherited from class org.finra.herd.dao.impl.AbstractHerdDao

AbstractHerdDao.AggregateFunction

Field Summary

Fields inherited from class org.finra.herd.dao.impl.AbstractHerdDao

BUSINESS_OBJECT_DATA_PARTITIONS, BUSINESS_OBJECT_DATA_SUBPARTITIONS, configurationHelper, DEFAULT_SINGLE_DAY_DATE_MASK, MAX_PARTITION_FILTERS_PER_REQUEST

Fields inherited from class org.finra.herd.dao.impl.BaseJpaDaoImpl

entityManager

Constructor Summary

Constructors

Constructor and Description
BusinessObjectDataDaoImpl()

Method Summary

Modifier and Type	Method and Description
BusinessObjectDataEntity	getBusinessObjectDataByAltKey(BusinessObjectDataKey businessObjectDataKey) Retrieves business object data by it's key.
BusinessObjectDataEntity	getBusinessObjectDataByAltKeyAndStatus(BusinessObjectDataKey businessObjectDataKey, BusinessObjectDataStatusEntity businessObjectDataStatusEntity) Retrieves business object data by it's key.
List<BusinessObjectDataKey>	getBusinessObjectDataByBusinessObjectDefinition(BusinessObjectDefinitionEntity businessObjectDefinitionEntity, Integer maxResults) Gets a list of keys for business object data registered under specified business object definition entity.
List<BusinessObjectDataKey>	getBusinessObjectDataByBusinessObjectFormat(BusinessObjectFormatEntity businessObjectFormatEntity, Integer maxResults) Gets a list of keys for business object data registered under specified business object format entity.
Long	getBusinessObjectDataCount(BusinessObjectFormatKey businessObjectFormatKey) Returns a number of business object data instances registered with this business object format.
List<BusinessObjectDataEntity>	getBusinessObjectDataEntities(BusinessObjectDataKey businessObjectDataKey) Retrieves business object data versions that match the specified business object data key with potentially missing business object format and/or data version values.
List<BusinessObjectDataEntity>	getBusinessObjectDataEntitiesByPartitionValue(String partitionValue) Retrieves a list of business object data by their partition value.
Map<BusinessObjectDataEntity,StoragePolicyEntity>	getBusinessObjectDataEntitiesMatchingStoragePolicies(StoragePolicyPriorityLevel storagePolicyPriorityLevel, Boolean doNotTransitionLatestValid, List<String> supportedBusinessObjectDataStatuses, int storagePolicyTransitionMaxAllowedAttempts, int startPosition, int maxResult) Retrieves a map of business object data entities to their corresponding storage policy entities, where the business object data status is supported by the storage policy feature and the business object data alternate key values match storage policy's filter and transition (not taking into account storage policy rules).
List<BusinessObjectDataEntity>	getBusinessObjectDataFromStorageOlderThan(StorageEntity storageEntity, int thresholdMinutes, List<String> businessObjectDataStatuses) Selects business object data having storage files associated with the specified storage and status.
Integer	getBusinessObjectDataLimitedCountBySearchKey(BusinessObjectDataSearchKey businessObjectDataSearchKey, Integer recordCountLimit) Retrieves business object data record count up to to the specified record limit as per business object data search key.
String	getBusinessObjectDataMaxPartitionValue(int partitionColumnPosition, BusinessObjectFormatKey businessObjectFormatKey, Integer businessObjectDataVersion, BusinessObjectDataStatusEntity businessObjectDataStatusEntity, List<StorageEntity> storageEntities, StoragePlatformEntity storagePlatformEntity, StoragePlatformEntity excludedStoragePlatformEntity, String upperBoundPartitionValue, String lowerBoundPartitionValue) Retrieves a maximum available partition value per specified parameters.
Integer	getBusinessObjectDataMaxVersion(BusinessObjectDataKey businessObjectDataKey) Gets a maximum available version of the specified business object data.
String	getBusinessObjectDataMinPartitionValue(int partitionColumnPosition, BusinessObjectFormatKey businessObjectFormatKey, Integer businessObjectDataVersion, BusinessObjectDataStatusEntity businessObjectDataStatusEntity, List<StorageEntity> storageEntities, StoragePlatformEntity storagePlatformEntity, StoragePlatformEntity excludedStoragePlatformEntity) Retrieves a minimum available partition value per specified parameters.
List<BusinessObjectData>	searchBusinessObjectData(BusinessObjectDataSearchKey businessObjectDataSearchKey, Integer pageNum, Integer pageSize) Retrieves a list of business object data per specified business object data search key.

Methods inherited from class org.finra.herd.dao.impl.AbstractHerdDao

getQueryRestriction, getQueryRestriction, getQueryRestriction, getQueryRestriction, getQueryRestrictionOnBusinessObjectDataVersionAndStatus, getQueryRestrictionOnPartitionValues, getQueryRestrictionOnPartitionValues, getQueryRestrictionOnPartitionValues, getQueryRestrictionOnPartitionValues, getQueryRestrictionOnStorage, save

Methods inherited from class org.finra.herd.dao.impl.BaseJpaDaoImpl

delete, detach, executeSingleResultQuery, findAll, findById, findByNamedProperties, findUniqueByNamedProperties, getCurrentTimestamp, getEntityManager, getPredicateForInClause, query, queryByNamedParams, saveAndRefresh

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.finra.herd.dao.BaseJpaDao

delete, detach, findAll, findById, findByNamedProperties, findUniqueByNamedProperties, getCurrentTimestamp, getEntityManager, query, queryByNamedParams, save, saveAndRefresh

Constructor Detail

BusinessObjectDataDaoImpl

public BusinessObjectDataDaoImpl()

Method Detail

getBusinessObjectDataByAltKey

public BusinessObjectDataEntity getBusinessObjectDataByAltKey(BusinessObjectDataKey businessObjectDataKey)

Description copied from interface: BusinessObjectDataDao

Retrieves business object data by it's key. If a format version isn't specified, the latest available format version (for this partition value) will be used. If a business object data version isn't specified, the latest data version is returned regardless of the business object data status.

Specified by:

getBusinessObjectDataByAltKey in interface BusinessObjectDataDao

Parameters:

businessObjectDataKey - the business object data key

Returns:

the business object data

getBusinessObjectDataByAltKeyAndStatus

public BusinessObjectDataEntity getBusinessObjectDataByAltKeyAndStatus(BusinessObjectDataKey businessObjectDataKey,
                                                                       BusinessObjectDataStatusEntity businessObjectDataStatusEntity)

Description copied from interface: BusinessObjectDataDao

Retrieves business object data by it's key. If a format version isn't specified, the latest available format version (for this partition value) will be used. If a business object data version isn't specified, the latest data version based on the specified business object data status is returned. When both business object data version and business object data status are not specified, the method returns the latest business object data version for the relative business object format version.

Specified by:

getBusinessObjectDataByAltKeyAndStatus in interface BusinessObjectDataDao

Parameters:

businessObjectDataKey - the business object data key with the optional business object format and business object data versions

businessObjectDataStatusEntity - the optional business object data status entity. This parameter is ignored when the business object data version is specified

Returns:

the business object data

getBusinessObjectDataMaxVersion

public Integer getBusinessObjectDataMaxVersion(BusinessObjectDataKey businessObjectDataKey)

Description copied from interface: BusinessObjectDataDao

Gets a maximum available version of the specified business object data.

Specified by:

getBusinessObjectDataMaxVersion in interface BusinessObjectDataDao

Parameters:

businessObjectDataKey - the business object data key

Returns:

the maximum available version of the specified business object data

getBusinessObjectDataMaxPartitionValue

public String getBusinessObjectDataMaxPartitionValue(int partitionColumnPosition,
                                                     BusinessObjectFormatKey businessObjectFormatKey,
                                                     Integer businessObjectDataVersion,
                                                     BusinessObjectDataStatusEntity businessObjectDataStatusEntity,
                                                     List<StorageEntity> storageEntities,
                                                     StoragePlatformEntity storagePlatformEntity,
                                                     StoragePlatformEntity excludedStoragePlatformEntity,
                                                     String upperBoundPartitionValue,
                                                     String lowerBoundPartitionValue)

Description copied from interface: BusinessObjectDataDao

Retrieves a maximum available partition value per specified parameters.

Specified by:

getBusinessObjectDataMaxPartitionValue in interface BusinessObjectDataDao

Parameters:

partitionColumnPosition - the partition column position (1-based numbering)

businessObjectFormatKey - the business object format key (case-insensitive). If a business object format version isn't specified, business object data partition value is selected across all business object format versions

businessObjectDataVersion - the optional business object data version. If business object data version isn't specified, business object data partition value is selected from all available business object data as per specified business object data status entity

businessObjectDataStatusEntity - the optional business object data status entity. This parameter is ignored when the business object data version is specified

storageEntities - the optional list of storage entities

storagePlatformEntity - the optional storage platform entity, e.g. S3 for Hive DDL. It is ignored when the list of storage entities is not empty

excludedStoragePlatformEntity - the optional storage platform entity to be excluded from search. It is ignored when the list of storage entities is not empty or the storage platform entity is specified

upperBoundPartitionValue - the optional inclusive upper bound for the maximum available partition value

lowerBoundPartitionValue - the optional inclusive lower bound for the maximum available partition value

Returns:

the maximum available partition value

getBusinessObjectDataMinPartitionValue

public String getBusinessObjectDataMinPartitionValue(int partitionColumnPosition,
                                                     BusinessObjectFormatKey businessObjectFormatKey,
                                                     Integer businessObjectDataVersion,
                                                     BusinessObjectDataStatusEntity businessObjectDataStatusEntity,
                                                     List<StorageEntity> storageEntities,
                                                     StoragePlatformEntity storagePlatformEntity,
                                                     StoragePlatformEntity excludedStoragePlatformEntity)

Description copied from interface: BusinessObjectDataDao

Retrieves a minimum available partition value per specified parameters.

Specified by:

getBusinessObjectDataMinPartitionValue in interface BusinessObjectDataDao

Parameters:

partitionColumnPosition - the partition column position (1-based numbering)

businessObjectFormatKey - the business object format key (case-insensitive). If a business object format version isn't specified, business object data partition value is selected across all business object format versions

businessObjectDataVersion - the optional business object data version. If business object data version isn't specified, business object data partition value is selected from all available business object data as per specified business object data status entity

businessObjectDataStatusEntity - the optional business object data status entity. This parameter is ignored when the business object data version is specified

storageEntities - the optional list of storage entities

storagePlatformEntity - the optional storage platform entity, e.g. S3 for Hive DDL. It is ignored when the list of storage entities is not empty

excludedStoragePlatformEntity - the optional storage platform entity to be excluded from search. It is ignored when the list of storage entities is not empty or the storage platform entity is specified

Returns:

the maximum available partition value

getBusinessObjectDataCount

public Long getBusinessObjectDataCount(BusinessObjectFormatKey businessObjectFormatKey)

Description copied from interface: BusinessObjectDataDao

Returns a number of business object data instances registered with this business object format.

Specified by:

getBusinessObjectDataCount in interface BusinessObjectDataDao

Parameters:

businessObjectFormatKey - the business object format key

Returns:

the number of business object data instances registered with this business object format

getBusinessObjectDataEntities

public List<BusinessObjectDataEntity> getBusinessObjectDataEntities(BusinessObjectDataKey businessObjectDataKey)

Description copied from interface: BusinessObjectDataDao

Retrieves business object data versions that match the specified business object data key with potentially missing business object format and/or data version values.

Specified by:

getBusinessObjectDataEntities in interface BusinessObjectDataDao

Parameters:

businessObjectDataKey - the business object data key with potentially missing business object format and/or data version values

Returns:

the business object data

getBusinessObjectDataFromStorageOlderThan

public List<BusinessObjectDataEntity> getBusinessObjectDataFromStorageOlderThan(StorageEntity storageEntity,
                                                                                int thresholdMinutes,
                                                                                List<String> businessObjectDataStatuses)

Description copied from interface: BusinessObjectDataDao

Selects business object data having storage files associated with the specified storage and status. Only tbe business object data records that are older than threshold minutes will be selected.

Specified by:

getBusinessObjectDataFromStorageOlderThan in interface BusinessObjectDataDao

Parameters:

storageEntity - the storage entity

thresholdMinutes - the expiration time in minutes

businessObjectDataStatuses - the list of business object data statuses

Returns:

the list of business object data entities sorted by created on timestamp

getBusinessObjectDataEntitiesMatchingStoragePolicies

public Map<BusinessObjectDataEntity,StoragePolicyEntity> getBusinessObjectDataEntitiesMatchingStoragePolicies(StoragePolicyPriorityLevel storagePolicyPriorityLevel,
                                                                                                              Boolean doNotTransitionLatestValid,
                                                                                                              List<String> supportedBusinessObjectDataStatuses,
                                                                                                              int storagePolicyTransitionMaxAllowedAttempts,
                                                                                                              int startPosition,
                                                                                                              int maxResult)

Description copied from interface: BusinessObjectDataDao

Retrieves a map of business object data entities to their corresponding storage policy entities, where the business object data status is supported by the storage policy feature and the business object data alternate key values match storage policy's filter and transition (not taking into account storage policy rules). The storage policy priority level identifies a particular storage policy priority that will be selected by the query. The returned map is ordered by the business object data "created on" timestamp, starting with the oldest business object data entity.

Specified by:

getBusinessObjectDataEntitiesMatchingStoragePolicies in interface BusinessObjectDataDao

Parameters:

storagePolicyPriorityLevel - the storage policy priority level

doNotTransitionLatestValid - specifies if this storage policy should not transition latest valid business object data versions

supportedBusinessObjectDataStatuses - the list of business object data statuses that storage policies apply to (case-sensitive)

storagePolicyTransitionMaxAllowedAttempts - the maximum number of failed storage policy transition attempts before the relative storage unit gets excluded from being selected. 0 means the maximum is not set

startPosition - the position of the first result, numbered from 0

maxResult - the maximum number of results to retrieve

Returns:

the map of business object data entities to their corresponding storage policy entities

getBusinessObjectDataEntitiesByPartitionValue

public List<BusinessObjectDataEntity> getBusinessObjectDataEntitiesByPartitionValue(String partitionValue)

Description copied from interface: BusinessObjectDataDao

Retrieves a list of business object data by their partition value.

Specified by:

getBusinessObjectDataEntitiesByPartitionValue in interface BusinessObjectDataDao

Parameters:

partitionValue - The partition value

Returns:

A list of business object data entity

getBusinessObjectDataLimitedCountBySearchKey

public Integer getBusinessObjectDataLimitedCountBySearchKey(BusinessObjectDataSearchKey businessObjectDataSearchKey,
                                                            Integer recordCountLimit)

Description copied from interface: BusinessObjectDataDao

Retrieves business object data record count up to to the specified record limit as per business object data search key.

Specified by:

getBusinessObjectDataLimitedCountBySearchKey in interface BusinessObjectDataDao

Parameters:

businessObjectDataSearchKey - the business object data search key

recordCountLimit - the business object data record count limit

Returns:

the record count of business object data up to to the specified limit

searchBusinessObjectData

public List<BusinessObjectData> searchBusinessObjectData(BusinessObjectDataSearchKey businessObjectDataSearchKey,
                                                         Integer pageNum,
                                                         Integer pageSize)

Description copied from interface: BusinessObjectDataDao

Retrieves a list of business object data per specified business object data search key.

Specified by:

searchBusinessObjectData in interface BusinessObjectDataDao

Parameters:

businessObjectDataSearchKey - the business object data search key

pageNum - if pageNum parameter is specified, results contain the appropriate page specified. Page numbers are one-based - that is the first page number is one

pageSize - if pageSize parameter is specified, results contain that number of business object data (unless it is the end of the result set)

Returns:

the list of business object data

getBusinessObjectDataByBusinessObjectDefinition

public List<BusinessObjectDataKey> getBusinessObjectDataByBusinessObjectDefinition(BusinessObjectDefinitionEntity businessObjectDefinitionEntity,
                                                                                   Integer maxResults)

Description copied from interface: BusinessObjectDataDao

Gets a list of keys for business object data registered under specified business object definition entity. The results are sorted by primary partition value descending, sub-partition values (if present) descending, and business object data version descending.

Specified by:

getBusinessObjectDataByBusinessObjectDefinition in interface BusinessObjectDataDao

Parameters:

businessObjectDefinitionEntity - the business object definition entity

maxResults - the optional maximum number of results to return

Returns:

the list of business object data keys

getBusinessObjectDataByBusinessObjectFormat

public List<BusinessObjectDataKey> getBusinessObjectDataByBusinessObjectFormat(BusinessObjectFormatEntity businessObjectFormatEntity,
                                                                               Integer maxResults)

Description copied from interface: BusinessObjectDataDao

Gets a list of keys for business object data registered under specified business object format entity.

Specified by:

getBusinessObjectDataByBusinessObjectFormat in interface BusinessObjectDataDao

Parameters:

businessObjectFormatEntity - the business object format entity

maxResults - optional maximum number of results to return

Returns:

the list of business object data keys