org.kuali.rice.kns.service.impl
Class DataObjectMetaDataServiceImpl

java.lang.Object
  org.kuali.rice.kns.service.impl.DataObjectMetaDataServiceImpl

All Implemented Interfaces:

DataObjectMetaDataService

Direct Known Subclasses:

BusinessObjectMetaDataServiceImpl

public class DataObjectMetaDataServiceImpl
extends Object
implements DataObjectMetaDataService

Author:

Kuali Rice Team (rice.collab@kuali.org)

Constructor Summary

DataObjectMetaDataServiceImpl()

Method Summary

boolean	equalsByPrimaryKeys(Object do1, Object do2) Compares two dataObject instances for equality of type and key values using toString() of each value for comparison purposes.
protected DataDictionaryService	getDataDictionaryService() Protected method to allow subclasses to access the dataDictionaryService.
protected DataObjectEntry	getDataObjectEntry(Class<?> dataObjectClass)
BusinessObjectRelationship	getDataObjectRelationship(Object dataObject, Class<?> dataObjectClass, String attributeName, String attributePrefix, boolean keysOnly, boolean supportsLookup, boolean supportsInquiry) Attempts to find a relationship for the given attribute within the given data object
protected BusinessObjectRelationship	getDataObjectRelationship(RelationshipDefinition ddReference, Object dataObject, Class<?> dataObjectClass, String attributeName, String attributePrefix, boolean keysOnly, boolean supportsLookup, boolean supportsInquiry)
RelationshipDefinition	getDictionaryRelationship(Class<?> c, String attributeName) This method fetches the RelationshipDefinition using the parameters.
protected KualiModuleService	getKualiModuleService() Protected method to allow subclasses to access the kualiModuleService.
protected PersistenceStructureService	getPersistenceStructureService() Protected method to allow subclasses to access the persistenceStructureService.
Map<String,?>	getPrimaryKeyFieldValues(Object dataObject)
Map<String,?>	getPrimaryKeyFieldValues(Object dataObject, boolean sortFieldNames)
protected BusinessObjectRelationship	getRelationshipMetadata(Class<?> dataObjectClass, String attributeName, String attributePrefix)
String	getTitleAttribute(Class<?> dataObjectClass) Returns the attribute to be associated with for object level markings.
protected ViewDictionaryService	getViewDictionaryService()
List<String>	listPrimaryKeyFieldNames(Class<?> clazz) Checks the DataDictionary and OJB Repository File to determine the primary fields names for a given class.
protected BusinessObjectRelationship	populateRelationshipFromDictionaryReference(Class<?> dataObjectClass, RelationshipDefinition ddReference, String attributePrefix, boolean keysOnly)
void	setDataDictionaryService(DataDictionaryService dataDictionaryService)
void	setKualiModuleService(KualiModuleService kualiModuleService)
void	setPersistenceStructureService(PersistenceStructureService persistenceStructureService)
void	setViewDictionaryService(ViewDictionaryService viewDictionaryService)

Methods inherited from class java.lang.Object

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

Constructor Detail

DataObjectMetaDataServiceImpl

public DataObjectMetaDataServiceImpl()

Method Detail

listPrimaryKeyFieldNames

public List<String> listPrimaryKeyFieldNames(Class<?> clazz)

Description copied from interface: DataObjectMetaDataService

Checks the DataDictionary and OJB Repository File to determine the primary fields names for a given class.

Specified by:

listPrimaryKeyFieldNames in interface DataObjectMetaDataService

Parameters:

clazz - The Class to check for primary keys

Returns:

a list of the primary key field names or an empty list if none are found

See Also:

DataObjectMetaDataService.listPrimaryKeyFieldNames(java.lang.Class)

getPrimaryKeyFieldValues

public Map<String,?> getPrimaryKeyFieldValues(Object dataObject)

Specified by:

getPrimaryKeyFieldValues in interface DataObjectMetaDataService

Returns:

a Map containing the names and values of fields for the given class which are designated as key fields in the OJB repository file or DataDictionary

See Also:

DataObjectMetaDataService.getPrimaryKeyFieldValues(java.lang.Object)

getPrimaryKeyFieldValues

public Map<String,?> getPrimaryKeyFieldValues(Object dataObject,
                                              boolean sortFieldNames)

Specified by:

getPrimaryKeyFieldValues in interface DataObjectMetaDataService

sortFieldNames - if true, the returned Map will iterate through its entries sorted by fieldName

Returns:

a Map containing the names and values of fields for the given class which are designated as key fields in the OJB repository file or DataDictionary

See Also:

DataObjectMetaDataService.getPrimaryKeyFieldValues(java.lang.Object, boolean)

equalsByPrimaryKeys

public boolean equalsByPrimaryKeys(Object do1,
                                   Object do2)

Description copied from interface: DataObjectMetaDataService

Compares two dataObject instances for equality of type and key values using toString() of each value for comparison purposes.

Specified by:

equalsByPrimaryKeys in interface DataObjectMetaDataService

Returns:

boolean indicating whether the two objects are equal.

See Also:

DataObjectMetaDataService.equalsByPrimaryKeys(java.lang.Object, java.lang.Object)

getDataObjectRelationship

public BusinessObjectRelationship getDataObjectRelationship(Object dataObject,
                                                            Class<?> dataObjectClass,
                                                            String attributeName,
                                                            String attributePrefix,
                                                            boolean keysOnly,
                                                            boolean supportsLookup,
                                                            boolean supportsInquiry)

Description copied from interface: DataObjectMetaDataService

Attempts to find a relationship for the given attribute within the given data object

First the data dictionary is queried to find any relationship definitions setup that include the attribute, if found the BusinessObjectRetationship is build from that. If not and the data object class is persistent, relationships are retrieved from the persistence service. Nested attributes are handled in addition to external business objects. If multiple relationships are found, the one that contains the least amount of joining keys is returned

Specified by:

getDataObjectRelationship in interface DataObjectMetaDataService

Parameters:

dataObject - - data object instance that contains the attribute

dataObjectClass - - class for the data object that contains the attribute

attributeName - - property name for the attribute

attributePrefix - - property prefix for the attribute

keysOnly - - indicates whether only primary key fields should be returned in the relationship

supportsLookup - - indicates whether the relationship should support lookup

Returns:

BusinessObjectRelationship for the attribute, or null if not found

See Also:

DataObjectMetaDataService.getDataObjectRelationship(java.lang.Object, java.lang.Class, java.lang.String, java.lang.String, boolean, boolean, boolean)

getDataObjectRelationship

protected BusinessObjectRelationship getDataObjectRelationship(RelationshipDefinition ddReference,
                                                               Object dataObject,
                                                               Class<?> dataObjectClass,
                                                               String attributeName,
                                                               String attributePrefix,
                                                               boolean keysOnly,
                                                               boolean supportsLookup,
                                                               boolean supportsInquiry)

getDictionaryRelationship

public RelationshipDefinition getDictionaryRelationship(Class<?> c,
                                                        String attributeName)

Description copied from interface: DataObjectMetaDataService

This method fetches the RelationshipDefinition using the parameters.

Specified by:

getDictionaryRelationship in interface DataObjectMetaDataService

Parameters:

c - - data object class that contains the attribute

attributeName - - property name for the attribute

Returns:

RelationshipDefinition for the attribute, or null if not found

populateRelationshipFromDictionaryReference

protected BusinessObjectRelationship populateRelationshipFromDictionaryReference(Class<?> dataObjectClass,
                                                                                 RelationshipDefinition ddReference,
                                                                                 String attributePrefix,
                                                                                 boolean keysOnly)

getRelationshipMetadata

protected BusinessObjectRelationship getRelationshipMetadata(Class<?> dataObjectClass,
                                                             String attributeName,
                                                             String attributePrefix)

getTitleAttribute

public String getTitleAttribute(Class<?> dataObjectClass)

Description copied from interface: DataObjectMetaDataService

Returns the attribute to be associated with for object level markings. This would be the field chosen for inquiry links etc.

Specified by:

getTitleAttribute in interface DataObjectMetaDataService

Parameters:

dataObjectClass - - data object class to obtain title attribute of

Returns:

property name of title attribute or null if data object entry not found

See Also:

DataObjectMetaDataService.getTitleAttribute(java.lang.Class)

getDataObjectEntry

protected DataObjectEntry getDataObjectEntry(Class<?> dataObjectClass)

Parameters:

dataObjectClass -

Returns:

DataObjectEntry for the given dataObjectClass, or null if there is none

Throws:

IllegalArgumentException - if the given Class is null

getDataDictionaryService

protected DataDictionaryService getDataDictionaryService()

Protected method to allow subclasses to access the dataDictionaryService.

Returns:

Returns the dataDictionaryService.

setDataDictionaryService

public void setDataDictionaryService(DataDictionaryService dataDictionaryService)

getKualiModuleService

protected KualiModuleService getKualiModuleService()

Protected method to allow subclasses to access the kualiModuleService.

Returns:

Returns the persistenceStructureService.

setKualiModuleService

public void setKualiModuleService(KualiModuleService kualiModuleService)

getPersistenceStructureService

protected PersistenceStructureService getPersistenceStructureService()

Protected method to allow subclasses to access the persistenceStructureService.

Returns:

Returns the persistenceStructureService.

setPersistenceStructureService

public void setPersistenceStructureService(PersistenceStructureService persistenceStructureService)

getViewDictionaryService

protected ViewDictionaryService getViewDictionaryService()

setViewDictionaryService

public void setViewDictionaryService(ViewDictionaryService viewDictionaryService)