From ed08cfe4cd05b81e9dbdf33866c8e292a424fb67 Mon Sep 17 00:00:00 2001 From: Michael Koch Date: Wed, 25 Sep 2002 05:05:07 +0000 Subject: 2002-09-25 Michael Koch * java/net/DatagramPacket (DatagramPacket): Exception documentation added. (setData): Likewise. (setSocketAddress): Likewise. * java/net/DatagramSocketImpl.java (peek): Documentation addded. (peekData): Documentation addded. (send): Documentation addded. (receive): Documentation addded. (connect): New method. (disconnect): New method. (joinGroup): New abstract method. (leaveGroup): New abstract method. * java/net/InetSocketAddress.java (InetSocketAddress): Documentation added. (equals): final keyword added. (getAddress): final keyword added. (getHostName): final keyword added. (getPort): final keyword added. (hashCode): final keyword added. (isUnresolved): final keyword added. * java/net/MulticastSocket.java (MulticastSocket): Documentation added. (MulticastSocket): New method. (joinGroup): Documentation added. (joinGroup): New method. (leaveGroup): Documentation added. (leaveGroup): New method. (send): Documentation added. * java/net/NetworkInterface.java (getByName): Documentation added. (getByInetAddress): Documentation added. (getNetworkInterfaces): Documentation added. * java/net/PlainDatagramSocketImpl.java (connect): New method. (disconnect): New method. * java/net/SocketImpl.java (create): Documentation added. (shutdownInput): Convert public to protected, as it always was. (shutdownOutput): Convert public to protected, as it always was. * java/net/SocketOptions.java (whole file): Reintented. * java/net/URLClassLoader.java (URLClassLoader): SecurityManager check added, documentation added. (findResources): Documentation added. (findClass): Documentation added. (newInstance): More correct method arguments. * java/net/URLConnection.java (connect): Documentation added. (getContent): Documentation added. (getPermission): Documentation added. (getInputStream): Documentation added. (getOutputStream): Documentation added. (setDoInput): Throw correct exception, documentation added. (setDoOutput): Throw correct exception, documentation added. (setAllowUserInteraction): Throw correct exception, documentation added. (setUseCaches): Throw correct exception, documentation added. (setIfModifiedSince): Throw correct exception, documentation added. (setRequestProperty): Throw exception, documentation added. (addRequestProperty): Throw exception, documentation added. (getRequestProperty): Throw exception, documentation added. (getRequestProperties): Documentation added. (setContentHandlerFactory): Documentation added. (guessContentTypeFromName): protected to public. (setFileNameMap): Documentation added. * java/net/URLDecoder.java (URLDecoder): New method. (decode): Documentation added. (whole file): Reindented. * java/net/URLEncoder.java (encode): Documentation added. * java/net/natPlainDatagramSocketImpl.cc (connect): New method. (disconnect): New method. * javax/naming/RefAddr: (addrType): addrType was never final. (equals): Fix typo in method name. * javax/naming/BinaryRefAddr: (equals): Fix typo in method name. From-SVN: r57487 --- libjava/java/net/SocketOptions.java | 249 +++++++++++++++++------------------- 1 file changed, 116 insertions(+), 133 deletions(-) (limited to 'libjava/java/net/SocketOptions.java') diff --git a/libjava/java/net/SocketOptions.java b/libjava/java/net/SocketOptions.java index fda637e8d06..628e08e8de2 100644 --- a/libjava/java/net/SocketOptions.java +++ b/libjava/java/net/SocketOptions.java @@ -43,142 +43,125 @@ package java.net; */ /** - * This interface is used by SocketImpl and - * DatagramSocketImpl to implement options - * on sockets. - * - * @since 1.2 - * - * @author Aaron M. Renn (arenn@urbanophile.com) - * @author Warren Levy - * @status should be completely JDK 1.4 compatible - */ + * This interface is used by SocketImpl and + * DatagramSocketImpl to implement options + * on sockets. + * + * @since 1.2 + * + * @author Aaron M. Renn (arenn@urbanophile.com) + * @author Warren Levy + * @status should be completely JDK 1.4 compatible + */ public interface SocketOptions { - -/*************************************************************************/ - -/* - * Static Variables - */ - -/** - * Option id for the SO_KEEPALIVE value - * @since 1.3 - */ -static final int SO_KEEPALIVE = 0x8; + /** + * Option id for the SO_KEEPALIVE value + * @since 1.3 + */ + static final int SO_KEEPALIVE = 0x8; -/** - * Option id for the SO_LINGER value - */ -static final int SO_LINGER = 0x80; // 128 - -/** - * Option id for the SO_TIMEOUT value - */ -static final int SO_TIMEOUT = 0x1006; // 4102 - -/** - * Retrieve the local address to which the socket is bound. - */ -static final int SO_BINDADDR = 0x0F; // 15 - -/** - * Option id for the send buffer size - * @since 1.2 - */ -static final int SO_SNDBUF = 0x1001; // 4097 - -/** - * Option id for the receive buffer size - * @since 1.2 - */ -static final int SO_RCVBUF = 0x1002; // 4098 - -/** - * Sets the SO_REUSEADDR parameter on a socket - */ -static final int SO_REUSEADDR = 0x04; // 4 - -/** - * Sets SO_BROADCAST for a socket - * @since 1.4 - */ -static final int SO_BROADCAST = 0x20; // 32 - -/** - * Sets SO_OOBINLINE for a socket - * @since 1.4 - */ -static final int SO_OOBINLINE = 0x1003; // 4099 - -/** - * Option id for the TCP_NODELAY value - */ -static final int TCP_NODELAY = 0x01; // 1 - -/** - * Options id for the IP_MULTICAST_IF value - */ -static final int IP_MULTICAST_IF = 0x10; // 16 - -/** - * same as above - * @since 1.4 - */ -static final int IP_MULTICAST_IF2 = 0x1F; // 31 - -/** - * This option enables or disables local loopback of multicast datagrams. - * @since 1.4 - */ -static final int IP_MULTICAST_LOOP = 0x12; // 18 - -/** - * This option sets the type-of-service or traffic class field in the - * IP header for a TCP or UDP socket. - * @since 1.4 - */ -static final int IP_TOS = 0x03; // 3 - -/*************************************************************************/ - -/* - * Interface Methods - */ - -/** - * Sets the specified option on a socket to the passed in object. For - * options that take an integer argument, the passed in object is an - * Integer. For options that are set to on or off, the - * value passed will be a Boolean. The option_id - * parameter is one of the defined constants in this interface. - * - * @param option_id The identifier of the option - * @param val The value to set the option to - * - * @exception SocketException If an error occurs - */ -void -setOption(int option_id, Object val) throws SocketException; - -/*************************************************************************/ - -/** - * Returns the current setting of the specified option. The - * Object returned will be an Integer for options - * that have integer values. For options that are set to on or off, a - * Boolean will be returned. The option_id - * is one of the defined constants in this interface. - * - * @param option_id The option identifier - * - * @return The current value of the option - * - * @exception SocketException If an error occurs - */ -Object -getOption(int option_id) throws SocketException; + /** + * Option id for the SO_LINGER value + */ + static final int SO_LINGER = 0x80; // 128 + + /** + * Option id for the SO_TIMEOUT value + */ + static final int SO_TIMEOUT = 0x1006; // 4102 + + /** + * Retrieve the local address to which the socket is bound. + */ + static final int SO_BINDADDR = 0x0F; // 15 + + /** + * Option id for the send buffer size + * @since 1.2 + */ + static final int SO_SNDBUF = 0x1001; // 4097 + + /** + * Option id for the receive buffer size + * @since 1.2 + */ + static final int SO_RCVBUF = 0x1002; // 4098 + + /** + * Sets the SO_REUSEADDR parameter on a socket + */ + static final int SO_REUSEADDR = 0x04; // 4 + + /** + * Sets SO_BROADCAST for a socket + * @since 1.4 + */ + static final int SO_BROADCAST = 0x20; // 32 + + /** + * Sets SO_OOBINLINE for a socket + * @since 1.4 + */ + static final int SO_OOBINLINE = 0x1003; // 4099 + + /** + * Option id for the TCP_NODELAY value + */ + static final int TCP_NODELAY = 0x01; // 1 + + /** + * Options id for the IP_MULTICAST_IF value + */ + static final int IP_MULTICAST_IF = 0x10; // 16 + + /** + * same as above + * @since 1.4 + */ + static final int IP_MULTICAST_IF2 = 0x1F; // 31 + + /** + * This option enables or disables local loopback of multicast datagrams. + * @since 1.4 + */ + static final int IP_MULTICAST_LOOP = 0x12; // 18 + + /** + * This option sets the type-of-service or traffic class field in the + * IP header for a TCP or UDP socket. + * @since 1.4 + */ + static final int IP_TOS = 0x03; // 3 + + /** + * Sets the specified option on a socket to the passed in object. For + * options that take an integer argument, the passed in object is an + * Integer. For options that are set to on or off, the + * value passed will be a Boolean. The option_id + * parameter is one of the defined constants in this interface. + * + * @param option_id The identifier of the option + * @param val The value to set the option to + * + * @exception SocketException If an error occurs + */ + void setOption(int option_id, Object val) throws SocketException; + + /** + * Returns the current setting of the specified option. The + * Object returned will be an Integer for options + * that have integer values. For options that are set to on or off, a + * Boolean will be returned. The option_id + * is one of the defined constants in this interface. + * + * @param option_id The option identifier + * + * @return The current value of the option + * + * @exception SocketException If an error occurs + */ + Object getOption(int option_id) throws SocketException; } // interface SocketOptions -- cgit v1.2.3