View Javadoc
1   package org.apache.maven.doxia.tools;
2   
3   /*
4    * Licensed to the Apache Software Foundation (ASF) under one
5    * or more contributor license agreements.  See the NOTICE file
6    * distributed with this work for additional information
7    * regarding copyright ownership.  The ASF licenses this file
8    * to you under the Apache License, Version 2.0 (the
9    * "License"); you may not use this file except in compliance
10   * with the License.  You may obtain a copy of the License at
11   *
12   *   http://www.apache.org/licenses/LICENSE-2.0
13   *
14   * Unless required by applicable law or agreed to in writing,
15   * software distributed under the License is distributed on an
16   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
17   * KIND, either express or implied.  See the License for the
18   * specific language governing permissions and limitations
19   * under the License.
20   */
21  
22  import java.text.Collator;
23  import java.util.Comparator;
24  import java.util.Locale;
25  
26  import org.apache.maven.reporting.MavenReport;
27  
28  /**
29   * Sorts reports.
30   *
31   * @author <a href="mailto:brett@apache.org">Brett Porter</a>
32   * TODO move to reporting API?
33   * TODO allow reports to define their order in some other way?
34   */
35  public class ReportComparator
36      implements Comparator<MavenReport>
37  {
38      /** the local */
39      private final Locale locale;
40  
41      /**
42       * Default constructor.
43       *
44       * @param locale not null
45       */
46      public ReportComparator( Locale locale )
47      {
48          if ( locale == null )
49          {
50              throw new IllegalArgumentException( "locale should be defined" );
51          }
52          this.locale = locale;
53      }
54  
55      /** {@inheritDoc} */
56      public int compare( MavenReport r1, MavenReport r2 )
57      {
58          Collator collator = Collator.getInstance( locale );
59          return collator.compare( r1.getName( locale ), r2.getName( locale ) );
60      }
61  }