Spec-Zone.ru › OpenJDK 27

Класс 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» и отделённая двоеточием часть URI, содержащая схему. Схема определяется следующим образом:
scheme = alpha *( alpha | digit | "+" | "-" | "." )
где alpha = a-z и A-Z.

А протокол JAR:
jar[:scheme]

Протоколы, включающие ключевое слово «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, часть 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 W3C.
static final String W3C_XML_SCHEMA_NS_URI
URI пространства имён схемы XML 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
Модификатор и тип Метод Описание
protected Object clone()
Создаёт и возвращает копию этого объекта.
boolean equals(Object obj)
Показывает, равен ли этот объект другому объекту.
protected void finalize()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Финализация устарела и будет удалена в одном из следующих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.

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

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 W3C.

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

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

W3C_XML_SCHEMA_INSTANCE_NS_URI

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

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

См. также:
  • Схема XML, часть 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, 2026, 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.

Spec-Zone.ru

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