com.day.jcr.vault.packaging.Version Maven / Gradle / Ivy
/*************************************************************************
*
* ADOBE CONFIDENTIAL
* __________________
*
* Copyright 2011 Adobe Systems Incorporated
* All Rights Reserved.
*
* NOTICE: All information contained herein is, and remains
* the property of Adobe Systems Incorporated and its suppliers,
* if any. The intellectual and technical concepts contained
* herein are proprietary to Adobe Systems Incorporated and its
* suppliers and are protected by trade secret or copyright law.
* Dissemination of this information or reproduction of this material
* is strictly forbidden unless prior written permission is obtained
* from Adobe Systems Incorporated.
*
**************************************************************************/
package com.day.jcr.vault.packaging;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import com.day.jcr.vault.util.Text;
/**
* Implements a package version.
*
* @since 2.0
* @deprecated since 2.5.0. Use the org.apache.jackrabbit.vault API instead.
*/
@Deprecated
public class Version implements Comparable {
/**
* The empty version
*/
public static final Version EMPTY = new Version("", new String[0]);
/**
* internal string representation
*/
private final String str;
/**
* All segments of this version
*/
private final String[] segments;
/**
* Constructs a new version from the given string.
* @param str the version string.
* @deprecated use {@link Version#create(String)} instead.
*/
public Version(String str) {
this(str, Text.explode(str, '.'));
}
/**
* Constructs a new version from version segments
* @param segments version segments
* @deprecated use {@link Version#create(String[])} instead.
*/
public Version(String[] segments) {
this(Text.implode(segments, "."), segments);
}
/**
* Creates a new version from the given string.
* @param str the version string.
* @return the new version or {@link Version#EMPTY} if str is an empty string.
* @since 2.2.4
*/
public static Version create(String str) {
if (str == null || str.length() == 0) {
return Version.EMPTY;
}else {
return new Version(str, Text.explode(str, '.'));
}
}
/**
* Creates a new version from version segments
* @param segments version segments
* @return the new version or {@link Version#EMPTY} if segments is empty.
* @since 2.2.4
*/
public static Version create(String[] segments) {
if (segments == null || segments.length == 0) {
return Version.EMPTY;
} else {
return new Version(Text.implode(segments, "."), segments);
}
}
/**
* Internal constructor
* @param str string
* @param segments segments
*/
private Version(String str, String[] segments) {
if (str == null) {
throw new NullPointerException("Version String must not be null.");
}
this.str = str;
this.segments = segments;
}
@Override
public int hashCode() {
return str.hashCode();
}
@Override
public boolean equals(Object o) {
return this == o ||
o instanceof Version && str.equals(((Version) o).str);
}
@Override
public String toString() {
return str;
}
/**
* Returns all segments.
* @return all segments.
*/
public String[] getNormalizedSegments() {
return segments;
}
/**
* Compares this version to the given one, segment by segment with a special
* "SNAPSHOT" handling.
*
* Examples:
* "1" < "2"
* "1.0" < "2"
* "2.0.1" < "2.1"
* "2.1" < "2.1.1"
* "2.9" < "2.11"
* "2.1" > "2.1-SNAPSHOT"
* "2.1" > "2.1-R1234556"
* "2.1-R12345" < "2.1-SNAPSHOT"
*
* @param o the other version
* @return a negative integer, zero, or a positive integer as this version
* is less than, equal to, or greater than the specified version.
*/
public int compareTo(Version o) {
String[] oSegs = o.getNormalizedSegments();
for (int i=0; i< Math.min(segments.length, oSegs.length); i++) {
String s1 = segments[i];
String s2 = oSegs[i];
if (s1.equals(s2)) {
continue;
}
try {
int v1 = Integer.parseInt(segments[i]);
int v2 = Integer.parseInt(oSegs[i]);
if (v1 != v2) {
return v1 - v2;
}
} catch (NumberFormatException e) {
// ignore
}
String ss1[] = Text.explode(s1,'-');
String ss2[] = Text.explode(s2,'-');
for (int j=0; j< Math.min(ss1.length, ss2.length); j++) {
String c1 = ss1[j];
String c2 = ss2[j];
try {
int v1 = Integer.parseInt(c1);
int v2 = Integer.parseInt(c2);
if (v1 != v2) {
return v1 - v2;
}
} catch (NumberFormatException e) {
// ignore
}
int c = c1.compareTo(c2);
if (c!=0) {
return c;
}
}
int c = ss1.length - ss2.length;
if (c != 0) {
return -c;
}
}
return segments.length - oSegs.length;
}
/**
* Compares this version to the given one, segment by segment without any special
* "SNAPSHOT" handling.
*
* Examples:
* "1" < "2"
* "1.0" < "2"
* "2.0.1" < "2.1"
* "2.1" < "2.1.1"
* "2.9" < "2.11"
* "2.1" < "2.1-SNAPSHOT"
* "2.1" < "2.1-R1234556"
* "2.1-R12345" < "2.1-SNAPSHOT"
*
* @param o the other version
* @return a negative integer, zero, or a positive integer as this version
* is less than, equal to, or greater than the specified version.
*/
public int osgiCompareTo(Version o) {
// first convert into 'osgi' form
List segs0 = new ArrayList();
List segs1 = new ArrayList();
for (String s: segments) {
segs0.addAll(Arrays.asList(Text.explode(s, '-')));
}
for (String s: o.getNormalizedSegments()) {
segs1.addAll(Arrays.asList(Text.explode(s, '-')));
}
int len = Math.min(segs0.size(), segs1.size());
for (int i=0; i © 2015 - 2025 Weber Informatics LLC | Privacy Policy