README.md · yangfan0108/jfast

jfast是javaEE的一款简易mvc框架.

jfast注解介绍:

控制器注解

@Api
其参数为该类对应的请求路径,有该注解的类,在应用启动时,被加载到控制器缓存中.
@DateFormat
如果参数对象中包含日期类型或者参数本身就是日期类型,那么参数前需要有该注解,否则,日期参数将不能正确解析.
@RemoteObject
使用ApiCaller调用的服务可以传递java对象,目标服务方法中的用来接收远程对象的参数需要有@RemoteObject
注解 (这里要注意ApiCaller是服务调用,和浏览器发出的请求是不同的)
@RequireParam
如果参数名和请求传递到后台的名称不同,那么jfast解析该参数时,
取@RequireParam注解指定的参数名,如果其属性required为true,则该参数不可为空.
@Post,
@Get
表示该方法只能接受对应方式的请求,其参数值为方法对应的请求路径,
POST,GET请求可以由浏览器等所有实现http协议的终端发出
@Put,
@Delete,
@Head,
@Options,
@Trace
表示该方法只能接受对应方式的请求,其参数值为方法对应的请求路径,
PUT,DELETE,HEAD,OPTIONS,TRACE请求可以由ApiCaller或者某些http工具发出.
@Copy,
@Connect,
@Lock,
@Unlock,
@Move,
@Mkcol,
@Patch,
@Porpfind,
@Proppatch,
@Search
表示该方法只能接受对应方式的请求,请求可由完整实现http协议的终端发出.
@Transaction
声明该方法需要事务管理

拦截器注解

@Aop
jfast拦截器类需要继承AopHandler类,并且有@Aop注解
全局拦截器: Aop注解属性(scope=AopScope.Global) 代表全局拦截器,在应用启动时,被加载到拦截器缓存中,
方法拦截器: Aop注解属性(scope=AopScope.Method) 代表方法级拦截器(方法拦截器也可以不配置该属性).

DAO类注解

@Dao
Dao类声明注解.
@Select
select语句注解
@Update
update语句注解
@Delete
delete语句注解
@Insert
insert语句注解
@Body
该注解表示,调用该数据接口时,执行该方法的方法体来进行数据操作.否则jfast会解析方法名注解等来执行数据操作

定时任务注解

@ScheduleJob
有该注解的类,在应用启动时,被加载到定时任务缓存中.
@Schedule
其参数:cron有值时,jfast解析cron表达式来执行定时任务,否则按照 delay(延时多少毫秒启动),
repeat(任务执行次数),repeatInterval(重复任务的间隔毫秒数) 的规则执行;
JFast CRON表达式:
"* * * * * *" 代表秒分时日月年,
其中每个参数都可以使用 1或者 1,2,3 或者 5-10 或者 1,2-5,7-8,10等形式

范例:

配置web.xml

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="2.4"
     xmlns="http://java.sun.com/xml/ns/j2ee"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

     <filter>
         <filter-name>JFast</filter-name>
         <filter-class>cn.jfast.framework.web.core.ApiFilter</filter-class>
     </filter>

     <filter-mapping>
        <filter-name>JFast</filter-name>
        <url-pattern>/*</url-pattern>
     </filter-mapping>

     <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
     </welcome-file-list>

</web-app>

jfast配置文件(src根目录下)

<?xml version="1.0" encoding="UTF-8"?>

<context xmlns="http://www.jfast.cn/context"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.jfast.cn/context
                            http://www.jfast.cn/context/jfast-context.xsd">

    <!-- 数据库参数配置 -->
    <jdbc jdbcUser="****"
          jdbcPassword="****"
          jdbcUrl="jdbc:mysql://******:3306/jfast?characterEncoding=utf8"
          jdbcDriver="com.mysql.jdbc.Driver"/>

    <!-- 日志属性配置 -->
    <log isInfoEnable="true"
         isWarnEnable="true"
         isDebugEnable="true"
         isErrorEnable="true"/>
    <web isDevMode="true" characterEncoding="UTF-8"/>

    <!-- 微信公众号配置 -->
    <wx aesKey="******"
        appId="******"
        appSecret="******"
        token="******"
        handler="cn.app.wx.logic.WxApiHandler"/>
    <resources location="/js" mapping="/js"/>
    <resources location="/image" mapping="/image"/>

</context>

创建MVC的M模型层

模型层就是普通的pojo对象,不需要做任何改动.

创建Dao层

package cn.app.wx.dao;

import cn.app.wx.model.User;
import cn.jfast.framework.jdbc.annotation.Body;
import cn.jfast.framework.jdbc.annotation.Dao;
import cn.jfast.framework.jdbc.annotation.Select;
import cn.jfast.framework.jdbc.db.ConnectionFactory;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
java.util.Map;

@Dao
public class UserDao {

  private Connection conn;
  private PreparedStatement ps;
  private ResultSet rs;

  @Body
  public User selectAllFromUserByEmailPassword(String email, String password) throws SQLException, ClassNotFoundException {
     User user = new User();
     conn = ConnectionFactory.getThreadLocalConnection();
     ps = conn.prepareStatement("select * from user where email = ? and password = ?");
     ps.setString(1,email);
     ps.setString(2,password);
     rs = ps.executeQuery();
     if(rs.next()){
        user.setBirthday(rs.getDate("birthday"));
        user.setEmail(rs.getString("email"));
        user.setPassword(rs.getString("password"));
        user.setPhone(rs.getString("phone"));
        user.setSex(rs.getString("sex"));
        user.setUserid(rs.getInt("userid"));
        user.setUsername(rs.getString("username"));
        if(rs.next())
           throw new SQLException("查询目标为一条,但是查出了多条记录.");
     }
     return user;
  }

  public boolean deleteFromUserByEmail(String email){
     return false;
  }

  public int updateUserSetPasswordByEmail(String Email, String password){
     return 1;
  }

  @Select(sql = "select * from user where email = :email")
  public Map<String,Object> select(String email){
     return null;
  }

}

jfast对dao的支持与以往的框架不同:

1. Dao类类名需要加@Dao注解,
2. 如果Dao类类名加@Body注解,那么执行该dao类的方法时,都执行方法体中的内容,比如示例中的第一个方法,执行userDao.selectAllFromUserByEmailPassword(**)时,会使用方法体中的操作;如果没有@Body注解,则jfast会根据方法名以及注解的属性来生成sql
3. 如果方法名上没有@Select,@Update,@Insert,@Delete中的任何一个注解,那么jfast就根据方法名成来生成sql,具体生成规则:
        update表名Set更改字段By依据字段
        deleteFrom表名By依据字段
        select查询字段From表名By依据字段
        insertInto表名Values插入字段

创建MVC中的C控制器层

package cn.app.wx.controller;

import cn.app.wx.dao.UserDao;
import cn.app.wx.model.User;
import cn.jfast.framework.jdbc.annotation.Transaction;
import cn.jfast.framework.web.api.annotation.Api;
import cn.jfast.framework.web.api.annotation.Get;
import cn.jfast.framework.web.api.annotation.Post;
import cn.jfast.framework.web.view.Route;
import cn.jfast.framework.web.view.viewtype.Json;
import cn.jfast.framework.web.view.viewtype.Jsp;

import javax.annotation.Resource;
import javax.servlet.http.HttpServletRequest;
import java.sql.SQLException;

@Api("/jsp")
public class LoginController {

    @Resource
    UserDao userDao;

    @Transaction
    @Post("login")
    public Json login(String email,String password,HttpServletRequest request) throws SQLException, ClassNotFoundException {
        User user = userDao.selectAllFromUserByEmailPassword(email,password);
        if(null != user) {
            request.getSession().setAttribute("user", user);
            return new Json("{login:true}");
        } else {
            return new Json("{login:false}");
        }
    }

    @Post("home")
    @Get("home")
    public Jsp home(HttpServletRequest request){
        if(null != request.getSession().getAttribute("user"))
            return new Jsp("jsp/home", Route.REDIRECT);
        else
            return null;
    }

    @Post("logout")
    public Json logout(HttpServletRequest request){
        request.getSession().removeAttribute("user");
        return new Json("{logout:true}");
    }

}

创建拦截器

package cn.app.wx.interceptor;

import cn.jfast.framework.web.aop.AopHandler;
import cn.jfast.framework.web.aop.AopScope;
import cn.jfast.framework.web.aop.annotation.Aop;
import cn.jfast.framework.web.api.ApiInvocation;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.List;

@Aop(scope = AopScope.Global)
public class LoginStatusInterceptor extends AopHandler {
    @Override
    public void beforeHandle(ApiInvocation apiInvocation, HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, List<Exception> list) throws Exception {
        apiInvocation.invoke();
    }

    @Override
    public void afterHandle(ApiInvocation apiInvocation, HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, List<Exception> list) throws Exception {
        apiInvocation.invoke();
    }
}

yangfan0108 / jfast

简介

发行版

贡献者

近期动态

yangfan0108 / jfast .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

yangfan0108 / jfast