package org.apache.maven.plugin.doap;
   
   /*
    * 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.
   */
  
  import java.io.File;
  import java.io.FileNotFoundException;
  import java.io.IOException;
  import java.io.InputStream;
  import java.lang.reflect.Method;
  import java.net.MalformedURLException;
  import java.net.SocketTimeoutException;
  import java.net.URL;
  import java.text.DateFormat;
  import java.util.ArrayList;
  import java.util.Collection;
  import java.util.Date;
  import java.util.HashMap;
  import java.util.LinkedList;
  import java.util.List;
  import java.util.Locale;
  import java.util.Map;
  import java.util.StringTokenizer;
  import java.util.WeakHashMap;
  import java.util.Map.Entry;
  import java.util.regex.Matcher;
  import java.util.regex.Pattern;
  import java.util.Set;
  import java.util.Properties;
  
  import org.apache.commons.httpclient.Credentials;
  import org.apache.commons.httpclient.HttpClient;
  import org.apache.commons.httpclient.HttpStatus;
  import org.apache.commons.httpclient.MultiThreadedHttpConnectionManager;
  import org.apache.commons.httpclient.UsernamePasswordCredentials;
  import org.apache.commons.httpclient.auth.AuthScope;
  import org.apache.commons.httpclient.methods.GetMethod;
  import org.apache.commons.httpclient.params.HttpClientParams;
  import org.apache.commons.httpclient.params.HttpMethodParams;
  import org.apache.maven.model.Contributor;
  import org.apache.maven.project.MavenProject;
  import org.apache.maven.settings.Proxy;
  import org.apache.maven.settings.Settings;
  import org.apache.maven.wagon.proxy.ProxyInfo;
  import org.apache.maven.wagon.proxy.ProxyUtils;
  import org.codehaus.plexus.i18n.I18N;
  import org.codehaus.plexus.interpolation.EnvarBasedValueSource;
  import org.codehaus.plexus.interpolation.InterpolationException;
  import org.codehaus.plexus.interpolation.ObjectBasedValueSource;
  import org.codehaus.plexus.interpolation.PrefixedObjectValueSource;
  import org.codehaus.plexus.interpolation.PropertiesBasedValueSource;
  import org.codehaus.plexus.interpolation.RegexBasedInterpolator;
  import org.codehaus.plexus.util.IOUtil;
  import org.codehaus.plexus.util.StringUtils;
  import org.codehaus.plexus.util.introspection.ClassMap;
  import org.codehaus.plexus.util.xml.XMLWriter;
  import org.codehaus.plexus.util.xml.XmlWriterUtil;
  
  import com.hp.hpl.jena.rdf.model.Model;
  import com.hp.hpl.jena.rdf.model.ModelFactory;
  import com.hp.hpl.jena.rdf.model.RDFReader;
  import com.hp.hpl.jena.rdf.model.impl.RDFDefaultErrorHandler;
  
  /**
   * Utility class for {@link DoapMojo} class.
   *
   * @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
   * @version $Id: DoapUtil.html 815337 2012-05-01 21:52:10Z hboutemy $
   * @since 1.0
   */
  public class DoapUtil
  {
      /** Email regex */
      private static final String EMAIL_REGEX =
          "^[_A-Za-z0-9-]+(\\.[_A-Za-z0-9-]+)*@[A-Za-z0-9]+(\\.[A-Za-z0-9]+)*(\\.[A-Za-z]{2,})$";
  
      /** Email pattern */
      private static final Pattern EMAIL_PATTERN = Pattern.compile( EMAIL_REGEX );
  
      /** Magic number to repeat '=' */
      private static final int REPEAT_EQUALS = 21;
  
      /** The default timeout used when fetching url, i.e. 2000. */
     public static final int DEFAULT_TIMEOUT = 2000;
 
     /** RDF resource attribute */
     protected static final String RDF_RESOURCE = "rdf:resource";
 
     /** RDF nodeID attribute */
     protected static final String RDF_NODE_ID = "rdf:nodeID";
 
     /** DoaP Organizations stored by name */
     private static Map<String, DoapUtil.Organization> organizations = new HashMap<String, DoapUtil.Organization>();
 
     /**
      * Write comments in the DOAP file header
      *
      * @param writer not null
      */
     public static void writeHeader( XMLWriter writer )
     {
         XmlWriterUtil.writeLineBreak( writer );
 
         XmlWriterUtil.writeCommentLineBreak( writer );
         XmlWriterUtil.writeComment( writer, StringUtils.repeat( "=", REPEAT_EQUALS ) + " - DO NOT EDIT THIS FILE! - "
             + StringUtils.repeat( "=", REPEAT_EQUALS ) );
         XmlWriterUtil.writeCommentLineBreak( writer );
         XmlWriterUtil.writeComment( writer, " " );
         XmlWriterUtil.writeComment( writer, "Any modifications will be overwritten." );
         XmlWriterUtil.writeComment( writer, " " );
         DateFormat dateFormat = DateFormat.getDateTimeInstance( DateFormat.SHORT, DateFormat.SHORT, Locale.US );
         XmlWriterUtil.writeComment( writer, "Generated by Maven Doap Plugin " + getPluginVersion() + " on "
             + dateFormat.format( new Date( System.currentTimeMillis() ) ) );
         XmlWriterUtil.writeComment( writer, "See: http://maven.apache.org/plugins/maven-doap-plugin/" );
         XmlWriterUtil.writeComment( writer, " " );
         XmlWriterUtil.writeCommentLineBreak( writer );
 
         XmlWriterUtil.writeLineBreak( writer );
     }
 
     /**
      * Write comment.
      *
      * @param writer not null
      * @param comment not null
      * @throws IllegalArgumentException if comment is null or empty
      * @since 1.1
      */
     public static void writeComment( XMLWriter writer, String comment )
         throws IllegalArgumentException
     {
         if ( StringUtils.isEmpty( comment ) )
         {
             throw new IllegalArgumentException( "comment should be defined" );
         }
 
         XmlWriterUtil.writeLineBreak( writer );
         XmlWriterUtil.writeCommentText( writer, comment, 2 );
     }
 
     /**
      * @param writer not null
      * @param xmlnsPrefix could be null
      * @param name not null
      * @param value could be null. In this case, the element is not written.
      * @throws IllegalArgumentException if name is null or empty
      */
     public static void writeElement( XMLWriter writer, String xmlnsPrefix, String name, String value )
         throws IllegalArgumentException
     {
         if ( StringUtils.isEmpty( name ) )
         {
             throw new IllegalArgumentException( "name should be defined" );
         }
 
         if ( value != null )
         {
             writeStartElement( writer, xmlnsPrefix, name );
             writer.writeText( value );
             writer.endElement();
         }
     }
 
     /**
      * @param writer not null
      * @param xmlnsPrefix could be null
      * @param name not null
      * @param lang not null
      * @param value could be null. In this case, the element is not written.
      * @throws IllegalArgumentException if name is null or empty
      */
     public static void writeElement( XMLWriter writer, String xmlnsPrefix, String name, String value, String lang )
         throws IllegalArgumentException
     {
         if ( StringUtils.isEmpty( lang ) )
         {
             writeElement( writer, xmlnsPrefix, name, value );
             return;
         }
 
         if ( StringUtils.isEmpty( name ) )
         {
             throw new IllegalArgumentException( "name should be defined" );
         }
 
         if ( value != null )
         {
             writeStartElement( writer, xmlnsPrefix, name );
             writer.addAttribute( "xml:lang", lang );
             writer.writeText( value );
             writer.endElement();
         }
     }
 
     /**
      * @param writer not null
      * @param xmlnsPrefix could be null
      * @param name not null
      * @throws IllegalArgumentException if name is null or empty
      * @since 1.1
      */
     public static void writeStartElement( XMLWriter writer, String xmlnsPrefix, String name )
         throws IllegalArgumentException
     {
         if ( StringUtils.isEmpty( name ) )
         {
             throw new IllegalArgumentException( "name should be defined" );
         }
 
         if ( StringUtils.isNotEmpty( xmlnsPrefix ) )
         {
             writer.startElement( xmlnsPrefix + ":" + name );
         }
         else
         {
             writer.startElement( name );
         }
     }
 
     /**
      * @param writer not null
      * @param xmlnsPrefix could be null
      * @param name not null
      * @param value could be null. In this case, the element is not written.
      * @throws IllegalArgumentException if name is null or empty
      */
     public static void writeRdfResourceElement( XMLWriter writer, String xmlnsPrefix, String name, String value )
         throws IllegalArgumentException
     {
         if ( StringUtils.isEmpty( name ) )
         {
             throw new IllegalArgumentException( "name should be defined" );
         }
 
         if ( value != null )
         {
             writeStartElement( writer, xmlnsPrefix, name );
             writer.addAttribute( RDF_RESOURCE, value );
             writer.endElement();
         }
     }
 
     /**
      * @param writer not null
      * @param name not null
      * @param value could be null. In this case, the element is not written.
      * @throws IllegalArgumentException if name is null or empty
      */
     public static void writeRdfNodeIdElement( XMLWriter writer, String xmlnsPrefix, String name, String value )
         throws IllegalArgumentException
     {
         if ( StringUtils.isEmpty( name ) )
         {
             throw new IllegalArgumentException( "name should be defined" );
         }
 
         if ( value != null )
         {
             writeStartElement( writer, xmlnsPrefix, name );
             writer.addAttribute( RDF_NODE_ID, value );
             writer.endElement();
         }
     }
 
     /**
      * @param i18n the internationalization component
      * @param developersOrContributors list of <code>{@link Contributor}</code>
      * @return a none null list of <code>{@link Contributor}</code> which have a <code>developer</code> DOAP role.
      */
     public static List<Contributor> getContributorsWithDeveloperRole( I18N i18n,
                                                                       List<Contributor> developersOrContributors )
     {
         return filterContributorsByDoapRoles( i18n, developersOrContributors ).get( "developers" );
     }
 
     /**
      * @param i18n the internationalization component
      * @param developersOrContributors list of <code>{@link Contributor}</code>
      * @return a none null list of <code>{@link Contributor}</code> which have a <code>documenter</code> DOAP role.
      */
     public static List<Contributor> getContributorsWithDocumenterRole( I18N i18n,
                                                                        List<Contributor> developersOrContributors )
     {
         return filterContributorsByDoapRoles( i18n, developersOrContributors ).get( "documenters" );
     }
 
     /**
      * @param i18n the internationalization component
      * @param developersOrContributors list of <code>{@link Contributor}</code>
      * @return a none null list of <code>{@link Contributor}</code> which have an <code>helper</code> DOAP role.
      */
     public static List<Contributor> getContributorsWithHelperRole( I18N i18n, List<Contributor> developersOrContributors )
     {
         return filterContributorsByDoapRoles( i18n, developersOrContributors ).get( "helpers" );
     }
 
     /**
      * @param i18n the internationalization component
      * @param developersOrContributors list of <code>{@link Contributor}</code>
      * @return a none null list of <code>{@link Contributor}</code> which have a <code>maintainer</code> DOAP role.
      */
     public static List<Contributor> getContributorsWithMaintainerRole( I18N i18n,
                                                                        List<Contributor> developersOrContributors )
     {
         return filterContributorsByDoapRoles( i18n, developersOrContributors ).get( "maintainers" );
     }
 
     /**
      * @param i18n the internationalization component
      * @param developersOrContributors list of <code>{@link Contributor}</code>
      * @return a none null list of <code>{@link Contributor}</code> which have a <code>tester</code> DOAP role.
      */
     public static List<Contributor> getContributorsWithTesterRole( I18N i18n, List<Contributor> developersOrContributors )
     {
         return filterContributorsByDoapRoles( i18n, developersOrContributors ).get( "testers" );
     }
 
     /**
      * @param i18n the internationalization component
      * @param developersOrContributors list of <code>{@link Contributor}</code>
      * @return a none null list of <code>{@link Contributor}</code> which have a <code>translator</code> DOAP role.
      */
     public static List<Contributor> getContributorsWithTranslatorRole( I18N i18n,
                                                                        List<Contributor> developersOrContributors )
     {
         return filterContributorsByDoapRoles( i18n, developersOrContributors ).get( "translators" );
     }
 
     /**
      * @param i18n the internationalization component
      * @param developersOrContributors list of <code>{@link Contributor}</code>
      * @return a none null list of <code>{@link Contributor}</code> which have an <code>unknown</code> DOAP role.
      */
     public static List<Contributor> getContributorsWithUnknownRole( I18N i18n,
                                                                     List<Contributor> developersOrContributors )
     {
         return filterContributorsByDoapRoles( i18n, developersOrContributors ).get( "unknowns" );
     }
 
     /**
      * Utility class for keeping track of DOAP organizations in the DoaP mojo.
      *
      * @author <a href="mailto:t.fliss@gmail.com">Tim Fliss</a>
      * @version $Id: DoapUtil.html 815337 2012-05-01 21:52:10Z hboutemy $
      * @since 1.1
      */
     public static class Organization
     {
         private String name;
 
         private String url;
 
         private List<String> members = new LinkedList<String>();
 
         public Organization( String name, String url )
         {
             this.name = name;
             this.url = url;
         }
 
         public void setName( String name )
         {
             this.name = name;
         }
 
         public String getName()
         {
             return name;
         }
 
         public void setUrl( String url )
         {
             this.url = url;
         }
 
         public String getUrl()
         {
             return url;
         }
 
         public void addMember( String nodeId )
         {
             members.add( nodeId );
         }
 
         public List<String> getMembers()
         {
             return members;
         }
     }
 
     /**
      * put an organization from the pom file in the organization list.
      *
      * @param name from the pom file (e.g. Yoyodyne)
      * @param url from the pom file (e.g. http://yoyodyne.example.org/about)
      * @return the existing organization if a duplicate, or a new one.
      */
     public static DoapUtil.Organization addOrganization( String name, String url )
     {
         Organization organization = organizations.get( name );
 
         if ( organization == null )
         {
             organization = new DoapUtil.Organization( name, url );
         }
 
         organizations.put( name, organization );
 
         return organization;
     }
 
     // unique RDF blank node index scoped internal to the DOAP file
     private static int nodeNumber = 1;
 
     /**
      * get a unique (within the DoaP file) RDF blank node ID
      *
      * @return the nodeID
      * @see <a href="http://www.w3.org/TR/rdf-syntax-grammar/#section-Syntax-blank-nodes">
      *      http://www.w3.org/TR/rdf-syntax-grammar/#section-Syntax-blank-nodes</a>
      */
     public static String getNodeId()
     {
         return "b" + nodeNumber++;
     }
 
     /**
      * get the set of Organizations that people are members of
      *
      * @return Map.EntrySet of DoapUtil.Organization
      */
     public static Set<Entry<String, DoapUtil.Organization>> getOrganizations()
     {
         return organizations.entrySet();
     }
 
     /**
      * Validate the given DOAP file.
      *
      * @param doapFile not null and should exists.
      * @return an empty list if the DOAP file is valid, otherwise a list of errors.
      * @since 1.1
      */
     public static List<String> validate( File doapFile )
     {
         if ( doapFile == null || !doapFile.isFile() )
         {
             throw new IllegalArgumentException( "The DOAP file should exist" );
         }
 
         Model model = ModelFactory.createDefaultModel();
         RDFReader r = model.getReader( "RDF/XML" );
         r.setProperty( "error-mode", "strict-error" );
         final List<String> errors = new ArrayList<String>();
         r.setErrorHandler( new RDFDefaultErrorHandler()
         {
             @Override
             public void error( Exception e )
             {
                 errors.add( e.getMessage() );
             }
         } );
 
         try
         {
             r.read( model, doapFile.toURI().toURL().toString() );
         }
         catch ( MalformedURLException e )
         {
             // ignored
         }
 
         return errors;
     }
 
     /**
      * @param str not null
      * @return <code>true</code> if the str parameter is a valid email, <code>false</code> otherwise.
      * @since 1.1
      */
     public static boolean isValidEmail( String str )
     {
         if ( StringUtils.isEmpty( str ) )
         {
             return false;
         }
 
         Matcher matcher = EMAIL_PATTERN.matcher( str );
         return matcher.matches();
     }
 
     /**
      * Fetch an URL
      *
      * @param settings the user settings used to fetch the url with an active proxy, if defined.
      * @param url the url to fetch
      * @throws IOException if any
      * @see #DEFAULT_TIMEOUT
      * @since 1.1
      */
     public static void fetchURL( Settings settings, URL url )
         throws IOException
     {
         if ( url == null )
         {
             throw new IllegalArgumentException( "The url is null" );
         }
 
         if ( "file".equals( url.getProtocol() ) )
         {
             InputStream in = null;
             try
             {
                 in = url.openStream();
             }
             finally
             {
                 IOUtil.close( in );
             }
 
             return;
         }
 
         // http, https...
         HttpClient httpClient = new HttpClient( new MultiThreadedHttpConnectionManager() );
         httpClient.getHttpConnectionManager().getParams().setConnectionTimeout( DEFAULT_TIMEOUT );
         httpClient.getHttpConnectionManager().getParams().setSoTimeout( DEFAULT_TIMEOUT );
         httpClient.getParams().setBooleanParameter( HttpClientParams.ALLOW_CIRCULAR_REDIRECTS, true );
 
         // Some web servers don't allow the default user-agent sent by httpClient
         httpClient.getParams().setParameter( HttpMethodParams.USER_AGENT,
                                              "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)" );
 
         if ( settings != null && settings.getActiveProxy() != null )
         {
             Proxy activeProxy = settings.getActiveProxy();
 
             ProxyInfo proxyInfo = new ProxyInfo();
             proxyInfo.setNonProxyHosts( activeProxy.getNonProxyHosts() );
 
             if ( StringUtils.isNotEmpty( activeProxy.getHost() )
                 && !ProxyUtils.validateNonProxyHosts( proxyInfo, url.getHost() ) )
             {
                 httpClient.getHostConfiguration().setProxy( activeProxy.getHost(), activeProxy.getPort() );
 
                 if ( StringUtils.isNotEmpty( activeProxy.getUsername() ) && activeProxy.getPassword() != null )
                 {
                     Credentials credentials =
                         new UsernamePasswordCredentials( activeProxy.getUsername(), activeProxy.getPassword() );
 
                     httpClient.getState().setProxyCredentials( AuthScope.ANY, credentials );
                 }
             }
         }
 
         GetMethod getMethod = new GetMethod( url.toString() );
         try
         {
             int status;
             try
             {
                 status = httpClient.executeMethod( getMethod );
             }
             catch ( SocketTimeoutException e )
             {
                 // could be a sporadic failure, one more retry before we give up
                 status = httpClient.executeMethod( getMethod );
             }
 
             if ( status != HttpStatus.SC_OK )
             {
                 throw new FileNotFoundException( url.toString() );
             }
         }
         finally
         {
             getMethod.releaseConnection();
         }
     }
 
     /**
      * Interpolate a string with project and settings.
      *
      * @param value could be null
      * @param project not null
      * @param settings could be null
      * @return the value trimmed and interpolated or null if the interpolation doesn't work.
      * @since 1.1
      */
     public static String interpolate( String value, final MavenProject project, Settings settings )
     {
         if ( project == null )
         {
             throw new IllegalArgumentException( "project is required" );
         }
 
         if ( value == null )
         {
             return value;
         }
 
         if ( !value.contains( "${" ) )
         {
             return value.trim();
         }
 
         RegexBasedInterpolator interpolator = new RegexBasedInterpolator();
         try
         {
             interpolator.addValueSource( new EnvarBasedValueSource() );
         }
         catch ( IOException e )
         {
         }
         interpolator.addValueSource( new PropertiesBasedValueSource( System.getProperties() ) );
         interpolator.addValueSource( new PropertiesBasedValueSource( project.getProperties() ) );
         interpolator.addValueSource( new PrefixedObjectValueSource( "project", project ) );
         interpolator.addValueSource( new PrefixedObjectValueSource( "pom", project ) );
         interpolator.addValueSource( new ObjectBasedValueSource( project )
         {
             @Override
             public Object getValue( String expression )
             {
                 try
                 {
                     return ReflectionValueExtractor.evaluate( expression, project, true );
                 }
                 catch ( Exception e )
                 {
                     addFeedback( "Failed to extract \'" + expression + "\' from: " + project, e );
                 }
 
                 return null;
             }
         } );
 
         if ( settings != null )
         {
             interpolator.addValueSource( new PrefixedObjectValueSource( "settings", settings ) );
         }
 
         String interpolatedValue = value;
         try
         {
             interpolatedValue = interpolator.interpolate( value ).trim();
         }
         catch ( InterpolationException e )
         {
         }
 
         if ( interpolatedValue.startsWith( "${" ) )
         {
             return null;
         }
 
         return interpolatedValue;
     }
 
     // ----------------------------------------------------------------------
     // Private methods
     // ----------------------------------------------------------------------
 
     /**
      * Filter the developers/contributors roles by the keys from {@link I18N#getBundle()}. <br/>
      * I18N roles supported in DOAP, i.e. <code>maintainer</code>, <code>developer</code>, <code>documenter</code>,
      * <code>translator</code>, <code>tester</code>, <code>helper</code>. <br/>
      * <b>Note:</b> Actually, only English keys are used.
      *
      * @param i18n i18n component
      * @param developersOrContributors list of <code>{@link Contributor}</code>
      * @return a none null map with <code>maintainers</code>, <code>developers</code>, <code>documenters</code>,
      *         <code>translators</code>, <code>testers</code>, <code>helpers</code>, <code>unknowns</code> as keys and
      *         list of <code>{@link Contributor}</code> as value.
      */
     private static Map<String, List<Contributor>> filterContributorsByDoapRoles( I18N i18n,
                                                                                  List<Contributor> developersOrContributors )
     {
         Map<String, List<Contributor>> returnMap = new HashMap<String, List<Contributor>>( 7 );
         returnMap.put( "maintainers", new ArrayList<Contributor>() );
         returnMap.put( "developers", new ArrayList<Contributor>() );
         returnMap.put( "documenters", new ArrayList<Contributor>() );
         returnMap.put( "translators", new ArrayList<Contributor>() );
         returnMap.put( "testers", new ArrayList<Contributor>() );
         returnMap.put( "helpers", new ArrayList<Contributor>() );
         returnMap.put( "unknowns", new ArrayList<Contributor>() );
 
         if ( developersOrContributors == null || developersOrContributors.isEmpty() )
         {
             return returnMap;
         }
 
         for ( Contributor contributor : developersOrContributors )
         {
             List<String> roles = contributor.getRoles();
 
             if ( roles != null && roles.size() != 0 )
             {
                 for ( String role : roles )
                 {
                     role = role.toLowerCase( Locale.ENGLISH );
                     if ( role.contains( getLowerCaseString( i18n, "doap.maintainer" ) ) )
                     {
                         if ( !returnMap.get( "maintainers" ).contains( contributor ) )
                         {
                             returnMap.get( "maintainers" ).add( contributor );
                         }
                     }
                     else if ( role.contains( getLowerCaseString( i18n, "doap.developer" ) ) )
                     {
                         if ( !returnMap.get( "developers" ).contains( contributor ) )
                         {
                             returnMap.get( "developers" ).add( contributor );
                         }
                     }
                     else if ( role.contains( getLowerCaseString( i18n, "doap.documenter" ) ) )
                     {
                         if ( !returnMap.get( "documenters" ).contains( contributor ) )
                         {
                             returnMap.get( "documenters" ).add( contributor );
                         }
                     }
                     else if ( role.contains( getLowerCaseString( i18n, "doap.translator" ) ) )
                     {
                         if ( !returnMap.get( "translators" ).contains( contributor ) )
                         {
                             returnMap.get( "translators" ).add( contributor );
                         }
                     }
                     else if ( role.contains( getLowerCaseString( i18n, "doap.tester" ) ) )
                     {
                         if ( !returnMap.get( "testers" ).contains( contributor ) )
                         {
                             returnMap.get( "testers" ).add( contributor );
                         }
                     }
                     else if ( role.contains( getLowerCaseString( i18n, "doap.helper" ) ) )
                     {
                         if ( !returnMap.get( "helpers" ).contains( contributor ) )
                         {
                             returnMap.get( "helpers" ).add( contributor );
                         }
                     }
                     else if ( role.contains( getLowerCaseString( i18n, "doap.emeritus" ) ) )
                     {
                         // Don't add as developer nor as contributor as the person is no longer involved
                     }
                     else
                     {
                         if ( !returnMap.get( "unknowns" ).contains( contributor ) )
                         {
                             returnMap.get( "unknowns" ).add( contributor );
                         }
                     }
                 }
             }
             else
             {
                 if ( !returnMap.get( "unknowns" ).contains( contributor ) )
                 {
                     returnMap.get( "unknowns" ).add( contributor );
                 }
             }
         }
 
         return returnMap;
     }
 
     /**
      * @param i18n not null
      * @param key not null
      * @return lower case value for the key in the i18n bundle.
      */
     private static String getLowerCaseString( I18N i18n, String key )
     {
         return i18n.getString( "doap-person", Locale.ENGLISH, key ).toLowerCase( Locale.ENGLISH );
     }
 
     /**
      * @return the Maven artefact version.
      */
     private static String getPluginVersion()
     {
         Properties pomProperties = new Properties();
         InputStream is = null;
         try
         {
             is =
                 DoapUtil.class.getResourceAsStream( "/META-INF/maven/org.apache.maven.plugins/maven-doap-plugin/pom.properties" );
             if ( is == null )
             {
                 return "<unknown>";
             }
 
             pomProperties.load( is );
 
             return pomProperties.getProperty( "version", "<unknown>" );
         }
         catch ( IOException e )
         {
             return "<unknown>";
         }
         finally
         {
             IOUtil.close( is );
         }
     }
 
     /**
      * Fork of {@link org.codehaus.plexus.interpolation.reflection.ReflectionValueExtractor} to care of list or arrays.
      */
     static class ReflectionValueExtractor
     {
         @SuppressWarnings( "rawtypes" )
         private static final Class[] CLASS_ARGS = new Class[0];
 
         private static final Object[] OBJECT_ARGS = new Object[0];
 
         /**
          * Use a WeakHashMap here, so the keys (Class objects) can be garbage collected. This approach prevents permgen
          * space overflows due to retention of discarded classloaders.
          */
         @SuppressWarnings( "rawtypes" )
         private static final Map<Class,ClassMap> classMaps = new WeakHashMap<Class,ClassMap>();
 
         private ReflectionValueExtractor()
         {
         }
 
         public static Object evaluate( String expression, Object root )
             throws Exception
         {
             return evaluate( expression, root, true );
         }
 
         // TODO: don't throw Exception
         public static Object evaluate( String expression, Object root, boolean trimRootToken )
             throws Exception
         {
             // if the root token refers to the supplied root object parameter, remove it.
             if ( trimRootToken )
             {
                 expression = expression.substring( expression.indexOf( '.' ) + 1 );
             }
 
             Object value = root;
 
             // ----------------------------------------------------------------------
             // Walk the dots and retrieve the ultimate value desired from the
             // MavenProject instance.
             // ----------------------------------------------------------------------
 
             StringTokenizer parser = new StringTokenizer( expression, "." );
 
             while ( parser.hasMoreTokens() )
             {
                 String token = parser.nextToken();
                 if ( value == null )
                 {
                     return null;
                 }
 
                 StringTokenizer parser2 = new StringTokenizer( token, "[]" );
                 int index = -1;
                 if ( parser2.countTokens() > 1 )
                 {
                     token = parser2.nextToken();
                     try
                     {
                         index = Integer.valueOf( parser2.nextToken() ).intValue();
                     }
                     catch ( NumberFormatException e )
                     {
                     }
                 }
 
                 final ClassMap classMap = getClassMap( value.getClass() );
 
                 final String methodBase = StringUtils.capitalizeFirstLetter( token );
 
                 String methodName = "get" + methodBase;
 
                 Method method = classMap.findMethod( methodName, CLASS_ARGS );
 
                 if ( method == null )
                 {
                     // perhaps this is a boolean property??
                     methodName = "is" + methodBase;
 
                     method = classMap.findMethod( methodName, CLASS_ARGS );
                 }
 
                 if ( method == null )
                 {
                     return null;
                 }
 
                 value = method.invoke( value, OBJECT_ARGS );
                 if ( value == null )
                 {
                     return null;
                 }
                 if ( Collection.class.isAssignableFrom( value.getClass() ) )
                 {
                     ClassMap classMap2 = getClassMap( value.getClass() );
 
                     Method method2 = classMap2.findMethod( "toArray", CLASS_ARGS );
 
                     value = method2.invoke( value, OBJECT_ARGS );
                 }
                 if ( value.getClass().isArray() )
                 {
                     value = ( (Object[]) value )[index];
                 }
             }
 
             return value;
         }
 
         private static ClassMap getClassMap( Class<? extends Object> clazz )
         {
             ClassMap classMap = classMaps.get( clazz );
 
             if ( classMap == null )
             {
                 classMap = new ClassMap( clazz );
 
                 classMaps.put( clazz, classMap );
             }
 
             return classMap;
         }
     }
 }