1
2 package io.earcam.maven.plugin.sitemap;
3
4 import org.apache.maven.plugin.AbstractMojo;
5 import org.apache.maven.plugin.MojoExecutionException;
6 import org.apache.maven.plugins.annotations.Mojo;
7 import org.apache.maven.plugins.annotations.Parameter;
8
9 import org.w3c.dom.Document;
10 import org.w3c.dom.Element;
11 import org.w3c.dom.Node;
12 import org.w3c.dom.NodeList;
13 import org.xml.sax.SAXException;
14
15 import javax.xml.parsers.DocumentBuilder;
16 import javax.xml.parsers.DocumentBuilderFactory;
17 import javax.xml.parsers.ParserConfigurationException;
18 import java.io.IOException;
19 import java.io.InputStream;
20 import java.util.ArrayList;
21 import java.util.List;
22
23
24
25
26
27
28 @Mojo( name = "help", requiresProject = false, threadSafe = true )
29 public class HelpMojo
30 extends AbstractMojo
31 {
32
33
34
35
36 @Parameter( property = "detail", defaultValue = "false" )
37 private boolean detail;
38
39
40
41
42
43 @Parameter( property = "goal" )
44 private java.lang.String goal;
45
46
47
48
49
50 @Parameter( property = "lineLength", defaultValue = "80" )
51 private int lineLength;
52
53
54
55
56
57 @Parameter( property = "indentSize", defaultValue = "2" )
58 private int indentSize;
59
60
61 private static final String PLUGIN_HELP_PATH =
62 "/META-INF/maven/io.earcam.maven.plugin/io.earcam.maven.plugin.sitemap/plugin-help.xml";
63
64 private static final int DEFAULT_LINE_LENGTH = 80;
65
66 private Document build()
67 throws MojoExecutionException
68 {
69 getLog().debug( "load plugin-help.xml: " + PLUGIN_HELP_PATH );
70 InputStream is = null;
71 try
72 {
73 is = getClass().getResourceAsStream( PLUGIN_HELP_PATH );
74 DocumentBuilderFactory dbFactory = DocumentBuilderFactory.newInstance();
75 DocumentBuilder dBuilder = dbFactory.newDocumentBuilder();
76 return dBuilder.parse( is );
77 }
78 catch ( IOException e )
79 {
80 throw new MojoExecutionException( e.getMessage(), e );
81 }
82 catch ( ParserConfigurationException e )
83 {
84 throw new MojoExecutionException( e.getMessage(), e );
85 }
86 catch ( SAXException e )
87 {
88 throw new MojoExecutionException( e.getMessage(), e );
89 }
90 finally
91 {
92 if ( is != null )
93 {
94 try
95 {
96 is.close();
97 }
98 catch ( IOException e )
99 {
100 throw new MojoExecutionException( e.getMessage(), e );
101 }
102 }
103 }
104 }
105
106
107
108
109 public void execute()
110 throws MojoExecutionException
111 {
112 if ( lineLength <= 0 )
113 {
114 getLog().warn( "The parameter 'lineLength' should be positive, using '80' as default." );
115 lineLength = DEFAULT_LINE_LENGTH;
116 }
117 if ( indentSize <= 0 )
118 {
119 getLog().warn( "The parameter 'indentSize' should be positive, using '2' as default." );
120 indentSize = 2;
121 }
122
123 Document doc = build();
124
125 StringBuilder sb = new StringBuilder();
126 Node plugin = getSingleChild( doc, "plugin" );
127
128
129 String name = getValue( plugin, "name" );
130 String version = getValue( plugin, "version" );
131 String id = getValue( plugin, "groupId" ) + ":" + getValue( plugin, "artifactId" ) + ":" + version;
132 if ( isNotEmpty( name ) && !name.contains( id ) )
133 {
134 append( sb, name + " " + version, 0 );
135 }
136 else
137 {
138 if ( isNotEmpty( name ) )
139 {
140 append( sb, name, 0 );
141 }
142 else
143 {
144 append( sb, id, 0 );
145 }
146 }
147 append( sb, getValue( plugin, "description" ), 1 );
148 append( sb, "", 0 );
149
150
151 String goalPrefix = getValue( plugin, "goalPrefix" );
152
153 Node mojos1 = getSingleChild( plugin, "mojos" );
154
155 List<Node> mojos = findNamedChild( mojos1, "mojo" );
156
157 if ( goal == null || goal.length() <= 0 )
158 {
159 append( sb, "This plugin has " + mojos.size() + ( mojos.size() > 1 ? " goals:" : " goal:" ), 0 );
160 append( sb, "", 0 );
161 }
162
163 for ( Node mojo : mojos )
164 {
165 writeGoal( sb, goalPrefix, (Element) mojo );
166 }
167
168 if ( getLog().isInfoEnabled() )
169 {
170 getLog().info( sb.toString() );
171 }
172 }
173
174
175 private static boolean isNotEmpty( String string )
176 {
177 return string != null && string.length() > 0;
178 }
179
180 private String getValue( Node node, String elementName )
181 throws MojoExecutionException
182 {
183 return getSingleChild( node, elementName ).getTextContent();
184 }
185
186 private Node getSingleChild( Node node, String elementName )
187 throws MojoExecutionException
188 {
189 List<Node> namedChild = findNamedChild( node, elementName );
190 if ( namedChild.isEmpty() )
191 {
192 throw new MojoExecutionException( "Could not find " + elementName + " in plugin-help.xml" );
193 }
194 if ( namedChild.size() > 1 )
195 {
196 throw new MojoExecutionException( "Multiple " + elementName + " in plugin-help.xml" );
197 }
198 return namedChild.get( 0 );
199 }
200
201 private List<Node> findNamedChild( Node node, String elementName )
202 {
203 List<Node> result = new ArrayList<Node>();
204 NodeList childNodes = node.getChildNodes();
205 for ( int i = 0; i < childNodes.getLength(); i++ )
206 {
207 Node item = childNodes.item( i );
208 if ( elementName.equals( item.getNodeName() ) )
209 {
210 result.add( item );
211 }
212 }
213 return result;
214 }
215
216 private Node findSingleChild( Node node, String elementName )
217 throws MojoExecutionException
218 {
219 List<Node> elementsByTagName = findNamedChild( node, elementName );
220 if ( elementsByTagName.isEmpty() )
221 {
222 return null;
223 }
224 if ( elementsByTagName.size() > 1 )
225 {
226 throw new MojoExecutionException( "Multiple " + elementName + "in plugin-help.xml" );
227 }
228 return elementsByTagName.get( 0 );
229 }
230
231 private void writeGoal( StringBuilder sb, String goalPrefix, Element mojo )
232 throws MojoExecutionException
233 {
234 String mojoGoal = getValue( mojo, "goal" );
235 Node configurationElement = findSingleChild( mojo, "configuration" );
236 Node description = findSingleChild( mojo, "description" );
237 if ( goal == null || goal.length() <= 0 || mojoGoal.equals( goal ) )
238 {
239 append( sb, goalPrefix + ":" + mojoGoal, 0 );
240 Node deprecated = findSingleChild( mojo, "deprecated" );
241 if ( ( deprecated != null ) && isNotEmpty( deprecated.getTextContent() ) )
242 {
243 append( sb, "Deprecated. " + deprecated.getTextContent(), 1 );
244 if ( detail && description != null )
245 {
246 append( sb, "", 0 );
247 append( sb, description.getTextContent(), 1 );
248 }
249 }
250 else if ( description != null )
251 {
252 append( sb, description.getTextContent(), 1 );
253 }
254 append( sb, "", 0 );
255
256 if ( detail )
257 {
258 Node parametersNode = getSingleChild( mojo, "parameters" );
259 List<Node> parameters = findNamedChild( parametersNode, "parameter" );
260 append( sb, "Available parameters:", 1 );
261 append( sb, "", 0 );
262
263 for ( Node parameter : parameters )
264 {
265 writeParameter( sb, parameter, configurationElement );
266 }
267 }
268 }
269 }
270
271 private void writeParameter( StringBuilder sb, Node parameter, Node configurationElement )
272 throws MojoExecutionException
273 {
274 String parameterName = getValue( parameter, "name" );
275 String parameterDescription = getValue( parameter, "description" );
276
277 Element fieldConfigurationElement = null;
278 if ( configurationElement != null )
279 {
280 fieldConfigurationElement = (Element) findSingleChild( configurationElement, parameterName );
281 }
282
283 String parameterDefaultValue = "";
284 if ( fieldConfigurationElement != null && fieldConfigurationElement.hasAttribute( "default-value" ) )
285 {
286 parameterDefaultValue = " (Default: " + fieldConfigurationElement.getAttribute( "default-value" ) + ")";
287 }
288 append( sb, parameterName + parameterDefaultValue, 2 );
289 Node deprecated = findSingleChild( parameter, "deprecated" );
290 if ( ( deprecated != null ) && isNotEmpty( deprecated.getTextContent() ) )
291 {
292 append( sb, "Deprecated. " + deprecated.getTextContent(), 3 );
293 append( sb, "", 0 );
294 }
295 append( sb, parameterDescription, 3 );
296 if ( "true".equals( getValue( parameter, "required" ) ) )
297 {
298 append( sb, "Required: Yes", 3 );
299 }
300 if ( ( fieldConfigurationElement != null ) && isNotEmpty( fieldConfigurationElement.getTextContent() ) )
301 {
302 String property = getPropertyFromExpression( fieldConfigurationElement.getTextContent() );
303 append( sb, "User property: " + property, 3 );
304 }
305
306 append( sb, "", 0 );
307 }
308
309
310
311
312
313
314
315
316
317
318 private static String repeat( String str, int repeat )
319 {
320 StringBuilder buffer = new StringBuilder( repeat * str.length() );
321
322 for ( int i = 0; i < repeat; i++ )
323 {
324 buffer.append( str );
325 }
326
327 return buffer.toString();
328 }
329
330
331
332
333
334
335
336
337
338 private void append( StringBuilder sb, String description, int indent )
339 {
340 for ( String line : toLines( description, indent, indentSize, lineLength ) )
341 {
342 sb.append( line ).append( '\n' );
343 }
344 }
345
346
347
348
349
350
351
352
353
354
355
356 private static List<String> toLines( String text, int indent, int indentSize, int lineLength )
357 {
358 List<String> lines = new ArrayList<String>();
359
360 String ind = repeat( "\t", indent );
361
362 String[] plainLines = text.split( "(\r\n)|(\r)|(\n)" );
363
364 for ( String plainLine : plainLines )
365 {
366 toLines( lines, ind + plainLine, indentSize, lineLength );
367 }
368
369 return lines;
370 }
371
372
373
374
375
376
377
378
379
380 private static void toLines( List<String> lines, String line, int indentSize, int lineLength )
381 {
382 int lineIndent = getIndentLevel( line );
383 StringBuilder buf = new StringBuilder( 256 );
384
385 String[] tokens = line.split( " +" );
386
387 for ( String token : tokens )
388 {
389 if ( buf.length() > 0 )
390 {
391 if ( buf.length() + token.length() >= lineLength )
392 {
393 lines.add( buf.toString() );
394 buf.setLength( 0 );
395 buf.append( repeat( " ", lineIndent * indentSize ) );
396 }
397 else
398 {
399 buf.append( ' ' );
400 }
401 }
402
403 for ( int j = 0; j < token.length(); j++ )
404 {
405 char c = token.charAt( j );
406 if ( c == '\t' )
407 {
408 buf.append( repeat( " ", indentSize - buf.length() % indentSize ) );
409 }
410 else if ( c == '\u00A0' )
411 {
412 buf.append( ' ' );
413 }
414 else
415 {
416 buf.append( c );
417 }
418 }
419 }
420 lines.add( buf.toString() );
421 }
422
423
424
425
426
427
428
429 private static int getIndentLevel( String line )
430 {
431 int level = 0;
432 for ( int i = 0; i < line.length() && line.charAt( i ) == '\t'; i++ )
433 {
434 level++;
435 }
436 for ( int i = level + 1; i <= level + 4 && i < line.length(); i++ )
437 {
438 if ( line.charAt( i ) == '\t' )
439 {
440 level++;
441 break;
442 }
443 }
444 return level;
445 }
446
447 private String getPropertyFromExpression( String expression )
448 {
449 if ( expression != null && expression.startsWith( "${" ) && expression.endsWith( "}" )
450 && !expression.substring( 2 ).contains( "${" ) )
451 {
452
453 return expression.substring( 2, expression.length() - 1 );
454 }
455
456 return null;
457 }
458 }