1 /* 2 * Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package javax.xml.soap; 27 28 import java.util.ServiceLoader; 29 import java.util.logging.Level; 30 import java.util.logging.Logger; 31 32 /** 33 * Shared ServiceLoader/FactoryFinder Utils shared among SAAJ, JAXB and JAXWS 34 * Class duplicated to all those projects. 35 * 36 * @author Miroslav.Kos@oracle.com 37 */ 38 class ServiceLoaderUtil { 39 40 static <P, T extends Exception> P firstByServiceLoader(Class<P> spiClass, 41 Logger logger, 42 ExceptionHandler<T> handler) throws T { 43 logger.log(Level.FINE, "Using java.util.ServiceLoader to find {0}", spiClass.getName()); 44 // service discovery 45 try { 46 ServiceLoader<P> serviceLoader = ServiceLoader.load(spiClass); 47 48 for (P impl : serviceLoader) { 49 logger.fine("ServiceProvider loading Facility used; returning object [" + 50 impl.getClass().getName() + "]"); 51 52 return impl; 53 } 54 } catch (Throwable t) { 55 throw handler.createException(t, "Error while searching for service [" + spiClass.getName() + "]"); 56 } 57 return null; 58 } 59 60 static void checkPackageAccess(String className) { 61 // make sure that the current thread has an access to the package of the given name. 62 SecurityManager s = System.getSecurityManager(); 63 if (s != null) { 64 int i = className.lastIndexOf('.'); 65 if (i != -1) { 66 s.checkPackageAccess(className.substring(0, i)); 67 } 68 } 69 } 70 71 static Class nullSafeLoadClass(String className, ClassLoader classLoader) throws ClassNotFoundException { 72 if (classLoader == null) { 73 return Class.forName(className); 74 } else { 75 return classLoader.loadClass(className); 76 } 77 } 78 79 // Returns instance of required class. It checks package access (security) 80 // unless it is defaultClassname. It means if you are trying to instantiate 81 // default implementation (fallback), pass the class name to both first and second parameter. 82 static <T extends Exception> Object newInstance(String className, 83 String defaultImplClassName, ClassLoader classLoader, 84 final ExceptionHandler<T> handler) throws T { 85 try { 86 return safeLoadClass(className, defaultImplClassName, classLoader).newInstance(); 87 } catch (ClassNotFoundException x) { 88 throw handler.createException(x, "Provider " + className + " not found"); 89 } catch (Exception x) { 90 throw handler.createException(x, "Provider " + className + " could not be instantiated: " + x); 91 } 92 } 93 94 static Class safeLoadClass(String className, 95 String defaultImplClassName, 96 ClassLoader classLoader) throws ClassNotFoundException { 97 98 try { 99 checkPackageAccess(className); 100 } catch (SecurityException se) { 101 // anyone can access the platform default factory class without permission 102 if (defaultImplClassName != null && defaultImplClassName.equals(className)) { 103 return Class.forName(className); 104 } 105 // not platform default implementation ... 106 throw se; 107 } 108 return nullSafeLoadClass(className, classLoader); 109 } 110 111 static <T extends Exception> ClassLoader contextClassLoader(ExceptionHandler<T> exceptionHandler) throws T { 112 try { 113 return Thread.currentThread().getContextClassLoader(); 114 } catch (Exception x) { 115 throw exceptionHandler.createException(x, x.toString()); 116 } 117 } 118 119 static abstract class ExceptionHandler<T extends Exception> { 120 121 public abstract T createException(Throwable throwable, String message); 122 123 } 124 125 }