Spec-Zone .ru спецификации, руководства, описания, API

javax.security.jacc
Класс WebResourcePermission

java.lang.Object
  java.security.Permission
      javax.security.jacc.WebResourcePermission

Все Реализованные Интерфейсы:

java.io. Сериализуемый, java.security. Защита

public final class WebResourcePermission
расширяет java.security. Разрешение
реализации java.io. Сериализуемый

Класс для полномочий веб-ресурса Сервлета. WebResourcePermission является именованным разрешением и имеет действия.

Имя WebResourcePermission (также называемый целевым именем) идентифицирует Веб-ресурсы, которым принадлежит разрешение.

Реализации этого class МОГУТ реализовать newPermissionCollection или наследовать его реализацию от class высшего качества.

Версия:

% %I %E %

Автор:

Рон Монзилло, Гари Эллисон

См. Также:

Permission, Сериализированная Форма

Сводка конструктора

WebResourcePermission(HttpServletRequest request)
Создает новый WebResourcePermission из объекта HttpServletRequest.

WebResourcePermission(java.lang.String name, java.lang.String actions)
Создает новый WebResourcePermission с указанным именем и действиями.

WebResourcePermission(java.lang.String urlPatternSpec, java.lang.String[] HTTPMethods)
Создает новый WebResourcePermission с именем, соответствующим URLPatternSpec, и действиям, составленным из массива методов HTTP.

Сводка метода

boolean	equals(java.lang.Object o) Проверки два WebResourcePermission возражают для равенства.
java.lang.String	getActions() Возвращает каноническое Строковое представление действий этого WebResourcePermission.
int	hashCode() Возвращает значение хэш-кода для этого WebResourcePermission.
boolean	implies(java.security.Permission permission) Определяет, " ли Разрешение параметра подразумевается" этим WebResourcePermission.

Методы, наследованные от class java.security. Разрешение

checkGuard, getName, newPermissionCollection, toString

Методы, наследованные от class java.lang. Объект

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Деталь конструктора

WebResourcePermission

public WebResourcePermission(java.lang.String name,
                             java.lang.String actions)

Создает новый WebResourcePermission с указанным именем и действиями.

Имя содержит URLPatternSpec, который идентифицирует веб-ресурсы, к которым полномочия применяется. Синтаксис URLPatternSpec следующие:

          URLPatternList ::= URLPattern | URLPatternList colon URLPattern

          URLPatternSpec ::= null | URLPattern | URLPattern colon URLPatternList

 

Нулевой URLPatternSpec преобразовывается в значение по умолчанию URLPattern, "/", конструктором разрешения. Пустая строка является точным URLPattern, и может произойти где угодно в URLPatternSpec, что может произойти точный URLPattern. Первый URLPattern в URLPatternSpec может быть любым из типов образца, точных, префикс пути, расширение, или значение по умолчанию как определено в Спецификации Сервлета Java). Когда URLPatternSpec включает URLPatternList, образцы URLPatternList идентифицируют ресурсы, к которым разрешение НЕ применяется и зависит от типа образца и значения первого образца следующим образом:

• Никакой образец не может существовать в URLPatternList, который соответствует первый образец.
• Если первый образец является префиксным путем образцом, только точные образцы, соответствующие первым образцом и префиксными путем образцами, соответствующими, но отличающийся от, первый образец может произойти в URLPatternList.
• Если первый образец является образцом расширения, только точные образцы, которые являются соответствующими первым образцом, и префиксные путем образцы могут произойти в URLPatternList.
• Если первый образец является образцом значения по умолчанию, "/", любой образец кроме образца значения по умолчанию может произойти в URLPatternList.
• Если первый образец является точным образцом, URLPatternList не должен присутствовать в URLPatternSpec.

Параметр действий содержит запятую seperated список методов HTTP. Синтаксис параметра действий определяется следующим образом:

          ExtensionMethod ::= any token as defined by RFC 2616
                    (that is, 1*[any CHAR except CTLs or separators])

          HTTPMethod ::= "GET" | "POST" | "PUT" | "DELETE" | "HEAD" |
                   "OPTIONS" | "TRACE" | ExtensionMethod
          
          HTTPMethodList ::= HTTPMethod | HTTPMethodList comma HTTPMethod
  
          HTTPMethodExceptionList ::= exclaimationPoint HTTPMethodList
 
          HTTPMethodSpec ::= null | HTTPMethodExceptionList | 
                   HTTPMethodList

 

Если копии происходят в HTTPMethodSpec, они должны быть устранены конструктором разрешения.

Нулевой или пустой строковый HTTPMethodSpec указывает, что разрешение применяется ко всем методам HTTP в ресурсах, идентифицированных образцом URL.

Если HTTPMethodSpec содержит HTTPMethodExceptionList (то есть, он начинается с exclaimationPoint), разрешение принадлежит всем методам кроме тех, которые происходят в списке исключения.

Параметры:

name - URLPatternSpec, который идентифицирует специализированные веб-ресурсы, которым принадлежит разрешение. Все URLPatterns в URLPatternSpec относительно пути контекста развернутого модуля веб-приложения, и тот же самый URLPattern не должен произойти не раз в URLPatternSpec. Нулевой URLPatternSpec преобразовывается в значение по умолчанию URLPattern, "/", конструктором разрешения. Все двоеточия, происходящие в пределах элементов URLPattern URLPatternSpec, должны быть представлены в оставленном кодировании как определено в RFC 2396.

actions - идентифицирует методы HTTP, которым принадлежит разрешение. Если значение, через которое проходят, этот параметр является нулем или пустой строкой, то разрешение принадлежит всем возможным методам HTTP.

WebResourcePermission

public WebResourcePermission(java.lang.String urlPatternSpec,
                             java.lang.String[] HTTPMethods)

Создает новый WebResourcePermission с именем, соответствующим URLPatternSpec, и действиям, составленным из массива методов HTTP.

Параметры:

urlPatternSpec - URLPatternSpec, который идентифицирует специализированные веб-ресурсы, которым принадлежит разрешение. Все URLPatterns в URLPatternSpec относительно пути контекста развернутого модуля веб-приложения, и тот же самый URLPattern не должен произойти не раз в URLPatternSpec. Нулевой URLPatternSpec преобразовывается в значение по умолчанию URLPattern, "/", конструктором разрешения. Все двоеточия, происходящие в пределах элементов URLPattern URLPatternSpec, должны быть представлены в оставленном кодировании как определено в RFC 2396.

HTTPMethods - массив строк, каждый элемент которых содержит значение метода HTTP. Если значение, через которое проходят, этот параметр является нулем или является массивом без элементов, то разрешение принадлежит всем возможным методам HTTP.

WebResourcePermission

public WebResourcePermission(HttpServletRequest request)

Создает новый WebResourcePermission из объекта HttpServletRequest.

Параметры:

request - соответствие объекта HttpServletRequest работе Сервлета, которой принадлежит разрешение. Имя разрешения является подстрокой requestURI (HttpServletRequest.getRequestURI), который начинается после contextPath (HttpServletRequest.getContextPath). Когда работа подстроки приводит к строке "/", разрешение создается с пустой строкой как ее имя. Поле действий разрешения получается из HttpServletRequest.getMethod (). Конструктор должен преобразовать все символы двоеточия, происходящие в имя к оставленному кодированию как определено в RFC 2396.

Деталь метода

равняется

public boolean equals(java.lang.Object o)

Проверки два WebResourcePermission возражают для равенства. Объекты WebResourcePermission эквивалентны, если их URLPatternSpec и (канонизировавшие) значения действий эквивалентны. URLPatternSpec ссылочного разрешения эквивалентен тому из разрешения параметра, если их первые образцы эквивалентны, и образцы URLPatternList ссылочного разрешения все вместе соответствуют точно тот же самый набор образцов, как являются соответствующими образцами URLPatternList разрешения параметра.

Два Объекта полномочий, P1 и P2, эквивалентны если и только если P1.implies (P2) && P2.implies (P1).

Определенный:

equals в class java.security.Permission

Параметры:

o - объект WebResourcePermission, протестированный на равенство с этим WebResourcePermission.

Возвраты:

истина, если параметр объект WebResourcePermission эквивалентен этому WebResourcePermission.

getActions

public java.lang.String getActions()

Возвращает каноническое Строковое представление действий этого WebResourcePermission. В канонической форме, предопределенные методы preceed методы расширения, и в пределах каждой классификации метода соответствующие методы происходят в возрастающем лексическом порядке. В канонической форме не может быть никаких двойных методов HTTP, и каноническая форма набора всех методов HTTP является нулем значения.

Определенный:

getActions в class java.security.Permission

Возвраты:

Строка, содержащая канонизировавшие действия этого WebResourcePermission (или нулевое значение).

хэш-код

public int hashCode()

Возвращает значение хэш-кода для этого WebResourcePermission. Свойства возвращенного хэш-кода должны быть следующие:

• Во время времени жизни приложения Java метод хэш-кода должен возвратить то же самое целочисленное значение, каждый раз, когда это вызывают на объекте WebResourcePermission. Значение, возвращенное хэш-кодом для определенного WebResourcePermission, не должно остаться непротиворечивым от одного выполнения приложения другому.
• Если два объекта WebResourcePermission равны согласно, равняется методу, то вызов метода хэш-кода на каждом из этих двух Объектов полномочий должен привести к тому же самому целочисленному результату (в пределах приложения).

Определенный:

hashCode в class java.security.Permission

Возвраты:

целочисленный хэш-код оценивает за этот объект.

подразумевает

public boolean implies(java.security.Permission permission)

Определяет, " ли Разрешение параметра подразумевается" этим WebResourcePermission. Для этого, чтобы иметь место, все следующее должно быть истиной:

• Параметром является instanceof WebResourcePermission
• Первый URLPattern от имени разрешения параметра является соответствующим первым URLPattern от имени этого разрешения.
• Первый URLPattern от имени разрешения параметра НЕ является соответствующим никаким URLPattern в URLPatternList URLPatternSpec этого разрешения.
• Если первый URLPattern от имени разрешения параметра соответствует первый URLPattern в URLPatternSpec этого разрешения, то каждый URLPattern в URLPatternList URLPatternSpec этого разрешения является соответствующим URLPattern в URLPatternList разрешения параметра.
• Методы HTTP, представленные действиями разрешения параметра, являются подмножеством методов HTTP, представленных действиями этого разрешения.

Соответствие URLPattern выполняется, используя правила соответствия Сервлета, где два образца URL соответствуют, если они связываются следующим образом:

• их значения образца являются эквивалентной Строкой, или
• этот образец является префиксным путем образцом "/*", или
• этот образец является префиксным путем образцом (то есть, он запускается с "/" и заканчивается "/*"), и образец параметра запускается с подстроки этого образца минус его последние 2 символа, и следующий символ образца параметра, если есть один, "/", или
• этот образец является образцом расширения (то есть, он запускается с "*."), и образец параметра заканчивается этим образцом, или
• ссылочный образец является специальным образцом значения по умолчанию, "/", который соответствует все образцы параметра.

Все сравнения, описанные выше, являются чувствительными к регистру.

Определенный:

implies в class java.security.Permission

Параметры:

permission - "этот" WebResourcePermission проверяется, чтобы видеть, подразумевает ли он разрешение параметра.

Возвраты:

истина, если указанное разрешение подразумевается этим объектом, ложь если нет.