org.apache.sshd.common.util.VersionInfo Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of sshd-osgi
There is a newer version: 2.14.0
/*
 * 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.
 */

package org.apache.sshd.common.util;

import java.io.Serializable;

/**
 * @author Apache MINA SSHD Project
 */
public class VersionInfo implements Serializable, Comparable {
    private static final long serialVersionUID = -9127482432228413836L;

    private final int majorVersion;
    private final int minorVersion;
    private final int release;
    private final int buildNumber;

    public VersionInfo(int major, int minor) {
        this(major, minor, 0, 0);
    }

    public VersionInfo(int major, int minor, int release, int build) {
        this.majorVersion = major;
        this.minorVersion = minor;
        this.release = release;
        this.buildNumber = build;
    }

    public final int getMajorVersion() {
        return majorVersion;
    }

    public final int getMinorVersion() {
        return minorVersion;
    }

    public final int getRelease() {
        return release;
    }

    public final int getBuildNumber() {
        return buildNumber;
    }

    @Override
    public int hashCode() {
        return NumberUtils.hashCode(getMajorVersion(), getMinorVersion(), getRelease(), getBuildNumber());
    }

    @Override
    public boolean equals(Object obj) {
        if (obj == null) {
            return false;
        }
        if (this == obj) {
            return true;
        }
        if (getClass() != obj.getClass()) {
            return false;
        }
        return compareTo((VersionInfo) obj) == 0;
    }

    @Override
    public int compareTo(VersionInfo o) {
        if (o == null) {
            return -1; // push nulls to end
        }
        if (o == this) {
            return 0;
        }

        int nRes = Integer.compare(getMajorVersion(), o.getMajorVersion());
        if (nRes == 0) {
            nRes = Integer.compare(getMinorVersion(), o.getMinorVersion());
        }
        if (nRes == 0) {
            nRes = Integer.compare(getRelease(), o.getRelease());
        }
        if (nRes == 0) {
            nRes = Integer.compare(getBuildNumber(), o.getBuildNumber());
        }

        return nRes;
    }

    @Override
    public String toString() {
        return NumberUtils.join('.', getMajorVersion(), getMinorVersion(), getRelease(), getBuildNumber());
    }

    /**
     * Parses a version string - assumed to contain at most 4 non-negative components separated by a '.'. If less than 4
     * components are found, then the rest are assumed to be zero. If more than 4 components found, then only the 1st
     * ones are parsed.
     *
     * @param  version                  The version string - ignored if {@code null}/empty
     * @return                          The parsed {@link VersionInfo} - or {@code null} if empty input
     * @throws NumberFormatException    If failed to parse any of the components
     * @throws IllegalArgumentException If any of the parsed components is negative
     */
    public static VersionInfo parse(String version) throws NumberFormatException {
        String[] comps = GenericUtils.split(version, '.');
        if (GenericUtils.isEmpty(comps)) {
            return null;
        }

        int[] values = new int[4];
        int maxValues = Math.min(comps.length, values.length);
        for (int index = 0; index < maxValues; index++) {
            String c = comps[index];
            int v = Integer.parseInt(c);
            ValidateUtils.checkTrue(v >= 0, "Invalid version component in %s", version);
            values[index] = v;
        }

        return new VersionInfo(values[0], values[1], values[2], values[3]);
    }
}