1 /* Socket.java -- Client socket implementation
2 Copyright (C) 1998, 1999, 2000, 2002 Free Software Foundation, Inc.
4 This file is part of GNU Classpath.
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)
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.
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
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
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. */
41 import java
.nio
.channels
.SocketChannel
;
42 import java
.nio
.channels
.IllegalBlockingModeException
;
44 /* Written using on-line Java Platform 1.2 API Specification.
45 * Status: I believe all methods are implemented.
49 * This class models a client site socket. A socket is a TCP/IP endpoint
50 * for network communications conceptually similar to a file handle.
52 * This class does not actually do any work. Instead, it redirects all of
53 * its calls to a socket implementation object which implements the
54 * <code>SocketImpl</code> interface. The implementation class is
55 * instantiated by factory class that implements the
56 * <code>SocketImplFactory interface</code>. A default
57 * factory is provided, however the factory may be set by a call to
58 * the <code>setSocketImplFactory</code> method. Note that this may only be
59 * done once per virtual machine. If a subsequent attempt is made to set the
60 * factory, a <code>SocketException</code> will be thrown.
62 * @author Aaron M. Renn (arenn@urbanophile.com)
63 * @author Per Bothner (bothner@cygnus.com)
71 * This is the user SocketImplFactory for this class. If this variable is
72 * null, a default factory is used.
74 static SocketImplFactory factory
;
79 * The implementation object to which calls are redirected
83 private boolean inputShutdown
;
84 private boolean outputShutdown
;
86 SocketChannel ch
; // this field must have been set if created by SocketChannel
88 private boolean closed
= false;
93 * Initializes a new instance of <code>Socket</code> object without
94 * connecting to a remote host. This useful for subclasses of socket that
95 * might want this behavior.
97 * @specnote This constructor is public since JDK 1.4
103 impl
= factory
.createSocketImpl();
105 impl
= new PlainSocketImpl();
107 inputShutdown
= false;
108 outputShutdown
= false;
112 * Initializes a new instance of <code>Socket</code> object without
113 * connecting to a remote host. This is useful for subclasses of socket
114 * that might want this behavior.
116 * Additionally, this socket will be created using the supplied
117 * implementation class instead the default class or one returned by a
118 * factory. This value can be <code>null</code>, but if it is, all instance
119 * methods in <code>Socket</code> should be overridden because most of them
120 * rely on this value being populated.
122 * @param impl The <code>SocketImpl</code> to use for this
123 * <code>Socket</code>
125 * @exception SocketException If an error occurs
129 protected Socket (SocketImpl impl
) throws SocketException
132 this.inputShutdown
= false;
133 this.outputShutdown
= false;
137 * Initializes a new instance of <code>Socket</code> and connects to the
138 * hostname and port specified as arguments.
140 * @param host The name of the host to connect to
141 * @param port The port number to connect to
143 * @exception UnknownHostException If the hostname cannot be resolved to a
145 * @exception IOException If an error occurs
146 * @exception SecurityException If a security manager exists and its
147 * checkConnect method doesn't allow the operation
149 public Socket (String host
, int port
)
150 throws UnknownHostException
, IOException
152 this(InetAddress
.getByName(host
), port
, null, 0, true);
156 * Initializes a new instance of <code>Socket</code> and connects to the
157 * address and port number specified as arguments.
159 * @param address The address to connect to
160 * @param port The port number to connect to
162 * @exception IOException If an error occurs
163 * @exception SecurityException If a security manager exists and its
164 * checkConnect method doesn't allow the operation
166 public Socket (InetAddress address
, int port
)
169 this(address
, port
, null, 0, true);
173 * Initializes a new instance of <code>Socket</code> that connects to the
174 * named host on the specified port and binds to the specified local address
177 * @param host The name of the remote host to connect to.
178 * @param port The remote port to connect to.
179 * @param loadAddr The local address to bind to.
180 * @param localPort The local port to bind to.
182 * @exception SecurityException If the <code>SecurityManager</code>
183 * exists and does not allow a connection to the specified host/port or
184 * binding to the specified local host/port.
185 * @exception IOException If a connection error occurs.
189 public Socket (String host
, int port
,
190 InetAddress localAddr
, int localPort
) throws IOException
192 this(InetAddress
.getByName(host
), port
, localAddr
, localPort
, true);
196 * Initializes a new instance of <code>Socket</code> and connects to the
197 * address and port number specified as arguments, plus binds to the
198 * specified local address and port.
200 * @param address The remote address to connect to
201 * @param port The remote port to connect to
202 * @param localAddr The local address to connect to
203 * @param localPort The local port to connect to
205 * @exception IOException If an error occurs
206 * @exception SecurityException If a security manager exists and its
207 * checkConnect method doesn't allow the operation
211 public Socket (InetAddress address
, int port
,
212 InetAddress localAddr
, int localPort
) throws IOException
214 this(address
, port
, localAddr
, localPort
, true);
218 * Initializes a new instance of <code>Socket</code> and connects to the
219 * hostname and port specified as arguments. If the stream argument is set
220 * to <code>true</code>, then a stream socket is created. If it is
221 * <code>false</code>, a datagram socket is created.
223 * @param host The name of the host to connect to
224 * @param port The port to connect to
225 * @param stream <code>true</code> for a stream socket, <code>false</code>
226 * for a datagram socket
228 * @exception IOException If an error occurs
229 * @exception SecurityException If a security manager exists and its
230 * checkConnect method doesn't allow the operation
232 * @deprecated Use the <code>DatagramSocket</code> class to create
233 * datagram oriented sockets.
235 public Socket (String host
, int port
, boolean stream
) throws IOException
237 this(InetAddress
.getByName(host
), port
, null, 0, stream
);
241 * Initializes a new instance of <code>Socket</code> and connects to the
242 * address and port number specified as arguments. If the stream param is
243 * <code>true</code>, a stream socket will be created, otherwise a datagram
246 * @param host The address to connect to
247 * @param port The port number to connect to
248 * @param stream <code>true</code> to create a stream socket,
249 * <code>false</code> to create a datagram socket.
251 * @exception IOException If an error occurs
252 * @exception SecurityException If a security manager exists and its
253 * checkConnect method doesn't allow the operation
255 * @deprecated Use the <code>DatagramSocket</code> class to create
256 * datagram oriented sockets.
258 public Socket (InetAddress host
, int port
, boolean stream
) throws IOException
260 this(host
, port
, null, 0, stream
);
264 * This constructor is where the real work takes place. Connect to the
265 * specified address and port. Use default local values if not specified,
266 * otherwise use the local host and port passed in. Create as stream or
267 * datagram based on "stream" argument.
270 * @param raddr The remote address to connect to
271 * @param rport The remote port to connect to
272 * @param laddr The local address to connect to
273 * @param lport The local port to connect to
274 * @param stream true for a stream socket, false for a datagram socket
276 * @exception IOException If an error occurs
277 * @exception SecurityException If a security manager exists and its
278 * checkConnect method doesn't allow the operation
280 private Socket(InetAddress raddr
, int rport
, InetAddress laddr
, int lport
,
281 boolean stream
) throws IOException
284 this.inputShutdown
= false;
285 this.outputShutdown
= false;
288 throw new IOException("Cannot initialize Socket implementation");
290 SecurityManager sm
= System
.getSecurityManager();
292 sm
.checkConnect(raddr
.getHostName(), rport
);
296 // FIXME: JCL p. 1586 says if localPort is unspecified, bind to any port,
297 // i.e. '0' and if localAddr is unspecified, use getLocalAddress() as
298 // that default. JDK 1.2 doc infers not to do a bind.
300 impl
.bind(laddr
, lport
);
303 impl
.connect(raddr
, rport
);
307 * Binds the socket to the givent local address/port
309 * @param bindpoint The address/port to bind to
311 * @exception IOException If an error occurs
312 * @exception SecurityException If a security manager exists and its
313 * checkConnect method doesn't allow the operation
314 * @exception IllegalArgumentException If the address type is not supported
318 public void bind (SocketAddress bindpoint
) throws IOException
321 throw new SocketException ("Socket is closed");
323 if ( !(bindpoint
instanceof InetSocketAddress
))
324 throw new IllegalArgumentException ();
326 InetSocketAddress tmp
= (InetSocketAddress
) bindpoint
;
327 impl
.bind (tmp
.getAddress(), tmp
.getPort());
331 * Connects the socket with a remote address.
333 * @param endpoint The address to connect to
335 * @exception IOException If an error occurs
336 * @exception IllegalArgumentException If the addess type is not supported
337 * @exception IllegalBlockingModeException If this socket has an associated
338 * channel, and the channel is in non-blocking mode
342 public void connect (SocketAddress endpoint
)
346 throw new SocketException ("Socket is closed");
348 if (! (endpoint
instanceof InetSocketAddress
))
349 throw new IllegalArgumentException ("Address type not supported");
351 if (ch
!= null && !ch
.isBlocking ())
352 throw new IllegalBlockingModeException ();
354 impl
.connect (endpoint
, 0);
358 * Connects the socket with a remote address. A timeout of zero is
359 * interpreted as an infinite timeout. The connection will then block
360 * until established or an error occurs.
362 * @param endpoint The address to connect to
364 * @exception IOException If an error occurs
365 * @exception IllegalArgumentException If the address type is not supported
366 * @exception IllegalBlockingModeException If this socket has an associated
367 * channel, and the channel is in non-blocking mode
368 * @exception SocketTimeoutException If the timeout is reached
372 public void connect (SocketAddress endpoint
, int timeout
)
376 throw new SocketException ("Socket is closed");
378 if (! (endpoint
instanceof InetSocketAddress
))
379 throw new IllegalArgumentException ("Address type not supported");
381 if (ch
!= null && !ch
.isBlocking ())
382 throw new IllegalBlockingModeException ();
384 impl
.connect (endpoint
, timeout
);
388 * Returns the address of the remote end of the socket. If this socket
389 * is not connected, then <code>null</code> is returned.
391 * @return The remote address this socket is connected to
393 public InetAddress
getInetAddress ()
396 return impl
.getInetAddress();
402 * Returns the local address to which this socket is bound. If this socket
403 * is not connected, then <code>null</code> is returned.
405 * @return The local address
409 public InetAddress
getLocalAddress ()
414 InetAddress addr
= null;
417 addr
= (InetAddress
)impl
.getOption(SocketOptions
.SO_BINDADDR
);
419 catch(SocketException e
)
421 // (hopefully) shouldn't happen
422 // throw new java.lang.InternalError
423 // ("Error in PlainSocketImpl.getOption");
427 // FIXME: According to libgcj, checkConnect() is supposed to be called
428 // before performing this operation. Problems: 1) We don't have the
429 // addr until after we do it, so we do a post check. 2). The docs I
430 // see don't require this in the Socket case, only DatagramSocket, but
431 // we'll assume they mean both.
432 SecurityManager sm
= System
.getSecurityManager();
434 sm
.checkConnect(addr
.getHostName(), getLocalPort());
440 * Returns the port number of the remote end of the socket connection. If
441 * this socket is not connected, then -1 is returned.
443 * @return The remote port this socket is connected to
445 public int getPort ()
448 return impl
.getPort();
454 * Returns the local port number to which this socket is bound. If this
455 * socket is not connected, then -1 is returned.
457 * @return The local port
459 public int getLocalPort ()
462 return impl
.getLocalPort();
468 * If the socket is already bound this returns the local SocketAddress,
473 public SocketAddress
getLocalSocketAddress()
475 InetAddress addr
= getLocalAddress ();
480 return new InetSocketAddress (addr
, impl
.getLocalPort());
484 * If the socket is already connected this returns the remote SocketAddress,
489 public SocketAddress
getRemoteSocketAddress()
494 return new InetSocketAddress (impl
.getInetAddress (), impl
.getPort ());
498 * Returns an InputStream for reading from this socket.
500 * @return The InputStream object
502 * @exception IOException If an error occurs or Socket is not connected
504 public InputStream
getInputStream () throws IOException
507 return(impl
.getInputStream());
509 throw new IOException("Not connected");
513 * Returns an OutputStream for writing to this socket.
515 * @return The OutputStream object
517 * @exception IOException If an error occurs or Socket is not connected
519 public OutputStream
getOutputStream () throws IOException
522 return impl
.getOutputStream();
524 throw new IOException("Not connected");
528 * Sets the TCP_NODELAY option on the socket.
530 * @param on true to enable, false to disable
532 * @exception SocketException If an error occurs or Socket is not connected
536 public void setTcpNoDelay (boolean on
) throws SocketException
539 throw new SocketException("Not connected");
541 impl
.setOption(SocketOptions
.TCP_NODELAY
, new Boolean(on
));
545 * Tests whether or not the TCP_NODELAY option is set on the socket.
546 * Returns true if enabled, false if disabled. When on it disables the
547 * Nagle algorithm which means that packets are always send immediatly and
548 * never merged together to reduce network trafic.
550 * @return Whether or not TCP_NODELAY is set
552 * @exception SocketException If an error occurs or Socket not connected
556 public boolean getTcpNoDelay() throws SocketException
559 throw new SocketException("Not connected");
561 Object on
= impl
.getOption(SocketOptions
.TCP_NODELAY
);
563 if (on
instanceof Boolean
)
564 return(((Boolean
)on
).booleanValue());
566 throw new SocketException("Internal Error");
570 * Sets the value of the SO_LINGER option on the socket. If the
571 * SO_LINGER option is set on a socket and there is still data waiting to
572 * be sent when the socket is closed, then the close operation will block
573 * until either that data is delivered or until the timeout period
574 * expires. The linger interval is specified in hundreths of a second
575 * (platform specific?)
577 * @param on true to enable SO_LINGER, false to disable
578 * @param linger The SO_LINGER timeout in hundreths of a second or -1 if
581 * @exception SocketException If an error occurs or Socket not connected
582 * @exception IllegalArgumentException If linger is negative
586 public void setSoLinger(boolean on
, int linger
) throws SocketException
589 throw new SocketException("No socket created");
594 throw new IllegalArgumentException("SO_LINGER must be >= 0");
599 impl
.setOption(SocketOptions
.SO_LINGER
, new Integer(linger
));
603 impl
.setOption(SocketOptions
.SO_LINGER
, new Boolean(false));
608 * Returns the value of the SO_LINGER option on the socket. If the
609 * SO_LINGER option is set on a socket and there is still data waiting to
610 * be sent when the socket is closed, then the close operation will block
611 * until either that data is delivered or until the timeout period
612 * expires. This method either returns the timeouts (in hundredths of
613 * of a second (platform specific?)) if SO_LINGER is set, or -1 if
614 * SO_LINGER is not set.
616 * @return The SO_LINGER timeout in hundreths of a second or -1
617 * if SO_LINGER not set
619 * @exception SocketException If an error occurs or Socket is not connected
623 public int getSoLinger() throws SocketException
626 throw new SocketException("Not connected");
628 Object linger
= impl
.getOption(SocketOptions
.SO_LINGER
);
629 if (linger
instanceof Integer
)
630 return(((Integer
)linger
).intValue());
636 * Sends urgent data through the socket
638 * @param data The data to send.
639 * Only the lowest eight bits of data are sent
641 * @exception IOException If an error occurs
645 public void sendUrgentData (int data
) throws IOException
647 impl
.sendUrgentData (data
);
651 * Enables/disables the SO_OOBINLINE option
653 * @param on True if SO_OOBLINE should be enabled
655 * @exception SocketException If an error occurs
659 public void setOOBInline (boolean on
) throws SocketException
662 throw new SocketException("Not connected");
664 impl
.setOption(SocketOptions
.SO_OOBINLINE
, new Boolean(on
));
668 * Returns the current setting of the SO_OOBINLINE option for this socket
670 * @exception SocketException If an error occurs
674 public boolean getOOBInline () throws SocketException
677 throw new SocketException("Not connected");
679 Object buf
= impl
.getOption(SocketOptions
.SO_OOBINLINE
);
681 if (buf
instanceof Boolean
)
682 return(((Boolean
)buf
).booleanValue());
684 throw new SocketException("Internal Error: Unexpected type");
688 * Sets the value of the SO_TIMEOUT option on the socket. If this value
689 * is set, and an read/write is performed that does not complete within
690 * the timeout period, a short count is returned (or an EWOULDBLOCK signal
691 * would be sent in Unix if no data had been read). A value of 0 for
692 * this option implies that there is no timeout (ie, operations will
693 * block forever). On systems that have separate read and write timeout
694 * values, this method returns the read timeout. This
695 * value is in milliseconds.
697 * @param timeout The length of the timeout in milliseconds, or
698 * 0 to indicate no timeout.
700 * @exception SocketException If an error occurs or Socket not connected
704 public synchronized void setSoTimeout (int timeout
) throws SocketException
707 throw new SocketException("Not connected");
710 throw new IllegalArgumentException("SO_TIMEOUT value must be >= 0");
712 impl
.setOption(SocketOptions
.SO_TIMEOUT
, new Integer(timeout
));
716 * Returns the value of the SO_TIMEOUT option on the socket. If this value
717 * is set, and an read/write is performed that does not complete within
718 * the timeout period, a short count is returned (or an EWOULDBLOCK signal
719 * would be sent in Unix if no data had been read). A value of 0 for
720 * this option implies that there is no timeout (ie, operations will
721 * block forever). On systems that have separate read and write timeout
722 * values, this method returns the read timeout. This
723 * value is in thousandths of a second (implementation specific?).
725 * @return The length of the timeout in thousandth's of a second or 0
728 * @exception SocketException If an error occurs or Socket not connected
732 public synchronized int getSoTimeout () throws SocketException
735 throw new SocketException("Not connected");
737 Object timeout
= impl
.getOption(SocketOptions
.SO_TIMEOUT
);
738 if (timeout
instanceof Integer
)
739 return(((Integer
)timeout
).intValue());
745 * This method sets the value for the system level socket option
746 * SO_SNDBUF to the specified value. Note that valid values for this
747 * option are specific to a given operating system.
749 * @param size The new send buffer size.
751 * @exception SocketException If an error occurs or Socket not connected
752 * @exception IllegalArgumentException If size is 0 or negative
756 public void setSendBufferSize (int size
) throws SocketException
759 throw new SocketException("Not connected");
762 throw new IllegalArgumentException("SO_SNDBUF value must be > 0");
764 impl
.setOption(SocketOptions
.SO_SNDBUF
, new Integer(size
));
768 * This method returns the value of the system level socket option
769 * SO_SNDBUF, which is used by the operating system to tune buffer
770 * sizes for data transfers.
772 * @return The send buffer size.
774 * @exception SocketException If an error occurs or socket not connected
778 public int getSendBufferSize () throws SocketException
781 throw new SocketException("Not connected");
783 Object buf
= impl
.getOption(SocketOptions
.SO_SNDBUF
);
785 if (buf
instanceof Integer
)
786 return(((Integer
)buf
).intValue());
788 throw new SocketException("Internal Error: Unexpected type");
792 * This method sets the value for the system level socket option
793 * SO_RCVBUF to the specified value. Note that valid values for this
794 * option are specific to a given operating system.
796 * @param size The new receive buffer size.
798 * @exception SocketException If an error occurs or Socket is not connected
799 * @exception IllegalArgumentException If size is 0 or negative
803 public void setReceiveBufferSize (int size
) throws SocketException
806 throw new SocketException("Not connected");
809 throw new IllegalArgumentException("SO_RCVBUF value must be > 0");
811 impl
.setOption(SocketOptions
.SO_RCVBUF
, new Integer(size
));
815 * This method returns the value of the system level socket option
816 * SO_RCVBUF, which is used by the operating system to tune buffer
817 * sizes for data transfers.
819 * @return The receive buffer size.
821 * @exception SocketException If an error occurs or Socket is not connected
825 public int getReceiveBufferSize () throws SocketException
828 throw new SocketException("Not connected");
830 Object buf
= impl
.getOption(SocketOptions
.SO_RCVBUF
);
832 if (buf
instanceof Integer
)
833 return(((Integer
)buf
).intValue());
835 throw new SocketException("Internal Error: Unexpected type");
839 * This method sets the value for the socket level socket option
842 * @param on True if SO_KEEPALIVE should be enabled
844 * @exception SocketException If an error occurs or Socket is not connected
848 public void setKeepAlive (boolean on
) throws SocketException
851 throw new SocketException("Not connected");
853 impl
.setOption(SocketOptions
.SO_KEEPALIVE
, new Boolean(on
));
857 * This method returns the value of the socket level socket option
860 * @return The setting
862 * @exception SocketException If an error occurs or Socket is not connected
866 public boolean getKeepAlive () throws SocketException
869 throw new SocketException("Not connected");
871 Object buf
= impl
.getOption(SocketOptions
.SO_KEEPALIVE
);
873 if (buf
instanceof Boolean
)
874 return(((Boolean
)buf
).booleanValue());
876 throw new SocketException("Internal Error: Unexpected type");
882 * @exception IOException If an error occurs
884 public synchronized void close () throws IOException
896 * Converts this <code>Socket</code> to a <code>String</code>.
898 * @return The <code>String</code> representation of this <code>Socket</code>
900 public String
toString ()
902 return("Socket " + impl
);
908 * Sets the <code>SocketImplFactory</code>. This may be done only once per
909 * virtual machine. Subsequent attempts will generate a
910 * <code>SocketException</code>. Note that a <code>SecurityManager</code>
911 * check is made prior to setting the factory. If
912 * insufficient privileges exist to set the factory, then an
913 * <code>IOException</code> will be thrown.
915 * @exception SecurityException If the <code>SecurityManager</code> does
916 * not allow this operation.
917 * @exception SocketException If the SocketImplFactory is already defined
918 * @exception IOException If any other error occurs
920 public static synchronized void setSocketImplFactory (SocketImplFactory fac
)
923 // See if already set
925 throw new SocketException("SocketImplFactory already defined");
928 SecurityManager sm
= System
.getSecurityManager();
930 sm
.checkSetFactory();
933 throw new SocketException("SocketImplFactory cannot be null");
939 * Closes the input side of the socket stream.
941 * @exception IOException If an error occurs.
945 public void shutdownInput() throws IOException
948 impl
.shutdownInput();
950 inputShutdown
= true;
954 * Closes the output side of the socket stream.
956 * @exception IOException If an error occurs.
960 public void shutdownOutput() throws IOException
963 impl
.shutdownOutput();
965 outputShutdown
= true;
969 * Returns the socket channel associated with this socket.
971 * It returns null if no associated socket exists.
975 public SocketChannel
getChannel()
981 * Checks if the SO_REUSEADDR option is enabled
983 * @exception SocketException If an error occurs
987 public boolean getReuseAddress () throws SocketException
990 throw new SocketException ("Cannot initialize Socket implementation");
992 Object reuseaddr
= impl
.getOption (SocketOptions
.SO_REUSEADDR
);
994 if (!(reuseaddr
instanceof Boolean
))
995 throw new SocketException ("Internal Error");
997 return ((Boolean
) reuseaddr
).booleanValue ();
1001 * Enables/Disables the SO_REUSEADDR option
1003 * @exception SocketException If an error occurs
1007 public void setReuseAddress (boolean on
) throws SocketException
1010 throw new SocketException ("Cannot initialize Socket implementation");
1012 impl
.setOption (SocketOptions
.SO_REUSEADDR
, new Boolean (on
));
1016 * Returns the current traffic class
1018 * @exception SocketException If an error occurs
1020 * @see Socket:setTrafficClass
1024 public int getTrafficClass () throws SocketException
1027 throw new SocketException ("Cannot initialize Socket implementation");
1029 Object obj
= impl
.getOption(SocketOptions
.IP_TOS
);
1031 if (obj
instanceof Integer
)
1032 return ((Integer
) obj
).intValue ();
1034 throw new SocketException ("Unexpected type");
1038 * Sets the traffic class value
1040 * @param tc The traffic class
1042 * @exception SocketException If an error occurs
1043 * @exception IllegalArgumentException If tc value is illegal
1045 * @see Socket:getTrafficClass
1049 public void setTrafficClass (int tc
) throws SocketException
1052 throw new SocketException ("Cannot initialize Socket implementation");
1054 if (tc
< 0 || tc
> 255)
1055 throw new IllegalArgumentException();
1057 impl
.setOption (SocketOptions
.IP_TOS
, new Integer (tc
));
1061 * Checks if the socket is connected
1065 public boolean isConnected ()
1067 return impl
.getInetAddress () != null;
1071 * Checks if the socket is already bound.
1075 public boolean isBound ()
1077 return getLocalAddress () != null;
1081 * Checks if the socket is closed.
1085 public boolean isClosed ()
1091 * Checks if the socket's input stream is shutdown
1095 public boolean isInputShutdown ()
1097 return inputShutdown
;
1101 * Checks if the socket's output stream is shutdown
1105 public boolean isOutputShutdown ()
1107 return outputShutdown
;