1. 介绍

轻量级、高性能、简洁优雅的 Web 框架。

基于 Java8 开发，为个人开发者打造的轻量级 MVC 框架， 你只需要创建普通的 Maven 工程即可完成一个简单的应用。

官网地址：https://lets-blade.com/

设计理念：https://lets-blade.com/docs/blade-design.html

2. 快速入门

2.1 创建工程

maven 构建，JDK 1.8 编译。

2.1.1 依赖引入

pom 依赖如下：

  1.     <properties>
  2.         <blade-mvc.version>2.0.9.BETA3</blade-mvc.version>
  3.     </properties>
  5.     <dependencies>
  6.         <!-- mvc dependency -->
  7.         <dependency>
  8.             <groupId>com.bladejava</groupId>
  9.             <artifactId>blade-mvc</artifactId>
  10.             <version>${blade-mvc.version}</version>
  11.         </dependency>
  12.     </dependencies>
  14.     <build>
  15.         <finalName>hello</finalName>
  16.         <plugins>
  17.             <plugin>
  18.                 <artifactId>maven-compiler-plugin</artifactId>
  19.                 <configuration>
  20.                     <source>1.8</source>
  21.                     <target>1.8</target>
  22.                     <encoding>UTF-8</encoding>
  23.                 </configuration>
  24.             </plugin>
  25.         </plugins>
  26.     </build>

2.1.2 运行类编写

  1. package com.example;
  4. import com.blade.Blade;
  6. public class Application {
  7.     public static void main(String[] args) {
  9.         Blade.of().get("/", ctx -> ctx.text("Hello World!")).start(Application.class, args);
  10.     }
  11. }

2.1.3 启动看效果

启动应用后，即可用用浏览器访问：http://127.0.0.1:9000

2.2 创建路由

注册路由两种方式：

  • 使用 Blade 对象硬编码注册
  • 通过控制器来管理多个路由。

编写一个控制器，在你的 Application 所在目录之下，我们最好将它放在 controller 包中，看到名字也就知道是控制器了。

  1. @Path
  2. public class IndexController {
  4.     @GetRoute("/")
  5.     public String index(){
  6.         return "index.html";
  7.     }
  9.     @PostRoute("/save")
  10.     public void saveUser(@Param String username){
  11.         System.out.println("username:" + username);
  12.     }
  14.     @PutRoute("/update")
  15.     public void updateUser(@Param String username){
  16.         System.out.println("username:" + username);
  17.     }
  19.     @DeleteRoute("/delete/:uid")
  20.     public void updateUser(@PathParam Integer uid){
  21.         System.out.println("delete user:" + uid);
  22.     }
  24. }

四种路由中包含：

  • 访问路径
  • 请求方法
  • 具体执行的方法体

Blade 提供了四种请求方式：GET, POST,PUT, DELETE。

2.3 静态文件

2.3.1 默认静态资源

Blade 默认设置了 static、assets、webjars、upload 文件夹皆为静态资源目录。 你也可以自定义设置某个目录，这里我们就使用 static 目录作为存储。

2.3.2 自定义资源目录

  • 通过编码设置：blade.addStatics("/zhuangbi")
  • 通过配置文件：mvc.statics=/zhuangbi

2.3.3 静态资源目录下的列表开启

  • 通过编码设置：blade.showFileList(true)
  • 通过配置文件：mvc.statics.list=true


2.3.4 webjars

静态资源以 jar 方式引入。

2.4 渲染视图

渲染模板的准则：

  • 所有的模板文件都存储在 resources/templates 目录下

你可以调用 Response 方法的 render 方法渲染或者返回一个 String 类型的视图路径。

  1. @GetRoute("/index")
  2. public void renderIndex(Response response){
  3.     response.render("index.html");
  4. }
  6. @GetRoute("/index2")
  7. public String renderIndex(Response response){
  8.     return "index.html";
  9. }