com.saperion.connector.service

Class RmiClientLookupEntryService

java.lang.Object

com.saperion.connector.service.AbstractRmiClientService

com.saperion.connector.service.RmiClientLookupEntryService

All Implemented Interfaces:

LookupEntryService

public class RmiClientLookupEntryService
extends AbstractRmiClientService
implements LookupEntryService

This LookupEntryService provides lookup entry functionality by delegating to a remote saperion system via RMI.

Author:

jschwarz

Field Summary

Fields inherited from class com.saperion.connector.service.AbstractRmiClientService

connection

Constructor Summary

Constructors

Constructor and Description
RmiClientLookupEntryService(Connection connection)

Method Summary

Methods

Modifier and Type	Method and Description
com.lexmark.saperion.LookupEntryReferenceType	createLookupEntry(com.lexmark.saperion.document.DocumentDefinitionReferenceType definitionReference, Map<String,Object> indexData) Creates a new lookup entry with the given index data in the given definition.
com.lexmark.saperion.LookupEntryReferenceType	createLookupEntry(com.lexmark.saperion.document.DocumentDefinitionReferenceType definitionReference, Map<String,Object> indexData, List<com.lexmark.saperion.administration.AclReferenceType> aclReferences) Creates a new lookup entry with the given index data in the given definition with the given access control lists.
void	deleteLookupEntry(com.lexmark.saperion.LookupEntryReferenceType id) Deletes the lookup entry give by its id.
List<com.lexmark.saperion.administration.AclReferenceType>	getAccessControlLists(com.lexmark.saperion.LookupEntryReferenceType reference) This method returns the list of access control lists set on a given lookup entry.
Set<com.lexmark.saperion.administration.AccessRight>	getAccessOnEntry(com.lexmark.saperion.LookupEntryReferenceType reference) This method returns the current users rights on the given lookup entry.
com.lexmark.saperion.LookupEntryType	getLookupEntry(com.lexmark.saperion.LookupEntryReferenceType reference) This method returns the lookup entry the given reference references.
List<com.lexmark.saperion.LookupEntryType>	searchLookupEntries(com.lexmark.saperion.document.DocumentDefinitionReferenceType documentDefinitionReference, QueryExpression<Boolean> filter) This method lists the lookup entries that meet a given filtering condition.
com.lexmark.saperion.LookupEntryType	searchUniqueLookupEntry(com.lexmark.saperion.document.DocumentDefinitionReferenceType documentDefinitionReference, QueryExpression<Boolean> filter) This method returns the single lookup entry from a given ddc that meets the given filtering condition.
void	updateLookEntry(com.lexmark.saperion.LookupEntryReferenceType id, Map<String,Object> indexDataChanges) Updates the lookup entry given by the id in the given ddc with the given properties.
void	updateLookEntry(com.lexmark.saperion.LookupEntryReferenceType id, Map<String,Object> indexDataChanges, List<com.lexmark.saperion.administration.AclReferenceType> aclReferences) Updates the lookup entry given by the id in the given ddc with the given properties and the given access control lists.

Methods inherited from class com.saperion.connector.service.AbstractRmiClientService

mapSystemException

Methods inherited from class java.lang.Object

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

Constructor Detail

RmiClientLookupEntryService

public RmiClientLookupEntryService(Connection connection)

Method Detail

createLookupEntry

public com.lexmark.saperion.LookupEntryReferenceType createLookupEntry(com.lexmark.saperion.document.DocumentDefinitionReferenceType definitionReference,
                                                              Map<String,Object> indexData,
                                                              List<com.lexmark.saperion.administration.AclReferenceType> aclReferences)
                                                                throws SaBasicException

Description copied from interface: LookupEntryService

Creates a new lookup entry with the given index data in the given definition with the given access control lists.

Specified by:

createLookupEntry in interface LookupEntryService

Parameters:

definitionReference - the definition to create the entry in

indexData - the index data of the new lookup entry

aclReferences - the access control lists securing the new lookup entry

Returns:

the id of the newly created entry

Throws:

SaBasicException

createLookupEntry

public com.lexmark.saperion.LookupEntryReferenceType createLookupEntry(com.lexmark.saperion.document.DocumentDefinitionReferenceType definitionReference,
                                                              Map<String,Object> indexData)
                                                                throws SaBasicException

Description copied from interface: LookupEntryService

Creates a new lookup entry with the given index data in the given definition.

Specified by:

createLookupEntry in interface LookupEntryService

Parameters:

definitionReference - the definition to create the entry in

indexData - the index data of the new lookup entry

Returns:

the id of the newly created entry

Throws:

SaBasicException

updateLookEntry

public void updateLookEntry(com.lexmark.saperion.LookupEntryReferenceType id,
                   Map<String,Object> indexDataChanges,
                   List<com.lexmark.saperion.administration.AclReferenceType> aclReferences)
                     throws SaBasicException

Description copied from interface: LookupEntryService

Updates the lookup entry given by the id in the given ddc with the given properties and the given access control lists.

Specified by:

updateLookEntry in interface LookupEntryService

Parameters:

id - the id of the document to update

indexDataChanges - the new index values. Only the changed values need to be specified. If a property should be deleted set it to DeleteDocumentProperty.INSTANCE

aclReferences - the new access control lists securing the lookup entry or null if no change in the access control lists is intended

Throws:

SaBasicException

updateLookEntry

public void updateLookEntry(com.lexmark.saperion.LookupEntryReferenceType id,
                   Map<String,Object> indexDataChanges)
                     throws SaBasicException

Description copied from interface: LookupEntryService

Updates the lookup entry given by the id in the given ddc with the given properties.

Specified by:

updateLookEntry in interface LookupEntryService

Parameters:

id - the id of the document to update

indexDataChanges - the new index values. Only the changed values need to be specified. If a property should be deleted set it to DeleteDocumentProperty.INSTANCE

Throws:

SaBasicException

deleteLookupEntry

public void deleteLookupEntry(com.lexmark.saperion.LookupEntryReferenceType id)
                       throws SaBasicException

Description copied from interface: LookupEntryService

Deletes the lookup entry give by its id.

Specified by:

deleteLookupEntry in interface LookupEntryService

Parameters:

id - the id of the lookup entry to delete

Throws:

SaBasicException

searchUniqueLookupEntry

public com.lexmark.saperion.LookupEntryType searchUniqueLookupEntry(com.lexmark.saperion.document.DocumentDefinitionReferenceType documentDefinitionReference,
                                                           QueryExpression<Boolean> filter)
                                                             throws SaBasicException

Description copied from interface: LookupEntryService

This method returns the single lookup entry from a given ddc that meets the given filtering condition. If no such entry exists, null will be returned. If several such entries exist an exception is thrown.

Specified by:

searchUniqueLookupEntry in interface LookupEntryService

Parameters:

documentDefinitionReference - a reference to a lookup ddc to search in

filter - a filter defining which unique lookup entry to return

Returns:

the single lookup entry from a given ddc that meets the given filtering condition

Throws:

SaBasicException

searchLookupEntries

public List<com.lexmark.saperion.LookupEntryType> searchLookupEntries(com.lexmark.saperion.document.DocumentDefinitionReferenceType documentDefinitionReference,
                                                             QueryExpression<Boolean> filter)
                                                               throws SaBasicException

Description copied from interface: LookupEntryService

This method lists the lookup entries that meet a given filtering condition.

Specified by:

searchLookupEntries in interface LookupEntryService

Parameters:

documentDefinitionReference - a reference to a lookup ddc to search in

filter - a filter defining which lookup entries to return

Returns:

the list of all lookup entries in the given ddc that meet the condition

Throws:

SaBasicException

getLookupEntry

public com.lexmark.saperion.LookupEntryType getLookupEntry(com.lexmark.saperion.LookupEntryReferenceType reference)
                                                    throws SaBasicException

Description copied from interface: LookupEntryService

This method returns the lookup entry the given reference references. Will throw an UnknownReferenceException if there is no lookup entry with the given reference.

Specified by:

getLookupEntry in interface LookupEntryService

Parameters:

reference - a reference to the lookup entry to obtain

Returns:

the lookup entry the reference references

Throws:

SaBasicException

getAccessControlLists

public List<com.lexmark.saperion.administration.AclReferenceType> getAccessControlLists(com.lexmark.saperion.LookupEntryReferenceType reference)
                                                                                 throws SaBasicException

Description copied from interface: LookupEntryService

This method returns the list of access control lists set on a given lookup entry.

Specified by:

getAccessControlLists in interface LookupEntryService

Parameters:

reference - a reference to the lookup entry to obtain the access control lists for

Returns:

a list of references to the access control lists set on the given lokup entry

Throws:

SaBasicException

getAccessOnEntry

public Set<com.lexmark.saperion.administration.AccessRight> getAccessOnEntry(com.lexmark.saperion.LookupEntryReferenceType reference)
                                                                      throws SaBasicException

Description copied from interface: LookupEntryService

This method returns the current users rights on the given lookup entry.

Specified by:

getAccessOnEntry in interface LookupEntryService

Parameters:

reference - the id of the lookup entry to evaluate the current users rights for

Returns:

the current users rights on the given lookup entry

Throws:

SaBasicException