简介
Latke('lɑ:tkə,土豆饼)是一个简单易用的 Java Web 应用开发框架,包含 MVC、IoC、事件通知、ORM、插件等组件。
在实体模型上使用 JSON 贯穿前后端,使应用开发更加快捷。这是 Latke 不同于其他框架的地方,比较适合小型应用的快速开发。
特性
- 注解式、函数式路由
- 依赖注入
- 多种数据库 ORM
- 多语言
- 内存/Redis 缓存
- 事件机制
- 插件机制
案例
安装
<dependency>
<groupId>org.b3log</groupId>
<artifactId>latke-core</artifactId>
<version>${latke.version}</version>
</dependency>
控制器层用法
注解声明式路由
@RequestProcessing("/")
public void index(final RequestContext context) {
context.setRenderer(new SimpleFMRenderer("index.ftl"));
final Map<String, Object> dataModel = context.getRenderer().getRenderDataModel();
dataModel.put("greeting", "Hello, Latke!");
}
函数式路由
DispatcherServlet.post("/register", registerProcessor::register);
DispatcherServlet.mapping();
路径变量和查询字符串
@RequestProcessing("/var/{pathVar}")
public void paraPathVar(final RequestContext context) {
final String paraVar = context.param("paraVar");
final String pathVar = context.pathVar("pathVar");
context.renderJSON(new JSONObject().put("paraVar", paraVar).put("pathVar", pathVar));
}
JSON 解析
final JSONObject requestJSON = context.requestJSON();
Servlet 封装
final String remoteAddr = context.remoteAddr();
final String requestURI = context.requestURI();
final Object att = context.attr("name");
final String method = context.method();
context.sendRedirect("https://b3log.org");
final HttpServletRequest request = context.getRequest();
final HttpServletResponse response = context.getResponse();
服务层用法
依赖注入、事务
@Service
public class UserService {
private static final Logger LOGGER = Logger.getLogger(UserService.class);
@Inject
private UserRepository userRepository;
@Transactional
public void saveUser(final String name, final int age) {
final JSONObject user = new JSONObject();
user.put("name", name);
user.put("age", age);
String userId;
try {
userId = userRepository.add(user);
} catch (final RepositoryException e) {
LOGGER.log(Level.ERROR, "Saves user failed", e);
// 抛出异常后框架将回滚事务
throw new IllegalStateException("Saves user failed");
}
LOGGER.log(Level.INFO, "Saves a user successfully [userId={0}]", userId);
}
}
持久层用法
构造 ORM
@Repository
public class UserRepository extends AbstractRepository {
public UserRepository() {
super("user");
}
}
单表 CRUD
public interface Repository {
String add(final JSONObject jsonObject) throws RepositoryException;
void update(final String id, final JSONObject jsonObject) throws RepositoryException;
void remove(final String id) throws RepositoryException;
void remove(final Query query) throws RepositoryException;
JSONObject get(final String id) throws RepositoryException;
long count(final Query query) throws RepositoryException;
}
条件查询
public JSONObject getByName(final String name) throws RepositoryException {
return getFirst(new Query().setFilter(new PropertyFilter("name", FilterOperator.EQUAL, name)));
}
分页查询
new Query().setPage(1, 50)
按字段排序
new Query().addSort("name", SortDirection.DESCENDING);
仅获取需要字段
new Query().select("name", "age");
原生 SQL
final List<JSONObject> records = select("SELECT * FROM `user` WHERE `name` = ?", name);
文档
社区
授权
Latke 使用 Apache License, Version 2.0 开源协议。
鸣谢
- FreeMarker:使用广泛的 Java 模版引擎
- Commons Lang:Java 语言相关工具库
- Commons IO:Java IO 相关工具库
- Commons Codec:Java 编解码库
- Javassist:Java 字节码处理工具库
- SLF4j:Java 日志门户
- Gin:又快又好用的 golang HTTP web 框架