You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cxf.apache.org by bu...@apache.org on 2012/04/23 22:48:39 UTC
svn commit: r814126 - in /websites/production/cxf/content:
cache/docs.pageCache docs/jaxrs-services-description.html
docs/restful-services.html
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 -->