基本概念
Mars-Java 是一个不需要容器的 Java 开发框架,不需要 Tomcat,不需要 JBoss,不需要 Netty,甚至连 Servlet 都不需要。
一个纯基于 JRE 类库开发的 Http 服务,一个不需要容器的 Java 开发框架。
他可以快速的开发出一个后端 Http 服务,支持 MVC,IOC,AOP,数据库操作,声明式事务等常用的特性,并且他更小,更快,更简单。
为什么要用 Mars-Java
当我们需要开发一些中小型网站的时候,如果使用 Java,那么往往会走向两个极端,要么使用非常简单的 JDBC+Servlet,要么使用非常巨大化的 Springboot+Mybatis,那么有没有一个折中的方案呢?当用户量可以预见的不会太多(多见于 B 端应用),又或者仅仅是一个逻辑不复杂的展示型网站,这个时候我们怎么办? 这个时候就可以使用 Mars-Java 了。
它非常的小,不到 Springboot+Mybatis 的一半,它功能齐全,包含了 Springboot 常用的几大功能,并且有自己的持久层封装。同时它也有自己的生态,目前有一个小型的分布式组件 Mars-Cloud 。
几乎可以解决你日常中的所有需求。
MVC 支持的请求方式
目前为止 MVC 支持 GET,POST 两种请求方式,这也是用的最多的两种方式,其他的暂时不支持。
传参方式支持以下三种:
application/x-www-form-urlencoded
multipart/form-data
application/json
数据库操作
一、简单的单表操作
// 根据主键查询一条数据
@MarsGet(tableName = "userinfo",primaryKey = "id")
public abstract `Return type` selectById(int id);
// 插入一条数据
@MarsUpdate(tableName = "userinfo",operType = OperType.INSERT)
public abstract int insert(`Entity object parameter`);
// 根据主键删除一条数
@MarsUpdate(tableName = "userinfo",operType = OperType.DELETE,primaryKey = "id")
public abstract int delete(int id);
// 根据主键修改一条数据
@MarsUpdate(tableName = "userinfo",operType = OperType.UPDATE,primaryKey = "id")
public abstract int update(`Entity object parameter`);
二、简单的分页操作
// 如果你的 sql 语句是固定的,那么只需要这样就可以分页了
@MarsSelect(sql = "select * from userinfo where name = #{name} and age = ${age}", resultType = 要返回的实体类.clss,page = true)
public abstract PageModel selectList(PageParamModel pageParamModel);
// 如果你的 sql 语句不固定,那么就这样
public PageModel findPage(PageParamModel pageParamModel) throws Exception {
String sql = "select * from userinfo where name like #{name}";
return JdbcTemplate.get().selectPageList(sql,pageParamModel,DemoEntity.class);
}
声明式 API
一、 先声明一下
@MarsApi(refBean = "expApiService")
public interface ExpApi {
/**
* get 请求示例
* http://127.0.0.1:8080/expGetRequest?name=张三&names=王五&names=赵六
* @param expVO
* @return
*/
List expGetRequest(ExpVO expVO);
}
二、实现这个接口就好
@MarsBean("expApiService")
public class ExpApiService implements ExpApi {
/**
* 这个方法上加了 aop 监听
* @param expVO
* @return
*/
@Override
@MarsAop(className = ExpAop.class)
public List expGetRequest(ExpVO expVO) {
// 打印接收到的参数,看是否接收成功
System.out.println(expVO.getName());
System.out.println(JSON.toJSONString(expVO.getNames()));
// 返回数据
return getExpResultData();
}
}
对,你们没看错,Controller 层没了,为什么会这样呢?这得从 Controller 的作用说起,在实际开发中,Controller 基本上起到两个作用,一个是参数校验,一个是响应数据。
在 Mars-Java 中,参数校验被封装掉了,直接用注解即可,响应数据,这个本来就没什么,直接返回就好,不需要去 Controller 里再返回一次了。
所以,干脆去掉了,让使用者专注在业务逻辑上。