himozhang / vertx-zero-example

New Version

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


title:Zero 中文教程

Maven Central Apache License 2 Build Status

云原生版本在重新制作和开发,所以以前规划的 Zero Ui 和 Zero Extension框架文档全部转移到云端白皮书中:

后续所有和工程开发强相关的教程部分会直接转移到白皮书中进行介绍,中文教程中不再提供,白皮书中包括工程规范、环境搭建、运维部署、开发技巧、配置实施手册等全方位开发手册。

0.楔子

Zero,又称为:“零”,最初的名字起源于高达W中的“飞翼零式”,其实那时想写个框架,最好是:零编码、零配置、零BUG——也许这只是个遥远的梦。从正式官方网站的英文教程问世后,就再也没有更新过教程了,于是重新开启“零”的大门,只是我依旧在尝试将教程写得更加梦幻,最初的落笔点就是名字,包括项目名字、章节名字。

有人说Zero只有后端,其实相反,它还包含一套定制过的前端,虽然不是符合所有人的胃口,但是,从目前已经上线的几个生产系统看来,也简化了不少开发的工作量。于是通过“闯关 ”的方式来写一条类似游戏攻略一样的东西,说不定把读者当做玩家,简而精,能提炼更好的心得呢?

1. 资源

Zero相关的资源表

在线地址 说明
http://www.vertxup.cn Zero,后端框架
http://www.vertxui.cn Zero UI,前端框架
http://www.vertxai.cn Zero 工具集
http://www.vertx-cloud.cn Zero 数据规范(含白皮书)

Zero公众号(申请微信群先加微信号:445191171):

如果您喜欢Zero,帮忙点个Star,谢谢:

2. 教程

我一直在思考使用什么样的方式来写教程,如果告别了曾经那种概念,是不是会写成空中楼阁一样只有代码和“招式”的东西,沉淀下来,还是简单点吧(图、代码、解说一步到位),不过项目名称还是沿用希腊神话中的诸神之名,含义为:以诸神之名开启零之誓约。

Zero目前的版本中仅支持Maven,最新版为0.6.2,一直以0前缀做版本号,是因为我在收集生产环境的运行数据,当然我希望它的1.0是经过了生产环境验证的框架,成为一个真正可用的框架,而不是简单的样子货而已。

环境

在您的Maven项目的 pom.xml 文件中引入以下配置(推荐使用正式版,0.6.2已发布):

JDK 8, Vert.x 3.x

<parent>
    <artifactId>vertx-import</artifactId>
    <groupId>cn.vertxup</groupId>
    <version>0.6.2</version>
</parent>

JDK 11, Vert.x 4.x

<parent>
    <artifactId>vertx-import</artifactId>
    <groupId>cn.vertxup</groupId>
    <version>0.8.1</version>
</parent>

您可以使用最新版,支持JDK 17,0.9.1-SNAPSHOT版本。

特殊说明:写这套教程的过程中,我会验证所有的演示代码,验证过程的BUG以及最新的版本会在BUG表 中公布,不过由于教程先于框架,最终的框架版本以主页的最新版为主,而正文中所有的版本号都是写教程时的版本号。

然后书写主程序:

package cn.vertxup;

import io.vertx.up.VertxApplication;
import io.vertx.up.annotations.Up;

@Up
public class ApolloUp {

    public static void main(final String[] args) {
        VertxApplication.run(ApolloUp.class);
    }
}

启动该程序,您将在控制台看到如下信息,就证明Zero系统成功启动:

[ ZERO ] ( Http Server ) ZeroHttpAgent Http Server has been started successfully. 
         Endpoint: http://198.18.21.28:6083/.

最新版模块

最新版模块以Zero开发中心模块化后的功能表(包含前后端):

3. 教程(Zero)

零之遥(Απόλλων)

Zero Framework

氷る世界(Ψυχρός κόσμος)

Aeon System

䆐之疆(Σύνορα της χώρας)

本章节为快速链接,原文中的快捷方式。

COPYRIGHT IN CHINA

About

New Version


Languages

Language:HTML 89.2%Language:Java 6.9%Language:CSS 2.1%Language:JavaScript 1.5%Language:Shell 0.2%Language:Dockerfile 0.0%Language:Batchfile 0.0%