Spec-Zone.ru › OpenJDK 21

Класс XMLConstants

java.lang.Object
javax.xml.XMLConstants
public final class XMLConstants extends Object
Определяет константы для API обработки XML.

Внешние свойства доступа

Значение внешних свойств доступа, включая ACCESS_EXTERNAL_DTD, ACCESS_EXTERNAL_SCHEMA и ACCESS_EXTERNAL_STYLESHEET, определяется следующим образом.

Значение:

Список протоколов, разделенных запятыми. Протокол — это схема части URI, или в случае протокола JAR, «jar» плюс часть схемы, разделенная двоеточием. Схема определяется следующим образом:
схема = буква *( буква | цифра | «+» | «-» | «.» )
где буква = a-z и A-Z.

И протокол JAR:
jar[:схема]

Протоколы, включающие ключевое слово «jar», нечувствительны к регистру. Любые пробелы, определенные Character.isSpaceChar(char) в значении, будут игнорироваться. Примеры протоколов: file, http, jar:file.

Значение по умолчанию:

Значение по умолчанию зависит от реализации и поэтому не указано. Рассматриваются следующие варианты:
  • пустая строка для отказа от доступа ко всем внешним ссылкам;
  • конкретный протокол, например, file, для предоставления разрешения только для этого протокола;
  • ключевое слово «all» для предоставления разрешения всем протоколам.

При включенном FEATURE_SECURE_PROCESSING рекомендуется, чтобы реализации по умолчанию ограничивали внешние соединения, хотя это может вызвать проблемы для приложений, обрабатывающих XML/XSD/XSL с внешними ссылками.

Предоставление всех прав доступа:

Ключевое слово «all» предоставляет разрешение на все протоколы.

Порядок приоритета свойств

Свойства, включая Внешние свойства доступа и USE_CATALOG, могут быть заданы из нескольких источников конфигурации. Они следуют процессу конфигурации, определенному в разделе Конфигурация в резюме модуля.
С:
1.5
См. также:
  • Extensible Markup Language (XML) 1.1
  • Extensible Markup Language (XML) 1.0 (Второе издание)
  • Исправления спецификации XML 1.0 Второго издания
  • Пространства имен в XML 1.1
  • Пространства имен в XML
  • XML Schema Часть 1: Структуры

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

Модификатор и тип Поле Описание
static final String ACCESS_EXTERNAL_DTD
Свойство: accessExternalDTD
static final String ACCESS_EXTERNAL_SCHEMA
Свойство: accessExternalSchema
static final String ACCESS_EXTERNAL_STYLESHEET
Свойство: accessExternalStylesheet
static final String DEFAULT_NS_PREFIX
Префикс для представления стандартного пространства имен XML.
static final String FEATURE_SECURE_PROCESSING
Функция для безопасной обработки.
static final String NULL_NS_URI
URI пространства имен, используемый для представления отсутствия пространства имен.
static final String RELAXNG_NS_URI
URI пространства имен RELAX NG.
static final String USE_CATALOG
Функция: useCatalog
static final String W3C_XML_SCHEMA_INSTANCE_NS_URI
URI пространства имен экземпляра W3C XML Schema.
static final String W3C_XML_SCHEMA_NS_URI
URI пространства имен W3C XML Schema.
static final String W3C_XPATH_DATATYPE_NS_URI
URI пространства имен типов данных W3C XPath.
static final String XML_DTD_NS_URI
URI пространства имен объявления типа документа XML в качестве произвольного значения.
static final String XML_NS_PREFIX
Официальный префикс пространства имен XML.
static final String XML_NS_URI
Официальный URI пространства имен XML.
static final String XMLNS_ATTRIBUTE
Официальное атрибут XML, используемый для указания деклараций пространств имен XML.
static final String XMLNS_ATTRIBUTE_NS_URI
Официальное атрибут XML, используемый для указания деклараций пространств имен XML, XMLConstants.XMLNS_ATTRIBUTE, URI имени пространства имен.

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

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

NULL_NS_URI

public static final String NULL_NS_URI
Пространство имён URI, используемое для обозначения отсутствия пространства имён.

Определено спецификацией пространства имён как "".

См. также:
  • Пространства имён в XML, 5.2 Назначение по умолчанию
  • Значения константных полей

DEFAULT_NS_PREFIX

public static final String DEFAULT_NS_PREFIX
Префикс, используемый для обозначения пространства имён XML по умолчанию.

Определено спецификацией XML как "".

См. также:
  • Пространства имён в XML, 3. Квалифицированные имена
  • Значения константных полей

XML_NS_URI

public static final String XML_NS_URI
Официальное URI пространства имён XML.

Определено спецификацией XML как "http://www.w3.org/XML/1998/namespace".

См. также:
  • Пространства имён в XML, 3. Квалифицированные имена
  • Значения константных полей

XML_NS_PREFIX

public static final String XML_NS_PREFIX
Официальный префикс пространства имён XML.

Определено спецификацией XML как "xml".

См. также:
  • Пространства имён в XML, 3. Квалифицированные имена
  • Значения константных полей

XMLNS_ATTRIBUTE_NS_URI

public static final String XMLNS_ATTRIBUTE_NS_URI
Официальное атрибут XML, используемый для указания объявлений пространств имён XML, XMLConstants.XMLNS_ATTRIBUTE, URI имени пространства имён.

Определено спецификацией XML как "http://www.w3.org/2000/xmlns/".

См. также:
  • Пространства имён в XML, 3. Квалифицированные имена
  • Значения константных полей

XMLNS_ATTRIBUTE

public static final String XMLNS_ATTRIBUTE
Официальный атрибут XML, используемый для указания объявлений пространств имён XML.

Использование в качестве префикса не допускается. Определено спецификацией XML как "xmlns".

См. также:
  • Пространства имён в XML, 3. Квалифицированные имена
  • Значения константных полей

W3C_XML_SCHEMA_NS_URI

public static final String W3C_XML_SCHEMA_NS_URI
URI пространства имён W3C XML Schema.

Определено как "http://www.w3.org/2001/XMLSchema".

См. также:
  • XML Schema Part 1: Structures, 2.6 Разметка, относящаяся к схеме, в документах, которые проверяются
  • Значения константных полей

W3C_XML_SCHEMA_INSTANCE_NS_URI

public static final String W3C_XML_SCHEMA_INSTANCE_NS_URI
URI пространства имён экземпляра W3C XML Schema.

Определено как "http://www.w3.org/2001/XMLSchema-instance".

См. также:
  • XML Schema Part 1: Structures, 2.6 Разметка, относящаяся к схеме, в документах, которые проверяются
  • Значения константных полей

W3C_XPATH_DATATYPE_NS_URI

public static final String W3C_XPATH_DATATYPE_NS_URI
URI пространства имён типов данных W3C XPath.

Определено как "http://www.w3.org/2003/11/xpath-datatypes".

См. также:
  • Модель данных XQuery 1.0 и XPath 2.0
  • Значения константных полей

XML_DTD_NS_URI

public static final String XML_DTD_NS_URI
URI пространства имён XML объявления типа документа, как произвольное значение.

Поскольку это не формально определено никаким существующим стандартом, произвольно определено как "http://www.w3.org/TR/REC-xml".

См. также:
  • Значения константных полей

RELAXNG_NS_URI

public static final String RELAXNG_NS_URI
URI пространства имён RELAX NG.

Определено как "http://relaxng.org/ns/structure/1.0".

См. также:
  • Спецификация RELAX NG
  • Значения константных полей

FEATURE_SECURE_PROCESSING

public static final String FEATURE_SECURE_PROCESSING
Функция для безопасной обработки.
  • true указывает реализации обрабатывать XML безопасно. Это может установить ограничения на XML-конструкции, чтобы избежать условий, таких как атаки типа "отказ в обслуживании".
  • false указывает реализации обрабатывать XML в соответствии со спецификациями XML, игнорируя вопросы безопасности, такие как ограничения на XML-конструкции для предотвращения условий, таких как атаки типа "отказ в обслуживании".
Примечание для реализации:
при наличии Java Security Manager JDK устанавливает значение этого параметра в true и не позволяет его отключить.
См. также:
  • Значения константных полей

ACCESS_EXTERNAL_DTD

public static final String ACCESS_EXTERNAL_DTD
Свойство: accessExternalDTD

Ограничить доступ к внешним DTD и внешним ссылкам сущностей протоколами, указанными в. Если доступ запрещен из-за ограничения этого свойства, будет брошено исключение времени выполнения, специфичное для контекста. В случае SAXParser, например, будет брошено SAXException.

Значение: как определено в описании класса.

Система свойств: javax.xml.accessExternalDTD.

Файл конфигурации: Да. Свойство можно задать в файле конфигурации.

С тех пор:
1.7
См. также:
  • Значения константных полей

ACCESS_EXTERNAL_SCHEMA

public static final String ACCESS_EXTERNAL_SCHEMA

Свойство: accessExternalSchema

Ограничить доступ к указанным протоколам для внешней ссылки, установленной атрибутом schemaLocation, элементом Import и Include. Если доступ запрещен из-за ограничения этого свойства, будет брошено исключение времени выполнения, специфичное для контекста. В случае SchemaFactory, например, будет брошено org.xml.sax.SAXException.

Значение: как определено в описании класса.

Система свойств: javax.xml.accessExternalSchema

Файл конфигурации: Да. Свойство можно задать в файле конфигурации.

С тех пор:
1.7
См. также:
  • Значения константных полей

ACCESS_EXTERNAL_STYLESHEET

public static final String ACCESS_EXTERNAL_STYLESHEET
Свойство: accessExternalStylesheet

Ограничить доступ к указанным протоколам для внешних ссылок, заданных инструкцией обработки stylesheet, элементом Import и Include, и функцией документа. Если доступ запрещен из-за ограничения этого свойства, будет брошено исключение времени выполнения, специфичное для контекста. В случае создания нового Transformer, например, TransformerConfigurationException будет брошено TransformerFactory.

Значение: как определено в описании класса.

Система свойств: javax.xml.accessExternalStylesheet

Файл конфигурации: Да. Свойство можно задать в файле конфигурации.

С тех пор:
1.7
См. также:
  • Значения константных полей

Использование каталога

public static final String USE_CATALOG
Функция: useCatalog

Инструктирует процессоры XML использовать XML-каталоги для разрешения ссылок на сущности. Каталоги могут быть установлены через фабрики JAXP, системные свойства или конфигурационный файл, используя свойство javax.xml.catalog.files определенное в CatalogFeatures. Следующий код включает Catalog в SAX-парсер: 

     SAXParserFactory spf = SAXParserFactory.newInstance();
     spf.setFeature(XMLConstants.USE_CATALOG, true);
     SAXParser parser = spf.newSAXParser();
     parser.setProperty(CatalogFeatures.Feature.FILES.getPropertyName(), "catalog.xml");

Значение: логическое значение. Если значение true, и каталог установлен, XML-парсер будет разрешать внешние ссылки, используя CatalogResolver. Если значение false, XML-каталог игнорируется, даже если он установлен. Значение по умолчанию - true.

Системное свойство: javax.xml.useCatalog

Файл конфигурации: Да. Свойство может быть установлено в файле конфигурации.

С:
9
См. также:
  • Значения константных полей

© 1993, 2023, 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/21/docs/api/java.xml/javax/xml/XMLConstants.html

Spec-Zone.ru

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