This project is based on Vert.x, the idea came from Spring-Boot framework. It could help developers focus on business requirements instead of more details of Vert.x. The project contains two parts "Up" and "Zero". "Up" means running up, " Zero" means no more workload for high producation, you could run your project with default configuration only.

Micro Service architecture is a future focused method to design and build mature system and help more companies to implement project faster, based on this idea, Zero Framework came out. It's micro-service oriented framework and will be verified by real projects. Also it provide a tool set to help developers to do correct things. Now there are two enterprise application cases those are implemented by Zero, although the number is small, but the cases could verify that Zero can be used in production environment instead of tool, demo or good looks.

This framework contains four sub-projects, all these projects are located under vertx-gaia sub-project.

• vertx-gaia/vertx-co: Core Library of Zero Framework
• vertx-gaia/vertx-tp: Third part integration components in Zero Framework
• vertx-gaia/vertx-ifx：Useful plug-ins that could be supported in Zero Framework with Infix Structure
• vertx-gaia/vertx-up: Zero Up Engine with nested vert.x web container
• vertx-gaia/vertx-rx: Zero Up Engine with nested rxjava web container instead of web container ( Experimental Version for future )
• vertx-import: Zero Usage dependency project to perform development, provide uniform dependency for your projects.

In latest version, examples have been moved to https://github.com/silentbalanceyh/vertx-zero-example The chinese training book is 《Zero思然汀》

If your wan't to study vert.x development skill, you can refer chinese tutorial:《Vert.x逐陆记》. ( In Progress )

In 2019, Zero Framework has been re-factor to new version 0.6.x and here I provide the feature list to let developers know more details in Zero Framework: Feature List.

Extension Module:

• You can refer the link to see documents of Zero Framework: Offical Document
• For all module api documents you can refere Api Document

• You can refer Zero UI to visit front-end framework, it runs 3 production cases ( CN ).
• You can refer Spring Up to visit spring framework bridged component ( Experimental Version ), it runs one production cases ( CN ).
• You can refer Origin X to visit knowledge management of all documents, it act as entry of documentation ( CN ).

If you want to use Zero framework, you can add following dependency into you pom.xml to use Zero:

JDK 8, vert.x 3.9.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>

In your project, you can provide main entry only as following to run Zero ( Annotated with @Up ) .

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

@Up
public class Driver {

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

Once the Zero is up, you can see following logs in your console ( The default port is 6083 ):

[ ZERO ] ZeroHttpAgent Http Server has been started successfully. \
    Endpoint: http://0.0.0.0:6083/

In zero framework, we designed uniform data specification as following response data format for business usage:

{
    "data":
}

After 0.5.2, it could support freedom data format response as you wanted such as:

Hello World
1
...

If you want to switch to freedom mode, you can set the configuration in vertx.yml file:

zero:
    freedom: true     # The default value of `freedom` is false.

You can use following function in your coding to get Logger component instead of log4j because we have re-designed the detail implementation of logging system.

// Zero Logger initialized, connect to vert.x logging system directly but uniform managed by zero.

import io.vertx.up.log.Annal;

// Then in your class
public final class Statute {

    private static final Annal LOGGER = Annal.get(Statute.class);
    ......
}

Because of Contract and Confidentiality Agreement, removed Sensitive information of customer include system name, customer name etc.

• Deprecated: Not Running Now
• In Progress: In Development or Upgraded Development
• Running: Running on Production Environment

• From 0.8.0, if you want to use Zero Extension of Dynamic Modeling, you need the project of https://github.com/silentbalanceyh/vertx-zero/tree/master/vertx-pin/zero-vista. The latest version is 0.8.0-SNAPSHOT, you can modify the version and rebuild it. This feature is not needed in Core Framework.
• Above issue has been fixed in 0.8.1.

You can send request to group leader: 445191171 to contact with the author team of zero.