/*
 * Java
 *
 * Copyright 2015-2024 MicroEJ Corp. All rights reserved.
 * This library is provided in source code for use, modification and test, subject to license terms.
 * Any modification of the source code will break MicroEJ Corp. warranties on the whole library.
 * This document has been released and published by E-S-R consortium, a non-profit entity.
 * To learn more about E-S-R consortium, please visit http://www.e-s-r.net/.
 * The matter contained in this document is not subject to copyright; you are free to use it for any purpose, for more information see E-S-R consortium policies.
 */
package ej.microui.event;

import java.security.Permission;
import ej.annotation.Nullable;

/**
 * This class is for event generator permissions.
 * <p>
 * The name is related to the event generator APIs and it symbolizes the permission's action.
 * <p>
 * The meaning of the possible permissions is defined as follows:
 * <dl>
 * <dt>set
 * <dd>set handler permission. Allows <code>EventGenerator.setEventHandler(EventHandler)</code> to be called.
 * </dl>
 */
public class EventPermission extends Permission {

    /**
     * @param gen
     *            the event generator.
     * @deprecated use {@link #EventPermission(EventGenerator, String)}.
     */
    @Deprecated
    public EventPermission(@Nullable EventGenerator gen) {
        super(null);
    }

    /**
     * Creates a permission for events generated by the given event generator with the specified name.
     *
     * @param gen
     *            the event generator.
     * @param permission
     *            the name of the <code>EventPermission</code>.
     */
    public EventPermission(@Nullable EventGenerator gen, String permission) {
        super(null);
    }

    /**
     * Gets the event generator handled by this permission.
     *
     * @return the event generator.
     */
    @Nullable
    public EventGenerator getEventGenerator() {
        throw new RuntimeException();
    }

    @Override
    public boolean equals(@Nullable Object obj) {
        throw new RuntimeException();
    }

    @Override
    public String getActions() {
        throw new RuntimeException();
    }

    @Override
    public int hashCode() {
        throw new RuntimeException();
    }

    @Override
    public boolean implies(Permission permission) {
        throw new RuntimeException();
    }
}