Spec-Zone.ru › OpenJDK 24

Класс 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 Instance.
static final String W3C_XML_SCHEMA_NS_URI
URI пространства имен W3C XML Schema.
static final String W3C_XPATH_DATATYPE_NS_URI
URI пространства имен W3C XPath Datatype.
static final String XML_DTD_NS_URI
URI пространства имен XML Document Type Declaration в виде произвольного значения.
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 Schema-Related Markup in Documents Being Validated
  • Значения константных полей

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 Schema-Related Markup in Documents Being Validated
  • Значения константных полей

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 and XPath 2.0 Data Model
  • Значения константных полей

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
Свойство: доступ к внешним DTD

Ограничить доступ к внешним 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, а также функции документа. Если доступ запрещён из-за ограничения этого свойства, генерируется исключение времени выполнения, специфичное для контекста. Например, при создании нового объекта Transformer, исключение TransformerConfigurationException будет выброшено фабрикой TransformerFactory.

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

Системная переменная: javax.xml.accessExternalStylesheet

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

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

USE_CATALOG

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, 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/javax/xml/XMLConstants.html

Spec-Zone.ru

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