Skip to content

S
Smart Framework

后端镜像 / java镜像 / Smart Framework

通知 0
Star 0
Fork 0
S
Smart Framework

前往新版Gitcode，体验更适合开发者的 AI 搜索 >>

提交 23145c84 编写于 作者: 黄 黄勇
浏览文件
操作

修改 home_page 配置项

上级 24253e85
隐藏空白更改
内联 并排
Showing with 299 addition and 299 deletion
README.md
浏览文件 @ 23145c84
# Smart Framework
## 简介
### 1. 它是一款轻量级 Java Web 框架
- 内置 IOC、AOP、ORM、DAO、MVC 等特性
- 基于 Servlet 3.0 规范
- 使用 Java 注解取代 XML 配置
### 2. 它使应用充分做到“前后端分离”
- 客户端可使用 HTML 或 JSP 作为视图模板
- 服务端可发布 REST 服务
- 客户端通过 AJAX 获取服务端数据并进行界面渲染
### 3. 它可提高应用程序的开发效率
- 面向基于 Web 的中小规模的应用程序
- 新手能在较短时间内入门
- 核心具有良好的定制性且插件易于扩展
![架构](http://i.imgur.com/NrH99Zu.png)
## 入门
### 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` 依赖：
```xml
<dependency>
<groupId>org.smart4j</groupId>
<artifactId>smart-framework</artifactId>
<version>[版本号]</version>
</dependency>
```
> 提示：需要指定具体的版本号。若使用相关 Smart 插件，则需分别配置。
### 3. 编写 Smart 配置
在 `resources` 目录下，创建一个名为 `smart.properties` 的文件，内容如下：
```
smart.framework.app.base_package=org.smart4j.sample
smart.framework.app.home_page=/login
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 类
```java
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 接口
```java
package org.smart4j.sample.service;
import java.util.List;
import java.util.Map;
import org.smart4j.sample.entity.User;
public interface UserService {
List<User> findUserList();
User findUser(long id);
boolean saveUser(Map<String, Object> fieldMap);
boolean updateUser(long id, Map<String, Object> fieldMap);
boolean deleteUser(long id);
}
```
Service 实现
```java
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<User> 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<String, Object> fieldMap) {
return DataSet.insert(User.class, fieldMap);
}
@Override
@Transaction
public boolean updateUser(long id, Map<String, Object> 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 类
```java
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<User> userList = userService.findUserList();
DataContext.Request.put("userList", userList);
return new View("user.jsp");
}
@Request.Post("/users")
public View search(Params params) {
String username = params.getString("username");
List<User> userList = userService.findUserListByUsername(username);
DataContext.Request.put("userList", userList);
return new View("user_list.jsp");
}
@Request.Get("/user")
public View create() {
return new View("user_create.jsp");
}
@Request.Post("/user")
public Result save(Params params) {
Map<String, Object> 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<String, Object> 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 示例。
## 示例
- Smart Sample：http://git.oschina.net/huangyong/smart-sample
- Smart Bootstrap：http://git.oschina.net/huangyong/smart-bootstrap
- Smart REST Server：http://git.oschina.net/huangyong/smart-rest-server
- Smart REST Client：http://git.oschina.net/huangyong/smart-rest-client
## 提高
TODO
## 附录
### 相关插件
> 注意：插件依赖于框架，不能独立使用。
- [smart-plugin-security](http://git.oschina.net/huangyong/smart-plugin-security) -- 提供安全控制功能（封装 [Apache Shiro](http://shiro.apache.org/)）
- [smart-plugin-cache](http://git.oschina.net/huangyong/smart-plugin-cache) -- 提供数据缓存功能
- [smart-plugin-i18n](http://git.oschina.net/huangyong/smart-plugin-i18n) -- 提供国际化功能
- [smart-plugin-mail](http://git.oschina.net/huangyong/smart-plugin-mail) -- 提供发送与接收邮件功能（封装 [Apache Commons Email](http://commons.apache.org/proper/commons-email/)）
- [smart-plugin-template](http://git.oschina.net/huangyong/smart-plugin-template) -- 提供模板引擎功能（封装 [Apache Velocity](http://velocity.apache.org/)）
- [smart-plugin-job](http://git.oschina.net/huangyong/smart-plugin-job) -- 提供作业调度功能（封装 [Quartz](http://www.quartz-scheduler.org/)）
- [smart-plugin-soap](http://git.oschina.net/huangyong/smart-plugin-soap) -- 提供基于 SOAP 的 Web Service 功能（封装 [Apache CXF](http://cxf.apache.org/)）
- [smart-plugin-rest](http://git.oschina.net/huangyong/smart-plugin-rest) -- 提供基于 REST 的 Web Service 功能（封装 [Apache CXF](http://cxf.apache.org/)）
- [smart-plugin-hessian](http://git.oschina.net/huangyong/smart-plugin-hessian) -- 对 [Hessian](http://hessian.caucho.com/) 的封装
- [smart-plugin-xmlrpc](http://git.oschina.net/huangyong/smart-plugin-xmlrpc) -- 提供基于 XML-RPC 的 Web Service 功能（封装 [Apache XML-RPC](http://ws.apache.org/xmlrpc/)）
- [smart-plugin-search](http://git.oschina.net/huangyong/smart-plugin-search) -- 提供全文检索功能（封装 [Apache Lucene](http://lucene.apache.org/)）
- smart-plugin-mybatis -- 对 [MyBatis](http://mybatis.github.io/mybatis-3/) 的封装
### 相关模块
> 注意：模块不依赖于框架，可以独立使用。
- [smart-sso](http://git.oschina.net/huangyong/smart-sso) -- 提供单点登录功能（封装 [Jasig CAS](http://www.jasig.org/cas)）
- [smart-cache](http://git.oschina.net/huangyong/smart-cache) -- 提供缓存通用接口与默认实现（基于内存）
- [smart-cache-ehcache](http://git.oschina.net/huangyong/smart-cache-ehcache)（封装 [EhCache](http://www.ehcache.org/)）
- smart-cache-redis（封装 [Jedis](https://github.com/xetorthio/jedis/)）
### 参考资料
- Smart 系列博文：http://my.oschina.net/huangyong/blog/158380
# Smart Framework
## 简介
### 1. 它是一款轻量级 Java Web 框架
- 内置 IOC、AOP、ORM、DAO、MVC 等特性
- 基于 Servlet 3.0 规范
- 使用 Java 注解取代 XML 配置
### 2. 它使应用充分做到“前后端分离”
- 客户端可使用 HTML 或 JSP 作为视图模板
- 服务端可发布 REST 服务（使用 REST 插件）
- 客户端通过 AJAX 获取服务端数据并进行界面渲染
### 3. 它可提高应用程序的开发效率
- 面向基于 Web 的中小规模的应用程序
- 新手能在较短时间内入门
- 核心具有良好的定制性且插件易于扩展
![架构](http://i.imgur.com/NrH99Zu.png)
## 入门
### 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` 依赖：
```xml
<dependency>
<groupId>org.smart4j</groupId>
<artifactId>smart-framework</artifactId>
<version>[版本号]</version>
</dependency>
```
> 提示：需要指定具体的版本号。若使用相关 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 类
```java
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 接口
```java
package org.smart4j.sample.service;
import java.util.List;
import java.util.Map;
import org.smart4j.sample.entity.User;
public interface UserService {
List<User> findUserList();
User findUser(long id);
boolean saveUser(Map<String, Object> fieldMap);
boolean updateUser(long id, Map<String, Object> fieldMap);
boolean deleteUser(long id);
}
```
Service 实现
```java
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<User> 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<String, Object> fieldMap) {
return DataSet.insert(User.class, fieldMap);
}
@Override
@Transaction
public boolean updateUser(long id, Map<String, Object> 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 类
```java
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<User> userList = userService.findUserList();
DataContext.Request.put("userList", userList);
return new View("user.jsp");
}
@Request.Post("/users")
public View search(Params params) {
String username = params.getString("username");
List<User> userList = userService.findUserListByUsername(username);
DataContext.Request.put("userList", userList);
return new View("user_list.jsp");
}
@Request.Get("/user")
public View create() {
return new View("user_create.jsp");
}
@Request.Post("/user")
public Result save(Params params) {
Map<String, Object> 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<String, Object> 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 示例。
## 示例
- Smart Sample：http://git.oschina.net/huangyong/smart-sample
- Smart Bootstrap：http://git.oschina.net/huangyong/smart-bootstrap
- Smart REST Server：http://git.oschina.net/huangyong/smart-rest-server
- Smart REST Client：http://git.oschina.net/huangyong/smart-rest-client
## 提高
TODO
## 附录
### 相关插件
> 注意：插件依赖于框架，不能独立使用。
- [smart-plugin-security](http://git.oschina.net/huangyong/smart-plugin-security) -- 提供安全控制功能（封装 [Apache Shiro](http://shiro.apache.org/)）
- [smart-plugin-cache](http://git.oschina.net/huangyong/smart-plugin-cache) -- 提供数据缓存功能
- [smart-plugin-i18n](http://git.oschina.net/huangyong/smart-plugin-i18n) -- 提供国际化功能
- [smart-plugin-mail](http://git.oschina.net/huangyong/smart-plugin-mail) -- 提供发送与接收邮件功能（封装 [Apache Commons Email](http://commons.apache.org/proper/commons-email/)）
- [smart-plugin-template](http://git.oschina.net/huangyong/smart-plugin-template) -- 提供模板引擎功能（封装 [Apache Velocity](http://velocity.apache.org/)）
- [smart-plugin-job](http://git.oschina.net/huangyong/smart-plugin-job) -- 提供作业调度功能（封装 [Quartz](http://www.quartz-scheduler.org/)）
- [smart-plugin-soap](http://git.oschina.net/huangyong/smart-plugin-soap) -- 提供基于 SOAP 的 Web Service 功能（封装 [Apache CXF](http://cxf.apache.org/)）
- [smart-plugin-rest](http://git.oschina.net/huangyong/smart-plugin-rest) -- 提供基于 REST 的 Web Service 功能（封装 [Apache CXF](http://cxf.apache.org/)）
- [smart-plugin-hessian](http://git.oschina.net/huangyong/smart-plugin-hessian) -- 对 [Hessian](http://hessian.caucho.com/) 的封装
- [smart-plugin-xmlrpc](http://git.oschina.net/huangyong/smart-plugin-xmlrpc) -- 提供基于 XML-RPC 的 Web Service 功能（封装 [Apache XML-RPC](http://ws.apache.org/xmlrpc/)）
- [smart-plugin-search](http://git.oschina.net/huangyong/smart-plugin-search) -- 提供全文检索功能（封装 [Apache Lucene](http://lucene.apache.org/)）
- smart-plugin-mybatis -- 对 [MyBatis](http://mybatis.github.io/mybatis-3/) 的封装
### 相关模块
> 注意：模块不依赖于框架，可以独立使用。
- [smart-sso](http://git.oschina.net/huangyong/smart-sso) -- 提供单点登录功能（封装 [Jasig CAS](http://www.jasig.org/cas)）
- [smart-cache](http://git.oschina.net/huangyong/smart-cache) -- 提供缓存通用接口与默认实现（基于内存）
- [smart-cache-ehcache](http://git.oschina.net/huangyong/smart-cache-ehcache)（封装 [EhCache](http://www.ehcache.org/)）
- smart-cache-redis（封装 [Jedis](https://github.com/xetorthio/jedis/)）
### 参考资料
- Smart 系列博文：http://my.oschina.net/huangyong/blog/158380
- Maven 那点事儿：http://my.oschina.net/huangyong/blog/194583
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或