org.virtualrepository.impl

Class Services

java.lang.Object

org.virtualrepository.impl.Services

All Implemented Interfaces:

Iterable<RepositoryService>

public class Services
extends Object
implements Iterable<RepositoryService>

A collection of RepositoryServices.

Services can be explicitly added to the collection (cf. add(RepositoryService...), or else discovered on the classpath through the standard ServiceLoader mechanism (cf. load()).

Services must be uniquely named and are overwritten by others with the same name which are subsequently added or loaded.

This class is not thread-safe. If any, synchronisation requirements fall on clients.

Author:

Fabio Simeoni

See Also:

RepositoryService, ServiceLoader

Field Summary

Fields

Modifier and Type	Field and Description
static org.slf4j.Logger	log

Constructor Summary

Constructors

Constructor and Description
Services() Creates an instance with no RepositoryServices.
Services(RepositoryService... services) Creates an instance with given RepositoryServices.

Method Summary

Modifier and Type	Method and Description
int	add(RepositoryService... services) Adds one or more RepositoryServices to this collection, overwriting those that have the same names.
boolean	contains(QName name) Returns true if this collection includes a given RepositoryService.
Iterator<RepositoryService>	iterator() Returns the RepositoryServices in this collection.
void	load() Adds to this collection all the RepositoryServices found in the classpath by a ServiceLoader.
RepositoryService	lookup(QName name) Returns a RepositoryService in this collection.
int	size() Returns the number of RepositoryServices in this collection.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

log

public static org.slf4j.Logger log

Constructor Detail

Services

public Services()

Creates an instance with no RepositoryServices.

Services

public Services(RepositoryService... services)

Creates an instance with given RepositoryServices.

Parameters:

services - the services

Method Detail

add

public int add(RepositoryService... services)

Adds one or more RepositoryServices to this collection, overwriting those that have the same names.

Parameters:

services - the services

Returns:

the number of services effectively added

load

public void load()

Adds to this collection all the RepositoryServices found in the classpath by a ServiceLoader.

contains

public boolean contains(QName name)

Returns true if this collection includes a given RepositoryService.

Parameters:

name - the name of the service

Returns:

true if this collection includes the RepositoryService with the given name

lookup

public RepositoryService lookup(QName name)

Returns a RepositoryService in this collection.

Parameters:

name - the name of the service

Returns:

the service with the given name

Throws:

IllegalStateException - if a service with the given name does not exist

size

public int size()

Returns the number of RepositoryServices in this collection.

Returns:

the number of available services

iterator

public Iterator<RepositoryService> iterator()

Returns the RepositoryServices in this collection.

Specified by:

iterator in interface Iterable<RepositoryService>

Returns:

the services