Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
xxadev
jenkins
提交
48e95e0b
J
jenkins
项目概览
xxadev
/
jenkins
与 Fork 源项目一致
从无法访问的项目Fork
通知
3
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
J
jenkins
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
前往新版Gitcode,体验更适合开发者的 AI 搜索 >>
提交
48e95e0b
编写于
9月 13, 2011
作者:
K
Kohsuke Kawaguchi
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
split out the version number code as a separate reusable library
上级
88ffcc29
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
5 addition
and
541 deletion
+5
-541
core/pom.xml
core/pom.xml
+5
-0
core/src/main/java/hudson/util/VersionNumber.java
core/src/main/java/hudson/util/VersionNumber.java
+0
-481
core/src/test/java/hudson/util/VersionNumberTest.java
core/src/test/java/hudson/util/VersionNumberTest.java
+0
-60
未找到文件。
core/pom.xml
浏览文件 @
48e95e0b
...
...
@@ -56,6 +56,11 @@ THE SOFTWARE.
<artifactId>
cli
</artifactId>
<version>
${project.version}
</version>
</dependency>
<dependency>
<groupId>
org.jenkins-ci
</groupId>
<artifactId>
version-number
</artifactId>
<version>
1.0
</version>
</dependency>
<dependency>
<groupId>
org.jenkins-ci
</groupId>
<artifactId>
crypto-util
</artifactId>
...
...
core/src/main/java/hudson/util/VersionNumber.java
已删除
100644 → 0
浏览文件 @
88ffcc29
package
hudson.util
;
/*
* 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.math.BigInteger
;
import
java.util.ArrayList
;
import
java.util.Arrays
;
import
java.util.Iterator
;
import
java.util.List
;
import
java.util.ListIterator
;
import
java.util.Locale
;
import
java.util.Properties
;
import
java.util.Stack
;
/**
* Immutable representation of a version number based on the Mercury version numbering scheme.
*
* {@link VersionNumber}s are {@link Comparable}.
*
* <h2>Special tokens</h2>
* <p>
* We allow a component to be not just a number, but also "ea", "ea1", "ea2".
* "ea" is treated as "ea0", and eaN < M for any M > 0.
*
* <p>
* '*' is also allowed as a component, and '*' > M for any M > 0.
*
* <p>
* 'SNAPSHOT' is also allowed as a component, and "N.SNAPSHOT" is interpreted as "N-1.*"
*
* <pre>
* 2.0.* > 2.0.1 > 2.0.1-SNAPSHOT > 2.0.0.99 > 2.0.0 > 2.0.ea > 2.0
* </pre>
*
* This class is re-implemented in 1.415. The class was originally introduced in 1.139
*
* @since 1.139
* @author Stephen Connolly (stephenc@apache.org)
* @author Kenney Westerhof (kenney@apache.org)
* @author Hervé Boutemy (hboutemy@apache.org)
*/
public
class
VersionNumber
implements
Comparable
<
VersionNumber
>
{
private
String
value
;
private
String
canonical
;
private
ListItem
items
;
private
interface
Item
{
public
static
final
int
INTEGER_ITEM
=
0
;
public
static
final
int
STRING_ITEM
=
1
;
public
static
final
int
LIST_ITEM
=
2
;
public
static
final
int
WILDCARD_ITEM
=
3
;
public
int
compareTo
(
Item
item
);
public
int
getType
();
public
boolean
isNull
();
}
/**
* Represents a wild-card item in the version item list.
*/
private
static
class
WildCardItem
implements
Item
{
public
int
compareTo
(
Item
item
)
{
if
(
item
==
null
)
// 1.* ( > 1.99) > 1
return
1
;
switch
(
item
.
getType
())
{
case
INTEGER_ITEM:
case
LIST_ITEM:
case
STRING_ITEM:
return
1
;
case
WILDCARD_ITEM:
return
0
;
default
:
return
1
;
}
}
public
int
getType
()
{
return
WILDCARD_ITEM
;
}
public
boolean
isNull
()
{
return
false
;
}
@Override
public
String
toString
()
{
return
"*"
;
}
}
/**
* Represents a numeric item in the version item list.
*/
private
static
class
IntegerItem
implements
Item
{
private
static
final
BigInteger
BigInteger_ZERO
=
new
BigInteger
(
"0"
);
private
final
BigInteger
value
;
public
static
final
IntegerItem
ZERO
=
new
IntegerItem
();
private
IntegerItem
()
{
this
.
value
=
BigInteger_ZERO
;
}
public
IntegerItem
(
String
str
)
{
this
.
value
=
new
BigInteger
(
str
);
}
public
int
getType
()
{
return
INTEGER_ITEM
;
}
public
boolean
isNull
()
{
return
BigInteger_ZERO
.
equals
(
value
);
}
public
int
compareTo
(
Item
item
)
{
if
(
item
==
null
)
{
return
BigInteger_ZERO
.
equals
(
value
)
?
0
:
1
;
// 1.0 == 1, 1.1 > 1
}
switch
(
item
.
getType
())
{
case
INTEGER_ITEM:
return
value
.
compareTo
(((
IntegerItem
)
item
).
value
);
case
STRING_ITEM:
return
1
;
// 1.1 > 1-sp
case
LIST_ITEM:
return
1
;
// 1.1 > 1-1
case
WILDCARD_ITEM:
return
0
;
default
:
throw
new
RuntimeException
(
"invalid item: "
+
item
.
getClass
());
}
}
public
String
toString
()
{
return
value
.
toString
();
}
}
/**
* Represents a string in the version item list, usually a qualifier.
*/
private
static
class
StringItem
implements
Item
{
private
final
static
String
[]
QUALIFIERS
=
{
"snapshot"
,
"alpha"
,
"beta"
,
"milestone"
,
"rc"
,
""
,
"sp"
};
private
final
static
List
<
String
>
_QUALIFIERS
=
Arrays
.
asList
(
QUALIFIERS
);
private
final
static
Properties
ALIASES
=
new
Properties
();
static
{
ALIASES
.
put
(
"ga"
,
""
);
ALIASES
.
put
(
"final"
,
""
);
ALIASES
.
put
(
"cr"
,
"rc"
);
ALIASES
.
put
(
"ea"
,
"rc"
);
}
/**
* A comparable for the empty-string qualifier. This one is used to determine if a given qualifier makes the
* version older than one without a qualifier, or more recent.
*/
private
static
String
RELEASE_VERSION_INDEX
=
String
.
valueOf
(
_QUALIFIERS
.
indexOf
(
""
));
private
String
value
;
public
StringItem
(
String
value
,
boolean
followedByDigit
)
{
if
(
followedByDigit
&&
value
.
length
()
==
1
)
{
// a1 = alpha-1, b1 = beta-1, m1 = milestone-1
switch
(
value
.
charAt
(
0
))
{
case
'a'
:
value
=
"alpha"
;
break
;
case
'b'
:
value
=
"beta"
;
break
;
case
'm'
:
value
=
"milestone"
;
break
;
}
}
this
.
value
=
ALIASES
.
getProperty
(
value
,
value
);
}
public
int
getType
()
{
return
STRING_ITEM
;
}
public
boolean
isNull
()
{
return
(
comparableQualifier
(
value
).
compareTo
(
RELEASE_VERSION_INDEX
)
==
0
);
}
/**
* Returns a comparable for a qualifier.
* <p/>
* This method both takes into account the ordering of known qualifiers as well as lexical ordering for unknown
* qualifiers.
* <p/>
* just returning an Integer with the index here is faster, but requires a lot of if/then/else to check for -1
* or QUALIFIERS.size and then resort to lexical ordering. Most comparisons are decided by the first character,
* so this is still fast. If more characters are needed then it requires a lexical sort anyway.
*
* @param qualifier
* @return
*/
public
static
String
comparableQualifier
(
String
qualifier
)
{
int
i
=
_QUALIFIERS
.
indexOf
(
qualifier
);
return
i
==
-
1
?
_QUALIFIERS
.
size
()
+
"-"
+
qualifier
:
String
.
valueOf
(
i
);
}
public
int
compareTo
(
Item
item
)
{
if
(
item
==
null
)
{
// 1-rc < 1, 1-ga > 1
return
comparableQualifier
(
value
).
compareTo
(
RELEASE_VERSION_INDEX
);
}
switch
(
item
.
getType
())
{
case
INTEGER_ITEM:
return
-
1
;
// 1.any < 1.1 ?
case
STRING_ITEM:
return
comparableQualifier
(
value
).
compareTo
(
comparableQualifier
(((
StringItem
)
item
).
value
));
case
LIST_ITEM:
return
-
1
;
// 1.any < 1-1
case
WILDCARD_ITEM:
return
-
1
;
default
:
throw
new
RuntimeException
(
"invalid item: "
+
item
.
getClass
());
}
}
public
String
toString
()
{
return
value
;
}
}
/**
* Represents a version list item. This class is used both for the global item list and for sub-lists (which start
* with '-(number)' in the version specification).
*/
private
static
class
ListItem
extends
ArrayList
<
Item
>
implements
Item
{
public
int
getType
()
{
return
LIST_ITEM
;
}
public
boolean
isNull
()
{
return
(
size
()
==
0
);
}
void
normalize
()
{
for
(
ListIterator
iterator
=
listIterator
(
size
());
iterator
.
hasPrevious
();
)
{
Item
item
=
(
Item
)
iterator
.
previous
();
if
(
item
.
isNull
())
{
iterator
.
remove
();
// remove null trailing items: 0, "", empty list
}
else
{
break
;
}
}
}
public
int
compareTo
(
Item
item
)
{
if
(
item
==
null
)
{
if
(
size
()
==
0
)
{
return
0
;
// 1-0 = 1- (normalize) = 1
}
Item
first
=
(
Item
)
get
(
0
);
return
first
.
compareTo
(
null
);
}
switch
(
item
.
getType
())
{
case
INTEGER_ITEM:
return
-
1
;
// 1-1 < 1.0.x
case
STRING_ITEM:
return
1
;
// 1-1 > 1-sp
case
LIST_ITEM:
Iterator
left
=
iterator
();
Iterator
right
=
((
ListItem
)
item
).
iterator
();
while
(
left
.
hasNext
()
||
right
.
hasNext
())
{
Item
l
=
left
.
hasNext
()
?
(
Item
)
left
.
next
()
:
null
;
Item
r
=
right
.
hasNext
()
?
(
Item
)
right
.
next
()
:
null
;
// if this is shorter, then invert the compare and mul with -1
int
result
=
l
==
null
?
-
1
*
r
.
compareTo
(
l
)
:
l
.
compareTo
(
r
);
if
(
result
!=
0
)
{
return
result
;
}
}
return
0
;
case
WILDCARD_ITEM:
return
-
1
;
default
:
throw
new
RuntimeException
(
"invalid item: "
+
item
.
getClass
());
}
}
public
String
toString
()
{
StringBuilder
buffer
=
new
StringBuilder
(
"("
);
for
(
Iterator
<
Item
>
iter
=
iterator
();
iter
.
hasNext
();
)
{
buffer
.
append
(
iter
.
next
());
if
(
iter
.
hasNext
())
{
buffer
.
append
(
','
);
}
}
buffer
.
append
(
')'
);
return
buffer
.
toString
();
}
}
public
VersionNumber
(
String
version
)
{
parseVersion
(
version
);
}
private
void
parseVersion
(
String
version
)
{
this
.
value
=
version
;
items
=
new
ListItem
();
version
=
version
.
toLowerCase
(
Locale
.
ENGLISH
);
ListItem
list
=
items
;
Stack
<
Item
>
stack
=
new
Stack
<
Item
>();
stack
.
push
(
list
);
boolean
isDigit
=
false
;
int
startIndex
=
0
;
for
(
int
i
=
0
;
i
<
version
.
length
();
i
++)
{
char
c
=
version
.
charAt
(
i
);
if
(
c
==
'.'
)
{
if
(
i
==
startIndex
)
{
list
.
add
(
IntegerItem
.
ZERO
);
}
else
{
list
.
add
(
parseItem
(
isDigit
,
version
.
substring
(
startIndex
,
i
)));
}
startIndex
=
i
+
1
;
}
else
if
(
c
==
'-'
)
{
if
(
i
==
startIndex
)
{
list
.
add
(
IntegerItem
.
ZERO
);
}
else
{
list
.
add
(
parseItem
(
isDigit
,
version
.
substring
(
startIndex
,
i
)));
}
startIndex
=
i
+
1
;
if
(
isDigit
)
{
list
.
normalize
();
// 1.0-* = 1-*
if
((
i
+
1
<
version
.
length
())
&&
Character
.
isDigit
(
version
.
charAt
(
i
+
1
)))
{
// new ListItem only if previous were digits and new char is a digit,
// ie need to differentiate only 1.1 from 1-1
list
.
add
(
list
=
new
ListItem
());
stack
.
push
(
list
);
}
}
}
else
if
(
c
==
'*'
)
{
list
.
add
(
new
WildCardItem
());
startIndex
=
i
+
1
;
}
else
if
(
Character
.
isDigit
(
c
))
{
if
(!
isDigit
&&
i
>
startIndex
)
{
list
.
add
(
new
StringItem
(
version
.
substring
(
startIndex
,
i
),
true
));
startIndex
=
i
;
}
isDigit
=
true
;
}
else
if
(
Character
.
isWhitespace
(
c
))
{
if
(
i
>
startIndex
)
{
if
(
isDigit
)
{
list
.
add
(
parseItem
(
true
,
version
.
substring
(
startIndex
,
i
)));
}
else
{
list
.
add
(
new
StringItem
(
version
.
substring
(
startIndex
,
i
),
true
));
}
startIndex
=
i
;
}
isDigit
=
false
;
}
else
{
if
(
isDigit
&&
i
>
startIndex
)
{
list
.
add
(
parseItem
(
true
,
version
.
substring
(
startIndex
,
i
)));
startIndex
=
i
;
}
isDigit
=
false
;
}
}
if
(
version
.
length
()
>
startIndex
)
{
list
.
add
(
parseItem
(
isDigit
,
version
.
substring
(
startIndex
)));
}
while
(!
stack
.
isEmpty
())
{
list
=
(
ListItem
)
stack
.
pop
();
list
.
normalize
();
}
canonical
=
items
.
toString
();
}
private
static
Item
parseItem
(
boolean
isDigit
,
String
buf
)
{
return
isDigit
?
(
Item
)
new
IntegerItem
(
buf
)
:
(
Item
)
new
StringItem
(
buf
,
false
);
}
public
int
compareTo
(
VersionNumber
o
)
{
return
items
.
compareTo
(
o
.
items
);
}
public
String
toString
()
{
return
value
;
}
public
boolean
equals
(
Object
o
)
{
return
(
o
instanceof
VersionNumber
)
&&
canonical
.
equals
(((
VersionNumber
)
o
).
canonical
);
}
public
int
hashCode
()
{
return
canonical
.
hashCode
();
}
public
boolean
isOlderThan
(
VersionNumber
rhs
)
{
return
compareTo
(
rhs
)
<
0
;
}
public
boolean
isNewerThan
(
VersionNumber
rhs
)
{
return
compareTo
(
rhs
)
>
0
;
}
public
int
digit
(
int
idx
)
{
Iterator
i
=
items
.
iterator
();
Item
item
=
(
Item
)
i
.
next
();
while
(
idx
>
0
&&
i
.
hasNext
())
{
if
(
item
instanceof
IntegerItem
)
{
idx
--;
}
i
.
next
();
}
return
((
IntegerItem
)
item
).
value
.
intValue
();
}
}
core/src/test/java/hudson/util/VersionNumberTest.java
已删除
100644 → 0
浏览文件 @
88ffcc29
/*
* The MIT License
*
* Copyright (c) 2004-2009, Sun Microsystems, Inc., Kohsuke Kawaguchi, Xavier Le Vourch
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package
hudson.util
;
import
junit.framework.TestCase
;
/**
* @author Xavier Le Vourch
*/
public
class
VersionNumberTest
extends
TestCase
{
public
void
testIsNewerThan
()
{
assertTrue
(
new
VersionNumber
(
"2.0.*"
).
isNewerThan
(
new
VersionNumber
(
"2.0"
)));
assertTrue
(
new
VersionNumber
(
"2.1-SNAPSHOT"
).
isNewerThan
(
new
VersionNumber
(
"2.0.*"
)));
assertTrue
(
new
VersionNumber
(
"2.0.*"
).
isNewerThan
(
new
VersionNumber
(
"2.0.1"
)));
assertTrue
(
new
VersionNumber
(
"2.0.1"
).
isNewerThan
(
new
VersionNumber
(
"2.0.1-SNAPSHOT"
)));
assertTrue
(
new
VersionNumber
(
"2.0.1-SNAPSHOT"
).
isNewerThan
(
new
VersionNumber
(
"2.0.0.99"
)));
assertTrue
(
new
VersionNumber
(
"2.0.0.99"
).
isNewerThan
(
new
VersionNumber
(
"2.0.0"
)));
assertTrue
(
new
VersionNumber
(
"2.0.0"
).
isNewerThan
(
new
VersionNumber
(
"2.0.ea"
)));
assertTrue
(
new
VersionNumber
(
"2.0"
).
isNewerThan
(
new
VersionNumber
(
"2.0.ea"
)));
// the inversion of the previous test case from the old behaviour is explained by
// which makes more sense than before
assertTrue
(
new
VersionNumber
(
"2.0.0"
).
equals
(
new
VersionNumber
(
"2.0"
)));
}
public
void
testEarlyAccess
()
{
assertTrue
(
new
VersionNumber
(
"2.0.ea2"
).
isNewerThan
(
new
VersionNumber
(
"2.0.ea1"
)));
assertTrue
(
new
VersionNumber
(
"2.0.ea1"
).
isNewerThan
(
new
VersionNumber
(
"2.0.ea"
)));
assertEquals
(
new
VersionNumber
(
"2.0.ea"
),
new
VersionNumber
(
"2.0.ea0"
));
}
public
void
testSnapshots
()
{
assertTrue
(
new
VersionNumber
(
"1.12"
).
isNewerThan
(
new
VersionNumber
(
"1.12-SNAPSHOT (private-08/24/2008 12:13-hudson)"
)));
assertTrue
(
new
VersionNumber
(
"1.12-SNAPSHOT (private-08/24/2008 12:13-hudson)"
).
isNewerThan
(
new
VersionNumber
(
"1.11"
)));
// This is changed from the old impl because snapshots are no longer a "magic" number
assertFalse
(
new
VersionNumber
(
"1.12-SNAPSHOT"
).
equals
(
new
VersionNumber
(
"1.11.*"
)));
assertTrue
(
new
VersionNumber
(
"1.11.*"
).
isNewerThan
(
new
VersionNumber
(
"1.11.9"
)));
}
}
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录