From aa98f38c52254b5c8407bb5d24dec6b05f06b85c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Timo=20Westk=C3=A4mper?= <timo.westkamper@gmail.com>
Date: Wed, 8 Oct 2014 21:29:26 +0300
Subject: [PATCH] Add CTE docs

---
 .../docbook/en-US/content/tutorials/sql.xml   | 21 +++++++++++
 .../com/mysema/query/sql/SQLCommonQuery.java  | 36 +++++++++++++++++++
 2 files changed, 57 insertions(+)

diff --git a/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml b/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml
index f81a6a660..9335a259f 100644
--- a/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml
+++ b/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml
@@ -728,6 +728,27 @@ query.from(employee)
 ]]></programlisting>
   
   </sect2>
+
+  <sect2>
+
+    <title>Common table expressions</title>
+
+    <para>Common table expressions are supported in Querydsl SQL via two syntax variants</para>
+
+    <programlisting language="java"><![CDATA[
+query.with(employee, sq().from(employee).where(employee.name.startsWith("A")).list(employee.all()))
+     .from(...)
+]]></programlisting>
+
+    <para>And using a column listing</para>
+
+    <programlisting language="java"><![CDATA[
+query.with(employee, employee.id, employee.name)
+     .as(sq().from(employee).where(employee.name.startsWith("A")).list(employee.id, employee.name))
+     .from(...)
+]]></programlisting>
+
+  </sect2>
   
   <sect2>
   
diff --git a/querydsl-sql/src/main/java/com/mysema/query/sql/SQLCommonQuery.java b/querydsl-sql/src/main/java/com/mysema/query/sql/SQLCommonQuery.java
index b17571a9f..4400c4c49 100644
--- a/querydsl-sql/src/main/java/com/mysema/query/sql/SQLCommonQuery.java
+++ b/querydsl-sql/src/main/java/com/mysema/query/sql/SQLCommonQuery.java
@@ -290,6 +290,12 @@ public interface SQLCommonQuery<Q extends SQLCommonQuery<Q>> extends Query<Q> {
     /**
      * Adds a common table expression
      *
+     * <p>Usage</p>
+     * <pre>
+     * query.with(alias, subQuery)
+     *      .from(...)
+     * </pre>
+     *
      * @param alias
      * @param o
      * @return
@@ -299,6 +305,12 @@ public interface SQLCommonQuery<Q extends SQLCommonQuery<Q>> extends Query<Q> {
     /**
      * Adds a common table expression
      *
+     * <p>Usage</p>
+     * <pre>
+     * query.with(alias, subQuery)
+     *      .from(...)
+     * </pre>
+     *
      * @param alias
      * @param query
      * @return
@@ -308,6 +320,12 @@ public interface SQLCommonQuery<Q extends SQLCommonQuery<Q>> extends Query<Q> {
     /**
      * Adds a common table expression
      *
+     * <p>Usage</p>
+     * <pre>
+     * query.with(alias, columns...).as(subQuery)
+     *      .from(...)
+     * </pre>
+     *
      * @param alias
      * @param columns
      * @return
@@ -317,6 +335,12 @@ public interface SQLCommonQuery<Q extends SQLCommonQuery<Q>> extends Query<Q> {
     /**
      * Adds a common table expression
      *
+     * <p>Usage</p>
+     * <pre>
+     * query.withRecursive(alias, subQuery)
+     *      .from(...)
+     * </pre>
+     *
      * @param alias
      * @param o
      * @return
@@ -326,6 +350,12 @@ public interface SQLCommonQuery<Q extends SQLCommonQuery<Q>> extends Query<Q> {
     /**
      * Adds a common table expression
      *
+     * <p>Usage</p>
+     * <pre>
+     * query.withRecursive(alias, subQuery)
+     *      .from(...)
+     * </pre>
+     *
      * @param alias
      * @param query
      * @return
@@ -335,6 +365,12 @@ public interface SQLCommonQuery<Q extends SQLCommonQuery<Q>> extends Query<Q> {
     /**
      * Adds a common table expression
      *
+     * <p>Usage</p>
+     * <pre>
+     * query.withRecursive(alias, columns...).as(subQuery)
+     *      .from(...)
+     * </pre>
+     *
      * @param alias
      * @param columns
      * @return