1 /* 2 * Licensed to the Apache Software Foundation (ASF) under one 3 * or more contributor license agreements. See the NOTICE file 4 * distributed with this work for additional information 5 * regarding copyright ownership. The ASF licenses this file 6 * to you under the Apache License, Version 2.0 (the "License"); 7 * you may not use this file except in compliance with the License. 8 * You may obtain a copy of the License at 9 * 10 * http://www.apache.org/licenses/LICENSE-2.0 11 * 12 * Unless required by applicable law or agreed to in writing, software 13 * distributed under the License is distributed on an "AS IS" BASIS, 14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 15 * See the License for the specific language governing permissions and 16 * limitations under the License. 17 */ 18 /* 19 * $Id: Version.java 477252 2006-11-20 16:52:00Z minchau $ 20 */ 21 package org.apache.xml.serializer; 22 23 /** 24 * Administrative class to keep track of the version number of 25 * the Serializer release. 26 * <P>This class implements the upcoming standard of having 27 * org.apache.project-name.Version.getVersion() be a standard way 28 * to get version information.</P> 29 * @xsl.usage general 30 */ 31 public final class Version 32 { 33 34 /** 35 * Get the basic version string for the current Serializer. 36 * Version String formatted like 37 * <CODE>"<B>Serializer</B> <B>Java</B> v.r[.dd| <B>D</B>nn]"</CODE>. 38 * 39 * Futurework: have this read version info from jar manifest. 40 * 41 * @return String denoting our current version 42 */ getVersion()43 public static String getVersion() 44 { 45 return getProduct()+" "+getImplementationLanguage()+" " 46 +getMajorVersionNum()+"."+getReleaseVersionNum()+"." 47 +( (getDevelopmentVersionNum() > 0) ? 48 ("D"+getDevelopmentVersionNum()) : (""+getMaintenanceVersionNum())); 49 } 50 51 /** 52 * Print the processor version to the command line. 53 * 54 * @param argv command line arguments, unused. 55 */ main(String argv[])56 public static void main(String argv[]) 57 { 58 System.out.println(getVersion()); 59 } 60 61 /** 62 * Name of product: Serializer. 63 */ getProduct()64 public static String getProduct() 65 { 66 return "Serializer"; 67 } 68 69 /** 70 * Implementation Language: Java. 71 */ getImplementationLanguage()72 public static String getImplementationLanguage() 73 { 74 return "Java"; 75 } 76 77 78 /** 79 * Major version number. 80 * Version number. This changes only when there is a 81 * significant, externally apparent enhancement from 82 * the previous release. 'n' represents the n'th 83 * version. 84 * 85 * Clients should carefully consider the implications 86 * of new versions as external interfaces and behaviour 87 * may have changed. 88 */ getMajorVersionNum()89 public static int getMajorVersionNum() 90 { 91 return 2; 92 93 } 94 95 /** 96 * Release Number. 97 * Release number. This changes when: 98 * - a new set of functionality is to be added, eg, 99 * implementation of a new W3C specification. 100 * - API or behaviour change. 101 * - its designated as a reference release. 102 */ getReleaseVersionNum()103 public static int getReleaseVersionNum() 104 { 105 return 7; 106 } 107 108 /** 109 * Maintenance Drop Number. 110 * Optional identifier used to designate maintenance 111 * drop applied to a specific release and contains 112 * fixes for defects reported. It maintains compatibility 113 * with the release and contains no API changes. 114 * When missing, it designates the final and complete 115 * development drop for a release. 116 */ getMaintenanceVersionNum()117 public static int getMaintenanceVersionNum() 118 { 119 return 1; 120 } 121 122 /** 123 * Development Drop Number. 124 * Optional identifier designates development drop of 125 * a specific release. D01 is the first development drop 126 * of a new release. 127 * 128 * Development drops are works in progress towards a 129 * compeleted, final release. A specific development drop 130 * may not completely implement all aspects of a new 131 * feature, which may take several development drops to 132 * complete. At the point of the final drop for the 133 * release, the D suffix will be omitted. 134 * 135 * Each 'D' drops can contain functional enhancements as 136 * well as defect fixes. 'D' drops may not be as stable as 137 * the final releases. 138 */ getDevelopmentVersionNum()139 public static int getDevelopmentVersionNum() 140 { 141 try { 142 if ((new String("")).length() == 0) 143 return 0; 144 else 145 return Integer.parseInt(""); 146 } catch (NumberFormatException nfe) { 147 return 0; 148 } 149 } 150 } 151