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.update.configuration; 12 13 /** 14 * Generic problem handler. Used to report status from specific 15 * install operations. The methods implemented by this interface 16 * are callbacks from the update support to the caller of the update 17 * methods. 18 * <p> 19 * <b>Note:</b> This class/interface is part of an interim API that is still under development and expected to 20 * change significantly before reaching stability. It is being made available at this early stage to solicit feedback 21 * from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken 22 * (repeatedly) as the API evolves. 23 * </p> 24 * @since 2.0 25 */ 26 public interface IProblemHandler { 27 28 /** 29 * Report problem. 30 * 31 * @param problemText problem text 32 * @return <code>true</code> if the operation should continue, 33 * <code>false</code> if the operation should be cancelled 34 * @since 2.0 35 * <p> 36 * <b>Note:</b> This method is part of an interim API that is still under development and expected to 37 * change significantly before reaching stability. It is being made available at this early stage to solicit feedback 38 * from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken 39 * (repeatedly) as the API evolves. 40 * </p> 41 */ 42 boolean reportProblem(String problemText); 43 44 } 45