DATACOUCH-136 - Add @N1QL query annotation.

The annotation allows to execute N1QL queries that are provided inline. For ease of use, one can use the placeholder $SELECT_ENTITY$ instead of writing the SELECT and FROM clauses.

QueryParams passed in as a method parameter will be used to enrich the Query. Other parameters on the annotated method will be used as values for positional placeholders in the statement.

The template's findByN1QL now expect enough data to reconstruct the full CouchbaseDocument (including ID and CAS), the ad hoc version of it has been renamed findByN1QLProjection.
This commit is contained in:
Simon Baslé
2015-07-06 16:17:39 +02:00
parent b9f23f3fd5
commit 9deaf6b480
14 changed files with 637 additions and 18 deletions

View File

@@ -7,15 +7,10 @@ import com.couchbase.client.java.Bucket;
import com.couchbase.client.java.Cluster;
import com.couchbase.client.java.CouchbaseBucket;
import com.couchbase.client.java.CouchbaseCluster;
import com.couchbase.client.java.env.CouchbaseEnvironment;
import com.couchbase.client.java.env.DefaultCouchbaseEnvironment;
import org.mockito.Mock;
import org.mockito.Mockito;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.Environment;
import org.springframework.data.couchbase.config.AbstractCouchbaseConfiguration;
import org.springframework.data.couchbase.core.CouchbaseTemplate;
import org.springframework.data.couchbase.core.WriteResultChecking;

View File

@@ -0,0 +1,190 @@
package org.springframework.data.couchbase.repository.query;
import static com.couchbase.client.java.query.Select.select;
import static org.junit.Assert.*;
import static org.mockito.Mockito.*;
import java.lang.reflect.Method;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.concurrent.TimeUnit;
import com.couchbase.client.java.document.json.JsonArray;
import com.couchbase.client.java.document.json.JsonObject;
import com.couchbase.client.java.query.ParametrizedQuery;
import com.couchbase.client.java.query.PreparedQuery;
import com.couchbase.client.java.query.Query;
import com.couchbase.client.java.query.QueryParams;
import com.couchbase.client.java.query.QueryPlan;
import com.couchbase.client.java.query.Select;
import com.couchbase.client.java.query.SimpleQuery;
import com.couchbase.client.java.query.Statement;
import org.junit.Before;
import org.junit.BeforeClass;
import org.junit.Test;
import org.mockito.Mockito;
import org.springframework.data.couchbase.UnitTestApplicationConfig;
import org.springframework.data.couchbase.core.mapping.CouchbasePersistentEntity;
import org.springframework.data.couchbase.core.mapping.CouchbasePersistentProperty;
import org.springframework.data.domain.Page;
import org.springframework.data.mapping.context.MappingContext;
import org.springframework.data.repository.core.RepositoryMetadata;
import org.springframework.data.repository.query.Parameters;
import org.springframework.data.repository.query.QueryMethod;
import org.springframework.data.util.ReflectionUtils;
public class AbstractN1qlBasedQueryTest {
@Test
public void testQueryPlanShouldProducePreparedQuery() throws Exception {
Statement st = select("*");
QueryPlan plan = new QueryPlan(JsonObject.create());
List<Object> params = new ArrayList<Object>(2);
params.add("test");
params.add(plan);
Query query = AbstractN1qlBasedQuery.buildQuery(st, params.iterator());
JsonObject queryObject = query.n1ql();
assertTrue(query instanceof PreparedQuery);
assertEquals(plan, query.statement());
assertNull(query.params());
assertNotNull(queryObject.get("args"));
assertEquals(1, queryObject.getArray("args").size());
assertEquals("test", queryObject.getArray("args").getString(0));
params.add(QueryParams.build());
query = AbstractN1qlBasedQuery.buildQuery(st, params.iterator());
assertNotNull(query.params());
}
@Test
public void testEmptyArgumentsShouldProduceSimpleQuery() throws Exception {
Statement st = select("*");
List<Object> params = Collections.emptyList();
Query query = AbstractN1qlBasedQuery.buildQuery(st, params.iterator());
JsonObject queryObject = query.n1ql();
assertTrue(query instanceof SimpleQuery);
assertEquals(st.toString(), query.statement().toString());
assertNull(query.params());
assertFalse(queryObject.containsKey("args"));
}
@Test
public void testOnlyQueryParamsShouldProduceSimpleQuery() {
Statement st = select("*");
QueryParams queryParams = QueryParams.build().scanWait(1, TimeUnit.DAYS);
List<Object> params = new ArrayList<Object>(1);
params.add(queryParams);
Query query = AbstractN1qlBasedQuery.buildQuery(st, params.iterator());
JsonObject queryObject = query.n1ql();
assertTrue(query instanceof SimpleQuery);
assertEquals(st.toString(), query.statement().toString());
assertEquals(queryParams, query.params());
assertFalse(queryObject.containsKey("args"));
}
@Test
public void testSimpleArgumentsShouldProduceParametrizedQuery() throws Exception {
Statement st = select("*");
List<Object> params = new ArrayList<Object>(2);
params.add(123L);
params.add("test");
Query query = AbstractN1qlBasedQuery.buildQuery(st, params.iterator());
JsonObject queryObject = query.n1ql();
assertTrue(query instanceof ParametrizedQuery);
assertEquals(st.toString(), query.statement().toString());
assertNull(query.params());
assertTrue(queryObject.containsKey("args"));
JsonArray args = queryObject.getArray("args");
assertEquals(2, args.size());
assertEquals(123L, args.get(0));
assertEquals("test", args.get(1));
}
@Test
public void testSimpleArgumentsAndQueryParamsShouldProduceParametrizedQuery() throws Exception {
Statement st = select("*");
QueryParams queryParams = QueryParams.build().withContextId("toto");
List<Object> params = new ArrayList<Object>(2);
params.add(123L);
params.add(queryParams);
params.add("test");
Query query = AbstractN1qlBasedQuery.buildQuery(st, params.iterator());
JsonObject queryObject = query.n1ql();
assertTrue(query instanceof ParametrizedQuery);
assertEquals(st.toString(), query.statement().toString());
assertEquals(queryParams, query.params());
assertTrue(queryObject.containsKey("args"));
JsonArray args = queryObject.getArray("args");
assertEquals(2, args.size());
assertEquals(123L, args.get(0));
assertEquals("test", args.get(1));
}
@Test
public void shouldChooseCollectionExecutionWhenCollectionType() {
CouchbaseQueryMethod queryMethod = Mockito.mock(CouchbaseQueryMethod.class);
Query query = Mockito.mock(Query.class);
AbstractN1qlBasedQuery mock = mock(AbstractN1qlBasedQuery.class);
when(mock.executeDependingOnType(any(Query.class), any(QueryMethod.class), anyBoolean(), anyBoolean(), anyBoolean()))
.thenCallRealMethod();
when(queryMethod.isCollectionQuery()).thenReturn(true);
mock.executeDependingOnType(query, queryMethod, false, false, false);
verify(mock).executeCollection(any(Query.class));
verify(mock, never()).executeEntity(any(Query.class));
verify(mock, never()).executeStream(any(Query.class));
}
@Test
public void shouldChooseEntityExecutionWhenEntityType() {
CouchbaseQueryMethod queryMethod = Mockito.mock(CouchbaseQueryMethod.class);
Query query = Mockito.mock(Query.class);
AbstractN1qlBasedQuery mock = mock(AbstractN1qlBasedQuery.class);
when(mock.executeDependingOnType(any(Query.class), any(QueryMethod.class), anyBoolean(), anyBoolean(), anyBoolean()))
.thenCallRealMethod();
when(queryMethod.isQueryForEntity()).thenReturn(true);
mock.executeDependingOnType(query, queryMethod, false, false, false);
verify(mock, never()).executeCollection(any(Query.class));
verify(mock).executeEntity(any(Query.class));
verify(mock, never()).executeStream(any(Query.class));
}
@Test
public void shouldChooseStreamExecutionWhenStreamType() {
CouchbaseQueryMethod queryMethod = Mockito.mock(CouchbaseQueryMethod.class);
Query query = Mockito.mock(Query.class);
AbstractN1qlBasedQuery mock = mock(AbstractN1qlBasedQuery.class);
when(mock.executeDependingOnType(any(Query.class), any(QueryMethod.class), anyBoolean(), anyBoolean(), anyBoolean()))
.thenCallRealMethod();
when(queryMethod.isStreamQuery()).thenReturn(true);
mock.executeDependingOnType(query, queryMethod, false, false, false);
verify(mock, never()).executeCollection(any(Query.class));
verify(mock, never()).executeEntity(any(Query.class));
verify(mock).executeStream(any(Query.class));
}
@Test
public void shouldThrowWhenUnsupportedType() throws NoSuchMethodException {
CouchbaseQueryMethod queryMethod = Mockito.mock(CouchbaseQueryMethod.class);
Query query = Mockito.mock(Query.class);
AbstractN1qlBasedQuery mock = mock(AbstractN1qlBasedQuery.class);
when(mock.executeDependingOnType(any(Query.class), any(QueryMethod.class), anyBoolean(), anyBoolean(), anyBoolean()))
.thenCallRealMethod();
try { mock.executeDependingOnType(query, queryMethod, true, false, false); } catch (UnsupportedOperationException e) { }
try { mock.executeDependingOnType(query, queryMethod, false, true, false); } catch (UnsupportedOperationException e) { }
try { mock.executeDependingOnType(query, queryMethod, false, false, true); } catch (UnsupportedOperationException e) { }
verify(mock, never()).executeCollection(any(Query.class));
verify(mock, never()).executeEntity(any(Query.class));
verify(mock, never()).executeStream(any(Query.class));
}
}

View File

@@ -0,0 +1,38 @@
package org.springframework.data.couchbase.repository.query;
import static org.junit.Assert.*;
import static org.springframework.data.couchbase.repository.query.StringN1qlBasedQuery.PLACEHOLDER_BUCKET;
import static org.springframework.data.couchbase.repository.query.StringN1qlBasedQuery.PLACEHOLDER_ENTITY;
import static org.springframework.data.couchbase.repository.query.StringN1qlBasedQuery.PLACEHOLDER_SELECT_FROM;
import com.couchbase.client.java.query.Statement;
import org.junit.Test;
public class StringN1QlBasedQueryTest {
@Test
public void testReplaceFullSelectPlaceholderOnce() throws Exception {
String statement = PLACEHOLDER_SELECT_FROM + " where " + PLACEHOLDER_SELECT_FROM;
Statement parsed = StringN1qlBasedQuery.prepare(statement, "B");
assertEquals("SELECT META(`B`).id AS _ID, META(`B`).cas AS _CAS, `B`.* FROM `B` where "
+ PLACEHOLDER_SELECT_FROM, parsed.toString());
}
@Test
public void testReplaceAllBucketPlaceholder() throws Exception {
String statement = "SELECT * FROM " + PLACEHOLDER_BUCKET + " WHERE " + PLACEHOLDER_BUCKET + ".test = 1";
Statement parsed = StringN1qlBasedQuery.prepare(statement, "B");
assertEquals("SELECT * FROM `B` WHERE `B`.test = 1", parsed.toString());
}
@Test
public void testReplaceFirstEntityPlaceholder() throws Exception {
String statement = "SELECT " + PLACEHOLDER_ENTITY + " FROM b where b.test = 1 and " + PLACEHOLDER_ENTITY;
Statement parsed = StringN1qlBasedQuery.prepare(statement, "A");
assertEquals("SELECT META(`A`).id AS _ID, META(`A`).cas AS _CAS FROM b where b.test = 1 and "
+ PLACEHOLDER_ENTITY, parsed.toString());
}
}