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 2013/06/29 21:48:05 UTC
svn commit: r867815 - in /websites/production/cxf/content:
cache/docs.pageCache cache/main.pageCache docs/jax-rs-search.html
dosgi-release-build.html
Author: buildbot
Date: Sat Jun 29 19:48:04 2013
New Revision: 867815
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/cache/main.pageCache
websites/production/cxf/content/docs/jax-rs-search.html
websites/production/cxf/content/dosgi-release-build.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/jax-rs-search.html
==============================================================================
--- websites/production/cxf/content/docs/jax-rs-search.html (original)
+++ websites/production/cxf/content/docs/jax-rs-search.html Sat Jun 29 19:48:04 2013
@@ -130,7 +130,7 @@ Apache CXF -- JAX-RS Search
<div id="ConfluenceContent"><p><span style="font-size:2em;font-weight:bold"> JAX-RS: Search </span></p>
<div>
-<ul><li><a shape="rect" href="#JAX-RSSearch-FIQLsearchqueries">FIQL search queries</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-Introduction">Introduction</a></li><li><a shape="rect" href="#JAX-RSSearch-WhentouseFIQL">When to use FIQL</a></li><li><a shape="rect" href="#JAX-RSSearch-DependenciesandConfiguration">Dependencies and Configuration</a></li><li><a shape="rect" href="#JAX-RSSearch-WorkingwithFIQLqueries">Working with FIQL queries</a></li><li><a shape="rect" href="#JAX-RSSearch-CapturingFIQLqueries">Capturing FIQL queries</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-Mappingofquerypropertiestobeanproperties">Mapping of query properties to bean properties</a></li><li><a shape="rect" href="#JAX-RSSearch-Parserproperties">Parser properties</a></li></ul><li><a shape="rect" href="#JAX-RSSearch-Mappingofquerypropertiestocolumn%2Ffieldnames">Mapping of query properties to column/field names</a></li><li><a shape="rect" href="#JAX-RSSearch-SearchBean">SearchBean</a></li><
li><a shape="rect" href="#JAX-RSSearch-ConvertingFIQLqueries">Converting FIQL queries</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-SQL">SQL</a></li><li><a shape="rect" href="#JAX-RSSearch-JPA2.0">JPA 2.0</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-Countexpressions">Count expressions</a></li></ul><li><a shape="rect" href="#JAX-RSSearch-Lucene">Lucene</a></li><li><a shape="rect" href="#JAX-RSSearch-LDAP">LDAP</a></li><li><a shape="rect" href="#JAX-RSSearch-Customvisitors">Custom visitors</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-Untypedconverters">Untyped converters</a></li><li><a shape="rect" href="#JAX-RSSearch-Typedconverters">Typed converters</a></li><li><a shape="rect" href="#JAX-RSSearch-Customparsing">Custom parsing</a></li></ul></ul><li><a shape="rect" href="#JAX-RSSearch-ConvertingFIQLquerieswithQueryContext">Converting FIQL queries with QueryContext</a></li><li><a shape="rect" href="#JAX-RSSearch-PlainqueriestoFIQLconversion">Plain queries to FIQL co
nversion</a></li><li><a shape="rect" href="#JAX-RSSearch-SearchExpressionsinURIPathsegments">Search Expressions in URI Path segments</a></li><li><a shape="rect" href="#JAX-RSSearch-Queriesinvolvingmultipleentities">Queries involving multiple entities</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-Basicqueries">Basic queries</a></li><li><a shape="rect" href="#JAX-RSSearch-Complexqueries">Complex queries</a></li></ul><li><a shape="rect" href="#JAX-RSSearch-BuildingFIQLqueries">Building FIQL queries</a></li><li><a shape="rect" href="#JAX-RSSearch-Usingdatesinqueries">Using dates in queries</a></li><li><a shape="rect" href="#JAX-RSSearch-Alternativequerylanguages">Alternative query languages</a></li></ul></ul></div>
+<ul><li><a shape="rect" href="#JAX-RSSearch-FIQLsearchqueries">FIQL search queries</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-Introduction">Introduction</a></li><li><a shape="rect" href="#JAX-RSSearch-WhentouseFIQL">When to use FIQL</a></li><li><a shape="rect" href="#JAX-RSSearch-DependenciesandConfiguration">Dependencies and Configuration</a></li><li><a shape="rect" href="#JAX-RSSearch-WorkingwithFIQLqueries">Working with FIQL queries</a></li><li><a shape="rect" href="#JAX-RSSearch-CapturingFIQLqueries">Capturing FIQL queries</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-Mappingofquerypropertiestobeanproperties">Mapping of query properties to bean properties</a></li><li><a shape="rect" href="#JAX-RSSearch-Parserproperties">Parser properties</a></li></ul><li><a shape="rect" href="#JAX-RSSearch-Mappingofquerypropertiestocolumn%2Ffieldnames">Mapping of query properties to column/field names</a></li><li><a shape="rect" href="#JAX-RSSearch-SearchBean">SearchBean</a></li><
li><a shape="rect" href="#JAX-RSSearch-ConvertingFIQLqueries">Converting FIQL queries</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-SQL">SQL</a></li><li><a shape="rect" href="#JAX-RSSearch-JPA2.0">JPA 2.0</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-Countexpressions">Count expressions</a></li></ul><li><a shape="rect" href="#JAX-RSSearch-Lucene">Lucene</a></li><li><a shape="rect" href="#JAX-RSSearch-LDAP">LDAP</a></li><li><a shape="rect" href="#JAX-RSSearch-Customvisitors">Custom visitors</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-Untypedconverters">Untyped converters</a></li><li><a shape="rect" href="#JAX-RSSearch-Typedconverters">Typed converters</a></li><li><a shape="rect" href="#JAX-RSSearch-Customparsing">Custom parsing</a></li></ul></ul><li><a shape="rect" href="#JAX-RSSearch-ConvertingFIQLquerieswithQueryContext">Converting FIQL queries with QueryContext</a></li><li><a shape="rect" href="#JAX-RSSearch-PlainqueriestoFIQLconversion">Plain queries to FIQL co
nversion</a></li><li><a shape="rect" href="#JAX-RSSearch-SearchExpressionsinURIPathsegments">Search Expressions in URI Path segments</a></li><li><a shape="rect" href="#JAX-RSSearch-Queriesinvolvingmultipleentities">Queries involving multiple entities</a></li><ul><li><a shape="rect" href="#JAX-RSSearch-Basicqueries">Basic queries</a></li><li><a shape="rect" href="#JAX-RSSearch-Complexqueries">Complex queries</a></li></ul><li><a shape="rect" href="#JAX-RSSearch-Validation">Validation</a></li><li><a shape="rect" href="#JAX-RSSearch-BuildingFIQLqueries">Building FIQL queries</a></li><li><a shape="rect" href="#JAX-RSSearch-Usingdatesinqueries">Using dates in queries</a></li><li><a shape="rect" href="#JAX-RSSearch-Alternativequerylanguages">Alternative query languages</a></li></ul></ul></div>
<h1><a shape="rect" name="JAX-RSSearch-FIQLsearchqueries"></a>FIQL search queries</h1>
@@ -1214,12 +1214,19 @@ public class BooksResource {
}
}
-
-Note this code assumes that "bookId" is mapped to "Book.id" property with the help of the contextual "search.bean.property.map" property as explained earlier.
-
]]></script>
</div></div>
+<p>Note this code assumes that "bookId" is mapped to "Book.id" property with the help of the contextual "search.bean.property.map" property as explained earlier.</p>
+
+<h2><a shape="rect" name="JAX-RSSearch-Validation"></a>Validation</h2>
+
+<p>First option is to have a bean capturing specific property values do a domain specific validation. For example, a Book.class may have its setName(String name) method validating the name value. <br clear="none">
+Another option is to inject a custom <a shape="rect" class="external-link" href="http://svn.apache.org/repos/asf/cxf/trunk/rt/rs/extensions/search/src/main/java/org/apache/cxf/jaxrs/ext/search/visitor/PropertyValidator.java">validator</a> into a visitor which is used to build the untyped or typed query.</p>
+
+<p>Finally, avoid letting users to use properties whose values which can not be well validated in the application code. Using a typed capturing bean like Book.class offers a perfect option to limit a number of supported properties to the ones known to be related to Books.</p>
+
+
<h2><a shape="rect" name="JAX-RSSearch-BuildingFIQLqueries"></a>Building FIQL queries</h2>
<p>CXF 2.4.0 introduces <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/ext/search/client/SearchConditionBuilder.java">SearchConditionBuilder</a> which makes it simpler to build FIQL queries. SearchConditionBuilder is an abstract class that returns a FIQL builder by default:</p>
Modified: websites/production/cxf/content/dosgi-release-build.html
==============================================================================
--- websites/production/cxf/content/dosgi-release-build.html (original)
+++ websites/production/cxf/content/dosgi-release-build.html Sat Jun 29 19:48:04 2013
@@ -160,6 +160,11 @@ Apache CXF -- DOSGi release build
<ul><li>mvn release:prepare</li><li>mvn release:perform</li><li>go to <a shape="rect" class="external-link" href="https://repository.apache.org">https://repository.apache.org</a>, log in with you apache id, find your staging repo and close it</li></ul>
+<h2><a shape="rect" name="DOSGireleasebuild-Checkcompleteness"></a>Check completeness</h2>
+
+<ul><li>Check the tag is there in subversion and contains the correct version in the poms</li><li>Check that the release notes are correct</li><li>Check that the staging repo is visible and contains the correct release version</li></ul>
+
+
<h2><a shape="rect" name="DOSGireleasebuild-Sendvotemailtodevlist"></a>Send vote mail to dev list</h2>