<extension-point id="statAgentInterfaceExtensions" name="Statistical Agents Interface Extensions" schema="schema/statAgentInterfaceExtensions.exsd"/>

import java.net.MalformedURLException;

import java.net.URL;

import org.eclipse.hyades.ui.HyadesUIPlugin;

import org.eclipse.jface.resource.ImageDescriptor;

import org.osgi.framework.Bundle;

	}

	/**

	 * Returns an ImageDescriptor whose path relative to the plugin described 

	 * by <code>pluginDescriptor</code> is <code>subdirectoryAndFilename</code>.

	 * Returns <code>null</code>if no image could be found.

	 *

	 * <p>This method is convenience and only intended for use by the workbench 

	 * because it explicitly uses the workbench's registry for caching/retrieving 

	 * images from other extensions -- other plugins must user their own registry. 

	 * This convenience method is subject to removal.

	 *

	 * <p>Note: subdirectoryAndFilename must not have any leading "." or path 

	 * separators / or \ ISV's should use icons/mysample.gif and not 

	 * ./icons/mysample.gif.

	 *

	 * <p>Note:  This consults the plugin for extension and obtains its installation 

	 * location.  All requested images are assumed to be in a directory below and 

	 * relative to that plugins installation directory.

	 */

	public static ImageDescriptor getImageDescriptorFromPlugin(Bundle pluginBundle, String subdirectoryAndFilename)

	{

		URL path = pluginBundle.getEntry("/");

		URL fullPathString = null;

		try

		{

			fullPathString = new URL(path,subdirectoryAndFilename);

			return ImageDescriptor.createFromURL(fullPathString);

		}

		catch (MalformedURLException e)

		{

			HyadesUIPlugin.logError(e);

		}

		return null;

import org.eclipse.core.runtime.Status;

import org.eclipse.hyades.ui.HyadesUIPlugin;

	public static final String PLUGIN_ID = "org.eclipse.hyades.perfmon"; //$NON-NLS-1$	

	public static String EP_STATISTICAL_AGENTS_GUI = "statAgentInterfaceExtensions";

	/**

	 * Returns the instance of this class created by the eclipse framework.

	 * @return PermonPlugin

	 */

	public static PerfmonPlugin getInstance()

	{

		return plugin;

	}

	/**

	 * Logs an error described by a throwable.

	 * 

	 * <p>This method should be used whenever a class in this plugin

	 * has to log an error since it adheres to the global logging

	 * strategy.

	 * 

	 * @param throwable

	 */

	public static void logError(Throwable throwable)

	{

		Status status = new Status(1, getID(), 0, throwable.toString(), throwable);

		getInstance().getLog().log(status);

	}

	/**

	 * Logs an error described by a text.

	 * 

	 * <p>This method should be whenever a class in this plugin

	 * has to log an error since it adheres to the global logging

	 * strategy.

	 * 

	 * @param text

	 */

	public static void logError(String text)

	{

		logError(new Throwable(text));

	}    

	/**

	 * Returns this plugin's id.

	 * @return String

	 */

	public static String getID()

	{

		return PLUGIN_ID;

	}	

	private StatisticalAgentTabGroup group;

        this.group = group;

import java.util.List;

import org.eclipse.core.runtime.IConfigurationElement;

import org.eclipse.core.runtime.IExtension;

import org.eclipse.core.runtime.Platform;

    private static AgentInterface[] agents  = null;

    private static String[] agentNames  = null;   

    private static Image[] agentImages = null;    

    public void loadStatAgentInterfaceList() {  	

    		IExtension[] exts = Platform.getExtensionRegistry().getExtensionPoint(PerfmonPlugin.getID(), PerfmonPlugin.EP_STATISTICAL_AGENTS_GUI).getExtensions();

    		List agentList = new ArrayList();

    		List agentNamesList = new ArrayList();    		

    		List agentIconsList = new ArrayList();     		

			ImageRegistry reg = PerfmonPlugin.getInstance().getImageRegistry();    		

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

    			IConfigurationElement[] elements = exts[i].getConfigurationElements();

    			for (int j=0;j<elements.length;++j) {

    				if ("statAgentInterfaceContribution".equals(elements[j].getName())) {

    					//String id = elements[j].getAttribute("id");

    						try {

    							String className = elements[j].getAttribute("class");

    							String name = elements[j].getAttribute("name");

    							String iconKey = elements[j].getAttribute("icon");    							

    							Class classObj = Platform.getBundle(exts[i].getNamespace()).loadClass(className);

    							agentList.add(classObj.newInstance());

    							agentNamesList.add(name);

    							Image icon = null;

    							if (iconKey == null)

    								icon = PerfmonPlugin.img.getImage(ImageManager.IMG_PERFMON_SERVER);

    							else {

    							icon = reg.get(iconKey);

    							if (icon == null){

    								ImageDescriptor imageDescriptor = ImageManager.getImageDescriptorFromPlugin(Platform.getBundle(elements[j].getDeclaringExtension().getNamespace()), iconKey);

    								if(imageDescriptor != null)

    									reg.put(iconKey, imageDescriptor);

        							icon = reg.get(iconKey);

    							}

    							}

    							agentIconsList.add(icon);

    						}

    						catch (Exception e) {

    							PerfmonPlugin.logError(e);

    						}

    				}

    			}

    		}

    		agents = new AgentInterface[agentList.size()];    		

    		agentList.toArray(agents);

    		agentNames = new String[agentList.size()];

    		agentNamesList.toArray(agentNames);

    		agentImages = new Image[agentList.size()];

    		agentIconsList.toArray(agentImages);

    	}   	

	public String[] getAgentNames() {

		return agentNames;

	}

	public AgentInterface[] getAgents() {

		if (agents == null) loadStatAgentInterfaceList();

		return agents;

	}

	public Image getAgentImage(int i) {

		return agentImages[i];

	}

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

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

<schema targetNamespace="org.eclipse.hyades.ui">

<annotation>

      <appInfo>

         <meta.schema plugin="org.eclipse.hyades.ui" id="analyzerExtensions" name="Hyades Analyzer Extensions"/>

      </appInfo>

      <documentation>

         This extension point is used to register TPTP Statistical Agent User Interface extensions.

      </documentation>

   </annotation>

   <element name="extension">

      <complexType>

         <sequence>

            <element ref="statAgentInterfaceContribution" minOccurs="0" maxOccurs="unbounded"/>

         </sequence>

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

            <annotation>

               <documentation>

                  a fully qualified identifier of the target extension point

               </documentation>

            </annotation>

         </attribute>

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

            <annotation>

               <documentation>

                  an optional name of the extension instance

               </documentation>

            </annotation>

         </attribute>

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

            <annotation>

               <documentation>

                  an optional identifier of the extension instance

               </documentation>

            </annotation>

         </attribute>

      </complexType>

   </element>

   <element name="statAgentInterfaceContribution">

      <annotation>

         <appInfo>

            <meta.element labelAttribute="name"/>

         </appInfo>

      </annotation>

      <complexType>

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

            <annotation>

               <documentation>

                  a unique name that will be used to identify this TPTP Statistical Agent User Interface extension

               </documentation>

            </annotation>

         </attribute>

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

            <annotation>

               <documentation>

                  a translatable name that will be used in the UI for this Hyades analyzer extension

               </documentation>

            </annotation>

         </attribute>

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

            <annotation>

               <documentation>

                  a name of the class that implements <samp>org.eclipse.hyades.perfmon.common.internal.launch.AgentInterface</samp>.

               </documentation>

               <appInfo>

                  <meta.attribute kind="java" basedOn="org.eclipse.hyades.perfmon.common.internal.launch.AgentInterface"/>

               </appInfo>

            </annotation>

         </attribute>

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

            <annotation>

               <documentation>

                  identifies the category of objects that this extension point is associated with.  A good example would be the one of the supported Hyades types, such as trace or test.

               </documentation>

            </annotation>

         </attribute>

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

            <annotation>

               <documentation>

                  a relative name of the icon that will be used to describe this TPTP Statistical Agent User Interface extension.

               </documentation>

               <appInfo>

                  <meta.attribute kind="resource"/>

               </appInfo>

            </annotation>

         </attribute>

      </complexType>

   </element>

   <annotation>

      <appInfo>

         <meta.section type="since"/>

      </appInfo>

      <documentation>

         0.0.1

      </documentation>

   </annotation>

   <annotation>

      <appInfo>

         <meta.section type="examples"/>

      </appInfo>

      <documentation>

         <pre>

      <extension

            point="org.eclipse.hyades.perfmon.statAgentInterfaceExtensions">

         <statAgentInterfaceContribution

class="org.eclipse.hyades.perfmon.linux.internal.launchconfig.LinuxTabInterface"    extension="org.eclipse.hyades.perfmon.linux.internal.launchconfig.LinuxTabInterface"

id="org.eclipse.hyades.perfmon.linux.internal.launchconfig.LinuxTabInterface"

name="%LINUX_UI_AGENT_NAME"

icon="icons/full/obj16/host_obj.gif"/>

      </extension>  

</pre>

      </documentation>

   </annotation>

   <annotation>

      <appInfo>

         <meta.section type="apiInfo"/>

      </appInfo>

      <documentation>

         All TPTP Statistical Agent User Interface' classes are instances of <samp>org.eclipse.hyades.perfmon.common.internal.launch.AgentInterface</samp>.

      </documentation>

   </annotation>

   <annotation>

      <appInfo>

         <meta.section type="implementation"/>

      </appInfo>

      <documentation>

         The TPTP framework itself has a number of pre-defined analyzer extensions. Particular product installs may include additional analyzer extensions as required.

      </documentation>

   </annotation>

   <annotation>

      <appInfo>

         <meta.section type="copyright"/>

      </appInfo>

      <documentation>

         Copyright (c) 2003, 2005 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 <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>

      </documentation>

   </annotation>

</schema>