Класс URLPermission

public final class URLPermission
extends Permission

Представляет разрешение на доступ к ресурсу или набору ресурсов, определённых заданным URL, и для заданного набора пользовательских методов запроса и заголовков запроса. Имя разрешения — строка URL. Строка actions — конкатенация методов запроса и заголовков запроса. Диапазон имён методов и заголовков не ограничен этим классом.

URL

Строка URL имеет следующую ожидаемую структуру.

scheme : // authority [ / path ]

scheme обычно будет http или https, но не ограничен этим классом. authority задаётся следующим образом:

authority = [ userinfo @ ] hostrange [ : portrange ]
     portrange = portnumber | -portnumber | portnumber-[portnumber] | *
     hostrange = ([*.] dnsname) | IPv4address | IPv6address

dnsname — стандартное имя хоста или домена DNS, т.е. одна или несколько меткок, разделённых точкой. IPv4address — стандартный литеральный IPv4 адрес, а IPv6address определён в RFC 2732. Однако, литеральные IPv6 адреса должны быть заключены в символы '[]'. Спецификация dnsname может быть предшествована "*.", что означает, что имя будет соответствовать любому имени хоста, правые метки домена которого совпадают с этим именем. Например, "*.oracle.com" соответствует "foo.bar.oracle.com"

portrange используется для указания номера порта или ограниченного или неограниченного диапазона портов, к которым относится это разрешение. Если portrange отсутствует или некорректен, предполагается стандартный номер порта, если схема — http (по умолчанию 80) или https (по умолчанию 443). Для других схем не предполагается никакого значения по умолчанию. Может быть указан символ подстановки, означающий все порты.

userinfo необязателен. Компонент userinfo, если он присутствует, игнорируется при создании URLPermission и не оказывает никакого влияния на другие методы, определённые этим классом.

Компонент path состоит из последовательности сегментов пути, разделённых символами '/'. path также может быть пустым. Путь задаётся аналогично пути в FilePermission. Существует три различных способа, как показано в следующих примерах:

Пример URL	Описание
http://www.oracle.com/a/b/c.html	URL, который идентифицирует конкретный (единичный) ресурс
http://www.oracle.com/a/b/*	Символ '*' относится ко всем ресурсам в одном "каталоге" — другими словами, ко всем ресурсам с одинаковым количеством компонентов пути и которые различаются только конечным компонентом пути, представленным символом '*'.
http://www.oracle.com/a/b/-	Символ '-' относится ко всем ресурсам, находящимся иерархически ниже предыдущего пути (например, http://www.oracle.com/a/b/c/d/e.html соответствует этому примеру).

Символы '*' и '-' могут быть указаны только в последнем сегменте пути и должны быть единственными символами в этом сегменте. Любые компоненты запроса или фрагмента URL игнорируются при построении URLPermissions.

В качестве специального случая URL вида "scheme:*" принимаются для обозначения любого URL с данной схемой.

Компоненты scheme и authority строки URL обрабатываются без учёта регистра. Это означает equals(Object), hashCode() и implies(Permission) нечувствительны к регистру в отношении этих компонентов. Если authority содержит литеральный IP-адрес, то адрес нормализуется для сравнения. Компонент пути чувствителен к регистру.

Строка actions

Строка actions URLPermission представляет собой конкатенацию списка методов и списка заголовков запроса. Это списки разрешённых методов запроса и разрешённых заголовков запроса для разрешения (соответственно). Два списка разделяются двоеточием ':' и элементы каждого списка разделяются запятыми. Вот несколько примеров:

• "POST,GET,DELETE"
• "GET:X-Foo-Request,X-Bar-Request"
• "POST,GET:Header1,Header2"

Первый пример указывает методы: POST, GET и DELETE, но без заголовков запроса. Второй пример указывает один метод запроса и два заголовка. Третий пример указывает два метода запроса и два заголовка.

Разделитель двоеточие не требуется, если список заголовков запроса пуст. В строке actions не допускаются пробелы. Строки actions, передаваемые конструкторам URLPermission, нечувствительны к регистру и нормализуются путём преобразования имён методов в верхний регистр, а имён заголовков — в форму, определённую в RFC2616 (строчные буквы с заглавной первой буквой каждого слова).

Любой из списков может содержать символ подстановки '*' , который обозначает все методы запроса или заголовки запроса соответственно.

Примечание. В зависимости от контекста использования некоторые методы запроса и заголовки запроса могут быть разрешены всегда, а другие — никогда. Например, обработчик протокола HTTP может запретить некоторые заголовки, такие как Content-Length, чтобы их не устанавливал код приложения, независимо от того, разрешает ли действующая политика безопасности их.