OSDN Git Service

b654ce6cddb431f2976d5cf69f4631d8c9976abf
[pf3gnuchains/gcc-fork.git] / libjava / java / net / Inet4Address.java
1 /* Inet4Address.java --
2    Copyright (C) 2002, 2003, 2004  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., 59 Temple Place, Suite 330, Boston, MA
19 02111-1307 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 java.net;
40
41 import java.io.ObjectStreamException;
42 import java.util.Arrays;
43
44 /*
45  * Written using on-line Java Platform 1.4 API Specification and
46  * RFC 1884 (http://www.ietf.org/rfc/rfc1884.txt),
47  * RFC 1918 (http://www.ietf.org/rfc/rfc1918.txt),
48  * RFC 2365 (http://www.ietf.org/rfc/rfc2365.txt)
49  *
50  * @author Michael Koch
51  * @status Believed complete and correct.
52  */
53 public final class Inet4Address extends InetAddress
54 {
55   /**
56    * For compatability with Sun's JDK 1.4.2 rev. 5
57    */
58   static final long serialVersionUID = 3286316764910316507L;
59
60   /**
61    * needed for serialization
62    */
63   private Object writeReplace() throws ObjectStreamException
64   {
65     return new InetAddress(addr, hostName);
66   }
67   
68   /**
69    * Initializes this object's addr instance variable from the passed in
70    * byte array.  Note that this constructor is protected and is called
71    * only by static methods in this class.
72    *
73    * @param addr The IP number of this address as an array of bytes
74    * @param hostname The hostname of this IP address.
75    */
76   Inet4Address(byte[] addr, String host)
77   {
78     super(addr, host);
79   }
80
81   /**
82    * Checks if the address is a multicast address
83    *
84    * @since 1.1
85    */
86   public boolean isMulticastAddress()
87   {
88     return (addr[0] & 0xF0) == 0xE0;
89   }
90
91   /**
92    * Checks if this address is a loopback address
93    */
94   public boolean isLoopbackAddress()
95   {
96     return addr[0] == 0x7F;
97   }
98
99   /**
100    * Checks if this address is a wildcard address
101    *
102    * @since 1.4
103    */
104   public boolean isAnyLocalAddress()
105   {
106     byte[] anylocal = { 0, 0, 0, 0 };
107
108     return Arrays.equals(addr, anylocal);
109   }
110
111   /**
112    * Checks if this address is a link local address
113    *
114    * @since 1.4
115    */
116   public boolean isLinkLocalAddress()
117   {
118     // XXX: This seems to not exist with IPv4 addresses
119     return false;
120   }
121
122   /**
123    * Checks if this address is a site local address
124    *
125    * @since 1.4
126    */
127   public boolean isSiteLocalAddress()
128   {
129     // 10.0.0.0/8
130     if (addr[0] == 0x0A)
131       return true;
132
133     // XXX: Suns JDK 1.4.1 (on Linux) seems to have a bug here:
134     // it says 172.16.0.0 - 172.255.255.255 are site local addresses
135     //
136     // 172.16.0.0/12
137     if (addr[0] == 0xAC && (addr[1] & 0xF0) == 0x01)
138       return true;
139
140     // 192.168.0.0/16
141     if (addr[0] == 0xC0 && addr[1] == 0xA8)
142       return true;
143
144     // XXX: Do we need to check more addresses here ?
145     return false;
146   }
147
148   /**
149    * Checks if this multicast address has global scope
150    *
151    * @since 1.4
152    */
153   public boolean isMCGlobal()
154   {
155     // XXX: This seems to net exist with IPv4 addresses
156     return false;
157   }
158
159   /**
160    * Checks if this multicast address has node scope
161    *
162    * @since 1.4
163    */
164   public boolean isMCNodeLocal()
165   {
166     // XXX: This seems to net exist with IPv4 addresses
167     return false;
168   }
169
170   /**
171    * Checks if this multicast address has link scope
172    *
173    * @since 1.4
174    */
175   public boolean isMCLinkLocal()
176   {
177     if (! isMulticastAddress())
178       return false;
179
180     return (addr[0] == 0xE0) && (addr[1] == 0x00) && (addr[2] == 0x00);
181   }
182
183   /**
184    * Checks if this multicast address has site scope
185    *
186    * @since 1.4
187    */
188   public boolean isMCSiteLocal()
189   {
190     // XXX: This seems to net exist with IPv4 addresses
191     return false;
192   }
193
194   /**
195    * Checks if this multicast address has organization scope
196    *
197    * @since 1.4
198    */
199   public boolean isMCOrgLocal()
200   {
201     // XXX: This seems to net exist with IPv4 addresses
202     return false;
203   }
204
205   /**
206    * Returns the address of the current instance
207    */
208   public byte[] getAddress()
209   {
210     return (byte[]) addr.clone();
211   }
212
213   /**
214    * Returns the address as string
215    *
216    * @since 1.0.2
217    */
218   public String getHostAddress()
219   {
220     StringBuffer sbuf = new StringBuffer(40);
221     int len = addr.length;
222     int i = 0;
223
224     for (;;)
225       {
226         sbuf.append(addr[i] & 0xFF);
227         i++;
228
229         if (i == len)
230           break;
231
232         sbuf.append('.');
233       }
234
235     return sbuf.toString();
236   }
237
238   /**
239    * Computes the hashcode of the instance
240    */
241   public int hashCode()
242   {
243     int hash = 0;
244     int len = addr.length;
245     int i = len > 4 ? len - 4 : 0;
246
247     for (; i < len; i++)
248       hash = (hash << 8) | (addr[i] & 0xFF);
249
250     return hash;
251   }
252
253   /**
254    * Compare the current Inet4Address instance with obj
255    *
256    * @param obj Object to compare with
257    */
258   public boolean equals(Object obj)
259   {
260     if (! (obj instanceof InetAddress))
261       return false;
262
263     byte[] addr1 = addr;
264     byte[] addr2 = ((InetAddress) obj).addr;
265
266     if (addr1.length != addr2.length)
267       return false;
268
269     for (int i = addr1.length; --i >= 0;)
270       if (addr1[i] != addr2[i])
271         return false;
272
273     return true;
274   }
275 } // class Inet4Address