Module java.xml
Package javax.xml.catalog

Class CatalogManager

java.lang.Object
javax.xml.catalog.CatalogManager
public final class CatalogManager extends Object
目录管理器管理XML目录和目录解析器的创建。
自从:
9

  • Method Details

    • catalog

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

      如果uris为空，则将读取系统属性javax.xml.catalog.files（在CatalogFeatures中定义）以定位初始目录文件列表。

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

      根据XML目录，OASIS标准V1.1的规定，如果目录条目无效，则将被忽略。如果所有条目都无效，则生成的目录对象将不包含任何目录元素。使用目录的任何匹配操作将返回null。

      参数:
      features - 目录功能
      uris - 一个或多个目录的uri(s)
      返回:
      一个目录的实例
      抛出:
      IllegalArgumentException - 如果URI不是绝对的或者没有URI方案的URL协议处理程序
      CatalogException - 如果解析目录时发生错误
      SecurityException - 如果安全管理器拒绝访问资源

    • catalogResolver

      public static CatalogResolver catalogResolver(Catalog catalog)
      使用指定的目录创建一个目录解析器的实例。
      参数:
      catalog - 目录实例
      返回:
      一个目录解析器的实例

    • catalogResolver

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

      如果uris为空，则将读取系统属性javax.xml.catalog.files（在CatalogFeatures中定义）以定位初始目录文件列表。

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

      根据XML目录，OASIS标准V1.1的规定，如果目录条目无效，则将被忽略。如果所有条目都无效，则生成的目录解析器对象将不包含有效目录。因此，使用解析器的任何解析操作将返回未找到映射。请参阅CatalogResolver以了解未找到映射时的行为。

      参数:
      features - 目录功能
      uris - 一个或多个目录的uri(s)
      返回:
      一个目录解析器的实例
      抛出:
      IllegalArgumentException - 如果URI不是绝对的或者没有URI方案的URL协议处理程序
      CatalogException - 如果解析目录时发生错误
      SecurityException - 如果安全管理器拒绝访问资源