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