# fastbean

**Repository Path**: jiangsonglin/fastbean

## Basic Information

- **Project Name**: fastbean
- **Description**: fastbean是快速、优雅的JavaBean copy util，可配置不同的策略达到个性化设置。它不依赖反射，是基于cglib BeanCopier进一步优化的。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/jiangsonglin/fastbean
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2021-12-11
- **Last Updated**: 2024-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java

## README

# fastbean

#### 介绍
> fastbean基于cglib。一个快速的基于字节码的映射，它不依赖反射来操作Bean。
> 
> 默认支持同名同类型(含包装类)属性赋值,不同名需要设置nameMapping，字段忽略需要设置ignoreSet，
> 类型不同需要设置类型转换链(默认set NULL)。
> 详细用法请查看example
## 配置

### 默认配置

`FastBeanCopier.globalFastBeanStrategy`

- 不允许设置空值
- 不允许覆盖值
- 浅拷贝
- 类型不一致需自定义转换
- 泛型安全检查

### 修改全局配置

```java
FastBeanStrategy fastBeanStrategy = new FastBeanStrategy();
        fastBeanStrategy.setCopyStrategy(StrategyConstant.DEEP_COPY);
        fastBeanStrategy.setSetNullStrategy(StrategyConstant.CAN_SET_NULL);
// 设置全局策略 是否设置空值 是否覆盖 是否深拷贝
FastBeanCopier.setGlobalFastBeanStrategy(fastBeanStrategy);
```

### 局部配置

```java
BeanCopyUtil.chain(userDO, userDTO)
  // 允许值覆盖 单次生效
  .canCover() 
  // 允许设置控制 单次生效
  .canSetNull()
  // 深拷贝 单次生效
  .isDeep(true)
  .copy();
```

### 深拷贝规则

1.实现`FastCloneable`接口，属性值是浅拷贝。`Object.clone()`

2.拷贝失败尝试序列化方式

3.否则是浅拷贝

`FastBeanStrategy#deepCopy`


## 特点
- 基于字节码技术。
- 属性名映射,属性忽略。

- 支持自定义转换链，当前只支持类型不一致才会调用。
- 泛型安全检查
- 支持基本类型与包装类型之间转换。int <-> Integer
- 优雅的链式调用
```java
BeanCopyUtil.chain(userDO,userDTO) // 开启链式调用
        .nameMapping(UserDTO::getName, UserDO::getUsername) // 字段映射（可选）
        .nameMapping(UserDTO::getId, UserDO::getIds) // 字段映射（可选）
        .ignore(UserDTO::getAddress) // 字段忽略(可选
        .converterChain(new DefaultConverterChain()) // 自定义转换器链（可选）
        .converter(new EnumConverter()) // 往转换器(自定义/默认) 添加转换器 （可选）
        .copy(); // 复制
```
## 使用方式
### 查看生成文件
执行fastbean之前执行，查看cglib生成的代理类
```java
System.setProperty(DebuggingClassWriter.DEBUG_LOCATION_PROPERTY, "./proxyOutput");
```
![img.png](img.png)
![img_1.png](img_1.png)
### maven
```xml
<dependency>
    <groupId>io.github.cqpsjsl</groupId>
    <artifactId>fastbean</artifactId>
    <version>2.0.1</version>
</dependency>

```
> UserDO

```java
@Data
public class UserDO {
    private Integer id;
    private String username;
    private String address;
    private List<Long> ids;
    private Double price;
    private BigDecimal marketPrice;
    private LocalDateTime time;
}
```
> UserDTO

```java
@Data
public class UserDTO {
    private Integer id;
    private String name;
    private String address;
    private List<Long> ids;
    private Double price;
    private BigDecimal marketPrice;
    private Long time;
}
```
 ### 常规使用
 ```java
BeanCopyUtil.copy(userDO, userDTO);
```
### List
```java
List<UserDTO> userDTOS = BeanCopyUtil.copyList(list, UserDO.class, UserDTO.class);
```
### 属性映射、属性忽略
> UserDO中username需要赋值到UserDTO中的name上。
```java
// 属性映射
BeanCopyUtil.chain(userDO,userDTO)
        .nameMapping(UserDTO::getName, UserDO::getUsername)
        .copy();

```
### 自定义转换器
> UserDO中是LocalDateTime,UserDO中是Long,如果未定义属性转换器,将会set NULL。

```java
    BeanCopyUtil.chain(userDO,userDTO)
    .converter(new EnumConverter())
    .copy();

```
> TypeConverter

```java
public class TypeConverter
    implements Converter
{
    public Object convert(Object value, Class target) {
        if (value == null) return null; 
        if (value.getClass().equals(LocalDateTime.class) && target.equals(Long.class)) {
            // 返回你需要的处理
            return Long.valueOf(System.currentTimeMillis());
        }
        return null;
    }
}
```