com.hcl.domino.keep.cache

Interface NameLookupCache

All Superinterfaces:

KeepBaseCache

All Known Implementing Classes:

NameLookupCacheHolder

public interface NameLookupCache
extends KeepBaseCache

Cache to lookup NotesNames by email and eMail by NotesName expires after a few hours

Method Summary

Modifier and Type	Method and Description
void	add(java.lang.String notesName, java.lang.String eMail) Manually adds a cache entry into the caches
void	evict(java.lang.String notesName, java.lang.String eMail) Removes an cache entry from both Name and eMail lookup
default java.util.Optional<java.lang.String>	getEmailFromNotesName(com.hcl.domino.DominoClient client, java.lang.String notesName) Retrieve the Internet eMail associated with a NotesName
java.util.Optional<java.lang.String>	getEmailFromNotesName(com.hcl.domino.DominoClient client, java.lang.String notesName, boolean ignoreCache) Retrieve the Internet eMail associated with a NotesName
default java.util.Optional<java.lang.String>	getNotesNameFromEmail(com.hcl.domino.DominoClient client, java.lang.String eMailString) Retrieve a NotesName from an eMailId
java.util.Optional<java.lang.String>	getNotesNameFromEmail(com.hcl.domino.DominoClient client, java.lang.String eMailString, boolean ignoreCache) Retrieve a NotesName from an eMailId
java.util.Set<java.lang.String>	toEMail(com.hcl.domino.DominoClient client, java.util.Collection<java.lang.String> source) Translates a set of NotesName / eMail mix to eMails When an eMail is not found, the un-converted Name (which could be a group) gets returned
default io.vertx.core.json.JsonArray	toEMailJson(com.hcl.domino.DominoClient client, io.vertx.core.json.JsonArray source) Translates a set of NotesName / eMail mix to eMails When an eMail is not found, the un-converted Name (which could be a group) gets returned
java.util.Set<java.lang.String>	toNotesName(com.hcl.domino.DominoClient client, java.util.Collection<java.lang.String> source) Translates a set of eMails to NotesNames When an NotesName is not found, the un-converted eMail gets returned

Methods inherited from interface com.hcl.domino.keep.cache.KeepBaseCache

clear, evict, getCachePrefix, hasEntry

Method Detail

add

void add(java.lang.String notesName,
         java.lang.String eMail)

Manually adds a cache entry into the caches

Parameters:

notesName -

eMail -

evict

void evict(java.lang.String notesName,
           java.lang.String eMail)

Removes an cache entry from both Name and eMail lookup

Parameters:

notesName -

eMail -

getEmailFromNotesName

default java.util.Optional<java.lang.String> getEmailFromNotesName(com.hcl.domino.DominoClient client,
                                                                   java.lang.String notesName)

Retrieve the Internet eMail associated with a NotesName

Parameters:

client - DominoClient

notesName - a fully qualified Notes Name (X500) e.g. CN=John Doe/OU=Alpha/O=Acme Corp

Returns:

Optional with eMail, empty if that user doesn’t exist

getEmailFromNotesName

java.util.Optional<java.lang.String> getEmailFromNotesName(com.hcl.domino.DominoClient client,
                                                           java.lang.String notesName,
                                                           boolean ignoreCache)

Retrieve the Internet eMail associated with a NotesName

Parameters:

client - DominoClient

notesName - a fully qualified Notes Name (X500) e.g. CN=John Doe/OU=Alpha/O=Acme Corp

ignoreCache -

• true -> cache is ignored, full scan

Returns:

Optional with eMail, empty if that user doesn’t exist

getNotesNameFromEmail

default java.util.Optional<java.lang.String> getNotesNameFromEmail(com.hcl.domino.DominoClient client,
                                                                   java.lang.String eMailString)

Retrieve a NotesName from an eMailId

Parameters:

client - DominoClient

eMailString -

• the eMail too look up

Returns:

a qualified NotesName or back the NotesName if that user isn’t found

getNotesNameFromEmail

java.util.Optional<java.lang.String> getNotesNameFromEmail(com.hcl.domino.DominoClient client,
                                                           java.lang.String eMailString,
                                                           boolean ignoreCache)

Retrieve a NotesName from an eMailId

Parameters:

client - DominoClient

eMailString -

• the eMail too look up

ignoreCache -

• true -> cache is ignored, full scan

Returns:

a qualified NotesName as Optional, empty if user not found

toEMail

java.util.Set<java.lang.String> toEMail(com.hcl.domino.DominoClient client,
                                        java.util.Collection<java.lang.String> source)

Translates a set of NotesName / eMail mix to eMails When an eMail is not found, the un-converted Name (which could be a group) gets returned

Parameters:

client -

source -

Returns:

mostly eMails

toEMailJson

default io.vertx.core.json.JsonArray toEMailJson(com.hcl.domino.DominoClient client,
                                                 io.vertx.core.json.JsonArray source)

Translates a set of NotesName / eMail mix to eMails When an eMail is not found, the un-converted Name (which could be a group) gets returned

Parameters:

client -

source -

Returns:

mostly eMails

toNotesName

java.util.Set<java.lang.String> toNotesName(com.hcl.domino.DominoClient client,
                                            java.util.Collection<java.lang.String> source)

Translates a set of eMails to NotesNames When an NotesName is not found, the un-converted eMail gets returned

Parameters:

client -

source -

Returns:

mostly eMails