org.kuali.rice.kew.framework.document.search
Class DocumentSearchResultSetConfiguration

java.lang.Object
  extended by org.kuali.rice.core.api.mo.AbstractDataTransferObject
      extended by org.kuali.rice.kew.framework.document.search.DocumentSearchResultSetConfiguration
All Implemented Interfaces:
Serializable, ModelObjectBasic, ModelObjectComplete, DocumentSearchResultSetConfigurationContract

public final class DocumentSearchResultSetConfiguration
extends AbstractDataTransferObject
implements DocumentSearchResultSetConfigurationContract

An immutable data transfer object implementation of the DocumentSearchResultSetConfigurationContract. Instances of this class should be constructed using the nested DocumentSearchResultSetConfiguration.Builder class.

Author:
Kuali Rice Team (rice.collab@kuali.org)
See Also:
Serialized Form

Nested Class Summary
static class DocumentSearchResultSetConfiguration.Builder
          A builder which can be used to construct DocumentSearchResultSetConfiguration instances.
 
Method Summary
 List<RemotableAttributeField> getAdditionalAttributeFields()
          Gets attribute field definitions for additional attributes that may be displayed in the result set.
 List<String> getCustomFieldNamesToAdd()
          Returns a list of field names of custom fields representing document attributes which should be added to the result set.
 List<StandardResultField> getStandardResultFieldsToRemove()
          Returns a list of the standard (built-in) document search result fields which should not be displayed in the result set.
 boolean isOverrideSearchableAttributes()
          Returns true if the custom field names returned by DocumentSearchResultSetConfigurationContract.getCustomFieldNamesToAdd() should be used to define the order of searchable attributes as well as additional custom additional fields.
 
Methods inherited from class org.kuali.rice.core.api.mo.AbstractDataTransferObject
afterUnmarshal, beforeUnmarshal, equals, hashCode, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Method Detail

isOverrideSearchableAttributes

public boolean isOverrideSearchableAttributes()
Description copied from interface: DocumentSearchResultSetConfigurationContract
Returns true if the custom field names returned by DocumentSearchResultSetConfigurationContract.getCustomFieldNamesToAdd() should be used to define the order of searchable attributes as well as additional custom additional fields. Returns false if any searchable attribute values should be included in the result set according to their existing configuration.

Specified by:
isOverrideSearchableAttributes in interface DocumentSearchResultSetConfigurationContract
Returns:
true if custom field names defined by this object should override any default searchable attribute result field display behavior, flase if searchable attribute fields should still be displayed in the result set according to their own configuration

getCustomFieldNamesToAdd

public List<String> getCustomFieldNamesToAdd()
Description copied from interface: DocumentSearchResultSetConfigurationContract
Returns a list of field names of custom fields representing document attributes which should be added to the result set. This may contains fields that are defined in DocumentSearchResultSetConfigurationContract.getAdditionalAttributeFields() or also fields defined as part of a SearchableAttribute (see isOverrideSearchableAttributes()).

Specified by:
getCustomFieldNamesToAdd in interface DocumentSearchResultSetConfigurationContract
Returns:
a list of field names of custom document attributes which should be added to the result set, can be an empty or null list in which case no fields will be added

getStandardResultFieldsToRemove

public List<StandardResultField> getStandardResultFieldsToRemove()
Description copied from interface: DocumentSearchResultSetConfigurationContract
Returns a list of the standard (built-in) document search result fields which should not be displayed in the result set. The document search implementation should do it's best to honor the request to remove standard fields from the result set, but it is free to ignore such requests if needed. An example of this would be a preference for the implementation of document search that requires certain result set fields to remain (such as the document id and route log which is usually recommended to display).

Specified by:
getStandardResultFieldsToRemove in interface DocumentSearchResultSetConfigurationContract
Returns:
a list of standard result fields to remove from inclusion in the result set, may be an empty or null list if no standard result fields should be removed

getAdditionalAttributeFields

public List<RemotableAttributeField> getAdditionalAttributeFields()
Description copied from interface: DocumentSearchResultSetConfigurationContract
Gets attribute field definitions for additional attributes that may be displayed in the result set. This simply defines the attribute field definition for each of these fields, their inclusion here does not necessarily mean they will be visible in the result set. This is controlled primarily by DocumentSearchResultSetConfigurationContract.getCustomFieldNamesToAdd().

Specified by:
getAdditionalAttributeFields in interface DocumentSearchResultSetConfigurationContract
Returns:
a list containing additional attribute fields to define for use when constructing the result set, this method can return a null or empty list if there are no additional attribute fields to define


Copyright © 2005-2012 The Kuali Foundation. All Rights Reserved.