001/*
002 * Trident - A Multithreaded Server Alternative
003 * Copyright 2014 The TridentSDK Team
004 *
005 * Licensed under the Apache License, Version 2.0 (the "License");
006 * you may not use this file except in compliance with the License.
007 * You may obtain a copy of the License at
008 *
009 *    http://www.apache.org/licenses/LICENSE-2.0
010 *
011 * Unless required by applicable law or agreed to in writing, software
012 * distributed under the License is distributed on an "AS IS" BASIS,
013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014 * See the License for the specific language governing permissions and
015 * limitations under the License.
016 */
017package net.tridentsdk.event;
018
019import net.tridentsdk.plugin.Plugin;
020
021/**
022 * Represents a tool which is used to notify event listeners
023 *
024 * @author The TridentSDK Team
025 * @since 0.4-alpha
026 */
027public interface EventNotifier {
028    /**
029     * Obtains the plugin that contains the event listener
030     *
031     * @return the plugin
032     */
033    Plugin plugin();
034
035    /**
036     * Obtains the instance of the listener which was registered
037     *
038     * @return the listener instance
039     */
040    Listener listener();
041
042    /**
043     * Obtains the class of the event type that this notifier will be calling listeners for
044     *
045     * @return the event type
046     */
047    Class<? extends Event> eventType();
048
049    /**
050     * Obtains the importance of the event listener
051     *
052     * @return the importance
053     */
054    Importance importance();
055
056    /**
057     * Notifies the listener
058     *
059     * @param event the event to notify the listener
060     */
061    void handle(Event event);
062}