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 577939 2007-09-20 21:45:37Z minchau $
20  */
21 package org.apache.xalan;
22 
23 /**
24  * Administrative class to keep track of the version number of
25  * the Xalan 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.  This class will replace the older
29  * org.apache.xalan.processor.Version class.</P>
30  * <P>See also: org/apache/xalan/res/XSLTInfo.properties for
31  * information about the version of the XSLT spec we support.</P>
32  * @xsl.usage general
33  */
34 public class Version
35 {
36 
37   /**
38    * Get the basic version string for the current Xalan release.
39    * Version String formatted like
40    * <CODE>"<B>Xalan</B> <B>Java</B> v.r[.dd| <B>D</B>nn]"</CODE>.
41    *
42    * Futurework: have this read version info from jar manifest.
43    *
44    * @return String denoting our current version
45    */
getVersion()46   public static String getVersion()
47   {
48      return getProduct()+" "+getImplementationLanguage()+" "
49            +getMajorVersionNum()+"."+getReleaseVersionNum()+"."
50            +( (getDevelopmentVersionNum() > 0) ?
51                ("D"+getDevelopmentVersionNum()) : (""+getMaintenanceVersionNum()));
52   }
53 
54   /**
55    * Print the processor version to the command line.
56    *
57    * @param argv command line arguments, unused.
58    */
main(String argv[])59   public static void main(String argv[])
60   {
61     System.out.println(getVersion());
62   }
63 
64   /**
65    * Name of product: Xalan.
66    */
getProduct()67   public static String getProduct()
68   {
69     return "Xalan";
70   }
71 
72   /**
73    * Implementation Language: Java.
74    */
getImplementationLanguage()75   public static String getImplementationLanguage()
76   {
77     return "Java";
78   }
79 
80 
81   /**
82    * Major version number.
83    * Version number. This changes only when there is a
84    *          significant, externally apparent enhancement from
85    *          the previous release. 'n' represents the n'th
86    *          version.
87    *
88    *          Clients should carefully consider the implications
89    *          of new versions as external interfaces and behaviour
90    *          may have changed.
91    */
getMajorVersionNum()92   public static int getMajorVersionNum()
93   {
94     return 2;
95 
96   }
97 
98   /**
99    * Release Number.
100    * Release number. This changes when:
101    *            -  a new set of functionality is to be added, eg,
102    *               implementation of a new W3C specification.
103    *            -  API or behaviour change.
104    *            -  its designated as a reference release.
105    */
getReleaseVersionNum()106   public static int getReleaseVersionNum()
107   {
108     return 7;
109   }
110 
111   /**
112    * Maintenance Drop Number.
113    * Optional identifier used to designate maintenance
114    *          drop applied to a specific release and contains
115    *          fixes for defects reported. It maintains compatibility
116    *          with the release and contains no API changes.
117    *          When missing, it designates the final and complete
118    *          development drop for a release.
119    */
getMaintenanceVersionNum()120   public static int getMaintenanceVersionNum()
121   {
122     return 1;
123   }
124 
125   /**
126    * Development Drop Number.
127    * Optional identifier designates development drop of
128    *          a specific release. D01 is the first development drop
129    *          of a new release.
130    *
131    *          Development drops are works in progress towards a
132    *          compeleted, final release. A specific development drop
133    *          may not completely implement all aspects of a new
134    *          feature, which may take several development drops to
135    *          complete. At the point of the final drop for the
136    *          release, the D suffix will be omitted.
137    *
138    *          Each 'D' drops can contain functional enhancements as
139    *          well as defect fixes. 'D' drops may not be as stable as
140    *          the final releases.
141    */
getDevelopmentVersionNum()142   public static int getDevelopmentVersionNum()
143   {
144     try {
145         if ((new String("")).length() == 0)
146           return 0;
147         else
148           return Integer.parseInt("");
149     } catch (NumberFormatException nfe) {
150            return 0;
151     }
152   }
153 }
154