InetSocketAddress.java: Added some documentation and argument checks for the port numbers.

2002-08-28  Michael Koch <konqueror@gmx.de>

	* java/net/InetSocketAddress.java: Added some documentation and argument
	checks for the port numbers.
	* java/net/DatagramSocketImplFactory.java: New file.

From-SVN: r56638

1 files changed, 33 insertions, 0 deletions

diff --git a/libjava/java/net/InetSocketAddress.java b/libjava/java/net/InetSocketAddress.java
index 6db6baf..4a4f736 100644
--- a/libjava/java/net/InetSocketAddress.java
+++ b/libjava/java/net/InetSocketAddress.java
@@ -50,14 +50,37 @@ public class InetSocketAddress extends SocketAddress
     InetAddress addr;
     int port;
     
+    /**
+     * Constructs an InetSocketAddress instance.
+     * 
+     * @param addr Address of the socket
+     * @param port Port if the socket
+     *
+     * @exception IllegalArgumentException If the port number is illegel
+     */
     public InetSocketAddress(InetAddress addr, int port)
+	throws IllegalArgumentException
     {
+	if (port < 0 || port > 65535)
+          throw new IllegalArgumentException();
+  
 	this.addr = addr;
 	this.port = port;
     }
 
+    /**
+     * Constructs an InetSocketAddress instance.
+     * 
+     * @param port Port if the socket
+     *
+     * @exception IllegalArgumentException If the port number is illegel
+     */
     public InetSocketAddress(int port)
+	throws IllegalArgumentException
     {
+	if (port < 0 || port > 65535)
+          throw new IllegalArgumentException();
+
 	this.port = port;
 	try {
 	    this.addr = InetAddress.getLocalHost();
@@ -66,8 +89,18 @@ public class InetSocketAddress extends SocketAddress
     }
 
 
+    /**
+     * Constructs an InetSocketAddress instance.
+     * 
+     * @param addr Address of the socket
+     * @param port Port if the socket
+     */
     public InetSocketAddress(String hostname, int port)
+	throws IllegalArgumentException
     {
+	if (port < 0 || port > 65535)
+          throw new IllegalArgumentException();
+
 	this.port = port;
 	try {
 	    this.addr = InetAddress.getByName(hostname);