bundles/org.eclipse.wst.ws/src/org/eclipse/wst/ws/internal/wsfinder/WebServiceFinder.java

/*******************************************************************************
 * Copyright (c) 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
 * http://www.eclipse.org/legal/epl-v10.html
 * 
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/

package org.eclipse.wst.ws.internal.wsfinder;

import java.util.Iterator;
import java.util.List;
import java.util.Vector;
import org.eclipse.core.runtime.CoreException;
import org.eclipse.core.runtime.IConfigurationElement;

/**
 * @author joan
 *
 * WebServiceFinder is a singleton which finds all extenders and returns a comprehensive list of WebServiceInfo objects.
 * Finds web services by calling locators extending {@link org.eclipse.wst.ws.internal.wsfinder.AbstractWebServiceLocator} 
 * which have been registered with {@link org.eclipse.wst.ws.internal.wsfinder.WebServiceLocatorRegistry}.
 */

public class WebServiceFinder {
	
	private static WebServiceFinder instance = null;
	
	private static final String CLASS_ATTRIBUTE= "class"; //$NON-NLS-1$
		
	public WebServiceFinder()	
	{
		super();
	}
	
	public static WebServiceFinder instance()
	{
		if (instance == null)
		{
			instance = new WebServiceFinder();
		}
		return instance;
	}
		
	/**
	 * Returns an iterator of WebServiceInfo objects which represent web services found by locators that
	 * have registered using the org.eclipse.wst.ws.locator extension point.  Currently returns all web 
	 * services found for all registered locators.  Locators must extend {@link AbstractWebServiceLocator}.
	 * 
	 * Callers can use the getter methods on the WebServiceInfo object to retrieve information on the 
	 * web services found.  The WebServiceFinder cannot guarantee the level of detail contained in WebServiceInfo
	 * objects returned.  This is left to the locator implementations.
	 *  
	 * @return iterator of WebServiceInfo objects
	 */
	public Iterator getWebServices()
	{
		Vector webServices = new Vector();

		WebServiceLocatorRegistry wslr = WebServiceLocatorRegistry.getInstance();

		IConfigurationElement[] regElements = wslr.getConfigElements();
		for (int i = 0; i < regElements.length; i++) {
			try{
			    Object obj = regElements[i].createExecutableExtension(CLASS_ATTRIBUTE);
			    
			    if (obj instanceof IWebServiceLocator)
			    {
			    	IWebServiceLocator wsl = (IWebServiceLocator)obj;
			    	List wsList = wsl.getWebServices();
			    	webServices.addAll(wsList);
			     }				
			} 
			catch (CoreException ex){
				
			}		
		} 
		return webServices.iterator();	
	} 
	
}