Spec-Zone.ru › OpenJDK 25

Класс 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, содержащая схему, URI, а в случае протокола JAR — слово "jar" и отделённая двоеточием часть, содержащая схему. Схема определяется следующим образом:
схема = alpha *( alpha | digit | "+" | "-" | "." )
где alpha = 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
См. также:
  • Расширяемый язык разметки (XML) 1.1
  • Расширяемый язык разметки (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 пространства имён экземпляра XML Schema W3C.
static final String W3C_XML_SCHEMA_NS_URI
URI пространства имён XML Schema W3C.
static final String W3C_XPATH_DATATYPE_NS_URI
URI пространства имён типов данных XPath W3C.
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
URI имени пространства имён официального атрибута XML для указания объявлений пространства имён XML, XMLConstants.XMLNS_ATTRIBUTE.

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

Методы, объявленные в классе 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. Значения пространства имён по умолчанию
  • Значения константных полей

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
URI имени пространства имён официального атрибута XML для указания объявлений пространства имён XML, XMLConstants.XMLNS_ATTRIBUTE.

В спецификации 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 пространства имён XML Schema W3C.

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

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

W3C_XML_SCHEMA_INSTANCE_NS_URI

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

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

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

W3C_XPATH_DATATYPE_NS_URI

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

Определён как "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, предназначенные для предотвращения таких ситуаций, как атаки типа «отказ в обслуживании».
См. также:
  • Значения константных полей

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

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

Значение: согласно описанию класса.

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

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

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

USE_CATALOG

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

Предписывает XML-процессорам использовать каталоги XML для разрешения ссылок на сущности. Каталоги можно задавать через фабрики JAXP, системные свойства или файл конфигурации с помощью свойства javax.xml.catalog.files, определённого в CatalogFeatures. Следующий код включает каталог для 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
См. также:
  • Значения константных полей

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по 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/javax/xml/XMLConstants.html

Spec-Zone.ru

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