Android
java.net
public final class

java.net.SocketPermission

java.lang.Object
java.security.Permission Serializable Guard
java.net.SocketPermission Serializable

SocketPermissions represent permission to access resources via sockets. The name of the permission should be either the (possibly wildcarded (eg. *.company.com)) DNS style name of the of the host for which access is being requested, or its IP address in standard nn.nn.nn.nn ("dot") notation. The action list can be made up of any of the following:

connect
requests permission to connect to the host
listen
requests permission to listen for connections from the host
accept
requests permission to accept connections from the host
resolve
requests permission to resolve the host name
Note that "resolve" is implied when any (or none) of the others are present.

Access to a particular port can be requested by appending a colon and a single digit to the name (eg. "*.company.com:7000"). A range of port numbers can also be specified, by appending a pattern of the form - where and are valid port numbers. If either or is omitted it is equivalent to entering the lowest or highest possible value respectively. For example:

 SocketPermission("www.company.com:7000-", "connect", "accept")
 
represents permission to connect to and accept connections from www.company.com on ports in the range 7000 to 65535.

Summary

Public Constructors

            SocketPermission(String host, String action)
Constructs an instance of this class.

Public Methods

          boolean  equals(Object o)
Compares the argument to the receiver, and returns true if they represent the equal objects using a class specific comparison.
          String  getActions()
Returns the canonical action list of this SocketPermission in the order: connect, listen, accept, resolve.
          int  hashCode()
Returns an integer hash code for the receiver.
          boolean  implies(Permission p)
Check the permission to see if the actions requested by the argument permission are permissable.
          PermissionCollection  newPermissionCollection()
Returns a PermissionCollection for storing SocketPermission objects.
Methods inherited from class java.security.Permission
Methods inherited from class java.lang.Object
Methods inherited from interface java.security.Guard

Details

Public Constructors

public SocketPermission(String host, String action)

Constructs an instance of this class. The host name can be a DNS name, an individual hostname, an ip address or the empty string which implies localhost. The port or port range is optional.

The action list is a comma-seperated list which can consist of "connect", "listen", "accept", and "resolve". They are case-insensitive and can be put together in any order. "resolve" is always implied.

Parameters

host java.lang.String the host name
action java.lang.String the action string

Public Methods

public boolean equals(Object o)

Compares the argument to the receiver, and returns true if they represent the equal objects using a class specific comparison.

Parameters

o the object to compare with this object

Returns

  • true if the object is the same as this object false if it is different from this object

See Also

public String getActions()

Returns the canonical action list of this SocketPermission in the order: connect, listen, accept, resolve.

Returns

  • java.lang.String the canonical action list

public int hashCode()

Returns an integer hash code for the receiver. Any two objects which answer true when passed to .equals must answer the same value for this method.

Returns

  • int the receiver's hash.

See Also

public boolean implies(Permission p)

Check the permission to see if the actions requested by the argument permission are permissable. All argument permission actions, host and port must be implied by this permission in order to return true. This permission may imply additional actions etc. not present in the argument permission.

Parameters

p java.security.Permission the other socket permission

Returns

  • boolean true if this permission implies p, and false otherwise

public PermissionCollection newPermissionCollection()

Returns a PermissionCollection for storing SocketPermission objects.

Returns

  • java.security.PermissionCollection a permission collection
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:56