You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
NOTE: Copies of this document may be made for your own use and for distribution to others, provided that you do not charge any fee for such copies and further provided that each copy contains this Copyright Notice, whether distributed in print or electronically.
While it is not important to know the Spring APIs, understanding the concepts behind them is important.
30
30
At a minimum, the idea behind IoC should be familiar, no matter what IoC container you choose to use.
@@ -33,10 +33,10 @@ The core functionality of the Cassandra support can be used directly, with no ne
33
33
This is much like `JdbcTemplate`, which can be used 'standalone' without any other services of the Spring container.
34
34
To use all the features of Spring Data for Apache Cassandra, such as the repository support, you must configure some parts of the library by using Spring.
35
35
36
-
To learn more about Spring, you can refer to the comprehensive {spring-framework-docs}[documentation]
36
+
To learn more about Spring, you can refer to the comprehensive {springDocsUrl}[documentation]
37
37
that explains the Spring Framework in detail.
38
38
There are a lot of articles, blog entries, and books on Spring.
39
-
See the Spring Framework https://projects.spring.io/spring-framework/[home page] for more information.
39
+
See the Spring Framework https://spring.io/projects/spring-framework[home page] for more information.
40
40
41
41
[[get-started:first-steps:nosql]]
42
42
== Knowing NoSQL and Cassandra
@@ -50,9 +50,8 @@ It usually does not take more then 5-10 minutes to go through them, and, if you
50
50
The starting point for learning about Cassandra is https://cassandra.apache.org/[cassandra.apache.org].
51
51
Also, here is a list of other useful resources:
52
52
53
-
* The https://datastax.com/[DataStax] site offers https://www.datastax.com/what-we-offer/products-services/support[commercial support]
54
-
and many resources, including, but not limited to, https://docs.datastax.com/en/landing_page/doc/landing_page/current.html[documentation],
55
-
https://docs.datastax.com/en/landing_page/doc/landing_page/current.html[DataStax Academy], a https://www.datastax.com/dev/blog[Tech Blog], and so on.
53
+
* The https://datastax.com/[DataStax] site offers https://www.datastax.com/products/datastax-enterprise[commercial support]
54
+
and many resources, including, but not limited to, https://docs.datastax.com/en/home/docs/index.html[documentation], and https://docs.datastax.com/en/home/docs/index.html[DataStax Academy].
56
55
* The https://academy.datastax.com/resources/ds101-introduction-cassandra[DataStax Academy introduction to Cassandra].
57
56
* The https://cassandra.apache.org/doc/latest/getting_started/index.html[Cassandra Quick Start Guide].
58
57
@@ -83,7 +82,7 @@ https://pivotal.io/[Pivotal Software, Inc.], the company behind Spring Data and
83
82
[[get-started:up-to-date]]
84
83
=== Following Development
85
84
86
-
For information on the Spring Data for Apache Cassandra source code repository, nightly builds, and snapshot artifacts see the https://projects.spring.io/spring-data-cassandra/[Spring Data for Apache Cassandra home page].
85
+
For information on the Spring Data for Apache Cassandra source code repository, nightly builds, and snapshot artifacts see the https://spring.io/projects/spring-data-cassandra[Spring Data for Apache Cassandra home page].
87
86
You can help make Spring Data best serve the needs of the Spring community by interacting with developers through the community on https://stackoverflow.com/questions/tagged/spring-data[Stack Overflow].
88
87
To follow developer activity, look for the mailing list information on the Spring Data for Apache Cassandra home page.
89
88
If you encounter a bug or want to suggest an improvement, please create a ticket on the Spring Data issue
@@ -96,6 +95,6 @@ Finally, you can follow the Spring https://spring.io/blog[blog] or the project
96
95
97
96
* Version Control: https://github.com/spring-projects/spring-data-cassandra
The DataStax Cassandra documentation includes https://docs.datastax.com/en/cassandra/3.0/cassandra/dml/dmlConfigConsistency.html[a good discussion of the available consistency levels].
331
+
The DataStax Cassandra documentation includes https://docs.datastax.com/en/cassandra-oss/3.0/cassandra/dml/dmlConfigConsistency.html[a good discussion of the available consistency levels].
332
332
333
333
NOTE: You can control fetch size, consistency level, and retry policy defaults by configuring the following parameters on the CQL API instances: `CqlTemplate`, `AsyncCqlTemplate`, and `ReactiveCqlTemplate`.
334
334
Defaults apply if the particular query option is not set.
@@ -338,7 +338,7 @@ Defaults apply if the particular query option is not set.
338
338
339
339
Instances of the repository interfaces are usually created by a container, and the Spring container is the most natural choice when working with Spring Data.
340
340
Spring Data for Apache Cassandra ships with a custom CDI extension that allows using the repository abstraction in CDI environments.
341
-
The extension is part of the JAR.To activate it, drop the Spring Data for Apache Cassandra JAR into your classpath.
341
+
The extension is part of the JAR.To activate it, drop the Spring Data for Apache Cassandra JAR into your classpath.
342
342
You can now set up the infrastructure by implementing a CDI Producer for the
343
343
`CassandraTemplate`, as the following examlpe shows:
Copy file name to clipboardExpand all lines: src/main/asciidoc/reference/cassandra.adoc
+5-5Lines changed: 5 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -6,8 +6,8 @@ Spring Data support for Apache Cassandra contains a wide range of features:
6
6
* Spring configuration support with Java-based `@Configuration` classes or the XML namespace.
7
7
* The `CqlTemplate` helper class that increases productivity by properly handling common Cassandra data access operations.
8
8
* The `CassandraTemplate` helper class that provides object mapping between CQL Tables and POJOs.
9
-
* Exception translation into Spring's portable {spring-framework-docs}data-access.html#dao-exceptions[Data Access Exception Hierarchy].
10
-
* Feature rich object mapping integrated with _Spring's_ {spring-framework-docs}core.html#core-convert[Conversion Service].
9
+
* Exception translation into Spring's portable {springDocsUrl}data-access.html#dao-exceptions[Data Access Exception Hierarchy].
10
+
* Feature rich object mapping integrated with _Spring's_ {springDocsUrl}core.html#core-convert[Conversion Service].
11
11
* Annotation-based mapping metadata that is extensible to support other metadata formats.
12
12
* Java-based query, criteria, and update DSLs.
13
13
* Automatic implementation of `Repository` interfaces including support for custom finder methods.
@@ -19,7 +19,7 @@ Spring Data for Apache Cassandra uses consistent naming conventions on objects i
19
19
== Getting Started
20
20
21
21
Spring Data for Apache Cassandra requires Apache Cassandra 2.1 or later and Datastax Java Driver 4.0 or later.
22
-
An easy way to quickly set up and bootstrap a working environment is to create a Spring-based project in https://spring.io/tools/sts[STS] or use https://start.spring.io/[Spring Initializer].
22
+
An easy way to quickly set up and bootstrap a working environment is to create a Spring-based project in https://spring.io/tools[Spring Tools] or use https://start.spring.io/[Spring Initializer].
23
23
24
24
First, you need to set up a running Apache Cassandra server.
25
25
See the
@@ -116,7 +116,7 @@ These are discussed in the following sections.
116
116
117
117
NOTE: For those not familiar with how to configure the Spring container using Java-based bean metadata instead of XML-based metadata, see the high-level introduction in the reference docs
as well as the detailed documentation {spring-framework-docs}core.html#beans-java-instantiating-container[here].
119
+
as well as the detailed documentation {springDocsUrl}core.html#beans-java-instantiating-container[here].
120
120
121
121
[[cassandra.cassandra-java-config]]
122
122
=== Registering a Session Instance by Using Java-based Metadata
@@ -136,7 +136,7 @@ This approach lets you use the standard `com.datastax.oss.driver.api.core.CqlSes
136
136
An alternative is to register an instance of `com.datastax.oss.driver.api.core.CqlSession` with the container by using Spring's `CqlSessionFactoryBean`.
137
137
As compared to instantiating a `com.datastax.oss.driver.api.core.CqlSession` instance directly, the `FactoryBean` approach has the added advantage of also providing the container with an `ExceptionTranslator` implementation that translates Cassandra exceptions to exceptions in Spring's portable `DataAccessException` hierarchy.
138
138
This hierarchy and the use of
139
-
`@Repository` is described in {spring-framework-docs}data-access.html[Spring's DAO support features].
139
+
`@Repository` is described in {springDocsUrl}data-access.html[Spring's DAO support features].
140
140
141
141
The following example shows Java-based factory class usage:
The Spring Framework provides exception translation for a wide variety of database and mapping technologies.
4
-
This has traditionally been for JDBC and JPA. Spring Data for Apache Cassandra extends this feature to Apache Cassandra by providing an implementation of the `org.springframework.dao.support.PersistenceExceptionTranslator` interface.
4
+
This has traditionally been for JDBC and JPA.
5
+
Spring Data for Apache Cassandra extends this feature to Apache Cassandra by providing an implementation of the `org.springframework.dao.support.PersistenceExceptionTranslator` interface.
5
6
6
-
The motivation behind mapping to Spring's {spring-framework-docs}html/dao.html#dao-exceptions[consistent data access exception hierarchy]
7
+
The motivation behind mapping to Spring's {springDocsUrl}html/dao.html#dao-exceptions[consistent data access exception hierarchy]
7
8
is to let you write portable and descriptive exception handling code without resorting to coding against and handling specific Cassandra exceptions.
8
9
All of Spring's data access exceptions are inherited from the
9
10
`DataAccessException` class, so you can be sure that you can catch all database-related exceptions within a single try-catch block.
Copy file name to clipboardExpand all lines: src/main/asciidoc/reference/reactive-cassandra.adoc
+6-6Lines changed: 6 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -7,8 +7,8 @@ The reactive Cassandra support contains a wide range of features:
7
7
* `ReactiveCqlTemplate` helper class that increases productivity by properly handling common Cassandra data access operations.
8
8
* `ReactiveCassandraTemplate` helper class that increases productivity by using `ReactiveCassandraOperations` in a reactive manner.
9
9
It includes integrated object mapping between tables and POJOs.
10
-
* Exception translation into Spring's portable {spring-framework-docs}data-access.html#dao-exceptions[Data Access Exception Hierarchy].
11
-
* Feature rich object mapping integrated with Spring's {spring-framework-docs}core.html#core-convert[Conversion Service].
10
+
* Exception translation into Spring's portable {springDocsUrl}data-access.html#dao-exceptions[Data Access Exception Hierarchy].
11
+
* Feature rich object mapping integrated with Spring's {springDocsUrl}core.html#core-convert[Conversion Service].
12
12
* Java-based Query, Criteria, and Update DSLs.
13
13
* Automatic implementation of `Repository` interfaces, including support for custom finder methods.
14
14
@@ -19,7 +19,7 @@ Spring Data for Apache Cassandra uses consistent naming conventions on objects i
19
19
== Getting Started
20
20
21
21
Spring Data for Apache Cassandra requires Apache Cassandra 2.1 or later and Datastax Java Driver 4.0 or later.
22
-
An easy way to quickly set up and bootstrap a working environment is to create a Spring-based project in https://spring.io/tools/sts[STS] or use https://start.spring.io/[Spring Initializer].
22
+
An easy way to quickly set up and bootstrap a working environment is to create a Spring-based project in https://spring.io/tools[Spring Tools] or use https://start.spring.io/[Spring Initializer].
23
23
24
24
First, you need to set up a running Apache Cassandra server.
25
25
See the
@@ -64,7 +64,7 @@ If using a milestone release instead of a GA release, you also need to add the l
64
64
<repository>
65
65
<id>spring-milestone</id>
66
66
<name>Spring Maven MILESTONE Repository</name>
67
-
<url>https://repo.spring.io/libs-milestone</url>
67
+
<url>https://repo.spring.io/milestone</url>
68
68
</repository>
69
69
</repositories>
70
70
----
@@ -114,8 +114,8 @@ You can do so either by using Java-based bean metadata or by using XML-based bea
114
114
These are discussed in the following sections.
115
115
116
116
NOTE: For those not familiar with how to configure the Spring container using Java-based bean metadata instead of XML-based metadata, see the high-level introduction in the reference docs
0 commit comments