资讯专栏INFORMATION COLUMN

让ERP的服务更开放! ——用微服务架构搭建的一套基于EBS的API服务系统

JouyPub / 2707人阅读

摘要:每个服务运行在其独立的进程中,服务与服务间采用轻量级的通信机制互相沟通通常是基于的。在微服务架构下,故障会被隔离在单个服务中。

1. 源码下载地址

源码链接: https://github.com/samt007/xy...

这是用Spring Cloud微服务架构搭建的一套基于EBS的API服务系统

如对本文有任何的疑问,请联系我:samt007@qq.com

2. Introduction介绍

这是一篇传统ERP系统和基于Java的微服务架构有效结合的技术文档。

传统ERP关注的是企业内部的信息化管理。当ERP系统能将其服务发布出去之后(结合微服务架构),就可以很好实现与第三方系统的无缝对接,同时也可以实现扩展ERP本身的功能。
目标是:让ERP的服务更开放!
2.1 它有什么用?

简单来说,就是:

相当于做一个中间服务平台,把ERP的功能做成Web Service与其它系统集成。

下面具体说明它的作用。

1. 如果没有它...

如果没有一个统一的API对接平台,那么ERP和第三方系统做对接,那会是下图所示的结构:

从上图可以看出,各个第三方系统分别和ERP做对接,无论是DBLINK还是通过自己的Web Service, 都是杂乱的,没能统一管理的。简单来说就是各自为政,为对接而需要做的事情都是零碎的。

当第三方系统越来越多的时候,那对于日常的运维将会是一个灾难的问题。举个例子,就一个简单的运维:密码修改,需要调整的地方就会很多,也很容易遗漏。

特别指出的是,接口功能的复用方面也是个难题。假设一个查询库存的接口,CRM系统和在线下单系统都可以用的,需要开发2次。

2. 自从有了它...

有了这套统一的API系统之后,ERP系统和别的系统之间的对接就变成了这个结构:

所以,有了它,相当于ERP的API都可以通过这服务平台给开发出去,基本上所有的接口可以完成的业务,都可以通过这套服务平台来完成。

可以实现:

对外服务的统一

API服务之间可以实现互相调用,并且实现服务取数和处理的逻辑的统一

代码的统一,提高开发效率。特别是comm代码的部分。

提高与第三方系统对接的稳定性:只需要关注该微服务系统的运行稳定性即可。

3. 有哪些实例?

举个例子:

1) 成品进出条码管理系统:

大概这个需求:
成品入库的时候,直接可以用条码枪扫条码或者二维码就可以入库;销售出库的时候,也可以通过刷成品的条码直接进行出库。JIT管理。

通过这个系统的实现逻辑是:
通过EBS的用户名和密码可以登入条码枪上的APP系统。然后,刷条码的时候,通过该Web Service可以产生对应的事务处理!例如完工入库,处理物料搬运单等。

下面是该系统的一些截图

注意:该功能后台API由该微服务提供,前台是安卓的APP

2) 与各个第三方系统的集成:

每个企业内部都有各种第三方系统,这些系统或多或少都需要和EBS进行集成。传统的集成方法是通过DBLINK。

但是有这套Web Service系统之后,就可以统一通过该Web Service作为中介,和EBS进行数据的集成交互!

2.2 什么是微服务?

关于它的解析,网上资料很多。
这里引用某位大神的总结(引用:http://blog.51cto.com/ityoukn...),解析得比较到位:

微服务的概念源于2014年3月Martin Fowler所写的一篇文章“Microservices”。

微服务架构是一种架构模式,它提倡将单一应用程序划分成一组小的服务,服务之间互相协调、互相配合,为用户提供最终价值。每个服务运行在其独立的进程中,服务与服务间采用轻量级的通信机制互相沟通(通常是基于HTTP的RESTful
API)。每个服务都围绕着具体业务进行构建,并且能够被独立地部署到生产环境、类生产环境等。另外,应尽量避免统一的、集中式的服务管理机制,对具体的一个服务而言,应根据业务上下文,选择合适的语言、工具对其进行构建。

微服务是一种架构风格,一个大型复杂软件应用由一个或多个微服务组成。系统中的各个微服务可被独立部署,各个微服务之间是松耦合的。每个微服务仅关注于完成一件任务并很好地完成该任务。在所有情况下,每个任务代表着一个小的业务能力。

微服务架构优势

复杂度可控:在将应用分解的同时,规避了原本复杂度无止境的积累。每一个微服务专注于单一功能,并通过定义良好的接口清晰表述服务边界。由于体积小、复杂度低,每个微服务可由一个小规模开发团队完全掌控,易于保持高可维护性和开发效率。

独立部署:由于微服务具备独立的运行进程,所以每个微服务也可以独立部署。当某个微服务发生变更时无需编译、部署整个应用。由微服务组成的应用相当于具备一系列可并行的发布流程,使得发布更加高效,同时降低对生产环境所造成的风险,最终缩短应用交付周期。

技术选型灵活:微服务架构下,技术选型是去中心化的。每个团队可以根据自身服务的需求和行业发展的现状,自由选择最适合的技术栈。由于每个微服务相对简单,故需要对技术栈进行升级时所面临的风险就较低,甚至完全重构一个微服务也是可行的。

容错:当某一组建发生故障时,在单一进程的传统架构下,故障很有可能在进程内扩散,形成应用全局性的不可用。在微服务架构下,故障会被隔离在单个服务中。若设计良好,其他服务可通过重试、平稳退化等机制实现应用层面的容错。

扩展:单块架构应用也可以实现横向扩展,就是将整个应用完整的复制到不同的节点。当应用的不同组件在扩展需求上存在差异时,微服务架构便体现出其灵活性,因为每个服务可以根据实际需求独立进行扩展。

2.3 ERP API微服务系统架构说明 2.3.1 系统开发逻辑说明

从上面的解析得知:微服务是一种技术架构,将一个庞大的服务体系拆分为若干个子服务执行。
问题来了,应该如何拆分呢?就是服务的拆分原则是什么。

这个问题就像是一个大表如何进行分区一样,其实我觉得是具体问题具体分析。
由于我开发的是基于EBS的微服务系统,正常来说,比较合理的划分规则应该是以EBS的模块来分。

相当于每个模块都划分为一个多带带的微服务。例如FND模块,INV模块,WIP模块等等。

有时候,为了某个目的,可能有些功能是定制的,需要提取几个模块的数据来用,而且被别的模块重用的概率很低。所以,实际上也可以以定制的功能来划分微服务。

目前来说,该系统包括2个子服务:

xygerp-ald服务:ald模块

这个是整个微服务API的核心ald模块。这个模块的主要功能是验证用户的登录,为所有的api模块提供统一的token认证。相当于ebs的FND模块。

xygerp-albc服务:albc子模块

这个项目是属于微服务的API模块之一:条码管理系统提供数据以及数据处理的API。
主要是为条形码传输系统用。

当然,未来可以添加若干个服务。微服务架构的优势是有很好的横向扩展能力!

2.3.2 微服务系统架构图

该系统的架构图如下所示。

注意:

1.Spring Cloud模块中,实际上Spring Security并不是多带带的一个模块,而是融入到每一个业务微服务模块中! 每个微服务都必须要有token认证才允许访问API,它非常重要! 所以我将它给列到Spring Cloud模块中。

2.图中有些模块目前还没有实现。
目前实现了架构整体,包括以下的服务(下一个章节会具体说明每个模块的用途):

xygerp-ald

xygerp-albc

xygerp-server-eureka

xygerp-server-zuul

注意: 以后会按需添加别的模块。
3 系统开发流程

接下来是一步一步来开发一套这个基于Spring Cloud的微服务系统。

3.1 必须掌握的基础开发技术知识点

开发系统都必须要打好基础。所以,这里列出了开发基于Spring Cloud的微服务系统需要掌握的开发技术。

下面我不会具体解说每一个开发技术如何学习,因为这并不是本文的重点。工欲善其事必先利其器,基础还是必须要打好。
1)Java语言

必须要熟悉java,否则基本不用看文档了。先打好基础吧!

2)Maven项目管理工具

系统开发的项目都是以maven做项目管理的,所以必须要先安装并掌握maven工具。

3)Oracle数据库+PLSQL+SQL语言

数据库端的开发技术。这里选用Oracle数据库,因为EBS就是基于Oracle数据库的ERP系统。

3.2 需要熟悉的java框架

Java技术发展到现在,已经出现了许多非常优秀的开源框架,我们可以借助这些框架来快速开发系统。

3.2.1 Spring框架技术栈(全家桶)

Spring是目前开源的主流的技术包。
该系统主要用到的技术栈是:Spring boot,Spring Security以及Spring Cloud。

1.Spring Boot

系统基于SpringBoot快速开发。选择目前热度很高的SpringBoot,最大限度地降低配置复杂度,把大量的精力投入到业务开发中来。

2.Spring MVC

利用Spring MVC框架处理所有的url请求,简单易用。

3.Spring Security

Spring security是一个强大的和高度可定制的身份验证和访问控制框架。它是确保基于Spring的应用程序的标准。
这里主要是用Spring Security框架处理Token机制。

4.Spring Cloud

Spring Cloud是一系列框架的有序集合。
它利用Spring Boot的开发便利性巧妙地简化了分布式系统基础设施的开发,如服务发现注册、配置中心、消息总线、负载均衡、断路器、数据监控等,都可以用Spring Boot的开发风格做到一键启动和部署。
注意:本系统目前使用Spring Cloud的2个模块

请求统一通过API网关(Zuul)来访问内部服务.

网关接收到请求后,从注册中心(Eureka)获取可用服务

3.2.2 MyBatis

ORM框架选用MyBatis。

主要是考虑到它能够很好支持SQL语句:MyBatis是支持普通SQL查询,存储过程和高级映射的优秀持久层框架。
另外,还用到了MyBatis的一些提高开发效率的插件,特别是通用Mapper和PageHelper分页插件!

3.2.3 Alibaba druid

DRUID是阿里巴巴开源平台上一个数据库连接池实现。它结合了C3P0、DBCP、PROXOOL等DB池的优点,同时加入了日志监控,可以很好的监控DB池连接和SQL的执行情况。

3.2.4 Swagger

前端和后端的唯一联系,变成了API接口。

API文档变成了前后端开发人员联系的纽带,变得越来越重要,swagger就是一款让你更好的书写API文档的框架。

3.3 需要准备的软件工具 3.3.1Redis

目前用Redis的主要作用是存取token,以配合实现Spring Security完成api访问的安全机制。

以后可以考虑做缓存或者消息队列等高级功能。
3.3.2Docker

基于Docker的容器化部署。

由于使用了微服务架构后,我们的系统将会由很多子系统构成。
为了达到多个系统之间环境隔离的目的,我们可以将它们部署在多台服务器上,可这样的成本会比较高,而且每台服务器的性能可能都没有充分利用起来。

所以我们很自然地想到了虚拟机,在同一台服务器上运行多个虚拟机,从而实现环境的隔离,每个虚拟机上运行独立的服务。

然而虚拟机的隔离成本依旧很高,因为它需要占用服务器较多的硬件资源和软件资源。
所以,在微服务结构下,要实现服务环境的隔离,Docker是最佳选择。它比虚拟机更加轻量级,占用资源较少,而且能够实现快速部署。

备注:后面有专题说明这个工具如何安装使用。由于篇幅原因,本文档暂时不讲解容器化部署。
3.3.3 Jenkins

Jenkins自动化构建工具。

当我们采用了微服务架构后,我们会发现这样一个问题。整个系统由许许多多的服务构成,这些服务都需要运行在多带带的容器中,那么每次发布的复杂度将非常高。

首先你要搞清楚这些服务之间的依赖关系、启动的先后顺序,然后再将多个子系统挨个编译、打包、发布。这些操作技术难度低,却又容易出错。

那么有什么工具能够帮助我们解决这些问题呢?答案就是——Jenkins。

它是一款自动化构建的工具,简单的来说,就是我们只需要在它的界面上按一个按钮,就可以实现上述一系列复杂的过程。

备注:后面有专题说明这个工具如何安装使用。由于篇幅原因,本文档暂时不讲解自动化构建。
3.4 具体开发流程

现在开始手把手来搭建一套这样子的系统。

3.4.1 创建Maven项目的组织结构

先创建一个微服务系统的父级项目:xygerp-api

再在这个项目下面分别创建下面几个子项目:

项目名称 说明
xygerp-ald ald模块,端口:8180。这个是整个微服务API的核心ald模块。这个模块的主要功能是验证用户的登录,为所有的api模块提供统一的token认证。相当于ebs的FND模块。
xygerp-albc albc子模块,端口:8181。这个项目是属于微服务的API模块之一:条码管理系统提供数据以及数据处理的API。主要是为条形码传输系统用。
xygerp-comm comm模块这个项目是所有API项目的核心依赖项目。说白了就是将API微服务架构的所有项目的公用代码可以抽取在这里。
xygerp-basic-support 核心基础支撑模块这个项目是所有API项目的基础数据支撑项目。这里统一归集了所有的Entity!因为对于Entity来说,应该是整个微服务都公用的。
xygerp-server-eureka Spring Cloud的服务与发现的服务中心。端口:8101。这个模块是Spring cloud的最核心的模块了,用来处理各个微服务之间的服务调用的。
xygerp-server-zuul Spring Cloud服务网关。端口:8102。在Spring Cloud架构体系内的所有微服务都通过Zuul来对外提供统一的访问入口,所有需要和微服务架构内部服务进行通讯的请求都走统一网关。
它们的目录结果是这样子的:

注意:
关于xygerp-basic-support:核心基础支撑模块

可能您会有疑问:为什么不将entity归并在它所属的模块?其实是这样的,我主要是考虑到服务之间的互相调用的问题。

微服务虽然客观上是一个多带带的服务,但是,实际上大部分的功能肯定是互相调用的。举个例子,销售订单模块调用库存模块的功能查询个库存是很正常的业务吧?

如果entity不共用的话,相当于销售模块得到的库存模块的结果无法归集为bean来处理,这样子对于后台的处理会带来极大的不便!

3.4.2 构建模块的依赖关系

接着需要通过pom文件来指定它们之间的依赖关系,依赖关系如下图所示。

1. 业务服务部分:


注意,上面的4个项目是有依赖关系的。
所以,xygerp-ald和xygerp-albc部署方式 改为war部署 (主要是为了利用jenkins进行自动化部署)。

而xygerp-comm和xygerp-basic-support只是为各个微服务提供基础代码支撑,所以是jar部署即可。

此外,为了简化各个模块的配置,我们将所有模块的通用依赖放在Project的pom文件中,然后让所有模块作为Project的子模块。
这样子模块就可以从父模块中继承所有的依赖,而不需要自己再配置了。

在父pom中指定子模块

modules标签指定了当前模块的子模块是谁,但是仅在父模块的pom文件中指定子模块还不够,还需要在子模块的pom文件中指定父模块是谁。

    
        xygerp-comm          
        xygerp-basic-support    
        xygerp-server-eureka   
        xygerp-server-zuul      
        xygerp-ald             
        xygerp-albc           
    

需要在子模块中指定父模块


        xygerp
        com.xygerp
        1.0-SNAPSHOT
        ../pom.xml

备注:具体代码直接看源码吧。这里只是提及了一些重点设置而已。

所以,到此为止,模块的依赖关系配置完毕!但要注意模块打包的顺序。

由于所有模块都依赖于xygerp-comm模块和xygerp-basic-support模块,因此在构建模块时,首先需要编译、打包、安装xygerp-comm模块和xygerp-basic-support模块,将它打包进本地仓库中,这样上层模块才能引用到。当该模块安装完毕后,再构建上层模块。
否则在构建上层模块的时候会出现找不到xygerp-comm模块中类库的问题。

Tips: 其实,如果是在父级目录直接用mvn package整体打包的话,那打包构建的顺序在父pom中是直接指定了!
2. 微服务架构服务治理部分

xygerp-server-eureka:Spring Cloud服务注册和发现。就是处理服务之间的治理。

xygerp-server-zuul:Spring Cloud的统一API网关服务。

Tips: 这2个项目是为了实现微服务架构而用到的核心服务。所以,它们是相对独立的。不需要依赖父pom。
3.4.3用mvn编译命令打包代码

上面的项目都建立好之后,再添加所有项目都需要用到的依赖(具体代码可以参考我的源码)。

都没问题的话,就可以用mvn命令进行打包项目了:

mvn clean install -Dmaven.test.skip=true -P dev

这里简单解析一下指令: 

mvn:Maven的统一指令。

clean install:表示要构建该项目。

-Dmaven.test.skip=true:表示构建的时候要跳过测试模块。

-P dev:表示构建的时候,启用 dev 的Spring boot参数运行系统。

如果一切都OK,那正常的结果如下:

3.5 本地电脑测试系统

代码搞定了,接下来需要考虑的事情应该是如何测试。
毕竟所有的系统都必须要经过测试,特别是这种配置多,涉及范围广的系统。

这个就不得不说一下Spring boot的优势了。Spring boot的打包应用默认内置了tomcat服务。
换句话说,只需要java命令执行一下Spring boot打包的target结果,就可以启动一个tomcat服务啦!真挺方便测试的!
3.5.1 启动本地系统的服务

假设我的xygerp-api项目在这里:D:JSP_MyEclipsexygerp-api

然后分别打开4个cmd命令窗口,执行:

D:JSP_MyEclipsexygerp-apixygerp-server-eureka	arget>java -jar xygerp-server-eureka-1.0-SNAPSHOT.war
D:JSP_MyEclipsexygerp-apixygerp-server-zuul	arget>java -jar xygerp-server-zuul-1.0-SNAPSHOT.war
D:JSP_MyEclipsexygerp-apixygerp-ald	arget>java -jar xygerp-ald-1.0-SNAPSHOT.war
D:JSP_MyEclipsexygerp-apixygerp-albc	arget>java -jar xygerp-albc-1.0-SNAPSHOT.war

如下图:

3.5.2 本地测试API服务系统

本地测试环境的服务启动起来了,接着就是进行具体的数据测试。

首先测试Eureka的服务注册以及发现,确认服务是否都已经注册到系统中:

然后,用swagger测试用户登录的功能:
http://127.0.0.1:8102/xygerp/ald/swagger-ui.html
目前是测试是否可以正常产生token。


说明已经登录成功,并且产生了本次访问的token!

将token记录下来,接着测试。
继续测试一个查询的功能:
http://127.0.0.1:8102/xygerp/albc/swagger-ui.html

注意,这里用了Spring Security框架,所以的API请求头都必须携带token信息。否则请求会返回401。

如果测试OK,那说明基本上系统已经成功搭建好了。
下一步就是如何在测试环境或者正式环境部署它,以及如何一键构建项目的问题了。

简单来说,系统的部署是用 docker工具 ,一键部署项目用的是 Jenkins工具。后面将会用专题来说明这2个工具的使用。
3.6 该API微服务系统实现的功能难点 3.6.1 解决数据库Session的环境变量问题,特别是语言环境和用户环境。
关于这个问题,目前我用的办法可能不一定是最优的,如果有别的兄台有更好的解决办法,请留言给我,十分感谢!

问题来源:

熟悉EBS开发的兄台都应该知道,登录ERP之后,我们每次打开Form,系统就会申请一个新的数据库Session,这时候,EBS系统会 自动帮我们初始化该Session的环境变量 :例如基本的语言环境,用户环境,业务实体等等。

这时候,我们在包里面可以直接用FND_GLOBAL.USER_ID之类的函数就可以非常方便获取环境变量的信息。

但是,在Java Web开发里面就不一样了!

在Java访问数据库的理念中,Session的申请是一个极耗资源的动作!所以,大部分连接数据库的Java软件都提出了一个 数据库连接池 的概念(例如DRUID数据库连接池)。简单来说就是session共用!

Session公用就会带来一个并发问题:A用户使用系统,并初始化了该Session的环境变量为A用户;当A用户不用系统的时候,Session会闲置并放回连接池里面等待别的用户使用。

这时候如果B的用户很可能会使用该Session,如果不重新初始化环境变量的话,那B用户使用系统的Session的环境变量还是A用户,就会导致数据的bug!
如何处理该问题是开发该系统碰到的一个难题。

问题解决:

我目前的处理办法是:在Service层,用AOP统一自动监控Service层的这个参数AuthUser user

只要在Service层将参数AuthUser user放在最后,AOP会自动初始化Session的环境变量。(需要注意的是,我这个系统的数据库Transaction在Service层启用!)

另外,语言环境变量,登录ID环境变量等,会一并自动初始化。因为AuthUser会携带该定义!

核心处理代码如下:

private static final String SQL_GLOBAL_INIT
        = " DECLARE "
        + "    L_session_id NUMBER;L_user_id NUMBER;L_login_id NUMBER;L_LANG VARCHAR2(10); "
        + " BEGIN "
        + "    L_user_id:=:P_USER_ID; L_login_id:=:P_LOGIN_ID; L_LANG:=:P_LANG;"
        + "    APPS.fnd_global.INITIALIZE("
        + "       session_id=>L_session_id, user_id =>L_user_id, resp_id =>NULL, "
        + "       resp_appl_id=>NULL, security_group_id=>NULL, site_id=>NULL, login_id =>L_login_id, "
        + "       conc_login_id=>NULL, prog_appl_id=>NULL, conc_program_id=>NULL, conc_request_id=>NULL, "
        + "       conc_priority_request=>NULL"
        + "     ); "
        + "    IF NVL(L_LANG,"US") <> USERENV("LANG") THEN "
        + "        IF L_LANG="ZHS" THEN "
        + "            APPS.fnd_global.set_nls_context(p_nls_language => "SIMPLIFIED CHINESE"); "
        + "        ELSE "
        + "            APPS.fnd_global.set_nls_context(p_nls_language => "AMERICAN"); "
        + "         END IF;"
        + "    END IF;"
        + " END; ";
    
    /*** 
     * service层调用之前先自动初始化环境变量
     * 需要注意的是,用户变量必须的参数放在最后!
     * 只要在Service层将参数AuthUser user放在最后,AOP会自动初始化Session的环境变量。
     * @throws Exception 
     */  
    @SuppressWarnings("static-access")
    @Before("execution(* com.jebms.*.service..*.*(..))  && args(..,user)")  
    public void oracleDBInit(JoinPoint joinPoint,AuthUser user) throws Exception{
        Long dbLoginId=devDao.getJdbcTemplate().queryForObject("SELECT FND_GLOBAL.LOGIN_ID FROM DUAL", Long.class);
if(user.getLoginId()!=null&&user.getLoginId()>0&&!user.getLoginId().equals(dbLoginId)){
            Map inParamMap=new HashMap();
            inParamMap.put("P_USER_ID", user.getUserId());
            inParamMap.put("P_LOGIN_ID", user.getLoginId());
            inParamMap.put("P_LANG", user.getLanguage());
            devDao.getDevJdbcTemplate().execute(this.SQL_GLOBAL_INIT, inParamMap);
        }
    }
源代码在:com.jebms.comm.utils. AopUtil
3.6.2 解决EBS的用户的登录问题:统一用EBS系统的帐号密码登录API系统。

问题描述:

由于我这个是第三方的API系统,所以,用户名和密码信息实际上并不是该API系统需要管理的事情。

相当于说,API系统无法按照正常的流程来验证用户名和密码:输入用户名和密码,系统验证后台数据库的用户名和密码,再返回验证结果。

而是:输入用户名和密码,系统 调用ERP的用户名密码验证包 进行验证,再返回结果。
简单来说:需要添加自定义验证的逻辑。

还好Spring Security框架支持灵活的验证逻辑。

添加步骤:

首先,写一个自定义验证的类:MyAuthenticationProvider

接着,在Spring Security框架的定义中,添加这个自定义的验证。

AbstractWebSecurityConfig

private MyAuthenticationProvider provider;//自定义验证
auth.authenticationProvider(provider);

即可以完美实现这个效果

核心代码:

    /**
     * 自定义验证方式
     */
    @Override
    public Authentication authenticate(Authentication authentication) throws AuthenticationException {
        String username = authentication.getName();
        String password = (String) authentication.getCredentials();
        AuthUser user = (AuthUser) userService.loadUserByUsername(username);
        System.out.println("username:"+username+",password:"+password);
        if(user == null){
            throw new BadCredentialsException("Username not found.");
        }

        //加密过程在这里体现
        if (!sysService.xygErpValidateLogin(username, password)) {
            throw new BadCredentialsException("Wrong password.");
        }
        
        user.setPassword(passwordEncoder.encode(password));

        Collection authorities = user.getAuthorities();
        return new UsernamePasswordAuthenticationToken(user, password, authorities);
    }
3.6.3 统一的开发风格。

1.Entity基类封装。

封装了5who栏位,以及类似Form的FND_SET_WHO的方法,可以很方便进行开发。

另外,为了防止丢失更新,这边每次更新前实际上会先检测数据的一致性,对应的动作也有做了封装。

2.查询逻辑的封装。

查询功能相对来说还是会很多,对于复杂的查询条件如何传值是一个难题。

这里封装了一个SearchInfo积累,可以统一将所有的查询条件都放在这个类,然后在java的Controller层定义好查询条件对应匹配栏位,系统就可以自动产生对应的and条件。

例如:

   @GetMapping(value = "/getPageLocator")
    @ApiOperation(value = "货位分页列表接口")
    public ResultEntity> getPageLocator(
            @ApiParam(value = "库存组织ID",required = true) @RequestParam(required = true) int organizationId,
            @ApiParam(value = "库别代码",required = true) @RequestParam(required = true) String subinventoryCode,
            @ApiParam(value = "货位代码",required = false) @RequestParam(required = false) String locatorCode,
            SearchInfo searchInfo) throws Exception {
        searchInfo.getConditionMap().put("organizationId", organizationId);
        searchInfo.getConditionMap().put("subinventoryCode", subinventoryCode);
        searchInfo.getConditionMap().put("locatorCode", locatorCode);
        searchInfo.setAuthUser(this.authUser);
        searchInfo.initSqlCondition();
        searchInfo.andSqlCondition("MIL.ORGANIZATION_ID","organizationId");
        searchInfo.andSqlCondition("MIL.SUBINVENTORY_CODE","subinventoryCode");
        searchInfo.andSqlCondition("MIL.SEGMENT1","locatorCode");
        return eslipService.selectForPageLocator(searchInfo);
    }

3.统一的处理结果的封装。

基本上任何一个处理,要不成功,要不失败(警告其实也算失败)。

这里封装了一个返回结果的基类ResultEntity,可以进行有效的应用端或者java端的交互。

@ApiModelProperty(value = "状态码,0表示成功 其他表示失败", example = "0",position = 1)
private String code;

特别需要指出的是,前端获取或者处理数据,也是统一要用这个处理结果基类的返回。

简单来说,就是数据处理成功/失败,会有一个统一的返回结果标识。注意,这个标识和请求的响应结果标识(200)是有所不同的!

请求响应标识只是说明web服务器的响应是正常,但,具体的处理结果可能是处理失败。

下面是一个具体的例子(到时候实际开发处理的接口处理结果也是这样子):

{
    "code": "0",
    "message": "",
    "description": "",
    "obj": [{
        "createdBy": -1,
        "creationDate": "2017-10-10 09:37:03",
        "lastUpdatedBy": 10,
        "lastUpdateDate": "2017-11-16 14:47:48",
        "lastUpdateLogin": 96,
        "valueUUID": null,
        "id": 2,
        "applId": 1,
        "respCode": "BASIC_SET",
        "menuId": 2,
        "startDate": "2017-10-10 09:37:03",
        "endDate": null,
        "respName": "系统设置职责",
        "description": "系统设置职责",
        "menuCode": "SYSTEM_SET",
        "menuName": "系统设置菜单",
        "enabled": true
    }],
    "param1": null,
    "param2": null,
    "param3": null,
    "param4": null,
    "param5": null,
    "ok": true
}
文档参考链接:
https://juejin.im/entry/5a781...
http://blog.51cto.com/ityoukn...

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/69133.html

相关文章

  • 服务实战:从架构到发布(一)

    摘要:微服务集成服务间通信微服务架构下,应用的服务直接相互独立。微服务架构倾向于降低中心消息总线类似于的依赖,将业务逻辑分布在每个具体的服务终端。 引言:微服务是当前软件架构领域非常热门的词汇,能找到很多关于微服务的定义、准则,以及如何从微服务中获益的文章,在企业的实践中去应用微服务的资源却很少。本篇文章中,会介绍微服务架构(Microservices Architecture)的基础概念,...

    libin19890520 评论0 收藏0
  • 服务实战:从架构到发布(一)

    摘要:微服务集成服务间通信微服务架构下,应用的服务直接相互独立。微服务架构倾向于降低中心消息总线类似于的依赖,将业务逻辑分布在每个具体的服务终端。 引言:微服务是当前软件架构领域非常热门的词汇,能找到很多关于微服务的定义、准则,以及如何从微服务中获益的文章,在企业的实践中去应用微服务的资源却很少。本篇文章中,会介绍微服务架构(Microservices Architecture)的基础概念,...

    HtmlCssJs 评论0 收藏0

发表评论

0条评论

JouyPub

|高级讲师

TA的文章

阅读更多
最新活动
阅读需要支付1元查看
<