Класс 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 отсутствует или недействителен, предполагается значение порта по умолчанию, если схема — 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 заданной схемы.

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

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

     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 пробелы не допускаются. Строки действий, предоставляемые конструкторам URLPermission, нечувствительны к регистру и нормализуются путём преобразования имён методов в верхний регистр и имён заголовков в форму, определённую в RFC2616 (строчные буквы с прописной первой буквой каждого слова). Любой список может содержать символ подстановки '*' , который обозначает все методы запроса или заголовки, соответственно.