svn commit: r831202 - in /websites/production/cxf/content: cache/docs.pageCache docs/jaxrs-services-description.html

[bu...@apache.org]

Author: buildbot
Date: Wed Sep  5 12:47:28 2012
New Revision: 831202

Log:
Production update by buildbot for cxf

Modified:
    websites/production/cxf/content/cache/docs.pageCache
    websites/production/cxf/content/docs/jaxrs-services-description.html

Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.

Modified: websites/production/cxf/content/docs/jaxrs-services-description.html
==============================================================================
--- websites/production/cxf/content/docs/jaxrs-services-description.html (original)
+++ websites/production/cxf/content/docs/jaxrs-services-description.html Wed Sep  5 12:47:28 2012
@@ -124,7 +124,7 @@ Apache CXF -- JAXRS Services Description
 <div id="ConfluenceContent"><p><span style="font-size:2em;font-weight:bold"> JAX-RS Services Description </span></p>
 
 <div>
-<ul><li><a shape="rect" href="#JAXRSServicesDescription-WADLoverview">WADL overview</a></li><ul><li><a shape="rect" href="#JAXRSServicesDescription-Basicexample">Basic example</a></li><li><a shape="rect" href="#JAXRSServicesDescription-WADLwithreferences">WADL with references</a></li><li><a shape="rect" href="#JAXRSServicesDescription-SharingdeclarationsbetweenmultipleWADLs">Sharing declarations between multiple WADLs</a></li></ul><li><a shape="rect" href="#JAXRSServicesDescription-WADLfirstDevelopment">WADL-first Development</a></li><ul><li><a shape="rect" href="#JAXRSServicesDescription-wadl2javacommandlinetool">wadl2java command line tool</a></li><ul><li><a shape="rect" href="#JAXRSServicesDescription-JAXBcustomizations">JAXB customizations</a></li></ul><li><a shape="rect" href="#JAXRSServicesDescription-wadl2javaMavenplugin">wadl2java Maven plugin</a></li><li><a shape="rect" href="#JAXRSServicesDescription-Integration">Integration</a></li><li><a shape="rect" href="#JAXRS
 ServicesDescription-ExternalWADLdocumentsandJAXRSendpoints.">External WADL documents and JAXRS endpoints.</a></li></ul><li><a shape="rect" href="#JAXRSServicesDescription-WADLAutoGeneration">WADL Auto Generation</a></li><ul><li><a shape="rect" href="#JAXRSServicesDescription-DocumentingresourceclassesandmethodsingeneratedWADL">Documenting resource classes and methods in generated WADL</a></li><li><a shape="rect" href="#JAXRSServicesDescription-CustomizingWADLGeneration">Customizing WADL Generation</a></li><ul><li><a shape="rect" href="#JAXRSServicesDescription-RepresentingexplicitJAXBcollections">Representing explicit JAXB collections</a></li><li><a shape="rect" href="#JAXRSServicesDescription-RepresentingexternalschemasandnonJAXBtypes">Representing external schemas and non JAXB types</a></li></ul></ul><li><a shape="rect" href="#JAXRSServicesDescription-ServicelistingsandWADLqueries">Service listings and WADL queries</a></li><li><a shape="rect" href="#JAXRSServicesDescriptio
 n-WADLinJSONformat">WADL in JSON format</a></li><li><a shape="rect" href="#JAXRSServicesDescription-HidinglinkstoJAXRSendpointsfromtheservicespage">Hiding links to JAXRS endpoints from the services page</a></li></ul></div>
+<ul><li><a shape="rect" href="#JAXRSServicesDescription-WADLoverview">WADL overview</a></li><ul><li><a shape="rect" href="#JAXRSServicesDescription-Basicexample">Basic example</a></li><li><a shape="rect" href="#JAXRSServicesDescription-WADLwithreferences">WADL with references</a></li><li><a shape="rect" href="#JAXRSServicesDescription-SharingdeclarationsbetweenmultipleWADLs">Sharing declarations between multiple WADLs</a></li></ul><li><a shape="rect" href="#JAXRSServicesDescription-WADLfirstDevelopment">WADL-first Development</a></li><ul><li><a shape="rect" href="#JAXRSServicesDescription-wadl2javacommandlinetool">wadl2java command line tool</a></li><ul><li><a shape="rect" href="#JAXRSServicesDescription-JAXBcustomizations">JAXB customizations</a></li></ul><li><a shape="rect" href="#JAXRSServicesDescription-wadl2javaMavenplugin">wadl2java Maven plugin</a></li><li><a shape="rect" href="#JAXRSServicesDescription-Integration">Integration</a></li><li><a shape="rect" href="#JAXRS
 ServicesDescription-ExternalWADLdocumentsandJAXRSendpoints.">External WADL documents and JAXRS endpoints.</a></li></ul><li><a shape="rect" href="#JAXRSServicesDescription-WADLAutoGeneration">WADL Auto Generation</a></li><ul><li><a shape="rect" href="#JAXRSServicesDescription-DocumentingresourceclassesandmethodsingeneratedWADL">Documenting resource classes and methods in generated WADL</a></li><li><a shape="rect" href="#JAXRSServicesDescription-CustomizingWADLGeneration">Customizing WADL Generation</a></li><ul><li><a shape="rect" href="#JAXRSServicesDescription-RepresentingexplicitJAXBcollections">Representing explicit JAXB collections</a></li><li><a shape="rect" href="#JAXRSServicesDescription-RepresentingexternalschemasandnonJAXBtypes">Representing external schemas and non JAXB types</a></li><li><a shape="rect" href="#JAXRSServicesDescription-Changingthebaseaddress">Changing the base address</a></li></ul></ul><li><a shape="rect" href="#JAXRSServicesDescription-Servicelistin
 gsandWADLqueries">Service listings and WADL queries</a></li><li><a shape="rect" href="#JAXRSServicesDescription-WADLinJSONformat">WADL in JSON format</a></li><li><a shape="rect" href="#JAXRSServicesDescription-HidinglinkstoJAXRSendpointsfromtheservicespage">Hiding links to JAXRS endpoints from the services page</a></li></ul></div>
 
 <p>CXF JAX-RS supports (Web Application Description Language|http://www.w3.org/Submission/wadl] (WADL). <br clear="none">
 Users can use WADL documents to generate the initial code and have WADL auto-generated on demand. </p>
@@ -586,6 +586,11 @@ wg.setSchemaLocations(Collections.single
 
 <p>If no JAXB is used then you can attach an <a shape="rect" class="external-link" href="http://svn.apache.org/repos/asf/cxf/trunk/rt/frontend/jaxrs/src/main/java/org/apache/cxf/jaxrs/model/wadl/XMLName.java">XMLName</a> annotation to method input or output types. Alternatively, you can register an instance of <a shape="rect" class="external-link" href="http://svn.apache.org/repos/asf/cxf/trunk/rt/frontend/jaxrs/src/main/java/org/apache/cxf/jaxrs/model/wadl/ElementQNameResolver.java">ElementQNameResolver</a> with the WadlGenerator which will be used for creating wadl:representation/@element values.</p>
 
+<h3><a shape="rect" name="JAXRSServicesDescription-Changingthebaseaddress"></a>Changing the base address</h3>
+
+<p>Starting from CXF 2.6.2 it is possible to affect the base address specified in the auto-generated WADL (in wadl:resources/@base attribute).<br clear="none">
+WADLGenerator can be indirectly configured by setting a jaxrs:server/@publishedEndpointUrl attribute, similarly to the way CXF WADL generator can be configured by setting a jaxws;endpoint/@publishedEndpointUrl attribute.</p>
+
 <h1><a shape="rect" name="JAXRSServicesDescription-ServicelistingsandWADLqueries"></a>Service listings and WADL queries</h1>
 
 <p>Links to WADL instances for RESTful endpoints are available from {base endpointaddress}/services, in addition to SOAP endpoints if any. </p>