Author: buildbot
Date: Mon Apr 23 20:48:38 2012
New Revision: 814126
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/jaxrs-services-description.html
websites/production/cxf/content/docs/restful-services.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 Mon
Apr 23 20:48:38 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-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="#JAXRSServicesDescription-WADLinJSONformat">WADL in JSON
format</a></li><li><a shape="rect"
href="#JAXRSServicesDescription-GeneratingtheclientcodefromWADLatrun
time">Generating the client code from WADL at runtime</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-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="#JAXRSServicesDescription-WADLinJSONformat">WADL in JSON
format</a></li><li><a shape="rect"
href="#JAXRSServicesDescription-HidinglinkstoJAXRSendpointsfromthese
rvicespage">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>
@@ -619,30 +619,6 @@ with a given jaxrs:server endpoint. </p>
<p>Use a "?_wadl&_type=json" or something like "fiction.wadl", where
extensions will map a 'wadl' to 'application/json' in order to get a WADL JSON
representations, please see <a shape="rect" class="external-link"
href="http://sberyozkin.blogspot.com/2011/10/describing-json-services-in-wadl.html";
rel="nofollow">this blog entry</a> for more information.</p>
-<h1><a shape="rect"
name="JAXRSServicesDescription-GeneratingtheclientcodefromWADLatruntime"></a>Generating
the client code from WADL at runtime</h1>
-
-<p>If you register an org.apache.cxf.jaxrs.ext.codegen.CodeGeneratorProvider
with a jaxrs endpoint and issue a '_code' query to it then you will get back an
XHTML page containing the link to a zipped client source code which you can
download and start customizing. </p>
-
-<p>Test/development servers can host such a provider to help implementers get
started with working on the client code asap.</p>
-
-<p>Internally, before the code gets generated, WADL will be generated first.
The archive will include JAXB generated classes from a WADL grammar section
plus the proxy based client code for accessing root and sub resources. The
WebClient based code can not be generated just yet but one can request that
only a WADL grammar section is processed by adding a '_codeType=grammar' query
and easily adding a WebClient-based code. </p>
-
-<p>Here is how to get the archive programmatically :</p>
-<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">
-WebClient wc = WebClient.create(<span class="code-quote">"http:<span
class="code-comment">//localhost:9080/petstore"</span>);
-</span>XMLSource source = wc.query(<span
class="code-quote">"_code"</span>).query(<span class="code-quote">"_os"</span>,
getOs()).get(XMLSource.class);
-<span class="code-object">String</span> link = source.getValue(<span
class="code-quote">"ns:html/ns:body/ns:ul/ns:a/@href"</span>,
- Collections.singletonMap(<span
class="code-quote">"ns"</span>,<span class="code-quote">"http:<span
class="code-comment">//www.w3.org/1999/xhtml"</span>));
-</span><span class="code-comment">// download a zip file
-</span>WebClient wcZip = WebClient.create(link);
-InputStream is = wcZip.accept(<span
class="code-quote">"application/zip"</span>).get(InputStream.class);
-<span class="code-comment">// unzip and compile it</span>
-</pre>
-</div></div>
-
-<p>Please see a <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/systests/jaxrs/src/test/java/org/apache/cxf/systest/jaxrs/JAXRSClientServerResourceCreatedSpringProviderTest.java";>testPetStore</a>
test for more details.</p>
-
<h1><a shape="rect"
name="JAXRSServicesDescription-HidinglinkstoJAXRSendpointsfromtheservicespage"></a>Hiding
links to JAXRS endpoints from the services page </h1>
<p>In some cases you may not want the users to see the links to some JAXRS
endpoints. For example, if you have an AtomPullServer endpoint collecting the
log entries for a number of application endpoints, you may not want to see
AtomPullServer endpoint being listed among the endpoints representing the
actual application and which users are actually interested in. If so then
adding an "org.apache.cxf.endpoint.private" boolean property with a value
"true" will do the trick; note the same property can be used by jaxws
endpoints.</p></div>
Modified: websites/production/cxf/content/docs/restful-services.html
==============================================================================
--- websites/production/cxf/content/docs/restful-services.html (original)
+++ websites/production/cxf/content/docs/restful-services.html Mon Apr 23
20:48:38 2012
@@ -126,7 +126,7 @@ Apache CXF -- RESTful Services
<p>There are different ways to build RESTful services with CXF. </p>
<ol><li><a shape="rect" href="jax-rs.html" title="JAX-RS">JAX-RS</a>: CXF has
an implementation of JAX-RS 1.1 and JAX-RS 1.0 (JSR-311): Java API for RESTful
Web Services. This provides a more standard way to build RESTful services in
JAVA.</li><li><a shape="rect"
href="rest-with-jax-ws-provider-and-dispatch.html" title="REST with JAX-WS
Provider and Dispatch">JAX-WS Provider and Dispatch</a>: It is possible to
create RESTful services with the JAX-WS Provider and Dispatch APIs.</li><li><a
shape="rect" href="http-binding.html" title="HTTP Binding">HTTP Binding</a>:
The HTTP binding provides a flexible way of creating resources and mapping them
to operations in your service. This can currently be done via annotations or a
convention based mapping.<br clear="none">
-Note : HTTP Binding has been deprecated and is likely to be removed from CXF
in one of its future releases. </li></ol>
+Note : HTTP Binding has been removed from CXF 2.6.0. </li></ol>
</div>
</div>
<!-- Content -->
