SocketPermission (Платформа Java SE 7)

java.lang. Объект
- java.security. Разрешение
- - java.net. SocketPermission

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

Сериализуемый, Защита
```
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".
Формат 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.

Методы java.security унаследованный от класса. Разрешение
checkGuard, getName, toString

Методы 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 в классе Permission
    
    Параметры:
    p - разрешение, чтобы проверить по.
    
    Возвраты:
    истина, если указанное разрешение подразумевается этим объектом, ложь если нет.
  - равняется
```
public boolean equals(Object obj)
```
    Проверки два SocketPermission возражают для равенства.
    
    Определенный:
    
    equals в классе Permission
    
    Параметры:
    obj - объект протестировать на равенство с этим объектом.
    
    Возвраты:
    истина, если obj является SocketPermission, и имеет то же самое имя хоста, диапазон порта, и действия как этот объект SocketPermission. Однако, диапазон порта будет проигнорирован в сравнении, если obj только будет содержать действие, 'решение'.
    См. Также:
    Object.hashCode(), HashMap
  - хэш-код
```
public int hashCode()
```
    Возвращает значение хэш-кода для этого объекта.
    
    Определенный:
    
    hashCode в классе Permission
    
    Возвраты:
    значение хэш-кода для этого объекта.
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - getActions
```
public String getActions()
```
    Возвращает каноническое строковое представление действий. Всегда возвраты представляют действия в следующем порядке: соединитесь, слушайте, примите, решение.
    
    Определенный:
    
    getActions в классе Permission
    
    Возвраты:
    каноническое строковое представление действий.
  - newPermissionCollection
```
public PermissionCollection newPermissionCollection()
```
    Возвращает новый объект PermissionCollection для того, чтобы хранить объекты SocketPermission.
    Объекты SocketPermission должны храниться способом, который позволяет им быть вставленными в набор в любом порядке, но это также включает PermissionCollection implies метод, который будет реализован в эффективном (и непротиворечивый) способ.
    
    Переопределения:
    
    newPermissionCollection в классе Permission
    
    Возвраты:
    новый объект PermissionCollection, подходящий для того, чтобы сохранить SocketPermissions.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс SocketPermission

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

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

Методы java.security унаследованный от класса. Разрешение

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

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

SocketPermission

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

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

равняется

хэш-код

getActions

newPermissionCollection