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 defense
  • 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
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 nor 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
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

DataTable-Pagination example with Spring boot, jQuery and ajax

10 Best Job Posting Sites 2021-2022

Spring boot web project free download:User Registration System

Spring Boot + JPA/Hibernate One to Many mapping example

5 Hardest Puzzle,100% fail answers

Java security AES,SHA256,SHA512,MD5-Spring Boot Project Free Download

Spring Boot-AngularJS-Bootstrap-JPA-CRUD

ReactJS - Bootstrap - Buttons

Spring Boot file upload/download example