Author: buildbot
Date: Tue Apr 29 09:46:50 2014
New Revision: 907277
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/jax-rs.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/jax-rs.html
==============================================================================
--- websites/production/cxf/content/docs/jax-rs.html (original)
+++ websites/production/cxf/content/docs/jax-rs.html Tue Apr 29 09:46:50 2014
@@ -119,11 +119,11 @@ Apache CXF -- JAX-RS
<!-- Content -->
<div class="wiki-content">
<div id="ConfluenceContent"><p> </p><p> </p><span
style="font-size:2em;font-weight:bold"> JAX-RS (JSR-339)
</span><p> </p><p> </p><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1396468210131 {padding: 0px;}
-div.rbtoc1396468210131 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1396468210131 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1398764783738 {padding: 0px;}
+div.rbtoc1398764783738 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1398764783738 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1396468210131">
+/*]]>*/</style></p><div class="toc-macro rbtoc1398764783738">
<ul class="toc-indentation"><li><a shape="rect"
href="#JAX-RS-Introduction">Introduction</a></li><li><a shape="rect"
href="#JAX-RS-JAX-RSCompliance">JAX-RS Compliance</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#JAX-RS-1.1">1.1</a></li><li><a shape="rect" href="#JAX-RS-2.0Final">2.0
Final</a></li></ul>
</li><li><a shape="rect" href="#JAX-RS-Projectsetupandconfiguration">Project
setup and configuration</a>
@@ -265,7 +265,7 @@ public void upload(@Multipart InputStrea
<jaxrs:server>
</beans>
]]></script>
-</div></div><p>Please make sure the <code><a shape="rect"
href="http://cxf.apache.org/core";>http://cxf.apache.org/core</a></code>
namespace is in scope.</p><p>Starting from CXF 2.3.0 it is also possible to
convert log events into Atom entries and either push them to receivers or make
them available for polling.</p><p>Please see the <a shape="rect"
href="debugging-and-logging.html">Debugging and Logging</a> page for more
information.</p><h1 id="JAX-RS-AdvancedFeatures">Advanced Features</h1><h2
id="JAX-RS-Multiparts">Multiparts</h2><p>Multiparts can be handled in a number
of ways. The CXF core runtime provides advanced support for handling
attachments which CXF JAX-RS builds upon.</p><p>Please see the <a shape="rect"
href="jax-rs-multiparts.html">JAX-RS Multiparts</a> page for more
information.</p><h2 id="JAX-RS-SecureJAX-RSservices">Secure JAX-RS
services</h2><p>Transport level HTTPS security can be used to protect messages
exchanged between CXF JAX-RS endpoints and providers.</p><p
>Authentication and authorization can be enforced in a number of
>ways.</p><p>Please see the <a shape="rect"
>href="secure-jax-rs-services.html">Secure JAX-RS Services</a> page for more
>information.</p><p>Please also check <a shape="rect"
>href="https://cwiki.apache.org/confluence/display/CXF20DOC/JAX-RS+XML+Security";>JAX-RS
> XML Security</a>, <a shape="rect" href="jax-rs-saml.html">JAX-RS SAML</a>
>and <a shape="rect" href="jax-rs-oauth2.html">JAX-RS OAuth2</a> pages for
>more information about the advanced security topics.</p><h2
>id="JAX-RS-FailoverandLoadDistributionFeatures">Failover and Load
>Distribution Features</h2><p>Starting from CXF 2.4.1, CXF JAX-RS proxy and
>WebClient consumers can be backed up by failover and load distribution
>features.<br clear="none"> Please see the <a shape="rect"
>href="jax-rs-failover.html">JAX-RS Failover</a> page for more
>information.</p><h2 id="JAX-RS-Redirection">Redirection</h2><p>Starting from
>CXF 2.2.5 it is possible to redirect the request or resp
onse call to other servlet resources by configuring CXFServlet or using CXF
JAX-RS RequestDispatcherProvider.</p><p>Please see the <a shape="rect"
href="jax-rs-redirection.html">JAX-RS Redirection</a> page for more
information.</p><h2 id="JAX-RS-XSLTandXPath">XSLT and XPath</h2><p>XSLT and
XPath are promoted and treated as first-class citizens in CXF JAX-RS. These
technologies can be very powerful when generating complex data or retrieving
data of interest out of complex XML fragments.</p><p>Please see the <a
shape="rect" href="jax-rs-advanced-xml.html">JAX-RS Advanced XML</a> page for
more information.</p><h2 id="JAX-RS-ComplexSearchQueries">Complex Search
Queries</h2><p>Using <a shape="rect"
href="http://cxf.apache.org/docs/jax-rs.html#JAX-RS-Parameterbeans";>query
parameter beans</a> provides a way to capture search requirements that can be
expressed by enumerating name/value pairs, for example, a query such as
'?name=CXF&version=2.3' can be captured by a bean containing setNa
me and setVersion methods. This 'template' bean can be used in the code to
compare it against all available local data.</p><p>Versions 2.3 and later of
CXF JAXRS support another option for doing advanced search queries using the <a
shape="rect" class="external-link"
href="http://tools.ietf.org/html/draft-nottingham-atompub-fiql-00";
rel="nofollow">Feed Item Query Language</a>(FIQL).</p><p>Please see the <a
shape="rect" href="jax-rs-search.html">JAX-RS Search</a> page for more
information.</p><h2
id="JAX-RS-Model-View-Controllersupport">Model-View-Controller
support</h2><p><strong>XSLT</strong><br clear="none"> Please see the <a
shape="rect" href="jax-rs-advanced-xml.html">JAX-RS Advanced XML</a> page for
more information. on how <code>XSLTJaxbProvider</code> can be used to generate
complex (X)HTML views.</p><p><strong>JSP</strong></p><p>With the introduction
of <code>RequestDispatcherProvider</code> it is now possible for JAXRS service
responses be redirected to JSP pages for further
processing. Please see the <a shape="rect"
href="jax-rs-redirection.html">JAX-RS Redirection</a> page for more
information.</p><h2 id="JAX-RS-CombiningJAX-WSandJAX-RS">Combining JAX-WS and
JAX-RS</h2><p>CXF JAX-RS tries to make it easy for SOAP developers to
experiment with JAX-RS and combine both JAX-WS and JAX-RS in the same service
bean when needed.</p><p>Please see the <a shape="rect"
href="jax-rs-and-jax-ws.html">JAX-RS and JAX-WS</a> page for more
information.</p><h2 id="JAX-RS-IntegrationwithDistributedOSGi">Integration with
Distributed OSGi</h2><p>Distributed OSGi RI is a CXF <a shape="rect"
href="http://cxf.apache.org/distributed-osgi.html";>subproject</a>. DOSGi
mandates how registered Java interfaces can be exposed<br clear="none"> and
consumed as remote services. DOSGi single and multi bundle distributions
contain all the OSGI bundles required for a CXF endpoint be successfully
published.</p><p>CXF JAX-RS implementations has been integrated with DOSGi RI
1.1-SNAPSHOT whi
ch makes it possible to expose Java interfaces as RESTful services and consume
such services using a proxy-based client API.</p><p>Please see the <a
shape="rect"
href="http://cxf.apache.org/distributed-osgi-reference.html#DistributedOSGiReference-ServiceProviderproperties";>DOSGI
Reference page</a> ('org.apache.cxf.rs' properties) and a <a shape="rect"
class="external-link"
href="http://svn.apache.org/repos/asf/cxf/dosgi/trunk/samples/greeter_rest/";>greeter_rest</a>
sample for more information. Note that this demo can be run exactly as a
SOAP-based <a shape="rect"
href="http://cxf.apache.org/distributed-osgi-greeter-demo-walkthrough.html";>greeter</a>
demo as it registers and consumes a similar (but) JAX-RS annotated <a
shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/dosgi/trunk/samples/greeter_rest/interface/src/main/java/org/apache/cxf/dosgi/samples/greeter/rest/GreeterService.java";>GreeterService</a>.
In addition, this demo shows how one can register an
d consume a given interface (<a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/dosgi/trunk/samples/greeter_rest/interface/src/main/java/org/apache/cxf/dosgi/samples/greeter/rest/GreeterService2.java";>GreeterService2</a>)
without using explicit JAX-RS annotations but providing an out-of-band <a
shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/dosgi/trunk/samples/greeter_rest/interface/src/main/resources/OSGI-INF/cxf/jaxrs/GreeterService2-model.xml";>user
model description</a>.</p><h2 id="JAX-RS-OtherAdvancedFeatures">Other Advanced
Features</h2><p>CXF JAX-RS provides a number of advanced extensions such as the
support for the JMS transport, one-way invocations (HTTP and JMS), suspended
invocations (HTTP and JMS), making existing code REST-aware by applying
external user models, etc.</p><p>Please see the <a shape="rect"
href="jax-rs-advanced-features.html">JAX-RS Advanced Features</a> page for more
information.</p><h1 id="JAX-RS
-MavenPlugins">Maven Plugins</h1><p>Please see the <a shape="rect"
href="jax-rs-maven-plugins.html">JAX-RS Maven Plugins</a> page for more
information about the Maven plugins and archetypes which can help with creating
CXF JAX-RS applications.</p><h1 id="JAX-RS-Deployment">Deployment</h1><p>CXF
JAX-RS applications packaged as WAR archives can be deployed into standalone
Servlet containers such as Tomcat or Jetty.<br clear="none"> Please see the <a
shape="rect"
href="https://cwiki.apache.org/confluence/display/CXF20DOC/JAX-RS+Deployment";>JAX-RS
Deployment</a> page for the tips on how to deploy the CXF JAX-RS applications
into various Java EE and OSGI application servers successfully.</p><h1
id="JAX-RS-Third-partyprojects">Third-party projects</h1><ul><li>REST
Utilities: <a shape="rect" class="external-link"
href="https://github.com/taimos/RESTUtils";
rel="nofollow">RESTUtils</a></li></ul><h1
id="JAX-RS-References">References</h1><ul><li><a shape="rect"
class="external-link" href="http
://jcp.org/aboutJava/communityprocess/final/jsr311/index.html"
rel="nofollow">JSR-000311 JAX-RS: The JavaTM API for RESTful Web
Services</a></li><li><a shape="rect" class="external-link"
href="http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm";
rel="nofollow">Architectural Styles and the Design of Network-based Software
Architectures</a></li><li><a shape="rect" class="external-link"
href="http://en.wikipedia.org/wiki/Representational_State_Transfer";
rel="nofollow">Representational State Transfer - Wikipedia </a></li><li><a
shape="rect" class="external-link"
href="http://oreilly.com/catalog/9780596801694/"; rel="nofollow">RESTful Web
Services Cookbook - Solutions for Improving Scalability and Simplicity</a>
<em>by Subbu Allamarajuy</em> (O'Reilly Media, February 2010)</li><li><a
shape="rect" class="external-link"
href="http://oreilly.com/catalog/9780596158057/"; rel="nofollow">RESTful Java
with JAX-RS</a> <em>by Bill Burke</em> (O'Reilly Media, November
2009)</li><li><a shape="
rect" class="external-link" href="http://oreilly.com/catalog/9780596521134/";
rel="nofollow">Java Web Services: Up and Running </a> <em>by Martin Kalin</em>
(O'Reilly Media, February 2009)</li><li><a shape="rect" class="external-link"
href="http://oreilly.com/catalog/9780596529260/"; rel="nofollow">RESTful Web
Services - Web services for the real world</a> <em>by Leonard Richardson, Sam
Ruby</em> (O'Reilly Media, May 2007)</li><li><a shape="rect"
class="external-link"
href="http://www.oracle.com/technetwork/articles/javase/index-137171.html";
rel="nofollow">RESTful Web Services</a> <em>by Sameer Tyagi</em> (Oracle ,
August 2006)</li><li><a shape="rect" class="external-link"
href="http://www.crummy.com/writing/RESTful-Web-Services/";
rel="nofollow">RESTful Web Services - "Unofficial homepage for a book about
simple web services."</a> <em>Unknown</em></li><li><a shape="rect"
class="external-link" href="http://tomayko.com/writings/rest-to-my-wife";
rel="nofollow">How I Explained REST to My
Wife</a> <em>by Ryan Tomayko</em> (<a shape="rect" class="external-link"
href="http://tomayko.com"; rel="nofollow">http://tomayko.com</a>, December
2004)</li></ul><h1 id="JAX-RS-Howtocontribute">How to contribute</h1><p>CXF
JAX-RS implementation sits on top of the core CXF runtime and is quite
self-contained and isolated from other CXF modules such as jaxws and simple
frontends.</p><p>Please check the <a shape="rect" class="external-link"
href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&mode=hide&pid=12310511&sorter/order=DESC&sorter/field=priority&resolution=-1&component=12311911";>issue
list</a> and see if you are interested in fixing one of the issues.</p><p>If
you decide to go ahead then the fastest way to start is to</p><ul><li>do the
fast trunk build using '<code>mvn install -Pfastinstall</code>'</li><li>setup
the workspace 'mvn -Psetup.eclipse' which will create a workspace in a
'workspace' folder, next to 'trunk'</li><li>import
cxf modules from the trunk into the workspace and start working with the
cxf-frontend-jaxrs module</li></ul><p>If you are about to submit a patch after
building a trunk/rt/frontend/jaxrs, then please also run JAX-RS system tests in
trunk/systests/jaxrs :<br clear="none"> <code>> mvn install</code></p><p>You
can also check out the general <a shape="rect"
href="http://cxf.apache.org/getting-involved.html";>Getting Involved</a> web
page for more information on contributing.</p></div>
+</div></div><p>Please make sure the <code><a shape="rect"
href="http://cxf.apache.org/core";>http://cxf.apache.org/core</a></code>
namespace is in scope.</p><p>Starting from CXF 2.3.0 it is also possible to
convert log events into Atom entries and either push them to receivers or make
them available for polling.</p><p>Please see the <a shape="rect"
href="debugging-and-logging.html">Debugging and Logging</a> page for more
information.</p><h1 id="JAX-RS-AdvancedFeatures">Advanced Features</h1><h2
id="JAX-RS-Multiparts">Multiparts</h2><p>Multiparts can be handled in a number
of ways. The CXF core runtime provides advanced support for handling
attachments which CXF JAX-RS builds upon.</p><p>Please see the <a shape="rect"
href="jax-rs-multiparts.html">JAX-RS Multiparts</a> page for more
information.</p><h2 id="JAX-RS-SecureJAX-RSservices">Secure JAX-RS
services</h2><p>Transport level HTTPS security can be used to protect messages
exchanged between CXF JAX-RS endpoints and providers.</p><p
>Authentication and authorization can be enforced in a number of
>ways.</p><p>Please see the <a shape="rect"
>href="secure-jax-rs-services.html">Secure JAX-RS Services</a> page for more
>information.</p><p>Please also check <a shape="rect"
>href="http://cxf.apache.org/docs/jax-rs-xml-security.html";>JAX-RS XML
>Security</a>, <a shape="rect" href="jax-rs-saml.html">JAX-RS SAML</a> and <a
>shape="rect" href="jax-rs-oauth2.html">JAX-RS OAuth2</a> pages for more
>information about the advanced security topics.</p><h2
>id="JAX-RS-FailoverandLoadDistributionFeatures">Failover and Load
>Distribution Features</h2><p>Starting from CXF 2.4.1, CXF JAX-RS proxy and
>WebClient consumers can be backed up by failover and load distribution
>features.<br clear="none"> Please see the <a shape="rect"
>href="jax-rs-failover.html">JAX-RS Failover</a> page for more
>information.</p><h2 id="JAX-RS-Redirection">Redirection</h2><p>Starting from
>CXF 2.2.5 it is possible to redirect the request or response call to other se
rvlet resources by configuring CXFServlet or using CXF JAX-RS
RequestDispatcherProvider.</p><p>Please see the <a shape="rect"
href="jax-rs-redirection.html">JAX-RS Redirection</a> page for more
information.</p><h2 id="JAX-RS-XSLTandXPath">XSLT and XPath</h2><p>XSLT and
XPath are promoted and treated as first-class citizens in CXF JAX-RS. These
technologies can be very powerful when generating complex data or retrieving
data of interest out of complex XML fragments.</p><p>Please see the <a
shape="rect" href="jax-rs-advanced-xml.html">JAX-RS Advanced XML</a> page for
more information.</p><h2 id="JAX-RS-ComplexSearchQueries">Complex Search
Queries</h2><p>Using <a shape="rect"
href="http://cxf.apache.org/docs/jax-rs.html#JAX-RS-Parameterbeans";>query
parameter beans</a> provides a way to capture search requirements that can be
expressed by enumerating name/value pairs, for example, a query such as
'?name=CXF&version=2.3' can be captured by a bean containing setName and
setVersion met
hods. This 'template' bean can be used in the code to compare it against all
available local data.</p><p>Versions 2.3 and later of CXF JAXRS support another
option for doing advanced search queries using the <a shape="rect"
class="external-link"
href="http://tools.ietf.org/html/draft-nottingham-atompub-fiql-00";
rel="nofollow">Feed Item Query Language</a>(FIQL).</p><p>Please see the <a
shape="rect" href="jax-rs-search.html">JAX-RS Search</a> page for more
information.</p><h2
id="JAX-RS-Model-View-Controllersupport">Model-View-Controller
support</h2><p><strong>XSLT</strong><br clear="none"> Please see the <a
shape="rect" href="jax-rs-advanced-xml.html">JAX-RS Advanced XML</a> page for
more information. on how <code>XSLTJaxbProvider</code> can be used to generate
complex (X)HTML views.</p><p><strong>JSP</strong></p><p>With the introduction
of <code>RequestDispatcherProvider</code> it is now possible for JAXRS service
responses be redirected to JSP pages for further processing. Please s
ee the <a shape="rect" href="jax-rs-redirection.html">JAX-RS Redirection</a>
page for more information.</p><h2
id="JAX-RS-CombiningJAX-WSandJAX-RS">Combining JAX-WS and JAX-RS</h2><p>CXF
JAX-RS tries to make it easy for SOAP developers to experiment with JAX-RS and
combine both JAX-WS and JAX-RS in the same service bean when
needed.</p><p>Please see the <a shape="rect"
href="jax-rs-and-jax-ws.html">JAX-RS and JAX-WS</a> page for more
information.</p><h2 id="JAX-RS-IntegrationwithDistributedOSGi">Integration with
Distributed OSGi</h2><p>Distributed OSGi RI is a CXF <a shape="rect"
href="http://cxf.apache.org/distributed-osgi.html";>subproject</a>. DOSGi
mandates how registered Java interfaces can be exposed<br clear="none"> and
consumed as remote services. DOSGi single and multi bundle distributions
contain all the OSGI bundles required for a CXF endpoint be successfully
published.</p><p>CXF JAX-RS implementations has been integrated with DOSGi RI
1.1-SNAPSHOT which makes it possible
to expose Java interfaces as RESTful services and consume such services using
a proxy-based client API.</p><p>Please see the <a shape="rect"
href="http://cxf.apache.org/distributed-osgi-reference.html#DistributedOSGiReference-ServiceProviderproperties";>DOSGI
Reference page</a> ('org.apache.cxf.rs' properties) and a <a shape="rect"
class="external-link"
href="http://svn.apache.org/repos/asf/cxf/dosgi/trunk/samples/greeter_rest/";>greeter_rest</a>
sample for more information. Note that this demo can be run exactly as a
SOAP-based <a shape="rect"
href="http://cxf.apache.org/distributed-osgi-greeter-demo-walkthrough.html";>greeter</a>
demo as it registers and consumes a similar (but) JAX-RS annotated <a
shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/dosgi/trunk/samples/greeter_rest/interface/src/main/java/org/apache/cxf/dosgi/samples/greeter/rest/GreeterService.java";>GreeterService</a>.
In addition, this demo shows how one can register and consume a given int
erface (<a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/dosgi/trunk/samples/greeter_rest/interface/src/main/java/org/apache/cxf/dosgi/samples/greeter/rest/GreeterService2.java";>GreeterService2</a>)
without using explicit JAX-RS annotations but providing an out-of-band <a
shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/dosgi/trunk/samples/greeter_rest/interface/src/main/resources/OSGI-INF/cxf/jaxrs/GreeterService2-model.xml";>user
model description</a>.</p><h2 id="JAX-RS-OtherAdvancedFeatures">Other Advanced
Features</h2><p>CXF JAX-RS provides a number of advanced extensions such as the
support for the JMS transport, one-way invocations (HTTP and JMS), suspended
invocations (HTTP and JMS), making existing code REST-aware by applying
external user models, etc.</p><p>Please see the <a shape="rect"
href="jax-rs-advanced-features.html">JAX-RS Advanced Features</a> page for more
information.</p><h1 id="JAX-RS-MavenPlugins">Maven
Plugins</h1><p>Please see the <a shape="rect"
href="jax-rs-maven-plugins.html">JAX-RS Maven Plugins</a> page for more
information about the Maven plugins and archetypes which can help with creating
CXF JAX-RS applications.</p><h1 id="JAX-RS-Deployment">Deployment</h1><p>CXF
JAX-RS applications packaged as WAR archives can be deployed into standalone
Servlet containers such as Tomcat or Jetty.<br clear="none"> Please see the <a
shape="rect"
href="https://cwiki.apache.org/confluence/display/CXF20DOC/JAX-RS+Deployment";>JAX-RS
Deployment</a> page for the tips on how to deploy the CXF JAX-RS applications
into various Java EE and OSGI application servers successfully.</p><h1
id="JAX-RS-Third-partyprojects">Third-party projects</h1><ul><li>REST
Utilities: <a shape="rect" class="external-link"
href="https://github.com/taimos/RESTUtils";
rel="nofollow">RESTUtils</a></li></ul><h1
id="JAX-RS-References">References</h1><ul><li><a shape="rect"
class="external-link" href="http://jcp.org/aboutJava/
communityprocess/final/jsr311/index.html" rel="nofollow">JSR-000311 JAX-RS:
The JavaTM API for RESTful Web Services</a></li><li><a shape="rect"
class="external-link"
href="http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm";
rel="nofollow">Architectural Styles and the Design of Network-based Software
Architectures</a></li><li><a shape="rect" class="external-link"
href="http://en.wikipedia.org/wiki/Representational_State_Transfer";
rel="nofollow">Representational State Transfer - Wikipedia </a></li><li><a
shape="rect" class="external-link"
href="http://oreilly.com/catalog/9780596801694/"; rel="nofollow">RESTful Web
Services Cookbook - Solutions for Improving Scalability and Simplicity</a>
<em>by Subbu Allamarajuy</em> (O'Reilly Media, February 2010)</li><li><a
shape="rect" class="external-link"
href="http://oreilly.com/catalog/9780596158057/"; rel="nofollow">RESTful Java
with JAX-RS</a> <em>by Bill Burke</em> (O'Reilly Media, November
2009)</li><li><a shape="rect" class="external
-link" href="http://oreilly.com/catalog/9780596521134/"; rel="nofollow">Java
Web Services: Up and Running </a> <em>by Martin Kalin</em> (O'Reilly Media,
February 2009)</li><li><a shape="rect" class="external-link"
href="http://oreilly.com/catalog/9780596529260/"; rel="nofollow">RESTful Web
Services - Web services for the real world</a> <em>by Leonard Richardson, Sam
Ruby</em> (O'Reilly Media, May 2007)</li><li><a shape="rect"
class="external-link"
href="http://www.oracle.com/technetwork/articles/javase/index-137171.html";
rel="nofollow">RESTful Web Services</a> <em>by Sameer Tyagi</em> (Oracle ,
August 2006)</li><li><a shape="rect" class="external-link"
href="http://www.crummy.com/writing/RESTful-Web-Services/";
rel="nofollow">RESTful Web Services - "Unofficial homepage for a book about
simple web services."</a> <em>Unknown</em></li><li><a shape="rect"
class="external-link" href="http://tomayko.com/writings/rest-to-my-wife";
rel="nofollow">How I Explained REST to My Wife</a> <em>by Ryan
Tomayko</em> (<a shape="rect" class="external-link" href="http://tomayko.com";
rel="nofollow">http://tomayko.com</a>, December 2004)</li></ul><h1
id="JAX-RS-Howtocontribute">How to contribute</h1><p>CXF JAX-RS implementation
sits on top of the core CXF runtime and is quite self-contained and isolated
from other CXF modules such as jaxws and simple frontends.</p><p>Please check
the <a shape="rect" class="external-link"
href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&mode=hide&pid=12310511&sorter/order=DESC&sorter/field=priority&resolution=-1&component=12311911";>issue
list</a> and see if you are interested in fixing one of the issues.</p><p>If
you decide to go ahead then the fastest way to start is to</p><ul><li>do the
fast trunk build using '<code>mvn install -Pfastinstall</code>'</li><li>setup
the workspace 'mvn -Psetup.eclipse' which will create a workspace in a
'workspace' folder, next to 'trunk'</li><li>import cxf modules from the
trunk into the workspace and start working with the cxf-frontend-jaxrs
module</li></ul><p>If you are about to submit a patch after building a
trunk/rt/frontend/jaxrs, then please also run JAX-RS system tests in
trunk/systests/jaxrs :<br clear="none"> <code>> mvn install</code></p><p>You
can also check out the general <a shape="rect"
href="http://cxf.apache.org/getting-involved.html";>Getting Involved</a> web
page for more information on contributing.</p></div>
</div>
<!-- Content -->
</td>
