documentmanipulationaction.java

Java 3D Desktop Environment旨在使用Java 3D来创建一个3D桌面环境。功能包括：分布式的应用程序

/*
 * Copyright (c) 2000, Niklas Mehner 
 * All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without 
 * modification, are permitted provided that the following conditions 
 * are met:
 * 
 *   - Redistributions of source code must retain the above copyright 
 *     notice, this list of conditions and the following disclaimer.
 * 
 *   - Redistributions in binary form must reproduce the above copyright 
 *     notice, this list of conditions and the following disclaimer in 
 *     the documentation and/or other materials provided with the 
 *     distribution.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR 
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
 */ 
package org.j3de.action;

import java.util.EventListener;

/** 
  *
DocumentManipulationAction is a asbtract class that is used to perform
  * actions on documents. These actions are used to abstract from the concrete
  * source of the events. For example the keyboard-device or some kind of
  * speech input could be sources of DocumentManipulationActions without
  * requiring the receiving DocumentManipulator to know, where the Action originated from.
  *
  * @author Niklas Mehner
  * @version $Revision: 1.2 $, $Date: 2000/09/06 22:39:48 $
  * @since  j3de 1.0
  */
public abstract class DocumentManipulationAction implements Action {   
  
  /** 
   * Creates a new DocumentManipulationAction.
   */ 
  public DocumentManipulationAction() {
  }
   
  /** 
   * Performs an action on the DocumentMaipulator. This method has to be implemented
   * by subclasses.
   * @param manipulator the DocumentManipulator the action should be performed on.
   */
  public abstract void performAction(DocumentManipulator manipulator);                 
  
  /**
   * Dispatches this action to the given listener. The listener has to be a
   * DocumentManipulator.
   * @param listener the listener this action is to be to dispatched to.  
   */
  public void dispatch(EventListener listener) {
    performAction((DocumentManipulator)listener);
  }
  
  /** 
   * This method returns DocumentManipulator.class. This is the interface this
   * action can dispatch itself to.
   * @return the interface this action can dispatch itself to.
   */
  public Class getListenerInterface() {
    return DocumentManipulator.class;
  }
}