InetAddress.java: Merged class documentation with classpath.

2003-05-02  Michael Koch  <konqueror@gmx.de>

	* java/net/InetAddress.java:
	Merged class documentation with classpath.
	* java/net/JarURLConnection.java:
	Explicitely import all used classes.
	* java/net/URL.java:
	Reformatting.
	* java/net/ServerSocket.java,
	java/net/Socket.java:
	New versions from classpath.

From-SVN: r66376

libjava/ChangeLog

@@ -1,3 +1,15 @@
+2003-05-02  Michael Koch  <konqueror@gmx.de>
+
+	* java/net/InetAddress.java:
+	Merged class documentation with classpath.
+	* java/net/JarURLConnection.java:
+	Explicitely import all used classes.
+	* java/net/URL.java:
+	Reformatting.
+	* java/net/ServerSocket.java,
+	java/net/Socket.java:
+	New versions from classpath.
+
 2003-05-02  Michael Koch  <konqueror@gmx.de>
 
 	* gnu/java/nio/FileChannelImpl.java

libjava/java/net/InetAddress.java

@@ -44,20 +44,28 @@ import java.io.IOException;
 import java.io.Serializable;
 import java.io.ObjectStreamException;
 
-/**
- * @author Per Bothner
- * @date January 6, 1999.
- */
-
 /*
  * Written using on-line Java Platform 1.2 API Specification, as well
  * as "The Java Class Libraries", 2nd edition (Addison-Wesley, 1998).
  * (The latter turns out to have some errors ...)
  * Status:  Believed complete and correct.
+ */
+
+/**
+ * This class models an Internet address.  It does not have a public
+ * constructor.  Instead, new instances of this objects are created
+ * using the static methods getLocalHost(), getByName(), and
+ * getAllByName().
+ * <p>
+ * This class fulfills the function of the C style functions gethostname(),
+ * gethostbyname(), and gethostbyaddr().  It resolves Internet DNS names
+ * into their corresponding numeric addresses and vice versa.
+ *
+ * @author Aaron M. Renn <arenn@urbanophile.com>
+ * @author Per Bothner
  *
  * @specnote This class is not final since JK 1.4
  */
-
 public class InetAddress implements Serializable
 {
   // The Serialized Form specifies that an int 'address' is saved/restored.

libjava/java/net/JarURLConnection.java

@@ -38,10 +38,16 @@ exception statement from your version. */
 
 package java.net;
 
-import java.net.*;
+import java.io.BufferedInputStream;
-import java.io.*;
+import java.io.ByteArrayInputStream;
-import java.util.jar.*;
+import java.io.InputStream;
-import java.util.zip.*;
+import java.io.IOException;
+import java.util.jar.Attributes;
+import java.util.jar.JarEntry;
+import java.util.jar.JarFile;
+import java.util.jar.JarInputStream;
+import java.util.jar.Manifest;
+import java.util.zip.ZipEntry;
 import java.util.Map;
 import java.util.Vector;
 import java.util.Hashtable;
@@ -52,8 +58,6 @@ import java.security.cert.Certificate;
  * @since 1.2
  * @date Aug 10, 1999.
  */
-
-
 public abstract class JarURLConnection extends URLConnection
 {
   // three different ways to say the same thing

libjava/java/net/ServerSocket.java

@@ -164,10 +164,51 @@ public class ServerSocket
     if (bindAddr == null)
       bindAddr = InetAddress.ANY_IF;
 
+    // create socket
     impl.create(true);
+
+    // bind to address/port
+    try
+      {
         impl.bind(bindAddr, port);
+      }
+    catch (IOException exception)
+      {
+        impl.close();
+        throw exception;
+      }
+    catch (RuntimeException exception)
+      {
+        impl.close();
+        throw exception;
+      }
+    catch (Error error)
+      {
+        impl.close();
+        throw error;
+      }
+
+    // listen on socket
+    try
+      {
         impl.listen(backlog);
       }
+    catch (IOException exception)
+      {
+        impl.close();
+        throw exception;
+      }
+    catch (RuntimeException exception)
+      {
+        impl.close();
+        throw exception;
+      }
+    catch (Error error)
+      {
+        impl.close();
+        throw error;
+      }
+  }
 
   /**
    * Binds the server socket to a specified socket address

libjava/java/net/Socket.java

@@ -291,17 +291,60 @@ public class Socket
     if (sm != null)
       sm.checkConnect(raddr.getHostName(), rport);
 
+    // create socket
     impl.create(stream);
 
     // FIXME: JCL p. 1586 says if localPort is unspecified, bind to any port,
     // i.e. '0' and if localAddr is unspecified, use getLocalAddress() as
     // that default.  JDK 1.2 doc infers not to do a bind.
+    
+    // bind/connect to address/port
     if (laddr != null)
+      {
+        try
+	  {
             impl.bind(laddr, lport);
+          }
+	catch (IOException exception)
+          {
+            impl.close();
+            throw exception;
+          }
+        catch (RuntimeException exception)
+          {
+            impl.close();
+            throw exception;
+          }
+        catch (Error error)
+          {
+            impl.close();
+            throw error;
+          }
+      }
 
     if (raddr != null)
+      {
+        try
+          {
             impl.connect(raddr, rport);
           }
+        catch (IOException exception)
+          {
+            impl.close();
+            throw exception;
+          }
+        catch (RuntimeException exception)
+          {
+            impl.close();
+            throw exception;
+          }
+        catch (Error error)
+          {
+            impl.close();
+            throw error;
+          }
+      }
+  }
 
   /**
    * Binds the socket to the givent local address/port

libjava/java/net/URL.java

@@ -99,7 +99,7 @@ import java.util.StringTokenizer;
   * Please note that a protocol handler must be a subclass of
   * URLStreamHandler.
   *
-  * @author Aaron M. Renn (arenn@urbanophile.com)
+  * @author Aaron M. Renn <arenn@urbanophile.com>
   * @author Warren Levy <warrenl@cygnus.com>
   *
   * @see URLStreamHandler