[jbossws-issues] [JBoss JIRA] Updated: (JBWS-678) OASIS Catalog support

[Thomas Diesler (JIRA)]

     [ http://jira.jboss.com/jira/browse/JBWS-678?page=all ]

Thomas Diesler updated JBWS-678:
--------------------------------

    Assignee:     (was: Thomas Diesler)

> OASIS Catalog support
> ---------------------
>
>                 Key: JBWS-678
>                 URL: http://jira.jboss.com/jira/browse/JBWS-678
>             Project: JBoss Web Services
>          Issue Type: Feature Request
>      Security Level: Public(Everyone can see) 
>          Components: jbossws-native
>            Reporter: Thomas Diesler
>             Fix For: jbossws-3.x
>
>         Attachments: jboss-entity-resolver.zip
>
>
> From the JAXWS-2.-0 spec 
> 4.4 Catalog Facility 
>  
> JAX-WS mandates support for a standard catalog facility to be used when resolving any Web service docu- 15
> ment that is part of the description of a Web service, specifically WSDL and XML Schema documents. 16
> The facility in question is the OASIS XML Catalogs 1.1 specification [30]. It defines an entity catalog that 17
> handles the following two cases: 18
> ? Mapping an external entity?s public identifier and/or system identifier to a URI reference. 19
> ? Mapping the URI reference of a resource to another URI reference. 20
> Using the entity catalog, an application can package one or more description and/or schema documents in 21
> jar files, avoiding costly remote accesses, or remap remote URIs to other, possibly local ones. Since the 22
> catalog is an XML document, a deployer can easily alter it to suit the local environment, unbeknownst to 23
> the application code. 24
> The catalog is assembled by taking into account all accessible resources whose name is META-INF/jax- 25
> -ws-catalog.xml. Each resource MUST be a valid entity catalog according to the XML Catalogs 1.1 26
> specification. When running on the Java SE platform, the current context class loader MUST be used to 27
> retrieve all the resources with the specified name. Relative URIs inside a catalog file are relative to the 28
> location of the catalog that contains them. 29
> } Conformance (Use of the Catalog): In the process of resolving a URI that points to a WSDL document 30
> or any document reachable from it, a JAX-WS implementation MUST perform a URI resolution for it, as 31
> prescribed by the XML Catalogs 1.1 specification, using the catalog defined above as its entity catalog. 32
> In particular, every JAX-WS API argument or annotation element whose semantics is that of a WSDL 33
> location URI MUST undergo URI resolution using the catalog facility described in this section. 34
> Although defined in the client API chapter for reasons of ease of exposure, use of the catalog is in no way 35
> restricted to client uses of WSDL location URIs. In particular, resolutions of URIs to WSDL and schema 36
> documents that arise during the publishing of endpoint metadata (see 5.2.5) are subject to the requirements 37
> in this section, resulting in catalog-based URI resolutions.
>  
> There is a catalog implementation by Apache
> http://xml.apache.org/commons/components/resolver/
> XML Entity and URI Resolvers
> http://xml.apache.org/commons/components/resolver/resolver-article.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.jboss.com/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira