com.retek.component.customer.impl.persistence
Interface CustomerDao

All Known Implementing Classes:
CacheCustomerDao, OracleCustomerDao

public interface CustomerDao

The interface that defines persistence-layer operations available on customer objects.

See Also:
Customer

Method Summary
 ReferenceCache createReferenceCache(java.lang.Class businessInterface)
          Creates a reference for a new given businessInterface.
 java.util.List find(CustomerFindCriteria findCriteria)
          Finds all customers meeting the given criteria.
 java.util.Set findAllCustomerChangeReasons()
          Finds all customer change reasons.
 java.util.Set findAllCustomerInactiveReasons()
          Finds all CustomerInactiveReasonDtos
 java.util.List findAllMatchRules()
          Finds all match rules.
 java.util.Set findCustomerCreditPreApproval(CustomerCreditPreApprovalSearchCriteria findCriteria)
          Finds all customer credit pre-approvals that match the given criteria.
 java.util.List findCustomerReferences(CustomerExportSearchCriteria findCriteria)
          Finds all customers references meeting the given criteria.
 java.util.List findCustomerReferences(CustomerFindCriteria findCriteria)
          Finds all customers references meeting the given criteria.
 java.util.Set findProcessedCustomerImportRequestIds(java.util.Set importRequestIds)
          Find previously processed customer import request ids.
 java.util.Set findStoredValueCardCashoutsForSalesAuditExport()
          Finds all StoredValueCardCashoutDtos with a sales audit state of READY
 java.util.List getSalutations()
          Reads all of the customer salutations (e.g.
 java.util.List getSuffixes()
          Reads all of the customer suffixes (e.g.
 CustomerCreditPreApprovalDto persist(CustomerCreditPreApprovalDto preApprovalDto)
          Persists a customer credit pre-approval.
 CustomerDto persist(CustomerDto customerDto)
          Persists a customer.
 StoredValueCardCashoutDto persist(StoredValueCardCashoutDto cashoutDto)
          Persists a stored value card cashout record.
 CustomerDto read(DistributedReference ref)
          Reads the customer for the given reference.
 CustomerAddressDto readAddress(DistributedReference ref)
          Reads the customer address for the given reference.
 CustomerChangeReasonDto readCustomerChangeReason(DistributedReference ref)
          Read a customer change reason
 CustomerInactiveReasonDto readCustomerInactiveReason(DistributedReference ref)
          Read a customer inactive reason
 java.util.List readCustomers(java.util.Collection refs)
          Reads the customers for the given references.
 SalutationDto readCustomerSalutation(DistributedReference ref)
          Reads the country for the given reference.
 SuffixDto readCustomerSuffix(DistributedReference ref)
          Reads the customer suffix (e.g.
 CustomerEmailAddressDto readEmailAddress(DistributedReference ref)
          Reads the customer email for the given reference.
 StoredValueCardCashoutDto readStoredValueCardCashout(DistributedReference ref)
          Read a stored value card cashout.
 CustomerTelephoneDto readTelephone(DistributedReference ref)
          Reads the customer telephone for the given reference.
 MatchRuleDto update(MatchRuleDto matchRuleDto)
          Persists changes to a match rule.
 

Method Detail

createReferenceCache

public ReferenceCache createReferenceCache(java.lang.Class businessInterface)
                                    throws SystemException
Creates a reference for a new given businessInterface. Responsible for retrieving the next unique CustomerOrderAddress id.

Returns:
reference to a new businessInterface
Throws:
SystemException

persist

public CustomerDto persist(CustomerDto customerDto)
                    throws SystemException
Persists a customer.

Parameters:
customerDto - customer dto
Throws:
java.lang.NullPointerException - if dto is null.
SystemException

persist

public CustomerCreditPreApprovalDto persist(CustomerCreditPreApprovalDto preApprovalDto)
                                     throws SystemException
Persists a customer credit pre-approval.

Throws:
java.lang.NullPointerException - if dto is null.
SystemException

persist

public StoredValueCardCashoutDto persist(StoredValueCardCashoutDto cashoutDto)
                                  throws SystemException
Persists a stored value card cashout record.

Throws:
java.lang.NullPointerException - if dto is null.
SystemException

read

public CustomerDto read(DistributedReference ref)
                 throws SystemException
Reads the customer for the given reference.

Returns:
Always either returns a CustomerDto or throws an exception. Never returns null.
Throws:
InvalidReferenceException - if the reference cannot be resolved.
SystemException

readCustomers

public java.util.List readCustomers(java.util.Collection refs)
                             throws SystemException
Reads the customers for the given references.

Parameters:
refs - customers to read
Returns:
Always either returns a CustomerDto or throws an exception. Never returns null.
Throws:
InvalidReferenceException - if the reference cannot be resolved.
SystemException

readAddress

public CustomerAddressDto readAddress(DistributedReference ref)
                               throws SystemException
Reads the customer address for the given reference.

Returns:
Always either returns a CustomerAddressDto or throws an exception. Never returns null.
Throws:
InvalidReferenceException - if the reference cannot be resolved.
SystemException

readTelephone

public CustomerTelephoneDto readTelephone(DistributedReference ref)
                                   throws SystemException
Reads the customer telephone for the given reference.

Returns:
Always either returns a CustomerTelephoneDto or throws an exception. Never returns null.
Throws:
InvalidReferenceException - if the reference cannot be resolved.
SystemException

readEmailAddress

public CustomerEmailAddressDto readEmailAddress(DistributedReference ref)
                                         throws SystemException
Reads the customer email for the given reference.

Returns:
Always either returns a CustomerEmailDto or throws an exception. Never returns null.
Throws:
InvalidReferenceException - if the reference cannot be resolved.
SystemException

readCustomerSalutation

public SalutationDto readCustomerSalutation(DistributedReference ref)
                                     throws SystemException
Reads the country for the given reference.

Returns:
Always either returns a CountryDto or throws an exception. Never returns null.
Throws:
InvalidReferenceException - if the reference cannot be resolved.
SystemException

readCustomerSuffix

public SuffixDto readCustomerSuffix(DistributedReference ref)
                             throws SystemException
Reads the customer suffix (e.g. Jr., Sr.) for the given reference.

Returns:
Always either returns a SuffixDto or throws an exception. Never returns null.
Throws:
InvalidReferenceException - if the reference cannot be resolved.
SystemException

getSuffixes

public java.util.List getSuffixes()
                           throws SystemException
Reads all of the customer suffixes (e.g. Jr., Sr.) supported by RCOM.

Throws:
InvalidReferenceException - if the reference cannot be resolved.
SystemException

getSalutations

public java.util.List getSalutations()
                              throws SystemException
Reads all of the customer salutations (e.g. Miss, Dr.) supported by RCOM.

Throws:
InvalidReferenceException - if the reference cannot be resolved.
SystemException

find

public java.util.List find(CustomerFindCriteria findCriteria)
                    throws SystemException
Finds all customers meeting the given criteria. If no criteria are specified, all customers will be found.

Returns:
An empty list if no customers exists for the given criteria.
Throws:
SystemException

findCustomerReferences

public java.util.List findCustomerReferences(CustomerFindCriteria findCriteria)
                                      throws SystemException
Finds all customers references meeting the given criteria.

Parameters:
findCriteria - customer search criteria
Returns:
customer references
Throws:
SystemException

findCustomerReferences

public java.util.List findCustomerReferences(CustomerExportSearchCriteria findCriteria)
                                      throws SystemException
Finds all customers references meeting the given criteria.

Parameters:
findCriteria - customer export search criteria
Returns:
customer references
Throws:
SystemException

findProcessedCustomerImportRequestIds

public java.util.Set findProcessedCustomerImportRequestIds(java.util.Set importRequestIds)
                                                    throws SystemException
Find previously processed customer import request ids.

Parameters:
importRequestIds - customer import request ids
Returns:
found import request ids
Throws:
SystemException

findCustomerCreditPreApproval

public java.util.Set findCustomerCreditPreApproval(CustomerCreditPreApprovalSearchCriteria findCriteria)
                                            throws SystemException
Finds all customer credit pre-approvals that match the given criteria.

Returns:
An empty list if no customer credit pre-approvals exist for the given criteria.
Throws:
SystemException

update

public MatchRuleDto update(MatchRuleDto matchRuleDto)
                    throws SystemException
Persists changes to a match rule.

Returns:
The match rule dto in its updated state.
Throws:
SystemException

findAllMatchRules

public java.util.List findAllMatchRules()
                                 throws SystemException
Finds all match rules.

Returns:
An empty list if no match rules exist.
Throws:
SystemException

findAllCustomerChangeReasons

public java.util.Set findAllCustomerChangeReasons()
                                           throws SystemException
Finds all customer change reasons.

Returns:
An empty set if no change reasons exist.
Throws:
SystemException

readStoredValueCardCashout

public StoredValueCardCashoutDto readStoredValueCardCashout(DistributedReference ref)
                                                     throws SystemException
Read a stored value card cashout.

Parameters:
ref -
Returns:
StoredValueCardCashout
Throws:
SystemException

findStoredValueCardCashoutsForSalesAuditExport

public java.util.Set findStoredValueCardCashoutsForSalesAuditExport()
                                                             throws SystemException
Finds all StoredValueCardCashoutDtos with a sales audit state of READY

Returns:
An empty set if no cashouts are ready.
Throws:
SystemException

findAllCustomerInactiveReasons

public java.util.Set findAllCustomerInactiveReasons()
                                             throws SystemException
Finds all CustomerInactiveReasonDtos

Returns:
An empty set if no inactive reasons are in the DB.
Throws:
SystemException

readCustomerInactiveReason

public CustomerInactiveReasonDto readCustomerInactiveReason(DistributedReference ref)
                                                     throws SystemException
Read a customer inactive reason

Parameters:
ref -
Returns:
CustomerInactiveReason
Throws:
SystemException

readCustomerChangeReason

public CustomerChangeReasonDto readCustomerChangeReason(DistributedReference ref)
                                                 throws SystemException
Read a customer change reason

Parameters:
ref -
Returns:
CustomerChangeReasonDto
Throws:
SystemException


Copyright © 2004 Retek Inc. All Rights Reserved. - Generated at Fri, 10/22/2004 07:28