Configuration on Java

• Feature ResolverFeature.MASK_JAR_URIS (type: Boolean)

• System property xml.catalog.maskJarUris

• Property file property mask-jar-uris

Configuration on .NET

• This setting has no equivalent on .NET

Don’t return jar: or classpath: URIs. Most entity resolver APIs are defined such that if resolution succeeds, the base URI of the resource returned is the base URI of the actual, local resource. This can greatly simplify things because subsequent relative URIs can be resolved against the local resource directly.

However, the Java URI class does not treat jar: or classpath: URI schemes as hierarchical, so any subsequent attempts to resolve relative URIs will fail. If this property is true, the local resource will be returned but the URI will be left unchanged. That may require a more complete catalog, but it will avoid a situation which is guaranteed to fail.