Класс SocketPermission

java.lang.Object
- java.security.Permission
- - java.net.SocketPermission

Все реализованные интерфейсы:: Serializable, Guard

public final class SocketPermission
extends Permission
implements Serializable

Этот класс представляет доступ к сети через сокеты. SocketPermission состоит из спецификации хоста и набора «действий», определяющих способы подключения к этому хосту. Хост специфицируется как

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

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

Формат IPv6-ссылок должен соответствовать спецификации, указанной в 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-адреса.

Порт или диапазон портов являются необязательными. Указание порта в формате "N-", где N — номер порта, означает все порты с номером N и выше, а указание в формате "-N" — все порты с номером N и ниже. Специальное значение порта 0 относится ко всему диапазону эпизодических портов. Это фиксированный диапазон портов, которые система может использовать для выделения динамических портов. Фактический диапазон может зависеть от системы.

Возможные способы подключения к хосту:

accept
 connect
 listen
 resolve

Действие "listen" имеет смысл только при использовании с "localhost" и означает возможность привязки к указанному порту. Действие "resolve" подразумевается, когда присутствуют любые другие действия. Действие "resolve" относится к поиску хостов/IP-имен в службе имен.

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

В качестве примера создания и значения SocketPermission обратите внимание, что если разрешено следующее разрешение:

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 на локальном хосте.

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

С тех пор:: 1.2
См. также:: Permissions, SocketPermission

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

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

Методы

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

Методы, объявленные в классе java.security.Permission

checkGuard, getName, toString

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

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

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

SocketPermission

public SocketPermission(String host,
                        String action)

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

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

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

Примеры создания 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 — имя хоста или IP-адрес компьютера, необязательно включающий двоеточие, за которым следует порт или диапазон портов.; action — строка действий.

Методы

implies

public boolean implies(Permission p)

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

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

p является экземпляром SocketPermission,
действия p являются надмножеством действий этого объекта, и
диапазон портов p включен в этот диапазон портов. Примечание: диапазон портов игнорируется, если p содержит только действие "resolve".

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

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

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

Определено в:: implies в классе Permission
Параметры:: p — разрешение для проверки.
Возвращает:: true, если указанное разрешение подразумевается этим объектом, false — в противном случае.

equals

public boolean equals(Object obj)

Проверяет равенство двух объектов SocketPermission.

Определено в:: equals в классе Permission
Параметры:: obj — объект для проверки на равенство с этим объектом.
Возвращает:: true, если obj — SocketPermission, и у него такое же имя хоста, диапазон портов и действия, как у этого объекта SocketPermission. Однако диапазон портов будет проигнорирован при сравнении, если obj содержит только действие "resolve".
См. также:: Object.hashCode(), HashMap

hashCode

public int hashCode()

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

Определено в:: hashCode в классе Permission
Возвращает:: значение хэш-кода для этого объекта.
См. также:: Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

getActions

public String getActions()

Возвращает каноническое строковое представление действий. Всегда возвращает присутствующие действия в следующем порядке: connect, listen, accept, resolve.

Определено в:: getActions в классе Permission
Возвращает:: каноническое строковое представление действий.

newPermissionCollection

public PermissionCollection newPermissionCollection()

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

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

Переопределяет:: newPermissionCollection в классе Permission
Возвращает:: новый объект PermissionCollection, подходящий для хранения SocketPermission.