Smart Framework
简介
1. 它是一款轻量级 Java Web 框架
内置 IOC、AOP、ORM、DAO、MVC 等特性
基于 Servlet 3.0 规范
使用 Java 注解取代 XML 配置
2. 它使应用充分做到“前后端分离”
客户端可使用 HTML 或 JSP 作为视图模板
服务端可发布 REST 服务(使用 REST 插件)
客户端通过 AJAX 获取服务端数据并进行界面渲染
3. 它可提高应用程序的开发效率
面向基于 Web 的中小规模的应用程序
新手能在较短时间内入门
核心具有良好的定制性且插件易于扩展
入门
1. 创建一个 Maven Web 工程
整个工程的目录结构如下:
smart-sample/
┗ src/
┗ main/
┗ java/
┗ resources/
┗ webapp/
┗ pom.xml
在 java 目录下,创建以下包名目录结构:
org/
┗ smart4j/
┗ sample/
┗ action/
┗ entity/
┗ service/
可见,基础包名为:org.smart4j.sample,下面的配置中会用到它。
2. 配置 Maven 依赖
编辑 pom.xml 文件,添加 smart-framework 依赖:
org.smart4j
smart-framework
[版本号]
提示:需要指定具体的版本号。若使用相关 Smart 插件,则需分别配置。
3. 编写 Smart 配置
在 resources 目录下,创建一个名为 smart.properties 的文件,内容如下:
smart.framework.app.base_package=org.smart4j.sample
smart.framework.app.home_page=/users
smart.framework.jdbc.driver=com.mysql.jdbc.Driver
smart.framework.jdbc.url=jdbc:mysql://localhost:3306/smart-sample
smart.framework.jdbc.username=root
smart.framework.jdbc.password=root
提示:需根据实际情况修改以上配置。
4. 编写 Entity 类
package org.smart4j.sample.entity;
import org.smart4j.framework.orm.annotation.Entity;
@Entity
public class User {
private long id;
private String username;
private String password;
// getter/setter
}
5. 编写 Service 接口及其实现
Service 接口
package org.smart4j.sample.service;
import java.util.List;
import java.util.Map;
import org.smart4j.sample.entity.User;
public interface UserService {
List findUserList();
User findUser(long id);
boolean saveUser(Map fieldMap);
boolean updateUser(long id, Map fieldMap);
boolean deleteUser(long id);
}
Service 实现
package org.smart4j.sample.service.impl;
import java.util.List;
import java.util.Map;
import org.smart4j.framework.orm.DataSet;
import org.smart4j.framework.tx.annotation.Service;
import org.smart4j.framework.tx.annotation.Transaction;
import org.smart4j.sample.entity.User;
import org.smart4j.sample.service.UserService;
@Service
public class UserServiceImpl implements UserService {
@Override
public List findUserList() {
return DataSet.selectList(User.class);
}
@Override
public User findUser(long id) {
return DataSet.select(User.class, "id = ?", id);
}
@Override
@Transaction
public boolean saveUser(Map fieldMap) {
return DataSet.insert(User.class, fieldMap);
}
@Override
@Transaction
public boolean updateUser(long id, Map fieldMap) {
return DataSet.update(User.class, fieldMap, "id = ?", id);
}
@Override
@Transaction
public boolean deleteUser(long id) {
return DataSet.delete(User.class, "id = ?", id);
}
}
5. 编写 Action 类
package org.smart4j.sample.action;
import java.util.List;
import java.util.Map;
import org.smart4j.framework.ioc.annotation.Inject;
import org.smart4j.framework.mvc.DataContext;
import org.smart4j.framework.mvc.annotation.Action;
import org.smart4j.framework.mvc.annotation.Request;
import org.smart4j.framework.mvc.bean.Params;
import org.smart4j.framework.mvc.bean.Result;
import org.smart4j.framework.mvc.bean.View;
import org.smart4j.sample.entity.User;
import org.smart4j.sample.service.UserService;
@Action
public class UserAction {
@Inject
private UserService userService;
@Request.Get("/users")
public View index() {
List userList = userService.findUserList();
DataContext.Request.put("userList", userList);
return new View("user.jsp");
}
@Request.Get("/user")
public View create() {
return new View("user_create.jsp");
}
@Request.Post("/user")
public Result save(Params params) {
Map fieldMap = params.getFieldMap();
boolean result = userService.saveUser(fieldMap);
return new Result(result);
}
@Request.Get("/user/{id}")
public View edit(long id) {
User user = userService.findUser(id);
DataContext.Request.put("user", user);
return new View("user_edit.jsp");
}
@Request.Put("/user/{id}")
public Result update(long id, Params params) {
Map fieldMap = params.getFieldMap();
boolean result = userService.updateUser(id, fieldMap);
return new Result(result);
}
@Request.Delete("/user/{id}")
public Result delete(long id) {
boolean result = userService.deleteUser(id);
return new Result(result);
}
}
6. 编写视图
在 Action 中使用了 JSP 作为视图展现技术,需要编写以下 JSP 文件:
user.jsp
user_list.jsp
user_create.jsp
user_edit.jsp
提示:更多相关细节,请参考 Smart Sample 示例。
提高
TODO
示例
附录
相关插件
注意:插件依赖于框架,不能独立使用。
相关模块
注意:模块不依赖于框架,可以独立使用。