cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r814126 - in /websites/production/cxf/content: cache/docs.pageCache docs/jaxrs-services-description.html docs/restful-services.html
Date Mon, 23 Apr 2012 20:48:39 GMT
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&amp;_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 -->



Mime
View raw message