blob: bdfe92a23f9ab2bacef4884298ca27a433ebe48f [file]
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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 com.datastax.oss.driver.mapper;
import static com.datastax.oss.driver.api.mapper.entity.naming.GetterStyle.FLUENT;
import static org.assertj.core.api.Assertions.assertThat;
import com.datastax.oss.driver.api.core.CqlIdentifier;
import com.datastax.oss.driver.api.core.CqlSession;
import com.datastax.oss.driver.api.core.cql.Row;
import com.datastax.oss.driver.api.core.cql.SimpleStatement;
import com.datastax.oss.driver.api.core.data.UdtValue;
import com.datastax.oss.driver.api.core.type.UserDefinedType;
import com.datastax.oss.driver.api.mapper.MapperBuilder;
import com.datastax.oss.driver.api.mapper.annotations.Computed;
import com.datastax.oss.driver.api.mapper.annotations.CqlName;
import com.datastax.oss.driver.api.mapper.annotations.Dao;
import com.datastax.oss.driver.api.mapper.annotations.DaoFactory;
import com.datastax.oss.driver.api.mapper.annotations.DaoKeyspace;
import com.datastax.oss.driver.api.mapper.annotations.DefaultNullSavingStrategy;
import com.datastax.oss.driver.api.mapper.annotations.Entity;
import com.datastax.oss.driver.api.mapper.annotations.GetEntity;
import com.datastax.oss.driver.api.mapper.annotations.Insert;
import com.datastax.oss.driver.api.mapper.annotations.Mapper;
import com.datastax.oss.driver.api.mapper.annotations.PartitionKey;
import com.datastax.oss.driver.api.mapper.annotations.PropertyStrategy;
import com.datastax.oss.driver.api.mapper.annotations.Select;
import com.datastax.oss.driver.api.mapper.entity.saving.NullSavingStrategy;
import com.datastax.oss.driver.api.testinfra.ccm.CcmRule;
import com.datastax.oss.driver.api.testinfra.ccm.SchemaChangeSynchronizer;
import com.datastax.oss.driver.api.testinfra.session.SessionRule;
import com.datastax.oss.driver.categories.ParallelizableTests;
import java.util.Objects;
import java.util.UUID;
import org.junit.BeforeClass;
import org.junit.ClassRule;
import org.junit.Test;
import org.junit.experimental.categories.Category;
import org.junit.rules.RuleChain;
import org.junit.rules.TestRule;
@Category(ParallelizableTests.class)
public class ImmutableEntityIT extends InventoryITBase {
private static final CcmRule CCM_RULE = CcmRule.getInstance();
private static final SessionRule<CqlSession> SESSION_RULE = SessionRule.builder(CCM_RULE).build();
@ClassRule
public static final TestRule CHAIN = RuleChain.outerRule(CCM_RULE).around(SESSION_RULE);
private static final UUID PRODUCT_2D_ID = UUID.randomUUID();
private static ImmutableProductDao dao;
@BeforeClass
public static void setup() {
CqlSession session = SESSION_RULE.session();
SchemaChangeSynchronizer.withLock(
() -> {
for (String query : createStatements(CCM_RULE)) {
session.execute(
SimpleStatement.builder(query)
.setExecutionProfile(SESSION_RULE.slowProfile())
.build());
}
});
UserDefinedType dimensions2d =
session
.getKeyspace()
.flatMap(ks -> session.getMetadata().getKeyspace(ks))
.flatMap(ks -> ks.getUserDefinedType("dimensions2d"))
.orElseThrow(AssertionError::new);
session.execute(
"INSERT INTO product2d (id, description, dimensions) VALUES (?, ?, ?)",
PRODUCT_2D_ID,
"2D product",
dimensions2d.newValue(12, 34));
InventoryMapper mapper = InventoryMapper.builder(session).build();
dao = mapper.immutableProductDao(SESSION_RULE.keyspace());
}
@Test
public void should_insert_and_retrieve_immutable_entities() {
ImmutableProduct originalProduct =
new ImmutableProduct(
UUID.randomUUID(), "mock description", new ImmutableDimensions(1, 2, 3), -1);
dao.save(originalProduct);
ImmutableProduct retrievedProduct = dao.findById(originalProduct.id());
assertThat(retrievedProduct).isEqualTo(originalProduct);
}
@Test
public void should_map_immutable_entity_from_complete_row() {
ImmutableProduct originalProduct =
new ImmutableProduct(
UUID.randomUUID(), "mock description", new ImmutableDimensions(1, 2, 3), -1);
dao.save(originalProduct);
Row row =
SESSION_RULE
.session()
.execute(
"SELECT id, description, dimensions, writetime(description) AS writetime, now() "
+ "FROM product WHERE id = ?",
originalProduct.id())
.one();
ImmutableProduct retrievedProduct = dao.mapStrict(row);
assertThat(retrievedProduct.id()).isEqualTo(originalProduct.id());
assertThat(retrievedProduct.description()).isEqualTo(originalProduct.description());
assertThat(retrievedProduct.dimensions()).isEqualTo(originalProduct.dimensions());
assertThat(retrievedProduct.writetime()).isGreaterThan(0);
}
@Test
public void should_map_immutable_entity_from_partial_row_when_lenient() {
Row row =
SESSION_RULE
.session()
.execute("SELECT id, dimensions FROM product2d WHERE id = ?", PRODUCT_2D_ID)
.one();
ImmutableProduct retrievedProduct = dao.mapLenient(row);
assertThat(retrievedProduct.id()).isEqualTo(PRODUCT_2D_ID);
assertThat(retrievedProduct.dimensions()).isEqualTo(new ImmutableDimensions(0, 12, 34));
assertThat(retrievedProduct.description()).isNull();
assertThat(retrievedProduct.writetime()).isZero();
}
@Test
public void should_map_immutable_entity_from_complete_udt() {
ImmutableProduct originalProduct =
new ImmutableProduct(
UUID.randomUUID(), "mock description", new ImmutableDimensions(1, 2, 3), -1);
dao.save(originalProduct);
Row row =
SESSION_RULE
.session()
.execute("SELECT dimensions FROM product WHERE id = ?", originalProduct.id())
.one();
assertThat(row).isNotNull();
ImmutableDimensions retrievedDimensions = dao.mapStrict(row.getUdtValue(0));
assertThat(retrievedDimensions).isEqualTo(originalProduct.dimensions());
}
@Test
public void should_map_immutable_entity_from_partial_udt_when_lenient() {
Row row =
SESSION_RULE
.session()
.execute("SELECT dimensions FROM product2d WHERE id = ?", PRODUCT_2D_ID)
.one();
assertThat(row).isNotNull();
ImmutableDimensions retrievedDimensions = dao.mapLenient(row.getUdtValue(0));
assertThat(retrievedDimensions).isEqualTo(new ImmutableDimensions(0, 12, 34));
}
@Entity
@CqlName("product")
@PropertyStrategy(getterStyle = FLUENT, mutable = false)
public static class ImmutableProduct {
@PartitionKey private final UUID id;
private final String description;
private final ImmutableDimensions dimensions;
@Computed("writetime(description)")
private final long writetime;
public ImmutableProduct(
UUID id, String description, ImmutableDimensions dimensions, long writetime) {
this.id = id;
this.description = description;
this.dimensions = dimensions;
this.writetime = writetime;
}
public UUID id() {
return id;
}
public String description() {
return description;
}
public ImmutableDimensions dimensions() {
return dimensions;
}
public long writetime() {
return writetime;
}
@Override
public boolean equals(Object other) {
if (other == this) {
return true;
} else if (other instanceof ImmutableProduct) {
ImmutableProduct that = (ImmutableProduct) other;
return Objects.equals(this.id, that.id)
&& Objects.equals(this.description, that.description)
&& Objects.equals(this.dimensions, that.dimensions);
} else {
return false;
}
}
@Override
public int hashCode() {
return Objects.hash(id, description, dimensions);
}
}
@Entity
@PropertyStrategy(mutable = false)
public static class ImmutableDimensions {
private final int length;
private final int width;
private final int height;
public ImmutableDimensions(int length, int width, int height) {
this.length = length;
this.width = width;
this.height = height;
}
public int getLength() {
return length;
}
public int getWidth() {
return width;
}
public int getHeight() {
return height;
}
@Override
public boolean equals(Object other) {
if (this == other) {
return true;
} else if (other instanceof ImmutableDimensions) {
ImmutableDimensions that = (ImmutableDimensions) other;
return this.length == that.length && this.width == that.width && this.height == that.height;
} else {
return false;
}
}
@Override
public int hashCode() {
return Objects.hash(length, width, height);
}
@Override
public String toString() {
return "Dimensions{length=" + length + ", width=" + width + ", height=" + height + '}';
}
}
@Mapper
public interface InventoryMapper {
static MapperBuilder<InventoryMapper> builder(CqlSession session) {
return new ImmutableEntityIT_InventoryMapperBuilder(session);
}
@DaoFactory
ImmutableProductDao immutableProductDao(@DaoKeyspace CqlIdentifier keyspace);
}
@Dao
@DefaultNullSavingStrategy(NullSavingStrategy.SET_TO_NULL)
public interface ImmutableProductDao {
@Select
ImmutableProduct findById(UUID productId);
@Insert
void save(ImmutableProduct product);
@GetEntity
ImmutableProduct mapStrict(Row row);
@GetEntity(lenient = true)
ImmutableProduct mapLenient(Row row);
@GetEntity
ImmutableDimensions mapStrict(UdtValue udt);
@GetEntity(lenient = true)
ImmutableDimensions mapLenient(UdtValue udt);
}
}