Feature/pmi 66 initial statment builder

.classpath

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+  <classpathentry kind="src" path="src/test/java" output="target/test-classes" including="**/*.java"/>
+  <classpathentry kind="src" path="src/main/java" including="**/*.java"/>
+  <classpathentry kind="output" path="target/classes"/>
+  <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.8"/>
+  <classpathentry kind="var" path="M2_REPO/org/junit/jupiter/junit-jupiter-api/5.3.1/junit-jupiter-api-5.3.1.jar" sourcepath="M2_REPO/org/junit/jupiter/junit-jupiter-api/5.3.1/junit-jupiter-api-5.3.1-sources.jar"/>
+  <classpathentry kind="var" path="M2_REPO/org/apiguardian/apiguardian-api/1.0.0/apiguardian-api-1.0.0.jar" sourcepath="M2_REPO/org/apiguardian/apiguardian-api/1.0.0/apiguardian-api-1.0.0-sources.jar"/>
+  <classpathentry kind="var" path="M2_REPO/org/opentest4j/opentest4j/1.1.1/opentest4j-1.1.1.jar" sourcepath="M2_REPO/org/opentest4j/opentest4j/1.1.1/opentest4j-1.1.1-sources.jar"/>
+  <classpathentry kind="var" path="M2_REPO/org/junit/platform/junit-platform-commons/1.3.1/junit-platform-commons-1.3.1.jar" sourcepath="M2_REPO/org/junit/platform/junit-platform-commons/1.3.1/junit-platform-commons-1.3.1-sources.jar"/>
+  <classpathentry kind="var" path="M2_REPO/org/junit/jupiter/junit-jupiter-engine/5.3.1/junit-jupiter-engine-5.3.1.jar" sourcepath="M2_REPO/org/junit/jupiter/junit-jupiter-engine/5.3.1/junit-jupiter-engine-5.3.1-sources.jar"/>
+  <classpathentry kind="var" path="M2_REPO/org/junit/platform/junit-platform-engine/1.3.1/junit-platform-engine-1.3.1.jar" sourcepath="M2_REPO/org/junit/platform/junit-platform-engine/1.3.1/junit-platform-engine-1.3.1-sources.jar"/>
+  <classpathentry kind="var" path="M2_REPO/org/junit/platform/junit-platform-launcher/1.3.1/junit-platform-launcher-1.3.1.jar" sourcepath="M2_REPO/org/junit/platform/junit-platform-launcher/1.3.1/junit-platform-launcher-1.3.1-sources.jar"/>
+  <classpathentry kind="var" path="M2_REPO/org/hamcrest/hamcrest-all/1.3/hamcrest-all-1.3.jar" sourcepath="M2_REPO/org/hamcrest/hamcrest-all/1.3/hamcrest-all-1.3-sources.jar"/>
+</classpath>

.gitignore

@@ -0,0 +1,7 @@
+/bin/
+/target/
+**/*.md.html
+**/*.bak
+**/*.swp
+**/*.log
+**/*.out

.project

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+  <name>sql-statement-builder</name>
+  <comment>This module provides a Builder for SQL statements that helps creating the correct structure and validates variable parts of the statements. NO_M2ECLIPSE_SUPPORT: Project files created with the maven-eclipse-plugin are not supported in M2Eclipse.</comment>
+  <projects/>
+  <buildSpec>
+    <buildCommand>
+      <name>org.eclipse.jdt.core.javabuilder</name>
+    </buildCommand>
+    <buildCommand>
+      <name>org.eclipse.m2e.core.maven2Builder</name>
+    </buildCommand>
+  </buildSpec>
+  <natures>
+    <nature>org.eclipse.jdt.core.javanature</nature>
+    <nature>org.eclipse.m2e.core.maven2Nature</nature>
+  </natures>
+</projectDescription>

.settings/org.eclipse.core.resources.prefs

@@ -0,0 +1,4 @@
+eclipse.preferences.version=1
+encoding//src/main/java=UTF-8
+encoding//src/test/java=UTF-8
+encoding/<project>=UTF-8

.settings/org.eclipse.jdt.core.prefs

@@ -0,0 +1,6 @@
+eclipse.preferences.version=1
+org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.8
+org.eclipse.jdt.core.compiler.compliance=1.8
+org.eclipse.jdt.core.compiler.problem.forbiddenReference=warning
+org.eclipse.jdt.core.compiler.release=disabled
+org.eclipse.jdt.core.compiler.source=1.8

.travis.yml

@@ -0,0 +1,12 @@
+language: java
+
+jdk:
+  - openjdk8
+  - oraclejdk10
+  - openjdk10
+
+before_script:
+  - version=$(grep -oP '(?<=^  <version>)[^<]*' pom.xml)
+
+script:
+  - mvn clean install

README.md

@@ -1 +1,75 @@
-# sql-statement-builder
+# sql-statement-builder
+
+[![Build Status](https://travis-ci.com/EXASOL/sql-statement-builder.svg?branch=develop)](https://travis-ci.com/EXASOL/sql-statement-builder)
+
+The Exasol SQL Statement Builder abstracts programmatic creation of SQL statements and is intended to replace ubiquitous string concatenation solutions which make the code hard to read and are prone to error and security risks.
+
+Goals:
+
+1. Foster clean and readable code
+1. Allow for thorough validation of dynamic parts
+1. Detect as many errors as possible at *compile time*
+1. Don't repeat yourself (DRY)
+1. Allow extension for different SQL dialects
+
+## Usage
+
+```java
+import com.exasol.sql.StatementFactory;
+import com.exasol.sql.SqlStatement;
+import com.exasol.sql.rendering.SqlStatementRenderer;
+
+SqlStatement statement = StatementFactory.getInstance()
+  .select()
+  .field("firstname", "lastname")
+  .from("person");
+
+String statementText = SqlStatementRenderer.render(statement);
+```
+
+## Development
+
+The following sub-sections provide information about building and extending the project.
+
+### Build Time Dependencies
+
+The list below show all build time dependencies in alphabetical order. Note that except the Maven build tool all required modules are downloaded automatically by Maven.
+
+| Dependency                                                | Purpose                                                | License                       |
+------------------------------------------------------------|--------------------------------------------------------|--------------------------------
+| [Apache Maven](https://maven.apache.org/)                 | Build tool                                             | Apache License 2.0            |
+| [Equals Verifier](https://github.com/jqno/equalsverifier) | Automatic contract checker for `equals()` and `hash()` | Apache License 2.0            |
+| [Hamcrest](http://hamcrest.org/)                          | Advanced matchers for JUnit                            | GNU BSD-3-Clause              |
+| [JUnit 5](https://junit.org/junit5/)                      | Unit testing framework                                 | Eclipse Public License 1.0    |
+| [Mockito](http://site.mockito.org/)                       | Mocking framework                                      | MIT License                   |
+
+### Planned Milestones
+
+The milestones listed below are a rough outline and might be subject to change depending on which constructs are needed more. The plan will be updated accordingly.
+
+#### M1
+
+* Basic support for Data Query Language (DQL) statement constructs (SELECT, FROM, JOIN, WHERE)
+* Rendering to string
+* Exasol Dialect only
+
+#### M2
+
+* Validation for constructs from M1
+
+(Later milestones will always include validation of the newly learned milestones)
+
+#### M3
+
+* Scalar functions
+
+#### M4
+
+* Sub-Selects including validation
+
+#### Later Milstones (very coarse)
+
+* Data Manipulation Language (DML) statements
+* Data Definition Language (DDL) statements
+* Support for Standard SQL
+* Support for other dialects (help welcome!)

doc/system_requirements.md

@@ -0,0 +1,19 @@
+* Upper case / lower case
+* One line / pretty
+
+SQL features:
+
+---
+
+SELECT
+* Fields
+* Asterisk ("*")
+
+FROM
+
+( INNER / ( LEFT / RIGHT / FULL ) OUTER ) JOIN
+* ON
+
+LIMIT
+* offset
+* count

launch/sql-statement-builder mvn package.launch

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<launchConfiguration type="org.eclipse.m2e.Maven2LaunchConfigurationType">
+<booleanAttribute key="M2_DEBUG_OUTPUT" value="false"/>
+<stringAttribute key="M2_GOALS" value="package"/>
+<booleanAttribute key="M2_NON_RECURSIVE" value="false"/>
+<booleanAttribute key="M2_OFFLINE" value="false"/>
+<stringAttribute key="M2_PROFILES" value=""/>
+<listAttribute key="M2_PROPERTIES"/>
+<stringAttribute key="M2_RUNTIME" value="EMBEDDED"/>
+<booleanAttribute key="M2_SKIP_TESTS" value="false"/>
+<intAttribute key="M2_THREADS" value="1"/>
+<booleanAttribute key="M2_UPDATE_SNAPSHOTS" value="false"/>
+<stringAttribute key="M2_USER_SETTINGS" value=""/>
+<booleanAttribute key="M2_WORKSPACE_RESOLUTION" value="false"/>
+<listAttribute key="org.eclipse.debug.ui.favoriteGroups">
+<listEntry value="org.eclipse.debug.ui.launchGroup.run"/>
+</listAttribute>
+<stringAttribute key="org.eclipse.jdt.launching.JRE_CONTAINER" value="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/java-1.8.0-openjdk-1.8.0.181-7.b13.fc28.x86_64"/>
+<stringAttribute key="org.eclipse.jdt.launching.WORKING_DIRECTORY" value="${workspace_loc:/sql-statement-builder}"/>
+</launchConfiguration>

launch/sql-statment-builder all tests.launch

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<launchConfiguration type="org.eclipse.jdt.junit.launchconfig">
+<listAttribute key="org.eclipse.debug.core.MAPPED_RESOURCE_PATHS">
+<listEntry value="/sql-statement-builder"/>
+</listAttribute>
+<listAttribute key="org.eclipse.debug.core.MAPPED_RESOURCE_TYPES">
+<listEntry value="4"/>
+</listAttribute>
+<listAttribute key="org.eclipse.debug.ui.favoriteGroups">
+<listEntry value="org.eclipse.eclemma.ui.launchGroup.coverage"/>
+<listEntry value="org.eclipse.debug.ui.launchGroup.debug"/>
+<listEntry value="org.eclipse.debug.ui.launchGroup.run"/>
+</listAttribute>
+<listAttribute key="org.eclipse.eclemma.core.SCOPE_IDS">
+<listEntry value="=sql-statement-builder/src\/main\/java"/>
+</listAttribute>
+<stringAttribute key="org.eclipse.jdt.junit.CONTAINER" value="=sql-statement-builder"/>
+<booleanAttribute key="org.eclipse.jdt.junit.KEEPRUNNING_ATTR" value="false"/>
+<stringAttribute key="org.eclipse.jdt.junit.TESTNAME" value=""/>
+<stringAttribute key="org.eclipse.jdt.junit.TEST_KIND" value="org.eclipse.jdt.junit.loader.junit5"/>
+<stringAttribute key="org.eclipse.jdt.launching.CLASSPATH_PROVIDER" value="org.eclipse.m2e.launchconfig.classpathProvider"/>
+<stringAttribute key="org.eclipse.jdt.launching.MAIN_TYPE" value=""/>
+<stringAttribute key="org.eclipse.jdt.launching.PROJECT_ATTR" value="sql-statement-builder"/>
+<stringAttribute key="org.eclipse.jdt.launching.SOURCE_PATH_PROVIDER" value="org.eclipse.m2e.launchconfig.sourcepathProvider"/>
+<stringAttribute key="org.eclipse.jdt.launching.VM_ARGUMENTS" value="-ea"/>
+</launchConfiguration>

model/diagrams/class/cl_fragments.plantuml

@@ -0,0 +1,19 @@
+@startuml
+!include ../exasol.skin
+
+together {
+	interface Fragment <<interface>>
+	interface FieldDefinition <<interface>>
+	interface TableReference <<interface>>
+}
+
+FieldDefinition -u-|> Fragment
+Field .u.|> FieldDefinition
+Select .u.|> Fragment
+TableReference -u-|> Fragment
+
+Select *-d- "1..*" Field
+Select *-d- FromClause
+FromClause *-d- "1..*" TableReference
+Table .u.|> TableReference
+@enduml

model/diagrams/class/cl_visitor.plantuml

@@ -0,0 +1,31 @@
+@startuml
+!include ../exasol.skin
+
+package com.exasol.sql {
+	interface Fragment <<interface>>
+
+	abstract class AbstractFragment <<abstract>> {
+		+ accept(visitor : FragmentVisitor) : void
+	}
+
+	interface FragmentVisitor <<interface>>	{
+		+ visit(statement : SqlStatement) : void
+		+ visit(field : Field) : void
+	}
+
+	package dql {
+		class SqlStatement
+		class Field
+	}
+
+	package rendering {
+	    class StringRenderer
+	}
+
+	AbstractFragment .u.|> Fragment
+	AbstractFragment -r-> FragmentVisitor : accepts
+	SqlStatement -u-|> AbstractFragment
+	Field -u-|> AbstractFragment
+	StringRenderer .u.|> FragmentVisitor
+}
+@enduml

model/diagrams/exasol.skin

@@ -0,0 +1,38 @@
+hide empty methods
+hide empty attributes
+skinparam style strictuml
+skinparam classAttributeIconSize 0
+!pragma horizontalLineBetweenDifferentPackageAllowed
+
+skinparam Arrow {
+	Color 093e52
+	FontColor 093e52
+}
+
+skinparam Class {
+    BackgroundColor fffff
+	FontColor 093e52
+	FontStyle bold
+	BorderColor 093e52
+    BackgroundColor<<interface>> 00b09b
+	FontColor<<interface>> ffffff
+	StereotypeFontColor<<interface>> ffffff
+}
+
+skinparam ClassAttribute {
+    BackgroundColor fffff
+	FontColor 093e52
+	BorderColor 093e52
+    BackgroundColor<<interface>> 00b09b
+	FontColor<<interface>> ffffff
+	StereotypeFontColor<<interface>> ffffff
+}
+
+skinparam Package {
+    BackgroundColor fffff
+	FontColor 093e52
+	FontStyle bold
+	BorderColor 093e52
+}
+
+skinparam padding 5

pom.xml

@@ -0,0 +1,59 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>sql-statement-builder</groupId>
+  <artifactId>sql-statement-builder</artifactId>
+  <version>0.1.0</version>
+  <name>Exasol SQL Statement Builder</name>
+  <description>This module provides a Builder for SQL statements that helps creating the correct structure and validates variable parts of the statements.</description>
+  <properties>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <java.version>1.8</java.version>
+    <junit.version>5.3.1</junit.version>
+    <junit.platform.version>1.3.1</junit.platform.version>
+  </properties>
+  <dependencies>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-api</artifactId>
+      <version>${junit.version}</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <version>${junit.version}</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.junit.platform</groupId>
+      <artifactId>junit-platform-launcher</artifactId>
+      <version>${junit.platform.version}</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.hamcrest</groupId>
+      <artifactId>hamcrest-all</artifactId>
+      <version>1.3</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>3.8.0</version>
+        <configuration>
+          <source>${java.version}</source>
+          <target>${java.version}</target>
+        </configuration>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-surefire-plugin</artifactId>
+        <version>2.22.0</version>
+      </plugin>
+    </plugins>
+  </build>
+</project>