Java tutorial
/******************************************************************************* * Copyright (c) 2015 The Board of Trustees of the Leland Stanford Junior University * BY CLICKING ON "ACCEPT," DOWNLOADING, OR OTHERWISE USING EPAD, YOU AGREE TO THE FOLLOWING TERMS AND CONDITIONS: * STANFORD ACADEMIC SOFTWARE SOURCE CODE LICENSE FOR * "ePAD Annotation Platform for Radiology Images" * * This Agreement covers contributions to and downloads from the ePAD project ("ePAD") maintained by The Board of Trustees * of the Leland Stanford Junior University ("Stanford"). * * * Part A applies to downloads of ePAD source code and/or data from ePAD. * * * Part B applies to contributions of software and/or data to ePAD (including making revisions of or additions to code * and/or data already in ePAD), which may include source or object code. * * Your download, copying, modifying, displaying, distributing or use of any ePAD software and/or data from ePAD * (collectively, the "Software") is subject to Part A. Your contribution of software and/or data to ePAD (including any * that occurred prior to the first publication of this Agreement) is a "Contribution" subject to Part B. Both Parts A and * B shall be governed by and construed in accordance with the laws of the State of California without regard to principles * of conflicts of law. Any legal action involving this Agreement or the Research Program will be adjudicated in the State * of California. This Agreement shall supersede and replace any license terms that you may have agreed to previously with * respect to ePAD. * * PART A. DOWNLOADING AGREEMENT - LICENSE FROM STANFORD WITH RIGHT TO SUBLICENSE ("SOFTWARE LICENSE"). * 1. As used in this Software License, "you" means the individual downloading and/or using, reproducing, modifying, * displaying and/or distributing Software and the institution or entity which employs or is otherwise affiliated with you. * Stanford hereby grants you, with right to sublicense, with respect to Stanford's rights in the Software, a * royalty-free, non-exclusive license to use, reproduce, make derivative works of, display and distribute the Software, * provided that: (a) you adhere to all of the terms and conditions of this Software License; (b) in connection with any * copy, distribution of, or sublicense of all or any portion of the Software, the terms and conditions in this Software * License shall appear in and shall apply to such copy and such sublicense, including without limitation all source and * executable forms and on any user documentation, prefaced with the following words: "All or portions of this licensed * product have been obtained under license from The Board of Trustees of the Leland Stanford Junior University. and are * subject to the following terms and conditions" AND any user interface to the Software or the "About" information display * in the Software will display the following: "Powered by ePAD http://epad.stanford.edu;" (c) you preserve and maintain * all applicable attributions, copyright notices and licenses included in or applicable to the Software; (d) modified * versions of the Software must be clearly identified and marked as such, and must not be misrepresented as being the * original Software; and (e) you consider making, but are under no obligation to make, the source code of any of your * modifications to the Software freely available to others on an open source basis. * * 2. The license granted in this Software License includes without limitation the right to (i) incorporate the Software * into your proprietary programs (subject to any restrictions applicable to such programs), (ii) add your own copyright * statement to your modifications of the Software, and (iii) provide additional or different license terms and conditions * in your sublicenses of modifications of the Software; provided that in each case your use, reproduction or distribution * of such modifications otherwise complies with the conditions stated in this Software License. * 3. This Software License does not grant any rights with respect to third party software, except those rights that * Stanford has been authorized by a third party to grant to you, and accordingly you are solely responsible for (i) * obtaining any permissions from third parties that you need to use, reproduce, make derivative works of, display and * distribute the Software, and (ii) informing your sublicensees, including without limitation your end-users, of their * obligations to secure any such required permissions. * 4. You agree that you will use the Software in compliance with all applicable laws, policies and regulations including, * but not limited to, those applicable to Personal Health Information ("PHI") and subject to the Institutional Review * Board requirements of the your institution, if applicable. Licensee acknowledges and agrees that the Software is not * FDA-approved, is intended only for research, and may not be used for clinical treatment purposes. Any commercialization * of the Software is at the sole risk of you and the party or parties engaged in such commercialization. You further agree * to use, reproduce, make derivative works of, display and distribute the Software in compliance with all applicable * governmental laws, regulations and orders, including without limitation those relating to export and import control. * 5. You or your institution, as applicable, will indemnify, hold harmless, and defend Stanford against any third party * claim of any kind made against Stanford arising out of or related to the exercise of any rights granted under this * Agreement, the provision of Software, or the breach of this Agreement. Stanford provides the Software AS IS and WITH ALL * FAULTS. Stanford makes no representations and extends no warranties of any kind, either express or implied. Among * other things, Stanford disclaims any express or implied warranty in the Software: * (a) of merchantability, of fitness for a particular purpose, * (b) of non-infringement or * (c) arising out of any course of dealing. * * Title and copyright to the Program and any associated documentation shall at all times remain with Stanford, and * Licensee agrees to preserve same. Stanford reserves the right to license the Program at any time for a fee. * 6. None of the names, logos or trademarks of Stanford or any of Stanford's affiliates or any of the Contributors, or any * funding agency, may be used to endorse or promote products produced in whole or in part by operation of the Software or * derived from or based on the Software without specific prior written permission from the applicable party. * 7. Any use, reproduction or distribution of the Software which is not in accordance with this Software License shall * automatically revoke all rights granted to you under this Software License and render Paragraphs 1 and 2 of this * Software License null and void. * 8. This Software License does not grant any rights in or to any intellectual property owned by Stanford or any * Contributor except those rights expressly granted hereunder. * * PART B. CONTRIBUTION AGREEMENT - LICENSE TO STANFORD WITH RIGHT TO SUBLICENSE ("CONTRIBUTION AGREEMENT"). * 1. As used in this Contribution Agreement, "you" means an individual providing a Contribution to ePAD and the * institution or entity which employs or is otherwise affiliated with you. * 2. This Contribution Agreement applies to all Contributions made to ePAD at any time. By making a Contribution you * represent that: (i) you are legally authorized and entitled by ownership or license to make such Contribution and to * grant all licenses granted in this Contribution Agreement with respect to such Contribution; (ii) if your Contribution * includes any patient data, all such data is de-identified in accordance with U.S. confidentiality and security laws and * requirements, including but not limited to the Health Insurance Portability and Accountability Act (HIPAA) and its * regulations, and your disclosure of such data for the purposes contemplated by this Agreement is properly authorized and * in compliance with all applicable laws and regulations; and (iii) you have preserved in the Contribution all applicable * attributions, copyright notices and licenses for any third party software or data included in the Contribution. * 3. Except for the licenses you grant in this Agreement, you reserve all right, title and interest in your Contribution. * 4. You hereby grant to Stanford, with the right to sublicense, a perpetual, worldwide, non-exclusive, no charge, * royalty-free, irrevocable license to use, reproduce, make derivative works of, display and distribute the Contribution. * If your Contribution is protected by patent, you hereby grant to Stanford, with the right to sublicense, a perpetual, * worldwide, non-exclusive, no-charge, royalty-free, irrevocable license under your interest in patent rights embodied in * the Contribution, to make, have made, use, sell and otherwise transfer your Contribution, alone or in combination with * ePAD or otherwise. * 5. You acknowledge and agree that Stanford ham may incorporate your Contribution into ePAD and may make your * Contribution as incorporated available to members of the public on an open source basis under terms substantially in * accordance with the Software License set forth in Part A of this Agreement. You further acknowledge and agree that * Stanford shall have no liability arising in connection with claims resulting from your breach of any of the terms of * this Agreement. * 6. YOU WARRANT THAT TO THE BEST OF YOUR KNOWLEDGE YOUR CONTRIBUTION DOES NOT CONTAIN ANY CODE OBTAINED BY YOU UNDER AN * OPEN SOURCE LICENSE THAT REQUIRES OR PRESCRIBES DISTRBUTION OF DERIVATIVE WORKS UNDER SUCH OPEN SOURCE LICENSE. (By way * of non-limiting example, you will not contribute any code obtained by you under the GNU General Public License or other * so-called "reciprocal" license.) *******************************************************************************/ package edu.stanford.epad.epadws; import java.io.BufferedReader; import java.io.File; import java.io.FileInputStream; import java.io.FileNotFoundException; import java.io.FileOutputStream; import java.io.IOException; import java.io.InputStream; import java.io.InputStreamReader; import java.io.OutputStream; import java.net.BindException; import java.net.SocketException; import java.util.ArrayList; import java.util.EnumSet; import java.util.List; import java.util.concurrent.TimeUnit; import org.apache.commons.io.IOUtils; import org.eclipse.jetty.server.DispatcherType; import org.eclipse.jetty.server.Handler; import org.eclipse.jetty.server.Server; import org.eclipse.jetty.server.handler.ContextHandler; import org.eclipse.jetty.server.handler.ContextHandlerCollection; import org.eclipse.jetty.server.handler.DefaultHandler; import org.eclipse.jetty.server.handler.HandlerList; import org.eclipse.jetty.server.handler.ResourceHandler; import org.eclipse.jetty.servlet.ServletContextHandler; import org.eclipse.jetty.servlet.ServletHolder; import org.eclipse.jetty.webapp.WebAppContext; import org.eclipse.jetty.xml.XmlConfiguration; import org.springframework.web.context.ContextLoaderListener; import org.springframework.web.context.WebApplicationContext; import org.springframework.web.context.support.AnnotationConfigWebApplicationContext; import org.springframework.web.servlet.DispatcherServlet; import org.xml.sax.SAXException; import edu.stanford.epad.common.plugins.PluginController; import edu.stanford.epad.common.plugins.PluginServletHandler; import edu.stanford.epad.common.util.EPADConfig; import edu.stanford.epad.common.util.EPADFileUtils; import edu.stanford.epad.common.util.EPADLogger; import edu.stanford.epad.epadws.aim.AIMUtil; import edu.stanford.epad.epadws.dcm4chee.Dcm4CheeOperations; import edu.stanford.epad.epadws.epaddb.EpadDatabase; import edu.stanford.epad.epadws.epaddb.EpadDatabaseOperations; import edu.stanford.epad.epadws.handlers.admin.ConvertAIM4Handler; import edu.stanford.epad.epadws.handlers.admin.CopyAimsToExistHandler; import edu.stanford.epad.epadws.handlers.admin.ImageCheckHandler; import edu.stanford.epad.epadws.handlers.admin.ImageReprocessingHandler; import edu.stanford.epad.epadws.handlers.admin.ResourceCheckHandler; import edu.stanford.epad.epadws.handlers.admin.ResourceFailureLogHandler; import edu.stanford.epad.epadws.handlers.admin.ServerStatusHandler; import edu.stanford.epad.epadws.handlers.admin.StatisticsHandler; import edu.stanford.epad.epadws.handlers.admin.XNATSyncHandler; import edu.stanford.epad.epadws.handlers.aim.AimResourceHandler; import edu.stanford.epad.epadws.handlers.coordination.CoordinationHandler; import edu.stanford.epad.epadws.handlers.core.EPADHandler; import edu.stanford.epad.epadws.handlers.dicom.DownloadHandler; import edu.stanford.epad.epadws.handlers.dicom.ResourcesFileHandler; import edu.stanford.epad.epadws.handlers.dicom.WadoHandler; import edu.stanford.epad.epadws.handlers.event.EventHandler; import edu.stanford.epad.epadws.handlers.event.ProjectEventHandler; import edu.stanford.epad.epadws.handlers.plugin.EPadPluginHandler; import edu.stanford.epad.epadws.handlers.session.EPADSessionHandler; import edu.stanford.epad.epadws.models.Plugin; import edu.stanford.epad.epadws.models.User; import edu.stanford.epad.epadws.plugins.PluginConfig; import edu.stanford.epad.epadws.plugins.PluginHandlerMap; import edu.stanford.epad.epadws.processing.pipeline.threads.ShutdownHookThread; import edu.stanford.epad.epadws.processing.pipeline.threads.ShutdownSignal; import edu.stanford.epad.epadws.processing.pipeline.watcher.QueueAndWatcherManager; import edu.stanford.epad.epadws.service.DefaultEpadProjectOperations; import edu.stanford.epad.epadws.service.PluginOperations; import edu.stanford.epad.epadws.service.RemotePACService; /** * Entry point for the ePAD Plugin Webapp. * <p> * Start an embedded Jetty server and install handlers required for this application. The application listens on the port * indicated by the property <i>PluginPort</i> in proxy-config.properties. * <p> * NOTE: The current directory must be set to the ePAD bin subdirectory (~epad/DicomProxy/bin) before calling the start * scripts associated with this application. Code in the WAR file needs to be updated to remove this restriction. */ public class PluginMain { private static final EPADLogger log = EPADLogger.getInstance(); public static void main(String[] args) { ShutdownSignal shutdownSignal = ShutdownSignal.getInstance(); Server server = null; try { checkPluginsFile(); int pluginPort = new Integer(EPADConfig.getParamValue("PluginPort", "8085")); log.info("#######################################################"); log.info("############# Starting ePAD Plugin Webapp #############"); log.info("#######################################################"); initializePlugins(); server = new Server(pluginPort); configureJettyServer(server); addHandlers(server); Runtime.getRuntime().addShutdownHook(new ShutdownHookThread()); log.info("Starting Jetty for ePAD Plugins on port " + pluginPort); server.start(); server.join(); } catch (BindException be) { log.severe("Bind exception", be); Throwable t = be.getCause(); log.warning("Bind exception cause: " + be.getMessage(), t); } catch (SocketException se) { log.severe("Cannot bind to all sockets", se); } catch (Exception e) { log.severe("Fatal Exception. Shutting down ePAD Web Service", e); } catch (Error err) { log.severe("Fatal Error. Shutting down ePAD Web Service", err); } finally { log.info("#####################################################"); log.info("############# Shutting down ePAD ###################"); log.info("#####################################################"); shutdownSignal.shutdownNow(); stopServer(server); try { // Wait just long enough for some messages to be printed out. TimeUnit.MILLISECONDS.sleep(2000); } catch (InterruptedException e) { e.printStackTrace(); } } log.info("#####################################################"); log.info("################## Exit ePAD Web Service ###########"); log.info("#####################################################"); } public static void checkPluginsFile() { File pluginsFile = new File(EPADConfig.getEPADWebServerPluginConfigFilePath()); if (!pluginsFile.exists()) { pluginsFile.getParentFile().mkdirs(); BufferedReader reader = null; InputStream is = null; StringBuilder sb = new StringBuilder(); try { is = EPADFileUtils.class.getClassLoader().getResourceAsStream(pluginsFile.getName()); reader = new BufferedReader(new InputStreamReader(is, "UTF8")); String line = null; while ((line = reader.readLine()) != null) { sb.append(line); sb.append("\n"); } } catch (Exception x) { log.warning("Error creating plugin config file", x); return; } finally { if (reader != null) IOUtils.closeQuietly(reader); else if (is != null) IOUtils.closeQuietly(is); } EPADFileUtils.write(pluginsFile, sb.toString()); } } private static void configureJettyServer(Server server) { FileInputStream jettyConfigFileStream = null; try { String jettyConfigFilePath = EPADConfig.getEPADWebServerJettyConfigFilePath(); jettyConfigFileStream = new FileInputStream(jettyConfigFilePath); XmlConfiguration configuration = new XmlConfiguration(jettyConfigFileStream); configuration.configure(server); log.info("Jetty server configured using configuration file " + jettyConfigFilePath); } catch (FileNotFoundException e) { log.warning( "Could not find Jetty configuration file " + EPADConfig.getEPADWebServerJettyConfigFilePath()); } catch (SAXException e) { log.warning("SAX error reading Jetty configuration file " + EPADConfig.getEPADWebServerJettyConfigFilePath(), e); } catch (IOException e) { log.warning( "IO error reading Jetty configuration file " + EPADConfig.getEPADWebServerJettyConfigFilePath(), e); } catch (Exception e) { log.warning( "Error processing Jetty configuration file " + EPADConfig.getEPADWebServerJettyConfigFilePath(), e); } finally { IOUtils.closeQuietly(jettyConfigFileStream); } } public static void initializePlugins() { PluginController.getInstance(); } private static void addHandlers(Server server) { List<Handler> handlerList = new ArrayList<Handler>(); loadPluginClasses(); addHandlerAtContextPath(new EPadPluginHandler(), "/epad/plugin", handlerList); ContextHandlerCollection contexts = new ContextHandlerCollection(); contexts.setHandlers(handlerList.toArray(new Handler[handlerList.size()])); server.setHandler(contexts); } private static void addHandlerAtContextPath(Handler handler, String contextPath, List<Handler> handlerList) { ContextHandler contextHandler = new ContextHandler(contextPath); contextHandler.setResourceBase("."); contextHandler.setClassLoader(Thread.currentThread().getContextClassLoader()); contextHandler.setHandler(handler); handlerList.add(contextHandler); log.info("Added " + handler.getClass().getName() + " at context " + contextPath); } /** * Load all the plugins into a map. */ public static void loadPluginClasses() { try { PluginHandlerMap pluginHandlerMap = PluginHandlerMap.getInstance(); PluginConfig pluginConfig = PluginConfig.getInstance(); List<String> pluginHandlerList = pluginConfig.getPluginHandlerList(); PluginOperations pluginOps = PluginOperations.getInstance(); List<Plugin> plugins = new ArrayList<Plugin>(); try { plugins = pluginOps.getPlugins(); } catch (Exception x) { } ; for (String pluginClassName : pluginHandlerList) { log.info("Loading plugin class: " + pluginClassName); try { PluginServletHandler psh = pluginHandlerMap.loadFromClassName(pluginClassName); if (psh != null) { String pluginName = psh.getName(); pluginHandlerMap.setPluginServletHandler(pluginName, psh); } else { log.warning("Could not find plugin class: " + pluginClassName); } } catch (Exception x) { for (Plugin plugin : plugins) { if (plugin.getJavaclass().equals(pluginClassName)) { plugin.setStatus("Error loading class:" + x.getMessage()); try { plugin.save(); } catch (Exception x2) { } } } } } } catch (Exception x) { log.warning("Error loading plugin", x); } log.info("Done loading plugins"); } private static void stopServer(Server server) { try { if (server != null) { log.info("#####################################################"); log.info("############### Stopping Jetty server ###############"); log.info("#####################################################"); server.stop(); } } catch (Exception e) { log.warning("Failed to stop the Jetty server", e); } } }