vert.x README

The project's README from github.com/eclipse-vertx/vert.x. As one markdown file: README.md.

Build Status (5.x) Build Status (4.x)

Vert.x Core

This is the repository for Vert.x core.

Vert.x core contains fairly low-level functionality, including support for HTTP, TCP, file system access, and various other features. You can use this directly in your own applications, and it's used by many of the other components of Vert.x.

For more information on Vert.x and where Vert.x core fits into the big picture please see the website.

Building Vert.x artifacts

> mvn package

Running tests

Runs the tests

> mvn test

Tests can be run with specified HTTP port and/or HTTPS port.

> mvn test -Dvertx.httpPort=8888 -Dvertx.httpsPort=4044

Vert.x supports native transport on BSD and Linux, to run the tests with native transport

> mvn test -PNativeEpoll
> mvn test -PNativeIoUring
> mvn test -PNativeKQueue

Vert.x supports domain sockets on Linux exclusively, to run the tests with domain sockets

> mvn test -PNativeEpoll+DomainSockets

Vert.x has integrations tests that run a differently configured JVM (classpath, system properties, etc....)

> vertx verify -Dtest=FooTest # FooTest does not exists, its only purpose is to execute no tests during the test phase

Building documentation

> mvn package -Pdocs -DskipTests

Open target/docs/vertx-core/java/index.html with your browser

vert.x (eclipse-vertx/vert.x)

Searching Database…

14.7K ·GitHub
这是什么?Vert.x Core 是一个用于在 JVM 上构建响应式、事件驱动应用的工具包,提供 HTTP、TCP、文件系统访问等底层支持。
这是框架还是我可以直接调用的库?它是一个工具包/库,可以嵌入到你自己的 JVM 应用中,而不是规定应用结构的完整框架。许多更高层的 Vert.x 组件都是基于这个核心模块构建的。
怎样把它添加到项目中?通过 JVM 构建工具(Maven/Gradle)将 vertx-core 构件添加为依赖;README 主要介绍如何使用随附的构建脚本从源码构建各个构件。
运行它除了 Java 还需要别的东西吗?你需要一个 JVM;Vert.x Core 的非阻塞 I/O 层基于 Netty 构建。
原生传输在所有操作系统上都能用吗?原生传输支持(用于获得更好的性能)仅限于 BSD 和 Linux,而 Unix 域套接字只在 Linux 上受支持。
Vert.x Core 开箱即用支持哪些网络协议?它内置支持 HTTP(包括 HTTP/2)、TCP、UDP 和文件系统访问,底层基于 Netty 的非阻塞 I/O。
为什么要用 Vert.x,而不是直接编写原始的 Netty 代码?Vert.x 在 Netty 之上封装了一层更高级的事件驱动 API(即 Vert.x 事件循环模型),让你无需直接处理 Netty 的底层细节,就能获得响应式、非阻塞的网络能力;同时,基于它构建的其他 Vert.x 生态组件也可以直接使用。
这个模块的文档是如何生成的?运行构建后会生成 HTML 文档,你可以在本地打开,例如 target/docs/vertx-core/java/index.html。
What are similar projects?gnet, akka-core, swoole-src, JCSprout, netty, uvloop, kafka, dubbo
Size
124.4 MB
Stars
14.7K
Updated
CommitOct 18
Age
15y
Commits · 90 Days