From f6d49f66ec0e0a59285d304720cc3bfa18f28141 Mon Sep 17 00:00:00 2001 From: Michael Koch Date: Tue, 20 Apr 2004 13:05:10 +0000 Subject: Authenticator.java, [...]: Fixed javadocs, coding style and argument names all over. 2004-04-20 Michael Koch * java/net/Authenticator.java, java/net/BindException.java, java/net/ConnectException.java, java/net/ContentHandler.java, java/net/ContentHandlerFactory.java, java/net/DatagramPacket.java, java/net/DatagramSocket.java, java/net/DatagramSocketImpl.java, java/net/DatagramSocketImplFactory.java, java/net/FileNameMap.java, java/net/HttpURLConnection.java, java/net/Inet4Address.java, java/net/Inet6Address.java, java/net/InetAddress.java, java/net/InetSocketAddress.java, java/net/JarURLConnection.java, java/net/MalformedURLException.java, java/net/MulticastSocket.java, java/net/NetPermission.java, java/net/NetworkInterface.java, java/net/NoRouteToHostException.java, java/net/PasswordAuthentication.java, java/net/PortUnreachableException.java, java/net/ProtocolException.java, java/net/ServerSocket.java, java/net/Socket.java, java/net/SocketAddress.java, java/net/SocketException.java, java/net/SocketImpl.java, java/net/SocketImplFactory.java, java/net/SocketOptions.java, java/net/SocketPermission.java, java/net/SocketTimeoutException.java, java/net/URI.java, java/net/URISyntaxException.java, java/net/URL.java, java/net/URLClassLoader.java, java/net/URLConnection.java, java/net/URLDecoder.java, java/net/URLEncoder.java, java/net/URLStreamHandler.java, java/net/URLStreamHandlerFactory.java, java/net/UnknownHostException.java, java/net/UnknownServiceException.java: Fixed javadocs, coding style and argument names all over. From-SVN: r80900 --- libjava/java/net/SocketPermission.java | 209 ++++++++++++++++++--------------- 1 file changed, 113 insertions(+), 96 deletions(-) (limited to 'libjava/java/net/SocketPermission.java') diff --git a/libjava/java/net/SocketPermission.java b/libjava/java/net/SocketPermission.java index 35006173828..e9d1402a7d4 100644 --- a/libjava/java/net/SocketPermission.java +++ b/libjava/java/net/SocketPermission.java @@ -1,5 +1,5 @@ /* SocketPermission.java -- Class modeling permissions for socket operations - Copyright (C) 1998, 2000, 2001, 2002 Free Software Foundation, Inc. + Copyright (C) 1998, 2000, 2001, 2002, 2004 Free Software Foundation, Inc. This file is part of GNU Classpath. @@ -41,6 +41,7 @@ import java.io.Serializable; import java.security.Permission; import java.security.PermissionCollection; + /** * This class models a specific set of permssions for connecting to a * host. There are two elements to this, the host/port combination and @@ -64,18 +65,20 @@ import java.security.PermissionCollection; * value for a port (respectively) is used by default. Here are some * examples: *

* The permission list is a comma separated list of individual permissions. * These individual permissions are: *

- * accept
- * connect
- * listen
- * resolve
+ * 

+ * accept
+ * connect
+ * listen
+ * resolve
+ *
*

* The "listen" permission is only relevant if the host is localhost. If * any permission at all is specified, then resolve permission is implied to @@ -103,12 +106,12 @@ import java.security.PermissionCollection; * * @author Aaron M. Renn (arenn@urbanophile.com) */ -public final class SocketPermission extends Permission - implements Serializable +public final class SocketPermission extends Permission implements Serializable { static final long serialVersionUID = -7204263841984476862L; // FIXME: Needs serialization work, including readObject/writeObject methods. + /** * A hostname/port combination as described above */ @@ -120,7 +123,7 @@ public final class SocketPermission extends Permission private String actions; /** - * Initializes a new instance of SocketPermission with the + * Initializes a new instance of SocketPermission with the * specified host/port combination and actions string. * * @param hostport The hostname/port number combination @@ -136,18 +139,18 @@ public final class SocketPermission extends Permission /** * Tests this object for equality against another. This will be true if - * and only if the passed object is an instance of - * SocketPermission and both its hostname/port combination + * and only if the passed object is an instance of + * SocketPermission and both its hostname/port combination * and permissions string are identical. * * @param obj The object to test against for equality * - * @return true if object is equal to this object, + * @return true if object is equal to this object, * false otherwise. */ public boolean equals(Object obj) { - if (!(obj instanceof SocketPermission)) + if (! (obj instanceof SocketPermission)) return (false); if (((SocketPermission) obj).hostport.equals(hostport)) @@ -158,7 +161,7 @@ public final class SocketPermission extends Permission } /** - * Returns a hash code value for this object. Overrides the + * Returns a hash code value for this object. Overrides the * Permission.hashCode(). * * @return A hash code @@ -192,21 +195,21 @@ public final class SocketPermission extends Permission if (actions.indexOf("listen") != -1) if (found) - sb.append(",listen"); + sb.append(",listen"); else - { + { sb.append("listen"); found = true; - } + } if (actions.indexOf("accept") != -1) if (found) sb.append(",accept"); else - { + { sb.append("accept"); found = true; - } + } if (found) sb.append(",resolve"); @@ -231,25 +234,27 @@ public final class SocketPermission extends Permission /** * Returns true if the permission object passed it is implied by the - * this permission. This will be true if - *