Класс URLPermission

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

URL

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

scheme : // authority [ / path ]

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

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

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

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

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

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

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

Строка actions

Строка actions URLPermission представляет собой конкатенацию списка методов и списка заголовков запроса. Это списки разрешенных методов запроса и разрешенных заголовков запроса для разрешения (соответственно). Два списка разделены двоеточием ':' и элементы каждого списка разделяются запятыми. Вот несколько примеров:

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

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

Примечание. В зависимости от контекста использования некоторые методы запроса и заголовки могут быть разрешены всегда, а другие — никогда. Например, обработчик протокола HTTP может запретить устанавливать определенные заголовки, такие как Content-Length, кодом приложения, независимо от того, разрешает ли действующая политика безопасности их установку.

Конструкторы

URLPermission

public URLPermission(String url,
                     String actions)

Создаёт новый URLPermission из строки url и задаёт разрешённые методы запроса и настраиваемые пользователем заголовки запроса. Имя разрешения — это строка url, с которой оно было создано. Внутренне используются только схема, авторитет и путь url. Любые фрагмент или компоненты запроса игнорируются. Строка действия разрешения указана выше.

Параметры:

url - строка url

actions - строка действий

Исключения:

IllegalArgumentException - если url некорректен или если actions содержит пробелы.

URLPermission

public URLPermission(String url)

Создаёт URLPermission с заданной строкой url и без ограничений на методы и заголовки запросов, вызвав конструктор с двумя аргументами следующим образом: URLPermission(url, "*:*")

Параметры:

url - строка url

Исключения:

IllegalArgumentException - если url не соответствует валидному URI

Методы

getActions

public String getActions()

"method-names : header-names"

Определено в:

getActions в классе Permission

Возвращает:

действия данного разрешения.

implies

public boolean implies(Permission p)

Определено в:

implies в классе Permission

Параметры:

p - разрешение для проверки.

Возвращает:

true, если указанное разрешение подразумевается этим объектом, false — в противном случае.

equals

public boolean equals(Object p)

Возвращает true, если this.getActions().equals(p.getActions()) и url p равен url этого. В противном случае возвращает false.

Определено в:

equals в классе Permission

Параметры:

p - объект, с которым мы проверяем равенство этому объекту.

Возвращает:

true, если оба объекта Permission эквивалентны.

См. также:

Object.hashCode(), HashMap

hashCode

public int hashCode()

Возвращает хэш-код, рассчитанный из хэш-кода строки действий и строки url.

Определено в:

hashCode в классе Permission

Возвращает:

значение хэш-кода для этого объекта.

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)