Класс URLPermission

public final class URLPermission extends Permission

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

URL

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

     scheme : // authority [ / path ] [ ignored-query-or-fragment ]
 

схема обычно будет http или https, но не ограничена этим классом. авторитет указывается как:

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

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

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

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

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

Примеры URL

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

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

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

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

игнорируемый-запрос-или-фрагмент относится к любому запросу или фрагменту, который появляется после компонента пути и игнорируется конструкторами этого класса. Он определяется как:

     ignored-query-or-fragment = [ ? query ] [ # fragment ]
 

где запрос и фрагмент определены в RFC2396. getName() поэтому возвращает только компоненты схема, авторитет и путь строки URL, с которой было создано разрешение.

Строка 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, кодом приложения, независимо от того, разрешает ли действующая политика безопасности это сделать.