/*
* Copyright (C) 2004-2013 L2J Server
*
* This file is part of L2J Server.
*
* L2J Server is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* L2J Server is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
*/
package com.l2jserver.gameserver.model.events;
import java.util.Queue;
import java.util.concurrent.TimeUnit;
import java.util.logging.Level;
import java.util.logging.Logger;
import com.l2jserver.gameserver.ThreadPoolManager;
import com.l2jserver.gameserver.model.events.impl.IBaseEvent;
import com.l2jserver.gameserver.model.events.listeners.AbstractEventListener;
import com.l2jserver.gameserver.model.events.returns.AbstractEventReturn;
/**
* @author UnAfraid
*/
public class EventDispatcher extends ListenersContainer
{
private static final Logger _log = Logger.getLogger(EventDispatcher.class.getName());
protected EventDispatcher()
{
}
/**
* @param
* @param event
* @return
*/
public T notifyEvent(IBaseEvent event)
{
return notifyEvent(event, null, null);
}
/**
* @param
* @param event
* @param callbackClass
* @return
*/
public T notifyEvent(IBaseEvent event, Class callbackClass)
{
return notifyEvent(event, null, callbackClass);
}
/**
* @param
* @param event
* @param container
* @param callbackClass
* @return
*/
public T notifyEvent(IBaseEvent event, ListenersContainer container, Class callbackClass)
{
try
{
return notifyEventImpl(event, container, callbackClass);
}
catch (Exception e)
{
_log.log(Level.WARNING, getClass().getSimpleName() + ": Couldn't notify event " + event.getClass().getSimpleName(), e);
}
return null;
}
/**
* @param
* @param event
* @param containers
* @param callbackClass
* @return
*/
public T notifyEventToMultipleContainers(IBaseEvent event, ListenersContainer[] containers, Class callbackClass)
{
try
{
if (event == null)
{
throw new NullPointerException("Event cannot be null!");
}
T callback = null;
if (containers != null)
{
// Local listeners container first.
for (ListenersContainer container : containers)
{
if ((callback == null) || !callback.abort())
{
callback = notifyToListeners(container.getListeners(event.getType()), event, callbackClass, callback);
}
}
}
// Global listener container.
if ((callback == null) || !callback.abort())
{
callback = notifyToListeners(getListeners(event.getType()), event, callbackClass, callback);
}
return callback;
}
catch (Exception e)
{
_log.log(Level.WARNING, getClass().getSimpleName() + ": Couldn't notify event " + event.getClass().getSimpleName(), e);
}
return null;
}
/**
* @param
* @param event
* @param container
* @param callbackClass
* @return {@link AbstractEventReturn} object that may keep data from the first listener, or last that breaks notification.
*/
private T notifyEventImpl(IBaseEvent event, ListenersContainer container, Class callbackClass)
{
if (event == null)
{
throw new NullPointerException("Event cannot be null!");
}
T callback = null;
// Local listener container first.
if (container != null)
{
callback = notifyToListeners(container.getListeners(event.getType()), event, callbackClass, callback);
}
// Global listener container.
if ((callback == null) || !callback.abort())
{
callback = notifyToListeners(getListeners(event.getType()), event, callbackClass, callback);
}
return callback;
}
/**
* @param
* @param listeners
* @param event
* @param returnBackClass
* @param callback
* @return
*/
private T notifyToListeners(Queue listeners, IBaseEvent event, Class returnBackClass, T callback)
{
for (AbstractEventListener listener : listeners)
{
try
{
final T rb = listener.executeEvent(event, returnBackClass);
if (rb == null)
{
continue;
}
else if ((callback == null) || rb.override()) // Let's check if this listener wants to override previous return object or we simply don't have one
{
callback = rb;
}
else if (rb.abort()) // This listener wants to abort the notification to others.
{
break;
}
}
catch (Exception e)
{
_log.log(Level.WARNING, getClass().getSimpleName() + ": Exception during notification of event: " + event.getClass().getSimpleName() + " listener: " + listener.getClass().getSimpleName(), e);
}
}
return callback;
}
/**
* Executing global listener notification asynchronously
* @param event
*/
public void notifyEventAsync(final IBaseEvent event)
{
notifyEventAsync(event);
}
/**
* Executing current listener notification asynchronously
* @param event
* @param containers
*/
public void notifyEventAsync(final IBaseEvent event, ListenersContainer... containers)
{
if (event == null)
{
throw new NullPointerException("Event cannot be null!");
}
ThreadPoolManager.getInstance().executeEvent(() -> notifyEventToMultipleContainers(event, containers, null));
}
/**
* Scheduling current listener notification asynchronously after specified delay.
* @param event
* @param container
* @param delay
*/
public void notifyEventAsyncDelayed(final IBaseEvent event, ListenersContainer container, long delay)
{
ThreadPoolManager.getInstance().scheduleEvent(() -> notifyEvent(event, container, null), delay);
}
/**
* Scheduling current listener notification asynchronously after specified delay.
* @param event
* @param container
* @param delay
* @param unit
*/
public void notifyEventAsyncDelayed(final IBaseEvent event, ListenersContainer container, long delay, TimeUnit unit)
{
ThreadPoolManager.getInstance().scheduleEvent(() -> notifyEvent(event, container, null), delay, unit);
}
public static final EventDispatcher getInstance()
{
return SingletonHolder._instance;
}
private static class SingletonHolder
{
protected static final EventDispatcher _instance = new EventDispatcher();
}
}