Introduce @InsertOnlyProperty.

You may now annotate properties of the aggregate root with `@InsertOnlyProperty`.
Properties annotated in such way will be written to the database only during insert operations, but they will not be updated afterwards.

Closes #637
Original pull request #1327

Author: schauder

spring-data-jdbc/src/main/java/org/springframework/data/jdbc/core/convert/SqlGenerator.java

@@ -95,7 +95,7 @@ <T> SqlIdentifierParameterSource forInsert(T instance, Class<T> domainType, Iden
 	 */
 	<T> SqlIdentifierParameterSource forUpdate(T instance, Class<T> domainType) {
 
-		return getParameterSource(instance, getRequiredPersistentEntity(domainType), "", Predicates.includeAll(),
+		return getParameterSource(instance, getRequiredPersistentEntity(domainType), "", RelationalPersistentProperty::isInsertOnly,
 				dialect.getIdentifierProcessing());
 	}
 

spring-data-jdbc/src/main/java/org/springframework/data/jdbc/core/convert/SqlParametersFactory.java

@@ -64,6 +64,7 @@
 import org.springframework.data.jdbc.testing.TestDatabaseFeatures;
 import org.springframework.data.relational.core.conversion.DbActionExecutionException;
 import org.springframework.data.relational.core.mapping.Column;
+import org.springframework.data.relational.core.mapping.InsertOnlyProperty;
 import org.springframework.data.relational.core.mapping.MappedCollection;
 import org.springframework.data.relational.core.mapping.RelationalMappingContext;
 import org.springframework.data.relational.core.mapping.Table;
@@ -1030,6 +1031,20 @@ void updateIdOnlyAggregate() {
 		template.save(entity);
 	}
 
+	@Test // GH-637
+	void insertOnlyPropertyDoesNotGetUpdated() {
+
+		WithInsertOnly entity = new WithInsertOnly();
+		entity.insertOnly = "first value";
+
+		assertThat(template.save(entity).id).isNotNull();
+
+		entity.insertOnly = "second value";
+		template.save(entity);
+
+		assertThat(template.findById(entity.id, WithInsertOnly.class).insertOnly).isEqualTo("first value");
+	}
+
 	private <T extends Number> void saveAndUpdateAggregateWithVersion(VersionedAggregate aggregate,
 			Function<Number, T> toConcreteNumber) {
 		saveAndUpdateAggregateWithVersion(aggregate, toConcreteNumber, 0);
@@ -1461,10 +1476,16 @@ static class WithLocalDateTime {
 	}
 
 	@Table
-	class WithIdOnly {
+	static class WithIdOnly {
 		@Id Long id;
 	}
 
+	@Table
+	static class WithInsertOnly {
+		@Id Long id;
+		@InsertOnlyProperty
+		String insertOnly;
+	}
 
 	@Configuration
 	@Import(TestConfiguration.class)

spring-data-jdbc/src/test/java/org/springframework/data/jdbc/core/JdbcAggregateTemplateIntegrationTests.java

@@ -39,6 +39,8 @@ DROP TABLE WITH_LOCAL_DATE_TIME;
 
 DROP TABLE WITH_ID_ONLY;
 
+DROP TABLE WITH_INSERT_ONLY;
+
 CREATE TABLE LEGO_SET
 (
   "id1"  BIGINT GENERATED BY DEFAULT AS IDENTITY (START WITH 1) PRIMARY KEY,
@@ -357,4 +359,10 @@ CREATE TABLE WITH_LOCAL_DATE_TIME
 CREATE TABLE WITH_ID_ONLY
 (
   ID BIGINT GENERATED BY DEFAULT AS IDENTITY (START WITH 1) PRIMARY KEY
+);
+
+CREATE TABLE WITH_INSERT_ONLY
+(
+  ID BIGINT GENERATED BY DEFAULT AS IDENTITY (START WITH 1) PRIMARY KEY,
+  INSERT_ONLY VARCHAR(100)
 );

spring-data-jdbc/src/test/resources/org.springframework.data.jdbc.core/JdbcAggregateTemplateIntegrationTests-db2.sql

@@ -326,4 +326,10 @@ CREATE TABLE WITH_LOCAL_DATE_TIME
 CREATE TABLE WITH_ID_ONLY
 (
     ID SERIAL PRIMARY KEY
+);
+
+CREATE TABLE WITH_INSERT_ONLY
+(
+    ID        SERIAL PRIMARY KEY,
+    INSERT_ONLY VARCHAR(100)
 );

spring-data-jdbc/src/test/resources/org.springframework.data.jdbc.core/JdbcAggregateTemplateIntegrationTests-h2.sql

@@ -325,6 +325,12 @@ CREATE TABLE WITH_LOCAL_DATE_TIME
     TEST_TIME TIMESTAMP(9)
 );
 
+CREATE TABLE WITH_INSERT_ONLY
+(
+    ID BIGINT GENERATED BY DEFAULT AS IDENTITY (START WITH 1) PRIMARY KEY,
+    INSERT_ONLY VARCHAR(100)
+);
+
 CREATE TABLE WITH_ID_ONLY
 (
     ID BIGINT GENERATED BY DEFAULT AS IDENTITY (START WITH 1) PRIMARY KEY

spring-data-jdbc/src/test/resources/org.springframework.data.jdbc.core/JdbcAggregateTemplateIntegrationTests-hsql.sql

@@ -301,4 +301,10 @@ CREATE TABLE WITH_LOCAL_DATE_TIME
 CREATE TABLE WITH_ID_ONLY
 (
   ID BIGINT AUTO_INCREMENT PRIMARY KEY
+);
+
+CREATE TABLE WITH_INSERT_ONLY
+(
+  ID BIGINT AUTO_INCREMENT PRIMARY KEY,
+  INSERT_ONLY VARCHAR(100)
 );

spring-data-jdbc/src/test/resources/org.springframework.data.jdbc.core/JdbcAggregateTemplateIntegrationTests-mariadb.sql

@@ -331,4 +331,12 @@ DROP TABLE IF EXISTS WITH_ID_ONLY;
 CREATE TABLE WITH_ID_ONLY
 (
   ID BIGINT IDENTITY PRIMARY KEY
+);
+
+DROP TABLE IF EXISTS WITH_INSERT_ONLY;
+
+CREATE TABLE WITH_INSERT_ONLY
+(
+  ID BIGINT IDENTITY PRIMARY KEY,
+  INSERT_ONLY VARCHAR(100)
 );

spring-data-jdbc/src/test/resources/org.springframework.data.jdbc.core/JdbcAggregateTemplateIntegrationTests-mssql.sql

@@ -306,4 +306,10 @@ CREATE TABLE WITH_LOCAL_DATE_TIME
 CREATE TABLE WITH_ID_ONLY
 (
   ID BIGINT AUTO_INCREMENT PRIMARY KEY
+);
+
+CREATE TABLE WITH_INSERT_ONLY
+(
+  ID BIGINT AUTO_INCREMENT PRIMARY KEY,
+  INSERT_ONLY VARCHAR(100)
 );

spring-data-jdbc/src/test/resources/org.springframework.data.jdbc.core/JdbcAggregateTemplateIntegrationTests-mysql.sql

@@ -29,6 +29,7 @@ DROP TABLE VERSIONED_AGGREGATE CASCADE CONSTRAINTS PURGE;
 DROP TABLE WITH_READ_ONLY CASCADE CONSTRAINTS PURGE;
 DROP TABLE WITH_LOCAL_DATE_TIME CASCADE CONSTRAINTS PURGE;
 DROP TABLE WITH_ID_ONLY CASCADE CONSTRAINTS PURGE;
+DROP TABLE WITH_INSERT_ONLY CASCADE CONSTRAINTS PURGE;
 
 CREATE TABLE LEGO_SET
 (
@@ -338,4 +339,11 @@ CREATE TABLE WITH_LOCAL_DATE_TIME
 CREATE TABLE WITH_ID_ONLY
 (
   ID NUMBER GENERATED by default on null as IDENTITY PRIMARY KEY
+);
+
+
+CREATE TABLE WITH_INSERT_ONLY
+(
+  ID NUMBER GENERATED by default on null as IDENTITY PRIMARY KEY,
+  INSERT_ONLY VARCHAR(100)
 );