View Javadoc

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