In the previous step, we have deployed service2 to the same server instance and tested both services. In a real production environment, the server instance will be deployed to the cloud with no static IP and port number. All services need to register itself to the registry like Consul to let client discover them. Unlike other frameworks, where all endpoints are in the same server instance, light-hybrid-4j services can share the same instance and each server instance might have different number of services depending how each service is scaled. Read More »

In this Hello World tutorial, we have created a server project and two services projects. You can add more services if you want to extend the tutorial. As all services share the same server instance, the entire application can be considered as a monolithic application. However, each service is developed, tested and deployed independently as a microservice. These services deployed on the same server instance can call each other with the API just like other microservices. Read More »

In the previous step, we have tested the service2 to make sure that it is working for the tests in the development project. In this step, we are going to build the jar file and deploy it to the server instance along with service1. cd ~/networknt/light-example-4j/hybrid/hello-world/service2 ./mvnw install Once the build is done, you should have service2-1.0.0.jar in the target folder. We deploy the service1 by adding it to the classpath when starting the server instance, it works if you have one or two services, but if you have too many services or plan to add more services in the future, it is easier just to copy all services to a folder and put that folder as part of server classpath. Read More »

In the previous step, we have generated service2 project. In this step, we are going to work with the service2 project in the IntelliJ IDEA. Open the service2 project from light-example-4j/hybrid/hello-world/service2 In the src/main, there are two handlers in the com.networknt.hello.handler package. Let’s change the return value to new and old. After the changes, you should have the following two Java classes. CommandOld.java package com.networknt.hello.handler; import com.networknt.utility.NioUtils; import com.networknt.rpc.Handler; import com. Read More »

In the previous step, we have created service2 schema file and config.json file in the model-config repository. In this step, we are going to generate the service2 with light-codegen. For information on how to use light-codegen to scaffold hybrid service project, please visit hybrid service With both schema.json and config.json ready for the service2, let’s run the following commands to scaffold the project. cd ~/networknt java -jar light-codegen/codegen-cli/target/codegen-cli.jar -f light-hybrid-4j-service -o light-example-4j/hybrid/hello-world/service2 -m model-config/hybrid/hello-world/service2/schema. Read More »

In the previous step, we have completed the service1 and deployed it with the server instance. In this step, we are going to create another service and deploy it along with service1. To create service2, we need to create a schema.json and a config.json first. The final version can be found at https://github.com/networknt/model-config/tree/master/hybrid/hello-world/service2 The config.json is almost the same as service1. The only difference is the name of the service and artifactId. Read More »

In the previous step, we have tested the service1 within the IDE. In the current step, we are going to build the service1 and deploy it to the server instance. First, let’s build the service1 from the command line. cd ~/networknt/light-example-4j/hybrid/hello-world/service1 ./mvnw install After the build is done, you should find a jar file named service1-1.0.0.jar in the target folder. -rw-r--r-- 1 steve steve 6223 Apr 4 23:58 service1-1.0.0.jar You can see that the jar file is only 6K in size as there are only two handler classes in the jar. Read More »

In the previous step, we have [generated a service1][] project. In this step, we are going to work with the service1 project in the IntelliJ IDEA. If you don’t have IntelliJ community edition installed, please install it, and it is free. You can use Eclipse as well if it is your preferred IDE. We assume that you are using IntelliJ IDEA for the following steps. Open the service1 project from light-example-4j/hybrid/hello-world/service1 Read More »

In the previous step, we have created service1 schema file in the model-config repository. In this step, we are going to create a config.json file and generate the service1 with light-codegen. The config.json should be very similar to the config.json for the server. You can find it at https://github.com/networknt/model-config/tree/master/hybrid/hello-world/service1 config.json { "rootPackage": "com.networknt.hello", "handlerPackage":"com.networknt.hello.handler", "modelPackage":"com.networknt.hello.model", "artifactId": "hello", "groupId": "com.networknt", "name": "hello", "version": "1.0.0", "overwriteHandler": true, "overwriteHandlerTest": true, "httpPort": 8080, "enableHttp": false, "httpsPort": 8443, "enableHttps": true, "enableHttp2": true, "enableRegistry": false, "supportOracle": false, "supportMysql": false, "supportPostgresql": false, "supportH2ForTest": false, "supportClient": false } For information on how to use light-codegen to scaffold hybrid service project, please visit hybrid service Read More »

In the previous step, we have generated a server. In this section, we are going to create a schema for service1 so that we can use it to scaffold service1 project. Let’s call this service as query, and there are two actions for the service. An action is just like an endpoint in Swagger specification. You can find the schema.json for service1 at https://github.com/networknt/model-config/tree/master/hybrid/hello-world/service1 Here is the schema.json for the service1. Read More »

To generate a hybrid server, we only need a config.json to specify project related parameters as there is no specification for the server. The server itself is just a host for multiple services. The config.json can be accessed at https://github.com/networknt/model-config/tree/master/hybrid/hello-world/server { "rootPackage": "com.networknt.hello", "handlerPackage":"com.networknt.hello.handler", "modelPackage":"com.networknt.hello.model", "artifactId": "hello", "groupId": "com.networknt", "name": "hello", "version": "1.0.0", "overwriteHandler": true, "overwriteHandlerTest": true, "httpPort": 8080, "enableHttp": false, "httpsPort": 8443, "enableHttps": true, "enableHttp2": true, "enableRegistry": false, "supportOracle": false, "supportMysql": false, "supportPostgresql": false, "supportH2ForTest": false, "supportClient": false } As you can see, we want to generate a generic server project without extra dependencies. Read More »

In the previous workspace step, we have cloned related repositories to the networknt workspace in the home directory. In this step, we are going to build the light-codegen so that we can use the command line to scaffold projects. Maven is the build tool for light-codegen, and we have the maven wrapper included in the repository. If you don’t have Maven installed on your local computer, you can use the mvnw or mvnw. Read More »

In this section, we are going to prepare the local environment and workspace for the rest of the tutorial. JDK 11 We are going to use the master branch of each repository for the tutorial, so JDK 11 is required to be installed on your computer. If you have another version of JDK installed already, the SDKMAN is a great tool to allow you to install multiple versions of JDK and switch between them. Read More »