Source code: 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 hostname 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 }