org.kuali.rice.kns.service
Interface DataDictionaryService

All Known Implementing Classes:

DataDictionaryServiceImpl

public interface DataDictionaryService

This interface defines the API for interacting with the data dictionary.

Method Summary

void	addDataDictionaryLocations(List<String> locations)
Set<InactivationBlockingMetadata>	getAllInactivationBlockingDefinitions(Class inactivationBlockedBusinessObjectClass) Returns all of the inactivation blocks registered for a particular business object
ControlDefinition	getAttributeControlDefinition(Class businessObjectClass, String attributeName) the html control type used to render the field
ControlDefinition	getAttributeControlDefinition(String entryName, String attributeName) the html control type used to render the field
String	getAttributeDescription(Class businessObjectClass, String attributeName) detailed help text for attribute
String	getAttributeDescription(String entryName, String attributeName) detailed help text for attribute
String	getAttributeErrorLabel(Class businessObjectClass, String attributeName) the "label (short label)" used for displaying error messages
String	getAttributeErrorLabel(String entryName, String attributeName) the "label (short label)" used for displaying error messages
BigDecimal	getAttributeExclusiveMin(String entryName, String attributeName)
Boolean	getAttributeForceUppercase(Class businessObjectClass, String attributeName) indicates whether or not to force input text into uppercase
Boolean	getAttributeForceUppercase(String entryName, String attributeName) indicates whether or not to force input text into uppercase
Class<? extends Formatter>	getAttributeFormatter(Class businessObjectClass, String attributeName) the formatter class used to format the attribute value
Class<? extends Formatter>	getAttributeFormatter(String entryName, String attributeName) the formatter class used to format the attribute value
BigDecimal	getAttributeInclusiveMax(String entryName, String attributeName)
String	getAttributeLabel(Class businessObjectClass, String attributeName) the label to be used for displaying the attribute.
String	getAttributeLabel(String entryName, String attributeName) the label to be used for displaying the attribute.
Integer	getAttributeMaxLength(Class businessObjectClass, String attributeName) the max length defined for the given attribute name.
Integer	getAttributeMaxLength(String entryName, String attributeName) the max length defined for the given attribute name.
AttributeSecurity	getAttributeSecurity(String entryName, String attributeName) the AttributeSecurity object defined for the attribute's data value
String	getAttributeShortLabel(Class businessObjectClass, String attributeName) the short label to be used for displaying the attribute.
String	getAttributeShortLabel(String entryName, String attributeName) the short label to be used for displaying the attribute.
Integer	getAttributeSize(Class businessObjectClass, String attributeName) the display size of the field if text control
Integer	getAttributeSize(String entryName, String attributeName) the display size of the field if text control
String	getAttributeSummary(Class businessObjectClass, String attributeName) short help text for attribute
String	getAttributeSummary(String entryName, String attributeName) short help text for attribute
String	getAttributeValidatingErrorMessageKey(String entryName, String attributeName)
String[]	getAttributeValidatingErrorMessageParameters(String entryName, String attributeName)
Pattern	getAttributeValidatingExpression(Class businessObjectClass, String attributeName) the regular expression defined to validate the given attribute name.
Pattern	getAttributeValidatingExpression(String entryName, String attributeName) the regular expression defined to validate the given attribute name.
Class<? extends KeyValuesFinder>	getAttributeValuesFinderClass(Class businessObjectClass, String attributeName) the Class that returns a values list for this attribute
Class<? extends KeyValuesFinder>	getAttributeValuesFinderClass(String entryName, String attributeName) the Class that returns a values list for this attribute
String	getCollectionDescription(Class businessObjectClass, String collectionName) detailed help text for collection
String	getCollectionDescription(String entryName, String collectionName) detailed help text for collection
String	getCollectionElementLabel(String entryName, String collectionName, Class businessObjectClass) the element label to be used for displaying the collection.
String	getCollectionLabel(Class businessObjectClass, String collectionName) the label to be used for displaying the collection.
String	getCollectionLabel(String entryName, String collectionName) the label to be used for displaying the collection.
String	getCollectionShortLabel(Class businessObjectClass, String collectionName) the short label to be used for displaying the collection.
String	getCollectionShortLabel(String entryName, String collectionName) the short label to be used for displaying the collection.
String	getCollectionSummary(Class businessObjectClass, String collectionName) short help text for collection
String	getCollectionSummary(String entryName, String collectionName) short help text for collection
DataDictionary	getDataDictionary()
Map	getDataDictionaryMap()
Class<? extends Document>	getDocumentClassByTypeName(String documentTypeName) Returns the document class declared in the dd for the given document type name.
String	getDocumentLabelByClass(Class documentOrBusinessObjectClass) This method returns the user friendly label based on the document or business object class
String	getDocumentLabelByTypeName(String documentTypeName) This method returns the user friendly label based on the workflow doc type name
String	getDocumentTypeNameByClass(Class documentClass) Returns the document type name declared in the dd for the given document class.
Class<? extends PromptBeforeValidation>	getPromptBeforeValidationClass(String docTypeName)
Map<String,String>	getRelationshipAttributeMap(String entryName, String relationshipName) returns a Map that specifies the attributes of the relationship
List<String>	getRelationshipEntriesForSourceAttribute(String entryName, String sourceAttributeName) returns a list of names for all entries whose source parameter matches the parameter
List<String>	getRelationshipEntriesForTargetAttribute(String entryName, String targetAttributeName) returns a list of names for all entries whose source parameter matches the parameter
List<String>	getRelationshipNames(String entryName) Returns all of the relationships defined for a BO in the DD
List<String>	getRelationshipSourceAttributes(String entryName, String relationshipName)
Class<? extends BusinessObject>	getRelationshipSourceClass(String entryName, String relationshipName)
List<String>	getRelationshipTargetAttributes(String entryName, String relationshipName)
Class<? extends BusinessObject>	getRelationshipTargetClass(String entryName, String relationshipName)
Class<? extends Document>	getValidDocumentClassByTypeName(String documentTypeName) Returns the document class declared in the dd for the given document type name.
String	getValidDocumentTypeNameByClass(Class documentClass) Returns the document type name declared in the dd for the given document class.
boolean	hasRelationship(String entryName, String relationshipName) Determines whether there is a relationship defined for the given entry with the given name
Boolean	isAttributeDefined(Class businessObjectClass, String attributeName) indicates whether or not the named attribute is defined in the business object xml
Boolean	isAttributeDefined(String entryName, String attributeName) indicates whether or not the named attribute is defined in the business object xml
Boolean	isAttributeRequired(Class businessObjectClass, String attributeName) indicates whether or not the named attribute is required
Boolean	isAttributeRequired(String entryName, String attributeName) indicates whether or not the named attribute is required
void	setBaselinePackages(List baselinePackages) Sequentially adds each package named (as a String) in the given List as a source of unique entries to the DataDictionary being constructed.

Method Detail

setBaselinePackages

void setBaselinePackages(List baselinePackages)
                         throws IOException

Sequentially adds each package named (as a String) in the given List as a source of unique entries to the DataDictionary being constructed. Duplicate entries among any of the XML files in any of these packages will result in exceptions being thrown, hence service-initialization failure.

Parameters:

baselinePackages -

Throws:

SourceException - if any of the given packages can't be located

IOException

getDataDictionary

DataDictionary getDataDictionary()

Returns:

current DataDictionary

addDataDictionaryLocations

void addDataDictionaryLocations(List<String> locations)
                                throws IOException

Throws:

IOException

getAttributeControlDefinition

ControlDefinition getAttributeControlDefinition(Class businessObjectClass,
                                                String attributeName)

the html control type used to render the field

getAttributeSize

Integer getAttributeSize(Class businessObjectClass,
                         String attributeName)

the display size of the field if text control

getAttributeMaxLength

Integer getAttributeMaxLength(Class businessObjectClass,
                              String attributeName)

the max length defined for the given attribute name.

getAttributeValidatingExpression

Pattern getAttributeValidatingExpression(Class businessObjectClass,
                                         String attributeName)

the regular expression defined to validate the given attribute name.

getAttributeLabel

String getAttributeLabel(Class businessObjectClass,
                         String attributeName)

the label to be used for displaying the attribute.

getAttributeShortLabel

String getAttributeShortLabel(Class businessObjectClass,
                              String attributeName)

the short label to be used for displaying the attribute.

getAttributeErrorLabel

String getAttributeErrorLabel(Class businessObjectClass,
                              String attributeName)

the "label (short label)" used for displaying error messages

getAttributeFormatter

Class<? extends Formatter> getAttributeFormatter(Class businessObjectClass,
                                                 String attributeName)

the formatter class used to format the attribute value

getAttributeForceUppercase

Boolean getAttributeForceUppercase(Class businessObjectClass,
                                   String attributeName)

indicates whether or not to force input text into uppercase

getAttributeSummary

String getAttributeSummary(Class businessObjectClass,
                           String attributeName)

short help text for attribute

getAttributeDescription

String getAttributeDescription(Class businessObjectClass,
                               String attributeName)

detailed help text for attribute

isAttributeRequired

Boolean isAttributeRequired(Class businessObjectClass,
                            String attributeName)

indicates whether or not the named attribute is required

isAttributeDefined

Boolean isAttributeDefined(Class businessObjectClass,
                           String attributeName)

indicates whether or not the named attribute is defined in the business object xml

getAttributeValuesFinderClass

Class<? extends KeyValuesFinder> getAttributeValuesFinderClass(Class businessObjectClass,
                                                               String attributeName)

the Class that returns a values list for this attribute

getCollectionLabel

String getCollectionLabel(Class businessObjectClass,
                          String collectionName)

the label to be used for displaying the collection.

getCollectionShortLabel

String getCollectionShortLabel(Class businessObjectClass,
                               String collectionName)

the short label to be used for displaying the collection.

getCollectionSummary

String getCollectionSummary(Class businessObjectClass,
                            String collectionName)

short help text for collection

getCollectionDescription

String getCollectionDescription(Class businessObjectClass,
                                String collectionName)

detailed help text for collection

getAttributeControlDefinition

ControlDefinition getAttributeControlDefinition(String entryName,
                                                String attributeName)

the html control type used to render the field

getAttributeSize

Integer getAttributeSize(String entryName,
                         String attributeName)

the display size of the field if text control

getAttributeMaxLength

Integer getAttributeMaxLength(String entryName,
                              String attributeName)

the max length defined for the given attribute name.

getAttributeExclusiveMin

BigDecimal getAttributeExclusiveMin(String entryName,
                                    String attributeName)

Parameters:

entryName -

attributeName -

Returns:

the exclusive minimum for the specified attribute, or null if none.

getAttributeInclusiveMax

BigDecimal getAttributeInclusiveMax(String entryName,
                                    String attributeName)

Parameters:

entryName -

attributeName -

Returns:

the inclusive maximum for the specified attribute, or null if none.

getAttributeValidatingExpression

Pattern getAttributeValidatingExpression(String entryName,
                                         String attributeName)

the regular expression defined to validate the given attribute name.

getAttributeLabel

String getAttributeLabel(String entryName,
                         String attributeName)

the label to be used for displaying the attribute.

getAttributeShortLabel

String getAttributeShortLabel(String entryName,
                              String attributeName)

the short label to be used for displaying the attribute.

getAttributeErrorLabel

String getAttributeErrorLabel(String entryName,
                              String attributeName)

the "label (short label)" used for displaying error messages

getAttributeFormatter

Class<? extends Formatter> getAttributeFormatter(String entryName,
                                                 String attributeName)

the formatter class used to format the attribute value

getAttributeForceUppercase

Boolean getAttributeForceUppercase(String entryName,
                                   String attributeName)

indicates whether or not to force input text into uppercase

getAttributeSecurity

AttributeSecurity getAttributeSecurity(String entryName,
                                       String attributeName)

the AttributeSecurity object defined for the attribute's data value

getAttributeSummary

String getAttributeSummary(String entryName,
                           String attributeName)

short help text for attribute

getAttributeDescription

String getAttributeDescription(String entryName,
                               String attributeName)

detailed help text for attribute

getAttributeValidatingErrorMessageKey

String getAttributeValidatingErrorMessageKey(String entryName,
                                             String attributeName)

getAttributeValidatingErrorMessageParameters

String[] getAttributeValidatingErrorMessageParameters(String entryName,
                                                      String attributeName)

isAttributeRequired

Boolean isAttributeRequired(String entryName,
                            String attributeName)

indicates whether or not the named attribute is required

isAttributeDefined

Boolean isAttributeDefined(String entryName,
                           String attributeName)

indicates whether or not the named attribute is defined in the business object xml

getAttributeValuesFinderClass

Class<? extends KeyValuesFinder> getAttributeValuesFinderClass(String entryName,
                                                               String attributeName)

the Class that returns a values list for this attribute

getCollectionLabel

String getCollectionLabel(String entryName,
                          String collectionName)

the label to be used for displaying the collection.

getCollectionShortLabel

String getCollectionShortLabel(String entryName,
                               String collectionName)

the short label to be used for displaying the collection.

getCollectionElementLabel

String getCollectionElementLabel(String entryName,
                                 String collectionName,
                                 Class businessObjectClass)

the element label to be used for displaying the collection.

getCollectionSummary

String getCollectionSummary(String entryName,
                            String collectionName)

short help text for collection

getCollectionDescription

String getCollectionDescription(String entryName,
                                String collectionName)

detailed help text for collection

getRelationshipSourceClass

Class<? extends BusinessObject> getRelationshipSourceClass(String entryName,
                                                           String relationshipName)

Parameters:

entryName -

relationshipName -

Returns:

source Class for the given relationship, or null if there is no relationship with that name

getRelationshipTargetClass

Class<? extends BusinessObject> getRelationshipTargetClass(String entryName,
                                                           String relationshipName)

Parameters:

entryName -

relationshipName -

Returns:

target Class for the given relationship, or null if there is no relationship with that name

getRelationshipSourceAttributes

List<String> getRelationshipSourceAttributes(String entryName,
                                             String relationshipName)

Parameters:

entryName -

relationshipName -

Returns:

List of source attributeNames for the given relationship, or null if there is no relationship with that name

getRelationshipTargetAttributes

List<String> getRelationshipTargetAttributes(String entryName,
                                             String relationshipName)

Parameters:

entryName -

relationshipName -

Returns:

List of target attributeNames for the given relationship, or null if there is no relationship with that name

getRelationshipAttributeMap

Map<String,String> getRelationshipAttributeMap(String entryName,
                                               String relationshipName)

returns a Map that specifies the attributes of the relationship

Parameters:

entryName - - Name of the Business Object entry

relationshipName - - Name of the relationship

Returns:

Map - Target field as key, source field as value

getRelationshipEntriesForSourceAttribute

List<String> getRelationshipEntriesForSourceAttribute(String entryName,
                                                      String sourceAttributeName)

returns a list of names for all entries whose source parameter matches the parameter

Parameters:

entryName - Name of the Business Object entry

sourceAttributeName - name of the source attribute

Returns:

the names of all entries that use the sourceAttributeName as a primitive attribute

getRelationshipEntriesForTargetAttribute

List<String> getRelationshipEntriesForTargetAttribute(String entryName,
                                                      String targetAttributeName)

returns a list of names for all entries whose source parameter matches the parameter

Parameters:

entryName - Name of the Business Object entry

targetAttributeName - name of the target attribute

Returns:

the names of all entries that use the targetAttributeName as a primitive attribute

hasRelationship

boolean hasRelationship(String entryName,
                        String relationshipName)

Determines whether there is a relationship defined for the given entry with the given name

Parameters:

entryName - name of the BO entry

relationshipName - name of the relationship for the entry

Returns:

true iff there is a relationship with the given name defined for the BO entry in the DD

getRelationshipNames

List<String> getRelationshipNames(String entryName)

Returns all of the relationships defined for a BO in the DD

Parameters:

name - of the BO entry

Returns:

a list of all DD defined mappings

getDocumentLabelByTypeName

String getDocumentLabelByTypeName(String documentTypeName)

This method returns the user friendly label based on the workflow doc type name

Parameters:

documentTypeName -

Returns:

label

getDocumentLabelByClass

String getDocumentLabelByClass(Class documentOrBusinessObjectClass)

This method returns the user friendly label based on the document or business object class

Parameters:

documentTypeName -

Returns:

label

getDocumentTypeNameByClass

String getDocumentTypeNameByClass(Class documentClass)

Returns the document type name declared in the dd for the given document class. If no valid document type is found 'null' is returned.

Parameters:

documentClass -

Returns:

documentTypeName

getValidDocumentTypeNameByClass

String getValidDocumentTypeNameByClass(Class documentClass)

Returns the document type name declared in the dd for the given document class. If no valid document type is found an UnknownDocumentTypeException is thrown.

Parameters:

documentClass -

Returns:

documentTypeName

getDocumentClassByTypeName

Class<? extends Document> getDocumentClassByTypeName(String documentTypeName)

Returns the document class declared in the dd for the given document type name. If no document entry is found with given document type name, 'null' will be returned.

Parameters:

documentTypeName -

Returns:

document Class

getValidDocumentClassByTypeName

Class<? extends Document> getValidDocumentClassByTypeName(String documentTypeName)

Returns the document class declared in the dd for the given document type name. If no document entry is found with given document type name, and UnknownDocumentTypeException will be thrown.

Parameters:

documentTypeName -

Returns:

document Class

getPromptBeforeValidationClass

Class<? extends PromptBeforeValidation> getPromptBeforeValidationClass(String docTypeName)

Parameters:

document -

Returns:

preRulesCheckClass associated with the given document's type

getDataDictionaryMap

Map getDataDictionaryMap()

getAllInactivationBlockingDefinitions

Set<InactivationBlockingMetadata> getAllInactivationBlockingDefinitions(Class inactivationBlockedBusinessObjectClass)

Returns all of the inactivation blocks registered for a particular business object

Parameters:

inactivationBlockedBusinessObjectClass -

Returns:

a set of all registered inactivation blocks for a particular business object