com.sk89q.squirrelid.cache

Class SQLiteCache

java.lang.Object

com.sk89q.squirrelid.cache.SQLiteCache

All Implemented Interfaces:

ProfileCache

public class SQLiteCache
extends Object

An implementation of a UUID cache using a SQLite database.

The implementation performs all requests in a single thread, so calls may block for a short period of time.

Constructor Summary

Constructors

Constructor and Description
SQLiteCache(File file) Create a new instance.

Method Summary

Modifier and Type	Method and Description
protected com.google.common.collect.ImmutableMap<UUID,Profile>	executeGet(Iterable<UUID> uuids)
protected void	executePut(Iterable<Profile> profiles)
com.google.common.collect.ImmutableMap<UUID,Profile>	getAllPresent(Iterable<UUID> uuids) Query the cache for the names of the given UUIDs.
protected Connection	getConnection() Get the connection.
Profile	getIfPresent(UUID uuid) Query the cache for the name for a given UUID.
void	put(Profile profile) Store the given name as the last known name for the given UUID.
void	putAll(Iterable<Profile> entries) Store a list of zero or more names.

Methods inherited from class java.lang.Object

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

Constructor Detail

SQLiteCache

public SQLiteCache(File file)
            throws IOException

Create a new instance.

Parameters:

file - the path to a SQLite file to use

Throws:

IOException

Method Detail

getConnection

protected Connection getConnection()
                            throws SQLException

Get the connection.

Returns:

a connection

Throws:

SQLException - thrown on error

putAll

public void putAll(Iterable<Profile> entries)

Description copied from interface: ProfileCache

Store a list of zero or more names.

If the operation fails, an error will be logged but no exception will be thrown.

Parameters:

entries - an iterable of profiles

getAllPresent

public com.google.common.collect.ImmutableMap<UUID,Profile> getAllPresent(Iterable<UUID> uuids)

Description copied from interface: ProfileCache

Query the cache for the names of the given UUIDs.

If the operation fails, an error will be logged but no exception will be thrown.

Parameters:

uuids - a list of UUIDs to query

Returns:

a map of results, which may not have a key for every given UUID

executePut

protected void executePut(Iterable<Profile> profiles)
                   throws SQLException

Throws:

SQLException

executeGet

protected com.google.common.collect.ImmutableMap<UUID,Profile> executeGet(Iterable<UUID> uuids)
                                                                   throws SQLException

Throws:

SQLException

put

public void put(Profile profile)

Description copied from interface: ProfileCache

Store the given name as the last known name for the given UUID.

If the operation fails, an error will be logged but no exception will be thrown.

Specified by:

put in interface ProfileCache

Parameters:

profile - a profile

getIfPresent

@Nullable
public Profile getIfPresent(UUID uuid)

Description copied from interface: ProfileCache

Query the cache for the name for a given UUID.

If the operation fails, an error will be logged but no exception will be thrown.

Specified by:

getIfPresent in interface ProfileCache

Parameters:

uuid - the UUID

Returns:

the name or null if it is not known