1 | |
package org.apache.maven.plugin.ejb; |
2 | |
|
3 | |
import java.util.ArrayList; |
4 | |
import java.util.Iterator; |
5 | |
import java.util.List; |
6 | |
|
7 | |
import org.apache.maven.plugin.AbstractMojo; |
8 | |
import org.apache.maven.plugin.MojoExecutionException; |
9 | |
|
10 | |
|
11 | |
|
12 | |
|
13 | |
|
14 | |
|
15 | |
|
16 | |
|
17 | |
|
18 | 0 | public class HelpMojo |
19 | |
extends AbstractMojo |
20 | |
{ |
21 | |
|
22 | |
|
23 | |
|
24 | |
|
25 | |
|
26 | |
private boolean detail; |
27 | |
|
28 | |
|
29 | |
|
30 | |
|
31 | |
|
32 | |
|
33 | |
private java.lang.String goal; |
34 | |
|
35 | |
|
36 | |
|
37 | |
|
38 | |
|
39 | |
|
40 | |
private int lineLength; |
41 | |
|
42 | |
|
43 | |
|
44 | |
|
45 | |
|
46 | |
|
47 | |
private int indentSize; |
48 | |
|
49 | |
|
50 | |
|
51 | |
public void execute() |
52 | |
throws MojoExecutionException |
53 | |
{ |
54 | 0 | if ( lineLength <= 0 ) |
55 | |
{ |
56 | 0 | getLog().warn( "The parameter 'lineLength' should be positive, using '80' as default." ); |
57 | 0 | lineLength = 80; |
58 | |
} |
59 | 0 | if ( indentSize <= 0 ) |
60 | |
{ |
61 | 0 | getLog().warn( "The parameter 'indentSize' should be positive, using '2' as default." ); |
62 | 0 | indentSize = 2; |
63 | |
} |
64 | |
|
65 | 0 | StringBuffer sb = new StringBuffer(); |
66 | |
|
67 | 0 | append( sb, "org.apache.maven.plugins:maven-ejb-plugin:2.3", 0 ); |
68 | 0 | append( sb, "", 0 ); |
69 | |
|
70 | 0 | append( sb, "Maven EJB Plugin", 0 ); |
71 | 0 | append( sb, "Generates a J2EE Enterprise JavaBean (EJB) file as well as the associated client JAR.", 1 ); |
72 | 0 | append( sb, "", 0 ); |
73 | |
|
74 | 0 | if ( goal == null || goal.length() <= 0 ) |
75 | |
{ |
76 | 0 | append( sb, "This plugin has 2 goals:", 0 ); |
77 | 0 | append( sb, "", 0 ); |
78 | |
} |
79 | |
|
80 | 0 | if ( goal == null || goal.length() <= 0 || "ejb".equals( goal ) ) |
81 | |
{ |
82 | 0 | append( sb, "ejb:ejb", 0 ); |
83 | 0 | append( sb, "Build an EJB (and optional client) from the current project.", 1 ); |
84 | 0 | append( sb, "", 0 ); |
85 | 0 | if ( detail ) |
86 | |
{ |
87 | 0 | append( sb, "Available parameters:", 1 ); |
88 | 0 | append( sb, "", 0 ); |
89 | |
|
90 | 0 | append( sb, "archive", 2 ); |
91 | 0 | append( sb, "The archive configuration to use. See Maven Archiver Reference. This version of the EJB Plugin uses Maven Archiver 2.4.", 3 ); |
92 | 0 | append( sb, "", 0 ); |
93 | |
|
94 | 0 | append( sb, "classifier", 2 ); |
95 | 0 | append( sb, "Classifier to add to the artifact generated. If given, the artifact will be an attachment instead.", 3 ); |
96 | 0 | append( sb, "", 0 ); |
97 | |
|
98 | 0 | append( sb, "clientExcludes", 2 ); |
99 | 0 | append( sb, "The files and directories to exclude from the client jar. Usage:\n<clientExcludes>\n\u00a0\u00a0<clientExclude>**/*Ejb.class</clientExclude>\n\u00a0\u00a0<clientExclude>**/*Bean.class</clientExclude>\n</clientExcludes>\n\nAttribute is used only if client jar is generated.\nDefault exclusions: **/*Bean.class, **/*CMP.class, **/*Session.class, **/package.html", 3 ); |
100 | 0 | append( sb, "", 0 ); |
101 | |
|
102 | 0 | append( sb, "clientIncludes", 2 ); |
103 | 0 | append( sb, "The files and directories to include in the client jar. Usage:\n<clientIncludes>\n\u00a0\u00a0<clientInclude>**/*</clientInclude>\n</clientIncludes>\n\nAttribute is used only if client jar is generated.\nDefault value: **/**", 3 ); |
104 | 0 | append( sb, "", 0 ); |
105 | |
|
106 | 0 | append( sb, "ejbVersion (Default: 2.1)", 2 ); |
107 | 0 | append( sb, "What EJB version should the EJB Plugin generate? Valid values are \'2.x\' or \'3.x\' (where x is a digit). When ejbVersion is \'3.x\', the ejb-jar.xml file is optional.\n>Usage:\n\n<ejbVersion>3.0</ejbVersion>\n", 3 ); |
108 | 0 | append( sb, "", 0 ); |
109 | |
|
110 | 0 | append( sb, "escapeBackslashesInFilePath (Default: false)", 2 ); |
111 | 0 | append( sb, "To escape interpolated value with windows path. c:\\foo\\bar will be replaced with c:\\\\foo\\\\bar.", 3 ); |
112 | 0 | append( sb, "", 0 ); |
113 | |
|
114 | 0 | append( sb, "escapeString", 2 ); |
115 | 0 | append( sb, "An expression preceded with this String won\'t be interpolated. \\${foo} will be replaced with ${foo}.", 3 ); |
116 | 0 | append( sb, "", 0 ); |
117 | |
|
118 | 0 | append( sb, "excludes", 2 ); |
119 | 0 | append( sb, "The files and directories to exclude from the main EJB jar. Usage:\n<excludes>\n\u00a0\u00a0<exclude>**/*Ejb.class</exclude>\n\u00a0\u00a0<exclude>**/*Bean.class</exclude>\n</excludes>\n\nDefault exclusions: META-INF/ejb-jar.xml, **/package.html", 3 ); |
120 | 0 | append( sb, "", 0 ); |
121 | |
|
122 | 0 | append( sb, "filterDeploymentDescriptor (Default: false)", 2 ); |
123 | 0 | append( sb, "To filter the deployment descriptor.", 3 ); |
124 | 0 | append( sb, "", 0 ); |
125 | |
|
126 | 0 | append( sb, "filters", 2 ); |
127 | 0 | append( sb, "Filters (properties files) to include during the interpolation of the deployment descriptor.", 3 ); |
128 | 0 | append( sb, "", 0 ); |
129 | |
|
130 | 0 | append( sb, "generateClient (Default: false)", 2 ); |
131 | 0 | append( sb, "Whether the EJB client jar should be generated or not.", 3 ); |
132 | 0 | append( sb, "", 0 ); |
133 | |
|
134 | 0 | append( sb, "jarName (Default: ${project.build.finalName})", 2 ); |
135 | 0 | append( sb, "The name of the EJB file to generate.", 3 ); |
136 | 0 | append( sb, "", 0 ); |
137 | |
|
138 | 0 | append( sb, "outputDirectory (Default: ${project.build.outputDirectory})", 2 ); |
139 | 0 | append( sb, "Directory that resources are copied to during the build.", 3 ); |
140 | 0 | append( sb, "", 0 ); |
141 | |
} |
142 | |
} |
143 | |
|
144 | 0 | if ( goal == null || goal.length() <= 0 || "help".equals( goal ) ) |
145 | |
{ |
146 | 0 | append( sb, "ejb:help", 0 ); |
147 | 0 | append( sb, "Display help information on maven-ejb-plugin.\nCall\n\u00a0\u00a0mvn\u00a0ejb:help\u00a0-Ddetail=true\u00a0-Dgoal=<goal-name>\nto display parameter details.", 1 ); |
148 | 0 | append( sb, "", 0 ); |
149 | 0 | if ( detail ) |
150 | |
{ |
151 | 0 | append( sb, "Available parameters:", 1 ); |
152 | 0 | append( sb, "", 0 ); |
153 | |
|
154 | 0 | append( sb, "detail (Default: false)", 2 ); |
155 | 0 | append( sb, "If true, display all settable properties for each goal.", 3 ); |
156 | 0 | append( sb, "", 0 ); |
157 | |
|
158 | 0 | append( sb, "goal", 2 ); |
159 | 0 | append( sb, "The name of the goal for which to show help. If unspecified, all goals will be displayed.", 3 ); |
160 | 0 | append( sb, "", 0 ); |
161 | |
|
162 | 0 | append( sb, "indentSize (Default: 2)", 2 ); |
163 | 0 | append( sb, "The number of spaces per indentation level, should be positive.", 3 ); |
164 | 0 | append( sb, "", 0 ); |
165 | |
|
166 | 0 | append( sb, "lineLength (Default: 80)", 2 ); |
167 | 0 | append( sb, "The maximum length of a display line, should be positive.", 3 ); |
168 | 0 | append( sb, "", 0 ); |
169 | |
} |
170 | |
} |
171 | |
|
172 | 0 | if ( getLog().isInfoEnabled() ) |
173 | |
{ |
174 | 0 | getLog().info( sb.toString() ); |
175 | |
} |
176 | 0 | } |
177 | |
|
178 | |
|
179 | |
|
180 | |
|
181 | |
|
182 | |
|
183 | |
|
184 | |
|
185 | |
|
186 | |
|
187 | |
private static String repeat( String str, int repeat ) |
188 | |
{ |
189 | 0 | StringBuffer buffer = new StringBuffer( repeat * str.length() ); |
190 | |
|
191 | 0 | for ( int i = 0; i < repeat; i++ ) |
192 | |
{ |
193 | 0 | buffer.append( str ); |
194 | |
} |
195 | |
|
196 | 0 | return buffer.toString(); |
197 | |
} |
198 | |
|
199 | |
|
200 | |
|
201 | |
|
202 | |
|
203 | |
|
204 | |
|
205 | |
|
206 | |
|
207 | |
private void append( StringBuffer sb, String description, int indent ) |
208 | |
{ |
209 | 0 | for ( Iterator it = toLines( description, indent, indentSize, lineLength ).iterator(); it.hasNext(); ) |
210 | |
{ |
211 | 0 | sb.append( it.next().toString() ).append( '\n' ); |
212 | |
} |
213 | 0 | } |
214 | |
|
215 | |
|
216 | |
|
217 | |
|
218 | |
|
219 | |
|
220 | |
|
221 | |
|
222 | |
|
223 | |
|
224 | |
|
225 | |
private static List toLines( String text, int indent, int indentSize, int lineLength ) |
226 | |
{ |
227 | 0 | List lines = new ArrayList(); |
228 | |
|
229 | 0 | String ind = repeat( "\t", indent ); |
230 | 0 | String[] plainLines = text.split( "(\r\n)|(\r)|(\n)" ); |
231 | 0 | for ( int i = 0; i < plainLines.length; i++ ) |
232 | |
{ |
233 | 0 | toLines( lines, ind + plainLines[i], indentSize, lineLength ); |
234 | |
} |
235 | |
|
236 | 0 | return lines; |
237 | |
} |
238 | |
|
239 | |
|
240 | |
|
241 | |
|
242 | |
|
243 | |
|
244 | |
|
245 | |
|
246 | |
|
247 | |
private static void toLines( List lines, String line, int indentSize, int lineLength ) |
248 | |
{ |
249 | 0 | int lineIndent = getIndentLevel( line ); |
250 | 0 | StringBuffer buf = new StringBuffer( 256 ); |
251 | 0 | String[] tokens = line.split( " +" ); |
252 | 0 | for ( int i = 0; i < tokens.length; i++ ) |
253 | |
{ |
254 | 0 | String token = tokens[i]; |
255 | 0 | if ( i > 0 ) |
256 | |
{ |
257 | 0 | if ( buf.length() + token.length() >= lineLength ) |
258 | |
{ |
259 | 0 | lines.add( buf.toString() ); |
260 | 0 | buf.setLength( 0 ); |
261 | 0 | buf.append( repeat( " ", lineIndent * indentSize ) ); |
262 | |
} |
263 | |
else |
264 | |
{ |
265 | 0 | buf.append( ' ' ); |
266 | |
} |
267 | |
} |
268 | 0 | for ( int j = 0; j < token.length(); j++ ) |
269 | |
{ |
270 | 0 | char c = token.charAt( j ); |
271 | 0 | if ( c == '\t' ) |
272 | |
{ |
273 | 0 | buf.append( repeat( " ", indentSize - buf.length() % indentSize ) ); |
274 | |
} |
275 | 0 | else if ( c == '\u00A0' ) |
276 | |
{ |
277 | 0 | buf.append( ' ' ); |
278 | |
} |
279 | |
else |
280 | |
{ |
281 | 0 | buf.append( c ); |
282 | |
} |
283 | |
} |
284 | |
} |
285 | 0 | lines.add( buf.toString() ); |
286 | 0 | } |
287 | |
|
288 | |
|
289 | |
|
290 | |
|
291 | |
|
292 | |
|
293 | |
|
294 | |
private static int getIndentLevel( String line ) |
295 | |
{ |
296 | 0 | int level = 0; |
297 | 0 | for ( int i = 0; i < line.length() && line.charAt( i ) == '\t'; i++ ) |
298 | |
{ |
299 | 0 | level++; |
300 | |
} |
301 | 0 | for ( int i = level + 1; i <= level + 4 && i < line.length(); i++ ) |
302 | |
{ |
303 | 0 | if ( line.charAt( i ) == '\t' ) |
304 | |
{ |
305 | 0 | level++; |
306 | 0 | break; |
307 | |
} |
308 | |
} |
309 | 0 | return level; |
310 | |
} |
311 | |
} |