!per #17862 Remove experimental from persistence
This commit is contained in:
Patrik Nordwall
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
|
||||
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
|
||||
`eventsourced`_ but significantly differs on API and implementation level.
|
||||
|
||||
.. _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
|
||||
============
|
||||
|
||||
|
|
@ -44,7 +26,7 @@ Akka persistence is a separate jar file. Make sure that you have the following d
|
|||
|
||||
<dependency>
|
||||
<groupId>com.typesafe.akka</groupId>
|
||||
<artifactId>akka-persistence-experimental_@binVersion@</artifactId>
|
||||
<artifactId>akka-persistence_@binVersion@</artifactId>
|
||||
<version>@version@</version>
|
||||
</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`)
|
||||
|
||||
.. 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
|
||||
concepts and architecture of `eventsourced`_ but significantly differs on API and implementation level. See also
|
||||
:ref:`migration-eventsourced-2.3`
|
||||
|
||||
.. _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
|
||||
============
|
||||
|
||||
|
|
@ -48,7 +30,7 @@ Akka persistence is a separate jar file. Make sure that you have the following d
|
|||
|
||||
<dependency>
|
||||
<groupId>com.typesafe.akka</groupId>
|
||||
<artifactId>akka-persistence-experimental_@binVersion@</artifactId>
|
||||
<artifactId>akka-persistence_@binVersion@</artifactId>
|
||||
<version>@version@</version>
|
||||
</dependency>
|
||||
|
||||
|
|
|
|||
|
|
@ -300,7 +300,27 @@ For the synchronous case you can return the result via ``scala.concurrent.Future
|
|||
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``
|
||||
|
|
|
|||
|
|
@ -10,6 +10,7 @@ Migration Guides
|
|||
migration-guide-2.0.x-2.1.x
|
||||
migration-guide-2.1.x-2.2.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-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
|
||||
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
|
||||
concepts and architecture of `eventsourced`_ but significantly differs on API and implementation level. See also
|
||||
:ref:`migration-eventsourced-2.3`
|
||||
|
||||
.. _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
|
||||
============
|
||||
|
||||
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
|
||||
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.experimentalSettings
|
||||
|
||||
Formatting.formatSettings
|
||||
|
||||
// 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.experimentalSettings
|
||||
|
||||
Formatting.formatSettings
|
||||
|
||||
OSGi.persistence
|
||||
|
|
|
|||
|
|
@ -36,7 +36,7 @@
|
|||
</dependency>
|
||||
<dependency>
|
||||
<groupId>com.typesafe.akka</groupId>
|
||||
<artifactId>akka-persistence-experimental_${scala.dep.version}</artifactId>
|
||||
<artifactId>akka-persistence_${scala.dep.version}</artifactId>
|
||||
</dependency>
|
||||
<dependency>
|
||||
<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")
|
||||
|
||||
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>
|
||||
<groupId>com.typesafe.akka</groupId>
|
||||
<artifactId>akka-persistence-experimental_2.11</artifactId>
|
||||
<artifactId>akka-persistence_2.11</artifactId>
|
||||
<version>2.4-SNAPSHOT</version>
|
||||
</dependency>
|
||||
<dependency>
|
||||
|
|
|
|||
|
|
@ -5,6 +5,6 @@ version := "2.4-SNAPSHOT"
|
|||
scalaVersion := "2.11.5"
|
||||
|
||||
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(
|
||||
"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(
|
||||
id = "akka-persistence-experimental",
|
||||
id = "akka-persistence",
|
||||
base = file("akka-persistence"),
|
||||
dependencies = Seq(actor, remote % "test->test", testkit % "test->test")
|
||||
)
|
||||
|
||||
lazy val persistenceTck = Project(
|
||||
id = "akka-persistence-experimental-tck",
|
||||
id = "akka-persistence-tck",
|
||||
base = file("akka-persistence-tck"),
|
||||
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)
|
||||
// Adding `PersistentActor.persistAsync`
|
||||
// Adding `PersistentActor.defer`
|
||||
// Changes in akka-persistence-experimental in #13944
|
||||
// Changes in akka-persistence in #13944
|
||||
// Changes in private LevelDB Store by #13962
|
||||
// Renamed `processorId` to `persistenceId`
|
||||
ProblemFilters.excludePackage("akka.persistence"),
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue