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 идентифицируют ресурсы, к которым разрешение НЕ применяется и зависит от типа образца и значения первого образца следующим образом:

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

Определенный:
hashCode в class java.security.Permission
Возвраты:
целочисленный хэш-код оценивает за этот объект.

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

public boolean implies(java.security.Permission permission)
Определяет, " ли Разрешение параметра подразумевается" этим WebResourcePermission. Для этого, чтобы иметь место, все следующее должно быть истиной:

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

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

Определенный:
implies в class java.security.Permission
Параметры:
permission - "этот" WebResourcePermission проверяется, чтобы видеть, подразумевает ли он разрешение параметра.

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


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter