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>
