Package org.apache.wiki.event

Class WikiEvent

java.lang.Object
java.util.EventObject
org.apache.wiki.event.WikiEvent
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
WikiEngineEvent, WikiPageEvent, WikiSecurityEvent, WorkflowEvent
public abstract class WikiEvent
extends EventObject
Abstract parent class for wiki events.
Since:
2.3.79
See Also:
Serialized Form

  • Field Summary

    Fields
    Modifier and Type Field Description
    static int ERROR
    Indicates a exception or error state.
    static int UNDEFINED
    Indicates an undefined state.

    Fields inherited from class java.util.EventObject

    source

  • Constructor Summary

    Constructors
    Constructor Description
    WikiEvent​(Object src, int type)
    Constructs an instance of this event.

  • Method Summary

    Modifier and Type Method Description
    String eventName()
    Returns a textual representation of an event type.
    <T> T getSrc()
    Convenience method that returns the typed object to which the event applied.
    int getType()
    Returns the type of this event.
    String getTypeDescription()
    Returns a String (human-readable) description of an event type.
    long getWhen()
    Returns the timestamp of when this WikiEvent occurred.
    static boolean isValidType​(int type)
    Returns true if the int value is a valid WikiEvent type.
    protected void setType​(int type)
    Sets the type of this event.
    String toString()
    Prints a String (human-readable) representation of this object.

    Methods inherited from class java.util.EventObject

    getSource

    Methods inherited from class java.lang.Object

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

  • Field Details

  • Constructor Details

    • WikiEvent

      public WikiEvent​(Object src, int type)
      Constructs an instance of this event.
      Parameters:
      src - the Object that is the source of the event.
      type - the event type.

  • Method Details

    • getSrc

      public <T> T getSrc()
      Convenience method that returns the typed object to which the event applied.
      Returns:
      the typed object to which the event applied.

    • getWhen

      public long getWhen()
      Returns the timestamp of when this WikiEvent occurred.
      Returns:
      this event's timestamp
      Since:
      2.4.74

    • setType

      protected void setType​(int type)
      Sets the type of this event. Validation of acceptable type values is the responsibility of each subclass.
      Parameters:
      type - the type of this WikiEvent.

    • getType

      public int getType()
      Returns the type of this event.
      Returns:
      the type of this WikiEvent. See the enumerated values defined in WikiEvent).

    • getTypeDescription

      public String getTypeDescription()
      Returns a String (human-readable) description of an event type. This should be subclassed as necessary.
      Returns:
      the String description

    • isValidType

      public static boolean isValidType​(int type)
      Returns true if the int value is a valid WikiEvent type. Because the WikiEvent class does not itself any event types, this method returns true if the event type is anything except ERROR or UNDEFINED. This method is meant to be subclassed as appropriate.
      Parameters:
      type - The value to test.
      Returns:
      true, if the value is a valid WikiEvent type.

    • eventName

      public String eventName()
      Returns a textual representation of an event type.
      Returns:
      the String representation

    • toString

      public String toString()
      Prints a String (human-readable) representation of this object. This should be subclassed as necessary.
      Overrides:
      toString in class EventObject
      Returns:
      the String representation
      See Also:
      Object.toString()