Класс 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-адресов.

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

Примечание API:

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

С:

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".

Параметр действия содержит список действий, разрешенных для указанного хоста (и порта(ов)), разделённых запятыми. Возможные действия: "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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/net/SocketPermission.html