cdmlib-model/src/main/java/eu/etaxonomy/cdm/model/metadata/CdmMetaData.java

   1 /**
   2 * Copyright (C) 2007 EDIT
   3 * European Distributed Institute of Taxonomy
   4 * http://www.e-taxonomy.eu
   5 *
   6 * The contents of this file are subject to the Mozilla Public License Version 1.1
   7 * See LICENSE.TXT at the top of this package for the full license terms.
   8 */
   9
  10 package eu.etaxonomy.cdm.model.metadata;
  11
  12 import java.util.ArrayList;
  13 import java.util.Comparator;
  14 import java.util.List;
  15 import java.util.UUID;
  16
  17 import javax.persistence.Column;
  18 import javax.persistence.Entity;
  19 import javax.validation.constraints.NotNull;
  20 import javax.xml.bind.annotation.XmlAttribute;
  21
  22 import org.apache.log4j.Logger;
  23 import org.hibernate.annotations.Type;
  24 import org.joda.time.DateTime;
  25
  26 import eu.etaxonomy.cdm.common.monitor.IProgressMonitor;
  27 import eu.etaxonomy.cdm.model.common.CdmBase;
  28 import eu.etaxonomy.cdm.model.term.DefinedTermBase;
  29 import eu.etaxonomy.cdm.model.term.TermType;
  30 import eu.etaxonomy.cdm.model.term.TermVocabulary;
  31
  32 /**
  33  * @author a.mueller
  34  * @since 07.09.2009
  35  */
  36 @Entity
  37 public class CdmMetaData extends CdmBase{
  38
  39     private static final long serialVersionUID = -3033376680593279078L;
  40         @SuppressWarnings("unused")
  41         private static final Logger logger = Logger.getLogger(CdmMetaData.class);
  42
  43         private static final String UNNAMED = "- UNNAMED -";
  44
  45
  46         /* It is a little bit confusing that this specific information is located in
  47          * a generic class for metadata. Think about moving the schema version
  48          *
  49          */
  50         /**
  51          * The database schema version number.
  52          * It is recommended to have the first two numbers equal to the CDM Library version number.
  53          * But it is not obligatory as there may be cases when the library number changes but the
  54          * schema version is not changing.
  55          * The third should be incremented if the schema changes in a way that SCHEMA_VALIDATION.UPDATE
  56          * will probably not work or will not be enough to transform old data into new data.
  57          * The fourth number should be incremented when minor schema changes take place that can
  58          * be handled by SCHEMA_VALIDATION.UPDATE
  59          * The last number represents the date of change.
  60          */
  61 //      private static final String dbSchemaVersion = "5.11.1.0.20191108";
  62 //    private static final String dbSchemaVersion = "5.12.0.0.20191202";
  63     private static final String dbSchemaVersion = "5.11.2.0.20191109";
  64
  65
  66         /* END OF CONFUSION */
  67
  68            /**
  69      * The {@link TermType type} of this term. Needs to be the same type in a {@link DefinedTermBase defined term}
  70      * and in it's {@link TermVocabulary vocabulary}.
  71      */
  72     @XmlAttribute(name ="PropertyName")
  73     @Column(name="propertyName", length=20)
  74     @NotNull
  75     @Type(type = "eu.etaxonomy.cdm.hibernate.EnumUserType",
  76         parameters = {@org.hibernate.annotations.Parameter(name  = "enumClass", value = "eu.etaxonomy.cdm.model.metadata.CdmMetaDataPropertyName")}
  77     )
  78         private CdmMetaDataPropertyName propertyName;
  79         private String value;
  80
  81
  82 //********************* Constructor *********************************************/
  83
  84         /**
  85          * Simple constructor to be used by Spring
  86          */
  87         protected CdmMetaData(){
  88                 super();
  89         }
  90
  91         public CdmMetaData(CdmMetaDataPropertyName propertyName, String value) {
  92                 super();
  93                 this.propertyName = propertyName;
  94                 this.value = value;
  95         }
  96
  97 // ******************** STATIC **********************************/
  98
  99
 100     /**
 101      * @return a list of default metadata objects
 102      */
 103     public static final List<CdmMetaData> defaultMetaData(){
 104         List<CdmMetaData> result = new ArrayList<>();
 105         // schema version
 106         result.add(new CdmMetaData(CdmMetaDataPropertyName.DB_SCHEMA_VERSION, dbSchemaVersion));
 107         // database create time
 108         result.add(new CdmMetaData(CdmMetaDataPropertyName.DB_CREATE_DATE, new DateTime().toString()));
 109         result.add(new CdmMetaData(CdmMetaDataPropertyName.INSTANCE_ID, UUID.randomUUID().toString()));
 110         result.add(new CdmMetaData(CdmMetaDataPropertyName.INSTANCE_NAME, UNNAMED));
 111         return result;
 112     }
 113
 114
 115
 116 //****************** instance methods ****************************/
 117
 118         public CdmMetaDataPropertyName getPropertyName() {
 119                 return propertyName;
 120         }
 121         public void setPropertyName(CdmMetaDataPropertyName propertyName) {
 122                 this.propertyName = propertyName;
 123         }
 124
 125         public String getValue() {
 126                 return value;
 127         }
 128         public void setValue(String value) {
 129                 this.value = value;
 130         }
 131
 132 //******************** Version comparator **********************************/
 133
 134         public static class VersionComparator implements Comparator<String>{
 135                 Integer depth;
 136                 IProgressMonitor monitor;
 137
 138                 public VersionComparator(Integer depth, IProgressMonitor monitor){
 139                         this.depth = depth;
 140                         this.monitor = monitor;
 141                 }
 142
 143                 @Override
 144         public int compare(String version1, String version2) {
 145                         int result = 0;
 146
 147                         if (version1.equals(version2)){
 148                             return 0;
 149                         }
 150
 151                         String[] version1Split = version1.split("\\.");
 152                         String[] version2Split = version2.split("\\.");
 153
 154                         if(version1Split.length == 1 || version2Split.length == 1){
 155                                 throwException("Tried to compare version but given Strings don't seem to " +
 156                                                 "contain version numbers. version1: " + version1 + ", version2:" + version2);
 157                         }
 158
 159                         if(depth != null && (version1Split.length < depth || version2Split.length < depth )){
 160                                 throwException("Desired depth can not be achieved with the given strings. depth: " + depth  + ", version1: " + version1 + ", version2:" + version2);
 161                         }
 162                         //use the shorter version to avoid arrayOutOfBoundsException, if version2Split.length < version1Split.length but > depth
 163                         int length = (version1Split.length < version2Split.length) ? version1Split.length: version2Split.length;
 164                         if (depth != null){
 165                             length = length<depth?length:depth;
 166                         }
 167                         for (int i = 0; i < length; i++){
 168                                 Long version1Part = Long.valueOf(version1Split[i]);
 169                                 Long version2Part = Long.valueOf(version2Split[i]);
 170                                 int partCompare = version1Part.compareTo(version2Part);
 171                                 if (partCompare != 0){
 172                                         return partCompare;
 173                                 }
 174                         }
 175                         return result;
 176                 }
 177
 178                 private Throwable throwException(String message){
 179                         RuntimeException exception =  new RuntimeException(message);
 180                         if (monitor != null){
 181                                 monitor.warning(message, exception);
 182                         }
 183                         throw exception;
 184                 }
 185         }
 186
 187         /**
 188          * Compares two version string. If version1 is higher than version2 a positive result is returned.
 189          * If both are equal 0 is returned, otherwise -1 is returned.
 190          * @see Comparator#compare(Object, Object)
 191          * @param version1
 192          * @param version2
 193          * @param depth
 194          * @param monitor
 195          * @return
 196          */
 197         public static int compareVersion(String version1, String version2, Integer depth, IProgressMonitor monitor){
 198                 VersionComparator versionComparator = new VersionComparator(depth, monitor);
 199                 return versionComparator.compare(version1, version2);
 200         }
 201
 202         public static boolean isDbSchemaVersionCompatible(String version){
 203                 return compareVersion(dbSchemaVersion, version, 3, null) == 0;
 204         }
 205
 206         public static String getDbSchemaVersion() {
 207                 return dbSchemaVersion;
 208         }
 209
 210 }