/*
    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at
    
       http://www.apache.org/licenses/LICENSE-2.0
   
   Unless required by applicable law or agreed to in writing,
   software distributed under the License is distributed on an
   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   KIND, either express or implied.  See the License for the
   specific language governing permissions and limitations
   under the License.
   =================== DO NOT EDIT THIS FILE ====================
   Generated by Modello 2.5.1,
   any modifications will be overwritten.
   ==============================================================
   */
  
  package org.apache.maven.plugins.pmd.model.io.xpp3;
  
    //---------------------------------/
   //- Imported classes and packages -/
  //---------------------------------/
  
  import java.io.IOException;
  import java.io.InputStream;
  import java.io.Reader;
  import java.text.DateFormat;
  import org.apache.maven.plugins.pmd.model.CpdErrorDetail;
  import org.apache.maven.plugins.pmd.model.CpdFile;
  import org.apache.maven.plugins.pmd.model.Duplication;
  import org.codehaus.plexus.util.xml.XmlStreamReader;
  import org.codehaus.plexus.util.xml.pull.EntityReplacementMap;
  import org.codehaus.plexus.util.xml.pull.MXParser;
  import org.codehaus.plexus.util.xml.pull.XmlPullParser;
  import org.codehaus.plexus.util.xml.pull.XmlPullParserException;
  
  /**
   * Class CpdXpp3Reader.
   * 
   * @version $Revision$ $Date$
   */
  @SuppressWarnings( "all" )
  public class CpdXpp3Reader
  {
  
        //--------------------------/
       //- Class/Member Variables -/
      //--------------------------/
  
      /**
       * If set the parser will be loaded with all single characters
       * from the XHTML specification.
       * The entities used:
       * <ul>
       * <li>http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent</li>
       * <li>http://www.w3.org/TR/xhtml1/DTD/xhtml-special.ent</li>
       * <li>http://www.w3.org/TR/xhtml1/DTD/xhtml-symbol.ent</li>
       * </ul>
       */
      private boolean addDefaultEntities = true;
  
      /**
       * Field contentTransformer.
       */
      public final ContentTransformer contentTransformer;
  
  
        //----------------/
       //- Constructors -/
      //----------------/
  
      public CpdXpp3Reader()
      {
          this( new ContentTransformer()
          {
              public String transform( String source, String fieldName )
              {
                  return source;
              }
          } );
      } //-- org.apache.maven.plugins.pmd.model.io.xpp3.CpdXpp3Reader()
  
      public CpdXpp3Reader(ContentTransformer contentTransformer)
      {
          this.contentTransformer = contentTransformer;
      } //-- org.apache.maven.plugins.pmd.model.io.xpp3.CpdXpp3Reader(ContentTransformer)
  
  
        //-----------/
       //- Methods -/
      //-----------/
  
      /**
      * Method checkFieldWithDuplicate.
      * 
      * @param parser a parser object.
      * @param parsed a parsed object.
      * @param alias a alias object.
      * @param tagName a tagName object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return boolean
      */
     private boolean checkFieldWithDuplicate( XmlPullParser parser, String tagName, String alias, java.util.Set<String> parsed )
         throws XmlPullParserException
     {
         if ( !( parser.getName().equals( tagName ) || parser.getName().equals( alias ) ) )
         {
             return false;
         }
         if ( !parsed.add( tagName ) )
         {
             throw new XmlPullParserException( "Duplicated tag: '" + tagName + "'", parser, null );
         }
         return true;
     } //-- boolean checkFieldWithDuplicate( XmlPullParser, String, String, java.util.Set )
 
     /**
      * Method checkUnknownAttribute.
      * 
      * @param parser a parser object.
      * @param strict a strict object.
      * @param tagName a tagName object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @throws IOException IOException if any.
      */
     private void checkUnknownAttribute( XmlPullParser parser, String attribute, String tagName, boolean strict )
         throws XmlPullParserException, IOException
     {
         // strictXmlAttributes = true for model: if strict == true, not only elements are checked but attributes too
         if ( strict )
         {
             throw new XmlPullParserException( "Unknown attribute '" + attribute + "' for tag '" + tagName + "'", parser, null );
         }
     } //-- void checkUnknownAttribute( XmlPullParser, String, String, boolean )
 
     /**
      * Method checkUnknownElement.
      * 
      * @param parser a parser object.
      * @param strict a strict object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @throws IOException IOException if any.
      */
     private void checkUnknownElement( XmlPullParser parser, boolean strict )
         throws XmlPullParserException, IOException
     {
         if ( strict )
         {
             throw new XmlPullParserException( "Unrecognised tag: '" + parser.getName() + "'", parser, null );
         }
 
         for ( int unrecognizedTagCount = 1; unrecognizedTagCount > 0; )
         {
             int eventType = parser.next();
             if ( eventType == XmlPullParser.START_TAG )
             {
                 unrecognizedTagCount++;
             }
             else if ( eventType == XmlPullParser.END_TAG )
             {
                 unrecognizedTagCount--;
             }
         }
     } //-- void checkUnknownElement( XmlPullParser, boolean )
 
     /**
      * Returns the state of the "add default entities" flag.
      * 
      * @return boolean
      */
     public boolean getAddDefaultEntities()
     {
         return addDefaultEntities;
     } //-- boolean getAddDefaultEntities()
 
     /**
      * Method getBooleanValue.
      * 
      * @param s a s object.
      * @param parser a parser object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return boolean
      */
     private boolean getBooleanValue( String s, String attribute, XmlPullParser parser )
         throws XmlPullParserException
     {
         return getBooleanValue( s, attribute, parser, null );
     } //-- boolean getBooleanValue( String, String, XmlPullParser )
 
     /**
      * Method getBooleanValue.
      * 
      * @param s a s object.
      * @param defaultValue a defaultValue object.
      * @param parser a parser object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return boolean
      */
     private boolean getBooleanValue( String s, String attribute, XmlPullParser parser, String defaultValue )
         throws XmlPullParserException
     {
         if ( s != null && s.length() != 0 )
         {
             return Boolean.valueOf( s ).booleanValue();
         }
         if ( defaultValue != null )
         {
             return Boolean.valueOf( defaultValue ).booleanValue();
         }
         return false;
     } //-- boolean getBooleanValue( String, String, XmlPullParser, String )
 
     /**
      * Method getByteValue.
      * 
      * @param s a s object.
      * @param strict a strict object.
      * @param parser a parser object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return byte
      */
     private byte getByteValue( String s, String attribute, XmlPullParser parser, boolean strict )
         throws XmlPullParserException
     {
         if ( s != null )
         {
             try
             {
                 return Byte.valueOf( s ).byteValue();
             }
             catch ( NumberFormatException nfe )
             {
                 if ( strict )
                 {
                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a byte", parser, nfe );
                 }
             }
         }
         return 0;
     } //-- byte getByteValue( String, String, XmlPullParser, boolean )
 
     /**
      * Method getCharacterValue.
      * 
      * @param s a s object.
      * @param parser a parser object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return char
      */
     private char getCharacterValue( String s, String attribute, XmlPullParser parser )
         throws XmlPullParserException
     {
         if ( s != null )
         {
             return s.charAt( 0 );
         }
         return 0;
     } //-- char getCharacterValue( String, String, XmlPullParser )
 
     /**
      * Method getDateValue.
      * 
      * @param s a s object.
      * @param parser a parser object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return Date
      */
     private java.util.Date getDateValue( String s, String attribute, XmlPullParser parser )
         throws XmlPullParserException
     {
         return getDateValue( s, attribute, null, parser );
     } //-- java.util.Date getDateValue( String, String, XmlPullParser )
 
     /**
      * Method getDateValue.
      * 
      * @param s a s object.
      * @param parser a parser object.
      * @param dateFormat a dateFormat object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return Date
      */
     private java.util.Date getDateValue( String s, String attribute, String dateFormat, XmlPullParser parser )
         throws XmlPullParserException
     {
         if ( s != null )
         {
             String effectiveDateFormat = dateFormat;
             if ( dateFormat == null )
             {
                 effectiveDateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSS";
             }
             if ( "long".equals( effectiveDateFormat ) )
             {
                 try
                 {
                     return new java.util.Date( Long.parseLong( s ) );
                 }
                 catch ( NumberFormatException e )
                 {
                     throw new XmlPullParserException( e.getMessage(), parser, e );
                 }
             }
             else
             {
                 try
                 {
                     DateFormat dateParser = new java.text.SimpleDateFormat( effectiveDateFormat, java.util.Locale.US );
                     return dateParser.parse( s );
                 }
                 catch ( java.text.ParseException e )
                 {
                     throw new XmlPullParserException( e.getMessage(), parser, e );
                 }
             }
         }
         return null;
     } //-- java.util.Date getDateValue( String, String, String, XmlPullParser )
 
     /**
      * Method getDoubleValue.
      * 
      * @param s a s object.
      * @param strict a strict object.
      * @param parser a parser object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return double
      */
     private double getDoubleValue( String s, String attribute, XmlPullParser parser, boolean strict )
         throws XmlPullParserException
     {
         if ( s != null )
         {
             try
             {
                 return Double.valueOf( s ).doubleValue();
             }
             catch ( NumberFormatException nfe )
             {
                 if ( strict )
                 {
                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a floating point number", parser, nfe );
                 }
             }
         }
         return 0;
     } //-- double getDoubleValue( String, String, XmlPullParser, boolean )
 
     /**
      * Method getFloatValue.
      * 
      * @param s a s object.
      * @param strict a strict object.
      * @param parser a parser object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return float
      */
     private float getFloatValue( String s, String attribute, XmlPullParser parser, boolean strict )
         throws XmlPullParserException
     {
         if ( s != null )
         {
             try
             {
                 return Float.valueOf( s ).floatValue();
             }
             catch ( NumberFormatException nfe )
             {
                 if ( strict )
                 {
                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a floating point number", parser, nfe );
                 }
             }
         }
         return 0;
     } //-- float getFloatValue( String, String, XmlPullParser, boolean )
 
     /**
      * Method getIntegerValue.
      * 
      * @param s a s object.
      * @param strict a strict object.
      * @param parser a parser object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return int
      */
     private int getIntegerValue( String s, String attribute, XmlPullParser parser, boolean strict )
         throws XmlPullParserException
     {
         if ( s != null )
         {
             try
             {
                 return Integer.valueOf( s ).intValue();
             }
             catch ( NumberFormatException nfe )
             {
                 if ( strict )
                 {
                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be an integer", parser, nfe );
                 }
             }
         }
         return 0;
     } //-- int getIntegerValue( String, String, XmlPullParser, boolean )
 
     /**
      * Method getLongValue.
      * 
      * @param s a s object.
      * @param strict a strict object.
      * @param parser a parser object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return long
      */
     private long getLongValue( String s, String attribute, XmlPullParser parser, boolean strict )
         throws XmlPullParserException
     {
         if ( s != null )
         {
             try
             {
                 return Long.valueOf( s ).longValue();
             }
             catch ( NumberFormatException nfe )
             {
                 if ( strict )
                 {
                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a long integer", parser, nfe );
                 }
             }
         }
         return 0;
     } //-- long getLongValue( String, String, XmlPullParser, boolean )
 
     /**
      * Method getRequiredAttributeValue.
      * 
      * @param s a s object.
      * @param strict a strict object.
      * @param parser a parser object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return String
      */
     private String getRequiredAttributeValue( String s, String attribute, XmlPullParser parser, boolean strict )
         throws XmlPullParserException
     {
         if ( s == null )
         {
             if ( strict )
             {
                 throw new XmlPullParserException( "Missing required value for attribute '" + attribute + "'", parser, null );
             }
         }
         return s;
     } //-- String getRequiredAttributeValue( String, String, XmlPullParser, boolean )
 
     /**
      * Method getShortValue.
      * 
      * @param s a s object.
      * @param strict a strict object.
      * @param parser a parser object.
      * @param attribute a attribute object.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return short
      */
     private short getShortValue( String s, String attribute, XmlPullParser parser, boolean strict )
         throws XmlPullParserException
     {
         if ( s != null )
         {
             try
             {
                 return Short.valueOf( s ).shortValue();
             }
             catch ( NumberFormatException nfe )
             {
                 if ( strict )
                 {
                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a short integer", parser, nfe );
                 }
             }
         }
         return 0;
     } //-- short getShortValue( String, String, XmlPullParser, boolean )
 
     /**
      * Method getTrimmedValue.
      * 
      * @param s a s object.
      * @return String
      */
     private String getTrimmedValue( String s )
     {
         if ( s != null )
         {
             s = s.trim();
         }
         return s;
     } //-- String getTrimmedValue( String )
 
     /**
      * Method interpolatedTrimmed.
      * 
      * @param value a value object.
      * @param context a context object.
      * @return String
      */
     private String interpolatedTrimmed( String value, String context )
     {
         return getTrimmedValue( contentTransformer.transform( value, context ) );
     } //-- String interpolatedTrimmed( String, String )
 
     /**
      * Method nextTag.
      * 
      * @param parser a parser object.
      * @throws IOException IOException if any.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return int
      */
     private int nextTag( XmlPullParser parser )
         throws IOException, XmlPullParserException
     {
         int eventType = parser.next();
         if ( eventType == XmlPullParser.TEXT )
         {
             eventType = parser.next();
         }
         if ( eventType != XmlPullParser.START_TAG && eventType != XmlPullParser.END_TAG )
         {
             throw new XmlPullParserException( "expected START_TAG or END_TAG not " + XmlPullParser.TYPES[eventType], parser, null );
         }
         return eventType;
     } //-- int nextTag( XmlPullParser )
 
     /**
      * Method read.
      * 
      * @param parser a parser object.
      * @param strict a strict object.
      * @throws IOException IOException if any.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return CpdErrorDetail
      */
     public CpdErrorDetail read( XmlPullParser parser, boolean strict )
         throws IOException, XmlPullParserException
     {
         CpdErrorDetail cpdErrorDetail = null;
         int eventType = parser.getEventType();
         boolean parsed = false;
         while ( eventType != XmlPullParser.END_DOCUMENT )
         {
             if ( eventType == XmlPullParser.START_TAG )
             {
                 if ( strict && ! "pmd-cpd".equals( parser.getName() ) )
                 {
                     throw new XmlPullParserException( "Expected root element 'pmd-cpd' but found '" + parser.getName() + "'", parser, null );
                 }
                 else if ( parsed )
                 {
                     // fallback, already expected a XmlPullParserException due to invalid XML
                     throw new XmlPullParserException( "Duplicated tag: 'pmd-cpd'", parser, null );
                 }
                 cpdErrorDetail = parseCpdErrorDetail( parser, strict );
                 cpdErrorDetail.setModelEncoding( parser.getInputEncoding() );
                 parsed = true;
             }
             eventType = parser.next();
         }
         if ( parsed )
         {
             return cpdErrorDetail;
         }
         throw new XmlPullParserException( "Expected root element 'pmd-cpd' but found no element at all: invalid XML document", parser, null );
     } //-- CpdErrorDetail read( XmlPullParser, boolean )
 
     /**
      * @see XmlStreamReader
      * 
      * @param reader a reader object.
      * @param strict a strict object.
      * @throws IOException IOException if any.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return CpdErrorDetail
      */
     public CpdErrorDetail read( Reader reader, boolean strict )
         throws IOException, XmlPullParserException
     {
         XmlPullParser parser = addDefaultEntities ? new MXParser(EntityReplacementMap.defaultEntityReplacementMap) : new MXParser( );
 
         parser.setInput( reader );
 
 
         return read( parser, strict );
     } //-- CpdErrorDetail read( Reader, boolean )
 
     /**
      * @see XmlStreamReader
      * 
      * @param reader a reader object.
      * @throws IOException IOException if any.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return CpdErrorDetail
      */
     public CpdErrorDetail read( Reader reader )
         throws IOException, XmlPullParserException
     {
         return read( reader, true );
     } //-- CpdErrorDetail read( Reader )
 
     /**
      * Method read.
      * 
      * @param in a in object.
      * @param strict a strict object.
      * @throws IOException IOException if any.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return CpdErrorDetail
      */
     public CpdErrorDetail read( InputStream in, boolean strict )
         throws IOException, XmlPullParserException
     {
         return read( new XmlStreamReader( in ), strict );
     } //-- CpdErrorDetail read( InputStream, boolean )
 
     /**
      * Method read.
      * 
      * @param in a in object.
      * @throws IOException IOException if any.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return CpdErrorDetail
      */
     public CpdErrorDetail read( InputStream in )
         throws IOException, XmlPullParserException
     {
         return read( new XmlStreamReader( in ) );
     } //-- CpdErrorDetail read( InputStream )
 
     /**
      * Method parseCpdErrorDetail.
      * 
      * @param parser a parser object.
      * @param strict a strict object.
      * @throws IOException IOException if any.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return CpdErrorDetail
      */
     private CpdErrorDetail parseCpdErrorDetail( XmlPullParser parser, boolean strict )
         throws IOException, XmlPullParserException
     {
         String tagName = parser.getName();
         CpdErrorDetail cpdErrorDetail = new CpdErrorDetail();
         for ( int i = parser.getAttributeCount() - 1; i >= 0; i-- )
         {
             String name = parser.getAttributeName( i );
             String value = parser.getAttributeValue( i );
 
             if ( name.indexOf( ':' ) >= 0 )
             {
                 // just ignore attributes with non-default namespace (for example: xmlns:xsi)
             }
             else if ( "xmlns".equals( name ) )
             {
                 // ignore xmlns attribute in root class, which is a reserved attribute name
             }
             else
             {
                 checkUnknownAttribute( parser, name, tagName, strict );
             }
         }
         java.util.Set<String> parsed = new java.util.HashSet<String>();
         while ( ( strict ? parser.nextTag() : nextTag( parser ) ) == XmlPullParser.START_TAG )
         {
             if ( "duplication".equals( parser.getName() ) )
             {
                 java.util.List<Duplication> duplications = cpdErrorDetail.getDuplications();
                 if ( duplications == null )
                 {
                     duplications = new java.util.ArrayList<Duplication>();
                 }
                 duplications.add( parseDuplication( parser, strict ) );
                 cpdErrorDetail.setDuplications( duplications );
             }
             else
             {
                 checkUnknownElement( parser, strict );
             }
         }
         return cpdErrorDetail;
     } //-- CpdErrorDetail parseCpdErrorDetail( XmlPullParser, boolean )
 
     /**
      * Method parseCpdFile.
      * 
      * @param parser a parser object.
      * @param strict a strict object.
      * @throws IOException IOException if any.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return CpdFile
      */
     private CpdFile parseCpdFile( XmlPullParser parser, boolean strict )
         throws IOException, XmlPullParserException
     {
         String tagName = parser.getName();
         CpdFile cpdFile = new CpdFile();
         for ( int i = parser.getAttributeCount() - 1; i >= 0; i-- )
         {
             String name = parser.getAttributeName( i );
             String value = parser.getAttributeValue( i );
 
             if ( name.indexOf( ':' ) >= 0 )
             {
                 // just ignore attributes with non-default namespace (for example: xmlns:xsi)
             }
             else if ( "line".equals( name ) )
             {
                 cpdFile.setLine( getIntegerValue( interpolatedTrimmed( value, "line" ), "line", parser, strict ) );
             }
             else if ( "path".equals( name ) )
             {
                 cpdFile.setPath( interpolatedTrimmed( value, "path" ) );
             }
             else
             {
                 checkUnknownAttribute( parser, name, tagName, strict );
             }
         }
         java.util.Set<String> parsed = new java.util.HashSet<String>();
         while ( ( strict ? parser.nextTag() : nextTag( parser ) ) == XmlPullParser.START_TAG )
         {
             checkUnknownElement( parser, strict );
         }
         return cpdFile;
     } //-- CpdFile parseCpdFile( XmlPullParser, boolean )
 
     /**
      * Method parseDuplication.
      * 
      * @param parser a parser object.
      * @param strict a strict object.
      * @throws IOException IOException if any.
      * @throws XmlPullParserException XmlPullParserException if
      * any.
      * @return Duplication
      */
     private Duplication parseDuplication( XmlPullParser parser, boolean strict )
         throws IOException, XmlPullParserException
     {
         String tagName = parser.getName();
         Duplication duplication = new Duplication();
         for ( int i = parser.getAttributeCount() - 1; i >= 0; i-- )
         {
             String name = parser.getAttributeName( i );
             String value = parser.getAttributeValue( i );
 
             if ( name.indexOf( ':' ) >= 0 )
             {
                 // just ignore attributes with non-default namespace (for example: xmlns:xsi)
             }
             else if ( "lines".equals( name ) )
             {
                 duplication.setLines( getIntegerValue( interpolatedTrimmed( value, "lines" ), "lines", parser, strict ) );
             }
             else if ( "tokens".equals( name ) )
             {
                 duplication.setTokens( getIntegerValue( interpolatedTrimmed( value, "tokens" ), "tokens", parser, strict ) );
             }
             else
             {
                 checkUnknownAttribute( parser, name, tagName, strict );
             }
         }
         java.util.Set<String> parsed = new java.util.HashSet<String>();
         while ( ( strict ? parser.nextTag() : nextTag( parser ) ) == XmlPullParser.START_TAG )
         {
             if ( "file".equals( parser.getName() ) )
             {
                 java.util.List<CpdFile> files = duplication.getFiles();
                 if ( files == null )
                 {
                     files = new java.util.ArrayList<CpdFile>();
                 }
                 files.add( parseCpdFile( parser, strict ) );
                 duplication.setFiles( files );
             }
             else if ( checkFieldWithDuplicate( parser, "codefragment", null, parsed ) )
             {
                 duplication.setCodefragment( interpolatedTrimmed( parser.nextText(), "codefragment" ) );
             }
             else
             {
                 checkUnknownElement( parser, strict );
             }
         }
         return duplication;
     } //-- Duplication parseDuplication( XmlPullParser, boolean )
 
     /**
      * Sets the state of the "add default entities" flag.
      * 
      * @param addDefaultEntities a addDefaultEntities object.
      */
     public void setAddDefaultEntities( boolean addDefaultEntities )
     {
         this.addDefaultEntities = addDefaultEntities;
     } //-- void setAddDefaultEntities( boolean )
 
     public static interface ContentTransformer
 {
     /**
      * Interpolate the value read from the xpp3 document
      * @param source The source value
      * @param fieldName A description of the field being interpolated. The implementation may use this to
      *                           log stuff.
      * @return The interpolated value.
      */
     String transform( String source, String fieldName );
 }
 
 }