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

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

Все Реализованные Интерфейсы:

Сериализуемый
```
public abstract class CertPath
extends Object
implements Serializable
```
Неизменная последовательность сертификатов (путь сертификации).
Это - абстрактный класс, который определяет методы, характерные для всех CertPaths. Подклассы могут обработать различные виды сертификатов (X.509, PGP, и т.д.).
Все CertPath у объектов есть тип, список Certificates, и один или более поддерживаемые кодировки. Поскольку CertPath класс является неизменным, a CertPath не может измениться никаким внешне видимым способом, будучи созданным. Это соглашение применяется ко всем общедоступным полям и методам этого класса, и любой добавил или переопределенный подклассами.
Тип является a String это идентифицирует тип Certificates в пути сертификации. Для каждого сертификата cert в пути сертификации certPath, cert.getType().equals(certPath.getType()) должен быть true.
Список Certificates является упорядоченным List из нуля или больше Certificates. Это List и весь из Certificates содержавшийся в этом должно быть неизменным.
Каждый CertPath объект должен поддерживать одни или более кодировок так, чтобы объект мог быть преобразован в байтовый массив для хранения или передачи к другим сторонам. Предпочтительно, эти кодировки должны быть хорошо задокументированными стандартами (такой как PKCS#7). Одни из кодировок поддерживаются a CertPath считается кодировкой по умолчанию. Это кодирование используется, если никакое кодирование явно не требуют (для getEncoded() метод, например).
Все CertPath объекты также Serializable. CertPath объекты разрешаются в альтернативу CertPathRep объект во время сериализации. Это позволяет a CertPath объект, который будет сериализирован в эквивалентное представление независимо от его базовой реализации.
CertPath объекты могут быть созданы с a CertificateFactory или они могут быть возвращены другими классами, такими как a CertPathBuilder.
Условно, X.509 CertPaths (состоящий из X509Certificates), упорядочиваются, запускаясь с целевого сертификата и заканчиваясь сертификатом, выпущенным доверительной привязкой. Таким образом, выпускающий одного сертификата является предметом следующего. Сертификат, представляющий TrustAnchor не должен быть включен в путь сертификации. Непроверенный X.509 CertPaths, возможно, не следует за этими соглашениями. PKIX CertPathValidators обнаружит любое отклонение от этих соглашений, которые заставляют путь сертификации быть недопустимым и бросить a CertPathValidatorException.
Каждая реализация платформы Java обязана поддерживать следующий стандарт CertPath кодировки:
- PKCS7
- PkiPath
Эти кодировки описываются в разделе Кодировок CertPath Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java. Консультируйтесь с документацией выпуска для своей реализации, чтобы видеть, поддерживаются ли какие-либо другие кодировки.
Параллельный Доступ
Все CertPath объекты должны быть ориентированы на многопотоковое исполнение. Таким образом, многократные потоки могут одновременно вызвать методы, определенные в этом классе на сингле CertPath объект (или больше чем один) без вредных воздействий. Это - также истина для List возвращенный CertPath.getCertificates.
Требование CertPath объекты быть неизменным и ориентированный на многопотоковое исполнение позволяют им быть розданными к различным частям кода, не волнуясь о координировании доступа. Обеспечение этой потокобезопасности является обычно не трудным, начиная с CertPath и List рассматриваемые объекты являются неизменными.
С тех пор:

1.4

См. Также:
CertificateFactory, CertPathBuilder, Сериализированная Форма

Вложенная Сводка Класса

Вложенные Классы
Модификатор и Тип	Класс и Описание
`protected static class`	`CertPath. CertPathRep` Альтернатива `CertPath` класс для сериализации.

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

Конструкторы
Модификатор Конструктор и Описание

protected CertPath(String type)
Создает a CertPath из указанного типа.

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`CertPath(String type)` Создает a `CertPath` из указанного типа.

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

Методы
Модификатор и Тип	Метод и Описание
`boolean`	`equals(Object other)` Сравнивает этот путь сертификации для равенства с указанным объектом.
`abstract List<? extends Certificate>`	`getCertificates()` Возвращает список сертификатов в этом пути сертификации.
`abstract byte[]`	`getEncoded()` Возвращает закодированную форму этого пути сертификации, используя кодировку по умолчанию.
`abstract byte[]`	`getEncoded(String encoding)` Возвращает закодированную форму этого пути сертификации, используя указанное кодирование.
`abstract Iterator<String>`	`getEncodings()` Возвращает итерацию кодировок, поддерживаемых этим путем сертификации, с кодировкой по умолчанию сначала.
`Строка`	`getType()` Возвращает тип `Certificate`s в этом пути сертификации.
`int`	`hashCode()` Возвращает хэш-код для этого пути сертификации.
`Строка`	`toString()` Возвращает строковое представление этого пути сертификации.
`protected Object`	`writeReplace()` Замены `CertPath` быть сериализированным с a `CertPathRep` объект.

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

- Деталь конструктора
  - CertPath
```
protected CertPath(String type)
```
    Создает a CertPath из указанного типа.
    Этот конструктор защищается, потому что большинство пользователей должно использовать a CertificateFactory создать CertPaths.
    
    Параметры:
    type - стандартное имя типа Certificates в этом пути
- Деталь метода
  - getType
```
public String getType()
```
    Возвращает тип Certificates в этом пути сертификации. Это - та же самая строка, которая была бы возвращена cert.getType() для всех Certificates в пути сертификации.
    
    Возвраты:
    тип Certificates в этом пути сертификации (никогда нуль)
  - getEncodings
```
public abstract Iterator<String> getEncodings()
```
    Возвращает итерацию кодировок, поддерживаемых этим путем сертификации, с кодировкой по умолчанию сначала. Попытки изменить возвращенный Iterator через remove результат метода в UnsupportedOperationException.
    
    Возвраты:
    Iterator по именам поддерживаемых кодировок (как Строки)
  - равняется
```
public boolean equals(Object other)
```
    Сравнивает этот путь сертификации для равенства с указанным объектом. Два CertPaths равны, если и только если их типы равны и их сертификат Lists (и косвенно Certificates в тех Lists) равны. A CertPath никогда не равно объекту, который не является a CertPath.
    Этот алгоритм реализуется этим методом. Если это переопределяется, поведение, определенное здесь, должно сохраняться.
    
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    other - объект протестировать на равенство с этим путем сертификации
    
    Возвраты:
    истина, если указанный объект равен этому пути сертификации, ложь иначе
    См. Также:
    Object.hashCode(), HashMap
  - хэш-код
```
public int hashCode()
```
    Возвращает хэш-код для этого пути сертификации. Хэш-код пути сертификации определяется, чтобы быть результатом следующего вычисления:
```
  hashCode = path.getType().hashCode();
  hashCode = 31*hashCode + path.getCertificates().hashCode();
 
```
    Это гарантирует это path1.equals(path2) подразумевает это path1.hashCode()==path2.hashCode() для любых двух путей сертификации, path1 и path2, как требуется согласно общему контракту Object.hashCode.
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    значение хэш-кода для этого пути сертификации
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    Возвращает строковое представление этого пути сертификации. Это вызывает toString метод на каждом из Certificates в пути.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    строковое представление этого пути сертификации
  - getEncoded
```
public abstract byte[] getEncoded()
                           throws CertificateEncodingException
```
    Возвращает закодированную форму этого пути сертификации, используя кодировку по умолчанию.
    
    Возвраты:
    закодированные байты
    
    Броски:
    
    CertificateEncodingException - если ошибка кодирования происходит
  - getEncoded
```
public abstract byte[] getEncoded(String encoding)
                           throws CertificateEncodingException
```
    Возвращает закодированную форму этого пути сертификации, используя указанное кодирование.
    
    Параметры:
    encoding - имя кодирования, чтобы использовать
    
    Возвраты:
    закодированные байты
    
    Броски:
    
    CertificateEncodingException - если ошибка кодирования происходит, или кодирование, которое требуют, не поддерживается
  - getCertificates
```
public abstract List<? extends Certificate> getCertificates()
```
    Возвращает список сертификатов в этом пути сертификации. List возвращенный должно быть неизменным и ориентированным на многопотоковое исполнение.
    
    Возвраты:
    неизменное List из Certificates (может быть пустым, но не нулевым),
  - writeReplace
```
protected Object writeReplace()
                       throws ObjectStreamException
```
    Замены CertPath быть сериализированным с a CertPathRep объект.
    
    Возвраты:
    CertPathRep быть сериализированным
    
    Броски:
    
    ObjectStreamException - если a CertPathRep объект, представляющий этот путь сертификации, не мог быть создан

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

Класс CertPath

Вложенная Сводка Класса

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

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

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

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

CertPath

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

getType

getEncodings

равняется

хэш-код

toString

getEncoded

getEncoded

getCertificates

writeReplace