LearnProcessor.java

/*
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License as published by the Free Software
 * Foundation; either version 2 of the License, or (at your option) any later
 * version. You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software Foundation, Inc.,
 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 */

package org.aitools.programd.processor.aiml;

import java.net.URL;

import org.aitools.programd.Core;
import org.aitools.programd.parser.TemplateParser;
import org.aitools.programd.processor.ProcessorException;
import org.aitools.util.xml.JDOM;
import org.jdom.Element;

/**
 * Handles a <code><a href="http://aitools.org/aiml/TR/2001/WD-aiml/#section-learn">learn</a></code> element.
 * 
 * @author Jon Baer
 * @author Thomas Ringate, Pedro Colla
 * @author <a href="mailto:noel@aitools.org">Noel Bush</a>
 */
public class LearnProcessor extends AIMLProcessor {

  /** The label (as required by the registration scheme). */
  public static final String label = "learn";

  /**
   * Creates a new LearnProcessor using the given Core.
   * 
   * @param core the Core object to use
   */
  public LearnProcessor(Core core) {
    super(core);
  }

  /**
   * Attempts to load an AIML file whose location is described by the results of processing the content of the element.
   * 
   * @param element the <code>learn</code> element
   * @param parser the parser that is at work
   * @return the result of processing the element
   * @throws ProcessorException if there is an error in processing
   */
  @SuppressWarnings("unchecked")
  @Override
  public String process(Element element, TemplateParser parser) throws ProcessorException {
    URL path = JDOM.contextualize(parser.evaluate(element.getContent()), element);
    parser.getCore().load(path, parser.getBotID());
    return "";
  }
}