engine/compbio/engine/conf/PropertyHelperManager.java

   1 /* Copyright (c) 2009 Peter Troshin\r
   2  *  \r
   3  *  JAva Bioinformatics Analysis Web Services (JABAWS) @version: 1.0     \r
   4  * \r
   5  *  This library is free software; you can redistribute it and/or modify it under the terms of the\r
   6  *  Apache License version 2 as published by the Apache Software Foundation\r
   7  * \r
   8  *  This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without\r
   9  *  even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Apache \r
  10  *  License for more details.\r
  11  * \r
  12  *  A copy of the license is in apache_license.txt. It is also available here:\r
  13  * @see: http://www.apache.org/licenses/LICENSE-2.0.txt\r
  14  * \r
  15  * Any republication or derived work distributed in source code form\r
  16  * must include this copyright and license notice.\r
  17  */\r
  18 \r
  19 package compbio.engine.conf;\r
  20 \r
  21 import java.io.File;\r
  22 import java.io.IOException;\r
  23 import java.net.URISyntaxException;\r
  24 import java.net.URL;\r
  25 \r
  26 import org.apache.log4j.Logger;\r
  27 \r
  28 import compbio.util.PropertyHelper;\r
  29 import compbio.util.Util;\r
  30 \r
  31 public final class PropertyHelperManager {\r
  32 \r
  33         private static Logger log = Logger.getLogger(PropertyHelperManager.class);\r
  34         private static PropertyHelper ph = null;\r
  35         public static final String confDir = "conf" + File.separator;\r
  36 \r
  37         /**\r
  38          * Ways to fix path problem: 1) find a path to WEB-INF directory based on\r
  39          * the path to a known class. Then prepend this absolute path to the rest of\r
  40          * paths pros: no input from user cons: relocation of the source may cause\r
  41          * problems 2) Require users to add configuration directories to the class\r
  42          * path and then load entries from it. pros: cons: Many paths needs to be\r
  43          * added. Put significant burden on the user. Hard to tell web appl server\r
  44          * to add these entries to its class path. 3) Ask for project source\r
  45          * directory explicitly in the configuration. pros cons: similar to 1, but\r
  46          * this initial configuration file must reside in well known location! Why\r
  47          * ask users what can be found automatically? 4) Have everything in the\r
  48          * location already in class path for tomcat. cons: only classes and\r
  49          * lib/*.jar are added, eclipse will remove non classses from classes dir.\r
  50          * \r
  51          * Try 1 - succeed.\r
  52          * \r
  53          * @return an instance\r
  54          */\r
  55         public static PropertyHelper getPropertyHelper() {\r
  56                 if (ph == null) {\r
  57                         try {\r
  58                                 File locEngineProp = getResourceFromClasspath(confDir\r
  59                                                 + "Engine.local.properties");\r
  60                                 File clustEngineProp = getResourceFromClasspath(confDir\r
  61                                                 + "Engine.cluster.properties");\r
  62                                 File execProp = getResourceFromClasspath(confDir\r
  63                                                 + "Executable.properties");\r
  64                                 ph = new PropertyHelper(locEngineProp, clustEngineProp,\r
  65                                                 execProp);\r
  66                         } catch (IOException e) {\r
  67                                 log.warn(\r
  68                                                 "Cannot read property files! Reason: "\r
  69                                                                 + e.getLocalizedMessage(), e.getCause());\r
  70                         }\r
  71                 }\r
  72                 return ph;\r
  73         }\r
  74 \r
  75         static File getResourceFromClasspath(String resourceName) {\r
  76                 assert !Util.isEmpty(resourceName);\r
  77                 String locPath = getLocalPath();\r
  78                 File prop = new File(locPath + resourceName);\r
  79                 if (!prop.exists()) {\r
  80                         log.warn("Could not find a resource " + resourceName\r
  81                                         + " in the classpath!");\r
  82                 }\r
  83                 return prop;\r
  84         }\r
  85 \r
  86         /**\r
  87          * Method return the absolute path to the project root directory. It assumes\r
  88          * the following structure of the project project root conf settings\r
  89          * binaries WEB-INF classes compbio engine conf If the structure changes it\r
  90          * must be reflected in this method\r
  91          * \r
  92          * @return the local path\r
  93          * @throws RuntimeException\r
  94          *             if cannot determine the local path\r
  95          */\r
  96         public static String getLocalPath() {\r
  97                 String clname = PropertyHelperManager.class.getSimpleName();\r
  98                 URL url = PropertyHelperManager.class.getResource(clname + ".class");\r
  99                 File f = null;\r
 100                 try {\r
 101                         f = new File(url.toURI());\r
 102                         // Iterate up the hierarchy to find a root project directory\r
 103                         for (int i = 0; i < 6; i++) {\r
 104                                 f = f.getParentFile();\r
 105                         }\r
 106                 } catch (URISyntaxException e) {\r
 107                         String message = "Could not find resources path! Problems locating PropertyHelperManager class! "\r
 108                                         + e.getLocalizedMessage();\r
 109                         log.error(message, e.getCause());\r
 110                         throw new RuntimeException(message, e.getCause());\r
 111                 } catch (IllegalArgumentException e) {\r
 112                         // Classes are in the jar file, using different method to determine\r
 113                         // the path new File(INCORRECT URL) throws it\r
 114                         log.debug(\r
 115                                         "It looks like classes are in the jar file. "\r
 116                                                         + "Attempting a different method to determinine the path to the resources "\r
 117                                                         + e.getLocalizedMessage(), e.getCause());\r
 118                         try {\r
 119                                 f = new File(PropertyHelperManager.class.getProtectionDomain()\r
 120                                                 .getCodeSource().getLocation().toURI().getPath());\r
 121 \r
 122                                 // Iterate up the hierarchy to find a root project directory\r
 123                                 // This time there is not need to walk up all class packages\r
 124                                 // WEB_APPL_NAME\WEB-INF\lib\JAR-FILE-NAME\r
 125                                 // jws2-1.0\WEB-INF\lib\full-jws2-1.0.jar\r
 126                                 for (int i = 0; i < 3; i++) {\r
 127                                         f = f.getParentFile();\r
 128                                 }\r
 129                         } catch (URISyntaxException e1) {\r
 130                                 log.error(\r
 131                                                 "Could not find resources path! "\r
 132                                                                 + e1.getLocalizedMessage(), e1.getCause());\r
 133                                 throw new RuntimeException("Could not find resources path! ",\r
 134                                                 e1.getCause());\r
 135                         }\r
 136                 }\r
 137                 log.debug("Project directory is: " + f.getAbsolutePath());\r
 138                 return f.getAbsolutePath() + File.separator;\r
 139         }\r
 140 }\r