Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
public interface PolicyConfiguration
Методы этого интерфейса используются контейнерами, чтобы создать программные заявления в провайдере Политики. Объект, который реализует интерфейс PolicyConfiguration, обеспечивает интерфейс конфигурирования программного заявления для соответствующего контекста политики в пределах соответствующего провайдера Политики.
Жизненный цикл контекста политики определяется тремя состояниями; "открытый", "штатный", и "удаленный". Контекст политики находится в одном из этих трех состояний.
Контекст политики в "открытом" состоянии находится в процессе того, чтобы быть сконфигурированным, и может управляться на любым из методов интерфейса PolicyConfiguration. Контекст политики в "открытом" состоянии не должен ассимилироваться в Policy.refresh
в программные заявления, используемые провайдером Политики в выполнении его решений о предоставлении доступа. Для программных заявлений контекста политики, который будет ассимилироваться связанным провайдером, контекст политики должен быть в "штатном" состоянии. Контекст политики в "открытом" состоянии переходится к "штатному" состоянию, вызывая метод фиксации.
Контекст политики в "штатном" состоянии доступен для ассимиляции в программные заявления, используемые, чтобы выполнить решения о предоставлении доступа связанным провайдером Политики. Провайдеры ассимилируют контексты политики, содержащие программные заявления, когда метод обновления провайдера вызывают. Когда метод обновления провайдера вызывают, он должен ассимилировать только те контексты политики, состояние которых является "штатным", и он должен гарантировать, что программные заявления, введенные в эксплуатацию для каждого контекста политики, являются только определенными в контексте во время вызова, чтобы обновить. Контекст политики в "штатном" состоянии не доступен для дополнительной конфигурации и может быть возвращен к "открытому" состоянию, вызывая getPolicyConfiguration метод PolicyConfigurationFactory.
Контекст политики в "удаленном" состоянии не ни доступен для конфигурации, и при этом это не доступно для ассимиляции в Провайдера. Контекст политики, состояние которого "удаляется", может быть исправлен для последующей обработки, вызывая getPolicyConfiguration метод связанного PolicyConfigurationFactory. "Удаленный" контекст политики переходится к "открытому" состоянию, когда это это возвратилось в результате звонка getPolicyConfiguration.
Следующая таблица получает корреспонденцию между жизненным циклом контекста политики и методами интерфейса PolicyConfiguration. Самые правые 3 столбца таблицы соответствуют состоянию PolicyConfiguration, идентифицированному во главе столбца. Значения в ячейках этих столбцов указывают на следующее состояние, следующее из звонка в метод identifed в крайнем левом столбце соответствующей строки, или что вызов метода неподдерживается в состоянии, представленном столбцом (когда состояние останется неизменным).
Метод | Текущее состояние в Следующее государство | ||
---|---|---|---|
удаленный | открытый | штатный | |
addToExcludedPolicy | Недопустимая операция | открытый | Недопустимая операция |
addToRole | Недопустимая операция | открытый | Недопустимая операция |
addToUncheckedPolicy | Недопустимая операция | открытый | Недопустимая операция |
фиксация | Недопустимая операция | штатный | штатный |
удалить | удаленный | удаленный | удаленный |
getContextID | удаленный | открытый | штатный |
штатный | удаленный | открытый | штатный |
linkConfiguration | Недопустимая операция | открытый | Недопустимая операция |
removeExcludedPolicy | Недопустимая операция | открытый | Недопустимая операция |
removeRole | Недопустимая операция | открытый | Недопустимая операция |
removeUncheckedPolicy | Недопустимая операция | открытый | Недопустимая операция |
Для реализации провайдера, чтобы быть совместимым с многопоточными средами, может быть необходимо синхронизировать метод обновления провайдера с методами его интерфейса PolicyConfiguration и с getPolicyConfiguration и штатными методами его PolicyConfigurationFactory.
Permission
, PermissionCollection
, PolicyContextException
, PolicyConfigurationFactory
Сводка метода | |
---|---|
void |
addToExcludedPolicy(java.security.Permission permission)
Используемый, чтобы добавить единственное исключенное программное заявление к этому PolicyConfiguration. |
void |
addToExcludedPolicy(java.security.PermissionCollection permissions)
Используемый, чтобы добавить исключенные программные заявления к этому PolicyConfiguration. |
void |
addToRole(java.lang.String roleName, java.security.Permission permission)
Используемый, чтобы добавить единственное разрешение к именованной роли в этом PolicyConfiguration. |
void |
addToRole(java.lang.String roleName, java.security.PermissionCollection permissions)
Используемый, чтобы добавить полномочия к именованной роли в этом PolicyConfiguration. |
void |
addToUncheckedPolicy(java.security.Permission permission)
Используемый, чтобы добавить единственное программное заявление непроверенное к этому PolicyConfiguration. |
void |
addToUncheckedPolicy(java.security.PermissionCollection permissions)
Используемый, чтобы добавить программные заявления непроверенные к этому PolicyConfiguration. |
void |
commit()
Этот метод используется, чтобы установить в "штатный" состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration. |
void |
delete()
Причины все программные заявления, которые будут удалены из этого PolicyConfiguration и наборов, которые его внутреннее состояние, так, что вызывая любой метод, кроме удаляет, getContextID, или штатный на PolicyConfiguration, будут отклонены и заставят UnsupportedOperationException быть брошенным. |
java.lang.String |
getContextID()
Этот метод возвращает идентификатор контекста политики этого объекта. |
boolean |
inService()
Этот метод используется, чтобы определить, находится ли контекст политики, интерфейс которого является этим Объектом PolicyConfiguration, в "штатном" состоянии. |
void |
linkConfiguration(PolicyConfiguration link)
Создает отношение между этой конфигурацией, и другой так, что они совместно используют те же самые отображения принципала к роли. |
void |
removeExcludedPolicy()
Используемый, чтобы удалить любые исключенные программные заявления из этого PolicyConfiguration. |
void |
removeRole(java.lang.String roleName)
Используемый, чтобы удалить роль и все ее полномочия из этого PolicyConfiguration. |
void |
removeUncheckedPolicy()
Используемый, чтобы удалить любые программные заявления непроверенные из этого PolicyConfiguration. |
Деталь метода |
---|
java.lang.String getContextID() throws PolicyContextException
java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено getContextID сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void addToRole(java.lang.String roleName, java.security.PermissionCollection permissions) throws PolicyContextException
Это - задание провайдера Политики, чтобы гарантировать, что все полномочия, добавленные к роли, предоставляют принципалам, "отображенным на роль".
roleName
- имя Роли, к которой должны быть добавлены полномочия. permissions
- набор полномочий, которые будут добавлены к роли. Набор может быть или однородным или неоднородным набором. java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. java.lang.UnsupportedOperationException
- если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено addToRole сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void addToRole(java.lang.String roleName, java.security.Permission permission) throws PolicyContextException
Это - задание провайдера Политики, чтобы гарантировать, что все полномочия, добавленные к роли, предоставляют принципалам, "отображенным на роль".
roleName
- имя Роли, к которой должно быть добавлено разрешение. permission
- разрешение, которое будет добавлено к роли. java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. java.lang.UnsupportedOperationException
- если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено addToRole сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void addToUncheckedPolicy(java.security.PermissionCollection permissions) throws PolicyContextException
permissions
- набор полномочий, которые будут добавлены как программные заявления непроверенные. Набор может быть или однородным или неоднородным набором. java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. java.lang.UnsupportedOperationException
- если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено addToUncheckedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void addToUncheckedPolicy(java.security.Permission permission) throws PolicyContextException
permission
- разрешение, которое будет добавлено к программным заявлениям непроверенным. java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. java.lang.UnsupportedOperationException
- если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено addToUncheckedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void addToExcludedPolicy(java.security.PermissionCollection permissions) throws PolicyContextException
permissions
- набор полномочий, которые будут добавлены к исключенным программным заявлениям. Набор может быть или однородным или неоднородным набором. java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. java.lang.UnsupportedOperationException
- если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено addToExcludedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void addToExcludedPolicy(java.security.Permission permission) throws PolicyContextException
permission
- разрешение, которое будет добавлено к исключенным программным заявлениям. java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. java.lang.UnsupportedOperationException
- если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено addToExcludedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void removeRole(java.lang.String roleName) throws PolicyContextException
roleName
- имя роли, чтобы удалить из этого PolicyConfiguration. Если значение roleName параметра "*", и никакая роль с именем "*" не существует в этом PolicyConfiguration, то все роли должны быть удалены из этого PolicyConfiguration. java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. java.lang.UnsupportedOperationException
- если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено removeRole сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void removeUncheckedPolicy() throws PolicyContextException
java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. java.lang.UnsupportedOperationException
- если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено removeUncheckedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void removeExcludedPolicy() throws PolicyContextException
java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. java.lang.UnsupportedOperationException
- если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено removeExcludedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void linkConfiguration(PolicyConfiguration link) throws PolicyContextException
Отметьте, что программные заявления, которые включают роль, или включают, исключенные или наборы политики непроверенные в PolicyConfiguration незатронуты конфигурацией, соединяемой с другим.
link
- ссылка на различный PolicyConfiguration чем этот PolicyConfiguration. Отношение, сформированное этим методом, является symetric, переходным и идемпотентным. Если параметр, у PolicyConfiguration нет различного идентификатора контекста Политики чем этот PolicyConfiguration никаким отношением, формируется, и исключение, как описано ниже, выдается.
java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. java.lang.UnsupportedOperationException
- если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают. java.lang.IllegalArgumentException
- если вызвано с параметром PolicyConfiguration, контекст Политики которого эквивалентен тому из этого PolicyConfiguration. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено linkConfiguration сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void delete() throws PolicyContextException
Эта работа имеет, не влияют на любом, соединил PolicyConfigurations кроме удаления любых ссылок, включающих удаленный PolicyConfiguration.
java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено удалить сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.void commit() throws PolicyContextException
Когда состояние контекста политики является "штатным", вызывая любой метод кроме фиксации, удалите, getContextID, или штатный на ее Объекте PolicyConfiguration заставит UnsupportedOperationException быть брошенным.
java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. java.lang.UnsupportedOperationException
- если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется", когда этот метод вызывают. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено сигнатурой метода фиксации. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.boolean inService() throws PolicyContextException
java.lang.SecurityException
- если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission. PolicyContextException
- если реализация выдает проверенное исключение, которое не было учтено штатной сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41