背景
odoo数据拉取,创建,更新
参考
官方external api文档
External API — Odoo 14.0 文档
术语
ORM odoo数据以对象模型呈现,支持one2many,many2one,many2many等对象关联关系
Model 可以看作数据表,数据类型
XML-RPC odoo使用xml-rpc通信
设计模型
Client负责连接协议,即xml rpm协议
Connector 封装获取数据逻辑
QueryRequest 查找请求,封装查找条件参数
表达式模型
odoo的查询表达式是逆波兰表达式,连接器支持两种构建表达式方式
-
表达式分析器(未实现)
用户出入 (traceId=='b') and ((database=='d') or ((days>=12) or (eventType=='g')))
通用格式的表达式,分析器转换成逆波兰式
-
流式api构建器
流式builder构建逆波兰式
两方式比较:
分析器,通用的表达式符合开发人员的思维,但分析器递归分析消耗一定性能,可增加缓存支持,但要考虑参数化表达式
流式api性能高,需要开发人员先转为逆波兰式
接口设计
setupTestDataBase 获取demo库的属性,包括host,user,password,database(数据库名称),用于demo库拉取,demo库是动态,先通过此方法,odoo分配哪个demo库
authenticate 认证,认证的参数,host,user,password,database,连接器构造方法传入
listFieldsOfModel 获取模型的字段,包括名称,类型,说明
count 返回传入请求条件查到的记录总数
search 查找
createRecored/updateRecord/deleteRecord 增删改记录
开发指南
以下代码来源于单元测试
1. 构建连接器
odooConnector = new Connector(host, dbParams, false);
host = "http://xxx.odoo.com" xxx申请时填写
user = "???@?????.com" 邮箱地址
database = "xxx" 同host的域名
password 支持密码,app key两种方式,推荐使用app key,不需要发布密码,防止别人登录,一个账号可以发布多个key,用名称识别,区分谁调用接口
其中,后3个参数封装到DatabaseParams类,即dbParams
若使用demo库,需要先用setupTestDataBase接口方法获取动态demo库的DatabaseParam
2. 认证
userID = odooConnector.authenticate();
userId用于后面查找api
3. 构建查找表达式
QueryExpBuilder eb = new QueryExpBuilder();
eb.or().and().left("amount_total", Operator.GT, 1000)
.right("amount_total", Operator.LT, 2000)
.right("amount_total", Operator.LT, 1000)
逆波兰表达式
4. 构建查找请求
QueryRequestBuilder builder = new QueryRequestBuilder();
builder
.sort("date_order", SortOrder.DESC) // 排序
.offset(0)
.limit(5) // offset/limit 分页
.requestFileds(…) // 请求返回的字段
.queryExp(eb) // 查询表达式,参考4
;
QueryRequest qr = builder.build();
最后调用build方法生成查询请求 QueryRequest
5. 执行查找
Object[] orders = odooConnector.search(orderModel, qr);
返回map数组,应用需转换成具体业务对象
单元测试
代码包提供完整单元测试,覆盖各种场景,包括not and or嵌套和优先级
代码包提供两个测试类,OdooConnectorDemoTest和OdooConnectorTest
分表用于odoo提供的demo数据库和自建数据库
demo库odoo提供,不需要自己创建应用,导入数据,直接可以使用,但demo是动态,每次测试可能连不同的库,数据不能延续,速度慢
odoo可免费注册,使用14天,之后可续期,odoo提供demo数据库,导入后应用有数据可供测试
测试示例使用odoo应用的销售模块,订单子功能,选取以下字段
/**
* 字段
name String 号码
date_order datetime 单据日期
commitment_date datetime 送货日期
expected_date datetime 预计日期
partner_id many2one 客户
amount_tax float
amount_untaxed float
amount_total float 合计
invoice_status 发票状态
order_line={name=order_line, type=one2many} 订单明细
note html 说明
*/
测试1:查找表达式测试
测试不同运算符,逻辑符场景,包括=,<>,like,not like等运算符,not and or及其嵌套,优先级
打开注释测试不同测试场景,1~7,其中6,7测试not and or嵌套和优先级
测试2:分页拉取测试
演示count方法获取总数,for循环分页拉取所有数据
代码下载(收费)
包含连接器和单元测试
https://download.csdn.net/download/szlhj/36717794