# otavia

**Repository Path**: mirrors/otavia

## Basic Information

- **Project Name**: otavia
- **Description**: otavia  是一个基于  Scala 3  实现的 IO 和 Actor 编程模型，他提供了一系列工具使编写高性能并发程序变得非常容易
- **Primary Language**: Scala
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://www.oschina.net/p/otavia
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-23
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align=center>
<img src="docs/_assets/images/logo.drawio.svg" alt="otavia" >
</div>
<h1 align=center>otavia</h1>

<p align=center ><b>一个有趣的 IO & Actor 编程模型</b></p>

![GitHub](https://img.shields.io/github/license/yankun1992/otavia)
[![GitHub Pages](https://github.com/otavia-projects/otavia/actions/workflows/gh-pages.yml/badge.svg)](https://otavia-projects.github.io/otavia/home.html)
![Static Badge](https://img.shields.io/badge/JDK-17%2B-blue)
![Static Badge](https://img.shields.io/badge/Scala-3.3-blue)
[![Unit Tests](https://github.com/otavia-projects/otavia/actions/workflows/unittest.yml/badge.svg)](https://github.com/otavia-projects/otavia/actions/workflows/unittest.yml)
![Maven Central](https://img.shields.io/maven-central/v/cc.otavia/otavia-runtime_3)
![GitHub commit activity](https://img.shields.io/github/commit-activity/y/otavia-projects/otavia)
![GitHub Release Date - Published_At](https://img.shields.io/github/release-date/otavia-projects/otavia)
![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/otavia-projects/otavia)


> 这个项目还不稳定，请谨慎的用于生成环境中。

<hr>

Language: [English](./README.md)

<hr>

## 介绍

`otavia` 是一个基于 `Scala 3` 实现的 `IO` 和 `Actor` 编程模型，他提供了一系列工具使编写高性能并发程序变得非常容易。

你可以通过以下文档快速的了解 `otavia` 的基本用法和核心的设计：

- [快速入门](./docs/_docs/zh/quick_start.md)
- [核心概念与设计](./docs/_docs/zh/core_concept.md)

更多文档可以在项目 [网站](https://otavia.cc/home.html) 查看。

## 特性

- **全链路异步**: 一切都是异步的，没有阻塞，没有线程挂起。
- **忘掉线程、忘掉锁**：使用 `otavia`，你将不再会被多线程问题困扰，你编写的一切代码都是单线程运行的！
- **简化并发**: `Actor` 和 `Channel` 让您更加容易构建高性能、易伸缩及更低资源占用的的系统。
- **设计的弹性**： 基于《反应性宣言》的原则，`Otavia` 允许你编写能自我修复的系统，并在面对失败时保持反应。
- **高性能**：在几秒钟内创建百万 `Actor` 实例并发送数亿条消息。
- **类型安全**： `Actor` 之间的发送的消息在编译时是类型安全的。
- **零成本 Ask-Pattern**：使用 ask 模式发送消息然后接收回复消息就像调用普通方法一样，而且开销非常低。
- **Actor 依赖注入**： `ActorSystem` 也被看作是一个 `Actor` 实例的容器，开发者可以在编译时类型安全的注入依赖 `Actor`。
- **强大的 IO 栈**： IO 栈是从 [Netty](https://netty.io) 移植而来，但支持 `AIO` 和文件通道。
- **async/await**： 使用 `Scala 3` 的元编程工具实现一套基于 CPS(Continuation Passing Style) 的 `async/await` 语法。
- **简洁的线程模型**：`otavia` 运行时的线程模型非常简洁并且高效，让您对系统 CPU 的利用率达到极致！
- **零依赖**：核心模块不依赖任何第三方包。
- **开放的生态系统**： `otavia` 提供了一个模块机制，允许用户轻松使用第三方模块库。

## 生态

`otavia` 的 IO 栈是从 Netty 移植而来的。为了让 IO 任务更好的与 Actor 模型工作在一起，`otavia` 并没有与 Netty
完全兼容。值得高兴的是 Netty 生态中大多数应用层网络协议的编解码代码是很容易移植到 `otavia` 的，所以我们维护了这个生态项目
主要用于从 Netty 以及 [Eclipse Vert.x](https://vertx.io/) 移植各种应用层网络协议的编解码代码。

- [GitHub - otavia-projects](https://github.com/otavia-projects)

## 贡献

欢迎任何形式的贡献！