JarCasting0.Get Start...
<dependency>
<groupId>com.github.dreamroute</groupId>
<artifactId>grator</artifactId>
<version>newest version</version>
</dependency>
1.为什么要使用微服务数据集？
- 由于微服务拆分比较细，往往在一个服务里面无法进行数据库的inner join或者left/right join操作，而需要查询多个服务，那么查询多个服务的返回结果如组合成为一个结果（对象或者json）， 数据集就是提供组合多个微服务查询结果的工具，类似于单库的join操作。
- 举例：前端查询订单需要显示订单相关的买家信息
- 订单服务查询出订单对象 Order[id=1, price=1.2, num=3, userId=10];
- 用户服务查询出用户对象 User[id=10, name="Jay", email="[email protected]"]
- 此时需要返回给前端Order，并且Order内部包含了User对象的，如果是单库，那么select * from order o left join user u on o.user_id = u.id，利用mybatis或者Hibernate的ORM能力，可以返回Order对象
- 然而此刻订单和用户未在同一个库，无法进行跨库的join操作，所以首先需要将Order和User单独查出，再人工进行合并数据
- 利用Grator这样实现：Order odr = QueryBuilder.newInstance().many2one(order, "userId", "addrId").association(user, "id", "user").association(addr, "id", "addr").result(Order.class);和mybatis很类似
2.作者提醒
- ORM解决的主要关系：一对一，一对多，多对一，多对多；
- 开发该工具主要致力于花20%的时间解决80%的问题，一对一足够简单（可以理解成为多对一），多对多由于存在中间表，关闭相对复杂，如果通过此工具解决，传入的参数过多，不太优雅，所以该工具 直接放弃多对多的支持，实际业务场景中多对多相对较少，而且即便是有，往往也伴随着比较复杂的业务逻辑，很少有直接3个表关联查询。
- 该工具支持单个对象或者集合类型的集成。
3.使用方法(以实际场景为例)
- 工具使用类似于建造者模式；
- 1.创建工具对象：QueryBuilder.newInstance()
- 2.关联管理(多对一，一对多，二选一)，方法为分别为：many2one和one2many
- 3.参数，工具由于参数较多，采用链式调用方式：
- 多对一：many2one(Object master, String... foreignKeys)；第一个为外层对象，第二个为多对一的外键，association(user, "id", "user")，第一个参数为内部对象，第二个为内部对象主键，第三个为内部 对象在外部对象中的属性名称；
- 一对多：one2many(Object master, String pk)；第一个为外层对象，第二个为“一”的一方的主键；collection(orders, "userId", "orders")，第一个参数为内部对象，第二个为内部对象的外键，第三个为内部 对象在外部对象中的属性名称；
- 该工具可以实现类似超过两张表的集成，同样采用链式调用，比如多对一，可以多个association，类似这样： Order odr = QueryBuilder.newInstance() .many2one(order, "userId", "addrId") .association(user, "id", "user") .association(addr, "id", "addr") .result(Order.class);
- 返回值：目前返回值只支持2种，一种是外层对象类型，另外一种是json，需要调用result方法进行传入参数类型，返回json传入参数为String.class
4.目前工具存在的问题：
- 由于工具内部涉及到大量的反射调用，因为工作比较繁忙，所以暂时为增加缓存功能，后续会陆续加上
5.兼容性：JDK7+
6.举例(单元测试中有这些例子)：
package com.bdfint.grator.util;
import java.math.BigDecimal; import java.util.ArrayList; import java.util.List;
import org.junit.Test;
import com.bdfint.grator.QueryBuilder; import com.bdfint.grator.util.domain.Addr; import com.bdfint.grator.util.domain.Order; import com.bdfint.grator.util.domain.User;
public class GratorTest {
/**
* 多对一：单个对象
*/
@Test
public void many2oneTest() {
Order order = new Order();
order.setId(1L);
order.setPrice(new BigDecimal("1.2"));
order.setNum(3);
order.setUserId(100L);
order.setAddrId(10L);
User user = new User();
user.setId(100L);
user.setName("w.dehai");
user.setEmail("[email protected]");
Addr addr = new Addr();
addr.setId(10L);
addr.setName("四川成都");
Order odr = QueryBuilder.newInstance()
.many2one(order, "userId", "addrId")
.association(user, "id", "user")
.association(addr, "id", "addr")
.result(Order.class);
System.err.println(odr);
}
/**
* 多对一：集合类型
*/
@Test
public void many2oneCollectionTest() {
List<Order> orders = new ArrayList<>();
for (int i = 0; i < 3; i++) {
Order order = new Order();
order.setId(Long.valueOf(i));
order.setPrice(new BigDecimal(String.valueOf(i + 1.2)));
order.setUserId(Long.valueOf(i));
orders.add(order);
}
List<User> users = new ArrayList<>();
for (int i = 0; i < 3; i++) {
User user = new User();
user.setId(Long.valueOf(i));
user.setName("w.dehai" + i);
users.add(user);
}
List<?> orderList = QueryBuilder.newInstance().many2one(orders, "userId").association(users, "id", "user").result(List.class);
System.err.println(orderList);
}
/**
* 一对多：单个对象
*/
@Test
public void one2manyTest() {
User user = new User();
user.setId(100L);
user.setName("w.dehai");
user.setEmail("[email protected]");
List<Order> orders = new ArrayList<>();
for (int i = 0; i < 3; i++) {
Order order = new Order();
order.setId(Long.valueOf(i));
order.setNum(3);
order.setPrice(new BigDecimal("1.2"));
order.setUserId(100L);
orders.add(order);
}
List<Addr> addrs = new ArrayList<>();
for (int i = 0; i < 3; i++) {
Addr addr = new Addr();
addr.setId(Long.valueOf(i));
addr.setName("四川成都" + i);
addr.setUserId(100L);
addrs.add(addr);
}
User result = QueryBuilder.newInstance().one2many(user, "id").collection(orders, "userId", "orders").collection(addrs, "userId", "addrs").result(User.class);
String resultStr = QueryBuilder.newInstance().one2many(user, "id").collection(orders, "userId", "orders").collection(addrs, "userId", "addrs").result(String.class);
System.err.println(result);
System.err.println(resultStr);
}
/**
* 一对多：集合类型
*/
@Test
public void one2manyCollectionTest() {
List<User> users = new ArrayList<>();
for (int i = 0; i < 2; i++) {
User user = new User();
user.setId(100L + i);
user.setName("w.dehai");
user.setEmail("[email protected]");
users.add(user);
}
List<Order> orders = new ArrayList<>();
for (int i = 0; i < 3; i++) {
Order order = new Order();
order.setId(Long.valueOf(i));
order.setNum(3);
order.setPrice(new BigDecimal("1.2"));
order.setUserId(100L + i);
orders.add(order);
}
List<Addr> addrs = new ArrayList<>();
for (int i = 0; i < 3; i++) {
Addr addr = new Addr();
addr.setId(Long.valueOf(i));
addr.setName("四川成都" + i);
addr.setUserId(100L);
addrs.add(addr);
}
List<?> result = QueryBuilder.newInstance().one2many(users, "id").collection(orders, "userId", "orders").collection(addrs, "userId", "addrs").result(List.class);
String resultStr = QueryBuilder.newInstance().one2many(users, "id").collection(orders, "userId", "orders").collection(addrs, "userId", "addrs").result(String.class);
System.err.println(result);
System.err.println(resultStr);
}
}
## 更新日志：
* 2018-05-13 内部上线；
* 2018-05-31 缓存功能上线，对用户透明，兼容以往接口；