compact1, compact2, compact3

java.net

Класс SocketPermission

java.lang. Объект

java.security. Разрешение

java.net. SocketPermission

Все Реализованные Интерфейсы:

Сериализуемый, Защита

public final class SocketPermission
extends Permission
implements Serializable

Этот class представляет доступ к сети через сокеты. SocketPermission состоит из спецификации узла и ряда "действий", определяющих способы соединиться с тем узлом. Узел определяется как

    host = (hostname | IPv4address | iPv6reference) [:portrange]
    portrange = portnumber | -portnumber | portnumber-[portnumber]
 

Узел выражается как имя DNS как числовой IP-адрес, или как "localhost" (для локальной машины). Подстановочный знак "*" может быть включен однажды в спецификации узла имени DNS. Если это включается, это должно быть в крайней левой позиции, как в "*.sun.com".

Формат IPv6reference должен следовать, который определил в RFC 2732: Формат для Литеральных Адресов IPv6 в URL:

    ipv6reference = "[" IPv6address "]"

Например, можно создать экземпляр SocketPermission как следующее:

    String hostAddress = inetaddress.getHostAddress();
    if (inetaddress instanceof Inet6Address) {
        sp = new SocketPermission("[" + hostAddress + "]:" + port, action);
    } else {
        sp = new SocketPermission(hostAddress + ":" + port, action);
    }
 

или

    String host = url.getHost();
    sp = new SocketPermission(host + ":" + port, action);
 

Полная несжатая форма адреса литерала IPv6 также допустима.

Порт или portrange являются дополнительными. Спецификация порта формы "N-", где N является номером порта, показывает все порты пронумерованный N и выше, в то время как спецификация формы"-N" указывает на все порты пронумерованный N и ниже.

Возможные способы соединиться с узлом

 accept
 connect
 listen
 resolve
 

"Слушать" действие только значимо когда использующийся с "localhost". Действие "решения" подразумевается, когда любое из других действий присутствует. Действие "решение" обращается к host/ip поискам службы имен.

Строка действий преобразовывается в нижний регистр перед обработкой.

Как пример создания и значения SocketPermissions, отметьте что если следующее разрешение:

   p1 = new SocketPermission("puffin.eng.sun.com:7777", "connect,accept");
 

предоставляется некоторому коду, он позволяет тому коду соединяться с портом 7777 на puffin.eng.sun.com, и принять соединения на том порту.

Точно так же, если следующее разрешение:

   p2 = new SocketPermission("localhost:1024-", "accept,connect,listen");
 

предоставляется некоторому коду, он позволяет тому коду принимать соединения на, соединяться с, или слушать на любом порту между 1024 и 65535 на локальном узле.

Отметьте: Предоставление, что разрешение кода принимает или делает соединения, чтобы отдалить узлы, может быть опасным, потому что злорадный код может тогда более легко передать и совместно использовать конфиденциальные данные среди сторон, у кого, возможно, иначе нет доступа к данным.

См. Также:

Permissions, SocketPermission

Сводка конструктора

Конструкторы

Конструктор и Описание
SocketPermission(String host, String action) Создает новый объект SocketPermission с указанными действиями.

Сводка метода

Модификатор и Тип	Метод и Описание
boolean	equals(Object obj) Проверки два SocketPermission возражают для равенства.
Строка	getActions() Возвращает каноническое строковое представление действий.
int	hashCode() Возвращает значение хэш-кода для этого объекта.
boolean	implies(Permission p) Проверки, если этот объект полномочий сокета "подразумевает" указанное разрешение.
PermissionCollection	newPermissionCollection() Возвращает новый объект PermissionCollection для того, чтобы хранить объекты SocketPermission.

Методы, наследованные от class java.security. Разрешение

checkGuard, getName, toString

Методы, наследованные от class java.lang. Объект

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Деталь конструктора

SocketPermission

public SocketPermission(String host,
                        String action)

Создает новый объект SocketPermission с указанными действиями. Узел выражается как имя DNS, или как числовой IP-адрес. Дополнительно, порт или portrange могут быть предоставлены (разделенный от имени DNS или IP-адреса двоеточием).

Чтобы определить локальную машину, используйте "localhost" в качестве узла. Также отметьте: пустая Строка узла ("") эквивалентна "localhost".

Параметр действий содержит список разделенных запятой значений действий, предоставленных для указанного узла (и порт (ы)). Возможные действия, "соединяются", "слушают", "принимают", "решают", или любая комбинация тех. "решение" автоматически добавляется, когда любой из других трех определяется.

Примерами инстанцирования SocketPermission является следующее:

    nr = new SocketPermission("www.catalog.com", "connect");
    nr = new SocketPermission("www.sun.com:80", "connect");
    nr = new SocketPermission("*.sun.com", "connect");
    nr = new SocketPermission("*.edu", "resolve");
    nr = new SocketPermission("204.160.241.0", "connect");
    nr = new SocketPermission("localhost:1024-65535", "listen");
    nr = new SocketPermission("204.160.241.0:1024-65535", "connect");
 

Параметры:

host - имя узла или IPaddress компьютера, дополнительно включая двоеточие, сопровождаемое портом или диапазоном порта.

action - строка действия.

Деталь метода

подразумевает

public boolean implies(Permission p)

Проверки, если этот объект полномочий сокета "подразумевает" указанное разрешение.

Более определенно этот метод сначала гарантирует, что все следующее является истиной (и возвращает false, если какой-либо из них не):

• p является instanceof SocketPermission,

• действия p являются собственным подмножеством действий этого объекта, и

• диапазон порта p включается в этот диапазон порта. Отметьте: диапазон порта игнорируется, когда p только содержит действие, 'решение'.

Затем implies проверки каждый из следующих, в порядке, и для каждого возвращает true, если установленное условие является истиной:

• Если этот объект был инициализирован с единственным IP-адресом, и один из IP-адресов p равен IP-адресу этого объекта.

• Если этот объект является подстановочным доменом (такой как *.sun.com), и каноническое имя p (имя ни с кем предыдущим *) концы с каноническим именем хоста этого объекта. Например, *.sun.com подразумевает *.eng.sun.com..

• Если этот объект не был инициализирован с единственным IP-адресом, и один из IP-адресов этого объекта равняется одному из IP-адресов p.

• Если это каноническое имя равняется каноническому имени p.

Если ни одно из вышеупомянутого не истина, implies возвращает false.

Определенный:

implies в class Permission

Параметры:

p - разрешение, чтобы проверить по.

Возвраты:

истина, если указанное разрешение подразумевается этим объектом, ложь если нет.

равняется

public boolean equals(Object obj)

Проверки два SocketPermission возражают для равенства.

Определенный:

equals в class Permission

Параметры:

obj - объект протестировать на равенство с этим объектом.

Возвраты:

истина, если obj является SocketPermission, и имеет то же самое имя узла, диапазон порта, и действия как этот объект SocketPermission. Однако, диапазон порта будет проигнорирован в сравнении, если obj только будет содержать действие, 'решение'.

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Возвращает значение хэш-кода для этого объекта.

Определенный:

hashCode в class Permission

Возвраты:

значение хэш-кода для этого объекта.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

getActions

public String getActions()

Возвращает каноническое строковое представление действий. Всегда возвраты представляют действия в следующем порядке: соединитесь, слушайте, примите, решение.

Определенный:

getActions в class Permission

Возвраты:

каноническое строковое представление действий.

newPermissionCollection

public PermissionCollection newPermissionCollection()

Возвращает новый объект PermissionCollection для того, чтобы хранить объекты SocketPermission.

Объекты SocketPermission должны храниться способом, который позволяет им быть вставленными в набор в любом порядке, но это также включает PermissionCollection implies метод, который будет реализован в эффективном (и непротиворечивый) способ.

Переопределения:

newPermissionCollection в class Permission

Возвраты:

новый объект PermissionCollection, подходящий для того, чтобы сохранить SocketPermissions.