cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r867815 - in /websites/production/cxf/content: cache/docs.pageCache cache/main.pageCache docs/jax-rs-search.html dosgi-release-build.html
Date Sat, 29 Jun 2013 19:48:05 GMT
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>
 
 



Mime
View raw message