小程序服务画代码动作手册
此手册主要介绍在后端服务中关于请求的处理逻辑设计(画代码)操作中各个动作的作用,主要介绍数据操作以及其它不易理解的动作含义.
数据操作:
- 删除全部数据:
- 说明:删除当前目标数据集中的所有数据.
- 设置相关:
- 目标对象:选择删除哪个目标数据集.
- 方法说明:删除全部,一条sql,userRepository.deleteAllInBatch().
- 删除行对象集合:
- 说明:根据传入的数据对象列表(需要删除的数据的主键ID)形成的集合删除多条数据.
- 设置相关:
- 数据对象列表 需要删除的数据主键ID形成的集合
- 方法说明:
- 删除集合,一条sql,拼接or语句 如 id=1 or id=2 ,userRepository.deleteInBatch(LIST) .
- 实例:
- 第一个动作在数据维护中新增一个方法进行数据查询动作进行数据查找需要删除的数据,此时返回一个由删除数据主键ID形成的集合List.,然后声明一个变量等于返回值.
- 第二个动作选中删除对象集合,在数据对象列表中选中上步得到的集合(存在上下文变量中)就可以了.
- 根据ID删除行对象:
- 说明:根据传入的数据对象(就是想删除数据的ID参数)删除那一条数据.
- 设置相关:
- 数据对象 传入的数据主键ID
- 方法说明:删除单条,根据主键值, userRepository.delete(id)
- 返回总记录数:
- 说明:此动作用来获取当前目标数据集中包含多少条数据,并返回数据个数.
- 设置相关:
- 选择想返回数据个数的目标数据集.
- 返回值:
- {Integer} 整数
- 方法说明:
- 计数方法,userRepository.count().
- 根据ID列表查询:
- 说明:根据传入的主键ID列表形成的集合进行数据查询并返回包含查询到的多条数据的数据集.
- 设置相关:
- ID列表
- 方法说明:单表查询,userRepository.findAll().
- 根据ID进行查询:
- 说明:根据接收的ID进行单条数据查询,并返回数据集中包含这条数据.
- 设置相关:
- 数据对象 想要查询的数据ID.
- 方法说明:
- userRepository.findOne(参数id).
- 保存数据:
- 说明:新增操作时,对一个数据对象进行赋值修改等操作后,调用此动作后进行保存并更新.
- 设置相关:
- 数据对象 想要保存的数据对象
- 方法说明:
- userRepository.saveAndFlush(数据对象).
更新:
说明:请在调用保存方法save()后调用该方法,目的是刷新缓存区数据,数据commit提交到数据库.
设置相关:
- 无
方法说明:
- userRepository.flush()
根据ID判断行对象是否存在:
- 说明:根据接收的主键ID在数据中进行查询,判断当前主键ID所在行对象是否存在.
- 设置相关:
- 数据对象: 要传入的数据主键ID
- 返回值:
- {Boolean} 布尔值
方法说明:
userRepository.exists(参数ID)
保存行对象集合:
- 说明:进行批量插入新增时,调用此动作进行保存多个数据完成当前数据集的保存.
- 设置相关:
- 数据的对象列表
- 方法说明:
- userRepository.save(数据对象集合List).
工具类中不易理解的动作:
sha1加密(字符串):
说明:SHA-1是一种数据加密算法,该算法的思想是接收一段明文,然后以一种不可逆的方式将它转换成一段(通常更小)密文,也可以简单的理解为取一串输入码(称为预映射或信息),并把它们转化为长度较短、位数固定的输出序列即散列的过程。
设置相关:
需要加密的字符串, {String}
使用返回值,新建一个变量并定义一个变量名称.
使用场景:
- 主要用于文件身份识别、数字签名和口令加密等.
实例:
- (“abc”)=》 03cfd743661f07975fa2f1220c5194cbaff48451.
是否包含(集合,元素):
说明:此动作用于判断一个元素是否存在于一个集合中.
设置相关:
集合 {List<Any>} list
元素 {Any} element 元素
返回值:
- {Boolean} 布尔值.
实例:
(["a","b","c"], "c") =》 true.
(["a","b","c"], "d") =》 false.
替换(字符串,字符,替换字符):
说明:此动作可以将接收的字符串中包含的某些字符替换成需要替换的字符并返回这个新的字符串,但只替换第一次出现查找到的字符.
设置相关:
{String} seq 字符串
{String} searchString 被查找替换字符
{String} replacement 替换字符
返回值:
- {String}
实例:
(“abcde”,"bc","ff") =》 “affde”.
(“abcded”,"d","m") =》"abcmed"
替换所有(字符串,字符,替换字符):
说明:此动作可以将接收的字符串中包含的某些字符替换成需要替换的字符并返回这个新的字符串,替换这个字符串中所有出现的被替换的字符.
设置相关:
{String} seq 字符串
{String} searchString 被查找替换字符
{String} replacement 替换字符
返回值:
- {String}
实例:
(“abcdebbb”,"b","L")=》 "aLcdeLLL" .
("abcdbcdbcbb","bc","qq") =》 "aqqdqqdqqbb" .
辅助动作:
- 调用原生函数:
- 当您想使用自定义封装的服务函数方法或者JAVA中提供的基础方法时,可以通过此动作选取您自定义封装的方法来达到需求的结果.
- 设置相关参数:
- 方法全名
- 说明: 方法全名由包名+ 类名+方法名/函数名组成 package.class.function.
- 参数1,参数2,参数3
- 说明:参数可根据当前方法需求的参数类型和个数依次对应传入.
- 方法全名
- 使用不同自定义服务函数方法时 方法全名 的定义场景:
- 使用java提供的基础方法时,直接在 方法全名 中写入就可以.
- 例如:方法全名 "java.lang.Math.abs " .
- 使用自定义新建JAVA文件时,在 方法全名 中需要按照包名+类名+方法名的结构写入.
- 注意: java包必须写在 service/main/src/main/java/main/service 目录下 .
- 例如: 方法全名 “com.jonatan.pojos.UserXmlForm.getUserList” .
- 使用java提供的基础方法时,直接在 方法全名 中写入就可以.
- 使用实例说明:
- 直接使用java提供的函数方法时:
- 步骤一:在画代码中使用调用原生函数的动作,写入方法全名以及所需参数.
- 步骤二:测试请求结果,看是否调用成功.
- 步骤一:在画代码中使用调用原生函数的动作,写入方法全名以及所需参数.
- 使用自己新建JAVA文件中的静态函数方法时:
- 步骤一:点击IDE后进入,在service/main/src/main目录下创建一个自定义java文件来封装自己想定义的静态方法.
- 步骤二:在服务画代码中调用原生函数方法并进行方法全名以及参数的设置:
- 步骤三:测试请求以及调用自定义的静态方法是否成功:
- 步骤一:点击IDE后进入,在service/main/src/main目录下创建一个自定义java文件来封装自己想定义的静态方法.
- 直接使用java提供的函数方法时: