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

javax.security.jacc
Класс PolicyConfigurationFactory

java.lang.Object
  javax.security.jacc.PolicyConfigurationFactory

public abstract class PolicyConfigurationFactory
расширяет java.lang. Объект

Абстрактная фабрика и средство обнаружения class для того, чтобы получить экземпляр class, который реализует PolicyConfigurationFactory провайдера. Фабрика будет использоваться, чтобы инстанцировать объектов PolicyConfiguration, которые будут использоваться инструментами развертывания контейнера, чтобы создать и управлять контекстами политики в пределах Провайдера Политики.

У классов реализации не должно быть общественности никакой конструктор параметра, который может использоваться, чтобы создать операционный экземпляр реализации фабрики class.

Автор:

Рон Монзилло, Гари Эллисон, Харприт Сингх

См. Также:

Permission, PolicyConfiguration, PolicyContextException

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

PolicyConfigurationFactory()

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

abstract PolicyConfiguration	getPolicyConfiguration(java.lang.String contextID, boolean remove) Этот метод используется, чтобы получить экземпляр провайдера определенный class, который реализует интерфейс PolicyConfiguration, который соответствует идентифицированному контексту политики в пределах провайдера.
static PolicyConfigurationFactory	getPolicyConfigurationFactory() Этот статический метод использует системное свойство, чтобы найти и инстанцировать (через общедоступного конструктора) провайдера определенная реализация фабрики class.
abstract boolean	inService(java.lang.String contextID) Этот метод определяет, существует ли идентифицированный контекст политики с состоянием, "штатным" в провайдере Политики, связанном с фабрикой.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

PolicyConfigurationFactory

public PolicyConfigurationFactory()

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

getPolicyConfigurationFactory

public static PolicyConfigurationFactory getPolicyConfigurationFactory()
                                                                throws java.lang.ClassNotFoundException,
                                                                       PolicyContextException

Этот статический метод использует системное свойство, чтобы найти и инстанцировать (через общедоступного конструктора) провайдера определенная реализация фабрики class. Имя провайдера определенная реализация фабрики class получается из значения системного свойства,

     javax.security.jacc.PolicyConfigurationFactory.provider.
 

Возвраты:

одноэлементный экземпляр провайдера определенная реализация PolicyConfigurationFactory class.

Броски:

java.lang.SecurityException - когда вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.

java.lang.ClassNotFoundException - когда class, названный системным свойством, не мог быть найден включая то, потому что значение системного свойства не имеет быть установленным.

PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено getPolicyConfigurationFactory сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException

getPolicyConfiguration

public abstract PolicyConfiguration getPolicyConfiguration(java.lang.String contextID,
                                                           boolean remove)
                                                    throws PolicyContextException

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

Если во время вызова, идентифицированный контекст политики не будет существовать в провайдере, то контекст политики будет создаваться в провайдере и Объекте, который реализует Интерфейс PolicyConfiguration контекста, будет возвращен. Если состояние идентифицированного контекста будет "удалено" или "штатное", то это перейдется к "открытому" состоянию в результате вызова. Состояния в жизненном цикле контекста политики определяются интерфейсом PolicyConfiguration.

Для данного значения идентификатора контекста политики этот метод должен всегда возвращать тот же самый экземпляр PolicyConfiguration и должен быть самое большее один фактический экземпляр PolicyConfiguration с данным идентификатором контекста политики (во время контекста процесса).

Чтобы сохранить инвариант, которые там быть самое большее одним PolicyConfiguration возражают для данного контекста политики, может быть необходимо для этого метода быть ориентированным на многопотоковое исполнение.

Параметры:

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

remove - Возвращается булево значение, которое устанавливает, должны ли программные заявления и редактирования существующего контекста политики быть удалены перед его объектом PolicyConfiguration. Если значение, которое передают к этому параметру, будет истиной, то программные заявления и редактирования существующего контекста политики будут удалены. Если значение будет ложью, то они не будут удалены.

Возвраты:

Объект, который реализует Интерфейс PolicyConfiguration, соответствующий к провайдеру Политики и соответствию идентифицированному контексту политики.

Броски:

java.lang.SecurityException - когда вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.

PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено getPolicyConfiguration сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.

штатный

public abstract boolean inService(java.lang.String contextID)
                           throws PolicyContextException

Этот метод определяет, существует ли идентифицированный контекст политики с состоянием, "штатным" в провайдере Политики, связанном с фабрикой.

Параметры:

contextID - Строка, идентифицирующая контекст политики

Возвраты:

истина, если идентифицированный контекст политики существует в пределах провайдера и его состояния, является "штатной", ложной иначе.

Броски:

java.lang.SecurityException - когда вызвано AccessControlContext, которому не предоставили "setPolicy" SecurityPermission.

PolicyContextException - если реализация выдает проверенное исключение, которое не было учтено штатной сигнатурой метода. Исключение, выданное реализацией class, будет инкапсулироваться (во время конструкции) в брошенном PolicyContextException.