Spring/spring-data-commons
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

DATACMNS-810 - Improvements to the Query by Example documentation.

Browse Source 
Fixed a few left over references to ExampleSpec which is now ExampleMatcher. Removed references to previous model of typed and untyped matchers.
This commit is contained in:
Oliver Gierke
2016-03-17 21:39:06 +01:00
parent 26f725be0d
commit ef7315a48f
1 changed files with 6 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
src/main/asciidoc/query-by-example.adoc
View File

@@ -86,9 +86,9 @@ You can read more about <<query.by.example.execution, Query by Example Execution
[[query.by.example.matcher]]
=== Example matchers
Examples are not limited to default settings. You can specify own defaults for string matching, null handling and property-specific settings using the `ExampleMatcher`. `ExampleMatcher` comes in two flavors: untyped and typed. By default `Example.of(Person.class)` uses an untyped `ExampleMatcher`. Using untyped `ExampleMatcher` will use the Repository entity information to determine the type to query and has no control over inheritance queries. Also, untyped `ExampleMatcher` will use the probe type when using with a Template to determine the type to query. Read more about <<query.by.example.matcher.typed,typed `ExampleMatcher`>> below.
Examples are not limited to default settings. You can specify own defaults for string matching, null handling and property-specific settings using the `ExampleMatcher`.
.Untyped Example Spec with customized matching
.Example matcher with customized matching
====
[source,java]
----
@@ -118,7 +118,7 @@ You can specify behavior for individual properties (e.g. "firstname" and "lastna
====
[source,java]
----
ExampleMatcher exampleSpec = ExampleMatcher.untyped()
ExampleMatcher matcher = ExampleMatcher.matching()
.withMatcher("firstname", endsWith())
.withMatcher("lastname", startsWith().ignoreCase());
}
@@ -131,9 +131,9 @@ Another style to configure matcher options is by using Java 8 lambdas. This appr
====
[source,java]
----
ExampleMatcher exampleSpec = ExampleMatcher.untyped()
.withMatcher("firstname", matcher -> matcher.endsWith())
.withMatcher("firstname", matcher -> matcher.startsWith());
ExampleMatcher matcher = ExampleMatcher.matching()
.withMatcher("firstname", match -> match.endsWith())
.withMatcher("firstname", match -> match.startsWith());
}
----
====