Recognizer API

<span style="font-size:24px;">public class Recognizer implements Configurable, ResultProducer此为识别了设置了相应的状态，以防止在某些方法在其必要的条件之前被调用。使用了异常处理。靠继承RuntimeException来实现新的异常类。Sphinx4识别器。此是sphinx4的主要的入口。一个识别器的典型使用如下：public void recognizeDigits() {      URL digitsConfig = new URL("file:./digits.xml");      ConfigurationManager cm = new ConfigurationManager(digitsConfig);      Recognizer sphinxDigitsRecognizer          = (Recognizer) cm.lookup("digitsRecognizer"");      boolean done = false;      Result result;       sphinxDigitsRecognizer.allocate();      // echo spoken digits, quit when 'nine' is spoken       while (!done) {           result = sphinxDigitsRecognizer.recognize();           System.out.println("Result: " + result);           done = result.toString().equals("nine");      }      sphinxDigitsRecognizer.deallocate();  }本类的属性： @S4Component(type = Decoder.class)public final static String PROP_DECODER = "decoder";识别器所使用的解码器。 @S4ComponentList(type = Monitor.class)public final static String PROP_MONITORS = "monitors";此识别器所使用的监视器的集合。 public static enum State { DEALLOCATED, ALLOCATING, ALLOCATED, READY, RECOGNIZING, DEALLOCATING, ERROR }；定义了识别器的所有可能的状态。 private String name;识别器的名字。 private Decoder decoder;使用的解码器private State currentState = State.DEALLOCATED;当前状态为未分配资源的状态。 private final List<StateListener> stateListeners = Collections.synchronizedList(new ArrayList<StateListener>());为状态监听器列表 private List<Monitor> monitors;使用的监听器列表。本类的构造方法：public Recognizer()；为空的构造方法。 public Recognizer(Decoder decoder, List<Monitor> monitors)；给定解码器和监听器列表来创建对象。本类的方法：public void newProperties(PropertySheet ps)；对属性进行设置。  public String toString()；为此对象的字符串表示。为名字和当前状态。 public void removeStateListener(StateListener stateListener)；从监听器列表中移除给定的监听器。此方法可以再任何状态调用。 public void removeResultListener(ResultListener resultListener)；移除给定的结果监听器。此方法可以再任何状态被调用。此方法调用解码器的方法来实现的。public void addStateListener(StateListener stateListener)；为此识别器添加一个状态监听器，即添加到监听器列表中。 无论何时当识别器的状态改变时，此状态监听器被调用，此方法可以在任何状态被调用。 public void addResultListener(ResultListener resultListener)；为此识别器添加一个结果监听器。无论何时当一个新的结果被识别器产生时，此结果监听器被调用。此方法可以在任何时候被调用。是通过解码器来实现的。 public void resetMonitors() ；为此识别器重新设置监听器即Resets the monitors monitoring this recognizer public State getState()；获得此识别器的状态，此方法可以在任何时候被调用。返回的当前状态属性。 public void deallocate()；释放此识别器的资源，此方法仅仅在识别器处于已经分配的状态下才被调用。  public void allocate()；为此识别器分配必要的资源。注意此方法需要一些时间才能完成。此方法仅仅在识别器处于已经被释放资源的状态下才能被调用。如果识别器不在DEALLOCATED状态，则会抛出异常。 private void setState(State newState)；设置当前状态。把所有的状态监听器都该变成当前的状态。输入为：新的状态。private void checkState(State desiredState)；检查确保识别器处于给定的状态。输入：desiredState为识别器应该处于的状态。如果识别器不做给定的状态，则会抛出异常。 public Result recognize()；对给定输入数量的特征帧矢量进行识别处理，或者直到一个最终结果（final result）被产生。此方法仅在识别器处于allocated已经分配状态 才能被调用。返回的是一个识别的结果集result。如果识别器不处于allocated状态，则会抛出异常。 public Result recognize(String referenceText)；对给定输入数量的特征帧矢量进行识别处理，或者直到一个最终结果（final result）被产生。此方法仅在识别器处于allocated已经分配状态 才能被调用。返回的是一个识别的结果集result。如果识别器不处于allocated状态，则会抛出异常。在其中主要靠解码器的decode方法来完成识别。 </span>