src/main/java/org/onap/clamp/util/SemanticVersioning.java

   1 /*-
   2  * ============LICENSE_START=======================================================
   3  * ONAP CLAMP
   4  * ================================================================================
   5  * Copyright (C) 2020 AT&T Intellectual Property. All rights
   6  *                             reserved.
   7  * ================================================================================
   8  * Licensed under the Apache License, Version 2.0 (the "License");
   9  * you may not use this file except in compliance with the License.
  10  * 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, software
  15  * distributed under the License is distributed on an "AS IS" BASIS,
  16  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  17  * See the License for the specific language governing permissions and
  18  * limitations under the License.
  19  * ============LICENSE_END============================================
  20  * ===================================================================
  21  *
  22  */
  23
  24 package org.onap.clamp.util;
  25
  26 /**
  27  * This class is the base class for object that requires semantic versioning.
  28  * ... This class supports also a.b.c.d... etc ... as a version.
  29  *
  30  *
  31  */
  32 public class SemanticVersioning {
  33     public static final int BEFORE = -1;
  34     public static final int EQUAL = 0;
  35     public static final int AFTER = 1;
  36     public static final String DEFAULT_VERSION = "1.0.0";
  37
  38     /**
  39      * The compare method that compare arg0 to arg1.
  40      *
  41      * @param arg0 A version in string for semantic versioning (a.b.c.d...)
  42      * @param arg1 A version in string for semantic versioning (a.b.c.d...)
  43      * @return objects (arg0, arg1) given as parameters. It returns the value: 0: if
  44      *         (arg0==arg1) -1: if (arg0 < arg1) 1: if (arg0 > arg1)
  45      */
  46     public static int compare(String arg0, String arg1) {
  47
  48         if (arg0 == null && arg1 == null) {
  49             return EQUAL;
  50         }
  51         if (arg0 == null) {
  52             return BEFORE;
  53         }
  54         if (arg1 == null) {
  55             return AFTER;
  56         }
  57         String[] arg0Array = arg0.split("\\.");
  58         String[] arg1Array = arg1.split("\\.");
  59
  60         int smalestStringLength = Math.min(arg0Array.length, arg1Array.length);
  61
  62         for (int currentVersionIndex =
  63             0; currentVersionIndex < smalestStringLength; ++currentVersionIndex) {
  64             if (Integer.parseInt(arg0Array[currentVersionIndex]) < Integer
  65                 .parseInt(arg1Array[currentVersionIndex])) {
  66                 return BEFORE;
  67             } else if (Integer.parseInt(arg0Array[currentVersionIndex]) > Integer
  68                 .parseInt(arg1Array[currentVersionIndex])) {
  69                 return AFTER;
  70             }
  71             // equals, so do not return anything, continue
  72         }
  73         if (arg0Array.length == arg1Array.length) {
  74             return EQUAL;
  75         } else {
  76             return Integer.compare(arg0Array.length, arg1Array.length);
  77         }
  78     }
  79
  80     /**
  81      * Method to increment a version from its current version.
  82      *
  83      * @param currentVersion The current Version
  84      * @return the increment version string
  85      */
  86     public static String incrementMajorVersion(String currentVersion) {
  87         if (currentVersion == null || currentVersion.isEmpty()) {
  88             return DEFAULT_VERSION;
  89         }
  90         String[] versionArray = currentVersion.split("\\.");
  91         return String.valueOf(Integer.parseInt(versionArray[0]) + 1)+".0.0";
  92     }
  93 }