From 2694e13b326f84ae94be2560362d57c20b53a301 Mon Sep 17 00:00:00 2001 From: Patrik Nordwall Date: Tue, 11 Aug 2015 11:20:32 +0200 Subject: [PATCH] !per #17862 Remove experimental from persistence --- akka-docs/rst/java/lambda-persistence.rst | 20 +---------------- akka-docs/rst/java/persistence.rst | 20 +---------------- .../project/migration-guide-2.3.x-2.4.x.rst | 22 ++++++++++++++++++- akka-docs/rst/project/migration-guides.rst | 3 ++- akka-docs/rst/scala/persistence.rst | 21 +----------------- akka-persistence-tck/build.sbt | 2 -- akka-persistence/build.sbt | 2 -- .../core/pom.xml | 2 +- .../build.sbt | 2 +- .../pom.xml | 2 +- .../akka-sample-persistence-java/build.sbt | 2 +- .../akka-sample-persistence-scala/build.sbt | 2 +- project/AkkaBuild.scala | 4 ++-- project/MiMa.scala | 2 +- 14 files changed, 34 insertions(+), 72 deletions(-) diff --git a/akka-docs/rst/java/lambda-persistence.rst b/akka-docs/rst/java/lambda-persistence.rst index bdef9e2353..b0267dc736 100644 --- a/akka-docs/rst/java/lambda-persistence.rst +++ b/akka-docs/rst/java/lambda-persistence.rst @@ -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 `_. - Dependencies ============ @@ -44,7 +26,7 @@ Akka persistence is a separate jar file. Make sure that you have the following d com.typesafe.akka - akka-persistence-experimental_@binVersion@ + akka-persistence_@binVersion@ @version@ diff --git a/akka-docs/rst/java/persistence.rst b/akka-docs/rst/java/persistence.rst index 5a1832f485..8c84f71eb6 100644 --- a/akka-docs/rst/java/persistence.rst +++ b/akka-docs/rst/java/persistence.rst @@ -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 `_. - Dependencies ============ @@ -48,7 +30,7 @@ Akka persistence is a separate jar file. Make sure that you have the following d com.typesafe.akka - akka-persistence-experimental_@binVersion@ + akka-persistence_@binVersion@ @version@ diff --git a/akka-docs/rst/project/migration-guide-2.3.x-2.4.x.rst b/akka-docs/rst/project/migration-guide-2.3.x-2.4.x.rst index 0abc5a5a0e..305e0a34bd 100644 --- a/akka-docs/rst/project/migration-guide-2.3.x-2.4.x.rst +++ b/akka-docs/rst/project/migration-guide-2.3.x-2.4.x.rst @@ -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:: + + + com.typesafe.akka + akka-persistence_@binVersion@ + @version@ + + +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`` diff --git a/akka-docs/rst/project/migration-guides.rst b/akka-docs/rst/project/migration-guides.rst index 2dae824d3c..23e306dc02 100644 --- a/akka-docs/rst/project/migration-guides.rst +++ b/akka-docs/rst/project/migration-guides.rst @@ -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 + diff --git a/akka-docs/rst/scala/persistence.rst b/akka-docs/rst/scala/persistence.rst index 2c28f9092a..6d516ff6ec 100644 --- a/akka-docs/rst/scala/persistence.rst +++ b/akka-docs/rst/scala/persistence.rst @@ -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 `_. - - 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. diff --git a/akka-persistence-tck/build.sbt b/akka-persistence-tck/build.sbt index c31672846c..a2c563926f 100644 --- a/akka-persistence-tck/build.sbt +++ b/akka-persistence-tck/build.sbt @@ -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? diff --git a/akka-persistence/build.sbt b/akka-persistence/build.sbt index 978c6a0b83..8800ddc43e 100644 --- a/akka-persistence/build.sbt +++ b/akka-persistence/build.sbt @@ -3,8 +3,6 @@ import com.typesafe.tools.mima.plugin.MimaKeys AkkaBuild.defaultSettings -AkkaBuild.experimentalSettings - Formatting.formatSettings OSGi.persistence diff --git a/akka-samples/akka-sample-osgi-dining-hakkers/core/pom.xml b/akka-samples/akka-sample-osgi-dining-hakkers/core/pom.xml index c6f8145e92..4087122b8c 100644 --- a/akka-samples/akka-sample-osgi-dining-hakkers/core/pom.xml +++ b/akka-samples/akka-sample-osgi-dining-hakkers/core/pom.xml @@ -36,7 +36,7 @@ com.typesafe.akka - akka-persistence-experimental_${scala.dep.version} + akka-persistence_${scala.dep.version} com.typesafe diff --git a/akka-samples/akka-sample-persistence-java-lambda/build.sbt b/akka-samples/akka-sample-persistence-java-lambda/build.sbt index 15c6f05251..a1e59bd55c 100644 --- a/akka-samples/akka-sample-persistence-java-lambda/build.sbt +++ b/akka-samples/akka-sample-persistence-java-lambda/build.sbt @@ -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" ) diff --git a/akka-samples/akka-sample-persistence-java-lambda/pom.xml b/akka-samples/akka-sample-persistence-java-lambda/pom.xml index 8b8db9afcc..7fc5ccee63 100644 --- a/akka-samples/akka-sample-persistence-java-lambda/pom.xml +++ b/akka-samples/akka-sample-persistence-java-lambda/pom.xml @@ -21,7 +21,7 @@ com.typesafe.akka - akka-persistence-experimental_2.11 + akka-persistence_2.11 2.4-SNAPSHOT diff --git a/akka-samples/akka-sample-persistence-java/build.sbt b/akka-samples/akka-sample-persistence-java/build.sbt index ca639bd7f6..aee0022655 100644 --- a/akka-samples/akka-sample-persistence-java/build.sbt +++ b/akka-samples/akka-sample-persistence-java/build.sbt @@ -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" ) diff --git a/akka-samples/akka-sample-persistence-scala/build.sbt b/akka-samples/akka-sample-persistence-scala/build.sbt index 50135f9aa4..90d7f3a361 100644 --- a/akka-samples/akka-sample-persistence-scala/build.sbt +++ b/akka-samples/akka-sample-persistence-scala/build.sbt @@ -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" ) diff --git a/project/AkkaBuild.scala b/project/AkkaBuild.scala index e49ce06c35..81a989d93a 100644 --- a/project/AkkaBuild.scala +++ b/project/AkkaBuild.scala @@ -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") ) diff --git a/project/MiMa.scala b/project/MiMa.scala index ef3d2cb260..585f2caa0b 100644 --- a/project/MiMa.scala +++ b/project/MiMa.scala @@ -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"),