Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||
JbossConfiguration |
|
| 1.4375;1.438 |
1 | package org.apache.maven.plugin.ear; | |
2 | ||
3 | import java.util.List; | |
4 | ||
5 | /* | |
6 | * Licensed to the Apache Software Foundation (ASF) under one | |
7 | * or more contributor license agreements. See the NOTICE file | |
8 | * distributed with this work for additional information | |
9 | * regarding copyright ownership. The ASF licenses this file | |
10 | * to you under the Apache License, Version 2.0 (the | |
11 | * "License"); you may not use this file except in compliance | |
12 | * with the License. You may obtain a copy of the License at | |
13 | * | |
14 | * http://www.apache.org/licenses/LICENSE-2.0 | |
15 | * | |
16 | * Unless required by applicable law or agreed to in writing, | |
17 | * software distributed under the License is distributed on an | |
18 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | |
19 | * KIND, either express or implied. See the License for the | |
20 | * specific language governing permissions and limitations | |
21 | * under the License. | |
22 | */ | |
23 | ||
24 | ||
25 | /** | |
26 | * The JBoss specific configuration, used to generate the jboss-app.xml | |
27 | * deployment descriptor file | |
28 | * | |
29 | * @author <a href="snicoll@apache.org">Stephane Nicoll</a> | |
30 | * @version $Id: JbossConfiguration.java 746726 2009-02-22 15:15:41Z snicoll $ | |
31 | */ | |
32 | class JbossConfiguration | |
33 | { | |
34 | static final String VERSION_3_2 = "3.2"; | |
35 | ||
36 | static final String VERSION_4 = "4"; | |
37 | ||
38 | static final String VERSION_4_2 = "4.2"; | |
39 | ||
40 | static final String VERSION_5 = "5"; | |
41 | ||
42 | static final String VERSION = "version"; | |
43 | ||
44 | static final String SECURITY_DOMAIN = "security-domain"; | |
45 | ||
46 | static final String UNAUHTHENTICTED_PRINCIPAL = "unauthenticated-principal"; | |
47 | ||
48 | static final String JMX_NAME = "jmx-name"; | |
49 | ||
50 | static final String LOADER_REPOSITORY = "loader-repository"; | |
51 | ||
52 | static final String LOADER_REPOSITORY_CLASS_ATTRIBUTE = "loaderRepositoryClass"; | |
53 | ||
54 | static final String LOADER_REPOSITORY_CONFIG = "loader-repository-config"; | |
55 | ||
56 | static final String CONFIG_PARSER_CLASS_ATTRIBUTE = "configParserClass"; | |
57 | ||
58 | static final String MODULE_ORDER = "module-order"; | |
59 | ||
60 | static final String DATASOURCES = "data-sources"; | |
61 | ||
62 | static final String DATASOURCE = "data-source"; | |
63 | ||
64 | static final String LIBRARY_DIRECTORY = "library-directory"; | |
65 | ||
66 | private final String version; | |
67 | ||
68 | private boolean jbossThreeDotTwo; | |
69 | ||
70 | private boolean jbossFour; | |
71 | ||
72 | private boolean jbossFourDotTwo; | |
73 | ||
74 | private boolean jbossFive; | |
75 | ||
76 | private final String securityDomain; | |
77 | ||
78 | private final String unauthenticatedPrincipal; | |
79 | ||
80 | private final String jmxName; | |
81 | ||
82 | private final String loaderRepository; | |
83 | ||
84 | private final String loaderRepositoryConfig; | |
85 | ||
86 | private final String loaderRepositoryClass; | |
87 | ||
88 | private final String configParserClass; | |
89 | ||
90 | private final String moduleOrder; | |
91 | ||
92 | private final List dataSources; | |
93 | ||
94 | private final String libraryDirectory; | |
95 | ||
96 | public JbossConfiguration( String version, String securityDomain, String unauthenticatedPrincipal, String jmxName, | |
97 | String loaderRepository, String moduleOrder, List dataSources, String libraryDirectory, | |
98 | String loaderRepositoryConfig, String loaderRepositoryClass, String configParserClass ) | |
99 | throws EarPluginException | |
100 | 0 | { |
101 | 0 | if ( version == null ) |
102 | { | |
103 | 0 | throw new EarPluginException( "jboss version could not be null." ); |
104 | } | |
105 | else | |
106 | { | |
107 | 0 | this.version = version; |
108 | 0 | if ( version.equals( JbossConfiguration.VERSION_3_2 ) ) |
109 | { | |
110 | 0 | this.jbossThreeDotTwo = true; |
111 | } | |
112 | 0 | else if ( version.equals( JbossConfiguration.VERSION_4 ) ) |
113 | { | |
114 | 0 | this.jbossFour = true; |
115 | } | |
116 | 0 | else if ( version.equals( JbossConfiguration.VERSION_4_2 ) ) |
117 | { | |
118 | 0 | this.jbossFourDotTwo = true; |
119 | } | |
120 | 0 | else if ( version.equals( JbossConfiguration.VERSION_5 ) ) |
121 | { | |
122 | 0 | this.jbossFive = true; |
123 | } | |
124 | else | |
125 | { | |
126 | 0 | throw new EarPluginException( |
127 | "Invalid JBoss configuration, version[" + version + "] is not supported." ); | |
128 | } | |
129 | 0 | this.securityDomain = securityDomain; |
130 | 0 | this.unauthenticatedPrincipal = unauthenticatedPrincipal; |
131 | 0 | this.jmxName = jmxName; |
132 | 0 | this.loaderRepository = loaderRepository; |
133 | 0 | this.moduleOrder = moduleOrder; |
134 | 0 | this.dataSources = dataSources; |
135 | 0 | this.libraryDirectory = libraryDirectory; |
136 | 0 | this.loaderRepositoryConfig = loaderRepositoryConfig; |
137 | 0 | this.loaderRepositoryClass = loaderRepositoryClass; |
138 | 0 | this.configParserClass = configParserClass; |
139 | } | |
140 | 0 | } |
141 | ||
142 | /** | |
143 | * Returns the targeted version of JBoss. | |
144 | * | |
145 | * @return the jboss version | |
146 | */ | |
147 | public String getVersion() | |
148 | { | |
149 | 0 | return version; |
150 | } | |
151 | ||
152 | /** | |
153 | * Returns true if the targeted JBoss version is 3.2. | |
154 | * | |
155 | * @return if the targeted version is 3.2 | |
156 | */ | |
157 | public boolean isJbossThreeDotTwo() | |
158 | { | |
159 | 0 | return jbossThreeDotTwo; |
160 | } | |
161 | ||
162 | /** | |
163 | * Returns true if the targeted JBoss version is 4. | |
164 | * | |
165 | * @return if the targeted version is 4 | |
166 | */ | |
167 | public boolean isJbossFour() | |
168 | { | |
169 | 0 | return jbossFour; |
170 | } | |
171 | ||
172 | ||
173 | /** | |
174 | * Returns true if the targeted JBoss version is 4.2. | |
175 | * | |
176 | * @return if the targeted version is 4.2 | |
177 | */ | |
178 | public boolean isJbossFourDotTwo() | |
179 | { | |
180 | 0 | return jbossFourDotTwo; |
181 | } | |
182 | ||
183 | /** | |
184 | * Returns true if the targeted JBoss version is 5. | |
185 | * | |
186 | * @return if the targeted version is 5 | |
187 | */ | |
188 | public boolean isJbossFive() | |
189 | { | |
190 | 0 | return jbossFive; |
191 | } | |
192 | ||
193 | /** | |
194 | * The security-domain element specifies the JNDI name of the security | |
195 | * manager that implements the EJBSecurityManager and RealmMapping for | |
196 | * the domain. When specified at the jboss level it specifies the security | |
197 | * domain for all j2ee components in the deployment unit. | |
198 | * <p/> | |
199 | * One can override the global security-domain at the container | |
200 | * level using the security-domain element at the container-configuration | |
201 | * level. | |
202 | * <p/> | |
203 | * Only available as from JBoss 4. | |
204 | * | |
205 | * @return the JNDI name of the security manager | |
206 | */ | |
207 | public String getSecurityDomain() | |
208 | { | |
209 | 0 | return securityDomain; |
210 | } | |
211 | ||
212 | /** | |
213 | * The unauthenticated-principal element specifies the name of the principal | |
214 | * that will be returned by the EJBContext.getCallerPrincipal() method if there | |
215 | * is no authenticated user. This Principal has no roles or privaledges to call | |
216 | * any other beans. | |
217 | * <p/> | |
218 | * Only available as from JBoss 4. | |
219 | * | |
220 | * @return the unauthenticated principal | |
221 | */ | |
222 | public String getUnauthenticatedPrincipal() | |
223 | { | |
224 | 0 | return unauthenticatedPrincipal; |
225 | } | |
226 | ||
227 | /** | |
228 | * The jmx-name element allows one to specify the JMX ObjectName to use | |
229 | * for the MBean associated with the ear module. This must be a unique | |
230 | * name and valid JMX ObjectName string. | |
231 | * | |
232 | * @return the object name of the ear mbean | |
233 | */ | |
234 | public String getJmxName() | |
235 | { | |
236 | 0 | return jmxName; |
237 | } | |
238 | ||
239 | /** | |
240 | * The loader-repository specifies the name of the UnifiedLoaderRepository | |
241 | * MBean to use for the ear to provide ear level scoping of classes deployed | |
242 | * in the ear. It is a unique JMX ObjectName string. | |
243 | * <p/> | |
244 | * <P>Example:</P> | |
245 | * <loader-repository>jboss.test:loader=cts-cmp2v1-sar.ear</loader-repository> | |
246 | * | |
247 | * @return the object name of the ear mbean | |
248 | */ | |
249 | public String getLoaderRepository() | |
250 | { | |
251 | 0 | return loaderRepository; |
252 | } | |
253 | ||
254 | /** | |
255 | * The module-order specifies the order in which the modules specified | |
256 | * in the application.xml file gets loaded. Allowed values are: | |
257 | * <p/> | |
258 | * <module-order>strict</module-order> | |
259 | * The strict value indicates that the deployments of the modules will | |
260 | * be done in the order that would be specified in the application.xml | |
261 | * and jboss-app.xml file. | |
262 | * <p/> | |
263 | * <module-order>implicit</module-order> | |
264 | * The implicit value indicates the deployment would follow the order | |
265 | * which would be specified in the DeploymentSorter. | |
266 | * <p/> | |
267 | * Returns <tt>null</tt> if no module order is set. | |
268 | * <p/> | |
269 | * Only available in JBoss 4.2 and 4.3. Has no effect in JBoss 5 and is | |
270 | * not added when mentioned version is used. | |
271 | * | |
272 | * @return the module order | |
273 | */ | |
274 | public String getModuleOrder() | |
275 | { | |
276 | 0 | return moduleOrder; |
277 | } | |
278 | ||
279 | /** | |
280 | * Returns the list of datasources to include in the <tt>jboss-app.xml</tt> | |
281 | * file as services. Each element of the list is the relative path to the | |
282 | * datasource file contained in the EAR archive. | |
283 | * | |
284 | * @return the list of datasources paths | |
285 | */ | |
286 | public List getDataSources() | |
287 | { | |
288 | 0 | return dataSources; |
289 | } | |
290 | ||
291 | /** | |
292 | * Returns the library directory to include in the <tt>jboss-app.xml</tt> file. | |
293 | * It tells JBoss where to find non-Java EE libraries included in the EAR. | |
294 | * | |
295 | * @return the library directory | |
296 | */ | |
297 | public String getLibraryDirectory() | |
298 | { | |
299 | 0 | return libraryDirectory; |
300 | } | |
301 | ||
302 | /** | |
303 | * Returns the class loader repository configuration to include in the <tt>jboss-app.xml</tt> file. | |
304 | * The content of this element is handed to the class loader, thereby altering it's default behaviour. | |
305 | * <p/> | |
306 | * This element is added as a child to the <tt>loader-repository</tt> element. If the element is not | |
307 | * present in the configuration, it will be added. | |
308 | * <p/> | |
309 | * Example: <loader-repository-config>java2ParentDelegaton=true</loader-repository-config> | |
310 | * | |
311 | * @return the class loader repository configuration | |
312 | */ | |
313 | public String getLoaderRepositoryConfig() | |
314 | { | |
315 | 0 | return loaderRepositoryConfig; |
316 | } | |
317 | ||
318 | /** | |
319 | * Returns the class loader repository class to include in the <tt>jboss-app.xml</tt> file. | |
320 | * It tells JBoss which loader repository implementation to use. | |
321 | * <p/> | |
322 | * This element is added as an attribute to the <tt>loader-repository</tt> element, therefore it is | |
323 | * not added if no such element configuration is present. | |
324 | * <p/> | |
325 | * Example: <loader-repository-class>org.mindbug.jboss.AlternateLoaderRepository</loader-repository-class> | |
326 | * | |
327 | * @return the class loader repository class | |
328 | */ | |
329 | public String getLoaderRepositoryClass() | |
330 | { | |
331 | 0 | return loaderRepositoryClass; |
332 | } | |
333 | ||
334 | /** | |
335 | * Returns the class loader's configuration parser class to include in the <tt>jboss-app.xml</tt> file. | |
336 | * It tells JBoss how to parse the configuration given in the <tt>loader-repository-config</tt> element. | |
337 | * <p/> | |
338 | * This element is added as an attribute to the <tt>loader-repository-config</tt> element, therefore it is | |
339 | * not added if no such element configuration is present. | |
340 | * <p/> | |
341 | * Example: <config-parser-class>org.mindbug.jboss.AlternateLoaderRepositoryConfigParser</config-parser-class> | |
342 | * | |
343 | * @return the class loader's configuration parser class | |
344 | */ | |
345 | public String getConfigParserClass() | |
346 | { | |
347 | 0 | return configParserClass; |
348 | } | |
349 | } |