# blade

**Repository Path**: SmartCloud/blade

## Basic Information

- **Project Name**: blade
- **Description**: blade 是一个简洁强大的web框架，它内置了IOC管理，拦截器配置，REST API开发等众多主流web特性，集成了模板引擎，缓存插件，数据库操作，邮件发送等常用功能
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: http://bladejava.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 171
- **Created**: 2015-07-28
- **Last Updated**: 2024-11-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#Blade

[![简洁强大的JavaWeb框架](http://i1.tietuku.com/0c4b9726253b6268.png "简洁强大的JavaWeb框架")](http://bladejava.com)

[English](https://github.com/biezhi/blade/blob/master/README_EN.md)

[![@biezhi on weibo](https://img.shields.io/badge/weibo-%40biezhi-red.svg)](http://weibo.com/u/5238733773)
[![Hex.pm](https://img.shields.io/hexpm/l/plug.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)
[![Build Status](https://api.travis-ci.org/biezhi/blade.svg?branch=master)](https://travis-ci.org/biezhi/blade)
[![release](https://img.shields.io/maven-central/v/com.bladejava/blade-core.svg)](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.bladejava%22)

**blade** 是一个简洁强大的web框架，它内置了`IOC`管理，拦截器配置，`REST API`开发等众多主流web特性，集成了模板引擎，缓存插件，数据库操作，邮件发送等常用功能，简洁的源码值得你阅读和学习。如果你喜欢，欢迎[Star and Fork](https://github.com/biezhi/blade) ！

## Blade特性

* 简洁的MVC & 拦截器
* REST风格API
* 注解方式 开发
* 微内核IOC容器
* 实用工具类
* 模板引擎支持
* 支持JDK1.6+
* 插件扩展机制
* 缓存数据信息
* 编码/JSON/配置文件
* ...

## 快速入门
第一步、用maven构建一个webapp，加入blade的依赖，推荐获取[最新版本](LAST_VERSION.md)

```xml
<dependency>
	<groupId>com.bladejava</groupId>
	<artifactId>blade-core</artifactId>
	<version>1.2.3</version>
</dependency>
```
	
第二步、在`web.xml`中配置Blade核心过滤器并设置你的初始化类，你也可以不配置(使用jetty启动)
	
```xml
<web-app>
	<display-name>Archetype Created Web Application</display-name>
	<filter>
		<filter-name>BladeFilter</filter-name>
		<filter-class>blade.BladeFilter</filter-class>
		<init-param>
			<param-name>applicationClass</param-name>
			<param-value>blade.sample.App</param-value>
		</init-param>
	</filter>
	
	<filter-mapping>
		<filter-name>BladeFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
	
</web-app>
```

第三步、编写App.java和路由文件，下面是一个示例

```java
public class App extends BladeApplication{

	Logger logger = Logger.getLogger(App.class);
	@Override
	public void init() {
		// 设置路由、拦截器包所在包
		Blade.defaultRoute("blade.sample");
	}
	
}
```

	
```java
@Path("/")
public class Hello {
	
	@Route("hello")
	public String hello() {
		System.out.println("hello");
		return "hello.jsp";
	}
		
	@Route(value = "post", method = HttpMethod.POST)
	public void post(Request request) {
		String name = request.query("name");
		System.out.println("name = " + name);
	}
	
	@Route("users/:name")
	public ModelAndView users(Request request, Response response) {
		System.out.println("users");
		String name = request.pathParam(":name");
		
		ModelAndView modelAndView = new ModelAndView("users");
		modelAndView.add("name", name);
		return modelAndView;
	}

	@Route("index")
	public String index(Request request) {
		request.attribute("name", "jack");
		return "index.jsp";
	}
	
}
```
	
OK，这一切看起来多么的简单，查阅使用指南更多现成的例子供你参考:

+ [API docs](http://bladejava.com/apidocs/)
+ [使用指南](http://bladejava.com/doc/cn/index.html) (完善中...)
+ [一些例子](https://github.com/bladejava)

### 计划
	1. 完善文档
	2. 用`blade`开发单用户博客系统、音乐系统、图片系统等
	3. 优化代码性能
	4. 编写英文文档

## 更新日志

### v1.2.5
	1. 添加JSON、Properties文件配置
	2. 优化代码性能
	3. 去除内置jetty服务
	
### v1.2.2
	1. `DateKit`添加获取当前unix时间戳
	2. 修复`blade-sql2o`分页bug
	3. 修复`blade-beetl`没有存储`ModelAndView`的数据
	
### v1.2
	1. 修复sql2o更新Bug
	2. 去除blade-kit无用类
	3. 添加邮件支持
	4. 添加程序计时支持
	5. 添加http网络请求支持
	6. 优化内置日志输出
	7. 添加定时任务支持
	8. 重构项目结构
		
### v1.1.x
	1. 去除对外公开的多余方法展示
	2. 添加`Blade.run()`方式运行jetty
	3. 添加`Blade.register()`方法注册bean对象
	4. 优化IOC对象管理
	5. 优化底层IO
	6. 简化插件扩展
	7. 拦截器路由匹配分离
	8. 修复jetty在多maven环境下运行bug 
	9. 添加初始化监听context
	10. 优化文件上传
	11. 优化路由匹配
	12. 添加方法执行监测
	13. 添加缓存支持

### v1.0.0
	第一个稳定版本发布

## 开源协议
Blade框架基于 [Apache2 License](http://www.apache.org/licenses/LICENSE-2.0.html)

## 联系我
OSC Blog:[http://my.oschina.net/biezhi](http://my.oschina.net/biezhi)

Mail: biezhi.me#gmail.com

Java交流群: [1013565](http://shang.qq.com/wpa/qunwpa?idkey=932642920a5c0ef5f1ae902723c4f168c58ea63f3cef1139e30d68145d3b5b2f)