DATAJDBC-335 - Add DSL and renderer for Insert, Update, and Delete.

We now provide Statement builders for Insert, Update, and Delete statements.

Table myTable = SQL.table("mytable");

Insert insert = StatementBuilder.insert().into(myTable).values(SQL.bindMarker()).build();

Update update = StatementBuilder.update(table).set(myTable.column("foo").set(SQL.bindMarker())).build();

Delete delete = StatementBuilder.delete().from(table).where(myTable.column("foo").isEqualTo(SQL.literal("bar"))).build();

Original pull request: #121.

Author: mp911de

spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/AbstractImportValidator.java

@@ -0,0 +1,66 @@
+/*
+ * Copyright 2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.relational.core.sql;
+
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * Validator for statements to import columns.
+ *
+ * @author Mark Paluch
+ * @since 1.1
+ */
+abstract class AbstractImportValidator implements Visitor {
+
+	Set<Table> requiredByWhere = new HashSet<>();
+	Set<Table> from = new HashSet<>();
+	Visitable parent;
+
+	/*
+	 * (non-Javadoc)
+	 * @see org.springframework.data.relational.core.sql.Visitor#enter(org.springframework.data.relational.core.sql.Visitable)
+	 */
+	@Override
+	public void enter(Visitable segment) {
+
+		if (segment instanceof Table && parent instanceof From) {
+			from.add((Table) segment);
+		}
+
+		if (segment instanceof Where) {
+
+			segment.visit(item -> {
+
+				if (item instanceof Table) {
+					requiredByWhere.add((Table) item);
+				}
+			});
+		}
+
+		if (segment instanceof Join || segment instanceof OrderByField || segment instanceof From
+				|| segment instanceof Select || segment instanceof Where || segment instanceof SimpleFunction) {
+			parent = segment;
+		}
+	}
+
+	/*
+	 * (non-Javadoc)
+	 * @see org.springframework.data.relational.core.sql.Visitor#leave(org.springframework.data.relational.core.sql.Visitable)
+	 */
+	@Override
+	public void leave(Visitable segment) {}
+}

spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/AssignValue.java

@@ -0,0 +1,78 @@
+/*
+ * Copyright 2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.relational.core.sql;
+
+import org.springframework.util.Assert;
+
+/**
+ * Assign a {@link Expression} to a {@link Column}.
+ * <p/>
+ * Results in a rendered assignment: {@code <column> = <value>} (e.g. {@code col = 'foo'}.
+ *
+ * @author Mark Paluch
+ * @since 1.1
+ */
+public class AssignValue extends AbstractSegment implements Assignment {
+
+	private final Column column;
+	private final Expression value;
+
+	private AssignValue(Column column, Expression value) {
+		super(column, value);
+		this.column = column;
+		this.value = value;
+	}
+
+	/**
+	 * Creates a {@link AssignValue value} assignment to a {@link Column} given an {@link Expression}.
+	 *
+	 * @param target target column, must not be {@literal null}.
+	 * @param value assignment value, must not be {@literal null}.
+	 * @return the {@link AssignValue}.
+	 */
+	public static AssignValue create(Column target, Expression value) {
+
+		Assert.notNull(target, "Target column must not be null!");
+		Assert.notNull(value, "Value must not be null!");
+
+		return new AssignValue(target, value);
+	}
+
+	/**
+	 * @return the target {@link Column}.
+	 */
+	public Column getColumn() {
+		return column;
+	}
+
+	/**
+	 * @return the value to assign.
+	 */
+	public Expression getValue() {
+		return value;
+	}
+
+	/* 
+	 * (non-Javadoc)
+	 * @see java.lang.Object#toString()
+	 */
+	@Override
+	public String toString() {
+
+		StringBuilder builder = new StringBuilder(32);
+		return builder.append(this.column).append(" = ").append(this.value).toString();
+	}
+}

spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/Assignment.java

@@ -0,0 +1,23 @@
+/*
+ * Copyright 2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.relational.core.sql;
+
+/**
+ * Update assignment to a {@link Column}.
+ *
+ * @author Mark Paluch
+ */
+public interface Assignment extends Segment {}

spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/Assignments.java

@@ -0,0 +1,42 @@
+/*
+ * Copyright 2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.relational.core.sql;
+
+/**
+ * Factory for common {@link Assignment}s.
+ *
+ * @author Mark Paluch
+ * @since 1.1
+ * @see SQL
+ * @see Expressions
+ * @see Functions
+ */
+public abstract class Assignments {
+
+	/**
+	 * Creates a {@link AssignValue value} assignment to a {@link Column} given an {@link Expression}.
+	 *
+	 * @param target target column, must not be {@literal null}.
+	 * @param value assignment value, must not be {@literal null}.
+	 * @return the {@link AssignValue}.
+	 */
+	public static AssignValue value(Column target, Expression value) {
+		return AssignValue.create(target, value);
+	}
+
+	// Utility constructor.
+	private Assignments() {}
+}

spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/Column.java

@@ -200,6 +200,20 @@ public Condition isNotNull() {
 		return isNull().not();
 	}
 
+	// -------------------------------------------------------------------------
+	// Methods for Assignment creation.
+	// -------------------------------------------------------------------------
+
+	/**
+	 * Creates a value {@link AssignValue assignment}.
+	 *
+	 * @param value the value to assign.
+	 * @return the {@link AssignValue} assignment.
+	 */
+	public AssignValue set(Expression value) {
+		return Assignments.value(this, value);
+	}
+
 	/*
 	 * (non-Javadoc)
 	 * @see org.springframework.data.relational.core.sql.Named#getName()

spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/DefaultDelete.java

@@ -0,0 +1,75 @@
+/*
+ * Copyright 2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.relational.core.sql;
+
+import org.springframework.lang.Nullable;
+import org.springframework.util.Assert;
+
+/**
+ * Default {@link Delete} implementation.
+ *
+ * @author Mark Paluch
+ * @since 1.1
+ */
+class DefaultDelete implements Delete {
+
+	private final From from;
+	private final @Nullable Where where;
+
+	DefaultDelete(Table table, @Nullable Condition where) {
+
+		this.from = new From(table);
+		this.where = where != null ? new Where(where) : null;
+	}
+
+	/* 
+	 * (non-Javadoc)
+	 * @see org.springframework.data.relational.core.sql.Visitable#visit(org.springframework.data.relational.core.sql.Visitor)
+	 */
+	@Override
+	public void visit(Visitor visitor) {
+
+		Assert.notNull(visitor, "Visitor must not be null!");
+
+		visitor.enter(this);
+
+		from.visit(visitor);
+
+		if (where != null) {
+			where.visit(visitor);
+		}
+
+		visitor.leave(this);
+	}
+
+	/* 
+	 * (non-Javadoc)
+	 * @see java.lang.Object#toString()
+	 */
+	@Override
+	public String toString() {
+
+		StringBuilder builder = new StringBuilder();
+
+		builder.append("DELETE ").append(this.from);
+
+		if (this.where != null) {
+			builder.append(' ').append(this.where);
+		}
+
+		return builder.toString();
+	}
+}