KeyInfoFactory (Платформа Java SE 7)

java.lang. Объект
- javax.xml.crypto.dsig.keyinfo.KeyInfoFactory

```
public abstract class KeyInfoFactory
extends Object
```
Фабрика для того, чтобы создать KeyInfo объекты с нуля или для того, чтобы неупорядочить a KeyInfo объект от соответствующего представления XML.
Каждый экземпляр KeyInfoFactory поддерживает определенный тип механизма XML. Создать a KeyInfoFactory, вызовите одни из помех getInstance методы, передающие в требуемом типе механизма XML, например:
KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM");

Объекты, что эта фабрика продукты будет основана на ДОМЕ и соблюдать требования функциональной совместимости ДОМА как определено в разделе Требований ДОМА Мечанисма краткого обзора API. См. раздел Поставщиков услуг краткого обзора API для списка стандартных типов механизма.
KeyInfoFactory реализации регистрируются и загрузили использование Provider механизм. Например, поставщик услуг, который поддерживает механизм ДОМА, был бы определен в Provider подкласс как:
```
     put("KeyInfoFactory.DOM", "org.example.DOMKeyInfoFactory");
 
```
Кроме того, XMLStructures, которые создаются этой фабрикой, может содержать состояние, определенное для KeyInfo и не предназначаются, чтобы быть допускающими повторное использование.
Реализация ДОЛЖНА минимально поддерживать тип механизма по умолчанию: ДОМ.
Отметьте, что вызывающая сторона должна использовать то же самое KeyInfoFactory экземпляр, чтобы создать XMLStructures детали KeyInfo объект. Поведение неопределено если XMLStructures от различных провайдеров или различных типов механизма используются вместе.
Параллельный Доступ
Статические методы этого класса, как гарантируют, будут ориентированы на многопотоковое исполнение. Многократные потоки могут одновременно вызвать статические методы, определенные в этом классе без вредных воздействий.
Однако, это не истина для нестатических методов, определенных этим классом. Если иначе не задокументировано определенным провайдером, потоки, которые должны получить доступ к синглу KeyInfoFactory экземпляр одновременно должен синхронизироваться среди себя и обеспечить необходимую блокировку. Многократные потоки каждое управление различным KeyInfoFactory экземпляр не должен синхронизироваться.
С тех пор:

1.6

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

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`KeyInfoFactory()` Конструктор по умолчанию, для вызова подклассами.

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

Методы
Модификатор и Тип	Метод и Описание
`static KeyInfoFactory`	`getInstance()` Возвраты a `KeyInfoFactory` это поддерживает XML по умолчанию, обрабатывающий механизм и тип представления ("ДОМ").
`static KeyInfoFactory`	`getInstance(String mechanismType)` Возвраты a `KeyInfoFactory` это поддерживает указанный XML, обрабатывающий механизм и тип представления (исключая: "ДОМ").
`static KeyInfoFactory`	`getInstance(String mechanismType, Provider provider)` Возвраты a `KeyInfoFactory` это поддерживает требуемый XML, обрабатывающий механизм и тип представления (исключая: "ДОМ"), как предоставлено указанным провайдером.
`static KeyInfoFactory`	`getInstance(String mechanismType, String provider)` Возвраты a `KeyInfoFactory` это поддерживает требуемый XML, обрабатывающий механизм и тип представления (исключая: "ДОМ"), как предоставлено указанным провайдером.
`Строка`	`getMechanismType()` Возвращает тип XML, обрабатывающего механизм и представление, поддерживаемое этим `KeyInfoFactory` (исключая: "ДОМ")
`Провайдер`	`getProvider()` Возвращает провайдера этого `KeyInfoFactory`.
`abstract URIDereferencer`	`getURIDereferencer()` Возвращает ссылку на `URIDereferencer` это используется по умолчанию, чтобы разыменовать URI в `RetrievalMethod` объекты.
`abstract boolean`	`isFeatureSupported(String feature)` Указывает, поддерживается ли указанная функция.
`abstract KeyInfo`	`newKeyInfo(List content)` Создает a `KeyInfo` содержа указанный список ключевых типов информации.
`abstract KeyInfo`	`newKeyInfo(List content, String id)` Создает a `KeyInfo` содержа указанный список ключевых типов информации и дополнительного идентификатора.
`abstract KeyName`	`newKeyName(String name)` Создает a `KeyName` с указанного имени.
`abstract KeyValue`	`newKeyValue(PublicKey key)` Создает a `KeyValue` от указанного открытого ключа.
`abstract PGPData`	`newPGPData(byte[] keyId)` Создает a `PGPData` от указанного идентификатора с открытым ключом PGP.
`abstract PGPData`	`newPGPData(byte[] keyId, byte[] keyPacket, List other)` Создает a `PGPData` от указанного идентификатора с открытым ключом PGP, и дополнительного ключевого материального пакета и списка внешних элементов.
`abstract PGPData`	`newPGPData(byte[] keyPacket, List other)` Создает a `PGPData` от указанного пакета материала ключа PGP и дополнительного списка внешних элементов.
`abstract RetrievalMethod`	`newRetrievalMethod(String uri)` Создает a `RetrievalMethod` от указанного URI.
`abstract RetrievalMethod`	`newRetrievalMethod(String uri, String type, List transforms)` Создает a `RetrievalMethod` от указанных параметров.
`abstract X509Data`	`newX509Data(List content)` Создает a `X509Data` содержа указанный список контента X.509.
`abstract X509IssuerSerial`	`newX509IssuerSerial(String issuerName, BigInteger serialNumber)` Создает `X509IssuerSerial` от указанного отличительного имени выпускающего X.500 и порядкового номера.
`abstract KeyInfo`	`unmarshalKeyInfo(XMLStructure xmlStructure)` Неупорядочивает новое `KeyInfo` экземпляр от специфичного для механизма `XMLStructure` (исключая: `DOMStructure`) экземпляр.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - KeyInfoFactory
```
protected KeyInfoFactory()
```
    Конструктор по умолчанию, для вызова подклассами.
- Деталь метода
  - getInstance
```
public static KeyInfoFactory getInstance(String mechanismType)
```
    Возвраты a KeyInfoFactory это поддерживает указанный XML, обрабатывающий механизм и тип представления (исключая: "ДОМ").
    Этот метод использует стандартный механизм поиска провайдера JCA, чтобы определить местоположение и инстанцировать a KeyInfoFactory реализация требуемого типа механизма. Это пересекает список зарегистрированной безопасности Providers, запускаясь с самого привилегированного Provider. Новое KeyInfoFactory объект сначала Provider это поддерживает указанный механизм, возвращается.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    
    Параметры:
    mechanismType - тип XML, обрабатывающего механизм и представление. См. раздел Поставщиков услуг краткого обзора API для списка стандартных типов механизма.
    
    Возвраты:
    новое KeyInfoFactory
    
    Броски:
    
    NullPointerException - если mechanismType null
    
    NoSuchMechanismException - если нет Provider поддерживает a KeyInfoFactory реализация для указанного механизма
    См. Также:
    Provider
  - getInstance
```
public static KeyInfoFactory getInstance(String mechanismType,
                         Provider provider)
```
    Возвраты a KeyInfoFactory это поддерживает требуемый XML, обрабатывающий механизм и тип представления (исключая: "ДОМ"), как предоставлено указанным провайдером. Отметьте что указанное Provider объект не должен быть зарегистрирован в списке провайдера.
    
    Параметры:
    mechanismType - тип XML, обрабатывающего механизм и представление. См. раздел Поставщиков услуг краткого обзора API для списка стандартных типов механизма.
    provider - Provider объект
    
    Возвраты:
    новое KeyInfoFactory
    
    Броски:
    
    NullPointerException - если mechanismType или provider null
    
    NoSuchMechanismException - если a KeyInfoFactory реализация для указанного механизма не доступна от указанного Provider объект
    См. Также:
    Provider
  - getInstance
```
public static KeyInfoFactory getInstance(String mechanismType,
                         String provider)
                                  throws NoSuchProviderException
```
    Возвраты a KeyInfoFactory это поддерживает требуемый XML, обрабатывающий механизм и тип представления (исключая: "ДОМ"), как предоставлено указанным провайдером. Указанный провайдер должен быть зарегистрирован в списке поставщика систем обеспечения безопасности.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    
    Параметры:
    mechanismType - тип XML, обрабатывающего механизм и представление. См. раздел Поставщиков услуг краткого обзора API для списка стандартных типов механизма.
    provider - имя строки провайдера
    
    Возвраты:
    новое KeyInfoFactory
    
    Броски:
    
    NoSuchProviderException - если указанный провайдер не регистрируется в списке поставщика систем обеспечения безопасности
    
    NullPointerException - если mechanismType или provider null
    
    NoSuchMechanismException - если a KeyInfoFactory реализация для указанного механизма не доступна от указанного провайдера
    См. Также:
    Provider
  - getInstance
```
public static KeyInfoFactory getInstance()
```
    Возвраты a KeyInfoFactory это поддерживает XML по умолчанию, обрабатывающий механизм и тип представления ("ДОМ").
    Этот метод использует стандартный механизм поиска провайдера JCA, чтобы определить местоположение и инстанцировать a KeyInfoFactory реализация типа механизма по умолчанию. Это пересекает список зарегистрированной безопасности Providers, запускаясь с самого привилегированного Provider. Новое KeyInfoFactory объект сначала Provider это поддерживает механизм ДОМА, возвращается.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    
    Возвраты:
    новое KeyInfoFactory
    
    Броски:
    
    NoSuchMechanismException - если нет Provider поддерживает a KeyInfoFactory реализация для механизма ДОМА
    См. Также:
    Provider
  - getMechanismType
```
public final String getMechanismType()
```
    Возвращает тип XML, обрабатывающего механизм и представление, поддерживаемое этим KeyInfoFactory (исключая: "ДОМ")
    
    Возвраты:
    XML, обрабатывающий тип механизма, поддерживается этим KeyInfoFactory
  - getProvider
```
public final Provider getProvider()
```
    Возвращает провайдера этого KeyInfoFactory.
    
    Возвраты:
    провайдер этого KeyInfoFactory
  - newKeyInfo
```
public abstract KeyInfo newKeyInfo(List content)
```
    Создает a KeyInfo содержа указанный список ключевых типов информации.
    
    Параметры:
    content - список один или больше XMLStructures представляющий ключевые типы информации. Список защитно копируется, чтобы защитить от последующей модификации.
    
    Возвраты:
    a KeyInfo
    
    Броски:
    
    NullPointerException - если content null
    
    IllegalArgumentException - если content пусто
    
    ClassCastException - если content содержит любые записи, которые не имеют типа XMLStructure
  - newKeyInfo
```
public abstract KeyInfo newKeyInfo(List content,
                 String id)
```
    Создает a KeyInfo содержа указанный список ключевых типов информации и дополнительного идентификатора. id параметр представляет значение XML ID припишите и полезно для ссылки KeyInfo от других структур XML.
    
    Параметры:
    content - список один или больше XMLStructures представляющий ключевые типы информации. Список защитно копируется, чтобы защитить от последующей модификации.
    id - значение XML ID (может быть null)
    
    Возвраты:
    a KeyInfo
    
    Броски:
    
    NullPointerException - если content null
    
    IllegalArgumentException - если content пусто
    
    ClassCastException - если content содержит любые записи, которые не имеют типа XMLStructure
  - newKeyName
```
public abstract KeyName newKeyName(String name)
```
    Создает a KeyName с указанного имени.
    
    Параметры:
    name - имя, которое идентифицирует ключ
    
    Возвраты:
    a KeyName
    
    Броски:
    
    NullPointerException - если name null
  - newKeyValue
```
public abstract KeyValue newKeyValue(PublicKey key)
                              throws KeyException
```
    Создает a KeyValue от указанного открытого ключа.
    
    Параметры:
    key - открытый ключ
    
    Возвраты:
    a KeyValue
    
    Броски:
    
    KeyException - если key's алгоритм не распознается или поддерживается этим KeyInfoFactory
    
    NullPointerException - если key null
  - newPGPData
```
public abstract PGPData newPGPData(byte[] keyId)
```
    Создает a PGPData от указанного идентификатора с открытым ключом PGP.
    
    Параметры:
    keyId - идентификатор с открытым ключом PGP как определено в RFC 2440, разделите 11.2. Массив клонируется, чтобы защитить от последующей модификации.
    
    Возвраты:
    a PGPData
    
    Броски:
    
    NullPointerException - если keyId null
    
    IllegalArgumentException - если ключевой идентификатор не находится в корректном формате
  - newPGPData
```
public abstract PGPData newPGPData(byte[] keyId,
                 byte[] keyPacket,
                 List other)
```
    Создает a PGPData от указанного идентификатора с открытым ключом PGP, и дополнительного ключевого материального пакета и списка внешних элементов.
    
    Параметры:
    keyId - идентификатор с открытым ключом PGP как определено в RFC 2440, разделите 11.2. Массив клонируется, чтобы защитить от последующей модификации.
    keyPacket - пакет материала ключа PGP как определено в RFC 2440, разделите 5.5. Массив клонируется, чтобы защитить от последующей модификации. Может быть null.
    other - список XMLStructures представление элементов от внешнего пространства имен. Список защитно копируется, чтобы защитить от последующей модификации. Может быть null или пустой.
    
    Возвраты:
    a PGPData
    
    Броски:
    
    NullPointerException - если keyId null
    
    IllegalArgumentException - если keyId или keyPacket не находится в корректном формате. Для keyPacket, формат пакетного заголовка проверяется, и тег проверяется, что это имеет ключевой материал типа. Содержание и формат пакетного тела не проверяются.
    
    ClassCastException - если other содержит любые записи, которые не имеют типа XMLStructure
  - newPGPData
```
public abstract PGPData newPGPData(byte[] keyPacket,
                 List other)
```
    Создает a PGPData от указанного пакета материала ключа PGP и дополнительного списка внешних элементов.
    
    Параметры:
    keyPacket - пакет материала ключа PGP как определено в RFC 2440, разделите 5.5. Массив клонируется, чтобы защитить от последующей модификации.
    other - список XMLStructures представление элементов от внешнего пространства имен. Список защитно копируется, чтобы защитить от последующей модификации. Может быть null или пустой.
    
    Возвраты:
    a PGPData
    
    Броски:
    
    NullPointerException - если keyPacket null
    
    IllegalArgumentException - если keyPacket не находится в корректном формате. Для keyPacket, формат пакетного заголовка проверяется, и тег проверяется, что это имеет ключевой материал типа. Содержание и формат пакетного тела не проверяются.
    
    ClassCastException - если other содержит любые записи, которые не имеют типа XMLStructure
  - newRetrievalMethod
```
public abstract RetrievalMethod newRetrievalMethod(String uri)
```
    Создает a RetrievalMethod от указанного URI.
    
    Параметры:
    uri - URI, который идентифицирует KeyInfo информация, которая будет получена
    
    Возвраты:
    a RetrievalMethod
    
    Броски:
    
    NullPointerException - если uri null
    
    IllegalArgumentException - если uri не совместимый RFC 2396
  - newRetrievalMethod
```
public abstract RetrievalMethod newRetrievalMethod(String uri,
                                 String type,
                                 List transforms)
```
    Создает a RetrievalMethod от указанных параметров.
    
    Параметры:
    uri - URI, который идентифицирует KeyInfo информация, которая будет получена
    type - URI, который идентифицирует тип KeyInfo информация, которая будет получена (может быть null)
    transforms - список Transforms. Список защитно копируется, чтобы защитить от последующей модификации. Может быть null или пустой.
    
    Возвраты:
    a RetrievalMethod
    
    Броски:
    
    NullPointerException - если uri null
    
    IllegalArgumentException - если uri не совместимый RFC 2396
    
    ClassCastException - если transforms содержит любые записи, которые не имеют типа Transform
  - newX509Data
```
public abstract X509Data newX509Data(List content)
```
    Создает a X509Data содержа указанный список контента X.509.
    
    Параметры:
    content - список одного или более типов контента X.509. Допустимые типы String (подвергните имена), byte[] (подвергните ключевые идентификаторы), X509Certificate, X509CRL, или XMLStructure (X509IssuerSerial объекты или элементы от внешнего пространства имен). Подчиненные имена являются отличительными именами в Строковом формате RFC 2253. Реализации ДОЛЖНЫ поддерживать ключевые слова типа атрибута, определенные в RFC 2253 (CN, L, ST, O, OU, C, УЛИЦА, DC и UID). Реализации МОГУТ поддерживать дополнительные ключевые слова. Список защитно копируется, чтобы защитить от последующей модификации.
    
    Возвраты:
    a X509Data
    
    Броски:
    
    NullPointerException - если content null
    
    IllegalArgumentException - если content пусто, или если подчиненное имя не является совместимым RFC 2253, или одно из ключевых слов типа атрибута не распознается.
    
    ClassCastException - если content содержит любые записи, которые не имеют одного из допустимых упомянутых выше типов
  - newX509IssuerSerial
```
public abstract X509IssuerSerial newX509IssuerSerial(String issuerName,
                                   BigInteger serialNumber)
```
    Создает X509IssuerSerial от указанного отличительного имени выпускающего X.500 и порядкового номера.
    
    Параметры:
    issuerName - отличительное имя выпускающего в Строковом формате RFC 2253. Реализации ДОЛЖНЫ поддерживать ключевые слова типа атрибута, определенные в RFC 2253 (CN, L, ST, O, OU, C, УЛИЦА, DC и UID). Реализации МОГУТ поддерживать дополнительные ключевые слова.
    serialNumber - порядковый номер
    
    Возвраты:
    X509IssuerSerial
    
    Броски:
    
    NullPointerException - если issuerName или serialNumber null
    
    IllegalArgumentException - если имя выпускающего не является совместимым RFC 2253, или одно из ключевых слов типа атрибута не распознается.
  - isFeatureSupported
```
public abstract boolean isFeatureSupported(String feature)
```
    Указывает, поддерживается ли указанная функция.
    
    Параметры:
    feature - имя функции (как абсолютный URI)
    
    Возвраты:
    true если указанная функция поддерживается, false иначе
    
    Броски:
    
    NullPointerException - если feature null
  - getURIDereferencer
```
public abstract URIDereferencer getURIDereferencer()
```
    Возвращает ссылку на URIDereferencer это используется по умолчанию, чтобы разыменовать URI в RetrievalMethod объекты.
    
    Возвраты:
    ссылка на значение по умолчанию URIDereferencer
  - unmarshalKeyInfo
```
public abstract KeyInfo unmarshalKeyInfo(XMLStructure xmlStructure)
                                  throws MarshalException
```
    Неупорядочивает новое KeyInfo экземпляр от специфичного для механизма XMLStructure (исключая: DOMStructure) экземпляр.
    
    Параметры:
    xmlStructure - специфичная для механизма структура XML, от которой можно неупорядочить keyinfo от
    
    Возвраты:
    KeyInfo
    
    Броски:
    
    NullPointerException - если xmlStructure null
    
    ClassCastException - если тип xmlStructure является несоответствующим для этой фабрики
    
    MarshalException - если неисправимое исключение происходит во время немаршалинга

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс KeyInfoFactory

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

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

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

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

KeyInfoFactory

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

getInstance

getInstance

getInstance

getInstance

getMechanismType

getProvider

newKeyInfo

newKeyInfo

newKeyName

newKeyValue

newPGPData

newPGPData

newPGPData

newRetrievalMethod

newRetrievalMethod

newX509Data

newX509IssuerSerial

isFeatureSupported

getURIDereferencer

unmarshalKeyInfo