001/**
002 *
003 * Copyright (c) 2014, the Railo Company Ltd. All rights reserved.
004 *
005 * This library is free software; you can redistribute it and/or
006 * modify it under the terms of the GNU Lesser General Public
007 * License as published by the Free Software Foundation; either 
008 * version 2.1 of the License, or (at your option) any later version.
009 * 
010 * This library is distributed in the hope that it will be useful,
011 * but WITHOUT ANY WARRANTY; without even the implied warranty of
012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
013 * Lesser General Public License for more details.
014 * 
015 * You should have received a copy of the GNU Lesser General Public 
016 * License along with this library.  If not, see <http://www.gnu.org/licenses/>.
017 * 
018 **/
019package lucee.transformer.cfml.evaluator;
020
021import lucee.runtime.config.Config;
022import lucee.runtime.exp.TemplateException;
023import lucee.transformer.bytecode.statement.tag.Tag;
024import lucee.transformer.cfml.Data;
025import lucee.transformer.library.function.FunctionLib;
026import lucee.transformer.library.tag.TagLib;
027import lucee.transformer.library.tag.TagLibTag;
028
029/**
030 * Jede Klasse die als Evaluator verwendet werden soll, 
031 * muss das Interface Evaluator implementieren. 
032 * Das Interface Evaluator definiert also die gemeinsame 
033 * Schnittstelle fuer alle Evaluatoren. 
034 */
035public interface Evaluator {
036
037        /**
038         * Die Methode evaluate wird aufgerufen, wenn der Context eines Tags geprueft werden soll.
039         * @param config 
040         * @param cfxdTag Das konkrete Tag innerhalb der kompletten CFXD.
041         * @param libTag Die Definition des Tag aus der TLD.
042         * @param flibs Saemtliche Function Library Deskriptoren des aktuellen Tag Libray Deskriptors.
043         * @param cfml
044         * @return changed talib
045         * @throws TemplateException
046        */
047        public TagLib execute(Config config,Tag tag, TagLibTag libTag, FunctionLib[] flibs,Data data) throws TemplateException;
048        
049        /**
050         * Die Methode evaluate wird aufgerufen, wenn der Context eines Tags geprueft werden soll,
051         * nachdem die komplette Seite uebersetzt wurde.
052         * @param cfxdTag Das konkrete Tag innerhalb der kompletten CFXD.
053         * @param libTag Die Definition des Tag aus der TLD.
054         * @param flibs Saemtliche Function Library Deskriptoren des aktuellen Tag Libray Deskriptors.
055         * @throws EvaluatorException
056        */
057        public void evaluate(Tag tag, TagLibTag libTag, FunctionLib[] flibs) throws EvaluatorException;
058        
059        
060}