/* * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ package org.apache.tuscany.sca.extensibility.equinox; import java.io.BufferedReader; import java.io.IOException; import java.io.InputStream; import java.io.InputStreamReader; import java.net.URL; import java.security.AccessController; import java.security.PrivilegedAction; import java.security.PrivilegedActionException; import java.security.PrivilegedExceptionAction; import java.util.Collection; import java.util.Enumeration; import java.util.HashMap; import java.util.HashSet; import java.util.Map; import java.util.Properties; import java.util.Set; import java.util.StringTokenizer; import java.util.logging.Level; import java.util.logging.Logger; import org.apache.tuscany.sca.extensibility.ServiceDeclaration; import org.apache.tuscany.sca.extensibility.ServiceDiscoverer; import org.osgi.framework.Bundle; import org.osgi.framework.BundleContext; import org.osgi.framework.BundleException; import org.osgi.framework.Constants; /** * A ServiceDiscoverer that find META-INF/services/... in installed bundles * * @version $Rev$ $Date$ */ public class EquinoxServiceDiscoverer implements ServiceDiscoverer { private static final Logger logger = Logger.getLogger(EquinoxServiceDiscoverer.class.getName()); private BundleContext context; public EquinoxServiceDiscoverer(BundleContext context) { this.context = context; } public static class ServiceDeclarationImpl implements ServiceDeclaration { private Bundle bundle; private URL url; private String className; private Class javaClass; private Map attributes; public ServiceDeclarationImpl(Bundle bundle, URL url, String className, Map attributes) { super(); this.bundle = bundle; this.url = url; this.className = className; this.attributes = attributes; } public Map getAttributes() { return attributes; } public String getClassName() { return className; } public Class loadClass() throws ClassNotFoundException { if (className == null) { return null; } if (javaClass == null) { javaClass = loadClass(className); } return javaClass; } public Class loadClass(String className) throws ClassNotFoundException { return bundle.loadClass(className); } public URL getLocation() { return url; } public URL getResource(final String name) { return AccessController.doPrivileged(new PrivilegedAction() { public URL run() { return bundle.getResource(name); } }); } @Override public String toString() { StringBuffer sb = new StringBuffer(); sb.append("Bundle: ").append(EquinoxServiceDiscoverer.toString(bundle)); sb.append(" Resource: ").append(url); sb.append(" Attributes: ").append(attributes); return sb.toString(); } public Bundle getBundle() { return bundle; } } /** * Empty static method to trigger the activation of this bundle. */ public static void init() { } private static String toString(Bundle b) { StringBuffer sb = new StringBuffer(); sb.append(b.getBundleId()).append(" ").append(b.getSymbolicName()); int s = b.getState(); if ((s & Bundle.UNINSTALLED) != 0) { sb.append(" UNINSTALLED"); } if ((s & Bundle.INSTALLED) != 0) { sb.append(" INSTALLED"); } if ((s & Bundle.RESOLVED) != 0) { sb.append(" RESOLVED"); } if ((s & Bundle.STARTING) != 0) { sb.append(" STARTING"); } if ((s & Bundle.STOPPING) != 0) { sb.append(" STOPPING"); } if ((s & Bundle.ACTIVE) != 0) { sb.append(" ACTIVE"); } return sb.toString(); } /** * Parse a service declaration in the form class;attr=value,attr=value and * return a map of attributes * * @param declaration * @return a map of attributes */ private static Map parseServiceDeclaration(String declaration) { Map attributes = new HashMap(); int index = declaration.indexOf(';'); if (index != -1) { attributes.put("class", declaration.substring(0, index).trim()); declaration = declaration.substring(index); } else { int j = declaration.indexOf('='); if (j == -1) { attributes.put("class", declaration.trim()); return attributes; } else { declaration = ";" + declaration; } } StringTokenizer tokens = new StringTokenizer(declaration); for (; tokens.hasMoreTokens();) { String key = tokens.nextToken("=").substring(1).trim(); if (key == null) break; String value = tokens.nextToken(",").substring(1).trim(); if (value == null) break; attributes.put(key, value); } return attributes; } public ServiceDeclaration getServiceDeclaration(String name) throws IOException { Collection declarations = getServiceDeclarations(name); if (declarations.isEmpty()) { return null; } else { return declarations.iterator().next(); } } public Collection getServiceDeclarations(String serviceName) throws IOException { boolean debug = logger.isLoggable(Level.FINE); Collection descriptors = new HashSet(); // http://java.sun.com/j2se/1.5.0/docs/api/javax/xml/xpath/XPathFactory.html boolean isPropertyFile = "javax.xml.xpath.XPathFactory".equals(serviceName); serviceName = "META-INF/services/" + serviceName; Set visited = new HashSet(); for (Bundle bundle : context.getBundles()) { if (bundle.getBundleId() == 0 || bundle.getHeaders().get(Constants.FRAGMENT_HOST) != null) { // Skip system bundle as it has access to the application classloader // Skip bundle fragments too continue; } Enumeration urls = null; try { // Use getResources to find resources on the classpath of the bundle // Please note there are cases that getResources will return null even // the bundle containing such entries: // 1. There is a match on Import-Package or DynamicImport-Package, and another // bundle exports the resource package, there is a possiblity that it doesn't // find the containing entry // 2. The bundle cannot be resolved, then getResources will return null urls = bundle.getResources(serviceName); if (urls == null) { URL entry = bundle.getEntry(serviceName); if (entry != null) { logger.warning("Unresolved resource " + serviceName + " found in " + toString(bundle)); try { bundle.start(); } catch (BundleException e) { logger.log(Level.SEVERE, e.getMessage(), e); } // urls = Collections.enumeration(Arrays.asList(entry)); } } } catch (IOException e) { logger.log(Level.SEVERE, e.getMessage(), e); } if (urls == null) { continue; } while (urls.hasMoreElements()) { final URL url = urls.nextElement(); if (!visited.add(url)) { // The URL has already been processed continue; } if (debug) { logger.fine("Reading service provider file: " + url.toExternalForm()); } try { // Allow privileged access to open URL stream. Add FilePermission to added to security // policy file. InputStream is; try { is = AccessController.doPrivileged(new PrivilegedExceptionAction() { public InputStream run() throws IOException { return url.openStream(); } }); } catch (PrivilegedActionException e) { throw (IOException)e.getException(); } if (isPropertyFile) { // Load as a property file Properties props = new Properties(); props.load(is); is.close(); for (Map.Entry e : props.entrySet()) { Map attributes = new HashMap(); String key = (String)e.getKey(); String value = (String)e.getValue(); // Unfortunately, the xalan file only has the classname if ("".equals(value)) { value = key; key = ""; } if (!"".equals(key)) { attributes.put(key, value); attributes.put("uri", key); } attributes.put("class", value); ServiceDeclarationImpl descriptor = new ServiceDeclarationImpl(bundle, url, value, attributes); descriptors.add(descriptor); } continue; } BufferedReader reader = null; try { reader = new BufferedReader(new InputStreamReader(is)); int count = 0; while (true) { String line = reader.readLine(); if (line == null) break; line = line.trim(); if (!line.startsWith("#") && !"".equals(line)) { String reg = line.trim(); if (debug) { logger.fine("Registering service provider: " + reg); } Map attributes = parseServiceDeclaration(reg); String className = attributes.get("class"); if (className == null) { // Add a unique class name to prevent equals() from returning true className = "_class_" + count; count++; } ServiceDeclarationImpl descriptor = new ServiceDeclarationImpl(bundle, url, className, attributes); descriptors.add(descriptor); } } } finally { if (reader != null) { try { reader.close(); } catch (IOException e) { // Ignore } } } } catch (IOException e) { logger.log(Level.SEVERE, e.getMessage(), e); } } } return descriptors; } }