Класс 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 может быть один раз использован символ подстановки "*". Если он используется, он должен стоять в самом левом положении, как в "*.example.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.

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

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

   p1 = new SocketPermission("foo.example.com:7777", "connect,accept");

это разрешает данному коду подключаться к порту 7777 на foo.example.com, и принимать подключения на этом порту.

Аналогично, если разрешено следующее разрешение:

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

это позволяет данному коду принимать подключения на любом порту от 1024 до 65535 на локальном хосте.

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

С:

1.2

См. также:

Краткое описание конструкторов

Конструктор	Описание
`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.example.com", "connect");
    nr = new SocketPermission("www.example.com:80", "connect");
    nr = new SocketPermission("*.example.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 - строка действия.
Исключения:: NullPointerException - если какой-либо параметр равен null; IllegalArgumentException - если формат host неверный, или если строка action пустая, имеет неправильный формат или содержит действие, отличное от указанных возможных действий

Подробное описание методов

implies

public boolean implies(Permission p)

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

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

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

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

Если этот объект был инициализирован с единственным IP-адресом и один из IP-адресов p равен IP-адресу этого объекта.
Если этот объект является подстановкой домена (например, *.example.com), и каноническое имя p (имя без предшествующего *) заканчивается каноническим именем хоста этого объекта. Например, *.example.com подразумевает *.foo.example.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".

См. также:

hashCode

public int hashCode()

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

Унаследовано от:

hashCode в классе Permission

Возвращает:

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

См. также:

getActions

public String getActions()

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

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

newPermissionCollection

public PermissionCollection newPermissionCollection()

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

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

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

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/SocketPermission.html