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

javax.security.jacc
Класс EJBMethodPermission

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

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

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

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

Класс для полномочий метода EJB.

Имя EJBMethodPermission содержит значение элемента ejb-имени в дескрипторе развертывания приложения, который идентифицирует целевой EJB.

Действия EJBMethodPermission идентифицируют методы EJB, к которому применяется разрешение.

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

Автор:

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

См. Также:

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

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

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

EJBMethodPermission(java.lang.String EJBName, java.lang.String methodInterface, java.lang.reflect.Method method)
Создает новый EJBMethodPermission с именем, соответствующим EJBName и действиям, составленным из methodInterface, и объекта Метода.

EJBMethodPermission(java.lang.String EJBName, java.lang.String methodName, java.lang.String methodInterface, java.lang.String[] methodParams)
Создает новый EJBMethodPermission с именем, соответствующим EJBName и действиям, составленным из methodName, methodInterface, и methodParams.

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

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

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

checkGuard, getName, newPermissionCollection, toString

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

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

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

EJBMethodPermission

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

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

Имя содержит значение элемента ejb-имени, соответствующего EJB в дескрипторе развертывания приложения.

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

      methodNameSpec ::= methodName | emptyString

      methodInterfaceName ::= String

      methodInterfaceSpec ::= methodInterfaceName | emptyString

      typeName ::= typeName | typeName []

      methodParams ::= typeName | methodParams comma typeName

      methodParamsSpec ::= emptyString | methodParams

      methodSpec ::= null |
           methodNameSpec |
           methodNameSpec comma methodInterfaceName |
           methodNameSpec comma methodInterfaceSpec comma methodParamsSpec
 

MethodInterfaceName является непустой Строкой и должен содержать значение метода-intf как определено для использования в дескрипторах развертывания EJB. Реализация должна быть гибкой так, что, она поддерживает дополнительные имена интерфейса особенно, если они стандартизируются Спецификацией EJB. Спецификация EJB в настоящий момент определяет следующие значения метода-intf:

       { "Home", "LocalHome", "Remote", "Local", "ServiceEndpoint" }
 

Нулевая или пустая строка methodSpec указывает, что разрешение применяется ко всем методам EJB. methodSpec с methodNameSpec пустой строки соответствует все методы EJB, которые соответствуют methodInterface и methodParams элементы methodSpec.

methodSpec с methodInterfaceSpec пустой строки соответствует все методы EJB, которые соответствуют methodNameSpec и methodParamsSpec элементы methodSpec.

methodSpec без methodParamsSpec соответствует все методы EJB, которые соответствуют methodNameSpec и methodInterface элементы methodSpec.

Порядок имен типов в массиве methodParams должен соответствовать порядок происшествия соответствующих параметров в сигнатуре метода целевого метода (ов). Каждое имя типа в methodParams должно содержать каноническую форму имени типа соответствующего параметра как определено getActions методом. methodSpec с пустым methodParamsSpec соответствует все 0 методов параметра EJB, которые соответствуют methodNameSpec и methodInterfaceSpec элементы methodSpec.

Параметры:

name - из EJB, которому принадлежит разрешение.

actions - идентифицирует методы EJB, которому принадлежит разрешение.

EJBMethodPermission

public EJBMethodPermission(java.lang.String EJBName,
                           java.lang.String methodName,
                           java.lang.String methodInterface,
                           java.lang.String[] methodParams)

Создает новый EJBMethodPermission с именем, соответствующим EJBName и действиям, составленным из methodName, methodInterface, и methodParams.

Параметры:

EJBName - Строковое представление имени EJB, как это появляется в соответствующем элементе ejb-имени в дескрипторе развертывания.

methodName - Строка, которая может использоваться, чтобы указать на метод EJB, которому принадлежит разрешение. Значение нуля или "" указывает, что разрешение принадлежит всем методам, которые соответствуют другие параметры спецификации разрешения без рассмотрения имени метода.

methodInterface - Строка, которая может использоваться, чтобы определить интерфейс EJB, которому принадлежит разрешение. Значение нуля или"", указывает, что разрешение принадлежит всем методам, которые соответствуют другие параметры спецификации разрешения без рассмотрения интерфейса, на котором они происходят.

methodParams - Массив строк, которые могут использоваться, чтобы определить (именами типов) подпись параметра целевых методов. Порядок имен типов в массиве methodParams должен соответствовать порядок происшествия соответствующих параметров в сигнатуре метода целевого метода (ов). Каждое имя типа в массиве methodParams должно содержать каноническую форму имени типа соответствующего параметра как определено getActions методом. Пустой массив methodParams используется, чтобы представить сигнатуру метода без параметров. Значение нуля указывает, что разрешение принадлежит всем методам, которые соответствуют другие параметры спецификации разрешения без рассмотрения сигнатуры метода.

EJBMethodPermission

public EJBMethodPermission(java.lang.String EJBName,
                           java.lang.String methodInterface,
                           java.lang.reflect.Method method)

Создает новый EJBMethodPermission с именем, соответствующим EJBName и действиям, составленным из methodInterface, и объекта Метода.

Контейнер использует этого конструктора до проверки, если у вызывающей стороны есть разрешение, чтобы вызвать метод EJB.

Параметры:

EJBName - Строковое представление имени EJB, как это появляется в соответствующем элементе ejb-имени в дескрипторе развертывания.

methodInterface - Строка, которая может использоваться, чтобы определить интерфейс EJB, которому принадлежит разрешение. Значение нуля или"", указывает, что разрешение принадлежит всем методам, которые соответствуют другие параметры спецификации разрешения без рассмотрения интерфейса, на котором они происходят.

method - экземпляр Java.lang.reflect. class метода, соответствующий методу, который контейнер пытается определить, есть ли у вызывающей стороны разрешение к доступу. Это значение не должно быть нулем.

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

равняется

public boolean equals(java.lang.Object o)

Проверки два EJBMethodPermission возражают для равенства. Объекты EJBMethodPermission эквивалентны, если у них есть чувствительное к регистру эквивалентное имя и значения действий.

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

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

equals в class java.security.Permission

Параметры:

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

Возвраты:

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

getActions

public java.lang.String getActions()

Возвращает Строку, содержащую каноническое представление действий этого EJBMethodPermission. Каноническая форма действий EJBMethodPermission описывается следующим описанием синтаксиса.

      methodNameSpec ::= methodName | emptyString

      methodInterfaceName ::= String

      methodInterfaceSpec ::= methodInterfaceName | emptyString

      typeName ::= typeName | typeName []

      methodParams ::= typeName | methodParams comma typeName

      methodParamsSpec ::= emptyString | methodParams

      methodSpec ::= null |
           methodName |
           methodNameSpec comma methodInterfaceName |
           methodNameSpec comma methodInterfaceSpec comma methodParamsSpec
 

Каноническая форма каждого имени типа должна начаться с полностью определенного имени Java типа соответствующего параметра. Каноническая форма имени типа для параметра массива является полностью определенным именем Java компонентного типа массива, сопровождаемого так многими экземплярами строки" []", поскольку есть размерности массиву. Никакие дополнительные символы (например, пробелы) не могут произойти в канонической форме.

MethodInterfaceName является непустой Строкой и должен содержать значение метода-intf как определено для использования в дескрипторах развертывания EJB. Реализация должна быть гибкой так, что, она поддерживает дополнительные имена интерфейса особенно, если они стандартизируются Спецификацией EJB. Спецификация EJB в настоящий момент определяет следующие значения метода-intf:

       { "Home", "LocalHome", "Remote", "Local", "ServiceEndpoint" }
 

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

getActions в class java.security.Permission

Возвраты:

Строка, содержащая канонизировавшие действия этого EJBMethodPermission.

хэш-код

public int hashCode()

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

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

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

hashCode в class java.security.Permission

Возвраты:

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

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

public boolean implies(java.security.Permission permission)

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

• Параметром должен быть instanceof EJBMethodPermission
• с именем, эквивалентным тому из этого EJBMethodPermission, и
• методы, к которым применяется разрешение параметра (как определено в его действиях) должны быть подмножеством методов, к которым этот EJBMethodPermission применяется (как определено в его действиях).

Разрешение параметра применяется к подмножеству методов, к которым применяется это разрешение, если все следующие условия встречаются.

• компонент имени метода methodNameSpec этого разрешения является нулем, пустой строкой, или эквивалентный имени метода разрешения параметра, и
• компонент интерфейса метода methodNameSpec этого разрешения является нулем, пустой строкой, или эквивалентный интерфейсу метода разрешения параметра, и
• компонент списка параметров метода methodNameSpec этого разрешения является нулем, пустой строкой, или эквивалентный списку параметров метода разрешения параметра.

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

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

implies в class java.security.Permission

Параметры:

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

Возвраты:

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