You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

CXF uses XML schemas extensively in the runtime: Its core includes the JAXB mappings of standard schemas such as http://schemas.xmlsoap.org/wsdl/ and http://www.w3.org/2006/03/addressing/ws-addr.xsd. CXF also defines its own schemas for WSDL extensions such as the jms-address element in namespace http://cxf.apache.org/transports/jms, and schemas for Spring configuration, for example the http://cxf.apache.org/jaxws namespace.

To avoid accessing resources over the network during a build, CXF maintains local copies of these schemas. Logically however, third party as well as CXF schemas, are as well as the CXF schemas, are referred to by their public URIs in schemaLocation attributes and similar places. The CXF code generators use catalog files to map them to their actual location in the trunk, see the pom.xml file in the api module for an example.

Spring uses a similar way to map UIRs to locations on the classpath (spring.schemas files), and that way validates your Spring configuration files. Validation can be disabled (by setting system property spring.validation.mode to VALIDATION_NONE), but the default is to have it enabled. This is very useful when you are configuring CXF and not very familiar with CXF's configuration schemas or with Spring itself.

The table below lists the UIRs for the CXF configuration schemas that you need to specify in your Spring configuration file's schemaLocation attribute so that Spring's validating parse can validate the file.
In theory you need not be concerned with the actual location of the files: Spring knows about their location on the classpath. And if you want to check the content of a schema file (in a binary distribution), you should be able to do so using its URI. At the moment this is not possible, however CXF aims at publishing its schemas in the future. In the meantime, you can use the classpath location in the table below to find the original version of the schema in the trunk.

Configuration Schemas

Other Schemas

The following schemas are imported by the schemas above, directly or indirectly. You may also find their classpath locations useful when you import or include any of the schemas below in your own schema, and want to know hpw you can access them locally (actually, it'd be cool if someone wrote a CatalogResolver based on the URI - classpath location mappings that already exist and get the CXF tools and/or xjc to use it).

URI

Target Namespace

Classpath Resource

Module

http://cxf.apache.org/schemas/configuration/cxf-beans.xsd http://cxf.apache.org/configuration/beans

/schemas/configuration/cxf-beans.xsd

cxf-common-utilities

http://cxf.apache.org/schemas/wsdl/http-conf.xsd http://cxf.apache.org/transports/http/configuration

/schemas/wsdl/http-conf.xsd

cxf-rt-transports-http

http://cxf.apache.org/schemas/wsdl/jms.xsd http://cxf.apache.org/transports/jms

/schemas/wsdl/jms.xsd

cxf-rt-transports-jms

http://activemq.org/config/1.0 http://activemq.org/config/1.0

/activemq.xsd

cxf-xxx-yyy

http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd

/schemas/oasis-200401-wss-wssecurity-secext-1.0.xsd

cxf-rt-ws-policy

http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd

/schemas/oasis-200401-wss-wssecurity-utility-1.0.xsd

cxf-rt-ws-policy

http://schemas.xmlsoap.org/ws/2004/08/addressing http://schemas.xmlsoap.org/ws/2004/08/addressing

/schemas/wsdl/addressing.xsd

cxf-common-schemas

http://schemas.xmlsoap.org/ws/2004/09/policy/ws-policy.xsd http://schemas.xmlsoap.org/ws/2004/09/policy

/schemas/ws-policy-200409.xsd

cxf-rt-ws-rm

http://schemas.xmlsoap.org/ws/2005/02/rm/wsrm-policy.xsd http://schemas.xmlsoap.org/ws/2005/02/rm/policy

/schemas/configuration/wsrm-policy.xsd

cxf-rt-ws-rm

http://schemas.xmlsoap.org/wsdl/ http://schemas.xmlsoap.org/wsdl/

/schemas/wsdl/wsdl.xsd

cxf-common-schemas

http://schemas.xmlsoap.org/wsdl/http/ http://schemas.xmlsoap.org/wsdl/http/

/schemas/wsdl/http.xsd

cxf-common-schemas

http://www.w3.org/2001/xml.xsd http://www.w3.org/XML/1998/namespace

/schemas/xml.xsd

cxf-rt-ws-policy

http://www.w3.org/2006/07/ws-policy.xsd http://www.w3.org/2006/07/ws-policy

/schemas/ws-policy-200607.xsd

cxf-rt-ws-policy

Note for Developers: If you define your own configuration schema, place it in the schemas subdirectory of the resources directory, then combine http://cxf.apache.org/ and the path of the schema relative to the resources directory to form the system ID, and make the latter known to Spring by adding a line similar to the following to the spring.schemas file in your module's META-INF directory (note the escaped : character):

http\://cxf.apache.org/schemas/wsdl/http-conf.xsd=schemas/wsdl/http-conf.xsd
  • No labels