feat: T-SQL FOR ... clause

- fixes JSQLParser#1800

src/main/java/net/sf/jsqlparser/expression/TrimFunction.java

@@ -96,7 +96,7 @@ public void accept(ExpressionVisitor expressionVisitor) {
         expressionVisitor.visit(this);
     }
 
-    StringBuilder appendTo(StringBuilder builder) {
+    public StringBuilder appendTo(StringBuilder builder) {
         builder.append("Trim(");
 
         if (trimSpecification != null) {

src/main/java/net/sf/jsqlparser/parser/ASTNodeAccessImpl.java

@@ -23,4 +23,15 @@ public void setASTNode(SimpleNode node) {
         this.node = node;
     }
 
+    public StringBuilder appendTo(StringBuilder builder) {
+        SimpleNode simpleNode = getASTNode();
+        Token token = simpleNode.jjtGetFirstToken();
+        Token lastToken = simpleNode.jjtGetLastToken();
+        while (token.next != null && token.absoluteEnd <= lastToken.absoluteEnd) {
+            builder.append(" ").append(token.image);
+            token = token.next;
+        }
+        return builder;
+    }
+
 }

src/main/java/net/sf/jsqlparser/statement/select/ForClause.java

@@ -0,0 +1,29 @@
+package net.sf.jsqlparser.statement.select;
+
+import net.sf.jsqlparser.parser.ASTNodeAccessImpl;
+
+public class ForClause extends ASTNodeAccessImpl {
+    public enum ForOption {
+        BROWSE, XML, JSON;
+
+        public static ForOption from(String option) {
+            return Enum.valueOf(ForOption.class, option.toUpperCase());
+        }
+    }
+
+    private ForOption forOption;
+
+    public ForOption getForOption() {
+        return forOption;
+    }
+
+    public ForClause setForOption(String forOption) {
+        this.forOption = ForOption.from(forOption);
+        return this;
+    }
+
+    @Override
+    public String toString() {
+        return appendTo(new StringBuilder()).toString();
+    }
+}

src/main/java/net/sf/jsqlparser/statement/select/Select.java

@@ -30,6 +30,9 @@ public abstract class Select extends ASTNodeAccessImpl implements Statement, Exp
     Fetch fetch;
     WithIsolation isolation;
     boolean oracleSiblings = false;
+
+    ForClause forClause = null;
+
     List<OrderByElement> orderByElements;
 
     public static String orderByToString(List<OrderByElement> orderByElements) {
@@ -154,6 +157,15 @@ public Select withOracleSiblings(boolean oracleSiblings) {
         return this;
     }
 
+    public ForClause getForClause() {
+        return forClause;
+    }
+
+    public Select setForClause(ForClause forClause) {
+        this.forClause = forClause;
+        return this;
+    }
+
     public List<OrderByElement> getOrderByElements() {
         return orderByElements;
     }
@@ -261,6 +273,10 @@ public StringBuilder appendTo(StringBuilder builder) {
 
         appendSelectBodyTo(builder);
 
+        if (forClause != null) {
+            forClause.appendTo(builder);
+        }
+
         builder.append(orderByToString(oracleSiblings, orderByElements));
 
         if (limitBy != null) {

src/main/java/net/sf/jsqlparser/util/deparser/ExpressionDeParser.java

@@ -820,12 +820,12 @@ public void visit(IntervalExpression intervalExpression) {
         if (intervalExpression.isUsingIntervalKeyword()) {
             buffer.append("INTERVAL ");
         }
-        if (intervalExpression.getExpression()!=null) {
+        if (intervalExpression.getExpression() != null) {
             intervalExpression.getExpression().accept(this);
         } else {
             buffer.append(intervalExpression.getParameter());
         }
-        if (intervalExpression.getIntervalType()!=null) {
+        if (intervalExpression.getIntervalType() != null) {
             buffer.append(" ").append(intervalExpression.getIntervalType());
         }
     }

src/main/java/net/sf/jsqlparser/util/deparser/SelectDeParser.java

@@ -272,6 +272,10 @@ public void visit(PlainSelect plainSelect) {
                 buffer.append(" SKIP LOCKED");
             }
         }
+        if (plainSelect.getForClause() != null) {
+            plainSelect.getForClause().appendTo(buffer);
+        }
+
         if (plainSelect.getOrderByElements() != null) {
             new OrderByDeParser(expressionVisitor, buffer).deParse(plainSelect.isOracleSiblings(),
                     plainSelect.getOrderByElements());

src/test/java/net/sf/jsqlparser/statement/select/ForClauseTest.java

@@ -0,0 +1,93 @@
+package net.sf.jsqlparser.statement.select;
+
+import net.sf.jsqlparser.JSQLParserException;
+import net.sf.jsqlparser.test.TestUtils;
+import org.junit.jupiter.api.Test;
+
+class ForClauseTest {
+
+    @Test
+    void testForBrowse() throws JSQLParserException {
+        String sqlStr = "SELECT * FROM table FOR BROWSE";
+        TestUtils.assertSqlCanBeParsedAndDeparsed(sqlStr, true);
+    }
+
+    @Test
+    void testForXMLPath() throws JSQLParserException {
+        String sqlStr =
+                "SELECT * " +
+                        "   FROM table " +
+                        "   FOR XML PATH('something'), ROOT('trkseg'), TYPE, BINARY BASE64, ELEMENTS ABSENT ";
+        TestUtils.assertSqlCanBeParsedAndDeparsed(sqlStr, true);
+    }
+
+    @Test
+    void testForXMLRaw() throws JSQLParserException {
+        String sqlStr =
+                "SELECT * " +
+                        "   FROM table " +
+                        "   FOR XML RAW('something'), ROOT('trkseg'), TYPE, BINARY BASE64, XMLDATA ";
+        TestUtils.assertSqlCanBeParsedAndDeparsed(sqlStr, true);
+    }
+
+    @Test
+    void testForXMLAuto() throws JSQLParserException {
+        String sqlStr =
+                "SELECT * " +
+                        "   FROM table " +
+                        "   FOR XML AUTO, ROOT('trkseg'), TYPE, BINARY BASE64, XMLDATA ";
+        TestUtils.assertSqlCanBeParsedAndDeparsed(sqlStr, true);
+    }
+
+    @Test
+    void testForXMLExplicit() throws JSQLParserException {
+        String sqlStr =
+                "SELECT * " +
+                        "   FROM table " +
+                        "   FOR XML EXPLICIT, ROOT('trkseg'), TYPE, BINARY BASE64, XMLDATA ";
+        TestUtils.assertSqlCanBeParsedAndDeparsed(sqlStr, true);
+    }
+
+    @Test
+    void testForXML() throws JSQLParserException {
+        String sqlStr =
+                "SELECT * " +
+                        "   FROM table " +
+                        "   FOR XML EXPLICIT, ROOT('trkseg'), TYPE, BINARY BASE64, XMLDATA " +
+                        "UNION ALL " +
+                        "SELECT * " +
+                        "   FROM table " +
+                        "   FOR XML EXPLICIT, ROOT('trkseg'), TYPE, BINARY BASE64, XMLDATA " +
+                        "UNION ALL " +
+                        "SELECT * " +
+                        "   FROM table " +
+                        "   FOR XML AUTO, ROOT('trkseg'), TYPE, BINARY BASE64, XMLDATA " +
+                        "UNION ALL " +
+                        "SELECT * " +
+                        "   FROM table " +
+                        "   FOR XML RAW('something'), ROOT('trkseg'), TYPE, BINARY BASE64, XMLDATA ";
+        TestUtils.assertSqlCanBeParsedAndDeparsed(sqlStr, true);
+    }
+
+    @Test
+    void testForJSON() throws JSQLParserException {
+        String sqlStr =
+                "SELECT * " +
+                        "   FROM table " +
+                        "   FOR JSON AUTO, ROOT('trkseg'), WITHOUT_ARRAY_WRAPPER, INCLUDE_NULL_VALUES "
+                        +
+                        "UNION ALL " +
+                        "SELECT * " +
+                        "   FROM table " +
+                        "   FOR JSON PATH, ROOT('trkseg'), INCLUDE_NULL_VALUES, WITHOUT_ARRAY_WRAPPER ";
+        TestUtils.assertSqlCanBeParsedAndDeparsed(sqlStr, true);
+    }
+
+    @Test
+    void testIssue1800() throws JSQLParserException {
+        String sqlStr =
+                "SELECT (SELECT '1.0' AS '@Version', (SELECT 'Test' AS 'name', (SELECT (SELECT DISTINCT 51.64315 AS '@lat', 14.31709 AS '@lon' FOR XML PATH('trkpt'), TYPE) FOR XML PATH(''), ROOT('trkseg'), TYPE) FOR XML PATH('trk'), TYPE) FOR XML PATH('gpx'), TYPE) FOR XML PATH('')";
+        TestUtils.assertSqlCanBeParsedAndDeparsed(sqlStr, true);
+    }
+
+}

src/test/java/net/sf/jsqlparser/statement/select/SelectTest.java

@@ -4213,7 +4213,8 @@ public void testSqlContainIsNullFunctionShouldBeParsed3() throws JSQLParserExcep
     @Test
     public void testForXmlPath() throws JSQLParserException {
         assertSqlCanBeParsedAndDeparsed(
-                "SELECT '|' + person_name FROM person JOIN person_group ON person.person_id = person_group.person_id WHERE person_group.group_id = 1 FOR XML PATH('')");
+                "SELECT '|' + person_name FROM person JOIN person_group ON person.person_id = person_group.person_id WHERE person_group.group_id = 1 FOR XML PATH('')",
+                true);
     }
 
     // @Test