Класс URLPermission

public final class URLPermission extends Permission

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

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, с которой было создано разрешение.

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