Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
java.lang.Object javax.security.jacc.PolicyContext
public final class PolicyContext
Эта утилита class используется контейнерами, чтобы передать идентификаторы контекста политики и другую политику соответствующий контекст к Policy
провайдеры. Policy
провайдеры используют идентификатор контекста политики, чтобы выбрать подмножество политики применяться в решениях о предоставлении доступа.
Значение идентификатора контекста политики является a String
и у каждого потока есть независимо установленный идентификатор контекста политики. Контейнер установит определяющее контекст потоком значение идентификатора контекста политики, вызывая помехи setContextID
метод. Значение определяющего контекст потоком идентификатора контекста политики доступно (к Policy
) вызывая помехи getContextID
метод.
Этот class также используется Policy
провайдеры, чтобы запросить дополнительную определяющую контекст потоком политику соответствующие объекты контекста от контейнера вызова. Контейнерно-специфичный регистр контейнеров PolicyContext
обработчики используя помехи registerHandler
метод. Регистрация обработчика является определяющей контекст к class, так, что та же самая регистрация обработчика является активной во всех контекстах потока. Контейнеры могут использовать статический метод setHandlerData
установить определяющий контекст потоком параметр, который передадут к обработчикам, когда ими активируют Policy
провайдеры. Помехи getContext
метод используется, чтобы активировать обработчик и получить соответствующий объект контекста.
Статические функции средства доступа, обеспеченные этим class, позволяют значениям контекста политики на поток быть установленными и переданными независимые от общей ссылки на определенный экземпляр PolicyContext.
PolicyContext class может инкапсулировать статические переменные экземпляра ThreadLocal, чтобы представить идентификатор контекста политики и значения данных обработчика.
Сервер приложений должен связать или установить PolicyContext class, и контейнеры сервера приложений должны предотвратить методы PolicyContext class от того, чтобы быть вызванным от вызова контекстов, которые не разрешаются вызвать эти методы. За исключением getContextID и методов GetHandlerKeys, контейнеры должны ограничить и предоставить доступ к методам PolicyContext class к вызову контекстов, которым доверяет контейнер, чтобы выполнить контейнерные решения о предоставлении доступа. class PolicyContext может удовлетворить это требование (от имени его контейнера), отклоняя требования, сделанные из AccessControlContext, которому не предоставили "setPolicy" SecurityPermission, и гарантируя, что провайдерам Политики, используемым, чтобы выполнить контейнерные решения о предоставлении доступа, предоставляют "setPolicy" разрешение.
PolicyContextHandler
Сводка метода | |
---|---|
static java.lang.Object |
getContext(java.lang.String key)
Этот метод может использоваться a Policy провайдер, чтобы активироваться PolicyContextHandler зарегистрированный к ключу объекта контекста и причине это, чтобы возвратить соответствующий объект контекста политики из контейнера. |
static java.lang.String |
getContextID()
Этот статический метод возвращает значение идентификатора контекста политики, связанного с потоком, на котором вызывают средство доступа. |
static java.util.Set |
getHandlerKeys()
Этот метод может использоваться, чтобы получить ключи, которые идентифицируют контейнерные определенные обработчики контекста, зарегистрированные контейнером. |
static void |
registerHandler(java.lang.String key, PolicyContextHandler handler, boolean replace)
Авторизация защищенный метод, используемый, чтобы зарегистрировать определенный контейнер PolicyContext обработчик. |
static void |
setContextID(java.lang.String contextID)
Защищенный метод авторизации, используемый, чтобы изменить значение идентификатора контекста политики, связанного с потоком, на котором вызывают этот метод. |
static void |
setHandlerData(java.lang.Object data)
Защищенный метод авторизации, который может использоваться, чтобы связать определяющий контекст потоком объект данных обработчика с PolicyContext. |
Методы, наследованные от class java.lang. Объект |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Деталь метода |
---|
public static void setContextID(java.lang.String contextID)
contextID
- a String
это представляет значение идентификатора контекста политики, который будет присвоен PolicyContext для вызывающего потока. Значение null
законное значение для этого параметра. java.lang.SecurityException
- если вызов AccessControlContext не разрешается контейнером вызвать этот метод.public static java.lang.String getContextID()
String
(или null
) идентификатор контекста политики устанавливается для потока. Этот метод должен возвратить идентификатор контекста политики значения по умолчанию, null
, если идентификатор контекста политики потока не был установлен через setContext
к другому значению. java.lang.SecurityException
- если вызов AccessControlContext не разрешается контейнером вызвать этот метод. Контейнеры могут хотеть авторизовывать звонки в этот метод любым AccessControlContext.public static void setHandlerData(java.lang.Object data)
data
- контейнерно-специфичный объект, который будет связан с вызывающим потоком и передан к любому обработчику, активированному a Policy
провайдер (на потоке). Значение null
законное значение для этого параметра, и значение, которое будет использоваться в активации обработчиков если setHandlerData
не был вызван на потоке. java.lang.SecurityException
- если вызов AccessControlContext не разрешается контейнером вызвать этот метод.public static void registerHandler(java.lang.String key, PolicyContextHandler handler, boolean replace) throws PolicyContextException
PolicyContext
обработчик. Обработчик может быть зарегистрирован, чтобы обработать многократные ключи, но в любое время, самое большее один обработчик может быть зарегистрирован для ключа.
key
- (чувствительный к регистру) String
это идентифицирует объект контекста, обработанный обработчиком. Значение этого параметра не должно быть нулем.handler
- объект, который реализует PolicyContextHandler
интерфейс. Значение этого параметра не должно быть нулем.replace
- это булево значение определяет поведение этого метода, если, когда это вызывают, a PolicyContextHandler
был уже зарегистрирован, чтобы обработать тот же самый ключ. В этом случае, и если значение этого параметра true
, существующий обработчик заменяется обработчиком параметра. Если значение этого параметра является ложью, существующая регистрация сохраняется, и исключение выдается. java.lang.IllegalArgumentException
- если значение или обработчика или ключевых параметров является нулем, или значение параметра замены false
и обработчик с тем же самым ключом как обработчик параметра уже регистрируется. java.lang.SecurityException
- если вызов AccessControlContext не разрешается контейнером вызвать этот метод. PolicyContextException
- если работа этим методом на параметре, PolicyContextHandler заставляет это выдавать проверенное исключение, которое не учитывается в подписи этого метода.public static java.util.Set getHandlerKeys()
Set
, элементы который, String
значения ключа, которые идентифицируют обработчики, которые были зарегистрированы и поэтому могут быть активированы на PolicyContext
. java.lang.SecurityException
- если вызов AccessControlContext не разрешается контейнером вызвать этот метод. Контейнеры могут хотеть авторизовывать звонки в этот метод любым AccessControlContext.public static java.lang.Object getContext(java.lang.String key) throws PolicyContextException
Policy
провайдер, чтобы активироваться PolicyContextHandler
зарегистрированный к ключу объекта контекста и причине это, чтобы возвратить соответствующий объект контекста политики из контейнера. Когда этот метод активирует обработчик, он передает к обработчику ключ объекта контекста и данные обработчика, связанные с вызывающим потоком.
key
- a String
это идентифицирует PolicyContextHandler
активироваться и объект контекста, который будет получен от обработчика. Значение этого параметра не должно быть нулем. null
значение возвращается, если соответствующий обработчик был зарегистрирован, и значение соответствующего контекста является нулем. java.lang.IllegalArgumentException
- если a PolicyContextHandler
не был зарегистрирован для ключа, или зарегистрированный обработчик больше не поддерживает ключ. java.lang.SecurityException
- если вызов AccessControlContext не разрешается контейнером вызвать этот метод. PolicyContextException
- если работа этим методом на идентифицированном PolicyContextHandler заставляет это выдавать проверенное исключение, которое не учитывается в подписи этого метода.
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41