<extension

              point="org.eclipse.mylyn.tasks.ui.taskRepositoryPageContributor">

           <taskRepositoryPageContributor

                 class="org.eclipse.mylyn.internal.sandbox.ui.wizards.TaskEditorExtensionSettingsContributor"

                 connectorKind="*">

           </taskRepositoryPageContributor>

        </extension>

/*******************************************************************************

 * Copyright (c) 2004, 2008 Mylyn project committers 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

 *******************************************************************************/

package org.eclipse.mylyn.internal.sandbox.ui.wizards;

import org.eclipse.mylyn.internal.sandbox.ui.editors.TaskEditorExtensions;

import org.eclipse.mylyn.tasks.core.TaskRepository;

import org.eclipse.mylyn.tasks.ui.wizards.ITaskRepositoryPageContribution;

import org.eclipse.mylyn.tasks.ui.wizards.ITaskRepositoryPageContributor;

/**

 * A contributor that adds {@link TaskEditorExtensionSettingsContribution} to all repositories

 * 

 * @see TaskEditorExtensionSettingsContribution

 * 

 * @author David Green

 */

public class TaskEditorExtensionSettingsContributor implements ITaskRepositoryPageContributor {

	public TaskEditorExtensionSettingsContributor() {

	}

	public ITaskRepositoryPageContribution createContribution(String connectorKind, TaskRepository repository) {

		// don't return a contribution if there are no extensions

		if (TaskEditorExtensions.getTaskEditorExtensions().isEmpty()) {

			return null;

		}

		return new TaskEditorExtensionSettingsContribution(connectorKind, repository);

	}

}

/*******************************************************************************

 * Copyright (c) 2004, 2007 Mylyn project committers 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

 *******************************************************************************/

package org.eclipse.mylyn.internal.sandbox.ui.wizards;

import java.util.SortedSet;

import org.eclipse.core.runtime.IProgressMonitor;

import org.eclipse.core.runtime.IStatus;

import org.eclipse.jface.resource.FontRegistry;

import org.eclipse.jface.resource.JFaceResources;

import org.eclipse.mylyn.internal.sandbox.ui.editors.TaskEditorExtensions;

import org.eclipse.mylyn.internal.sandbox.ui.editors.TaskEditorExtensions.RegisteredTaskEditorExtension;

import org.eclipse.mylyn.tasks.core.TaskRepository;

import org.eclipse.mylyn.tasks.ui.wizards.AbstractTaskRepositoryPageContribution;

import org.eclipse.swt.SWT;

import org.eclipse.swt.events.SelectionAdapter;

import org.eclipse.swt.events.SelectionEvent;

import org.eclipse.swt.events.SelectionListener;

import org.eclipse.swt.graphics.Font;

import org.eclipse.swt.graphics.FontData;

import org.eclipse.swt.layout.GridLayout;

import org.eclipse.swt.widgets.Button;

import org.eclipse.swt.widgets.Composite;

import org.eclipse.swt.widgets.Widget;

import org.eclipse.ui.forms.widgets.FormToolkit;

/**

 * A contribution that adds a section for 'Task Editor Extension'.

 * 

 * @author David Green

 */

public class TaskEditorExtensionSettingsContribution extends AbstractTaskRepositoryPageContribution {

	private static final String LABEL_NONE = "None";

	private static final String LABEL_DEFAULT_SUFFIX = " (default)";

	private static final String DATA_EDITOR_EXTENSION = "editorExtension";

	private final SelectionListener listener = new SelectionAdapter() {

		@Override

		public void widgetSelected(SelectionEvent e) {

			selectedExtensionId = (String) ((Widget) e.getSource()).getData(DATA_EDITOR_EXTENSION);

			fireValidationRequired();

		}

	};

	private String selectedExtensionId = null;

	public TaskEditorExtensionSettingsContribution(String connectorKind, TaskRepository repository) {

		super("Task Editor Extension", "Select an extension to the task editor", connectorKind, repository);

	}

	public void applyTo(TaskRepository repository) {

		TaskEditorExtensions.setTaskEditorExtensionId(repository, selectedExtensionId == null ? "none"

				: selectedExtensionId);

	}

	public boolean canFlipToNextPage() {

		return true;

	}

	public boolean isPageComplete() {

		return true;

	}

	public void createControl(Composite parent, FormToolkit toolkit) {

		parent.setLayout(new GridLayout(1, true));

		String defaultExtensionId = TaskEditorExtensions.getDefaultTaskEditorExtensionId(connectorKind);

		selectedExtensionId = repository == null ? defaultExtensionId

				: TaskEditorExtensions.getTaskEditorExtensionId(repository);

		Button noneButton;

		{ // configure a 'none' button

			String noneTitle = LABEL_NONE;

			boolean isDefault = defaultExtensionId == null || defaultExtensionId.length() == 0;

			if (isDefault) {

				noneTitle += LABEL_DEFAULT_SUFFIX;

			}

			noneButton = toolkit.createButton(parent, noneTitle, SWT.RADIO);

			if (isDefault) {

				adjustForDefault(noneButton);

			}

			noneButton.addSelectionListener(listener);

		}

		boolean foundSelection = false;

		// now add selection buttons for all registered extensions

		SortedSet<RegisteredTaskEditorExtension> allEditorExtensions = TaskEditorExtensions.getTaskEditorExtensions();

		for (RegisteredTaskEditorExtension editorExtension : allEditorExtensions) {

			String name = editorExtension.getName();

			boolean isDefault = editorExtension.getId().equals(defaultExtensionId);

			if (isDefault) {

				name += LABEL_DEFAULT_SUFFIX;

			}

			Button button = toolkit.createButton(parent, name, SWT.RADIO);

			if (isDefault) {

				adjustForDefault(button);

			}

			if (editorExtension.getId().equals(selectedExtensionId)) {

				foundSelection = true;

				button.setSelection(true);

			}

			button.setText(name);

			button.setData(DATA_EDITOR_EXTENSION, editorExtension.getId());

			button.addSelectionListener(listener);

		}

		if (!foundSelection) {

			noneButton.setSelection(true);

		}

	}

	private void adjustForDefault(Button button) {

		Font font = button.getFont();

		button.setFont(getBold(font));

	}

	private Font getBold(Font font) {

		FontData[] originalFontData = font.getFontData();

		FontData fontData = originalFontData[0];

		if ((fontData.getStyle() & SWT.BOLD) != 0) {

			return font;

		}

		FontRegistry fontRegistry = JFaceResources.getFontRegistry();

		String key = fontData.getName() + '-' + fontData.getHeight() + "-" + fontData.getLocale() + "-"

				+ fontData.getStyle() + "-bold";

		if (!fontRegistry.hasValueFor(key)) {

			FontData[] boldFontDatas = new FontData[originalFontData.length];

			int index = -1;

			for (FontData fd : originalFontData) {

				boldFontDatas[++index] = new FontData(fd.getName(), fd.getHeight(), fd.getStyle() | SWT.BOLD);

			}

			fontRegistry.put(key, boldFontDatas);

		}

		return fontRegistry.get(key);

	}

	public IStatus[] validate(IProgressMonitor monitor) {

		return null;

	}

}

import org.eclipse.mylyn.internal.tasks.core.LocalRepositoryConnector;

    <extension-point id="taskRepositoryPageContributor" name="Task Repository Page Contributor" schema="schema/taskRepositoryPageContributor.exsd"/>

import org.eclipse.mylyn.internal.tasks.ui.wizards.LocalRepositorySettingsPage;

 * @author David Green

	@Override

	@Override

	protected void createSettingControls(Composite parent) {

		addContributionSection();

	private void addContributionSection() {

		Composite composite = toolkit.createComposite(compositeContainer);

		GridDataFactory.fillDefaults().grab(true, false).span(2, SWT.DEFAULT).applyTo(composite);

		GridLayout layout = new GridLayout(1, false);

		layout.marginWidth = 0;

		layout.marginTop = -5;

		composite.setLayout(layout);

		composite.setBackground(compositeContainer.getBackground());

		addContributions(composite);

	}

	@Override

		super.applyTo(repository);

	/**

	 * validate settings provided by the {@link #getValidator(TaskRepository) validator}, typically the server settings.

	 */

	/**

	 * @since 3.1

	 */

	@Override

	protected IStatus[] validate(IProgressMonitor monitor) {

		return null;

	}

/*******************************************************************************

 * Copyright (c) 2004, 2008 Mylyn project committers 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

 *******************************************************************************/

package org.eclipse.mylyn.tasks.ui.wizards;

import org.eclipse.mylyn.tasks.core.TaskRepository;

/**

 * Implementors are capable of contributing to the settings page for a task repository.

 * 

 * @since 3.1

 * 

 * @author David Green

 */

public interface ITaskRepositoryPageContributor {

	/**

	 * create a contribution to a task repository

	 * 

	 * @param connectorKind

	 *            the kind of connector for which a contribution should be created

	 * @param repository

	 *            the repository for which contributions are desired, which may be null if the wizard is creating a new

	 *            repository

	 * 

	 * @return the contribution, or null if the contributor should not contribute to the given repository

	 */

	ITaskRepositoryPageContribution createContribution(String connectorKind, TaskRepository repository);

}

/*******************************************************************************

 * Copyright (c) 2004, 2008 Mylyn project committers 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

 *******************************************************************************/

package org.eclipse.mylyn.tasks.ui.wizards;

import java.lang.reflect.InvocationTargetException;

import java.util.ArrayList;

import java.util.Arrays;

import java.util.Collections;

import java.util.Comparator;

import java.util.List;

import org.eclipse.core.runtime.IConfigurationElement;

import org.eclipse.core.runtime.IExtension;

import org.eclipse.core.runtime.IExtensionPoint;

import org.eclipse.core.runtime.IExtensionRegistry;

import org.eclipse.core.runtime.IProgressMonitor;

import org.eclipse.core.runtime.IStatus;

import org.eclipse.core.runtime.Platform;

import org.eclipse.core.runtime.Status;

import org.eclipse.core.runtime.SubProgressMonitor;

import org.eclipse.jface.dialogs.IMessageProvider;

import org.eclipse.jface.layout.GridDataFactory;

import org.eclipse.jface.operation.IRunnableWithProgress;

import org.eclipse.jface.wizard.WizardPage;

import org.eclipse.mylyn.commons.core.StatusHandler;

import org.eclipse.mylyn.internal.tasks.ui.TasksUiPlugin;

import org.eclipse.mylyn.tasks.core.TaskRepository;

import org.eclipse.swt.SWT;

import org.eclipse.swt.layout.GridLayout;

import org.eclipse.swt.widgets.Composite;

import org.eclipse.ui.forms.events.ExpansionAdapter;

import org.eclipse.ui.forms.events.ExpansionEvent;

import org.eclipse.ui.forms.widgets.ExpandableComposite;

import org.eclipse.ui.forms.widgets.FormToolkit;

/**

 * An abstract base class for repository settings page that supports the <code>taskRepositoryPageContributor</code>

 * extension point.

 * 

 * {@link ITaskRepositoryPage} implementations are encouraged to extend {@link AbstractRepositorySettingsPage} if

 * possible as it provides a standard UI for managing server settings.

 * 

 * @see AbstractRepositorySettingsPage

 * 

 * @since 3.1

 * 

 * @author David Green

 */

public abstract class AbstractExtensibleRepositorySettingsPage extends WizardPage implements ITaskRepositoryPage {

	private static final String KIND = "connectorKind";

	private static final String TASK_REPOSITORY_PAGE_CONTRIBUTOR = "taskRepositoryPageContributor";

	private static final String TASK_REPOSITORY_PAGE_CONTRIBUTOR_EXTENSION = "org.eclipse.mylyn.tasks.ui.taskRepositoryPageContributor";

	private static final Comparator<ITaskRepositoryPageContribution> CONTRIBUTION_COMPARATOR = new ContributionComparator();

	protected final TaskRepository repository;

	private final List<ITaskRepositoryPageContribution> contributions = new ArrayList<ITaskRepositoryPageContribution>();

	protected FormToolkit toolkit;

	protected Composite compositeContainer;

	private final ITaskRepositoryPageContribution.Listener contributionListener = new ITaskRepositoryPageContribution.Listener() {

		public void validationRequired(ITaskRepositoryPageContribution contribution) {

			validatePageSettings();

		}

	};

	public AbstractExtensibleRepositorySettingsPage(String title, String description, TaskRepository repository) {

		super(title);

		if (repository != null && !repository.getConnectorKind().equals(getConnectorKind())) {

			throw new IllegalArgumentException();

		}

		this.repository = repository;

		setTitle(title);

		setDescription(description);

	}

	/**

	 * Get the kind of connector supported by this page.

	 * 

	 * @return the kind of connector, never null

	 */

	public abstract String getConnectorKind();

	@Override

	public void dispose() {

		if (toolkit != null) {

			toolkit.dispose();

			toolkit = null;

		}

		super.dispose();

	}

	public void createControl(Composite parent) {

		toolkit = new FormToolkit(TasksUiPlugin.getDefault().getFormColors(parent.getDisplay()));

		compositeContainer = new Composite(parent, SWT.NULL);

		GridLayout layout = new GridLayout(1, true);

		compositeContainer.setLayout(layout);

		createContents(compositeContainer);

		setControl(compositeContainer);

	}

	/**

	 * Create the contents of the page. Subclasses may override this method to change where the contributions are added.

	 */

	protected void createContents(Composite parent) {

		createSettingControls(parent);

		addContributions(parent);

	}

	/**

	 * create the controls of this page

	 */

	protected abstract void createSettingControls(Composite parent);

	@Override

	public boolean isPageComplete() {

		return super.isPageComplete() && conributionsIsPageComplete();

	}

	@Override

	public boolean canFlipToNextPage() {

		return super.canFlipToNextPage() && contributionsCanFlipToNextPage();

	}

	private boolean contributionsCanFlipToNextPage() {

		for (ITaskRepositoryPageContribution contribution : contributions) {

			if (!contribution.canFlipToNextPage()) {

				return false;

			}

		}

		return true;

	}

	private boolean conributionsIsPageComplete() {

		for (ITaskRepositoryPageContribution contribution : contributions) {

			if (!contribution.isPageComplete()) {

				return false;

			}

		}

		return true;

	}

	/**

	 * subclasses should only call this method if they override {@link #createContents(Composite)}

	 * 

	 * @param parentControl

	 *            the container into which the contributions will create their UI

	 */

	protected void addContributions(Composite parentControl) {

		List<ITaskRepositoryPageContributor> contributors = findApplicableContributors();

		for (ITaskRepositoryPageContributor contributor : contributors) {

			ITaskRepositoryPageContribution contribution = contributor.createContribution(getConnectorKind(),

					repository);

			if (contribution != null) {

				contributions.add(contribution);

				contribution.addListener(contributionListener);

			}

		}

		if (!contributions.isEmpty()) {

			Collections.sort(contributions, CONTRIBUTION_COMPARATOR);

			for (ITaskRepositoryPageContribution contribution : contributions) {

				ExpandableComposite section = toolkit.createExpandableComposite(parentControl,

						ExpandableComposite.COMPACT | ExpandableComposite.TWISTIE | ExpandableComposite.TITLE_BAR);

				section.clientVerticalSpacing = 0;

				section.setBackground(parentControl.getBackground());

				section.setFont(parentControl.getFont());

				section.addExpansionListener(new ExpansionAdapter() {

					@Override

					public void expansionStateChanged(ExpansionEvent e) {

						getControl().getShell().pack();

					}

				});

				section.setText(contribution.getTitle());

				section.setToolTipText(contribution.getDescription());

				GridDataFactory.fillDefaults().grab(true, false).applyTo(section);

				Composite sectionContentsContainer = toolkit.createComposite(section);

				sectionContentsContainer.setBackground(parentControl.getBackground());

				contribution.createControl(sectionContentsContainer, toolkit);

				section.setClient(sectionContentsContainer);

			}

		}

	}

	/**

	 * Validate the settings of this page, not including contributions. This method should not be called directly by

	 * page implementations. Implementations of this method must be capable of running in a non-UI thread.

	 * 

	 * @return an array of statuses, or null if there are no messages.

	 * 

	 * @see #validatePageSettings()

	 */

	protected abstract IStatus[] validate(IProgressMonitor monitor);

	/**

	 * Overriding methods should call <code>super.applyTo(repository)</code>

	 */

	public void applyTo(TaskRepository repository) {

		applyContributionSettingsTo(repository);

	}

	private void applyContributionSettingsTo(TaskRepository repository) {

		for (ITaskRepositoryPageContribution contribution : contributions) {

			contribution.applyTo(repository);

		}

	}

	private IStatus[] computeValidation(IProgressMonitor monitor) {

		int factor = 100;

		monitor.beginTask("Validating settings", (contributions.size() + 1) * factor);

		List<IStatus> statuses = null;

		// validate the page

		{

			SubProgressMonitor subMonitor = new SubProgressMonitor(monitor, factor);

			IStatus[] result = validate(subMonitor);

			if (result != null && result.length > 0) {

				if (statuses == null) {

					statuses = new ArrayList<IStatus>(result.length);

				}

				statuses.addAll(Arrays.asList(result));

			}

			subMonitor.done();

		}

		// validate contributions

		for (ITaskRepositoryPageContribution contribution : contributions) {

			SubProgressMonitor subMonitor = new SubProgressMonitor(monitor, factor);

			IStatus[] result = contribution.validate(subMonitor);

			if (result != null && result.length > 0) {

				if (statuses == null) {

					statuses = new ArrayList<IStatus>(result.length);

				}

				statuses.addAll(Arrays.asList(result));

			}

			subMonitor.done();

		}

		monitor.done();

		return statuses == null ? null : statuses.toArray(new IStatus[statuses.size()]);

	}

	/**

	 * Validate all settings in the page including contributions. This method should be called whenever a setting is

	 * changed on the page.

	 * 

	 * The results of validation are applied and the buttons of the page are updated.

	 * 

	 * @see #validate(IProgressMonitor)

	 * @see #applyValidationResult(IStatus[])

	 */

	protected void validatePageSettings() {

		final Object[] result = new Object[1];

		try {

			getWizard().getContainer().run(true, true, new IRunnableWithProgress() {

				public void run(IProgressMonitor monitor) throws InvocationTargetException, InterruptedException {

					result[0] = computeValidation(monitor);

				}

			});

		} catch (InvocationTargetException e) {

			StatusHandler.fail(new Status(IStatus.ERROR, TasksUiPlugin.ID_PLUGIN,

					"Internal error validating repository", e.getCause()));

			return;

		} catch (InterruptedException e) {

			// canceled

			return;

		}

		applyValidationResult((IStatus[]) result[0]);

		getWizard().getContainer().updateButtons();

	}

	/**

	 * Apply the results of validation to the page. The implementation finds the most {@link IStatus#getSeverity()

	 * severe} status and {@link #setMessage(String, int) applies the message} to the page.

	 * 

	 * @param statuses

	 *            an array of statuses that indicate the result of validation, or null

	 */

	protected void applyValidationResult(IStatus[] statuses) {

		if (statuses == null || statuses.length == 0) {

			setMessage(null, IMessageProvider.INFORMATION);

			setErrorMessage(null);

		} else {

			// find the most severe status

			IStatus status = statuses[0];

			for (IStatus s : statuses) {

				if (status == null || s.getSeverity() > status.getSeverity()) {

					status = s;

				}

			}

			int messageType;

			switch (status.getSeverity()) {

			case IStatus.OK:

			case IStatus.INFO:

				messageType = IMessageProvider.INFORMATION;

				break;

			case IStatus.WARNING:

				messageType = IMessageProvider.WARNING;

				break;

			case IStatus.ERROR:

			default:

				messageType = IMessageProvider.ERROR;

				break;

			}

			setErrorMessage(null);

			setMessage(status.getMessage(), messageType);

		}

	}

	private List<ITaskRepositoryPageContributor> findApplicableContributors() {

		List<ITaskRepositoryPageContributor> contributors = new ArrayList<ITaskRepositoryPageContributor>();

		IExtensionRegistry registry = Platform.getExtensionRegistry();

		IExtensionPoint editorExtensionPoint = registry.getExtensionPoint(TASK_REPOSITORY_PAGE_CONTRIBUTOR_EXTENSION);

		IExtension[] editorExtensions = editorExtensionPoint.getExtensions();

		for (IExtension extension : editorExtensions) {

			IConfigurationElement[] elements = extension.getConfigurationElements();

			for (IConfigurationElement element : elements) {

				if (element.getName().equals(TASK_REPOSITORY_PAGE_CONTRIBUTOR)) {

					String kind = element.getAttribute(KIND);

					if ("*".equals(kind) || getConnectorKind().equals(kind)) {

						try {

							Object contributor = element.createExecutableExtension("class");

							contributors.add((ITaskRepositoryPageContributor) contributor);

						} catch (Exception e) {

							StatusHandler.log(new Status(IStatus.ERROR, TasksUiPlugin.ID_PLUGIN, "Could not load "

									+ TASK_REPOSITORY_PAGE_CONTRIBUTOR, e));

						}

					}

				}

			}

		}

		return contributors;

	}

	private static class ContributionComparator implements Comparator<ITaskRepositoryPageContribution> {

		public int compare(ITaskRepositoryPageContribution o1, ITaskRepositoryPageContribution o2) {

			if (o1 == o2) {

				return 0;

			}

			String s1 = o1.getTitle();

			String s2 = o2.getTitle();

			int i = s1.compareTo(s2);

			if (i == 0) {

				i = new Integer(System.identityHashCode(s1)).compareTo(System.identityHashCode(s2));

			}

			return i;

		}

	}

}

/*******************************************************************************

 * Copyright (c) 2004, 2007 Mylyn project committers 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

 *******************************************************************************/

package org.eclipse.mylyn.tasks.ui.wizards;

import java.util.List;

import java.util.concurrent.CopyOnWriteArrayList;

import org.eclipse.mylyn.tasks.core.TaskRepository;

/**

 * An abstract implementation of {@link ITaskRepositoryPageContribution} that provides basic default functionality.

 * 

 * @since 3.1

 * 

 * @author David Green

 */

public abstract class AbstractTaskRepositoryPageContribution implements ITaskRepositoryPageContribution {

	private final List<Listener> listeners = new CopyOnWriteArrayList<Listener>();

	private final String title;

	private final String description;

	/**

	 * the repository for which this contribution was created, or null if it was created for a new repository

	 */

	protected final TaskRepository repository;

	/**

	 * the kind of connector for which this contribution was created

	 */

	protected final String connectorKind;

	protected AbstractTaskRepositoryPageContribution(String title, String description, String connectorKind,

			TaskRepository repository) {

		this.title = title;

		this.description = description;

		this.connectorKind = connectorKind;

		this.repository = repository;

	}

	public void addListener(Listener listener) {

		listeners.add(listener);

	}

	public String getDescription() {

		return description;

	}

	public String getTitle() {

		return title;

	}

	public void removeListener(Listener listener) {

		listeners.remove(listener);

	}

	protected void fireValidationRequired() {

		for (Listener l : listeners) {

			l.validationRequired(this);

		}

	}

}

/*******************************************************************************

 * Copyright (c) 2004, 2008 Mylyn project committers 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

 *******************************************************************************/

package org.eclipse.mylyn.tasks.ui.wizards;

import org.eclipse.core.runtime.IProgressMonitor;

import org.eclipse.core.runtime.IStatus;

import org.eclipse.jface.dialogs.IDialogPage;

import org.eclipse.jface.wizard.IWizardPage;

import org.eclipse.mylyn.tasks.core.TaskRepository;

import org.eclipse.swt.widgets.Composite;

import org.eclipse.ui.forms.widgets.FormToolkit;

/**

 * A contribution to a {@link ITaskRepositoryPage}

 * 

 * @see ITaskRepositoryPageContributor

 * 

 * @since 3.1

 * 

 * @author David Green

 */

public interface ITaskRepositoryPageContribution {

	/**

	 * a listener interface that should be implemented by classes wishing to be notified of changes that occur within

	 * the contribution.

	 */

	public interface Listener {

		/**

		 * Called when the state of the contribution changes such that validation should be performed

		 * 

		 * @param contribution

		 *            the contribution that changed

		 * 

		 * @see ITaskRepositoryPageContribution#validate(IProgressMonitor)

		 */

		public void validationRequired(ITaskRepositoryPageContribution contribution);

	}

	/**

	 * Add a listener to this contribution. The contribution must notify the listener at the appropriate times, for

	 * example when a setting has changed in the UI.

	 * 

	 * @see #removeListener(Listener)

	 */

	public void addListener(Listener listener);

	/**

	 * Remove a listener from this contribution.

	 * 

	 * @see #addListener(Listener)

	 */

	public void removeListener(Listener listener);

	/**

	 * @see IDialogPage#createControl(Composite)

	 */

	public void createControl(Composite parent, FormToolkit toolkit);

	/**

	 * @see IDialogPage#getTitle()

	 */

	public String getTitle();

	/**

	 * @see IDialogPage#getDescription()

	 */

	public String getDescription();

	/**

	 * @see IWizardPage#isPageComplete()

	 */

	public boolean isPageComplete();

	/**

	 * @see IWizardPage#canFlipToNextPage()

	 */

	public boolean canFlipToNextPage();

	/**

	 * Validate the settings of the contribution. Contributions should expect this method to be called often and should

	 * thus return quickly. Implementations of this method must be capable of running in a non-UI thread.

	 * 

	 * @return a list of errors on the contribution, or null if there are none

	 */

	public IStatus[] validate(IProgressMonitor monitor);

	/**

	 * Apply the settings in the contribution to the given repository.

	 * 

	 * @param repository

	 *            the repository to which settings should be applied

	 * 

	 * @see ITaskRepositoryPage#applyTo(TaskRepository)

	 */

	public void applyTo(TaskRepository repository);

}

/*******************************************************************************

 * Copyright (c) 2004, 2008 Mylyn project committers 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

 *******************************************************************************/

package org.eclipse.mylyn.internal.tasks.ui.wizards;

import org.eclipse.core.runtime.IProgressMonitor;

import org.eclipse.core.runtime.IStatus;

import org.eclipse.mylyn.internal.tasks.core.LocalRepositoryConnector;

import org.eclipse.mylyn.tasks.core.TaskRepository;

import org.eclipse.mylyn.tasks.ui.wizards.AbstractExtensibleRepositorySettingsPage;

import org.eclipse.swt.widgets.Composite;

public class LocalRepositorySettingsPage extends AbstractExtensibleRepositorySettingsPage {

	public LocalRepositorySettingsPage(TaskRepository taskRepository) {

		super("Local Repository Settings", "Configure the local repository", taskRepository);

	}

	@Override

	public String getConnectorKind() {

		return LocalRepositoryConnector.CONNECTOR_KIND;

	}

	public String getRepositoryUrl() {

		return null;

	}

	@Override

	protected void createSettingControls(Composite parent) {

		// nothing to do, since the local repository has no settings

	}

	@Override

	protected IStatus[] validate(IProgressMonitor monitor) {

		// nothing to do

		return null;

	}

}

<?xml version='1.0' encoding='UTF-8'?>

<!-- Schema file written by PDE -->

<schema targetNamespace="org.eclipse.mylyn.tasks.ui" xmlns="http://www.w3.org/2001/XMLSchema">

<annotation>

      <appinfo>

         <meta.schema plugin="org.eclipse.mylyn.tasks.ui" id="taskRepositoryPageContributor" name="Task Repository Page Contributor"/>

      </appinfo>

      <documentation>

         [Enter description of this extension point.]

      </documentation>

   </annotation>

   <element name="extension">

      <annotation>

         <appinfo>

            <meta.element />

         </appinfo>

      </annotation>

      <complexType>

         <sequence>

            <element ref="taskRepositoryPageContributor" minOccurs="1" maxOccurs="unbounded"/>

         </sequence>

         <attribute name="point" type="string" use="required">

            <annotation>

               <documentation>

               </documentation>

            </annotation>

         </attribute>

         <attribute name="id" type="string">

            <annotation>

               <documentation>

               </documentation>

            </annotation>

         </attribute>

         <attribute name="name" type="string">

            <annotation>

               <documentation>

               </documentation>

               <appinfo>

                  <meta.attribute translatable="true"/>

               </appinfo>

            </annotation>

         </attribute>

      </complexType>

   </element>

   <element name="taskRepositoryPageContributor">

      <complexType>

         <attribute name="class" type="string" use="required">

            <annotation>

               <documentation>

               </documentation>

               <appinfo>

                  <meta.attribute kind="java" basedOn=":org.eclipse.mylyn.tasks.ui.wizards.ITaskRepositoryPageContributor"/>

               </appinfo>

            </annotation>

         </attribute>

         <attribute name="connectorKind" type="string" use="required">

            <annotation>

               <documentation>

                  the kind of repository connector for which this contributor should be used, or "*" if it applies to all connectors

               </documentation>

            </annotation>

         </attribute>

      </complexType>

   </element>

   <annotation>

      <appinfo>

         <meta.section type="since"/>

      </appinfo>

      <documentation>

         [Enter the first release in which this extension point appears.]

      </documentation>

   </annotation>

   <annotation>

      <appinfo>

         <meta.section type="examples"/>

      </appinfo>

      <documentation>

         [Enter extension point usage example here.]

      </documentation>

   </annotation>

   <annotation>

      <appinfo>

         <meta.section type="apiinfo"/>

      </appinfo>

      <documentation>

         [Enter API information here.]

      </documentation>

   </annotation>

   <annotation>

      <appinfo>

         <meta.section type="implementation"/>

      </appinfo>

      <documentation>

         [Enter information about supplied implementation of this extension point.]

      </documentation>

   </annotation>

</schema>