Spec-Zone.ru › OpenJDK 25

Интерфейс KeyValue

Все суперинтерфейсы:
XMLStructure
public interface KeyValue extends XMLStructure
Представление элемента XML KeyValue, определённого в Рекомендации W3C по синтаксису и обработке XML-подписи. Объект KeyValue содержит один открытый ключ, который может быть полезен для проверки подписи. Определение схемы XML:
   <element name="KeyValue" type="ds:KeyValueType"/>
   <complexType name="KeyValueType" mixed="true">
     <choice>
       <element ref="ds:DSAKeyValue"/>
       <element ref="ds:RSAKeyValue"/>
       <!-- <element ref="dsig11:ECKeyValue"/> -->
       <!-- ECC keys (XMLDsig 1.1) will use the any element -->
       <any namespace="##other" processContents="lax"/>
     </choice>
   </complexType>

   <element name="DSAKeyValue" type="ds:DSAKeyValueType"/>
   <complexType name="DSAKeyValueType">
     <sequence>
       <sequence minOccurs="0">
         <element name="P" type="ds:CryptoBinary"/>
         <element name="Q" type="ds:CryptoBinary"/>
       </sequence>
       <element name="G" type="ds:CryptoBinary" minOccurs="0"/>
       <element name="Y" type="ds:CryptoBinary"/>
       <element name="J" type="ds:CryptoBinary" minOccurs="0"/>
       <sequence minOccurs="0">
         <element name="Seed" type="ds:CryptoBinary"/>
         <element name="PgenCounter" type="ds:CryptoBinary"/>
       </sequence>
     </sequence>
   </complexType>

   <element name="RSAKeyValue" type="ds:RSAKeyValueType"/>
   <complexType name="RSAKeyValueType">
     <sequence>
       <element name="Modulus" type="ds:CryptoBinary"/>
       <element name="Exponent" type="ds:CryptoBinary"/>
     </sequence>
   </complexType>

   <complexType name="ECKeyValueType">
     <sequence>
       <choice>
         <element name="ECParameters" type="dsig11:ECParametersType" />
         <element name="NamedCurve" type="dsig11:NamedCurveType" />
       </choice>
       <element name="PublicKey" type="dsig11:ECPointType" />
     </sequence>
     <attribute name="Id" type="ID" use="optional" />
   </complexType>

   <complexType name="NamedCurveType">
     <attribute name="URI" type="anyURI" use="required" />
   </complexType>

   <simpleType name="ECPointType">
     <restriction base="ds:CryptoBinary" />
   </simpleType>
Определение ECParametersType см. в разделе 4.5.2.3.1 Рекомендации W3C.

Экземпляр KeyValue можно создать, вызвав метод newKeyValue класса KeyInfoFactory и передав ему PublicKey, представляющий значение открытого ключа. Ниже приведён пример создания KeyValue на основе DSAPublicKey из Certificate, хранящегося в KeyStore:

KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
PublicKey dsaPublicKey = keyStore.getCertificate("myDSASigningCert").getPublicKey();
KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM");
KeyValue keyValue = factory.newKeyValue(dsaPublicKey);
Этот класс возвращает элементы DSAKeyValue и RSAKeyValue как объекты типов DSAPublicKey и RSAPublicKey соответственно. Обратите внимание, что не все поля схемы доступны в качестве параметров этих типов.
С момента выпуска:
1.6
См. также:
  • KeyInfoFactory.newKeyValue(PublicKey)

Краткое описание полей

Модификатор и тип Поле Описание
static final String DSA_TYPE
URI, идентифицирующий тип KeyInfo DSA KeyValue: http://www.w3.org/2000/09/xmldsig#DSAKeyValue.
static final String EC_TYPE
URI, идентифицирующий тип KeyInfo EC KeyValue: http://www.w3.org/2009/xmldsig11#ECKeyValue.
static final String RSA_TYPE
URI, идентифицирующий тип KeyInfo RSA KeyValue: http://www.w3.org/2000/09/xmldsig#RSAKeyValue.

Краткое описание методов

Модификатор и тип Метод Описание
PublicKey getPublicKey()
Возвращает открытый ключ этого KeyValue.

Методы, объявленные в интерфейсе XMLStructure

isFeatureSupported

Подробное описание полей

DSA_TYPE

static final String DSA_TYPE
URI, идентифицирующий тип KeyInfo DSA KeyValue: http://www.w3.org/2000/09/xmldsig#DSAKeyValue. Его можно указать в качестве значения параметра type класса RetrievalMethod для описания удалённой структуры DSAKeyValue.
См. также:
  • Значения константных полей

RSA_TYPE

static final String RSA_TYPE
URI, идентифицирующий тип KeyInfo RSA KeyValue: http://www.w3.org/2000/09/xmldsig#RSAKeyValue. Его можно указать в качестве значения параметра type класса RetrievalMethod для описания удалённой структуры RSAKeyValue.
См. также:
  • Значения константных полей

EC_TYPE

static final String EC_TYPE
URI, идентифицирующий тип KeyInfo EC KeyValue: http://www.w3.org/2009/xmldsig11#ECKeyValue. Его можно указать в качестве значения параметра type класса RetrievalMethod для описания удалённой структуры ECKeyValue.
С момента выпуска:
13
См. также:
  • Значения константных полей

Подробное описание методов

getPublicKey

PublicKey getPublicKey() throws KeyException
Возвращает открытый ключ этого KeyValue.
Возвращает:
открытый ключ этого KeyValue
Выбрасывает:
KeyException — если этот KeyValue нельзя преобразовать в PublicKey

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, включая концептуальные обзоры, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.xml.crypto/javax/xml/crypto/dsig/keyinfo/KeyValue.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API