OSGL - The art of conversion

[greenlaw110]

在前面的 OSGL 工具库之编程艺术系列中我们讲述了

• 图像处理的艺术
• 图像处理的艺术之用户定义处理器
• 字串处理的艺术
• IO 操作的艺术

本篇讲述如何使用 OSGL 工具库进行类型转换.

类型转换的 API 使用非常简单:

Y y = $.convert(x).to(Y.class)

1. 系统内置类型转换

1.1 基本类型转换示例

String s = "60";
int n = $.convert(s).to(Integer.class); // 60
n = $.convert(s).toInteger(); // 60
n = $.convert(s).toInt(); // 60
s = $.convert(n).toString(); // "60"
s = $.convert(n).to(String.class); // "60"

1.2 hint (转换提示) 的使用

// 这里 hint 的意思是 radix
n = $.convert("FF").hint(16).toInt(); // 255
// 这里 hint  的意思是日期格式
Date date = $.convert("06 Apr 2018").hint("dd MMM yyyy").toDate(); // 2018-04-06
String dateStr = $.convert(date).hint("yyyy-MM-dd").toString(); // 2018-04-06

1.3 Enum 类型转换示例

enum Code {
    AB, bc, Red;
}
Code code; 
code = $.convert("AB").to(Code.class); // Code.AB
code = $.convert("ab").caseInsensitivie().to(Code.class); // Code.AB

1.4 空值的处理

int n = $.convert(null).to(int.class); // 0
n = $.convert(null).to
Integer N = $.convert(null).to(Integer.class); // null

1.4.1 使用默认值

n = $.convert(null).defaultTo(5).toInt(); // 5
n = $.convert("2").defaultTo(5).toInt(); // 2

1.5 通过管道来级联类型转换

// 例1: 不用日期函数来转换日期格式:
// 06/Apr/2018 -> 2018-04-06
s = $.convert("06/Apr/2018")
        .hint("dd/MMM/yyyy")
        .pipeline(Date.class)
        .hint("yyyy-MM-dd")
        .toString(); // 2018-04-06

// 例2: 日期转到byte[]
byte[] ba = $.convert(new Date()).pipeline(String.class).to(byte[].class);

1.5.1 隐式管道

注意, 并没有注册直接的从 Date 到 byte[] 的转换器, OSGL 选择最近转换路径自动转换, 下面的代码的实际转换路径为: Date -> String -> Reader -> InputStream -> byte[]

ba = $.convert(new Date()).to(byte[].class);

2. 向 OSGL 注册并使用自己的类型转换器

2.1 源类型

public class MyFrom {
    public String id;

    public MyFrom(String id) {
        this.id = id;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        MyFrom myFrom = (MyFrom) o;
        return id != null ? id.equals(myFrom.id) : myFrom.id == null;
    }

    @Override
    public int hashCode() {
        return id != null ? id.hashCode() : 0;
    }
}

2.2 目标类型

public class MyTo {
    public String id;

    public MyTo(String id) {
        this.id = id;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        MyTo MyTo = (MyTo) o;
        return id != null ? id.equals(MyTo.id) : MyTo.id == null;
    }

    @Override
    public int hashCode() {
        return id != null ? id.hashCode() : 0;
    }
}

2.3 转换器

// MyFrom -> MyTo
public class MyConverter extends $.TypeConverter<MyFrom, MyTo> {
    @Override
    public MyTo convert(MyFrom myFrom) {
        return new MyTo(myFrom.id);
    }
}
// String -> MyFrom
public class MyConverter extends $.TypeConverter<String, MyFrom> {
    @Override
    public MyFrom convert(String s) {
        return new MyFrom(s);
    }
}

2.4 注册转换器到 OSGL

TypeConverterRegistry.INSTANCE
    .register(new MyConverter())
    .register(new StringToMyFrom());

2.5 使用自定义转换器

String s = "abc";
MyFrom from = new MyFrom(s);
MyTo to = $.convert(from).to(MyTo.class);

// 通过管道转换 String 到 myTo
to = $.convert(s).to(MyTo.class);