1   package org.apache.maven.artifact.versioning;
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.util.Locale;
23  
24  import junit.framework.TestCase;
25  
26  /**
27   * Test ComparableVersion.
28   *
29   * @author <a href="mailto:hboutemy@apache.org">Hervé Boutemy</a>
30   * @version $Id: ComparableVersionTest.java 900164 2010-01-17 17:31:30Z hboutemy $
31   */
32  @SuppressWarnings( "unchecked" )
33  public class ComparableVersionTest
34      extends TestCase
35  {
36      private Comparable newComparable( String version )
37      {
38          return new ComparableVersion( version );
39      }
40  
41      private static final String[] VERSIONS_QUALIFIER =
42          { "1-alpha2snapshot", "1-alpha2", "1-alpha-123", "1-beta-2", "1-beta123", "1-m2", "1-m11", "1-rc", "1-cr2",
43              "1-rc123", "1-SNAPSHOT", "1", "1-sp", "1-sp2", "1-sp123", "1-abc", "1-def", "1-pom-1", "1-1-snapshot",
44              "1-1", "1-2", "1-123" };
45  
46      private static final String[] VERSIONS_NUMBER =
47          { "2.0", "2-1", "2.0.a", "2.0.0.a", "2.0.2", "2.0.123", "2.1.0", "2.1-a", "2.1b", "2.1-c", "2.1-1", "2.1.0.1",
48              "2.2", "2.123", "11.a2", "11.a11", "11.b2", "11.b11", "11.m2", "11.m11", "11", "11.a", "11b", "11c", "11m" };
49  
50      private void checkVersionsOrder( String[] versions )
51      {
52          Comparable[] c = new Comparable[versions.length];
53          for ( int i = 0; i < versions.length; i++ )
54          {
55              c[i] = newComparable( versions[i] );
56          }
57  
58          for ( int i = 1; i < versions.length; i++ )
59          {
60              Comparable low = c[i - 1];
61              for ( int j = i; j < versions.length; j++ )
62              {
63                  Comparable high = c[j];
64                  assertTrue( "expected " + low + " < " + high, low.compareTo( high ) < 0 );
65                  assertTrue( "expected " + high + " > " + low, high.compareTo( low ) > 0 );
66              }
67          }
68      }
69  
70      private void checkVersionsEqual( String v1, String v2 )
71      {
72          Comparable c1 = newComparable( v1 );
73          Comparable c2 = newComparable( v2 );
74          assertTrue( "expected " + v1 + " == " + v2, c1.compareTo( c2 ) == 0 );
75          assertTrue( "expected " + v2 + " == " + v1, c2.compareTo( c1 ) == 0 );
76          assertTrue( "expected same hashcode for " + v1 + " and " + v2, c1.hashCode() == c2.hashCode() );
77          assertTrue( "expected " + v1 + ".equals( " + v2 + " )", c1.equals( c2 ) );
78          assertTrue( "expected " + v2 + ".equals( " + v1 + " )", c2.equals( c1 ) );
79      }
80  
81      private void checkVersionsOrder( String v1, String v2 )
82      {
83          Comparable c1 = newComparable( v1 );
84          Comparable c2 = newComparable( v2 );
85          assertTrue( "expected " + v1 + " < " + v2, c1.compareTo( c2 ) < 0 );
86          assertTrue( "expected " + v2 + " > " + v1, c2.compareTo( c1 ) > 0 );
87      }
88  
89      public void testVersionsQualifier()
90      {
91          checkVersionsOrder( VERSIONS_QUALIFIER );
92      }
93  
94      public void testVersionsNumber()
95      {
96          checkVersionsOrder( VERSIONS_NUMBER );
97      }
98  
99      public void testVersionsEqual()
100     {
101         checkVersionsEqual( "1", "1" );
102         checkVersionsEqual( "1", "1.0" );
103         checkVersionsEqual( "1", "1.0.0" );
104         checkVersionsEqual( "1.0", "1.0.0" );
105         checkVersionsEqual( "1", "1-0" );
106         checkVersionsEqual( "1", "1.0-0" );
107         checkVersionsEqual( "1.0", "1.0-0" );
108         // no separator between number and character
109         checkVersionsEqual( "1a", "1.a" );
110         checkVersionsEqual( "1a", "1-a" );
111         checkVersionsEqual( "1a", "1.0-a" );
112         checkVersionsEqual( "1a", "1.0.0-a" );
113         checkVersionsEqual( "1.0a", "1.0.a" );
114         checkVersionsEqual( "1.0.0a", "1.0.0.a" );
115         checkVersionsEqual( "1x", "1.x" );
116         checkVersionsEqual( "1x", "1-x" );
117         checkVersionsEqual( "1x", "1.0-x" );
118         checkVersionsEqual( "1x", "1.0.0-x" );
119         checkVersionsEqual( "1.0x", "1.0.x" );
120         checkVersionsEqual( "1.0.0x", "1.0.0.x" );
121 
122         // aliases
123         checkVersionsEqual( "1ga", "1" );
124         checkVersionsEqual( "1final", "1" );
125         checkVersionsEqual( "1cr", "1rc" );
126 
127         // special "aliases" a, b and m for alpha, beta and milestone
128         checkVersionsEqual( "1a1", "1alpha1" );
129         checkVersionsEqual( "1b2", "1beta2" );
130         checkVersionsEqual( "1m3", "1milestone3" );
131 
132         // case insensitive
133         checkVersionsEqual( "1X", "1x" );
134         checkVersionsEqual( "1A", "1a" );
135         checkVersionsEqual( "1B", "1b" );
136         checkVersionsEqual( "1M", "1m" );
137         checkVersionsEqual( "1Ga", "1" );
138         checkVersionsEqual( "1GA", "1" );
139         checkVersionsEqual( "1Final", "1" );
140         checkVersionsEqual( "1FinaL", "1" );
141         checkVersionsEqual( "1FINAL", "1" );
142         checkVersionsEqual( "1Cr", "1Rc" );
143         checkVersionsEqual( "1cR", "1rC" );
144         checkVersionsEqual( "1m3", "1Milestone3" );
145         checkVersionsEqual( "1m3", "1MileStone3" );
146         checkVersionsEqual( "1m3", "1MILESTONE3" );
147     }
148 
149     public void testVersionComparing()
150     {
151         checkVersionsOrder( "1", "2" );
152         checkVersionsOrder( "1.5", "2" );
153         checkVersionsOrder( "1", "2.5" );
154         checkVersionsOrder( "1.0", "1.1" );
155         checkVersionsOrder( "1.1", "1.2" );
156         checkVersionsOrder( "1.0.0", "1.1" );
157         checkVersionsOrder( "1.0.1", "1.1" );
158         checkVersionsOrder( "1.1", "1.2.0" );
159 
160         checkVersionsOrder( "1.0-alpha-1", "1.0" );
161         checkVersionsOrder( "1.0-alpha-1", "1.0-alpha-2" );
162         checkVersionsOrder( "1.0-alpha-1", "1.0-beta-1" );
163 
164         checkVersionsOrder( "1.0-beta-1", "1.0-SNAPSHOT" );
165         checkVersionsOrder( "1.0-SNAPSHOT", "1.0" );
166         checkVersionsOrder( "1.0-alpha-1-SNAPSHOT", "1.0-alpha-1" );
167 
168         checkVersionsOrder( "1.0", "1.0-1" );
169         checkVersionsOrder( "1.0-1", "1.0-2" );
170         checkVersionsOrder( "1.0.0", "1.0-1" );
171 
172         checkVersionsOrder( "2.0-1", "2.0.1" );
173         checkVersionsOrder( "2.0.1-klm", "2.0.1-lmn" );
174         checkVersionsOrder( "2.0.1", "2.0.1-xyz" );
175 
176         checkVersionsOrder( "2.0.1", "2.0.1-123" );
177         checkVersionsOrder( "2.0.1-xyz", "2.0.1-123" );
178     }
179 
180     public void testLocaleIndependent()
181     {
182         Locale orig = Locale.getDefault();
183         Locale[] locales = { Locale.ENGLISH, new Locale( "tr" ), Locale.getDefault() };
184         try
185         {
186             for ( Locale locale : locales )
187             {
188                 Locale.setDefault( locale );
189                 checkVersionsEqual( "1-abcdefghijklmnopqrstuvwxyz", "1-ABCDEFGHIJKLMNOPQRSTUVWXYZ" );
190             }
191         }
192         finally
193         {
194             Locale.setDefault( orig );
195         }
196     }
197 
198     public void testReuse()
199     {
200         ComparableVersion c1 = new ComparableVersion( "1" );
201         c1.parseVersion( "2" );
202 
203         Comparable c2 = newComparable( "2" );
204 
205         assertEquals( "reused instance should be equivalent to new instance", c1, c2 );
206     }
207 }