Apache Pekko Persistence JDBC 项目教程

Apache Pekko Persistence JDBC 项目教程

pekko-persistence-jdbcAsynchronously writes journal and snapshot entries to configured JDBC databases so that Apache Pekko Actors can recover state项目地址:https://gitcode.com/gh_mirrors/pe/pekko-persistence-jdbc

1. 项目的目录结构及介绍

Apache Pekko Persistence JDBC 项目的目录结构如下：

pekko-persistence-jdbc/
├── src/
│   ├── main/
│   │   ├── java/
│   │   ├── resources/
│   │   └── scala/
│   └── test/
│       ├── java/
│       ├── resources/
│       └── scala/
├── project/
├── .gitignore
├── .scalafmt.conf
├── build.sbt
├── CONTRIBUTING.md
├── LICENSE
├── README.md
└── RELEASE-NOTES.md

目录结构介绍

• src/main/java/ 和 src/main/scala/：包含项目的主要源代码，分别用 Java 和 Scala 编写。
• src/main/resources/：包含项目的资源文件，如配置文件等。
• src/test/java/ 和 src/test/scala/：包含项目的测试代码。
• project/：包含 SBT 构建工具的配置文件。
• .gitignore：Git 版本控制系统的忽略文件配置。
• .scalafmt.conf：Scala 代码格式化配置文件。
• build.sbt：SBT 构建脚本。
• CONTRIBUTING.md：贡献指南。
• LICENSE：项目许可证。
• README.md：项目说明文档。
• RELEASE-NOTES.md：发布说明。

2. 项目的启动文件介绍

项目的启动文件通常位于 src/main/scala/ 或 src/main/java/ 目录下。具体文件名和路径可能因项目结构而异。以下是一个示例启动文件的介绍：

package com.example

import akka.actor.ActorSystem
import akka.persistence.jdbc.query.scaladsl.JdbcReadJournal
import akka.persistence.query.PersistenceQuery

object Main extends App {
  // 创建 ActorSystem
  val system = ActorSystem("MyActorSystem")

  // 初始化持久化查询
  val readJournal = PersistenceQuery(system).readJournalFor[JdbcReadJournal](JdbcReadJournal.Identifier)

  // 启动应用程序逻辑
  // ...

  // 关闭 ActorSystem
  system.terminate()
}

启动文件介绍

• ActorSystem：创建一个 Actor 系统实例。
• JdbcReadJournal：初始化持久化查询，用于读取持久化数据。
• system.terminate()：关闭 Actor 系统。

3. 项目的配置文件介绍

项目的配置文件通常位于 src/main/resources/ 目录下。以下是一个示例配置文件的介绍：

pekko {
  persistence {
    journal {
      plugin = "jdbc-journal"
      auto-start-journals = ["jdbc-journal"]
    }
    snapshot-store {
      plugin = "jdbc-snapshot-store"
      auto-start-snapshot-stores = ["jdbc-snapshot-store"]
    }
    state {
      plugin = "jdbc-durable-state-store"
    }
  }
}

jdbc-journal {
  slick = ${slick}
}

jdbc-snapshot-store {
  slick = ${slick}
}

jdbc-read-journal {
  slick = ${slick}
}

jdbc-durable-state-store {
  slick = ${slick}
}

slick {
  profile = "slick.jdbc.PostgresProfile$"
  db {
    host = "localhost"
    url = "jdbc:postgresql://${pekko-persistence-jdbc.shared-databases.slick.db.host}:5432/docker?reWriteBatchedInserts=true"
    user = "docker"
    password = "docker"
    driver = "org.postgresql.Driver"
    numThreads = 5
    maxConnections = 5
    minConnections = 1
  }
}

配置文件介绍

• pekko.persistence：配置持久化插件。
  • journal：配置日志插件。
  • snapshot-store：配置快照存储插件。
  • state：配置持久化

pekko-persistence-jdbcAsynchronously writes journal and snapshot entries to configured JDBC databases so that Apache Pekko Actors can recover state项目地址:https://gitcode.com/gh_mirrors/pe/pekko-persistence-jdbc