fetchScriptBuilders.name = Fetch Script Builders

   <extension-point id="fetchScriptBuilders" name="%fetchScriptBuilders.name" schema="schema/fetchScriptBuilders.exsd"/>

   <extension

         point="org.eclipse.pde.build.fetchScriptBuilders">

      <builder

            class="org.eclipse.pde.internal.build.fetch.COPYFetchScriptBuilder"

            id="COPY"/>

      <builder

            class="org.eclipse.pde.internal.build.fetch.CVSFetchScriptBuilder"

            id="CVS"/>

   </extension>

        FetchScriptBuildersRegistry.shutdown();

import org.eclipse.pde.build.IFetchScriptBuilder;

        // print authentification task if one is provided

        ITask authTask = builder.generateAuthentificationTask(elementToFetch,type,mapFileEntry);

        if(null != authTask) script.print(authTask);

        // the location

            String destination = elementName;

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

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

<schema targetNamespace="org.eclipse.pde.build">

<annotation>

      <appInfo>

         <meta.schema plugin="org.eclipse.pde.build" id="fetchScriptBuilders" name="Fetch Script Builder"/>

      </appInfo>

      <documentation>

         Provides builders for constructing fetch scripts during the build process.

      </documentation>

   </annotation>

   <element name="extension">

      <complexType>

         <sequence>

            <element ref="builder" 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>

            </annotation>

         </attribute>

      </complexType>

   </element>

   <element name="builder">

      <annotation>

         <appInfo>

            <meta.element labelAttribute="id"/>

         </appInfo>

         <documentation>

            The builder.

         </documentation>

      </annotation>

      <complexType>

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

            <annotation>

               <documentation>

                  The builder id (must be unique).

               </documentation>

            </annotation>

         </attribute>

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

            <annotation>

               <documentation>

                  The builder implementation (must implement <code>org.eclipse.pde.build.IFetchScriptBuilder</code> and must provide a parameter less, public constructor).

               </documentation>

               <appInfo>

                  <meta.attribute kind="java" basedOn="org.eclipse.pde.build.IFetchScriptBuilder"/>

               </appInfo>

            </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>

   <annotation>

      <appInfo>

         <meta.section type="copyright"/>

      </appInfo>

      <documentation>

      </documentation>

   </annotation>

</schema>

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

 * Copyright (c) 2004, 2005 Eclipse Foundation 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

 * $Id$

 *

 * Contributors:

 *     Gunnar Wagenknecht - Initial API and implementation

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

package org.eclipse.pde.build;

import java.util.Map;

import org.eclipse.core.runtime.CoreException;

import org.eclipse.pde.internal.build.ant.ITask;

/**

 * A <code>IFetchScriptBuilder</code> constructs a repository specific fetch

 * script for the PDE build process.

 * <p>

 * It is registered via the

 * <code>org.eclipse.pde.build.fetchScriptBuilder</code> extension point.

 * </p>

 */

public interface IFetchScriptBuilder {

	/** element type <code>bundle</code> */

	String ELEMENT_TYPE_BUNDLE = "bundle"; //$NON-NLS-1$

	/** element type <code>feature</code> */

	String ELEMENT_TYPE_FEATURE = "feature"; //$NON-NLS-1$

	/** element type <code>fragment</code> */

	String ELEMENT_TYPE_FRAGMENT = "fragment"; //$NON-NLS-1$

	/** element type <code>plugin</code> */

	String ELEMENT_TYPE_PLUGIN = "plugin"; //$NON-NLS-1$

	/**

	 * Generates a task that is necessary for authentificate against the

	 * repository.

	 * 

	 * @param element

	 *            the element name

	 * @param type

	 *            the element type (one of

	 *            {@link #ELEMENT_TYPE_FEATURE <code>feature</code>},

	 *            {@link #ELEMENT_TYPE_PLUGIN <code>plugin</code>},

	 *            {@link #ELEMENT_TYPE_FRAGMENT <code>fragment</code>} or

	 *            {@link #ELEMENT_TYPE_BUNDLE <code>bundle</code>}) (may not be

	 *            <code>null</code>)

	 * @param entryInfos

	 *            the map with detailed information collected in

	 *            {@link #processMapFileEntry(String, String, String[], String, Map)}

	 * @return the authentification task (maybe <code>null</code> if not

	 *         necessary)

	 */

	ITask generateAuthentificationTask(String element, String type,

			Map entryInfos);

	/**

	 * Generates a properties for fetching the specified element via the fetch

	 * task.

	 * 

	 * @param element

	 *            the element name

	 * @param type

	 *            the element type (one of

	 *            {@link #ELEMENT_TYPE_FEATURE <code>feature</code>},

	 *            {@link #ELEMENT_TYPE_PLUGIN <code>plugin</code>},

	 *            {@link #ELEMENT_TYPE_FRAGMENT <code>fragment</code>} or

	 *            {@link #ELEMENT_TYPE_BUNDLE <code>bundle</code>}) (may not be

	 *            <code>null</code>)

	 * @param entryInfos

	 *            the map with detailed information collected in

	 *            {@link #processMapFileEntry(String, String, String[], String, Map)}

	 * @param destination

	 *            the destination where the files should be fetched to

	 * @param xmlFileOnly

	 *            if <code>true</code> only the element's XML descriptor

	 *            should be fetched, otherwise the complete element must be

	 *            fetched

	 * @return the map with properties (must be <code>String</code> keys and

	 *         <code>String</code> values)

	 * @throws CoreException

	 */

	Map generatePropertiesForFetchTask(String element, String type,

			Map entryInfos, String destination, boolean xmlFileOnly)

			throws CoreException;

	/**

	 * Generates a task for retrieving the specified files only.

	 * 

	 * @param element

	 *            the element name

	 * @param type

	 *            the element type (one of

	 *            {@link #ELEMENT_TYPE_FEATURE <code>feature</code>},

	 *            {@link #ELEMENT_TYPE_PLUGIN <code>plugin</code>},

	 *            {@link #ELEMENT_TYPE_FRAGMENT <code>fragment</code>} or

	 *            {@link #ELEMENT_TYPE_BUNDLE <code>bundle</code>}) (may not be

	 *            <code>null</code>)

	 * @param entryInfos

	 *            the map with detailed information collected in

	 *            {@link #processMapFileEntry(String, String, String[], String, Map)}

	 * @param destination

	 *            the destination where the files should be fetched to

	 * @param files

	 *            the list of files to fetch

	 * @return the task for fetching the files

	 */

	ITask generateRetrieveFilesTask(String element, String type,

			Map entryInfos, String destination, String[] files);

	/**

	 * Returns the common task that is used to fetch elements specified via Ant

	 * properties.

	 * <p>

	 * This task is called from within the element specific generated fetch

	 * tasks to fetch an elements.

	 * </p>

	 * 

	 * @return the common fetch task

	 * @see #generatePropertiesForFetchTask(String, String, Map, String,

	 *      boolean)

	 */

	ITask getFetchTask();

	/**

	 * Returns a version identifyer (eg. TAG name) of the element that will be

	 * fetched.

	 * 

	 * @param element

	 *            the element name

	 * @param type

	 *            the element type (one of

	 *            {@link #ELEMENT_TYPE_FEATURE <code>feature</code>},

	 *            {@link #ELEMENT_TYPE_PLUGIN <code>plugin</code>},

	 *            {@link #ELEMENT_TYPE_FRAGMENT <code>fragment</code>} or

	 *            {@link #ELEMENT_TYPE_BUNDLE <code>bundle</code>}) (may not be

	 *            <code>null</code>)

	 * @param entryInfos

	 *            the map with detailed information collected in

	 *            {@link #processMapFileEntry(String, String, String[], String, Map)}

	 * @return a version identifyer

	 */

	String getVersionToFetch(String element, String type, Map entryInfos);

	/**

	 * Processes the specified element with the specified type.

	 * <p>

	 * The arguments specified in the map file are provided. The map with entry

	 * infos should be filled with provider specific information that is

	 * required in later processing to sucessfully generate the fetch script.

	 * </p>

	 * 

	 * @param element

	 *            the element name (eg. <code>com.my.plugin</code>) (may not

	 *            be <code>null</code>)

	 * @param type

	 *            the element type (one of

	 *            {@link #ELEMENT_TYPE_FEATURE <code>feature</code>},

	 *            {@link #ELEMENT_TYPE_PLUGIN <code>plugin</code>},

	 *            {@link #ELEMENT_TYPE_FRAGMENT <code>fragment</code>} or

	 *            {@link #ELEMENT_TYPE_BUNDLE <code>bundle</code>}) (may not be

	 *            <code>null</code>)

	 * @param arguments

	 *            the arguments specified in the build script (may not be

	 *            <code>null</code>)

	 * @param fetchTag

	 *            the fetch tag that will overwrite all tags specified in the

	 *            repository if set (maybe <code>null</code> or empty)

	 * @param entryInfos

	 *            the map to store repository specific information (may not be

	 *            <code>null</code>)

	 * @throws CoreException

	 *             if the arguments are invalid

	 */

	void processMapFileEntry(String element, String type, String[] arguments,

			String fetchTag, Map entryInfos) throws CoreException;

}

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

 * Copyright (c) 2004, 2005 Eclipse Foundation 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

 * $Id$

 *

 * Contributors:

 *     Gunnar Wagenknecht - Initial API and implementation

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

package org.eclipse.pde.internal.build;

import java.util.Collection;

import java.util.Collections;

import java.util.HashMap;

import java.util.Map;

import org.eclipse.core.runtime.CoreException;

import org.eclipse.core.runtime.IConfigurationElement;

import org.eclipse.core.runtime.IRegistryChangeEvent;

import org.eclipse.core.runtime.IRegistryChangeListener;

import org.eclipse.core.runtime.Platform;

import org.eclipse.pde.build.IFetchScriptBuilder;

/**

 * A registry for acessing fetch script builders.

 */

public class FetchScriptBuildersRegistry implements IRegistryChangeListener {

    /** the extension point */

	private static final String EXT_FETCH_SCRIPT_BUILDERS = "org.eclipse.pde.build.fetchScriptBuilders"; //$NON-NLS-1$

    /** attribute <code>id</code> */

    private static final String ATTR_ID = "id"; //$NON-NLS-1$

    /** attribute <code>class</code> */

    private static final String ATTR_CLASS = "class"; //$NON-NLS-1$

    /** element <code>builder</code> */

    private static final String ELEM_BUILDER = "builder"; //$NON-NLS-1$

    /** the shared instance */

    private static FetchScriptBuildersRegistry instance;

    /**

     * Returns the singleton registry instance.

     * 

     * @return the registry instance

     */

    public static FetchScriptBuildersRegistry getRegistry() {

        if (null == instance) {

            createRegistry();

        }

        return instance;

    }

    /**

     * Creates the singleton registry instance.

     */

    private static synchronized void createRegistry() {

        if (null != instance) return;

        instance = new FetchScriptBuildersRegistry();

        Platform.getExtensionRegistry().addRegistryChangeListener(instance,

                "org.eclipse.pde.build"); //$NON-NLS-1$

    }

    /**

     * Shuts down the registry.

     */

    static void shutdown() {

        if (null != instance) {

            Platform.getExtensionRegistry().removeRegistryChangeListener(

                    instance);

        }

    }

    /** a map of registered builders */

    private Map builders;

    /**

     * Hidden constructor.

     */

    private FetchScriptBuildersRegistry() {

        // hidden constructor

    }

    /*

     * (non-Javadoc)

     * 

     * @see org.eclipse.core.runtime.IRegistryChangeListener#registryChanged(org.eclipse.core.runtime.IRegistryChangeEvent)

     */

    public void registryChanged(IRegistryChangeEvent event) {

        // reset list of known builders

        if (null != builders) builders = null;

    }

    /**

     * Returns a collection of registered builder ids.

     * 

     * @return a collection of registered builder ids

     */

    public Collection getBuilderIds() {

        // ensure initialized

        initializeRegistry();

        return null != builders ? builders.keySet() : Collections.EMPTY_SET;

    }

    /**

     * Initializes the registry

     */

    private void initializeRegistry() {

        // don't initialize twice

        if (null != builders) return;

        synchronized (builders = new HashMap()) {

            IConfigurationElement[] extensions = Platform

                    .getExtensionRegistry().getConfigurationElementsFor(

                            EXT_FETCH_SCRIPT_BUILDERS);

            for (int i = 0; i < extensions.length; i++) {

                IConfigurationElement extension = extensions[i];

                if(ELEM_BUILDER.equals(extension.getName())) {

                    String id = extension.getAttribute(ATTR_ID);

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

                        builders.put(id, extension);

                    }

                }

            }

        }

    }

    /**

     * Returns the builder instance with the specified id.

     * <p>

     * The instance is not cached. Each time this method is called, a new

     * instance is created.

     * </p>

     * 

     * @param id

     * @return the builder instance (maybe <code>null</code>)

     */

    public IFetchScriptBuilder getBuilder(String id) {

        // ensure initialized

        initializeRegistry();

        IConfigurationElement extension = (IConfigurationElement) builders

                .get(id);

        if (null != extension) {

            try {

                return (IFetchScriptBuilder) extension

                        .createExecutableExtension(ATTR_CLASS);

            } catch (CoreException e) {

                BundleHelper.getDefault().getLog().log(e.getStatus());

            }

        }

        return null;

    }

}

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

 * Copyright (c) 2004, 2005 Eclipse Foundation 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

 * $Id$

 *

 * Contributors:

 *     Gunnar Wagenknecht - Initial API and implementation

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

package org.eclipse.pde.internal.build.fetch;

import java.util.HashMap;

import java.util.Map;

import org.eclipse.core.runtime.CoreException;

import org.eclipse.core.runtime.IPath;

import org.eclipse.core.runtime.IStatus;

import org.eclipse.core.runtime.Path;

import org.eclipse.core.runtime.Status;

import org.eclipse.osgi.util.NLS;

import org.eclipse.pde.build.IFetchScriptBuilder;

import org.eclipse.pde.internal.build.IPDEBuildConstants;

import org.eclipse.pde.internal.build.Messages;

import org.eclipse.pde.internal.build.ant.AntScript;

import org.eclipse.pde.internal.build.ant.FileSet;

import org.eclipse.pde.internal.build.ant.ITask;

/**

 * An <code>IFetchScriptBuilder</code> that fetches features and plugins by

 * copying from a specific location (id: <code>COPY</code>).

 * <p>

 * Map file arguments:

 * <code>&lt;ROOT_LOCATION&gt;[,&lt;ELEMENT_LOCATION&gt;]</code>

 * <dl>

 * <dt>ROOT_LOCATION</dt>

 * <dd>The ROOT_LOCATION (eg. <code>/source/eclipse</code>, or

 * <code>D:/dev/myproduct</code>) is used as root path to determine the

 * location to fetch. It can be overwritten via the

 * <code>fetchTag</code> to fetch from another location (for example, on a different machine).</dd>

 * </dl>

 * <dt>ELEMENT_LOCATION</dt>

 * <dd>A path withing the ROOT_LOCATION (eg.

 * <code>org.eclipse.sdk-feature/features/org.eclipse.rcp</code>) to retrive

 * the element from if it is not within the root. If this is not provided the

 * default path will be used which simply maps to the element name.</dd>

 * </dl>

 * </p>

 */

public class COPYFetchScriptBuilder implements IFetchScriptBuilder,

		IPDEBuildConstants {

	public static final String ID = "COPY"; //$NON-NLS-1$

	private static final String PATH = "path"; //$NON-NLS-1$

	private static final String ROOT = "root"; //$NON-NLS-1$

	private static final ITask GET_FROM_PATH_TASK = new ITask() {

		/*

		 * (non-Javadoc)

		 * 

		 * @see org.eclipse.pde.internal.build.ant.ITask#print(org.eclipse.pde.internal.build.ant.AntScript)

		 */

		public void print(AntScript script) {

			FileSet dir = new FileSet(

					"${sourcePath}", null, null, null, null, null, null); //$NON-NLS-1$

			script.printCopyTask(null,

					"${destination}", new FileSet[] { dir }, false, true); //$NON-NLS-1$ 

		}

	};

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#generateAuthentificationTask(java.lang.String,

	 *      java.lang.String, java.util.Map)

	 */

	public ITask generateAuthentificationTask(String element, String type,

			Map entryInfos) {

		// not necessary

		return null;

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#generatePropertiesForFetchTask(java.lang.String,

	 *      java.lang.String, java.util.Map, java.lang.String, boolean)

	 */

	public Map generatePropertiesForFetchTask(String element, String type,

			Map entryInfos, String destination, boolean xmlFileOnly) {

		Map params = new HashMap(2);

		// we directly export the CVS content into the destination

		params.put("destination", destination); //$NON-NLS-1$

		params.put("quiet", "${quiet}"); //$NON-NLS-1$ //$NON-NLS-2$

		String root = (String) entryInfos.get(ROOT);

		String path = (String) entryInfos.get(PATH);

		IPath sourcePath = new Path(root);

		if (path != null) {

			sourcePath = sourcePath.append(path);

		} else {

			sourcePath = sourcePath.append(element);

		}

		if (xmlFileOnly) {

			if (type.equals("feature")) { //$NON-NLS-1$

				sourcePath.append(DEFAULT_FEATURE_FILENAME_DESCRIPTOR);

			} else if (type.equals("plugin")) { //$NON-NLS-1$

				sourcePath.append(DEFAULT_PLUGIN_FILENAME_DESCRIPTOR);

			} else if (type.equals("fragment")) { //$NON-NLS-1$

				sourcePath.append(DEFAULT_FRAGMENT_FILENAME_DESCRIPTOR);

			}

		}

		params.put("sourcePath", sourcePath.toString()); //$NON-NLS-1$

		return params;

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#generateRetrieveFilesTask(java.lang.String,

	 *      java.lang.String, java.util.Map, java.lang.String,

	 *      java.lang.String[])

	 */

	public ITask generateRetrieveFilesTask(final String element,

			final String type, final Map entryInfos, final String destination,

			final String[] files) {

		return new ITask() {

			/*

			 * (non-Javadoc)

			 * 

			 * @see org.eclipse.pde.internal.build.ant.ITask#print(org.eclipse.pde.internal.build.ant.AntScript)

			 */

			public void print(AntScript script) {

				String root = (String) entryInfos.get(ROOT);

				String path = (String) entryInfos.get(PATH);

				for (int i = 0; i < files.length; i++) {

					String file = files[i];

					IPath filePath = new Path(root);

					if (path != null) {

						filePath = filePath.append(path).append(file);

					} else {

						filePath = filePath.append(element).append(file);

					}

					script.printCopyTask(filePath.toString(), destination,

							null, false, true);

				}

			}

		};

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#getFetchTask()

	 */

	public ITask getFetchTask() {

		return GET_FROM_PATH_TASK;

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#getVersionToFetch(java.lang.String,

	 *      java.lang.String, java.util.Map)

	 */

	public String getVersionToFetch(String element, String type, Map entryInfos) {

		return (String) entryInfos.get(ROOT);

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#processMapFileEntry(java.lang.String,

	 *      java.lang.String, java.lang.String[], java.lang.String,

	 *      java.util.Map)

	 */

	public void processMapFileEntry(String element, String type,

			String[] arguments, String fetchTag, Map entryInfos)

			throws CoreException {

		if (arguments.length < 1) {

			String message = NLS.bind(Messages.error_incorrectDirectoryEntry,

					element); //$NON-NLS-1$

			throw new CoreException(new Status(IStatus.ERROR, PI_PDEBUILD,

					EXCEPTION_ENTRY_MISSING, message, null));

		}

		entryInfos

				.put(

						ROOT,

						(null == fetchTag || fetchTag.trim().length() == 0) ? arguments[0]

								: fetchTag);

		entryInfos.put(PATH, (arguments.length > 1 && arguments[1].trim()

				.length() > 0) ? arguments[1] : null);

	}

}

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

 * Copyright (c) 2000, 2004 IBM Corporation and others.

 * All rights reserved.   This program and the accompanying materials

 * are made available under the terms of the Common Public License v1.0

 * which accompanies this distribution, and is available at

 * http://www.eclipse.org/legal/cpl-v10.html

 * 

 * Contributors: 

 *     IBM Corporation - initial API and implementation

 *     Gunnar Wagenknecht - adaption to new fetch script builder API

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

package org.eclipse.pde.internal.build.fetch;

import java.util.HashMap;

import java.util.Map;

import org.eclipse.core.runtime.CoreException;

import org.eclipse.core.runtime.IPath;

import org.eclipse.core.runtime.IStatus;

import org.eclipse.core.runtime.Path;

import org.eclipse.core.runtime.Status;

import org.eclipse.osgi.util.NLS;

import org.eclipse.pde.build.IFetchScriptBuilder;

import org.eclipse.pde.internal.build.IPDEBuildConstants;

import org.eclipse.pde.internal.build.Messages;

import org.eclipse.pde.internal.build.ant.AntScript;

import org.eclipse.pde.internal.build.ant.ITask;

/**

 * An <code>IFetchScriptBuilder</code> for building fetch scripts that will

 * fetch content from a CVS repository (id: <code>CVS</code>).

 * <p>

 * Map file arguments:

 * <code>&lt;TAG&gt;,&lt;CVSROOT&gt;[,&lt;PASSWORD&gt;[,&lt;PATH&gt;[,&lt;CVSPASSFILE&gt;]]]</code>

 * </p>

 */

public class CVSFetchScriptBuilder implements IFetchScriptBuilder,

		IPDEBuildConstants {

	private static final String CVSPASSFILE = "cvsPassFile"; //$NON-NLS-1$

	private static final String CVSROOT = "cvsRoot"; //$NON-NLS-1$

	private static final ITask GET_FROM_CVS_TASK = new ITask() {

		/*

		 * (non-Javadoc)

		 * 

		 * @see org.eclipse.pde.internal.build.ant.ITask#print(org.eclipse.pde.internal.build.ant.AntScript)

		 */

		public void print(AntScript script) {

			script

					.printCVSTask(

							"export -d ${destination} -r ${tag} ${package}", "${cvsRoot}", null, null, null, "${quiet}", null); //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$

		}

	};

	public static final String ID = "CVS"; //$NON-NLS-1$

	private static final String PASSWORD = "password"; //$NON-NLS-1$

	private static final String PATH = "path"; //$NON-NLS-1$

	private static final String TAG = "tag"; //$NON-NLS-1$

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#generateAuthentificationTask(java.lang.String,

	 *      java.lang.String, java.util.Map)

	 */

	public ITask generateAuthentificationTask(final String element,

			final String type, final Map entryInfos) {

		return new ITask() {

			/*

			 * (non-Javadoc)

			 * 

			 * @see org.eclipse.pde.internal.build.ant.ITask#print(org.eclipse.pde.internal.build.ant.AntScript)

			 */

			public void print(AntScript script) {

				String password = (String) entryInfos.get(PASSWORD);

				String cvsPassFileLocation = (String) entryInfos

						.get(CVSPASSFILE);

				if (password != null)

					script.printCVSPassTask((String) entryInfos.get(CVSROOT),

							password, cvsPassFileLocation);

			}

		};

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#generatePropertiesForFetchTask(java.lang.String,

	 *      java.lang.String, java.util.Map, java.lang.String, boolean)

	 */

	public Map generatePropertiesForFetchTask(String element, String type,

			Map entryInfos, String destination, boolean manifestFileOnly) {

		Map params = new HashMap(5);

		// we directly export the CVS content into the destination

		params.put("destination", destination); //$NON-NLS-1$

		params.put(TAG, entryInfos.get(TAG));

		params.put(CVSROOT, entryInfos.get(CVSROOT));

		params.put("quiet", "${quiet}"); //$NON-NLS-1$ //$NON-NLS-2$

		String cvsPackage = ((String) entryInfos.get(PATH) == null ? element

				: (String) entryInfos.get(PATH));

		if (type.equals(ELEMENT_TYPE_FEATURE)) {

			cvsPackage += manifestFileOnly ? '/' + DEFAULT_FEATURE_FILENAME_DESCRIPTOR

					: ""; //$NON-NLS-1$

		} else if (type.equals(ELEMENT_TYPE_PLUGIN)) {

			cvsPackage += manifestFileOnly ? '/' + DEFAULT_PLUGIN_FILENAME_DESCRIPTOR

					: ""; //$NON-NLS-1$

		} else if (type.equals(ELEMENT_TYPE_FRAGMENT)) {

			cvsPackage += manifestFileOnly ? '/' + DEFAULT_FRAGMENT_FILENAME_DESCRIPTOR

					: ""; //$NON-NLS-1$

		} else if (type.equals(ELEMENT_TYPE_BUNDLE)) {

			cvsPackage += manifestFileOnly ? '/' + DEFAULT_BUNDLE_FILENAME_DESCRIPTOR

					: "";//$NON-NLS-1$ 

		}

		params.put("package", cvsPackage); //$NON-NLS-1$

		return params;

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#generateRetrieveFilesTask(java.lang.String,

	 *      java.lang.String, java.util.Map, java.lang.String,

	 *      java.lang.String[])

	 */

	public ITask generateRetrieveFilesTask(final String element,

			final String type, final Map entryInfos, final String destination,

			final String[] files) {

		return new ITask() {

			/*

			 * (non-Javadoc)

			 * 

			 * @see org.eclipse.pde.internal.build.ant.ITask#print(org.eclipse.pde.internal.build.ant.AntScript)

			 */

			public void print(AntScript script) {

				String cvsRoot = (String) entryInfos.get(CVSROOT);

				String tag = (String) entryInfos.get(TAG);

				String path = (String) entryInfos.get(PATH);

				String password = (String) entryInfos.get(PASSWORD);

				String cvsPassFileLocation = (String) entryInfos

						.get(CVSPASSFILE);

				if (password != null)

					script.printCVSPassTask(cvsRoot, password,

							cvsPassFileLocation);

				for (int i = 0; i < files.length; i++) {

					String file = files[i];

					IPath filePath;

					if (path != null) {

						filePath = new Path(path).append(file);

					} else {

						filePath = new Path(element).append(file);

					}

					script

							.printCVSTask(

									"export -d " + destination + " -r " + tag + " " + filePath.toString(), cvsRoot, null, null, null, "true", null); //$NON-NLS-1$//$NON-NLS-2$//$NON-NLS-3$ //$NON-NLS-4$

				}

			}

		};

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#getFetchTask()

	 */

	public ITask getFetchTask() {

		return GET_FROM_CVS_TASK;

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#getVersionToFetch(java.lang.String,

	 *      java.lang.String, java.util.Map)

	 */

	public String getVersionToFetch(String element, String type, Map entryInfos) {

		return (String) entryInfos.get(TAG);

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see org.eclipse.pde.internal.build.IFetchScriptBuilder#processMapFileEntry(java.lang.String,

	 *      java.lang.String, java.lang.String[], java.lang.String,

	 *      java.util.Map)

	 */

	public void processMapFileEntry(String element, String type,

			String[] arguments, String fetchTag, Map entryInfos)

			throws CoreException {

		if (arguments.length < 2) {

			String message = NLS.bind(Messages.error_incorrectDirectoryEntry,

					element);

			throw new CoreException(new Status(IStatus.ERROR, PI_PDEBUILD,

					EXCEPTION_ENTRY_MISSING, message, null));

		}

		entryInfos

				.put(

						TAG,

						(null == fetchTag || fetchTag.trim().length() == 0) ? arguments[0]

								: fetchTag);

		entryInfos.put(CVSROOT, arguments[1]);

		entryInfos.put(PASSWORD, (arguments.length > 2 && !arguments[2]

				.equals("")) ? arguments[2] : null); //$NON-NLS-1$

		entryInfos

				.put(

						PATH,

						(arguments.length > 3 && !arguments[3].equals("")) ? arguments[3] : null); //$NON-NLS-1$ 

		entryInfos.put(CVSPASSFILE, (arguments.length > 4 && !arguments[4]

				.equals("")) ? arguments[4] : null); //$NON-NLS-1$

	}

}