Change the way to deal with Limits to simplify wrapper writing and enable couping...
[jabaws.git] / runner / compbio / runner / Util.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.runner;\r
20 \r
21 import java.io.File;\r
22 import java.io.FileNotFoundException;\r
23 import java.io.FileOutputStream;\r
24 import java.io.IOException;\r
25 import java.util.List;\r
26 import java.util.Map;\r
27 \r
28 import org.apache.log4j.Logger;\r
29 \r
30 import compbio.data.sequence.Alignment;\r
31 import compbio.data.sequence.ClustalAlignmentUtil;\r
32 import compbio.data.sequence.FastaSequence;\r
33 import compbio.data.sequence.Score;\r
34 import compbio.data.sequence.SequenceUtil;\r
35 import compbio.data.sequence.UnknownFileFormatException;\r
36 import compbio.engine.client.ConfExecutable;\r
37 import compbio.engine.client.ConfiguredExecutable;\r
38 import compbio.engine.client.Executable;\r
39 import compbio.engine.conf.PropertyHelperManager;\r
40 import compbio.metadata.LimitsManager;\r
41 import compbio.metadata.PresetManager;\r
42 import compbio.metadata.RunnerConfig;\r
43 import compbio.util.PropertyHelper;\r
44 \r
45 public final class Util {\r
46 \r
47         private static Logger log = Logger.getLogger(Util.class);\r
48 \r
49         private static final PropertyHelper ph = PropertyHelperManager\r
50                         .getPropertyHelper();\r
51 \r
52         public static final String SPACE = " ";\r
53 \r
54         /**\r
55          * For now just assume that all parameters which came in needs setting it\r
56          * will be a client responsibility to prepare RunnerConfig object then\r
57          * \r
58          * @param rconfig\r
59          * @return\r
60          * \r
61          *         public static List<String> toOptionString(RunnerConfig<?>\r
62          *         rconfig) { String option = ""; List<String> options = new\r
63          *         ArrayList<String>(); for (Parameter<?> par :\r
64          *         rconfig.getParameters()) { if (par.getPossibleValues().isEmpty())\r
65          *         { option = par.getOptionName(); } else { option =\r
66          *         par.getOptionName() + "=" + par.getPossibleValues().get(0); } //\r
67          *         separate options options.add(option); } return options; }\r
68          */\r
69 \r
70         public static <T> LimitsManager<T> getLimits(Class<Executable<T>> clazz) {\r
71                 LimitsManager<T> limits = new LimitsManager<T>();\r
72                 try {\r
73                         limits = ConfExecutable.getRunnerLimits(clazz);\r
74                 } catch (FileNotFoundException e) {\r
75                         log.warn(\r
76                                         "No limits are found for " + clazz + " executable! "\r
77                                                         + e.getLocalizedMessage(), e.getCause());\r
78                         // its ok, limit may not be initialized\r
79                 } catch (IOException e) {\r
80                         log.warn("IO exception while attempting to read limits for "\r
81                                         + clazz + " executable! " + e.getLocalizedMessage(),\r
82                                         e.getCause());\r
83                         return null;\r
84                 }\r
85                 return limits;\r
86         }\r
87 \r
88         public static synchronized <T> RunnerConfig<T> getSupportedOptions(\r
89                         Class<? extends Executable<T>> clazz) {\r
90                 try {\r
91                         return ConfExecutable.getRunnerOptions(clazz);\r
92                 } catch (FileNotFoundException e) {\r
93                         log.error(\r
94                                         "Could not load " + clazz + " Parameters !"\r
95                                                         + e.getMessage(), e.getCause());\r
96                 } catch (IOException e) {\r
97                         log.error("IO exception while reading " + clazz + " Parameters !"\r
98                                         + e.getMessage(), e.getCause());\r
99                 }\r
100                 return null;\r
101         }\r
102 \r
103         public static <T> PresetManager<T> getPresets(\r
104                         Class<? extends Executable<T>> clazz) {\r
105                 try {\r
106                         return ConfExecutable.getRunnerPresets(clazz);\r
107                 } catch (FileNotFoundException e) {\r
108                         log.warn(\r
109                                         "No presets are found for " + clazz + " executable! "\r
110                                                         + e.getLocalizedMessage(), e.getCause());\r
111                 } catch (IOException e) {\r
112                         log.warn("IO exception while reading presents! for " + clazz\r
113                                         + " executable! " + e.getLocalizedMessage(), e.getCause());\r
114                 }\r
115                 return null;\r
116         }\r
117 \r
118         public static final Alignment readClustalFile(String workDirectory,\r
119                         String clustFile) throws UnknownFileFormatException, IOException,\r
120                         FileNotFoundException, NullPointerException {\r
121                 assert !compbio.util.Util.isEmpty(workDirectory);\r
122                 assert !compbio.util.Util.isEmpty(clustFile);\r
123                 File cfile = new File(compbio.engine.client.Util.getFullPath(\r
124                                 workDirectory, clustFile));\r
125                 log.trace("CLUSTAL OUTPUT FILE PATH: " + cfile.getAbsolutePath());\r
126                 if (!(cfile.exists() && cfile.length() > 0)) {\r
127                         throw new FileNotFoundException("Result for the jobId "\r
128                                         + workDirectory + " with file name " + clustFile\r
129                                         + " is not found!");\r
130                 }\r
131                 return ClustalAlignmentUtil.readClustalFile(cfile);\r
132         }\r
133 \r
134         public static final Map<String, Score> readJronnFile(String workDirectory,\r
135                         String clustFile) throws UnknownFileFormatException, IOException,\r
136                         FileNotFoundException, NullPointerException {\r
137                 assert !compbio.util.Util.isEmpty(workDirectory);\r
138                 assert !compbio.util.Util.isEmpty(clustFile);\r
139                 File cfile = new File(compbio.engine.client.Util.getFullPath(\r
140                                 workDirectory, clustFile));\r
141                 log.trace("Jronn OUTPUT FILE PATH: " + cfile.getAbsolutePath());\r
142                 if (!(cfile.exists() && cfile.length() > 0)) {\r
143                         throw new FileNotFoundException("Result for the jobId "\r
144                                         + workDirectory + " with file name " + clustFile\r
145                                         + " is not found!");\r
146                 }\r
147                 return SequenceUtil.readJRonn(cfile);\r
148         }\r
149 \r
150         public static void writeInput(List<FastaSequence> sequences,\r
151                         ConfiguredExecutable<?> exec) {\r
152 \r
153                 File filein = new File(exec.getInput());\r
154                 try {\r
155                         FileOutputStream fout = new FileOutputStream(filein);\r
156                         log.debug("File path: " + filein.getAbsolutePath());\r
157                         SequenceUtil.writeFasta(fout, sequences);\r
158                         fout.close();\r
159                 } catch (FileNotFoundException e) {\r
160                         e.printStackTrace();\r
161                 } catch (IOException e) {\r
162                         e.printStackTrace();\r
163                 }\r
164         }\r
165 \r
166 }\r