Module  java.xml
软件包  javax.xml.catalog

Class CatalogManager


  • public final class CatalogManager
extends Object
    目录管理器管理XML目录和目录解析器的创建。
    从以下版本开始：
    9

    • 方法详细信息

      • catalog

        public static Catalog catalog​(CatalogFeatures features,
                              URI... uris)
        使用指定的功能设置和uri（s）创建一个Catalog对象到一个或多个目录文件。

        如果uris是空的，系统属性javax.xml.catalog.files ，如定义CatalogFeatures ，将读取查找的目录文件的初步名单。

        如果通过uris参数或javax.xml.catalog.files属性指定了多个目录文件，则第一个条目被认为是主目录，而其他目录文件被视为主目录中的nextCatalog元素引用的替代目录。

        如XML Catalogs, OASIS Standard V1.1所述 ，如果目录条目无效，则会被忽略。 如果所有条目无效，则生成的目录对象将不包含目录元素。 使用目录的任何匹配操作将返回null。

        参数
        features - 目录功能
        uris - 一个或多个目录的uri。
        结果
        一个 Catalog一个实例
        异常
        IllegalArgumentException - 如果URI不是绝对的或者没有URI方案的URL协议处理程序
        CatalogException - 如果在解析目录时发生错误
        SecurityException - 如果对资源的访问被安全管理器拒绝

      • catalogResolver

        public static CatalogResolver catalogResolver​(Catalog catalog)
        使用指定的目录创建一个 CatalogResolver的实例。
        参数
        catalog - 目录实例
        结果
        一个 CatalogResolver一个实例

      • catalogResolver

        public static CatalogResolver catalogResolver​(CatalogFeatures features,
                                              URI... uris)
        使用指定的功能设置和uri（s）创建一个CatalogResolver的实例到一个或多个目录文件。

        如果uris是空的，系统属性javax.xml.catalog.files ，如定义CatalogFeatures ，将读取查找的目录文件的初步名单。

        如果通过uris参数或javax.xml.catalog.files属性指定了多个目录文件，则第一个条目被认为是主目录，而其他目录文件被视为主目录中的nextCatalog元素引用的替代目录。

        如XML Catalogs, OASIS Standard V1.1中所述 ，如果目录条目无效，则将被忽略。 如果所有条目无效，则生成的CatalogResolver对象将不包含有效的目录。 因此，使用解析器的任何解析操作都将返回，因为没有找到映射。 有关没有找到映射的行为，请参阅CatalogResolver 。

        参数
        features - 目录功能
        uris - 一个或多个目录的uri
        结果
        一个 CatalogResolver一个实例
        异常
        IllegalArgumentException - 如果URI不是绝对的，或者没有URI方案的URL协议处理程序
        CatalogException - 解析目录时是否发生错误
        SecurityException - 如果对资源的访问被安全管理器拒绝