...
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 both Spring and Blueprint (OSGi) configuration, for example the http://cxf.apache.org/jaxws and http://cxf.apache.org/blueprint/jaxws namespace namespaces.
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 URIs to locations on the classpath (spring.schemas files), and that way validates your Spring configuration filesNote if you're using Spring it will validate your Spring configuration files, using information in each JAR's META-INF/spring.schemas file (an example here). Validation is extremely helpful in diagnosing errors in CXF configurations, but it is also very expensive at runtime. Once you have got your application working, you can disable validation by setting a system property: org.apache.cxf.spring.validation.mode
(in 2.1) or spring.validation.mode
(in 2.0.x). Set it as follows to disable validation: -Dorg.apache.spring.validation.mode=VALIDATION_NONE
The table below lists includes the URIs for the CXF configuration schemas that you need to specify in your Spring configuration file's schemaLocation attribute so that Spring's validating parse parser can validate the file.
In theory you need not be concerned with the actual location of the files: Spring knows about can normally detect their location on from 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 You can also use the classpath location in the table below to find the original version of the schema in the trunk.
Configuration Schemas common to both Spring and Blueprint
URI | Target Namespace | Classpath Resource | Module | http://cxf.apache.org/schemas/core.xsd ||
---|---|---|---|---|---|
http://cxf.apache.org/core /schemas/core.xsd | cxf-rt-core | /schemas/configuration/http-conf.xsd | cxf-rt-transports-http | ||
/schemas/configuration/http-jetty.xsd | cxf-rt-transports-http-jetty | ||||
/schemas/configuration/jms.xsd | cxf-rt-transports-jms | ||||
/schemas/configuration/security.xsd | cxf-common-schemas | ||||
/schemas/configuration/soap.xsd | cxf-rt-bindings-soap | ||||
/schemas/jaxwsws-addr-conf.xsd | cxf-rt-frontendws-jaxws addr | ||||
http://cxf.apache.org/schemas/simpleconfiguration/wsrm-manager-types.xsd | /schemas/simple/configuration/wsrm-manager-types.xsd | cxf-rt-frontendws-simple rm | |||
http://cxf.apache.org/schemas/ws-addr-confconfiguration/wsrm-manager.xsd | http://cxf.apache.org/ws/rm/addressingmanager | /schemas/configuration/wswsrm-addr-confmanager.xsd * | cxf-rt-ws-addr -rm |
* wsrm-manager.xsd does an "xsd:include" on wsrm-manager-types.xsd as they are in the same namespace. As such, the user just needs to reference wsrm-manager.xsd to use both.
Spring-only Schemas
URI | Target Namespace | Classpath Resource | Module |
---|---|---|---|
/schemas/core.xsd | cxf-rt-core | ||
http://cxf.apache.org/schemas/jaxrs/configuration/wsrm-manager-types.xsd | /schemas/jaxrs.xsd | cxf-rt-frontend-jaxrs | |
/schemas/jaxws.xsd | cxf-rt-frontend-jaxws | ||
/schemas/policyrm/manager /schemas/configuration/wsrm-manager-types.xsd | cxf-rt-ws-rm policy | ||
http://cxf.apache.org/schemas/configuration/wsrm-manager.xsdsimple.xsd | /schemas/simple.xsd | cxf-rt-frontend-simple |
Blueprint-only Schemas
URI | Target Namespace | Classpath Resource | Module |
---|---|---|---|
/schemas/blueprint/core.xsd | cxf-rt-core | ||
http://cxf.apache.org/jaxrs /ws/rm/manager | /schemas/configurationblueprint/wsrm-managerjaxrs.xsd * | cxf-rt-wsfrontend-rm |
* wsrm-manager.xsd does an "xsd:include" on wsrm-manager-types.xsd as they are in the same namespace. As such, the user just needs to reference wsrm-manager.xsd to use both.
jaxrs | |||
/schemas/blueprint/jaxws.xsd | cxf-rt-frontend-jaxws | ||
/schemas/blueprint/policy.xsd | cxf-rt-ws-policy | ||
/schemas/blueprint/simple.xsd | cxf-rt-frontend-simple |
Example
The following is an example of a valid Spring configuration file. Using the table above, there is no magic involved in setting the correct value for the schemaLocation attribute!
...
The following schemas are imported by one or more of 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 |
---|---|---|---|
/schemas/configuration/cxf-beans.xsd | cxf-common-utilities | ||
/schemas/wsdl/http-conf.xsd | cxf-rt-transports-http | ||
/schemas/wsdl/jms.xsd | cxf-rt-transports-jms | ||
/schemas/wsdl/spec/jms-spec-wsdl.xsd | cxf-rt-transports-jms | ||
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 |
/schemas/wsdl/addressing.xsd | cxf-common-schemas | ||
/schemas/ws-policy-200409.xsd | cxf-rt-ws-rm | ||
/schemas/configuration/wsrm-policy.xsd | cxf-rt-ws-rm | ||
/schemas/wsdl/wsdl.xsd | cxf-common-schemas | ||
/schemas/wsdl/http.xsd | cxf-common-schemas | ||
/schemas/xml.xsd | cxf-rt-ws-policy | ||
/schemas/ws-policy-200607.xsd | cxf-rt-ws-policy |
...