Blade - Java Web Framework -Guide

Welcome to the new generation MVC framework(Web)
The Blade is based on Java8 + Netty4 to create a lightweight, high-performance, simple, and elegant Web framework. Blade Framework is based on the Apache2 License.


  • A new generation MVC framework that doesn't depend on other libraries
  • Get rid of SSH's bloated, modular design
  • The source is less than 500kb, learning it is also simple
  • RESTful-style routing design
  • Template engine support, view development more flexible
  • High performance, 100 concurrent qps 20w/s
  • Run the JAR package to open the web service
  • Streams-style API
  • CSRF and XSS defence
  • Basic Auth and Authorization
  • Supports plug-in extensions
  • Support web jars resources
  • Tasks based on cron expressions
  • Built-in a variety of commonly used middleware
  • Built-in JSON output
  • JDK8 +


  • Simplicity: The design is simple, easy to understand, and doesn't introduce many layers between you and the standard library. The goal of this project is that the users should be able to understand the whole framework in a single day.
  • Elegance: blade supports the RESTful style routing interface, has no invasive interceptors, and provides the writing of a DSL grammar.
  • Easy deploy: supports maven package jar file running.

Getting Started

Create a basic Maven or Gradle project.



compile 'com.bladejava:blade-mvc:2.0.14.RELEASE'

Running a Blade Application

The blade is based upon Netty, an amazing asynchronous event-driven network application framework. Therefore, to run our Blade-based application we don't need any external Application Server or Servlet Container; the JRE will be enough

Write the main method and the Hello World:
public static void main(String[] args) {
    Blade.of().get("/", ctx -> ctx.text("Hello World")).start();
After that, the application will be accessible at the http://localhost:9000 URL.

Register Route By annotation

First of all, we need to create a Controller through the @Path annotation, which will be scanned by Blade during the startup.

We then need to use the route annotation related to the HTTP method we want to intercept:

public class IndexController {
    public String signin(){
        return "signin.html";
    public RestResponse doSignin(RouteContext ctx){
        // do something
        return RestResponse.ok();

Get Form Parameters By annotation

public void savePerson(@Param String username, @Param Integer age){
    System.out.println("username is:" + username + ", age is:" + age)

Get Path Parameters By annotation

public void savePerson(@Param String username, @Param Integer age){
    System.out.println("username is:" + username + ", age is:" + age)

Get Header By Annotation

public void getHeader(@HeaderParam String Host){
    System.out.println("Host => " + Host);

Get Cookie By Annotation

public void getCookie(@CookieParam String UID){
    System.out.println("Cookie UID => " + UID);

Upload File By Annotation

public void upload(@MultipartParam FileItem fileItem){
    // Save to new path
    fileItem.moveTo(new File(fileItem.getFileName()));

Render JSON By annotation

public User printJSON(){
    return new User("biezhi", 18);

Custom Exception Handler

The blade has an exception handler already implemented by default; if you need to deal with custom exceptions, you can do it like follows.
public class GlobalExceptionHandler extends DefaultExceptionHandler {
    public void handle(Exception e) {
        if (e instanceof CustomException) {
            CustomException customException = (CustomException) e;
            String code = customException.getCode();
            // do something
        } else {

Change Server Port

There are three ways to modify the port: hard coding it, in a configuration file, and through a command-line parameter.
Hard Coding

Configuration For

Command Line
java -jar blade-app.jar --server.port=9001

For more details Visit Official Documentation

Popular posts from this blog

Spring boot video streaming example-HTML5

Learn Java 8 streams with an example - print odd/even numbers from Array and List

Spring Boot + Mockito simple application with 100% code coverage

Spring Boot + OpenCSV Export Data to CSV Example

Custom Exception Handling in Quarkus REST API

DataTable-Pagination example with Spring boot, jQuery and ajax

Registration and Login with Spring Boot + Spring Security + Thymeleaf

Node JS mini projects with source code - free download

Spring boot web project free download:User Registration System

Spring Boot + Apache Commons Export Data to CSV Example