xyz.cofe.cxconsole.srvc

Class AbstractService

java.lang.Object

xyz.cofe.cxconsole.srvc.AbstractService

All Implemented Interfaces:

ConsoleService, ServiceEventPublisher

Direct Known Subclasses:

ActionsService, GroovyClassLoaderService, GroovyEngineService, OpenFrameService, StartableService, UrlClassLoaderService

public abstract class AbstractService
extends Object
implements ConsoleService, ServiceEventPublisher

Абстрактный сервис.
Реализует функции:

• подписки на события сервсиса (ServiceEventPublisher)
• Разрешения зависимостей при использовании аннотации Dependency

Author:

Kamnev Georgiy (nt.gocha@gmail.com)

Field Summary

Fields

Modifier and Type	Field and Description
protected ConcurrentLinkedQueue<ServiceEvent>	serviceEventQueue

Constructor Summary

Constructors

Constructor and Description
AbstractService()

Method Summary

Modifier and Type	Method and Description
void	addServiceEvent(ServiceEvent event) Добавляет событие в очередь
Closeable	addServiceListener(ServiceListener listener) Добавляет подписчика на события службы
Closeable	addServiceListener(ServiceListener listener, boolean weakLink) Добавляет подписчика на события службы
static <T> T	findFirstService(Iterable services, Class<T> serviceClass, boolean stongCompare) Поиск службы указанного типа
<T> Set<T>	findServices(Class<T> serviceClass) Поиск службы указанного типа.
protected <T> Set<T>	findServices(Dependency dep, Class<T> serviceClass) Поиск службы указанного типа
static <T> Set<T>	findServices(Iterable services, Class<T> serviceClass, boolean stongCompare) Поиск службы указанного типа
void	fireServiceEvent(ServiceEvent event)
void	fireServiceEvents() Обработка очереди сообщений
Console	getConsole() Возвращает ссылку на класс консоли
List<FieldDependencyController>	getFieldDependencies() Возвращает список зависимостей
protected int	getInitDependenciesCallCount() Возвращает кол-во сделаных вызовов initDependencies()
Set<ServiceListener>	getServiceListeners() Возвращает список подписчиков
protected Set<Field>	getUnresolvedDependencies() Список неразрешенных зависимостей
boolean	hasServiceListener(ServiceListener listener) Проверяет наличие подписчика
void	init(Console console) Инициализация сервиса
protected void	initDependencies() Поиск и разрешение зависимостей
static Set<AbstractService>	instances() Возвращает созданные и существующие экземпляры класса AbstractService
protected boolean	isResolvedDependencies() Проверка что все указанные зависимости разрешены
protected ListenersHelper<ServiceListener,ServiceEvent>	listeners()
protected void	onInitServicesEnd(Console console) Все сервисы добавлены, вызывается для по
protected void	onResolvedDependencies(Dependency d, Field f, Object v) Зависимост разрешена
void	removeServiceListener(ServiceListener listener) Удаление подписчика
protected Object	resolveDependecy(Dependency d, Field f, Set variants) Разрешение зависимости

Methods inherited from class java.lang.Object

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

Field Detail

serviceEventQueue

protected final ConcurrentLinkedQueue<ServiceEvent> serviceEventQueue

Constructor Detail

AbstractService

public AbstractService()

Method Detail

listeners

protected ListenersHelper<ServiceListener,ServiceEvent> listeners()

getServiceListeners

public Set<ServiceListener> getServiceListeners()

Description copied from interface: ServiceEventPublisher

Возвращает список подписчиков

Specified by:

getServiceListeners in interface ServiceEventPublisher

Returns:

подписичики

hasServiceListener

public boolean hasServiceListener(ServiceListener listener)

Description copied from interface: ServiceEventPublisher

Проверяет наличие подписчика

Specified by:

hasServiceListener in interface ServiceEventPublisher

Parameters:

listener - подписчик

Returns:

true - подписчик имеется

addServiceListener

public Closeable addServiceListener(ServiceListener listener)

Description copied from interface: ServiceEventPublisher

Добавляет подписчика на события службы

Specified by:

addServiceListener in interface ServiceEventPublisher

Parameters:

listener - Подписчик

Returns:

Отписка от события

addServiceListener

public Closeable addServiceListener(ServiceListener listener,
                                    boolean weakLink)

Description copied from interface: ServiceEventPublisher

Добавляет подписчика на события службы

Specified by:

addServiceListener in interface ServiceEventPublisher

Parameters:

listener - Подписчик

weakLink - Добавить подписчика как weak ссылку

Returns:

Отписка от события

removeServiceListener

public void removeServiceListener(ServiceListener listener)

Description copied from interface: ServiceEventPublisher

Удаление подписчика

Specified by:

removeServiceListener in interface ServiceEventPublisher

Parameters:

listener - Подписчик

fireServiceEvent

public void fireServiceEvent(ServiceEvent event)

addServiceEvent

public void addServiceEvent(ServiceEvent event)

Description copied from interface: ServiceEventPublisher

Добавляет событие в очередь

Specified by:

addServiceEvent in interface ServiceEventPublisher

Parameters:

event - событие

fireServiceEvents

public void fireServiceEvents()

Description copied from interface: ServiceEventPublisher

Обработка очереди сообщений

Specified by:

fireServiceEvents in interface ServiceEventPublisher

instances

public static Set<AbstractService> instances()

Возвращает созданные и существующие экземпляры класса AbstractService

Returns:

Экземпляры класса

getConsole

public Console getConsole()

Возвращает ссылку на класс консоли

Returns:

косоль или null

init

public void init(Console console)

Description copied from interface: ConsoleService

Инициализация сервиса

Specified by:

init in interface ConsoleService

Parameters:

console - ссылка на консоль

onInitServicesEnd

protected void onInitServicesEnd(Console console)

Все сервисы добавлены, вызывается для по

Parameters:

console - консоль

getUnresolvedDependencies

protected Set<Field> getUnresolvedDependencies()

Список неразрешенных зависимостей

Returns:

зависимости

getInitDependenciesCallCount

protected int getInitDependenciesCallCount()

Возвращает кол-во сделаных вызовов initDependencies()

Returns:

кол-во вызов initDependencies(). 0 - вызовов небыло

getFieldDependencies

public List<FieldDependencyController> getFieldDependencies()

Возвращает список зависимостей

Returns:

список зависимостей

initDependencies

protected void initDependencies()

Поиск и разрешение зависимостей

onResolvedDependencies

protected void onResolvedDependencies(Dependency d,
                                      Field f,
                                      Object v)

Зависимост разрешена

Parameters:

d - Зависимость

f - поле

v - значение

resolveDependecy

protected Object resolveDependecy(Dependency d,
                                  Field f,
                                  Set variants)

Разрешение зависимости

Parameters:

d - описание зависимости

f - поле для которой производится разрешение зависимости

variants - список вариантов (возможно null)

Returns:

целевое значение или null

isResolvedDependencies

protected boolean isResolvedDependencies()

Проверка что все указанные зависимости разрешены

Returns:

true - все зависимости разрешены

findServices

protected <T> Set<T> findServices(Dependency dep,
                                  Class<T> serviceClass)

Поиск службы указанного типа

Type Parameters:

T - Тип службы

Parameters:

dep - Аннотация зависмости

serviceClass - Тип службы

Returns:

службы указанного типа

findServices

public <T> Set<T> findServices(Class<T> serviceClass)

Поиск службы указанного типа.
В результат будут включены объекты совместимые по типу (result instanceof serviceClass)

Type Parameters:

T - Тип службы

Parameters:

serviceClass - Тип службы

Returns:

службы указанного типа

findServices

public static <T> Set<T> findServices(Iterable services,
                                      Class<T> serviceClass,
                                      boolean stongCompare)

Поиск службы указанного типа

Type Parameters:

T - Тип службы

Parameters:

services - Список/перень служб среди которых производится поиск

serviceClass - Тип службы

stongCompare - true - Строга проверка на тип службы (result.class == serviceClass)
false - Совместимый тип службы (result instanceof serviceClass)

Returns:

службы указанного типа

findFirstService

public static <T> T findFirstService(Iterable services,
                                     Class<T> serviceClass,
                                     boolean stongCompare)

Поиск службы указанного типа

Type Parameters:

T - Тип службы

Parameters:

services - Список/перень служб среди которых производится поиск

serviceClass - Тип службы

stongCompare - true - Строга проверка на тип службы (result.class == serviceClass)
false - Совместимый тип службы (result instanceof serviceClass)

Returns:

службы указанного типа