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>