1 /* Version.java --
2    Copyright (C) 2005 Free Software Foundation, Inc.
3 
4 This file is part of GNU Classpath.
5 
6 GNU Classpath is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
9 any later version.
10 
11 GNU Classpath is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14 General Public License for more details.
15 
16 You should have received a copy of the GNU General Public License
17 along with GNU Classpath; see the file COPYING.  If not, write to the
18 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
19 02110-1301 USA.
20 
21 Linking this library statically or dynamically with other modules is
22 making a combined work based on this library.  Thus, the terms and
23 conditions of the GNU General Public License cover the whole
24 combination.
25 
26 As a special exception, the copyright holders of this library give you
27 permission to link this library with independent modules to produce an
28 executable, regardless of the license terms of these independent
29 modules, and to copy and distribute the resulting executable under
30 terms of your choice, provided that you also meet, for each linked
31 independent module, the terms and conditions of the license of that
32 module.  An independent module is a module which is not derived from
33 or based on this library.  If you modify this library, you may extend
34 this exception to your version of the library, but you are not
35 obligated to do so.  If you do not wish to do so, delete this
36 exception statement from your version. */
37 
38 
39 package gnu.CORBA;
40 
41 import java.io.IOException;
42 import java.io.Serializable;
43 
44 import org.omg.CORBA.MARSHAL;
45 
46 /**
47  * A version number, represented by the major version number
48  * and the minor version number.
49  *
50  * @author Audrius Meskauskas (AudriusA@Bioinformatics.org)
51  */
52 public class Version
53   implements Serializable
54 {
55   /**
56    * Use serialVersionUID for interoperability.
57    */
58   private static final long serialVersionUID = 1;
59 
60   /**
61    * Major number (0..256, so the byte cannot be used).
62    */
63   public final int major;
64 
65   /**
66    * Minor number.
67    */
68   public final int minor;
69 
70   /**
71    * Create the version with the given version numbers.
72    *
73    * @param _major major number (0..255)
74    * @param _minor minor number (0..255)
75    */
Version(int _major, int _minor)76   public Version(int _major, int _minor)
77   {
78     major = (byte) _major;
79     minor = (byte) _minor;
80   }
81 
82   /**
83    * Returns true if the versions are equal.
84    * @param other the other version to compare.
85    *
86    * @return true if the versions are equal
87    */
equals(java.lang.Object other)88   public boolean equals(java.lang.Object other)
89   {
90     if (other == this)
91       {
92         return true;
93       }
94     if (!(other instanceof Version))
95       {
96         return false;
97       }
98 
99     Version that = (Version) other;
100     return same(that);
101   }
102 
103   /**
104    * Get the hashcode, higher 8 bits being the major version and lower 8 bits
105    * the minor version.
106    */
hashCode()107   public int hashCode()
108   {
109     return major << 8 | minor;
110   }
111 
112   /**
113    * Read from the input stream, major number first.
114    * @param in a stream to read from.
115    */
read_version(java.io.InputStream in)116   public static Version read_version(java.io.InputStream in)
117   {
118     try
119       {
120         int major = in.read() & 0xFF;
121         int minor = in.read() & 0xFF;
122         return new Version(major, minor);
123       }
124     catch (IOException ex)
125       {
126         MARSHAL m = new MARSHAL("IOException while reading message header");
127         m.initCause(ex);
128         m.minor = Minor.Header;
129         throw m;
130       }
131   }
132 
133   /**
134    * Returns true if the versions are the same.
135    *
136    * @param that the other version to compare.
137    *
138    * @return true if the versions are the same.
139    */
same(Version that)140   public boolean same(Version that)
141   {
142     return major == that.major && minor == that.minor;
143   }
144 
145   /**
146    * Returns true if the given version is higher than
147    * or equals to the version, supplied as parameter
148    * in the form of two integers.
149    *
150    * @param a_major major number of the version to compare.
151    * @param a_minor minor number of the version to compare.
152    *
153    * @return true if this version is higher than or equals to
154    * the version v.
155    */
since_inclusive(int a_major, int a_minor)156   public boolean since_inclusive(int a_major, int a_minor)
157   {
158     if (major > a_major)
159       return true;
160     else if (major < a_major)
161       return false;
162     else
163 
164       // Major numbers are equal.
165       return minor >= a_minor;
166   }
167 
168   /**
169    * Return the string representation, in the form
170    * major.minor.
171    */
toString()172   public String toString()
173   {
174     return major + "." + minor;
175   }
176 
177   /**
178    * Returs true if the given version is lower or equal to the
179    * version, specified by the provided minor and major version
180    * number. This means, the version, specified by these two numbers,
181    * should be supported by the current version.
182    *
183    * @param a_major a major version number.
184    * @param a_minor a minor version number.
185    *
186    * @return true if the current version should be supported by the
187    * version, specified by the two passed numbers.
188    */
until_inclusive(int a_major, int a_minor)189   public boolean until_inclusive(int a_major, int a_minor)
190   {
191     if (major < a_major)
192       return true;
193     else if (major > a_major)
194       return false;
195     else
196 
197       // Major numbers are equal.
198       return minor <= a_minor;
199   }
200 
201   /**
202    * Write into the output stream, major number first.
203    *
204    * @param out a stream to write into.
205    */
write(java.io.OutputStream out)206   public void write(java.io.OutputStream out)
207   {
208     try
209       {
210         out.write(major & 0xFF);
211         out.write(minor & 0xFF);
212       }
213     catch (IOException ex)
214       {
215         MARSHAL m = new MARSHAL("IOException while writing message header");
216         m.minor = Minor.Header;
217         m.initCause(ex);
218         throw m;
219       }
220   }
221 
222 }
223