Класс URLPermission

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

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

URL

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

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

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 может стоять "*.", что означает, что имя будет соответствовать любому имени узла, крайние правые метки домена которого совпадают с этим именем. Например, "*.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 вида "scheme:*", обозначающие любой URL с заданной схемой.

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

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

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

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

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

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

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

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

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