processcontroller.java

来自「这是一个以JAVA编写的程序,本人还没有试过,是一个简单的温度控制系统」· Java 代码 · 共 89 行

package net.sf.dz.controller;

import org.freehold.jukebox.conf.Configurable;

/**
 * A process controller abstraction.
 *
 * <p>
 *
 * The controller is expected to produce an output based on the value of the
 * process variable and measurement time. The exact details are left to the
 * implementation.
 *
 * @author Copyright &copy; <a href="mailto:[e-mail]"> Vadim Tkachenko</a> 2001
 * @version $Id: ProcessController.java,v 1.4 2004/06/28 20:35:46 vtt Exp $
 */
public interface ProcessController extends Configurable {

    /**
     * Set the setpoint.
     *
     * @param setpoint Setpoint to set.
     */
    void setSetpoint(double setpoint);

    /**
     * Get the setpoint.
     *
     * @return Current setpoint value.
     */
    double getSetpoint();

    /**
     * Get the current value of the error.
     *
     * @return Current error value.
     */
    double getError();

    /**
     * Compute the controller output given the current value of the process
     * variable at a given time.
     *
     * @param time When this measurement was taken.
     *
     * @param pv Process variable.
     *
     * @return A computed controller output (corrective action).
     */
    double compute(long time, double pv);

    /**
     * Get the extended process controller status.
     *
     * <p>
     *
     * Since all the classes implementing this interface will have different
     * way of handling the status, there has to be a way to get the
     * controller status as a single object.
     *
     * <p>
     *
     * It would be reasonable to expect that the particular object returned
     * by the controller will implement <code>toString()</code> in a way
     * that allows to comprehend the status without getting into details.
     *
     * <p>
     *
     * This method ideally shouldn't throw any exceptions.
     *
     * @return The object representing a full process controller status.
     */
    ProcessControllerStatus getStatus();

    /**
     * Add the listener.
     *
     * @param l The listener to add.
     */
    void addListener(ProcessControllerListener l);

    /**
     * Remove the listener.
     *
     * @param l The listener to remove.
     */
    void removeListener(ProcessControllerListener l);
}