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.core; 12 13 import org.eclipse.core.runtime.*; 14 15 /** 16 * Site Feature reference. 17 * A reference to a feature on a particular update site. 18 * <p> 19 * Clients may implement this interface. However, in most cases clients should 20 * directly instantiate or subclass the provided implementation of this 21 * interface. 22 * </p> 23 * <p> 24 * <b>Note:</b> This class/interface is part of an interim API that is still under development and expected to 25 * change significantly before reaching stability. It is being made available at this early stage to solicit feedback 26 * from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken 27 * (repeatedly) as the API evolves. 28 * </p> 29 * @see org.eclipse.update.core.SiteFeatureReference 30 * @since 2.1 31 */ 32 public interface ISiteFeatureReference extends IFeatureReference, IAdaptable { 33 34 /** 35 * Returns an array of categories the referenced feature belong to. 36 * 37 * @return an array of categories, or an empty array 38 * @since 2.1 39 */ 40 public ICategory[] getCategories(); 41 42 /** 43 * Adds a category to the referenced feature. 44 * 45 * @param category new category 46 * @since 2.1 47 */ 48 public void addCategory(ICategory category); 49 50 } 51