extensionPointServerCreationWizardPageExtension=Server Creation Wizard Page Extension

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

import org.eclipse.wst.server.ui.wizard.ServerCreationWizardPageExtension;

	// Cached copy of all server wizard GUI modifier

	private static List<ServerCreationWizardPageExtension> serverCreationWizardPageExtensions;

	 * Returns the list of server creation wizard modifier.

	 *

	 * @return the list of server creation wizard modifier, or an empty list if none could be found

	 */

	public static List<ServerCreationWizardPageExtension> getServerCreationWizardPageExtensions() {

		if (serverCreationWizardPageExtensions == null) {

			loadServerCreationWizardPageExtensions();

		}

		return serverCreationWizardPageExtensions;

	}

	/**

	 * Load the Server creation wizard page modifiers.

	 */

	private static synchronized void loadServerCreationWizardPageExtensions() {

		if (serverCreationWizardPageExtensions != null)

			return;

		Trace.trace(Trace.CONFIG, "->- Loading .serverCreationWizardPageExtension extension point ->-");

		serverCreationWizardPageExtensions = new ArrayList<ServerCreationWizardPageExtension>();

		IExtensionRegistry registry = Platform.getExtensionRegistry();

		IConfigurationElement[] cf = registry.getConfigurationElementsFor(ServerUIPlugin.PLUGIN_ID, "serverCreationWizardPageExtension");

		for (IConfigurationElement curConfigElement: cf) {

			try {

				// Create the class here already since the usage of the server wizard page will need to use all the extensions

				// in all the calls.  Therefore, there is no need for lazy loading here.

				ServerCreationWizardPageExtension curExtension = (ServerCreationWizardPageExtension)curConfigElement.createExecutableExtension("class");

				Trace.trace(Trace.CONFIG, "  Loaded serverCreationWizardPageExtension: " + cf[0].getAttribute("id") + ", loaded class=" + curExtension);

				if (curExtension != null) {

					serverCreationWizardPageExtensions.add(curExtension);

				}

			} catch (Throwable t) {

				Trace.trace(Trace.SEVERE, "  Could not load serverCreationWizardPageExtension: " + cf[0].getAttribute("id"), t);

			}

		}

		Trace.trace(Trace.CONFIG, "-<- Done loading .serverCreationWizardPageExtension extension point -<-");

	}

	/**

import java.beans.PropertyChangeEvent;

import java.util.Map;

import org.eclipse.wst.server.ui.wizard.ServerCreationWizardPageExtension;

	protected Label hostnameLabel;

	private IServerType oldServerType = null;

		List<ServerCreationWizardPageExtension> pageExtensionLst = ServerUIPlugin.getServerCreationWizardPageExtensions();

		// Add the page modifier top section UI. 

		for (ServerCreationWizardPageExtension curPageExtension : pageExtensionLst) {

			curPageExtension.createControl(ServerCreationWizardPageExtension.UI_POSITION.TOP, this);

			curPageExtension.setUIControlListener(this);

		}

		// Add the page modifier middle section UI. 

		for (ServerCreationWizardPageExtension curPageExtension : pageExtensionLst) {

			curPageExtension.createControl(ServerCreationWizardPageExtension.UI_POSITION.MIDDLE, this);

		}

		// Add the page modifier bottom section UI. 

		for (ServerCreationWizardPageExtension curPageExtension : pageExtensionLst) {

			curPageExtension.createControl(ServerCreationWizardPageExtension.UI_POSITION.TOP, this);

		}

	public String getControlStringValue(String controlId) {

		if (controlId != null && AbstractUIControl.PROP_HOSTNAME.equals(controlId)) {

			return host;

		}	

		return null;

	}

			fireServerWorkingCopyChanged();

				fireServerWorkingCopyChanged();

	protected void fireServerWorkingCopyChanged() {

		List<ServerCreationWizardPageExtension> pageExtensionLst = ServerUIPlugin.getServerCreationWizardPageExtensions();

		// Add the page modifier top section UI. 

		for (ServerCreationWizardPageExtension curPageExtension : pageExtensionLst) {

			curPageExtension.setServerWorkingCopy(getServer());

		}

	}

		// Fire the property change event. 

		List<ServerCreationWizardPageExtension> pageExtensionLst = ServerUIPlugin.getServerCreationWizardPageExtensions();

		for (ServerCreationWizardPageExtension curPageExtension : pageExtensionLst) {

			curPageExtension.handlePropertyChanged(new PropertyChangeEvent(this, AbstractUIControl.PROP_SERVER_TYPE, oldServerType, serverType));

		}

		// Update the old server type value.

		oldServerType = serverType;

	public void handleUIControlMapChanged(Map<String, UIControlEntry> controlMap) {

		if (controlMap == null) {

			return;

		}

		for (String curControlId : controlMap.keySet()) {

			if (AbstractUIControl.PROP_HOSTNAME.equals(curControlId)) {

				UIControlEntry curControlEntry = controlMap.get(curControlId);

				if (hostnameLabel != null) {

					hostnameLabel.setEnabled(curControlEntry.isEnabled());

				}

				if (hostname != null){

					if (curControlEntry.getNewTextValue() != null) {

						hostname.setText(curControlEntry.getNewTextValue());

					}

					hostname.setEnabled(curControlEntry.isEnabled());

				}

			}

		}

  }

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

 * Copyright (c) 2009 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.wst.server.ui;

import java.beans.PropertyChangeEvent;

import java.util.HashMap;

import java.util.Map;

/**

 * The Abstract UI control that allows adopter to control the UI from other provider.

 * AbstractUIControl

 */

public abstract class AbstractUIControl {

	// Control map describing the UI that needs to be controlled. 

	public Map<String, UIControlEntry> controlMap = new HashMap<String, UIControlEntry>();

	// UI Control listener that listens to changes in event on GUI provided by this UI control

	public IUIControlListener controlListener;

	// The list of properties supported by the existing UI control.

	public static final String PROP_HOSTNAME = "PROP_HOSTNAME";

	public static final String PROP_SERVER_TYPE = "PROP_SERVERTYPE";

	/**

	 * UI Control listener that listens to changes in event on GUI provided by this UI control

	 * IUIControlListener

	 */

	public interface IUIControlListener {

		/**

		 * Handle the UI control map change by the listener based on the given control map.

		 * @param controlMap the control map that describes the UI control.

		 */

		public void handleUIControlMapChanged(Map<String, UIControlEntry> controlMap);

		/**

		 * Get the value of a given control UI on the listener's page.

		 * @param controlId control ID of the UI on the listener's page.

		 * @return the String value of the given control ID field.

		 */

		public String getControlStringValue(String controlId);

	}

	/**

	 * UI control entry class that describes the behaviour of the UI control of specific fields or widget.

	 * UIControlEntry

	 */

	public class UIControlEntry {

		private boolean isEnabled;

		private String newTextValue;

		public UIControlEntry(boolean curIsEnabled, String curNewTextValue) {

			isEnabled = curIsEnabled;

			newTextValue = curNewTextValue;

		}

		/**

		 * Gives the new text value of the given field.

		 * @return the new text value of the given field. If the value returns <code>null</code>, then it means

		 * the field do not need to be modified.

		 */

		public String getNewTextValue() {

    	return newTextValue;

    }

		/**

		 * Return if the UI control needs to be enabled.

		 * @return true if value needs to be enabled; otherwise, return false.

		 */

		public boolean isEnabled() {

    	return isEnabled;

    }

	}

	/**

	 * Fire the control change event for the changed control map to take effect.

	 */

	protected void fireUIControlChangedEvent() {

		if (controlListener != null) {

			controlListener.handleUIControlMapChanged(controlMap);

		}

	}

	/**

	 * Allow UI Control to react based on a property change and change the UI control.

	 * @param event property change event that describes the change.

	 */

	public abstract void handlePropertyChanged(PropertyChangeEvent event);

	/**

	 * Set the UI control listener that listens to the changes initialed by this UI control. 

	 * @param curControlListener the UI control listener

	 */

	public void setUIControlListener(IUIControlListener curControlListener) {

		controlListener = curControlListener;

	}

}

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

 * Copyright (c) 2009 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.wst.server.ui.wizard;

import org.eclipse.swt.widgets.Composite;

import org.eclipse.wst.server.core.IServerWorkingCopy;

import org.eclipse.wst.server.ui.AbstractUIControl;

/**

 * A modifier class that allow adopter to modify the behaviour of the server creation wizard page.

 * It also has places where adopter can inject custom GUI into the server creation wizard page.

 * ServerCreationWizardPageExtension

 */

public abstract class ServerCreationWizardPageExtension extends AbstractUIControl {

	protected IServerWorkingCopy serverWc = null;

	/**

	 * The list of position on the server creation wizard page that allows inserting custom GUI.

	 * UI_POSITION

	 */

	public enum UI_POSITION { TOP, MIDDLE, BOTTOM }

	/**

	 * Create the customer UI on the specified position.

	 * @param position the position on the server creation wizard page that allows inserting custom GUI.

	 * @param parent parent composite.

	 */

	public abstract void createControl(UI_POSITION position, Composite parent);

	/**

	 * Set the server working copy to the control to allow extension to store the extension values.

	 * @param curServerWc

	 */

	public void setServerWorkingCopy(IServerWorkingCopy curServerWc) {

		serverWc = curServerWc;

	}

}

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

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

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

<annotation>

      <appinfo>

         <meta.schema plugin="org.eclipse.wst.server.ui" id="serverCreationWizardPageExtension" name="Server Creation Wizard Page Extension"/>

      </appinfo>

      <documentation>

         This extension point provides a way to for adopters to modify the first page of the server creation wizard page.  It provides mechanisms to add custom UI to different sections of the server creation wizard page.  It also allow adopter to control the display of some existing UI on the server creation wizard page.

      </documentation>

   </annotation>

   <element name="extension">

      <annotation>

         <appinfo>

            <meta.element />

         </appinfo>

      </annotation>

      <complexType>

         <sequence>

            <element ref="serverCreationWizardPageExtension"/>

         </sequence>

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

            <annotation>

               <documentation>

                  a fully qualified identifier of the target extension point

               </documentation>

            </annotation>

         </attribute>

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

            <annotation>

               <documentation>

                  an optional identifier of the extension instance

               </documentation>

            </annotation>

         </attribute>

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

            <annotation>

               <documentation>

                  an optional name of the extension instance

               </documentation>

            </annotation>

         </attribute>

      </complexType>

   </element>

   <element name="serverCreationWizardPageExtension">

      <annotation>

         <appinfo>

            <meta.element labelAttribute="name"/>

         </appinfo>

      </annotation>

      <complexType>

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

            <annotation>

               <documentation>

                  specifies a unique identifier for this extension point

               </documentation>

            </annotation>

         </attribute>

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

            <annotation>

               <documentation>

                  specifies the fully qualified name of the Java class that extends <samp>org.eclipse.wst.server.ui.editor.ServerCreationWizardPageExtension</samp>. The class must have a public 0-arg constructor.

               </documentation>

               <appinfo>

                  <meta.attribute kind="java"/>

               </appinfo>

            </annotation>

         </attribute>

      </complexType>

   </element>

   <annotation>

      <appinfo>

         <meta.section type="since"/>

      </appinfo>

      <documentation>

         <b>This extension point is part of an interim API that is still under development and expected to change significantly before reaching stability. It is being made available at this early stage to solicit feedback from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken (repeatedly) as the API evolves.</b>

      </documentation>

   </annotation>

   <annotation>

      <appinfo>

         <meta.section type="examples"/>

      </appinfo>

      <documentation>

         3.2

      </documentation>

   </annotation>

   <annotation>

      <appinfo>

         <meta.section type="implementation"/>

      </appinfo>

      <documentation>

         The following is an example of the extension point:

<pre>

   <extension

         point="org.eclipse.wst.server.ui.serverCreationWizardPageExtension">

      <serverCreationWizardPageExtension

            id="org.eclipse.wst.server.ui.test.serverCreationWizardPageExtension"

                        class="org.eclipse.wst.server.ui.test.internal.serverCreationWizardPageExtension.ServerCreationWizardPageExtensionTest"/>

   </extension>

</pre>

      </documentation>

   </annotation>

   <annotation>

      <appinfo>

         <meta.section type="copyright"/>

      </appinfo>

      <documentation>

         Copyright (c) 2009 IBM Corporation and others.<br>

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 

<a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>

      </documentation>

   </annotation>

   <annotation>

      <appinfo>

         <meta.section type="apiInfo"/>

      </appinfo>

      <documentation>

         Value of the attribute <b>class</b> must be a fully qualified name of a Java class that extends <code>org.eclipse.wst.server.ui.editor.ServerCreationWizardPageExtension</code>.

This extension point currently only supports the control on the following fields on the implementation of org.eclipse.wst.server.ui.AbstractUIControl.IUIControlListener.handleUIControlMapChanged(Map<String, UIControlEntry>):

Server's host name

This extension point currently only issue property change event on the following property change:

Server type selection change

      </documentation>

   </annotation>

</schema>