1
2
3
4
5
6 package org.apache.maven.usability.plugin.io.xpp3;
7
8
9
10
11
12 import java.io.IOException;
13 import java.io.InputStream;
14 import java.io.Reader;
15 import java.text.DateFormat;
16 import org.apache.maven.usability.plugin.Expression;
17 import org.apache.maven.usability.plugin.ExpressionDocumentation;
18 import org.codehaus.plexus.util.ReaderFactory;
19 import org.codehaus.plexus.util.xml.pull.MXParser;
20 import org.codehaus.plexus.util.xml.pull.XmlPullParser;
21 import org.codehaus.plexus.util.xml.pull.XmlPullParserException;
22
23
24
25
26
27
28 @SuppressWarnings( "all" )
29 public class ParamdocXpp3Reader
30 {
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46 private boolean addDefaultEntities = true;
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63 private boolean checkFieldWithDuplicate( XmlPullParser parser, String tagName, String alias, java.util.Set parsed )
64 throws XmlPullParserException
65 {
66 if ( !( parser.getName().equals( tagName ) || parser.getName().equals( alias ) ) )
67 {
68 return false;
69 }
70 if ( !parsed.add( tagName ) )
71 {
72 throw new XmlPullParserException( "Duplicated tag: '" + tagName + "'", parser, null );
73 }
74 return true;
75 }
76
77
78
79
80
81
82
83
84
85
86
87 private void checkUnknownAttribute( XmlPullParser parser, String attribute, String tagName, boolean strict )
88 throws XmlPullParserException, IOException
89 {
90
91 if ( strict )
92 {
93 throw new XmlPullParserException( "Unknown attribute '" + attribute + "' for tag '" + tagName + "'", parser, null );
94 }
95 }
96
97
98
99
100
101
102
103
104
105 private void checkUnknownElement( XmlPullParser parser, boolean strict )
106 throws XmlPullParserException, IOException
107 {
108 if ( strict )
109 {
110 throw new XmlPullParserException( "Unrecognised tag: '" + parser.getName() + "'", parser, null );
111 }
112
113 for ( int unrecognizedTagCount = 1; unrecognizedTagCount > 0; )
114 {
115 int eventType = parser.next();
116 if ( eventType == XmlPullParser.START_TAG )
117 {
118 unrecognizedTagCount++;
119 }
120 else if ( eventType == XmlPullParser.END_TAG )
121 {
122 unrecognizedTagCount--;
123 }
124 }
125 }
126
127
128
129
130
131
132 public boolean getAddDefaultEntities()
133 {
134 return addDefaultEntities;
135 }
136
137
138
139
140
141
142
143
144
145
146 private boolean getBooleanValue( String s, String attribute, XmlPullParser parser )
147 throws XmlPullParserException
148 {
149 return getBooleanValue( s, attribute, parser, null );
150 }
151
152
153
154
155
156
157
158
159
160
161
162 private boolean getBooleanValue( String s, String attribute, XmlPullParser parser, String defaultValue )
163 throws XmlPullParserException
164 {
165 if ( s != null && s.length() != 0 )
166 {
167 return Boolean.valueOf( s ).booleanValue();
168 }
169 if ( defaultValue != null )
170 {
171 return Boolean.valueOf( defaultValue ).booleanValue();
172 }
173 return false;
174 }
175
176
177
178
179
180
181
182
183
184
185
186 private byte getByteValue( String s, String attribute, XmlPullParser parser, boolean strict )
187 throws XmlPullParserException
188 {
189 if ( s != null )
190 {
191 try
192 {
193 return Byte.valueOf( s ).byteValue();
194 }
195 catch ( NumberFormatException nfe )
196 {
197 if ( strict )
198 {
199 throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a byte", parser, nfe );
200 }
201 }
202 }
203 return 0;
204 }
205
206
207
208
209
210
211
212
213
214
215 private char getCharacterValue( String s, String attribute, XmlPullParser parser )
216 throws XmlPullParserException
217 {
218 if ( s != null )
219 {
220 return s.charAt( 0 );
221 }
222 return 0;
223 }
224
225
226
227
228
229
230
231
232
233
234 private java.util.Date getDateValue( String s, String attribute, XmlPullParser parser )
235 throws XmlPullParserException
236 {
237 return getDateValue( s, attribute, null, parser );
238 }
239
240
241
242
243
244
245
246
247
248
249
250 private java.util.Date getDateValue( String s, String attribute, String dateFormat, XmlPullParser parser )
251 throws XmlPullParserException
252 {
253 if ( s != null )
254 {
255 String effectiveDateFormat = dateFormat;
256 if ( dateFormat == null )
257 {
258 effectiveDateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSS";
259 }
260 if ( "long".equals( effectiveDateFormat ) )
261 {
262 try
263 {
264 return new java.util.Date( Long.parseLong( s ) );
265 }
266 catch ( NumberFormatException e )
267 {
268 throw new XmlPullParserException( e.getMessage(), parser, e );
269 }
270 }
271 else
272 {
273 try
274 {
275 DateFormat dateParser = new java.text.SimpleDateFormat( effectiveDateFormat, java.util.Locale.US );
276 return dateParser.parse( s );
277 }
278 catch ( java.text.ParseException e )
279 {
280 throw new XmlPullParserException( e.getMessage(), parser, e );
281 }
282 }
283 }
284 return null;
285 }
286
287
288
289
290
291
292
293
294
295
296
297 private double getDoubleValue( String s, String attribute, XmlPullParser parser, boolean strict )
298 throws XmlPullParserException
299 {
300 if ( s != null )
301 {
302 try
303 {
304 return Double.valueOf( s ).doubleValue();
305 }
306 catch ( NumberFormatException nfe )
307 {
308 if ( strict )
309 {
310 throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a floating point number", parser, nfe );
311 }
312 }
313 }
314 return 0;
315 }
316
317
318
319
320
321
322
323
324
325
326
327 private float getFloatValue( String s, String attribute, XmlPullParser parser, boolean strict )
328 throws XmlPullParserException
329 {
330 if ( s != null )
331 {
332 try
333 {
334 return Float.valueOf( s ).floatValue();
335 }
336 catch ( NumberFormatException nfe )
337 {
338 if ( strict )
339 {
340 throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a floating point number", parser, nfe );
341 }
342 }
343 }
344 return 0;
345 }
346
347
348
349
350
351
352
353
354
355
356
357 private int getIntegerValue( String s, String attribute, XmlPullParser parser, boolean strict )
358 throws XmlPullParserException
359 {
360 if ( s != null )
361 {
362 try
363 {
364 return Integer.valueOf( s ).intValue();
365 }
366 catch ( NumberFormatException nfe )
367 {
368 if ( strict )
369 {
370 throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be an integer", parser, nfe );
371 }
372 }
373 }
374 return 0;
375 }
376
377
378
379
380
381
382
383
384
385
386
387 private long getLongValue( String s, String attribute, XmlPullParser parser, boolean strict )
388 throws XmlPullParserException
389 {
390 if ( s != null )
391 {
392 try
393 {
394 return Long.valueOf( s ).longValue();
395 }
396 catch ( NumberFormatException nfe )
397 {
398 if ( strict )
399 {
400 throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a long integer", parser, nfe );
401 }
402 }
403 }
404 return 0;
405 }
406
407
408
409
410
411
412
413
414
415
416
417 private String getRequiredAttributeValue( String s, String attribute, XmlPullParser parser, boolean strict )
418 throws XmlPullParserException
419 {
420 if ( s == null )
421 {
422 if ( strict )
423 {
424 throw new XmlPullParserException( "Missing required value for attribute '" + attribute + "'", parser, null );
425 }
426 }
427 return s;
428 }
429
430
431
432
433
434
435
436
437
438
439
440 private short getShortValue( String s, String attribute, XmlPullParser parser, boolean strict )
441 throws XmlPullParserException
442 {
443 if ( s != null )
444 {
445 try
446 {
447 return Short.valueOf( s ).shortValue();
448 }
449 catch ( NumberFormatException nfe )
450 {
451 if ( strict )
452 {
453 throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a short integer", parser, nfe );
454 }
455 }
456 }
457 return 0;
458 }
459
460
461
462
463
464
465
466 private String getTrimmedValue( String s )
467 {
468 if ( s != null )
469 {
470 s = s.trim();
471 }
472 return s;
473 }
474
475
476
477
478
479
480
481 private void initParser( XmlPullParser parser )
482 throws XmlPullParserException
483 {
484 if ( addDefaultEntities )
485 {
486
487
488
489
490 parser.defineEntityReplacementText( "nbsp", "\u00a0" );
491 parser.defineEntityReplacementText( "iexcl", "\u00a1" );
492 parser.defineEntityReplacementText( "cent", "\u00a2" );
493 parser.defineEntityReplacementText( "pound", "\u00a3" );
494 parser.defineEntityReplacementText( "curren", "\u00a4" );
495 parser.defineEntityReplacementText( "yen", "\u00a5" );
496 parser.defineEntityReplacementText( "brvbar", "\u00a6" );
497 parser.defineEntityReplacementText( "sect", "\u00a7" );
498 parser.defineEntityReplacementText( "uml", "\u00a8" );
499 parser.defineEntityReplacementText( "copy", "\u00a9" );
500 parser.defineEntityReplacementText( "ordf", "\u00aa" );
501 parser.defineEntityReplacementText( "laquo", "\u00ab" );
502 parser.defineEntityReplacementText( "not", "\u00ac" );
503 parser.defineEntityReplacementText( "shy", "\u00ad" );
504 parser.defineEntityReplacementText( "reg", "\u00ae" );
505 parser.defineEntityReplacementText( "macr", "\u00af" );
506 parser.defineEntityReplacementText( "deg", "\u00b0" );
507 parser.defineEntityReplacementText( "plusmn", "\u00b1" );
508 parser.defineEntityReplacementText( "sup2", "\u00b2" );
509 parser.defineEntityReplacementText( "sup3", "\u00b3" );
510 parser.defineEntityReplacementText( "acute", "\u00b4" );
511 parser.defineEntityReplacementText( "micro", "\u00b5" );
512 parser.defineEntityReplacementText( "para", "\u00b6" );
513 parser.defineEntityReplacementText( "middot", "\u00b7" );
514 parser.defineEntityReplacementText( "cedil", "\u00b8" );
515 parser.defineEntityReplacementText( "sup1", "\u00b9" );
516 parser.defineEntityReplacementText( "ordm", "\u00ba" );
517 parser.defineEntityReplacementText( "raquo", "\u00bb" );
518 parser.defineEntityReplacementText( "frac14", "\u00bc" );
519 parser.defineEntityReplacementText( "frac12", "\u00bd" );
520 parser.defineEntityReplacementText( "frac34", "\u00be" );
521 parser.defineEntityReplacementText( "iquest", "\u00bf" );
522 parser.defineEntityReplacementText( "Agrave", "\u00c0" );
523 parser.defineEntityReplacementText( "Aacute", "\u00c1" );
524 parser.defineEntityReplacementText( "Acirc", "\u00c2" );
525 parser.defineEntityReplacementText( "Atilde", "\u00c3" );
526 parser.defineEntityReplacementText( "Auml", "\u00c4" );
527 parser.defineEntityReplacementText( "Aring", "\u00c5" );
528 parser.defineEntityReplacementText( "AElig", "\u00c6" );
529 parser.defineEntityReplacementText( "Ccedil", "\u00c7" );
530 parser.defineEntityReplacementText( "Egrave", "\u00c8" );
531 parser.defineEntityReplacementText( "Eacute", "\u00c9" );
532 parser.defineEntityReplacementText( "Ecirc", "\u00ca" );
533 parser.defineEntityReplacementText( "Euml", "\u00cb" );
534 parser.defineEntityReplacementText( "Igrave", "\u00cc" );
535 parser.defineEntityReplacementText( "Iacute", "\u00cd" );
536 parser.defineEntityReplacementText( "Icirc", "\u00ce" );
537 parser.defineEntityReplacementText( "Iuml", "\u00cf" );
538 parser.defineEntityReplacementText( "ETH", "\u00d0" );
539 parser.defineEntityReplacementText( "Ntilde", "\u00d1" );
540 parser.defineEntityReplacementText( "Ograve", "\u00d2" );
541 parser.defineEntityReplacementText( "Oacute", "\u00d3" );
542 parser.defineEntityReplacementText( "Ocirc", "\u00d4" );
543 parser.defineEntityReplacementText( "Otilde", "\u00d5" );
544 parser.defineEntityReplacementText( "Ouml", "\u00d6" );
545 parser.defineEntityReplacementText( "times", "\u00d7" );
546 parser.defineEntityReplacementText( "Oslash", "\u00d8" );
547 parser.defineEntityReplacementText( "Ugrave", "\u00d9" );
548 parser.defineEntityReplacementText( "Uacute", "\u00da" );
549 parser.defineEntityReplacementText( "Ucirc", "\u00db" );
550 parser.defineEntityReplacementText( "Uuml", "\u00dc" );
551 parser.defineEntityReplacementText( "Yacute", "\u00dd" );
552 parser.defineEntityReplacementText( "THORN", "\u00de" );
553 parser.defineEntityReplacementText( "szlig", "\u00df" );
554 parser.defineEntityReplacementText( "agrave", "\u00e0" );
555 parser.defineEntityReplacementText( "aacute", "\u00e1" );
556 parser.defineEntityReplacementText( "acirc", "\u00e2" );
557 parser.defineEntityReplacementText( "atilde", "\u00e3" );
558 parser.defineEntityReplacementText( "auml", "\u00e4" );
559 parser.defineEntityReplacementText( "aring", "\u00e5" );
560 parser.defineEntityReplacementText( "aelig", "\u00e6" );
561 parser.defineEntityReplacementText( "ccedil", "\u00e7" );
562 parser.defineEntityReplacementText( "egrave", "\u00e8" );
563 parser.defineEntityReplacementText( "eacute", "\u00e9" );
564 parser.defineEntityReplacementText( "ecirc", "\u00ea" );
565 parser.defineEntityReplacementText( "euml", "\u00eb" );
566 parser.defineEntityReplacementText( "igrave", "\u00ec" );
567 parser.defineEntityReplacementText( "iacute", "\u00ed" );
568 parser.defineEntityReplacementText( "icirc", "\u00ee" );
569 parser.defineEntityReplacementText( "iuml", "\u00ef" );
570 parser.defineEntityReplacementText( "eth", "\u00f0" );
571 parser.defineEntityReplacementText( "ntilde", "\u00f1" );
572 parser.defineEntityReplacementText( "ograve", "\u00f2" );
573 parser.defineEntityReplacementText( "oacute", "\u00f3" );
574 parser.defineEntityReplacementText( "ocirc", "\u00f4" );
575 parser.defineEntityReplacementText( "otilde", "\u00f5" );
576 parser.defineEntityReplacementText( "ouml", "\u00f6" );
577 parser.defineEntityReplacementText( "divide", "\u00f7" );
578 parser.defineEntityReplacementText( "oslash", "\u00f8" );
579 parser.defineEntityReplacementText( "ugrave", "\u00f9" );
580 parser.defineEntityReplacementText( "uacute", "\u00fa" );
581 parser.defineEntityReplacementText( "ucirc", "\u00fb" );
582 parser.defineEntityReplacementText( "uuml", "\u00fc" );
583 parser.defineEntityReplacementText( "yacute", "\u00fd" );
584 parser.defineEntityReplacementText( "thorn", "\u00fe" );
585 parser.defineEntityReplacementText( "yuml", "\u00ff" );
586
587
588
589
590
591 parser.defineEntityReplacementText( "OElig", "\u0152" );
592 parser.defineEntityReplacementText( "oelig", "\u0153" );
593 parser.defineEntityReplacementText( "Scaron", "\u0160" );
594 parser.defineEntityReplacementText( "scaron", "\u0161" );
595 parser.defineEntityReplacementText( "Yuml", "\u0178" );
596 parser.defineEntityReplacementText( "circ", "\u02c6" );
597 parser.defineEntityReplacementText( "tilde", "\u02dc" );
598 parser.defineEntityReplacementText( "ensp", "\u2002" );
599 parser.defineEntityReplacementText( "emsp", "\u2003" );
600 parser.defineEntityReplacementText( "thinsp", "\u2009" );
601 parser.defineEntityReplacementText( "zwnj", "\u200c" );
602 parser.defineEntityReplacementText( "zwj", "\u200d" );
603 parser.defineEntityReplacementText( "lrm", "\u200e" );
604 parser.defineEntityReplacementText( "rlm", "\u200f" );
605 parser.defineEntityReplacementText( "ndash", "\u2013" );
606 parser.defineEntityReplacementText( "mdash", "\u2014" );
607 parser.defineEntityReplacementText( "lsquo", "\u2018" );
608 parser.defineEntityReplacementText( "rsquo", "\u2019" );
609 parser.defineEntityReplacementText( "sbquo", "\u201a" );
610 parser.defineEntityReplacementText( "ldquo", "\u201c" );
611 parser.defineEntityReplacementText( "rdquo", "\u201d" );
612 parser.defineEntityReplacementText( "bdquo", "\u201e" );
613 parser.defineEntityReplacementText( "dagger", "\u2020" );
614 parser.defineEntityReplacementText( "Dagger", "\u2021" );
615 parser.defineEntityReplacementText( "permil", "\u2030" );
616 parser.defineEntityReplacementText( "lsaquo", "\u2039" );
617 parser.defineEntityReplacementText( "rsaquo", "\u203a" );
618 parser.defineEntityReplacementText( "euro", "\u20ac" );
619
620
621
622
623
624 parser.defineEntityReplacementText( "fnof", "\u0192" );
625 parser.defineEntityReplacementText( "Alpha", "\u0391" );
626 parser.defineEntityReplacementText( "Beta", "\u0392" );
627 parser.defineEntityReplacementText( "Gamma", "\u0393" );
628 parser.defineEntityReplacementText( "Delta", "\u0394" );
629 parser.defineEntityReplacementText( "Epsilon", "\u0395" );
630 parser.defineEntityReplacementText( "Zeta", "\u0396" );
631 parser.defineEntityReplacementText( "Eta", "\u0397" );
632 parser.defineEntityReplacementText( "Theta", "\u0398" );
633 parser.defineEntityReplacementText( "Iota", "\u0399" );
634 parser.defineEntityReplacementText( "Kappa", "\u039a" );
635 parser.defineEntityReplacementText( "Lambda", "\u039b" );
636 parser.defineEntityReplacementText( "Mu", "\u039c" );
637 parser.defineEntityReplacementText( "Nu", "\u039d" );
638 parser.defineEntityReplacementText( "Xi", "\u039e" );
639 parser.defineEntityReplacementText( "Omicron", "\u039f" );
640 parser.defineEntityReplacementText( "Pi", "\u03a0" );
641 parser.defineEntityReplacementText( "Rho", "\u03a1" );
642 parser.defineEntityReplacementText( "Sigma", "\u03a3" );
643 parser.defineEntityReplacementText( "Tau", "\u03a4" );
644 parser.defineEntityReplacementText( "Upsilon", "\u03a5" );
645 parser.defineEntityReplacementText( "Phi", "\u03a6" );
646 parser.defineEntityReplacementText( "Chi", "\u03a7" );
647 parser.defineEntityReplacementText( "Psi", "\u03a8" );
648 parser.defineEntityReplacementText( "Omega", "\u03a9" );
649 parser.defineEntityReplacementText( "alpha", "\u03b1" );
650 parser.defineEntityReplacementText( "beta", "\u03b2" );
651 parser.defineEntityReplacementText( "gamma", "\u03b3" );
652 parser.defineEntityReplacementText( "delta", "\u03b4" );
653 parser.defineEntityReplacementText( "epsilon", "\u03b5" );
654 parser.defineEntityReplacementText( "zeta", "\u03b6" );
655 parser.defineEntityReplacementText( "eta", "\u03b7" );
656 parser.defineEntityReplacementText( "theta", "\u03b8" );
657 parser.defineEntityReplacementText( "iota", "\u03b9" );
658 parser.defineEntityReplacementText( "kappa", "\u03ba" );
659 parser.defineEntityReplacementText( "lambda", "\u03bb" );
660 parser.defineEntityReplacementText( "mu", "\u03bc" );
661 parser.defineEntityReplacementText( "nu", "\u03bd" );
662 parser.defineEntityReplacementText( "xi", "\u03be" );
663 parser.defineEntityReplacementText( "omicron", "\u03bf" );
664 parser.defineEntityReplacementText( "pi", "\u03c0" );
665 parser.defineEntityReplacementText( "rho", "\u03c1" );
666 parser.defineEntityReplacementText( "sigmaf", "\u03c2" );
667 parser.defineEntityReplacementText( "sigma", "\u03c3" );
668 parser.defineEntityReplacementText( "tau", "\u03c4" );
669 parser.defineEntityReplacementText( "upsilon", "\u03c5" );
670 parser.defineEntityReplacementText( "phi", "\u03c6" );
671 parser.defineEntityReplacementText( "chi", "\u03c7" );
672 parser.defineEntityReplacementText( "psi", "\u03c8" );
673 parser.defineEntityReplacementText( "omega", "\u03c9" );
674 parser.defineEntityReplacementText( "thetasym", "\u03d1" );
675 parser.defineEntityReplacementText( "upsih", "\u03d2" );
676 parser.defineEntityReplacementText( "piv", "\u03d6" );
677 parser.defineEntityReplacementText( "bull", "\u2022" );
678 parser.defineEntityReplacementText( "hellip", "\u2026" );
679 parser.defineEntityReplacementText( "prime", "\u2032" );
680 parser.defineEntityReplacementText( "Prime", "\u2033" );
681 parser.defineEntityReplacementText( "oline", "\u203e" );
682 parser.defineEntityReplacementText( "frasl", "\u2044" );
683 parser.defineEntityReplacementText( "weierp", "\u2118" );
684 parser.defineEntityReplacementText( "image", "\u2111" );
685 parser.defineEntityReplacementText( "real", "\u211c" );
686 parser.defineEntityReplacementText( "trade", "\u2122" );
687 parser.defineEntityReplacementText( "alefsym", "\u2135" );
688 parser.defineEntityReplacementText( "larr", "\u2190" );
689 parser.defineEntityReplacementText( "uarr", "\u2191" );
690 parser.defineEntityReplacementText( "rarr", "\u2192" );
691 parser.defineEntityReplacementText( "darr", "\u2193" );
692 parser.defineEntityReplacementText( "harr", "\u2194" );
693 parser.defineEntityReplacementText( "crarr", "\u21b5" );
694 parser.defineEntityReplacementText( "lArr", "\u21d0" );
695 parser.defineEntityReplacementText( "uArr", "\u21d1" );
696 parser.defineEntityReplacementText( "rArr", "\u21d2" );
697 parser.defineEntityReplacementText( "dArr", "\u21d3" );
698 parser.defineEntityReplacementText( "hArr", "\u21d4" );
699 parser.defineEntityReplacementText( "forall", "\u2200" );
700 parser.defineEntityReplacementText( "part", "\u2202" );
701 parser.defineEntityReplacementText( "exist", "\u2203" );
702 parser.defineEntityReplacementText( "empty", "\u2205" );
703 parser.defineEntityReplacementText( "nabla", "\u2207" );
704 parser.defineEntityReplacementText( "isin", "\u2208" );
705 parser.defineEntityReplacementText( "notin", "\u2209" );
706 parser.defineEntityReplacementText( "ni", "\u220b" );
707 parser.defineEntityReplacementText( "prod", "\u220f" );
708 parser.defineEntityReplacementText( "sum", "\u2211" );
709 parser.defineEntityReplacementText( "minus", "\u2212" );
710 parser.defineEntityReplacementText( "lowast", "\u2217" );
711 parser.defineEntityReplacementText( "radic", "\u221a" );
712 parser.defineEntityReplacementText( "prop", "\u221d" );
713 parser.defineEntityReplacementText( "infin", "\u221e" );
714 parser.defineEntityReplacementText( "ang", "\u2220" );
715 parser.defineEntityReplacementText( "and", "\u2227" );
716 parser.defineEntityReplacementText( "or", "\u2228" );
717 parser.defineEntityReplacementText( "cap", "\u2229" );
718 parser.defineEntityReplacementText( "cup", "\u222a" );
719 parser.defineEntityReplacementText( "int", "\u222b" );
720 parser.defineEntityReplacementText( "there4", "\u2234" );
721 parser.defineEntityReplacementText( "sim", "\u223c" );
722 parser.defineEntityReplacementText( "cong", "\u2245" );
723 parser.defineEntityReplacementText( "asymp", "\u2248" );
724 parser.defineEntityReplacementText( "ne", "\u2260" );
725 parser.defineEntityReplacementText( "equiv", "\u2261" );
726 parser.defineEntityReplacementText( "le", "\u2264" );
727 parser.defineEntityReplacementText( "ge", "\u2265" );
728 parser.defineEntityReplacementText( "sub", "\u2282" );
729 parser.defineEntityReplacementText( "sup", "\u2283" );
730 parser.defineEntityReplacementText( "nsub", "\u2284" );
731 parser.defineEntityReplacementText( "sube", "\u2286" );
732 parser.defineEntityReplacementText( "supe", "\u2287" );
733 parser.defineEntityReplacementText( "oplus", "\u2295" );
734 parser.defineEntityReplacementText( "otimes", "\u2297" );
735 parser.defineEntityReplacementText( "perp", "\u22a5" );
736 parser.defineEntityReplacementText( "sdot", "\u22c5" );
737 parser.defineEntityReplacementText( "lceil", "\u2308" );
738 parser.defineEntityReplacementText( "rceil", "\u2309" );
739 parser.defineEntityReplacementText( "lfloor", "\u230a" );
740 parser.defineEntityReplacementText( "rfloor", "\u230b" );
741 parser.defineEntityReplacementText( "lang", "\u2329" );
742 parser.defineEntityReplacementText( "rang", "\u232a" );
743 parser.defineEntityReplacementText( "loz", "\u25ca" );
744 parser.defineEntityReplacementText( "spades", "\u2660" );
745 parser.defineEntityReplacementText( "clubs", "\u2663" );
746 parser.defineEntityReplacementText( "hearts", "\u2665" );
747 parser.defineEntityReplacementText( "diams", "\u2666" );
748
749 }
750 }
751
752
753
754
755
756
757
758
759
760 private int nextTag( XmlPullParser parser )
761 throws IOException, XmlPullParserException
762 {
763 int eventType = parser.next();
764 if ( eventType == XmlPullParser.TEXT )
765 {
766 eventType = parser.next();
767 }
768 if ( eventType != XmlPullParser.START_TAG && eventType != XmlPullParser.END_TAG )
769 {
770 throw new XmlPullParserException( "expected START_TAG or END_TAG not " + XmlPullParser.TYPES[eventType], parser, null );
771 }
772 return eventType;
773 }
774
775
776
777
778
779
780
781
782
783
784 public ExpressionDocumentation read( Reader reader, boolean strict )
785 throws IOException, XmlPullParserException
786 {
787 XmlPullParser parser = new MXParser();
788
789 parser.setInput( reader );
790
791 initParser( parser );
792
793 return read( parser, strict );
794 }
795
796
797
798
799
800
801
802
803
804 public ExpressionDocumentation read( Reader reader )
805 throws IOException, XmlPullParserException
806 {
807 return read( reader, true );
808 }
809
810
811
812
813
814
815
816
817
818
819 public ExpressionDocumentation read( InputStream in, boolean strict )
820 throws IOException, XmlPullParserException
821 {
822 return read( ReaderFactory.newXmlReader( in ), strict );
823 }
824
825
826
827
828
829
830
831
832
833 public ExpressionDocumentation read( InputStream in )
834 throws IOException, XmlPullParserException
835 {
836 return read( ReaderFactory.newXmlReader( in ) );
837 }
838
839
840
841
842
843
844
845
846
847
848 private Expression parseExpression( XmlPullParser parser, boolean strict )
849 throws IOException, XmlPullParserException
850 {
851 String tagName = parser.getName();
852 Expression expression = new Expression();
853 for ( int i = parser.getAttributeCount() - 1; i >= 0; i-- )
854 {
855 String name = parser.getAttributeName( i );
856 String value = parser.getAttributeValue( i );
857
858 if ( name.indexOf( ':' ) >= 0 )
859 {
860
861 }
862 else
863 {
864 checkUnknownAttribute( parser, name, tagName, strict );
865 }
866 }
867 java.util.Set parsed = new java.util.HashSet();
868 while ( ( strict ? parser.nextTag() : nextTag( parser ) ) == XmlPullParser.START_TAG )
869 {
870 if ( checkFieldWithDuplicate( parser, "syntax", null, parsed ) )
871 {
872 expression.setSyntax( getTrimmedValue( parser.nextText() ) );
873 }
874 else if ( checkFieldWithDuplicate( parser, "description", null, parsed ) )
875 {
876 expression.setDescription( getTrimmedValue( parser.nextText() ) );
877 }
878 else if ( checkFieldWithDuplicate( parser, "configuration", null, parsed ) )
879 {
880 expression.setConfiguration( getTrimmedValue( parser.nextText() ) );
881 }
882 else if ( checkFieldWithDuplicate( parser, "cliOptions", null, parsed ) )
883 {
884 while ( parser.nextTag() == XmlPullParser.START_TAG )
885 {
886 if ( "cliOption".equals( parser.getName() ) )
887 {
888 String key = null;
889 String value = null;
890
891 while ( parser.nextTag() == XmlPullParser.START_TAG )
892 {
893 if ( "key".equals( parser.getName() ) )
894 {
895 key = parser.nextText();
896 }
897 else if ( "value".equals( parser.getName() ) )
898 {
899 value = parser.nextText().trim();
900 }
901 else
902 {
903 parser.nextText();
904 }
905 }
906 expression.addCliOption( key, value );
907 }
908 parser.next();
909 }
910 }
911 else if ( checkFieldWithDuplicate( parser, "apiMethods", null, parsed ) )
912 {
913 while ( parser.nextTag() == XmlPullParser.START_TAG )
914 {
915 if ( "apiMethod".equals( parser.getName() ) )
916 {
917 String key = null;
918 String value = null;
919
920 while ( parser.nextTag() == XmlPullParser.START_TAG )
921 {
922 if ( "key".equals( parser.getName() ) )
923 {
924 key = parser.nextText();
925 }
926 else if ( "value".equals( parser.getName() ) )
927 {
928 value = parser.nextText().trim();
929 }
930 else
931 {
932 parser.nextText();
933 }
934 }
935 expression.addApiMethod( key, value );
936 }
937 parser.next();
938 }
939 }
940 else if ( checkFieldWithDuplicate( parser, "deprecation", null, parsed ) )
941 {
942 expression.setDeprecation( getTrimmedValue( parser.nextText() ) );
943 }
944 else if ( checkFieldWithDuplicate( parser, "ban", null, parsed ) )
945 {
946 expression.setBan( getTrimmedValue( parser.nextText() ) );
947 }
948 else if ( checkFieldWithDuplicate( parser, "editable", null, parsed ) )
949 {
950 expression.setEditable( getBooleanValue( getTrimmedValue( parser.nextText() ), "editable", parser, "true" ) );
951 }
952 else
953 {
954 checkUnknownElement( parser, strict );
955 }
956 }
957 return expression;
958 }
959
960
961
962
963
964
965
966
967
968
969 private ExpressionDocumentation parseExpressionDocumentation( XmlPullParser parser, boolean strict )
970 throws IOException, XmlPullParserException
971 {
972 String tagName = parser.getName();
973 ExpressionDocumentation expressionDocumentation = new ExpressionDocumentation();
974 for ( int i = parser.getAttributeCount() - 1; i >= 0; i-- )
975 {
976 String name = parser.getAttributeName( i );
977 String value = parser.getAttributeValue( i );
978
979 if ( name.indexOf( ':' ) >= 0 )
980 {
981
982 }
983 else if ( "xmlns".equals( name ) )
984 {
985
986 }
987 else
988 {
989 checkUnknownAttribute( parser, name, tagName, strict );
990 }
991 }
992 java.util.Set parsed = new java.util.HashSet();
993 while ( ( strict ? parser.nextTag() : nextTag( parser ) ) == XmlPullParser.START_TAG )
994 {
995 if ( checkFieldWithDuplicate( parser, "expressions", null, parsed ) )
996 {
997 java.util.List expressions = new java.util.ArrayList
998 expressionDocumentation.setExpressions( expressions );
999 while ( parser.nextTag() == XmlPullParser.START_TAG )
1000 {
1001 if ( "expression".equals( parser.getName() ) )
1002 {
1003 expressions.add( parseExpression( parser, strict ) );
1004 }
1005 else
1006 {
1007 checkUnknownElement( parser, strict );
1008 }
1009 }
1010 }
1011 else
1012 {
1013 checkUnknownElement( parser, strict );
1014 }
1015 }
1016 return expressionDocumentation;
1017 }
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028 private ExpressionDocumentation read( XmlPullParser parser, boolean strict )
1029 throws IOException, XmlPullParserException
1030 {
1031 int eventType = parser.getEventType();
1032 while ( eventType != XmlPullParser.END_DOCUMENT )
1033 {
1034 if ( eventType == XmlPullParser.START_TAG )
1035 {
1036 if ( strict && ! "paramdoc".equals( parser.getName() ) )
1037 {
1038 throw new XmlPullParserException( "Expected root element 'paramdoc' but found '" + parser.getName() + "'", parser, null );
1039 }
1040 ExpressionDocumentation expressionDocumentation = parseExpressionDocumentation( parser, strict );
1041 expressionDocumentation.setModelEncoding( parser.getInputEncoding() );
1042 return expressionDocumentation;
1043 }
1044 eventType = parser.next();
1045 }
1046 throw new XmlPullParserException( "Expected root element 'paramdoc' but found no element at all: invalid XML document", parser, null );
1047 }
1048
1049
1050
1051
1052
1053
1054 public void setAddDefaultEntities( boolean addDefaultEntities )
1055 {
1056 this.addDefaultEntities = addDefaultEntities;
1057 }
1058
1059 }