javax.security.jacc
Интерфейс PolicyConfiguration


public interface PolicyConfiguration

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

Жизненный цикл контекста политики определяется тремя состояниями; "открытый", "штатный", и "удаленный". Контекст политики находится в одном из этих трех состояний.

Контекст политики в "открытом" состоянии находится в процессе того, чтобы быть сконфигурированным, и может управляться на любым из методов интерфейса PolicyConfiguration. Контекст политики в "открытом" состоянии не должен ассимилироваться в Policy.refresh в программные заявления, используемые провайдером Политики в выполнении его решений о предоставлении доступа. Для программных заявлений контекста политики, который будет ассимилироваться связанным провайдером, контекст политики должен быть в "штатном" состоянии. Контекст политики в "открытом" состоянии переходится к "штатному" состоянию, вызывая метод фиксации.

Контекст политики в "штатном" состоянии доступен для ассимиляции в программные заявления, используемые, чтобы выполнить решения о предоставлении доступа связанным провайдером Политики. Провайдеры ассимилируют контексты политики, содержащие программные заявления, когда метод обновления провайдера вызывают. Когда метод обновления провайдера вызывают, он должен ассимилировать только те контексты политики, состояние которых является "штатным", и он должен гарантировать, что программные заявления, введенные в эксплуатацию для каждого контекста политики, являются только определенными в контексте во время вызова, чтобы обновить. Контекст политики в "штатном" состоянии не доступен для дополнительной конфигурации и может быть возвращен к "открытому" состоянию, вызывая getPolicyConfiguration метод PolicyConfigurationFactory.

Контекст политики в "удаленном" состоянии не ни доступен для конфигурации, и при этом это не доступно для ассимиляции в Провайдера. Контекст политики, состояние которого "удаляется", может быть исправлен для последующей обработки, вызывая getPolicyConfiguration метод связанного PolicyConfigurationFactory. "Удаленный" контекст политики переходится к "открытому" состоянию, когда это это возвратилось в результате звонка getPolicyConfiguration.

Следующая таблица получает корреспонденцию между жизненным циклом контекста политики и методами интерфейса PolicyConfiguration. Самые правые 3 столбца таблицы соответствуют состоянию PolicyConfiguration, идентифицированному во главе столбца. Значения в ячейках этих столбцов указывают на следующее состояние, следующее из звонка в метод identifed в крайнем левом столбце соответствующей строки, или что вызов метода неподдерживается в состоянии, представленном столбцом (когда состояние останется неизменным).

Таблица государства PolicyConfiguration
Метод Текущее состояние в Следующее государство
удаленный открытый штатный
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.
 

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

getContextID

java.lang.String getContextID()
                              throws PolicyContextException
Этот метод возвращает идентификатор контекста политики этого объекта.

Возвраты:
идентификатор контекста политики этого объекта.
Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено getContextID сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

addToRole

void addToRole(java.lang.String roleName,
               java.security.PermissionCollection permissions)
               throws PolicyContextException
Используемый, чтобы добавить полномочия к именованной роли в этом PolicyConfiguration. Если именованная роль не существует в PolicyConfiguration, она создается в результате звонка в эту функцию.

Это - задание провайдера Политики, чтобы гарантировать, что все полномочия, добавленные к роли, предоставляют принципалам, "отображенным на роль".

Параметры:
roleName - имя Роли, к которой должны быть добавлены полномочия.

permissions - набор полномочий, которые будут добавлены к роли. Набор может быть или однородным или неоднородным набором.
Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
java.lang.UnsupportedOperationException - если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено addToRole сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

addToRole

void addToRole(java.lang.String roleName,
               java.security.Permission permission)
               throws PolicyContextException
Используемый, чтобы добавить единственное разрешение к именованной роли в этом PolicyConfiguration. Если именованная роль не существует в PolicyConfiguration, она создается в результате звонка в эту функцию.

Это - задание провайдера Политики, чтобы гарантировать, что все полномочия, добавленные к роли, предоставляют принципалам, "отображенным на роль".

Параметры:
roleName - имя Роли, к которой должно быть добавлено разрешение.

permission - разрешение, которое будет добавлено к роли.
Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
java.lang.UnsupportedOperationException - если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено addToRole сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

addToUncheckedPolicy

void addToUncheckedPolicy(java.security.PermissionCollection permissions)
                          throws PolicyContextException
Используемый, чтобы добавить программные заявления непроверенные к этому PolicyConfiguration.

Параметры:
permissions - набор полномочий, которые будут добавлены как программные заявления непроверенные. Набор может быть или однородным или неоднородным набором.
Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
java.lang.UnsupportedOperationException - если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено addToUncheckedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

addToUncheckedPolicy

void addToUncheckedPolicy(java.security.Permission permission)
                          throws PolicyContextException
Используемый, чтобы добавить единственное программное заявление непроверенное к этому PolicyConfiguration.

Параметры:
permission - разрешение, которое будет добавлено к программным заявлениям непроверенным.
Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
java.lang.UnsupportedOperationException - если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено addToUncheckedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

addToExcludedPolicy

void addToExcludedPolicy(java.security.PermissionCollection permissions)
                         throws PolicyContextException
Используемый, чтобы добавить исключенные программные заявления к этому PolicyConfiguration.

Параметры:
permissions - набор полномочий, которые будут добавлены к исключенным программным заявлениям. Набор может быть или однородным или неоднородным набором.
Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
java.lang.UnsupportedOperationException - если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено addToExcludedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

addToExcludedPolicy

void addToExcludedPolicy(java.security.Permission permission)
                         throws PolicyContextException
Используемый, чтобы добавить единственное исключенное программное заявление к этому PolicyConfiguration.

Параметры:
permission - разрешение, которое будет добавлено к исключенным программным заявлениям.
Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
java.lang.UnsupportedOperationException - если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено addToExcludedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

removeRole

void removeRole(java.lang.String roleName)
                throws PolicyContextException
Используемый, чтобы удалить роль и все ее полномочия из этого PolicyConfiguration. Этот метод не имеет никакого эффекта на ссылки между этим PolicyConfiguration и другими.

Параметры:
roleName - имя роли, чтобы удалить из этого PolicyConfiguration. Если значение roleName параметра "*", и никакая роль с именем "*" не существует в этом PolicyConfiguration, то все роли должны быть удалены из этого PolicyConfiguration.
Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
java.lang.UnsupportedOperationException - если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено removeRole сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

removeUncheckedPolicy

void removeUncheckedPolicy()
                           throws PolicyContextException
Используемый, чтобы удалить любые программные заявления непроверенные из этого PolicyConfiguration. Этот метод не имеет никакого эффекта на ссылки между этим PolicyConfiguration и другими.

Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
java.lang.UnsupportedOperationException - если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено removeUncheckedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

removeExcludedPolicy

void removeExcludedPolicy()
                          throws PolicyContextException
Используемый, чтобы удалить любые исключенные программные заявления из этого PolicyConfiguration. Этот метод не имеет никакого эффекта на ссылки между этим PolicyConfiguration и другими.

Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
java.lang.UnsupportedOperationException - если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется" или "штатное", когда этот метод вызывают.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено removeExcludedPolicy сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

linkConfiguration

void linkConfiguration(PolicyConfiguration link)
                       throws PolicyContextException
Создает отношение между этой конфигурацией, и другой так, что они совместно используют те же самые отображения принципала к роли. PolicyConfigurations соединяются, чтобы применить общий принципал к роли, отображающийся на многократный seperately управляемый PolicyConfigurations, как требуется, когда приложение составляется из многократных модулей.

Отметьте, что программные заявления, которые включают роль, или включают, исключенные или наборы политики непроверенные в 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
Причины все программные заявления, которые будут удалены из этого PolicyConfiguration и наборов, которые его внутреннее состояние, так, что вызывая любой метод, кроме удаляет, getContextID, или штатный на PolicyConfiguration, будут отклонены и заставят UnsupportedOperationException быть брошенным.

Эта работа имеет, не влияют на любом, соединил PolicyConfigurations кроме удаления любых ссылок, включающих удаленный PolicyConfiguration.

Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено удалить сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

фиксация

void commit()
            throws PolicyContextException
Этот метод используется, чтобы установить в "штатный" состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration. Только те контексты политики, состояние которых является "штатным", будут включены в контексты политики, обработанные методом Policy.refresh. Контекст политики, состояние которого является "штатным", может быть возвращен к "открытому" состоянию, вызывая getPolicyConfiguration метод фабрики PolicyConfiguration с идентификатором контекста политики контекста политики.

Когда состояние контекста политики является "штатным", вызывая любой метод кроме фиксации, удалите, getContextID, или штатный на ее Объекте PolicyConfiguration заставит UnsupportedOperationException быть брошенным.

Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
java.lang.UnsupportedOperationException - если состояние контекста политики, интерфейс которого является этим Объектом PolicyConfiguration, "удаляется", когда этот метод вызывают.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено сигнатурой метода фиксации. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

штатный

boolean inService()
                  throws PolicyContextException
Этот метод используется, чтобы определить, находится ли контекст политики, интерфейс которого является этим Объектом PolicyConfiguration, в "штатном" состоянии.

Возвраты:
истина, если состояние связанного контекста политики является "штатным"; ложь иначе.
Броски:
java.lang.SecurityException - если вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.
PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено штатной сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.


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

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

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


Spec-Zone.ru - all specs in one place



free hit counter