org.eclipse.ui.activities.IActivityManager Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of workbench Show documentation
This plug-in contains the bulk of the Workbench implementation, and depends on JFace, SWT, and Core Runtime. It cannot be used independently from org.eclipse.ui. Workbench client plug-ins should not depend directly on this plug-in.
The newest version!
/*******************************************************************************
 * Copyright (c) 2000, 2006 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/

package org.eclipse.ui.activities;

import java.util.Set;

/**
 * An instance of this interface allows clients to manage activities, as
 * defined by the extension point org.eclipse.ui.activities.
 * 
 * This interface is not intended to be extended or implemented by clients.
 * 
 * 
 * @since 3.0
 */
public interface IActivityManager {

    /**
     * Registers an instance of IActivityManagerListener to
     * listen for changes to properties of this instance.
     * 
     * @param activityManagerListener
     *            the instance to register. Must not be null.
     *            If an attempt is made to register an instance which is
     *            already registered with this instance, no operation is
     *            performed.
     */
    void addActivityManagerListener(
            IActivityManagerListener activityManagerListener);

    /**
     * Returns an instance of IActivity given an identifier.
     * 
     * @param activityId
     *            an identifier. Must not be null
     * @return an instance of IActivity.
     */
    IActivity getActivity(String activityId);

    /**
     * Returns an instance of ICategory given an identifier.
     * 
     * @param categoryId
     *            an identifier. Must not be null
     * @return an instance of ICategory.
     */
    ICategory getCategory(String categoryId);

    /**
     * Returns the set of identifiers to defined activities.
     * 
     * Notification is sent to all registered listeners if this property
     * changes.
     * 
     * 
     * @return the set of identifiers to defined activities. This set may be
     *         empty, but is guaranteed not to be null. If this
     *         set is not empty, it is guaranteed to only contain instances of
     *         String.
     */
    Set getDefinedActivityIds();

    /**
     * Returns the set of identifiers to defined categories.
     * 
     * Notification is sent to all registered listeners if this property
     * changes.
     * 
     * 
     * @return the set of identifiers to defined categories. This set may be
     *         empty, but is guaranteed not to be null. If this
     *         set is not empty, it is guaranteed to only contain instances of
     *         String.
     */
    Set getDefinedCategoryIds();

    /**
     * Returns the set of identifiers to enabled activities.
     * 
     * Notification is sent to all registered listeners if this property
     * changes.
     * 
     * 
     * @return the set of identifiers to enabled activities. This set may be
     *         empty, but is guaranteed not to be null. If this
     *         set is not empty, it is guaranteed to only contain instances of
     *         String.
     */
    Set getEnabledActivityIds();

    /**
     * Returns an instance of IIdentifier given an identifier.
     * 
     * @param identifierId
     *            an identifier. Must not be null
     * @return an instance of IIdentifier.
     */
    IIdentifier getIdentifier(String identifierId);

    /**
     * Removes an instance of IActivityManagerListener
     * listening for changes to properties of this instance.
     * 
     * @param activityManagerListener
     *            the instance to remove. Must not be null.
     *            If an attempt is made to remove an instance which is not
     *            already registered with this instance, no operation is
     *            performed.
     */
    void removeActivityManagerListener(
            IActivityManagerListener activityManagerListener);
}