!per #17862 Remove experimental from persistence
This commit is contained in:
parent
fb5d338c06
commit
2694e13b32
14 changed files with 34 additions and 72 deletions
|
|
@ -14,29 +14,11 @@ changes to these actors from which they can rebuild internal state. This can be
|
||||||
or starting from a snapshot which can dramatically reduce recovery times. Akka persistence also provides point-to-point
|
or starting from a snapshot which can dramatically reduce recovery times. Akka persistence also provides point-to-point
|
||||||
communication with at-least-once message delivery semantics.
|
communication with at-least-once message delivery semantics.
|
||||||
|
|
||||||
.. warning::
|
|
||||||
|
|
||||||
This module is marked as **“experimental”** as of its introduction in Akka 2.3.0. We will continue to
|
|
||||||
improve this API based on our users’ feedback, which implies that while we try to keep incompatible
|
|
||||||
changes to a minimum the binary compatibility guarantee for maintenance releases does not apply to the
|
|
||||||
contents of the ``akka.persistence`` package.
|
|
||||||
|
|
||||||
Akka persistence is inspired by the `eventsourced`_ library. It follows the same concepts and architecture of
|
Akka persistence is inspired by the `eventsourced`_ library. It follows the same concepts and architecture of
|
||||||
`eventsourced`_ but significantly differs on API and implementation level.
|
`eventsourced`_ but significantly differs on API and implementation level.
|
||||||
|
|
||||||
.. _eventsourced: https://github.com/eligosource/eventsourced
|
.. _eventsourced: https://github.com/eligosource/eventsourced
|
||||||
|
|
||||||
Changes in Akka 2.3.4
|
|
||||||
=====================
|
|
||||||
|
|
||||||
In Akka 2.3.4 several of the concepts of the earlier versions were collapsed and simplified.
|
|
||||||
In essence; ``Processor`` and ``EventsourcedProcessor`` are replaced by ``PersistentActor``. ``Channel``
|
|
||||||
and ``PersistentChannel`` are replaced by ``AtLeastOnceDelivery``. ``View`` is replaced by ``PersistentView``.
|
|
||||||
|
|
||||||
See full details of the changes in the :ref:`migration-guide-persistence-experimental-2.3.x-2.4.x`.
|
|
||||||
The old classes are still included, and deprecated, for a while to make the transition smooth.
|
|
||||||
In case you need the old documentation it is located `here <http://doc.akka.io/docs/akka/2.3.3/java/lambda-persistence.html#persistence-lambda-java>`_.
|
|
||||||
|
|
||||||
Dependencies
|
Dependencies
|
||||||
============
|
============
|
||||||
|
|
||||||
|
|
@ -44,7 +26,7 @@ Akka persistence is a separate jar file. Make sure that you have the following d
|
||||||
|
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>com.typesafe.akka</groupId>
|
<groupId>com.typesafe.akka</groupId>
|
||||||
<artifactId>akka-persistence-experimental_@binVersion@</artifactId>
|
<artifactId>akka-persistence_@binVersion@</artifactId>
|
||||||
<version>@version@</version>
|
<version>@version@</version>
|
||||||
</dependency>
|
</dependency>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -17,30 +17,12 @@ communication with at-least-once message delivery semantics.
|
||||||
|
|
||||||
Java 8 lambda expressions are also supported. (See section :ref:`persistence-lambda-java`)
|
Java 8 lambda expressions are also supported. (See section :ref:`persistence-lambda-java`)
|
||||||
|
|
||||||
.. warning::
|
|
||||||
|
|
||||||
This module is marked as **“experimental”** as of its introduction in Akka 2.3.0. We will continue to
|
|
||||||
improve this API based on our users’ feedback, which implies that while we try to keep incompatible
|
|
||||||
changes to a minimum the binary compatibility guarantee for maintenance releases does not apply to the
|
|
||||||
contents of the ``akka.persistence`` package.
|
|
||||||
|
|
||||||
Akka persistence is inspired by and the official replacement of the `eventsourced`_ library. It follows the same
|
Akka persistence is inspired by and the official replacement of the `eventsourced`_ library. It follows the same
|
||||||
concepts and architecture of `eventsourced`_ but significantly differs on API and implementation level. See also
|
concepts and architecture of `eventsourced`_ but significantly differs on API and implementation level. See also
|
||||||
:ref:`migration-eventsourced-2.3`
|
:ref:`migration-eventsourced-2.3`
|
||||||
|
|
||||||
.. _eventsourced: https://github.com/eligosource/eventsourced
|
.. _eventsourced: https://github.com/eligosource/eventsourced
|
||||||
|
|
||||||
Changes in Akka 2.3.4
|
|
||||||
=====================
|
|
||||||
|
|
||||||
In Akka 2.3.4 several of the concepts of the earlier versions were collapsed and simplified.
|
|
||||||
In essence; ``Processor`` and ``EventsourcedProcessor`` are replaced by ``PersistentActor``. ``Channel``
|
|
||||||
and ``PersistentChannel`` are replaced by ``AtLeastOnceDelivery``. ``View`` is replaced by ``PersistentView``.
|
|
||||||
|
|
||||||
See full details of the changes in the :ref:`migration-guide-persistence-experimental-2.3.x-2.4.x`.
|
|
||||||
The old classes are still included, and deprecated, for a while to make the transition smooth.
|
|
||||||
In case you need the old documentation it is located `here <http://doc.akka.io/docs/akka/2.3.3/java/persistence.html>`_.
|
|
||||||
|
|
||||||
Dependencies
|
Dependencies
|
||||||
============
|
============
|
||||||
|
|
||||||
|
|
@ -48,7 +30,7 @@ Akka persistence is a separate jar file. Make sure that you have the following d
|
||||||
|
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>com.typesafe.akka</groupId>
|
<groupId>com.typesafe.akka</groupId>
|
||||||
<artifactId>akka-persistence-experimental_@binVersion@</artifactId>
|
<artifactId>akka-persistence_@binVersion@</artifactId>
|
||||||
<version>@version@</version>
|
<version>@version@</version>
|
||||||
</dependency>
|
</dependency>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -300,7 +300,27 @@ For the synchronous case you can return the result via ``scala.concurrent.Future
|
||||||
Akka Persistence
|
Akka Persistence
|
||||||
================
|
================
|
||||||
|
|
||||||
Mendatory persistenceId
|
Experimental removed
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
The artifact name has changed from ``akka-persistence-experimental`` to ``akka-persistence``.
|
||||||
|
|
||||||
|
New sbt dependency::
|
||||||
|
|
||||||
|
"com.typesafe.akka" %% "akka-persistence" % "@version@" @crossString@
|
||||||
|
|
||||||
|
New Maven dependency::
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>com.typesafe.akka</groupId>
|
||||||
|
<artifactId>akka-persistence_@binVersion@</artifactId>
|
||||||
|
<version>@version@</version>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
The artefact name of the Persistent TCK has changed from ``akka-persistence-tck-experimental`` (``akka-persistence-experimental-tck``) to
|
||||||
|
``akka-persistence-tck``.
|
||||||
|
|
||||||
|
Mandatory persistenceId
|
||||||
-----------------------
|
-----------------------
|
||||||
|
|
||||||
It is now mandatory to define the ``persistenceId`` in subclasses of ``PersistentActor``, ``UntypedPersistentActor``
|
It is now mandatory to define the ``persistenceId`` in subclasses of ``PersistentActor``, ``UntypedPersistentActor``
|
||||||
|
|
|
||||||
|
|
@ -10,6 +10,7 @@ Migration Guides
|
||||||
migration-guide-2.0.x-2.1.x
|
migration-guide-2.0.x-2.1.x
|
||||||
migration-guide-2.1.x-2.2.x
|
migration-guide-2.1.x-2.2.x
|
||||||
migration-guide-2.2.x-2.3.x
|
migration-guide-2.2.x-2.3.x
|
||||||
migration-guide-2.3.x-2.4.x
|
|
||||||
migration-guide-persistence-experimental-2.3.x-2.4.x
|
migration-guide-persistence-experimental-2.3.x-2.4.x
|
||||||
migration-guide-eventsourced-2.3.x
|
migration-guide-eventsourced-2.3.x
|
||||||
|
migration-guide-2.3.x-2.4.x
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -13,37 +13,18 @@ changes to these actors from which they can rebuild internal state. This can be
|
||||||
or starting from a snapshot which can dramatically reduce recovery times. Akka persistence also provides point-to-point
|
or starting from a snapshot which can dramatically reduce recovery times. Akka persistence also provides point-to-point
|
||||||
communication with at-least-once message delivery semantics.
|
communication with at-least-once message delivery semantics.
|
||||||
|
|
||||||
.. warning::
|
|
||||||
|
|
||||||
This module is marked as **“experimental”** as of its introduction in Akka 2.3.0. We will continue to
|
|
||||||
improve this API based on our users’ feedback, which implies that while we try to keep incompatible
|
|
||||||
changes to a minimum the binary compatibility guarantee for maintenance releases does not apply to the
|
|
||||||
contents of the ``akka.persistence`` package.
|
|
||||||
|
|
||||||
Akka persistence is inspired by and the official replacement of the `eventsourced`_ library. It follows the same
|
Akka persistence is inspired by and the official replacement of the `eventsourced`_ library. It follows the same
|
||||||
concepts and architecture of `eventsourced`_ but significantly differs on API and implementation level. See also
|
concepts and architecture of `eventsourced`_ but significantly differs on API and implementation level. See also
|
||||||
:ref:`migration-eventsourced-2.3`
|
:ref:`migration-eventsourced-2.3`
|
||||||
|
|
||||||
.. _eventsourced: https://github.com/eligosource/eventsourced
|
.. _eventsourced: https://github.com/eligosource/eventsourced
|
||||||
|
|
||||||
Changes in Akka 2.3.4
|
|
||||||
=====================
|
|
||||||
|
|
||||||
In Akka 2.3.4 several of the concepts of the earlier versions were collapsed and simplified.
|
|
||||||
In essence; ``Processor`` and ``EventsourcedProcessor`` are replaced by ``PersistentActor``. ``Channel``
|
|
||||||
and ``PersistentChannel`` are replaced by ``AtLeastOnceDelivery``. ``View`` is replaced by ``PersistentView``.
|
|
||||||
|
|
||||||
See full details of the changes in the :ref:`migration-guide-persistence-experimental-2.3.x-2.4.x`.
|
|
||||||
The old classes are still included, and deprecated, for a while to make the transition smooth.
|
|
||||||
In case you need the old documentation it is located `here <http://doc.akka.io/docs/akka/2.3.3/scala/persistence.html>`_.
|
|
||||||
|
|
||||||
|
|
||||||
Dependencies
|
Dependencies
|
||||||
============
|
============
|
||||||
|
|
||||||
Akka persistence is a separate jar file. Make sure that you have the following dependency in your project::
|
Akka persistence is a separate jar file. Make sure that you have the following dependency in your project::
|
||||||
|
|
||||||
"com.typesafe.akka" %% "akka-persistence-experimental" % "@version@" @crossString@
|
"com.typesafe.akka" %% "akka-persistence" % "@version@" @crossString@
|
||||||
|
|
||||||
Akka persistence extension comes with few built-in persistence plugins, including
|
Akka persistence extension comes with few built-in persistence plugins, including
|
||||||
in-memory heap based journal, local file-system based snapshot-store and LevelDB based journal.
|
in-memory heap based journal, local file-system based snapshot-store and LevelDB based journal.
|
||||||
|
|
|
||||||
|
|
@ -3,8 +3,6 @@ import com.typesafe.tools.mima.plugin.MimaKeys
|
||||||
|
|
||||||
AkkaBuild.defaultSettings
|
AkkaBuild.defaultSettings
|
||||||
|
|
||||||
AkkaBuild.experimentalSettings
|
|
||||||
|
|
||||||
Formatting.formatSettings
|
Formatting.formatSettings
|
||||||
|
|
||||||
// OSGi.persistenceTck TODO: we do need to export this as OSGi bundle too?
|
// OSGi.persistenceTck TODO: we do need to export this as OSGi bundle too?
|
||||||
|
|
|
||||||
|
|
@ -3,8 +3,6 @@ import com.typesafe.tools.mima.plugin.MimaKeys
|
||||||
|
|
||||||
AkkaBuild.defaultSettings
|
AkkaBuild.defaultSettings
|
||||||
|
|
||||||
AkkaBuild.experimentalSettings
|
|
||||||
|
|
||||||
Formatting.formatSettings
|
Formatting.formatSettings
|
||||||
|
|
||||||
OSGi.persistence
|
OSGi.persistence
|
||||||
|
|
|
||||||
|
|
@ -36,7 +36,7 @@
|
||||||
</dependency>
|
</dependency>
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>com.typesafe.akka</groupId>
|
<groupId>com.typesafe.akka</groupId>
|
||||||
<artifactId>akka-persistence-experimental_${scala.dep.version}</artifactId>
|
<artifactId>akka-persistence_${scala.dep.version}</artifactId>
|
||||||
</dependency>
|
</dependency>
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>com.typesafe</groupId>
|
<groupId>com.typesafe</groupId>
|
||||||
|
|
|
||||||
|
|
@ -9,6 +9,6 @@ javacOptions in compile ++= Seq("-encoding", "UTF-8", "-source", "1.8", "-target
|
||||||
javacOptions in doc ++= Seq("-encoding", "UTF-8", "-source", "1.8", "-Xdoclint:none")
|
javacOptions in doc ++= Seq("-encoding", "UTF-8", "-source", "1.8", "-Xdoclint:none")
|
||||||
|
|
||||||
libraryDependencies ++= Seq(
|
libraryDependencies ++= Seq(
|
||||||
"com.typesafe.akka" %% "akka-persistence-experimental" % "2.4-SNAPSHOT"
|
"com.typesafe.akka" %% "akka-persistence" % "2.4-SNAPSHOT"
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -21,7 +21,7 @@
|
||||||
</dependency>
|
</dependency>
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>com.typesafe.akka</groupId>
|
<groupId>com.typesafe.akka</groupId>
|
||||||
<artifactId>akka-persistence-experimental_2.11</artifactId>
|
<artifactId>akka-persistence_2.11</artifactId>
|
||||||
<version>2.4-SNAPSHOT</version>
|
<version>2.4-SNAPSHOT</version>
|
||||||
</dependency>
|
</dependency>
|
||||||
<dependency>
|
<dependency>
|
||||||
|
|
|
||||||
|
|
@ -5,6 +5,6 @@ version := "2.4-SNAPSHOT"
|
||||||
scalaVersion := "2.11.5"
|
scalaVersion := "2.11.5"
|
||||||
|
|
||||||
libraryDependencies ++= Seq(
|
libraryDependencies ++= Seq(
|
||||||
"com.typesafe.akka" %% "akka-persistence-experimental" % "2.4-SNAPSHOT"
|
"com.typesafe.akka" %% "akka-persistence" % "2.4-SNAPSHOT"
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -6,5 +6,5 @@ scalaVersion := "2.11.5"
|
||||||
|
|
||||||
libraryDependencies ++= Seq(
|
libraryDependencies ++= Seq(
|
||||||
"com.typesafe.akka" %% "akka-actor" % "2.4-SNAPSHOT",
|
"com.typesafe.akka" %% "akka-actor" % "2.4-SNAPSHOT",
|
||||||
"com.typesafe.akka" %% "akka-persistence-experimental" % "2.4-SNAPSHOT"
|
"com.typesafe.akka" %% "akka-persistence" % "2.4-SNAPSHOT"
|
||||||
)
|
)
|
||||||
|
|
|
||||||
|
|
@ -158,13 +158,13 @@ object AkkaBuild extends Build {
|
||||||
)
|
)
|
||||||
|
|
||||||
lazy val persistence = Project(
|
lazy val persistence = Project(
|
||||||
id = "akka-persistence-experimental",
|
id = "akka-persistence",
|
||||||
base = file("akka-persistence"),
|
base = file("akka-persistence"),
|
||||||
dependencies = Seq(actor, remote % "test->test", testkit % "test->test")
|
dependencies = Seq(actor, remote % "test->test", testkit % "test->test")
|
||||||
)
|
)
|
||||||
|
|
||||||
lazy val persistenceTck = Project(
|
lazy val persistenceTck = Project(
|
||||||
id = "akka-persistence-experimental-tck",
|
id = "akka-persistence-tck",
|
||||||
base = file("akka-persistence-tck"),
|
base = file("akka-persistence-tck"),
|
||||||
dependencies = Seq(persistence % "compile;provided->provided;test->test", testkit % "compile;test->test")
|
dependencies = Seq(persistence % "compile;provided->provided;test->test", testkit % "compile;test->test")
|
||||||
)
|
)
|
||||||
|
|
|
||||||
|
|
@ -50,7 +50,7 @@ object MiMa extends AutoPlugin {
|
||||||
// Changes in akka-stream-experimental are not binary compatible - still source compatible (2.3.3 -> 2.3.4)
|
// Changes in akka-stream-experimental are not binary compatible - still source compatible (2.3.3 -> 2.3.4)
|
||||||
// Adding `PersistentActor.persistAsync`
|
// Adding `PersistentActor.persistAsync`
|
||||||
// Adding `PersistentActor.defer`
|
// Adding `PersistentActor.defer`
|
||||||
// Changes in akka-persistence-experimental in #13944
|
// Changes in akka-persistence in #13944
|
||||||
// Changes in private LevelDB Store by #13962
|
// Changes in private LevelDB Store by #13962
|
||||||
// Renamed `processorId` to `persistenceId`
|
// Renamed `processorId` to `persistenceId`
|
||||||
ProblemFilters.excludePackage("akka.persistence"),
|
ProblemFilters.excludePackage("akka.persistence"),
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue