001/*-------------------------------------------------------------------------+
002|                                                                          |
003| Copyright 2005-2011 The ConQAT Project                                   |
004|                                                                          |
005| Licensed under the Apache License, Version 2.0 (the "License");          |
006| you may not use this file except in compliance with the License.         |
007| You may obtain a copy of the License at                                  |
008|                                                                          |
009|    http://www.apache.org/licenses/LICENSE-2.0                            |
010|                                                                          |
011| Unless required by applicable law or agreed to in writing, software      |
012| distributed under the License is distributed on an "AS IS" BASIS,        |
013| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
014| See the License for the specific language governing permissions and      |
015| limitations under the License.                                           |
016+-------------------------------------------------------------------------*/
017package eu.cqse.check.framework.scanner;
018
019import org.conqat.lib.commons.collections.ILookahead;
020
021/**
022 * Statement oracles detect statement boundaries. Statement oracles can be
023 * obtained via {@link LanguageProperties#getStatementOracle()}.
024 */
025public interface IStatementOracle {
026
027        /**
028         * Determines if the current token type ends a statement.
029         * 
030         * @param tokenType
031         *            the current token type
032         */
033        public <X extends Exception> boolean isEndOfStatementTokenType(ETokenType tokenType,
034                        ILookahead<ETokenType, X> lookahead) throws X;
035
036        /**
037         * Determines if the current token type ends a statement.
038         * 
039         * @param tokenType
040         *            the current token type
041         */
042        public <X extends Exception> boolean isEndOfStatementToken(ETokenType tokenType, ILookahead<IToken, X> lookahead)
043                        throws X;
044
045}