1 /******************************************************************************* 2 * Copyright (c) 2000, 2005 IBM Corporation and others. 3 * All rights reserved. This program and the accompanying materials 4 * are made available under the terms of the Eclipse Public License v1.0 5 * which accompanies this distribution, and is available at 6 * http://www.eclipse.org/legal/epl-v10.html 7 * 8 * Contributors: 9 * IBM Corporation - initial API and implementation 10 *******************************************************************************/ 11 package org.eclipse.jdt.debug.eval; 12 13 14 import org.eclipse.jdt.core.dom.Message; 15 16 /** 17 * A compiled expression can be compiled once and evaluated multiple times 18 * in a runtime context. 19 * <p> 20 * Clients are not intended to implement this interface. 21 * </p> 22 * @see org.eclipse.jdt.debug.eval.IAstEvaluationEngine 23 * @since 2.0 24 */ 25 26 27 public interface ICompiledExpression { 28 29 /** 30 * Returns the source snippet from which this compiled expression was created. 31 * 32 * @return the source snippet from which this compiled expression was created 33 */ 34 public String getSnippet(); 35 36 /** 37 * Returns whether this compiled expression has any compilation errors. 38 * 39 * @return whether this compiled expression has any compilation errors 40 */ 41 public boolean hasErrors(); 42 43 /** 44 * Returns any errors which occurred while creating this compiled expression. 45 * 46 * @return any errors which occurred while creating this compiled expression 47 * @deprecated use getErrorMessages() 48 */ 49 public Message[] getErrors(); 50 51 /** 52 * Returns an array of problem messages. Each message describes a problem that 53 * occurred while while creating this compiled expression. 54 * 55 * @return error messages, or an empty array if no errors occurred 56 * @since 2.1 57 */ 58 public String[] getErrorMessages(); 59 60 } 61 62