Added reference documentation for Sorts and Projections.

 JAVA-1776, JAVA-1777

Author: jyemin

docs/reference/content/builders/index.md

@@ -11,4 +11,6 @@ title = "Builders"
 
 The driver provides several classes that make it easier to use the CRUD API.
 
-- [Filters]({{< relref "filters.md" >}}): Documentation of the driver's support for query filters
+- [Filters]({{< relref "filters.md" >}}): Documentation of the driver's support for building query filters
+- [Projections]({{< relref "projections.md" >}}): Documentation of the driver's support for building projections
+- [Sorts]({{< relref "sorts.md" >}}): Documentation of the driver's support for building sort criteria

docs/reference/content/builders/projections.md

@@ -0,0 +1,133 @@
++++
+date = "2015-03-19T14:27:51-04:00"
+title = "Projections"
+[menu.main]
+  parent = "Builders"
+  weight = 20
+  pre = "<i class='fa'></i>"
++++
+
+## Filters
+
+The [`Projections`]({{< apiref "com/mongodb/client/model/Projections" >}}) class provides static factory methods for all the MongoDB 
+projection opererators.  Each method returns an instance of the [`Bson`]({{< relref "bson/documents.md#bson" >}}) type, which can in turn
+be passed to any method that expects a projection.
+
+For brevity, you may choose to import the methods of the `Projections` class statically:
+
+```java
+import com.mongodb.client.model.Projections.*;
+```
+  
+All the examples below assume this static import.
+
+### Inclusion
+
+By default, all fields of each document are projected.  To specify the inclusion of one or more fields (which implicitly excludes all 
+other fields except `_id`), use the `include` method.  
+
+This example includes the `quantity` field and (implicitly) the `_id` field:
+
+```java
+include("quantity")
+```
+
+This example includes the `quantity` and `totalAmount` fields and (implicitly) the `_id` field:
+
+```java
+include("quantity", "totalAmount")
+```
+
+### Exclusion
+
+To specify the exclusion of one or more fields (which implicitly includes all other fields), use the `exclude` method.
+
+This example excludes the `quantity` field:
+
+```java
+exclude("quantity")
+```
+
+This example excludes the `quantity` and `totalAmount` fields:
+
+```java
+exclude("quantity", "totalAmount")
+```
+
+### Exclusion of _id
+
+To specify the exclusion of the `_id` field, use the `excludeId` method:
+ 
+```java
+excludeId()
+```
+
+which is just shorthand for:
+
+```java
+exclude("_id")
+```
+
+### Array Element Match with a Supplied Filter
+
+To specify a projection that includes only the first element of an array that matches a supplied query filter (the 
+[elemMatch]({{< docsref "reference/operator/projection/elemMatch" >}}) operator), use the `elemMatch` method that takes a 
+field name and a filter. 
+
+This example projects the first element of the `orders` array where the `quantity` field is greater that `3`:
+  
+```java
+elemMatch("orders", Filters.gt("quantity", 3))
+```
+
+### Array Element Match with an Implicit Filter
+
+To specify a projection that includes only the first element of an array that matches the filter supplied as part of the query (the 
+[positional $ operator]({{< docsref "reference/operator/projection/positional/#projection" >}})), use the `elemMatch` method that takes 
+just a field name.
+
+This example projects the first element of the `orders` array that matches the query filter:
+
+```java
+elemMatch("orders")
+```
+     
+### Slice
+
+To project [a slice of an array]({{< docsref "reference/operator/projection/slice" >}}), use one of the `slice` methods. 
+
+This example projects the first `7` elements of the `tags` array:
+
+```java
+slice("tags", 7)
+```
+
+This example skips the first `2` elements of the `tags` array and projects the next `5`:
+
+```java
+slice("tags", 2, 5)
+```
+
+### Text Score
+
+To specify a projection of [the score of a `$text` query]({{< docsref "reference/operator/query/text/#return-the-text-search-score" >}}),
+use the `metaTextScore` method to specify the name of the projected field.
+
+This example projects the text score as the value of the `score` field:
+
+```java
+metaTextScore("score")
+```
+
+
+### Combining Projections
+
+To combine multiple projections, use the `fields` method.
+
+This example includes the `quantity` and `totalAmount` fields and excludes the `_id` field:
+
+```java
+fields(include("quantity", "totalAmount"), excludeId()) 
+```
+
+

docs/reference/content/builders/sorts.md

@@ -0,0 +1,79 @@
++++
+date = "2015-03-19T14:27:51-04:00"
+title = "Sort Criteria  "
+[menu.main]
+  parent = "Builders"
+  weight = 30
+  pre = "<i class='fa'></i>"
++++
+
+## Sorts
+
+The [`Sorts`]({{< apiref "com/mongodb/client/model/Sorts" >}}) class provides static factory methods for all the MongoDB sort criteria 
+operators.  Each method returns an instance of the [`Bson`]({{< relref "bson/documents.md#bson" >}}) type, which can in turn be passed to
+any method that expects sort criteria.
+
+For brevity, you may choose to import the methods of the `Sorts` class statically:
+
+```java
+import com.mongodb.client.model.Sorts.*;
+```
+  
+All the examples below assume this static import.
+
+### Ascending
+
+To specify an ascending sort, use one of the `ascending` methods.
+
+This example specifies an ascending sort on the `quantity` field:
+
+```java
+ascending("quantity")
+```
+
+This example specifies an ascending sort on the `quantity` field, followed by an ascending sort on the `totalAmount` field:
+
+```java
+ascending("quantity", "totalAmount") 
+```
+
+### Descending
+
+To specify a descending sort, use one of the `descending` methods.
+
+This example specifies a descending sort on the `quantity` field:
+
+```java
+descending("quantity")
+```
+
+This example specifies a descending sort on the `quantity` field, followed by a descending sort on the `totalAmount` field:
+
+
+```java
+descending("quantity", "totalAmount") 
+```
+
+### Text Score
+
+To specify a sort by [the score of a `$text` query]({{< docsref "reference/operator/query/text/#sort-by-text-search-score" >}}), use the 
+`metaTextScore` method to specify the name of the projected field.
+
+This example specifies a sort on the score of a `$text` query that will be projected into the `scoreValue` field in a projection on the 
+same query:
+
+```java
+metaTextScore("scoreValue")
+```
+
+### Combining sort criteria
+
+To specify the combination of multiple sort criteria, use the `orderBy` method.
+
+This example specifies an ascending sort on the `quantity` field, followed by an ascending sort on the `totalAmount` field, followed by a 
+descending sort on the `orderDate` field:
+
+```java
+orderBy(ascending("quantity", "totalAmount"), descending("orderDate"))
+```
+