Vert.x Documentation

入门

Vert.x can be used for many different things so we provide a wide range of examples demonstrating usage of Vert.x in many different situations - from getting started with a hello world exampanle in Maven or Gradle to a range of web application examples.
Vert.x可以用于许多不同的事情，因此我们提供了许多在不同的情况使用Vert.x的示例-从开始使用的一个基于Maven或Grade构建的Hello World例子到一系列的Web应用程序实例。

Start with the main README and let that guide you through.
从READEME开始，它会指导你学习全部。

探索

Vert.x contains several different components designed to make it easier for you to write compelling reactive applications in a range of different languages.
Vert.x包含几种不同的组件，这些组件旨在让你更容易的去使用不同的编程语言来完成响应式应用。

Vert.x is highly modular and you just use the bits that you need and nothing more.
Vert.x 具有高度模块化，你只需要使用你需要的模块即可。

And don't forget - Vert.x is a library not a restrictive container so you don't have to only use components provided by Vert.x. You can also use use Vert.x with all the usual libraries that you like.
并且不要忘了－－Vert.x本身就是一个库，并不是一个限制性的容器。所以不必仅仅使用Vert.x提供的组件，你也可以使用你喜欢的所有常用库。

The sections below describe most of the major components of Vert.x, with links to the source repository, manuals in different languages, and API documentation.
下面这个部分讲述了Vert.x大部分的组件，源码库的链接，不同语言的手册以及API文档。

On this page are only listed components that are part of the official Vert.x stack. You can find a lot more components, and see the high diversity of the Vert.x ecosystem, on the Vert.x awesome page.
此页面仅列举了Vert.x的部分官方组件。你可以在vertx-awesome中找到更多的组件，并且可以看到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
Vert.x core库包含一些初级的功能，包括对HTTP，TCP，文件系统访问以及其他多种特性的支持。你可以在你的应用中直接使用它，其实Vert.x的很多组件也使用了它。

Source
Java: Manual | Examples | API
JavaScript: Manual | Examples | API
Groovy: Manual | Examples | API
Ruby: Manual | Examples | API

Web
Vert.x-Web is a toolkit for writing sophisticated modern web applications and HTTP microservices.
Vert.x-Web是一个工具包，用于编写复杂的现代Web应用程序和HTTP微服务。

Source | Examples
Java: Manual | API
JavaScript: Manual | API
Groovy: Manual | API
Ruby: Manual | API

Data access
Vert.x provides a few different asynchronous clients for accessing various data stores from your application. You don't have to use these clients - you could use clients direct from the vendor if you prefer (e.g. MongoDB provide their own cool async and reactive clients), but these provide a simple async API which is available in various languages.
Vert.x提供了一些不同的异步客户端来访问你的应用里多种的数据存储，你不必使用这些客户端，如果你愿意你可以直接使用由供应商提供的客户端（比如 MongoDB 提供了很酷的异步和响应式客户端），但是这些提供了适用于多种语言一个简单的异步API。

MongoDB client
Source
Java: Manual | API
JavaScript: Manual | API
Groovy: Manual | API
Ruby: Manual | API

JDBC client
Source | Examples
Java: Manual | API
JavaScript: Manual | API
Groovy: Manual | API
Ruby: Manual | API

SQL common
The common SQL APIs
Source
Java: Manual | API
JavaScript: Manual | API
Groovy: Manual | API
Ruby: Manual | API

Redis client
Source | Examples
Java: Manual | API
JavaScript: Manual | API
Groovy: Manual | API
Ruby: Manual | API

集成 Integration

Mail Client
Vert.x provides a simple SMTP mail client so you can send emails from your applications.
Vert.x提供了一个简单的SMTP 邮件客户端，所以你可以在你的应用中发送邮件。
Source | Examples
Java: Manual | API
JavaScript: Manual | API
Groovy: Manual | API
Ruby: Manual | API

JCA Adaptor
Vert.x provides a Java Connector Architecture (JCA) adaptor which allows it to interoperate with any JavaEE application server.
Vert.x提供了一个允许在任何JavaEE应用服务器里交互操作J2EE 连接器架构。
Source

认证与授权

Vert.x提供了在你应用中认证的简单API。同时也提供了一些开箱即用的实现。

Auth common
The Common Auth APIs

Source
Java: Manual | API
JavaScript: Manual | API
Groovy: Manual | API
Ruby: Manual | API
JDBC auth

Auth implementation backed by JDBC
Source
Java: Manual | API
JavaScript: Manual | API
Groovy: Manual | API
Ruby: Manual | API
JWT auth

Auth implementation using JSON web tokens (JWT)
Source
Java: Manual | API
JavaScript: Manual | API
Groovy: Manual | API
Ruby: Manual | API
Shiro auth

Auth implementation using Apache Shiro
Source
Java: Manual | API
JavaScript: Manual | API
Groovy: Manual | API
Ruby: Manual | API

Reactive

Vert.x provides a couple of components to make your applications more reactive.
Vert.x提供了一些组件，使您的编写响应式应用程序。

Vert.x Rx
Don't like callback-style APIs? Vert.x provides Rx-ified (using RxJava) versions for most of its APIs so you can use those if you prefer.
不喜欢回调式的API？Vertx提供了基于RxJava响应式编程的API，如果你喜欢你可以使用它。

Source | Examples
Java: Manual | API
JavaScript: Manual | API
Groovy: Manual | API

Reactive streams
Vert.x supports reactive streams so your applications can interoperate with other reactive systems such as Akka or Project Reactor.
Vert.x 支持响应式编程，所以你的应用可以与其他响应系统例如Akka或者其他基于反应堆模式的框架进行交互操作。
Source
Java: Manual | API

Metrics

This component captures metrics from various Vert.x core components and exposes them using the popular Dropwizard metrics library.
该组件进行度量各种Vert.x核心组件，可以通过使用流行的Dropwizard metrics 库来暴露它们。
Source | Examples
Java: Manual | API
JavaScript: Manual | API
Ruby: Manual | API

Testing

Vert.x-Unit is an unit testing tool-kit especially design to work well with asynchronous code.
Vert.x-Unit 是一个单元测试工具，尤其适用与异步代码。
Source | Examples
Java: Manual | Examples | API
JavaScript: Manual | API
Groovy: Manual | API
Ruby: Manual | API

Clustering

Vert.x supports clustering and HA out of the box. Cluster group management is implemented in cluster managers which are pluggable. The default cluster manager uses Hazelcast.
Vert.x支持开箱即用的集群和HA。集群组管理在可插入的cluster managers中实现。默认的集群管理器 使用的是Hazelcast。

Hazelcast
Source
Manual

Services

Vert.x services are a simple and effective way to encapsulate reusable functionality for use elsewhere. Services are deployed using a service identifier which decouples the user from details of the implementation.
Vert.x services 是一个简单有效的方式去封装可重用功能，到处可以使用。通过使用一个可以让使用者从实现的细节中分离出来的服务ID(service identifier)可以发布Services。

Service Factories

How to package and deploy Vert.x services.
怎么去打包和发布Vert.x services
Source

Service Proxies
Proxies allow remote event bus services to be called as if they were local.
服务代理允许就像在本地一样的去调用远程事件总线服务。
Source
Examples

Maven Service Factory
This lets you dynamically install and deploy services from Maven at run-time.
可以让你在Maven运行时动态的安装和发布服务。
Source
Manual
Examples

HTTP Service Factory
This lets you dynamically install and deploy services from an HTTP server (for example Bintray) at run-time.
让你在HTTP服务器运行时动态的安装和发布服务(例如Bintray) 。
Source
Manual

Cloud and Docker

Vert.x OpenShift Cartridge
This cartridge allows you to easily run clusterable Vert.x applications on the Red Hat OpenShift cloud platform.
它可以让你在红帽OpenShift云平台上很容易的去跑Vert.x集群应用。
Source
Examples

Vert.x OpenShift Using DIY Cartridge
This cartridge allows you to get started running simple applications quickly on the Red Hat OpenShift cloud platform.
它可以让你在红帽OpenShift云平台上快速的去执行简单的应用。
Source
Examples

Vert.x Docker 镜像
These docker images let you run Vert.x applications in Docker containers.
这些docker 镜像让你在Docker容器中去跑 Vert.x应用。
Source
Manual
Docker registry
Examples

Advanced

Some of the more advanced or internal bits and pieces. You won't normally use these directly in your own projects. They're mainly stuff we use internally.
这是一些比较高级或者内部的点滴。你一般不会在你自己的项目中直接使用。我们主要在内部使用它们。

Codegen
This is the magic that translates Java APIs into other languages.
把Java API 转化成其他的语言，这是很神奇的！
Source

Docgen
Creates asciidoc and API documentation from in-source docs.
从in-source 文档中创建ascii文档和API文档。
Source

Codetrans
More magic that translates code into other languages (we mainly use this for translating examples)
更为神奇的是将代码转化到其他语言(我们主要使用它来转化例子)。
Source

Distro
This project builds the various Vert.x distributions.
Source
这个项目构建多种Vert.x的发布。

Web-site
This is the repository that creates this web-site.
这个是创建此网站的仓库。
Source