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

java.lang. Объект
- java.security.cert. CertificateFactory

```
public class CertificateFactory
extends Object
```
Этот класс определяет функциональность фабрики сертификата, которая используется, чтобы генерировать сертификат, путь сертификации (CertPath) и список аннулированных сертификатов (CRL) возражает от их кодировок.
Для кодировок, состоящих из многократных сертификатов, использовать generateCertificates когда Вы хотите проанализировать набор возможно несвязанных сертификатов. Иначе, использовать generateCertPath когда Вы хотите генерировать a CertPath (цепочка сертификата), и впоследствии проверяют этого с a CertPathValidator.
Фабрика сертификата для X.509 должна возвратить сертификаты, которые являются экземпляром java.security.cert.X509Certificate, и CRL, которые являются экземпляром java.security.cert.X509CRL.
Следующий пример читает файл с Base64 закодированные сертификаты, которые каждый ограничиваются вначале-----, НАЧИНАЮТ СЕРТИФИКАТ-----, и ограниченный в конце СЕРТИФИКАТОМ КОНЦА---------. Мы преобразовываем FileInputStream (который не поддерживает mark и reset) к a BufferedInputStream (который поддерживает те методы), так, чтобы каждый звонок generateCertificate использует только один сертификат, и позиция чтения входного потока располагается в следующий сертификат в файле:
```
 FileInputStream fis = new FileInputStream(filename);
 BufferedInputStream bis = new BufferedInputStream(fis);

 CertificateFactory cf = CertificateFactory.getInstance("X.509");

 while (bis.available() > 0) {
    Certificate cert = cf.generateCertificate(bis);
    System.out.println(cert.toString());
 }
 
```
Следующий пример анализирует PKCS#7-formatted ответ сертификата, сохраненный в файле, и извлекает все сертификаты из него:
```
 FileInputStream fis = new FileInputStream(filename);
 CertificateFactory cf = CertificateFactory.getInstance("X.509");
 Collection c = cf.generateCertificates(fis);
 Iterator i = c.iterator();
 while (i.hasNext()) {
    Certificate cert = (Certificate)i.next();
    System.out.println(cert);
 }
 
```
Каждая реализация платформы Java обязана поддерживать следующий стандарт CertificateFactory введите:
- X.509
и следующий стандарт CertPath кодировки:
- PKCS7
- PkiPath
Тип и кодировки описываются в разделе CertificateFactory и разделе Кодировок CertPath Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java. Консультируйтесь с документацией выпуска для своей реализации, чтобы видеть, поддерживаются ли какие-либо другие типы или кодировки.
С тех пор:

1.2

См. Также:
Certificate, X509Certificate, CertPath, CRL, X509CRL

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

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`CertificateFactory(CertificateFactorySpi certFacSpi, Provider provider, String type)` Создает объект CertificateFactory данного типа, и инкапсулирует данную реализацию провайдера (объект SPI) в этом.

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

Методы
Модификатор и Тип	Метод и Описание
`Сертификат`	`generateCertificate(InputStream inStream)` Генерирует объект сертификата и инициализирует это с данными, считанными из входного потока `inStream`.
`Collection<? extends Certificate>`	`generateCertificates(InputStream inStream)` Возвращается (возможно пустой) представление набора сертификатов, считанных из данного входного потока `inStream`.
`CertPath`	`generateCertPath(InputStream inStream)` Генерирует a `CertPath` возразите и инициализирует это с данными, считанными из `InputStream` inStream.
`CertPath`	`generateCertPath(InputStream inStream, String encoding)` Генерирует a `CertPath` возразите и инициализирует это с данными, считанными из `InputStream` inStream.
`CertPath`	`generateCertPath(List<? extends Certificate> certificates)` Генерирует a `CertPath` возразите и инициализирует это с a `List` из `Certificate`s.
`CRL`	`generateCRL(InputStream inStream)` Генерирует список аннулированных сертификатов объект (CRL) и инициализирует это с данными, считанными из входного потока `inStream`.
`Collection<? extends CRL>`	`generateCRLs(InputStream inStream)` Возвращается (возможно пустой) представление набора CRL, считанных из данного входного потока `inStream`.
`Iterator<String>`	`getCertPathEncodings()` Возвращает итерацию `CertPath` кодировки, поддерживаемые этой фабрикой сертификата, с кодировкой по умолчанию сначала.
`static CertificateFactory`	`getInstance(String type)` Возвращается фабрика сертификата возражают, что реализует указанный тип сертификата.
`static CertificateFactory`	`getInstance(String type, Provider provider)` Возвращает объект фабрики сертификата для указанного типа сертификата.
`static CertificateFactory`	`getInstance(String type, String provider)` Возвращает объект фабрики сертификата для указанного типа сертификата.
`Провайдер`	`getProvider()` Возвращает провайдера этой фабрики сертификата.
`Строка`	`getType()` Возвращает имя типа сертификата, связанного с этой фабрикой сертификата.

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

- Деталь конструктора
  - CertificateFactory
```
protected CertificateFactory(CertificateFactorySpi certFacSpi,
                  Provider provider,
                  String type)
```
    Создает объект CertificateFactory данного типа, и инкапсулирует данную реализацию провайдера (объект SPI) в этом.
    
    Параметры:
    certFacSpi - реализация провайдера.
    provider - провайдер.
    type - тип сертификата.
- Деталь метода
  - getInstance
```
public static final CertificateFactory getInstance(String type)
                                            throws CertificateException
```
    Возвращается фабрика сертификата возражают, что реализует указанный тип сертификата.
    Этот метод пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект CertificateFactory инкапсуляция реализации CertificateFactorySpi от первого Провайдера, который поддерживает указанный тип.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    
    Параметры:
    type - имя требуемого типа сертификата. См. раздел CertificateFactory в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных типах сертификата.
    
    Возвраты:
    фабрика сертификата возражает для указанного типа.
    
    Броски:
    
    CertificateException - если никакой Провайдер не поддерживает реализацию CertificateFactorySpi для указанного типа.
    См. Также:
    Provider
  - getInstance
```
public static final CertificateFactory getInstance(String type,
                             String provider)
                                            throws CertificateException,
                                                   NoSuchProviderException
```
    Возвращает объект фабрики сертификата для указанного типа сертификата.
    Возвращается новый объект CertificateFactory инкапсуляция реализации CertificateFactorySpi от указанного провайдера. Указанный провайдер должен быть зарегистрирован в списке поставщика систем обеспечения безопасности.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    
    Параметры:
    type - тип сертификата. См. раздел CertificateFactory в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных типах сертификата.
    provider - имя провайдера.
    
    Возвраты:
    фабрика сертификата возражает для указанного типа.
    
    Броски:
    
    CertificateException - если реализация CertificateFactorySpi для указанного алгоритма не доступна от указанного провайдера.
    
    NoSuchProviderException - если указанный провайдер не регистрируется в списке поставщика систем обеспечения безопасности.
    
    IllegalArgumentException - если имя провайдера является нулем или пустой.
    См. Также:
    Provider
  - getInstance
```
public static final CertificateFactory getInstance(String type,
                             Provider provider)
                                            throws CertificateException
```
    Возвращает объект фабрики сертификата для указанного типа сертификата.
    Возвращается новый объект CertificateFactory инкапсуляция реализации CertificateFactorySpi от указанного объекта Провайдера. Отметьте, что указанный объект Провайдера не должен быть зарегистрирован в списке провайдера.
    
    Параметры:
    type - тип сертификата. См. раздел CertificateFactory в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных типах сертификата.
    provider - провайдер.
    
    Возвраты:
    фабрика сертификата возражает для указанного типа.
    
    Броски:
    
    CertificateException - если реализация CertificateFactorySpi для указанного алгоритма не доступна от указанного объекта Провайдера.
    
    IllegalArgumentException - если provider нуль.
    С тех пор:
    
    1.4
    
    См. Также:
    Provider
  - getProvider
```
public final Provider getProvider()
```
    Возвращает провайдера этой фабрики сертификата.
    
    Возвраты:
    провайдер этой фабрики сертификата.
  - getType
```
public final String getType()
```
    Возвращает имя типа сертификата, связанного с этой фабрикой сертификата.
    
    Возвраты:
    имя типа сертификата связалось с этой фабрикой сертификата.
  - generateCertificate
```
public final Certificate generateCertificate(InputStream inStream)
                                      throws CertificateException
```
    Генерирует объект сертификата и инициализирует это с данными, считанными из входного потока inStream.
    Чтобы использовать в своих интересах специализированный формат сертификата, поддерживаемый этой фабрикой сертификата, возвращенный объект сертификата может быть преобразован тип к соответствующему классу сертификата. Например, если эта фабрика сертификата реализует сертификаты X.509, возвращенный объект сертификата может быть преобразован тип к X509Certificate класс.
    В случае фабрики сертификата для сертификатов X.509, сертификат, обеспеченный в inStream должен быть DER-закодирован и может быть предоставлен в двоичном или печатаемом (Base64) кодирование. Если сертификат обеспечивается в кодировании Base64, он должен быть ограничен вначале-----, НАЧИНАЮТ СЕРТИФИКАТ-----, и должен быть ограничен в конце СЕРТИФИКАТОМ КОНЦА---------.
    Отметьте это, если данный входной поток не поддерживает mark и reset, этот метод использует весь входной поток. Иначе, каждый звонок в этот метод использует один сертификат, и позиция чтения входного потока располагается в следующий доступный байт после свойственного маркера конца сертификата. Если данные во входном потоке не содержат свойственный маркер конца сертификата (кроме EOF) и там запаздывают данные после того, как сертификат анализируется, a CertificateException бросается.
    
    Параметры:
    inStream - входной поток с данными сертификата.
    
    Возвраты:
    объект сертификата инициализируется с данными от входного потока.
    
    Броски:
    
    CertificateException - при парсинге ошибок.
  - getCertPathEncodings
```
public final Iterator<String> getCertPathEncodings()
```
    Возвращает итерацию CertPath кодировки, поддерживаемые этой фабрикой сертификата, с кодировкой по умолчанию сначала. См. раздел Кодировок CertPath в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах кодирования и их форматах.
    Попытки изменить возвращенный Iterator через remove результат метода в UnsupportedOperationException.
    
    Возвраты:
    Iterator по именам поддерживаемого CertPath кодировки (как Strings)
    С тех пор:
    
    1.4
  - generateCertPath
```
public final CertPath generateCertPath(InputStream inStream)
                                throws CertificateException
```
    Генерирует a CertPath возразите и инициализирует это с данными, считанными из InputStream inStream. Данные, как предполагается, находятся в кодировке по умолчанию. Имя кодировки по умолчанию является первым элементом Iterator возвращенный getCertPathEncodings метод.
    
    Параметры:
    inStream - InputStream содержа данные
    
    Возвраты:
    a CertPath инициализированный с данными от InputStream
    
    Броски:
    
    CertificateException - если исключение происходит, декодируя
    С тех пор:
    
    1.4
  - generateCertPath
```
public final CertPath generateCertPath(InputStream inStream,
                        String encoding)
                                throws CertificateException
```
    Генерирует a CertPath возразите и инициализирует это с данными, считанными из InputStream inStream. Данные, как предполагается, находятся в указанном кодировании. См. раздел Кодировок CertPath в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах кодирования и их форматах.
    
    Параметры:
    inStream - InputStream содержа данные
    encoding - кодирование используется для данных
    
    Возвраты:
    a CertPath инициализированный с данными от InputStream
    
    Броски:
    
    CertificateException - если исключение происходит, декодируя, или кодирование, которое требуют, не поддерживается
    С тех пор:
    
    1.4
  - generateCertPath
```
public final CertPath generateCertPath(List<? extends Certificate> certificates)
                                throws CertificateException
```
    Генерирует a CertPath возразите и инициализирует это с a List из Certificates.
    Предоставленные сертификаты должны иметь тип, поддерживаемый CertificateFactory. Они будут скопированы из предоставленного List объект.
    
    Параметры:
    certificates - a List из Certificates
    
    Возвраты:
    a CertPath инициализированный с предоставленным списком сертификатов
    
    Броски:
    
    CertificateException - если исключение происходит
    С тех пор:
    
    1.4
  - generateCertificates
```
public final Collection<? extends Certificate> generateCertificates(InputStream inStream)
                                                             throws CertificateException
```
    Возвращается (возможно пустой) представление набора сертификатов, считанных из данного входного потока inStream.
    Чтобы использовать в своих интересах специализированный формат сертификата, поддерживаемый этой фабрикой сертификата, каждый элемент в возвращенном представлении набора может быть преобразован тип к соответствующему классу сертификата. Например, если эта фабрика сертификата реализует сертификаты X.509, элементы в возвращенном наборе могут быть преобразованы тип к X509Certificate класс.
    В случае фабрики сертификата для сертификатов X.509, inStream может содержать последовательность DER-закодированных сертификатов в форматах, описанных для generateCertificate. Кроме того, inStream может содержать PKCS#7 цепочка сертификата. Это PKCS#7 объект SignedData с единственным существенным полем, являющимся сертификатами. В частности подпись и содержание игнорируются. Этот формат позволяет многократным сертификатам быть загруженными сразу. Если никакие сертификаты не присутствуют, пустой набор возвращается.
    Отметьте это, если данный входной поток не поддерживает mark и reset, этот метод использует весь входной поток.
    
    Параметры:
    inStream - входной поток с сертификатами.
    
    Возвраты:
    (возможно пустой) представление набора java.security.cert. Объекты сертификата инициализируются с данными от входного потока.
    
    Броски:
    
    CertificateException - при парсинге ошибок.
  - generateCRL
```
public final CRL generateCRL(InputStream inStream)
                      throws CRLException
```
    Генерирует список аннулированных сертификатов объект (CRL) и инициализирует это с данными, считанными из входного потока inStream.
    Чтобы использовать в своих интересах специализированный формат CRL, поддерживаемый этой фабрикой сертификата, возвращенный объект CRL может быть преобразован тип к соответствующему классу CRL. Например, если эта фабрика сертификата реализует CRL X.509, возвращенный объект CRL может быть преобразован тип к X509CRL класс.
    Отметьте это, если данный входной поток не поддерживает mark и reset, этот метод использует весь входной поток. Иначе, каждый звонок в этот метод использует один CRL, и позиция чтения входного потока располагается в следующий доступный байт после свойственного маркера конца CRL. Если данные во входном потоке не содержат свойственный маркер конца CRL (кроме EOF) и там запаздывают данные после того, как CRL анализируется, a CRLException бросается.
    
    Параметры:
    inStream - входной поток с данными CRL.
    
    Возвраты:
    объект CRL инициализируется с данными от входного потока.
    
    Броски:
    
    CRLException - при парсинге ошибок.
  - generateCRLs
```
public final Collection<? extends CRL> generateCRLs(InputStream inStream)
                                             throws CRLException
```
    Возвращается (возможно пустой) представление набора CRL, считанных из данного входного потока inStream.
    Чтобы использовать в своих интересах специализированный формат CRL, поддерживаемый этой фабрикой сертификата, каждый элемент в возвращенном представлении набора может быть преобразован тип к соответствующему классу CRL. Например, если эта фабрика сертификата реализует CRL X.509, элементы в возвращенном наборе могут быть преобразованы тип к X509CRL класс.
    В случае фабрики сертификата для CRL X.509, inStream может содержать последовательность DER-закодированных CRL. Кроме того, inStream может содержать PKCS#7 набор CRL. Это PKCS#7 объект SignedData с единственным существенным полем, являющимся crls. В частности подпись и содержание игнорируются. Этот формат позволяет многократным CRL быть загруженными сразу. Если никакие CRL не присутствуют, пустой набор возвращается.
    Отметьте это, если данный входной поток не поддерживает mark и reset, этот метод использует весь входной поток.
    
    Параметры:
    inStream - входной поток с CRL.
    
    Возвраты:
    (возможно пустой) представление набора java.security.cert. Объекты CRL инициализируются с данными от входного потока.
    
    Броски:
    
    CRLException - при парсинге ошибок.

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

Класс CertificateFactory

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

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

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

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

CertificateFactory

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

getInstance

getInstance

getInstance

getProvider

getType

generateCertificate

getCertPathEncodings

generateCertPath

generateCertPath

generateCertPath

generateCertificates

generateCRL

generateCRLs