com.atlassian.crowd.dao.token
Interface TokenDAO

All Known Implementing Classes:

TokenDAOMemory

public interface TokenDAO

Manages persistence of Token

Method Summary

Token	add(Token token) Persists a new token.
Token	findByID(long ID) Finds token by its id.
Token	findByIdentifierHash(java.lang.String identifierHash) Finds token by identifier hash.
Token	findByRandomHash(java.lang.String randomHash) Finds token by random hash.
java.util.Collection<Token>	loadAll() Used when switching implementations.
void	remove(long directoryId, java.lang.String name) Remove token.
void	remove(Token token) Removes a token.
void	removeAccessedBefore(java.util.Date expiryTime) Remove all tokens by expiryTime.
void	removeAll() Wipes all tokens from the store.
void	removeAll(long directoryId) Remove all tokens associated with the given directory id.
void	saveAll(java.util.Collection<Token> tokens) Used when switching implementations.
java.util.List<Token>	search(EntityQuery query) Searches for token based on criteria.
Token	update(Token token)

Method Detail

findByRandomHash

Token findByRandomHash(java.lang.String randomHash)
                       throws ObjectNotFoundException

Finds token by random hash.

Parameters:

randomHash - Random hash.

Returns:

Token.

Throws:

ObjectNotFoundException - if the token identified by the random hash cannot be found.

findByIdentifierHash

Token findByIdentifierHash(java.lang.String identifierHash)
                           throws ObjectNotFoundException

Finds token by identifier hash.

Parameters:

identifierHash - Identifier hash.

Returns:

Token.

Throws:

ObjectNotFoundException - if the token identified by the identifier hash cannot be found.

add

Token add(Token token)

Persists a new token.

Parameters:

token - Token.

Returns:

The persisted token.

update

Token update(Token token)
             throws ObjectNotFoundException

Parameters:

token - token to update.

Returns:

updates the last accessed date on the token (sets it to now).

Throws:

ObjectNotFoundException

remove

void remove(Token token)

Removes a token.

Parameters:

token - Token.

search

java.util.List<Token> search(EntityQuery query)

Searches for token based on criteria.

Parameters:

query - Query.

Returns:

List of tokens which qualify for the criteria.

findByID

Token findByID(long ID)
               throws ObjectNotFoundException

Finds token by its id.

Parameters:

ID - id.

Returns:

Token.

Throws:

ObjectNotFoundException - if the Token cannot be found.

remove

void remove(long directoryId,
            java.lang.String name)

Remove token.

Parameters:

directoryId - Directory id.

name - User or application name.

removeAll

void removeAll(long directoryId)

Remove all tokens associated with the given directory id.

Parameters:

directoryId - Directory id.

removeAccessedBefore

void removeAccessedBefore(java.util.Date expiryTime)

Remove all tokens by expiryTime.

Parameters:

expiryTime - Expiry time.

removeAll

void removeAll()

Wipes all tokens from the store. Called after a successful loadAll() and persist into another store.

Throws:

org.springframework.dao.DataAccessException

loadAll

java.util.Collection<Token> loadAll()

Used when switching implementations. Synchronisation is the caller's responsibility; don't allow calls to other methods while this is in progress if you need to guarantee that the data are complete.

Returns:

Collection of all active tokens.

Throws:

org.springframework.dao.DataAccessException - If the tokens could not be retrieved.

saveAll

void saveAll(java.util.Collection<Token> tokens)

Used when switching implementations. Synchronization is the caller's reponsibility; don't allow calls to other methods while this is in progress if you need to guarantee that the data are complete.

Parameters:

tokens - all tokens to add.

Throws:

org.springframework.dao.DataAccessException