org.noos.xing.mydoggy.event.ContentManagerEvent Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of mydoggy-api Show documentation

MyDoggy-Api contains the application program interface of MyDoggy to manage every aspects of the framework.

The newest version!

package org.noos.xing.mydoggy.event;

import org.noos.xing.mydoggy.Content;
import org.noos.xing.mydoggy.ContentManager;

import java.util.EventObject;

/**
 * An event which indicates that an action occurred in the content manager.
 *
 * @author Angelo De Caro ([email protected])
 * @since 1.0.0
 */
public class ContentManagerEvent extends EventObject {
    private static final long serialVersionUID = -4432400424463237878L;

    /**
     * Action Identifier Enum.
     */
    public enum ActionId {
        CONTENT_ADDED,          // When a content is added.
        CONTENT_REMOVED,        // When a content is removed.
        CONTENT_SELECTED,       // When a content become selected.
        CONTENT_DESELECTED      // When a content become deselected.
    }

    /**
     * Indicates the action identifier.
     *
     * @see ContentManagerEvent.ActionId
     */
    private final ActionId actionId;

    /**
     * Indicates the content on which the action has occurred.
     */
    private final Content content;

    /**
     * Constructs a ContentManagerEvent object with the
     * specified source content manager, actionId, content.
     * Creating an invalid event (such as by using ActionId.ADD_CONTENT with a null content)
     * results in unspecified behavior.
     * 
     * This method throws an
     * IllegalArgumentException if source
     * is null.
     *
     * @param source     the content manager where the action has occurred.
     * @param actionId   the action identifier
     * @param content    the content subject of the action.
     * @see org.noos.xing.mydoggy.ContentManager
     * @see ContentManagerEvent.ActionId
     * @see org.noos.xing.mydoggy.Content
     */
    public ContentManagerEvent(ContentManager source, ContentManagerEvent.ActionId actionId, Content content) {
        super(source);
        this.actionId = actionId;
        this.content = content;
    }


    /**
     * Returns the action identifier.
     *
     * @return the action identifier.
     */
    public ActionId getId() {
        return actionId;
    }

    /**
     * Returns the content subject of the action.
     *
     * @return the content.
     */
    public Content getContent() {
        return content;
    }


    public String toString() {
        return "ContentManagerEvent{" +
               "actionId=" + actionId +
               ", content=" + content +
               '}';
    }
    
}