rake-jello

基于 fis3 针对 jsp/velocity 模板的前端工程解决方案。

使用说明

安装 rake-jello

npm install -g rake-jello

输入rkj -v 输出fis的标识，说明安装成功

编译产出

rkj release

启动调试服务。

rkj server start

获取rap mock数据

rkj data

rake-jello 开发流程

首先确保已经安装成功

进入工作目录，假设为 /workspace

所有的 rake-jello 项目都应该放在此根目录下

在当前目录运行 git clone [email protected]:java-web/jello-common.git

运行完成后，工作目录如下所示

workspace
    ├── jello-common 

jello-common 模块为 rake-jello 公共模块，提供了公共组件库，通用头尾，通过页面布局等功能，静态资源 combo 等也是通过模版继承来实现

注意 jello-common 目录名字不能修改

项目开发

开发老项目 （以 jello-zhongbao 为例）

在 workspace 目录下运行 git clone [email protected]:java-web/jello-zhongbao.git

运行完成后，工作目录如下所示

workspace
    ├── jello-common
    ├── jello-zhongbao         

rap 项目建立

前后端的接口文档，是存放在 rap 网站上的。接口是前后端沟通的桥梁，我们在完成需求分享和模块划分后，就需要和后端一起确定相关功能接口。

接口定好后，可以将接口录入到 rap 系统中。如果没有 RAP 账号，请联系程超

接口录入

请求URL填写，和PHP一样，只是接口描述的位置要把tpl的模板改为vm模板，如下：

1. 请求类型 ： get|post

2. 请求url ： /zhongbao/index 对应page目录下面的vm路径

3. 接口描述 ： { "render": "vm", "path": "zhongbao/index.vm" }

接口数据录入后，即可通过 rkj data 命令一键下载测试数据到本地。方便本地开发和调试

每次 RAP 系统接口有更新后，都需要运行 rkj data 获取最新的测试数据

使用rkj data后会新生成测试数据test（里面的数据和page下的模板是同名依赖关系）和路由文件server.conf，注意先在fis-config.js里面确定好rapId与namespace，rapId与RAP上建立的项目id保持一致，不然拉不下来数据。

RAP 使用说明

本地查看开发效果

在 rap 建立好接口后，或者更新接口后，都需要运行 rkj data 下载模拟数据

1. 进入 jello-common 目录，运行 rkj release -cw，发布 jello-common 模块代码。jello-common为公共组件，通常情况不会发生变化，一般情况不需要加上监听参数w，直接使rk release -c就可以了。

2. 进入 jello-zhongbao 目录，运行 rkj release -cw，发布 fis-zhongbao 模块代码

3. 运行 rkj server start，打开本地测试环境地址，输入 fis-zhongbao 目录下的 server.conf 文件里相应的接口地址即可看到效果

查看更详细的命令介绍

发布后的代码在哪里？运行 rkj server open 即可看到本地的调试服务器目录

如果发生了调试运行的时候发现即使url变了，但渲染的内容依然是旧的，这就是缓存在作怪，可以rkj server open，手动删除缓存；也可以直接使用rkj server clean清空目录，然后重新发布一下。

velocity 模板语法

参考语法文档链接

和后端联调

doing