Класс URLPermission

@Deprecated(since="25", forRemoval=true) public final class URLPermission extends Permission

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

URL

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

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

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

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

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

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

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

Компонент пути состоит из последовательности сегментов пути, разделённых символами '/'. Путь также может быть пустым. Путь задаётся способом, аналогичным пути в 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 соответствует этому примеру).

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

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

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

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

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

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

Строка действий

Строка действий URLPermission представляет собой объединение списка методов и списка заголовков запроса. Эти списки содержат соответственно разрешённые методы запроса и разрешённые заголовки запроса для данного разрешения. Списки разделены двоеточием ':', а элементы каждого списка — запятыми. Примеры:

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

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

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