public static final class DocumentSearchCriteria.Builder extends Object implements Serializable, ModelBuilder, DocumentSearchCriteriaContract
DocumentSearchCriteria
instances. Enforces the constraints of
the DocumentSearchCriteriaContract
.Modifier and Type | Method and Description |
---|---|
void |
addDocumentAttributeValue(String name,
String value)
add document attribute value to an internal map
|
DocumentSearchCriteria |
build()
Returns an instance of the object being built by this builder based
on the current state of the builder.
|
static DocumentSearchCriteria.Builder |
create()
Creates an empty builder instance.
|
static DocumentSearchCriteria.Builder |
create(DocumentSearchCriteriaContract contract)
Creates a new builder instance initialized with copies of the properties from the given contract.
|
List<String> |
getAdditionalDocumentTypeNames()
Returns an optional list of additional document type name criteria against which to search.
|
String |
getApplicationDocumentId()
Returns the application document id criteria to search against when executing the document search.
|
String |
getApplicationDocumentStatus()
Deprecated.
use
getApplicationDocumentStatuses() instead |
List<String> |
getApplicationDocumentStatuses()
Return the list of application document statuses to match when executing the document search.
|
String |
getApproverPrincipalId()
Returns the criteria for the principal id of an "approver" of a document (someone who took action against
the document) to search against when executing the document search.
|
String |
getApproverPrincipalName()
Deprecated.
use
getApproverPrincipalId() instead |
org.joda.time.DateTime |
getDateApplicationDocumentStatusChangedFrom()
Returns the inclusive lower end of the date of application document status change criteria to search against when executing the document search.
|
org.joda.time.DateTime |
getDateApplicationDocumentStatusChangedTo()
Returns the inclusive upper end of the date of application document status change criteria to search against when executing the document search.
|
org.joda.time.DateTime |
getDateApprovedFrom()
Returns the inclusive lower end of the date approved criteria to search against when executing the document search.
|
org.joda.time.DateTime |
getDateApprovedTo()
Returns the inclusive upper end of the date approved criteria to search against when executing the document search.
|
org.joda.time.DateTime |
getDateCreatedFrom()
Returns the inclusive lower end of the date created criteria to search against when executing the document search.
|
org.joda.time.DateTime |
getDateCreatedTo()
Returns the inclusive upper end of the date created criteria to search against when executing the document search.
|
org.joda.time.DateTime |
getDateFinalizedFrom()
Returns the inclusive lower end of the date finalized criteria to search against when executing the document search.
|
org.joda.time.DateTime |
getDateFinalizedTo()
Returns the inclusive upper end of the date finalized criteria to search against when executing the document search.
|
org.joda.time.DateTime |
getDateLastModifiedFrom()
Returns the inclusive lower end of the date last modified criteria to search against when executing the document search.
|
org.joda.time.DateTime |
getDateLastModifiedTo()
Returns the inclusive upper end of the date last modified criteria to search against when executing the document search.
|
String |
getDocSearchUserId()
Returns the principalId of the user performing the search
|
Map<String,List<String>> |
getDocumentAttributeValues()
Returns a map of document attribute values to search against when executing the document search.
|
String |
getDocumentId()
Returns the document id criteria to search against when executing the document search.
|
List<DocumentStatusCategory> |
getDocumentStatusCategories()
Returns an unmodifiable list of document status categories to search against when executing the document search.
|
List<DocumentStatus> |
getDocumentStatuses()
Returns an unmodifiable list of document statuses to search against when executing the document search.
|
String |
getDocumentTypeName()
Returns the document type name criteria to search against when executing the document search.
|
String |
getGroupViewerId()
Returns the criteria for the id of a group who is a "viewer" of a document (a group who received an action request
related to the document) to search against when executing the document search.
|
String |
getGroupViewerName()
Returns the criteria for the name of a group who is a "viewer" of a document (a group who received an action request
related to the document) to search against when executing the document search.
|
String |
getInitiatorPrincipalId()
Returns the criteria for the principal id of the document initiator to search against when executing the
document search.
|
String |
getInitiatorPrincipalName()
Deprecated.
use
getInitiatorPrincipalId() instead |
String |
getIsAdvancedSearch()
Returns a string that indicates if a query was run in advanced mode.
|
Integer |
getMaxResults()
Returns the requested maximum number of documents that should be returned from a document search performed using this
criteria.
|
RouteNodeLookupLogic |
getRouteNodeLookupLogic()
Returns the logic that should be used when performing a document search against the route name.
|
String |
getRouteNodeName()
Returns the route node name criteria to search against when executing the document search.
|
String |
getSaveName()
Return the name under which to save this criteria so that it can be recalled and used again in the future.
|
Map<String,List<String>> |
getSearchOptions()
Returns a map of custom options for document search when either executing the document search or returning results.
|
Integer |
getStartAtIndex()
Returns the 0-based index in the result set at which to start returning results from a document search which is
performed using this criteria.
|
String |
getTitle()
Returns the document title criteria to search against when executing the document search.
|
String |
getViewerPrincipalId()
Returns the criteria for the principal id of a "viewer" of a document (someone who received an action request
related to the document) to search against when executing the document search.
|
String |
getViewerPrincipalName()
Deprecated.
use
getViewerPrincipalId() instead |
void |
normalizeDateTimes()
Resets DateTimes to local TimeZone (preserving absolute time)
|
void |
setAdditionalDocumentTypeNames(List<String> additionalDocumentTypeNames) |
void |
setApplicationDocumentId(String applicationDocumentId) |
void |
setApplicationDocumentStatus(String applicationDocumentStatus)
Deprecated.
use
setApplicationDocumentStatuses(java.util.List) instead |
void |
setApplicationDocumentStatuses(List<String> applicationDocumentStatuses) |
void |
setApproverPrincipalId(String approverPrincipalId) |
void |
setApproverPrincipalName(String approverPrincipalName)
Deprecated.
use
setApproverPrincipalId(String) instead |
void |
setDateApplicationDocumentStatusChangedFrom(org.joda.time.DateTime dateApplicationDocumentStatusChangedFrom) |
void |
setDateApplicationDocumentStatusChangedTo(org.joda.time.DateTime dateApplicationDocumentStatusChangedTo) |
void |
setDateApprovedFrom(org.joda.time.DateTime dateApprovedFrom) |
void |
setDateApprovedTo(org.joda.time.DateTime dateApprovedTo) |
void |
setDateCreatedFrom(org.joda.time.DateTime dateCreatedFrom) |
void |
setDateCreatedTo(org.joda.time.DateTime dateCreatedTo) |
void |
setDateFinalizedFrom(org.joda.time.DateTime dateFinalizedFrom) |
void |
setDateFinalizedTo(org.joda.time.DateTime dateFinalizedTo) |
void |
setDateLastModifiedFrom(org.joda.time.DateTime dateLastModifiedFrom) |
void |
setDateLastModifiedTo(org.joda.time.DateTime dateLastModifiedTo) |
void |
setDocSearchUserId(String docSearchUserId) |
void |
setDocumentAttributeValues(Map<String,List<String>> documentAttributeValues) |
void |
setDocumentId(String documentId) |
void |
setDocumentStatusCategories(List<DocumentStatusCategory> documentStatusCategories) |
void |
setDocumentStatuses(List<DocumentStatus> documentStatuses) |
void |
setDocumentTypeName(String documentTypeName) |
void |
setGroupViewerId(String groupViewerId) |
void |
setGroupViewerName(String groupViewerName) |
void |
setInitiatorPrincipalId(String initiatorPrincipalId) |
void |
setInitiatorPrincipalName(String initiatorPrincipalName)
Deprecated.
use
setInitiatorPrincipalId(String) instead |
void |
setIsAdvancedSearch(String isAdvancedSearch) |
void |
setMaxResults(Integer maxResults) |
void |
setRouteNodeLookupLogic(RouteNodeLookupLogic routeNodeLookupLogic) |
void |
setRouteNodeName(String routeNodeName) |
void |
setSaveName(String saveName) |
void |
setSearchOptions(Map<String,List<String>> searchOptions) |
void |
setStartAtIndex(Integer startAtIndex) |
void |
setTitle(String title) |
void |
setViewerPrincipalId(String viewerPrincipalId) |
void |
setViewerPrincipalName(String viewerPrincipalName)
Deprecated.
use
setViewerPrincipalId(String) instead |
public static DocumentSearchCriteria.Builder create()
public static DocumentSearchCriteria.Builder create(DocumentSearchCriteriaContract contract)
contract
- the contract from which to copy propertiesIllegalArgumentException
- if the given contract is nullpublic DocumentSearchCriteria build()
ModelBuilder
build
in interface ModelBuilder
public String getDocumentId()
DocumentSearchCriteriaContract
getDocumentId
in interface DocumentSearchCriteriaContract
public List<DocumentStatus> getDocumentStatuses()
DocumentSearchCriteriaContract
getDocumentStatuses
in interface DocumentSearchCriteriaContract
public List<DocumentStatusCategory> getDocumentStatusCategories()
DocumentSearchCriteriaContract
getDocumentStatusCategories
in interface DocumentSearchCriteriaContract
public String getTitle()
DocumentSearchCriteriaContract
getTitle
in interface DocumentSearchCriteriaContract
public String getApplicationDocumentId()
DocumentSearchCriteriaContract
getApplicationDocumentId
in interface DocumentSearchCriteriaContract
@Deprecated public String getApplicationDocumentStatus()
getApplicationDocumentStatuses()
insteadDocumentSearchCriteriaContract
getApplicationDocumentStatus
in interface DocumentSearchCriteriaContract
@Deprecated public String getInitiatorPrincipalName()
getInitiatorPrincipalId()
insteadDocumentSearchCriteriaContract
getInitiatorPrincipalName
in interface DocumentSearchCriteriaContract
public String getInitiatorPrincipalId()
DocumentSearchCriteriaContract
getInitiatorPrincipalId
in interface DocumentSearchCriteriaContract
@Deprecated public String getViewerPrincipalName()
getViewerPrincipalId()
insteadDocumentSearchCriteriaContract
getViewerPrincipalName
in interface DocumentSearchCriteriaContract
public String getViewerPrincipalId()
DocumentSearchCriteriaContract
getViewerPrincipalId
in interface DocumentSearchCriteriaContract
public String getGroupViewerId()
DocumentSearchCriteriaContract
getGroupViewerId
in interface DocumentSearchCriteriaContract
public String getGroupViewerName()
DocumentSearchCriteriaContract
getGroupViewerName
in interface DocumentSearchCriteriaContract
@Deprecated public String getApproverPrincipalName()
getApproverPrincipalId()
insteadDocumentSearchCriteriaContract
getApproverPrincipalName
in interface DocumentSearchCriteriaContract
public String getApproverPrincipalId()
DocumentSearchCriteriaContract
getApproverPrincipalId
in interface DocumentSearchCriteriaContract
public String getRouteNodeName()
DocumentSearchCriteriaContract
DocumentSearchCriteriaContract.getRouteNodeLookupLogic()
returns
a non-null value that specifies different criteria for how the route node-based lookup should be performed.getRouteNodeName
in interface DocumentSearchCriteriaContract
public RouteNodeLookupLogic getRouteNodeLookupLogic()
DocumentSearchCriteriaContract
getRouteNodeLookupLogic
in interface DocumentSearchCriteriaContract
public String getDocumentTypeName()
DocumentSearchCriteriaContract
In order for the map of document attribute values to be properly searchable, this document type name should result to a valid document type. This is because the document type itself defines information about custom document attributes and the parameters around how searches against those attributes can be executed.
Note that searches against a document type name should be document type hierarchy-aware. Meaning that the search should also return results for any documents that have document types that are children of the specified document type name (assuming that the specified document type name is valid and not wildcarded at all).
getDocumentTypeName
in interface DocumentSearchCriteriaContract
public List<String> getAdditionalDocumentTypeNames()
DocumentSearchCriteriaContract
As with DocumentSearchCriteriaContract.getDocumentTypeName()
, the additional document type name criteria is document type hierarchy
aware.
getAdditionalDocumentTypeNames
in interface DocumentSearchCriteriaContract
public org.joda.time.DateTime getDateCreatedFrom()
DocumentSearchCriteriaContract
getDateCreatedFrom
in interface DocumentSearchCriteriaContract
public org.joda.time.DateTime getDateCreatedTo()
DocumentSearchCriteriaContract
getDateCreatedTo
in interface DocumentSearchCriteriaContract
public org.joda.time.DateTime getDateLastModifiedFrom()
DocumentSearchCriteriaContract
getDateLastModifiedFrom
in interface DocumentSearchCriteriaContract
public org.joda.time.DateTime getDateLastModifiedTo()
DocumentSearchCriteriaContract
getDateLastModifiedTo
in interface DocumentSearchCriteriaContract
public org.joda.time.DateTime getDateApprovedFrom()
DocumentSearchCriteriaContract
getDateApprovedFrom
in interface DocumentSearchCriteriaContract
public org.joda.time.DateTime getDateApprovedTo()
DocumentSearchCriteriaContract
getDateApprovedTo
in interface DocumentSearchCriteriaContract
public org.joda.time.DateTime getDateFinalizedFrom()
DocumentSearchCriteriaContract
getDateFinalizedFrom
in interface DocumentSearchCriteriaContract
public org.joda.time.DateTime getDateFinalizedTo()
DocumentSearchCriteriaContract
getDateFinalizedTo
in interface DocumentSearchCriteriaContract
public org.joda.time.DateTime getDateApplicationDocumentStatusChangedFrom()
DocumentSearchCriteriaContract
getDateApplicationDocumentStatusChangedFrom
in interface DocumentSearchCriteriaContract
public org.joda.time.DateTime getDateApplicationDocumentStatusChangedTo()
DocumentSearchCriteriaContract
getDateApplicationDocumentStatusChangedTo
in interface DocumentSearchCriteriaContract
public Map<String,List<String>> getDocumentAttributeValues()
DocumentSearchCriteriaContract
In order for the document attribute values to be processed as part of the criteria during the search, the
DocumentSearchCriteriaContract.getDocumentTypeName()
must return a valid name of a document type which is configured to understand the
attributes passed as part of the document attribute values map.
getDocumentAttributeValues
in interface DocumentSearchCriteriaContract
public Map<String,List<String>> getSearchOptions()
DocumentSearchCriteriaContract
In order for the search options to be processed as part of the criteria during the search, a custom document search customizer must be used to fill and process these values.
getSearchOptions
in interface DocumentSearchCriteriaContract
public String getSaveName()
DocumentSearchCriteriaContract
getSaveName
in interface DocumentSearchCriteriaContract
public Integer getStartAtIndex()
DocumentSearchCriteriaContract
getStartAtIndex
in interface DocumentSearchCriteriaContract
public Integer getMaxResults()
DocumentSearchCriteriaContract
It is important to note that this value is meant simply as a request to the document search for the number of results to return. The implementation may return fewer results then requested if it decides to impose it's own internal cap on results.
getMaxResults
in interface DocumentSearchCriteriaContract
public String getIsAdvancedSearch()
DocumentSearchCriteriaContract
getIsAdvancedSearch
in interface DocumentSearchCriteriaContract
public List<String> getApplicationDocumentStatuses()
DocumentSearchCriteriaContract
getApplicationDocumentStatuses
in interface DocumentSearchCriteriaContract
public String getDocSearchUserId()
DocumentSearchCriteriaContract
getDocSearchUserId
in interface DocumentSearchCriteriaContract
public void setDocumentId(String documentId)
public void setDocumentStatuses(List<DocumentStatus> documentStatuses)
public void setDocumentStatusCategories(List<DocumentStatusCategory> documentStatusCategories)
public void setApplicationDocumentId(String applicationDocumentId)
@Deprecated public void setApplicationDocumentStatus(String applicationDocumentStatus)
setApplicationDocumentStatuses(java.util.List)
insteadpublic void setInitiatorPrincipalName(String initiatorPrincipalName)
setInitiatorPrincipalId(String)
insteadinitiatorPrincipalName
- public void setInitiatorPrincipalId(String initiatorPrincipalId)
@Deprecated public void setViewerPrincipalName(String viewerPrincipalName)
setViewerPrincipalId(String)
insteadviewerPrincipalName
- public void setViewerPrincipalId(String viewerPrincipalId)
public void setGroupViewerId(String groupViewerId)
public void setGroupViewerName(String groupViewerName)
@Deprecated public void setApproverPrincipalName(String approverPrincipalName)
setApproverPrincipalId(String)
insteadapproverPrincipalName
- public void setApproverPrincipalId(String approverPrincipalId)
public void setRouteNodeName(String routeNodeName)
public void setRouteNodeLookupLogic(RouteNodeLookupLogic routeNodeLookupLogic)
public void setDocumentTypeName(String documentTypeName)
public void setAdditionalDocumentTypeNames(List<String> additionalDocumentTypeNames)
public void setDateCreatedFrom(org.joda.time.DateTime dateCreatedFrom)
public void setDateCreatedTo(org.joda.time.DateTime dateCreatedTo)
public void setDateLastModifiedFrom(org.joda.time.DateTime dateLastModifiedFrom)
public void setDateLastModifiedTo(org.joda.time.DateTime dateLastModifiedTo)
public void setDateApprovedFrom(org.joda.time.DateTime dateApprovedFrom)
public void setDateApprovedTo(org.joda.time.DateTime dateApprovedTo)
public void setDateFinalizedFrom(org.joda.time.DateTime dateFinalizedFrom)
public void setDateFinalizedTo(org.joda.time.DateTime dateFinalizedTo)
public void setDateApplicationDocumentStatusChangedFrom(org.joda.time.DateTime dateApplicationDocumentStatusChangedFrom)
public void setDateApplicationDocumentStatusChangedTo(org.joda.time.DateTime dateApplicationDocumentStatusChangedTo)
public void setDocumentAttributeValues(Map<String,List<String>> documentAttributeValues)
public void addDocumentAttributeValue(String name, String value)
name
- - the attribute namevalue
- - the attribute valuepublic void setSearchOptions(Map<String,List<String>> searchOptions)
public void setSaveName(String saveName)
public void setStartAtIndex(Integer startAtIndex)
public void setMaxResults(Integer maxResults)
public void setIsAdvancedSearch(String isAdvancedSearch)
public void setApplicationDocumentStatuses(List<String> applicationDocumentStatuses)
public void setDocSearchUserId(String docSearchUserId)
public void normalizeDateTimes()
Copyright © 2005–2015 The Kuali Foundation. All rights reserved.