compact1, compact2, compact3

java.security.cert

Класс CertPath

java.lang. Объект

java.security.cert. CertPath

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

Сериализуемый

public abstract class CertPath
extends Object
implements Serializable

Неизменная последовательность сертификатов (путь сертификации).

Это - абстрактный class, который определяет методы, характерные для всех CertPaths. Подклассы могут обработать различные виды сертификатов (X.509, PGP, и т.д.).

Все CertPath у объектов есть тип, список Certificates, и один или более поддерживаемые кодировки. Поскольку CertPath class является неизменным, a CertPath не может измениться никаким внешне видимым способом, будучи созданным. Это соглашение применяется ко всем общедоступным полям и методам этого class, и любой добавил или переопределенный подклассами.

Тип является 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 объекты должны быть ориентированы на многопотоковое исполнение. Таким образом, многократные потоки могут одновременно вызвать методы, определенные в этом class на сингле CertPath объект (или больше чем один) без вредных воздействий. Это - также истина для List возвращенный CertPath.getCertificates.

Требование CertPath объекты быть неизменным и ориентированный на многопотоковое исполнение позволяют им быть розданными к различным частям кода, не волнуясь о координировании доступа. Обеспечение этой потокобезопасности является обычно не трудным, начиная с CertPath и List рассматриваемые объекты являются неизменными.

С тех пор:

1.4

См. Также:

CertificateFactory, CertPathBuilder, Сериализированная Форма

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

Вложенные Классы

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

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

Конструкторы

Модификатор	Конструктор и Описание
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() Возвращает тип Certificates в этом пути сертификации.
int	hashCode() Возвращает хэш-код для этого пути сертификации.
Строка	toString() Возвращает строковое представление этого пути сертификации.
protected Object	writeReplace() Замены CertPath быть сериализированным с a CertPathRep объект.

Методы, наследованные от class 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 в class 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 в class Object

Возвраты:

значение хэш-кода для этого пути сертификации

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Возвращает строковое представление этого пути сертификации. Это вызывает toString метод на каждом из Certificates в пути.

Переопределения:

toString в class 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 объект, представляющий этот путь сертификации, не мог быть создан