com.sk89q.squirrelid.resolver

Class ParallelProfileService

java.lang.Object

com.sk89q.squirrelid.resolver.ParallelProfileService

All Implemented Interfaces:

ProfileService

public class ParallelProfileService
extends Object
implements ProfileService

Resolves profiles with several parallel threads using another resolver.

Constructor Summary

Constructors

Constructor and Description
ParallelProfileService(ProfileService resolver, ExecutorService executorService) Create a new parallel resolver.
ParallelProfileService(ProfileService resolver, int nThreads) Create a new parallel resolver.

Method Summary

Modifier and Type	Method and Description
com.google.common.collect.ImmutableList<Profile>	findAllByName(Iterable<String> names) Query the profile server for UUIDs for the given names.
void	findAllByName(Iterable<String> names, com.google.common.base.Predicate<Profile> consumer) Query the profile server for UUIDs for the given names.
Profile	findByName(String name) Query the profile server for the UUID of a name.
protected int	getEffectiveProfilesPerJob() Get the number or profiles to execute per job.
int	getIdealRequestLimit() Get the optimal maximum number of profiles that can be found with one ProfileService.findAllByName(Iterable) call.
int	getProfilesPerJob() Get the upper bound number of profiles to find per thread.
void	setProfilesPerJob(int profilesPerJob) Set the upper bound number of profiles to find per thread.

Methods inherited from class java.lang.Object

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

Constructor Detail

ParallelProfileService

public ParallelProfileService(ProfileService resolver,
                              ExecutorService executorService)

Create a new parallel resolver.

Parameters:

resolver - the resolver to use

executorService - the executor service to schedule jobs in

ParallelProfileService

public ParallelProfileService(ProfileService resolver,
                              int nThreads)

Create a new parallel resolver.

Parameters:

resolver - the resolver to use

nThreads - the number of threads to resolve profiles in

Method Detail

getProfilesPerJob

public int getProfilesPerJob()

Get the upper bound number of profiles to find per thread.

Returns:

a number of profiles

setProfilesPerJob

public void setProfilesPerJob(int profilesPerJob)

Set the upper bound number of profiles to find per thread.

Parameters:

profilesPerJob - a number of profiles

getIdealRequestLimit

public int getIdealRequestLimit()

Description copied from interface: ProfileService

Get the optimal maximum number of profiles that can be found with one ProfileService.findAllByName(Iterable) call.

ProfileService.findAllByName(Iterable) (and similar) methods may split up requests into smaller ones to fit within one request. This method returns the ideal maximum number.

Specified by:

getIdealRequestLimit in interface ProfileService

Returns:

the number of profiles

getEffectiveProfilesPerJob

protected int getEffectiveProfilesPerJob()

Get the number or profiles to execute per job.

Returns:

the number of profiles per job

findByName

@Nullable
public Profile findByName(String name)
                             throws IOException,
                                    InterruptedException

Description copied from interface: ProfileService

Query the profile server for the UUID of a name.

Specified by:

findByName in interface ProfileService

Parameters:

name - a name

Returns:

the profile of the user, otherwise null

Throws:

IOException - thrown on I/O error

InterruptedException - thrown on interruption

findAllByName

public com.google.common.collect.ImmutableList<Profile> findAllByName(Iterable<String> names)
                                                               throws IOException,
                                                                      InterruptedException

Description copied from interface: ProfileService

Query the profile server for UUIDs for the given names.

Specified by:

findAllByName in interface ProfileService

Parameters:

names - an iterable containing names to search

Returns:

a list of found profiles

Throws:

IOException - thrown on I/O error

InterruptedException - thrown on interruption

findAllByName

public void findAllByName(Iterable<String> names,
                          com.google.common.base.Predicate<Profile> consumer)
                   throws IOException,
                          InterruptedException

Description copied from interface: ProfileService

Query the profile server for UUIDs for the given names.

Specified by:

findAllByName in interface ProfileService

Parameters:

names - an iterable containing names to search

consumer - a consumer function that will receive discovered profiles

Throws:

IOException - thrown on I/O error

InterruptedException - thrown on interruption