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 git@git.zhubajie.la:java-web/jello-common.git
运行完成后,工作目录如下所示
workspace
├── jello-common
jello-common 模块为 rake-jello 公共模块,提供了公共组件库,通用头尾,通过页面布局等功能,静态资源 combo 等也是通过模版继承来实现
注意 jello-common
目录名字不能修改
项目开发
开发老项目 (以 jello-zhongbao 为例)
在 workspace 目录下运行 git clone git@git.zhubajie.la:java-web/jello-zhongbao.git
运行完成后,工作目录如下所示
workspace
├── jello-common
├── jello-zhongbao
rap 项目建立
前后端的接口文档,是存放在 rap 网站上的。接口是前后端沟通的桥梁,我们在完成需求分享和模块划分后,就需要和后端一起确定相关功能接口。
接口定好后,可以将接口录入到 rap 系统中。如果没有 RAP 账号,请联系程超
接口录入
请求URL填写,和PHP一样,只是接口描述的位置要把tpl
的模板改为vm
模板,如下:
-
请求类型 :
get|post
-
请求url :
/zhongbao/index
对应page目录下面的vm路径 -
接口描述 :
{ "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 建立好接口后,或者更新接口后,都需要运行 rkj data
下载模拟数据
-
进入 jello-common 目录,运行
rkj release -cw
,发布 jello-common 模块代码。jello-common为公共组件,通常情况不会发生变化,一般情况不需要加上监听参数w,直接使rk release -c
就可以了。 -
进入 jello-zhongbao 目录,运行
rkj release -cw
,发布 fis-zhongbao 模块代码 -
运行
rkj server start
,打开本地测试环境地址,输入 fis-zhongbao 目录下的 server.conf 文件里相应的接口地址即可看到效果
发布后的代码在哪里?运行 rkj server open
即可看到本地的调试服务器目录
如果发生了调试运行的时候发现即使url变了,但渲染的内容依然是旧的,这就是缓存在作怪,可以rkj server open
,手动删除缓存;也可以直接使用rkj server clean
清空目录,然后重新发布一下。
velocity 模板语法
参考语法文档链接
和后端联调
doing