java osgl_OSGL 工具库 - Java 字串处理的艺术

在 [OSGL 工具库 - 图片处理的艺术] (https://my.oschina.net/greenlaw110/blog/1786151) 中我们介绍了如何通过 OSGL Img 提供的一套 API 流畅地处理图片, 例如:

source(img1())

.resize(300, 400)

.pipeline()

.crop(50, 50, 250, 350)

.pipeline()

.watermark("HELLO OSGL")

.writeTo("/tmp/img1_pipeline.png");

采用这种方式编写的代码极大地提高了可读性, 我们把这种 API 结构称为流式编程 (Fluent Programming). 我们在本文中将介绍如何使用 OSGL S 库处理字串, 包括采用流式编程来提供具有高可读性的字串处理代码.

下面用代码来说明一切:

1. 字串判断

1.1 判断字串是否为空

boolean b = S.isEmpty(""); // true

b = S.isEmpty(null); // true

b = S.isEmpty(" "); // false

b = S.isBlank(" "); // true

b = S.isNotEmpty("abc"); // true

b = S.isNotBlank("\t"); false

b = S.isAnyEmpty("", "xyz", ..); // true

b = S.isAllEmpty("", "xyz", ...); // false

1.2. 判断字串是否为数字

boolean b = S.isIntOrLong("12345"); // true

b = S.isIntOrLong("1234.5"); // false

b = S.isNumeric("1234.5"); // true

1.3 字串判断的流式编程

boolean b = S.is("foo").empty(); // false

b = S.is(" ").blank(); // true

b = S.is("abc").contains("ab"); // true

b = S.is("abc").startsWith("ab"); // true

b = S.is("abc").endsWith("ab"); // false

b = S.is(null).equalsTo(null); // true

b = S.is(null).equalsTo(""); // true

b = S.is(null).equalsTo(" "); // false

b = S.is("[abc]").wrappedWith("[", "]"); // true

b = S.is("").wrappedWith(S.ANGLE_BRACKETS); // true

2. 字串相等性

yes(S.eq("foo", "foo"));

yes(S.eq("foo", "Foo", S.IGNORECASE));

no(S.eq("foobar", " FooBar "));

yes(S.eq("foobar", " FooBar ", S.IGNORESPACE | S.IGNORECASE));

yes(S.eq(null, null));

no(S.eq(null, "foo"));

3. 字串格式化

String s = S.fmt("hello %s", "world"); // hello world

s = S.msgFmt("hello {0}", "world"); // hello world

4. 字串验证

String s = S.requireNotEmpty("foo"); // foo

s = S.requireNotBlank("bar"); // bar

s = S.requireNotEmpty(""); // raise IllegalArgumentException

s = S.requireNotBlank(" "); raise IllegalArgumentException

5. 字串长度

int n = S.len("abc"); // 3

n = S.len(null); // 0

6. 字串分割

List list = S.fastSplit("/tmp/foo/bar", "/"); [tmp, foo, bar]

S.List list = S.split("abc5xyz132ijk", ":"); [abc, xyz, ijk]

list = S.split("/tmp/foo/bar").by("/").get(); [tmp, foo, bar]

list = S.split("[abc]-[xyz]").by("-").stripElementWrapper(S.BRACKETS).get(); // [abc, xyz]

7. 字串拼接

7.1 集合拼接为字串

List list = C.list("abc", "xyz");

String s = S.join(list).by("-").get(); // abc-xyz

s = S.join(list).by("-").wrapElementWith(S.SQUARE_BRACKETS).get(); // [abc]-[xyz]

list = S.list("abc", null, "xyz");

S.join(list).by("-").get(); // abc--xyz

S.join(list).by("-").ignoreEmptyElement().get(); // abc-xyz

7.2 任意类型对象拼接为字串

String s = S.concat("abc", 123); // abc123

s = S.concat("abc", null, 123); // abc123

7.3 路径拼接

eq("foo/bar", S.pathConcat("foo", '/', "bar"));

eq("foo/bar", S.pathConcat("foo/", '/', "bar"));

eq("foo/bar", S.pathConcat("foo", '/', "/bar"));

eq("foo/bar", S.pathConcat("foo/", '/', "/bar"));

9. 字串修饰确认

eq("[abc]", S.ensure("abc").wrappedWith(S.SQUARE_BRACKETS));

eq("[abc]", S.ensure("[abc").wrappedWith(S.SQUARE_BRACKETS));

eq("[abc]", S.ensure("[abc]").wrappedWith(S.SQUARE_BRACKETS));

eq("abc", S.ensure("abc").strippedOff(S.ANGLE_BRACKETS));

eq("abc", S.ensure("").strippedOff(S.ANGLE_BRACKETS));

eq("_abc", S.ensure("abc").startWith('_'));

eq("abc.html", S.ensure("abc").endWith(".html"));

10. 字串替换

String s;

s = S.given("hello world").replace("world").with("foo"); // hello foo

s = S.replace("world").in("hello world").with("foo"); // hello foo

s = S.replace("world").with("foo").in("hello world"); // hello foo

s = S.replace("[0-9]+").with("[N]").usingRegEx().in("times 10")); // times [N]

11. 字串重复

eq("aaa", S.repeat('a').times(3));

eq("aaa", S.repeat('a').x(3));

eq("aaaaa", S.repeat('a').forFiveTimes());

eq("foofoo", S.repeat("foo").times(2));

eq("foofoo", S.repeat("foo").x(2));

12. 字串包裹

eq("*abc*", S.wrap("abc").with("*"));

eq("[abc]", S.wrap("abc").with("[", "]"));

eq("[abc]", S.wrap("abc").with(S.BRACKETS));

eq("(abc)", S.wrap("abc").with(S.PARENTHESES));

eq("", S.wrap("abc").with(S.DIAMOND));

eq("", S.wrap("abc").with(S.ANGLE_BRACKETS));

eq("《abc》", S.wrap("abc").with(S.书名号));

13. 字串去包裹

eq("abc", S.strip("[abc]").of(S.BRACKETS));

eq("abc", S.strip("").of(S.DIAMOND));

eq("abc", S.strip("*abc*").of("*"));

eq("abc", S.strip("111abc222").of("111", "222"));

14. 字串切断

eq("abc12", S.cut("abc123").by(5));

eq("ab", S.cut("abc123").first(2));

eq("23", S.cut("abc123").last(2));

eq("123", S.cut("abc123").after("abc"));

eq("abc", S.cut("abc123").before("123"));

eq("abc", S.cut("abc123abc123").before("123"));

eq("abc", S.cut("abc123abc123").beforeFirst("123"));

eq("abc123abc", S.cut("abc123abc123").beforeLast("123"));

eq("123", S.cut("abc123abc123").after("abc"));

eq("123", S.cut("abc123abc123").afterLast("abc"));

eq("123abc123", S.cut("abc123abc123").afterFirst("abc"));

15. 关键字处理

final String s = "Hello World";

eq("HelloWorld", S.camelCase(s));

eq("hello_world", S.underscore(s));

eq("hello-world", S.dashed(s));

eq("Hello World", S.capFirst(s));

eq("hello World", S.lowerFirst(s));

eq("Hello-World", Keyword.of(s).httpHeader());

eq("helloWorld", Keyword.of(s).javaVariable());

eq("HELLO_WORLD", Keyword.of(s).constantName());

eq("Hello world", Keyword.of(s).readable());

16. 子串计数

final String s = "1011101111";

eq(3, S.count("11").in(s));

eq(5, S.count("11").withOverlap().in(s));

17. 其他工具

eq("", S.trim(null));

eq("abc", S.trim(" abc"));

eq("abc\nxyz", S.dos2unix("abc\n\rxyz"));

eq("abc\n\rxyz", S.unix2dos("abc\nxyz"));

eq("this...", S.maxLength("this is a long text", 4));

yes(S.eq("foo", "foo"));

String s;

s = S.uuid(); // 9b2ec83d-15df-4746-9689-c82df5643832

s = S.random(); //kGYH$KCj

s = S.random(2); // gb

s = S.maxLength("this is a long text", 4); // this...

转载至链接:https://my.oschina.net/greenlaw110/blog/1790369