OSDN Git Service

c80f1f175a29f10e73f6f1ab6f3bc980de47158e
[pf3gnuchains/gcc-fork.git] / libjava / classpath / java / net / Inet4Address.java
1 /* Inet4Address.java --
2    Copyright (C) 2002, 2003, 2004, 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 java.net;
40
41 import java.io.ObjectStreamException;
42
43 /*
44  * Written using on-line Java Platform 1.4 API Specification and
45  * RFC 1884 (http://www.ietf.org/rfc/rfc1884.txt),
46  * RFC 1918 (http://www.ietf.org/rfc/rfc1918.txt),
47  * RFC 2365 (http://www.ietf.org/rfc/rfc2365.txt)
48  *
49  * @author Michael Koch
50  * @status Believed complete and correct.
51  */
52 public final class Inet4Address extends InetAddress
53 {
54   /**
55    * For compatability with Sun's JDK 1.4.2 rev. 5
56    */
57   static final long serialVersionUID = 3286316764910316507L;
58
59   /**
60    * needed for serialization
61    */
62   private Object writeReplace() throws ObjectStreamException
63   {
64     return new InetAddress(addr, hostName);
65   }
66   
67   /**
68    * Initializes this object's addr instance variable from the passed in
69    * byte array.  Note that this constructor is protected and is called
70    * only by static methods in this class.
71    *
72    * @param addr The IP number of this address as an array of bytes
73    * @param host The hostname of this IP address.
74    */
75   Inet4Address(byte[] addr, String host)
76   {
77     super(addr, host);
78   }
79
80   /**
81    * Checks if the address is a multicast address
82    *
83    * @since 1.1
84    */
85   public boolean isMulticastAddress()
86   {
87     return super.isMulticastAddress();
88   }
89
90   /**
91    * Checks if this address is a loopback address
92    */
93   public boolean isLoopbackAddress()
94   {
95     return super.isLoopbackAddress();
96   }
97
98   /**
99    * Checks if this address is a wildcard address
100    *
101    * @since 1.4
102    */
103   public boolean isAnyLocalAddress()
104   {
105     return super.isAnyLocalAddress();
106   }
107
108   /**
109    * Checks if this address is a link local address
110    *
111    * @since 1.4
112    */
113   public boolean isLinkLocalAddress()
114   {
115     return super.isLinkLocalAddress();
116   }
117
118   /**
119    * Checks if this address is a site local address
120    *
121    * @since 1.4
122    */
123   public boolean isSiteLocalAddress()
124   {
125     return super.isSiteLocalAddress();
126   }
127
128   /**
129    * Checks if this multicast address has global scope
130    *
131    * @since 1.4
132    */
133   public boolean isMCGlobal()
134   {
135     return super.isMCGlobal();
136   }
137
138   /**
139    * Checks if this multicast address has node scope
140    *
141    * @since 1.4
142    */
143   public boolean isMCNodeLocal()
144   {
145     return super.isMCNodeLocal();
146   }
147
148   /**
149    * Checks if this multicast address has link scope
150    *
151    * @since 1.4
152    */
153   public boolean isMCLinkLocal()
154   {
155     return super.isMCLinkLocal();
156   }
157
158   /**
159    * Checks if this multicast address has site scope
160    *
161    * @since 1.4
162    */
163   public boolean isMCSiteLocal()
164   {
165     return super.isMCSiteLocal();
166   }
167
168   /**
169    * Checks if this multicast address has organization scope
170    *
171    * @since 1.4
172    */
173   public boolean isMCOrgLocal()
174   {
175     return super.isMCOrgLocal();
176   }
177
178   /**
179    * Returns the address of the current instance
180    */
181   public byte[] getAddress()
182   {
183     return (byte[]) addr.clone();
184   }
185
186   /**
187    * Returns the address as string
188    *
189    * @since 1.0.2
190    */
191   public String getHostAddress()
192   {
193     return super.getHostAddress();
194   }
195
196   /**
197    * Computes the hashcode of the instance
198    */
199   public int hashCode()
200   {
201     int hash = 0;
202     int len = addr.length;
203     int i = len > 4 ? len - 4 : 0;
204
205     for (; i < len; i++)
206       hash = (hash << 8) | (addr[i] & 0xFF);
207
208     return hash;
209   }
210
211   /**
212    * Compare the current Inet4Address instance with obj
213    *
214    * @param obj Object to compare with
215    */
216   public boolean equals(Object obj)
217   {
218     if (! (obj instanceof InetAddress))
219       return false;
220
221     byte[] addr1 = addr;
222     byte[] addr2 = ((InetAddress) obj).addr;
223
224     if (addr1.length != addr2.length)
225       return false;
226
227     for (int i = addr1.length; --i >= 0;)
228       if (addr1[i] != addr2[i])
229         return false;
230
231     return true;
232   }
233 }