Class Joiner

java.lang.Object

cloud.opencode.base.string.builder.Joiner

public final class Joiner
extends Object

String Joiner (Guava Style) 字符串连接器（Guava风格）

Joins pieces of text with a separator. Thread-safe and immutable.

使用分隔符连接文本片段。线程安全且不可变。

Features | 主要功能:

• Flexible null handling - 灵活的null处理
• Map joining support - Map连接支持
• Append to existing builders - 追加到现有构建器
• Immutable, thread-safe - 不可变，线程安全

Usage Examples | 使用示例:

// Basic join
String result = Joiner.on(", ").join(Arrays.asList("a", "b", "c"));
// -> "a, b, c"

// Skip nulls
String safe = Joiner.on(", ").skipNulls().join("a", null, "c");
// -> "a, c"

// Replace nulls
String withDefault = Joiner.on(", ").useForNull("N/A").join("a", null, "c");
// -> "a, N/A, c"

// Join Map
String params = Joiner.on("&").withKeyValueSeparator("=")
    .join(Map.of("key", "value"));
// -> "key=value"

Security | 安全性:

• Thread-safe: Yes (immutable) - 线程安全: 是（不可变）
• Null-safe: Configurable (skipNulls/useForNull) - 空值安全: 可配置

Since:

JDK 25, opencode-base-string V1.0.0

Author:

Leon Soo www.LeonSoo.com

See Also:

• OpenCode.cloud

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	Joiner.MapJoiner

Method Summary

Modifier and Type	Method	Description
<A extends Appendable> A	appendTo(A appendable, Iterable<?> parts)
<A extends Appendable> A	appendTo(A appendable, Iterator<?> parts)
StringBuilder	appendTo(StringBuilder builder, Iterable<?> parts)
String	join(Iterable<?> parts)
String	join(Object[] parts)
String	join(Object first, Object second, Object... rest)
String	join(Iterator<?> parts)
static Joiner	on(char separator)
static Joiner	on(String separator)
Joiner	skipNulls()
Joiner	useForNull(String nullText)
Joiner.MapJoiner	withKeyValueSeparator(char keyValueSeparator)
Joiner.MapJoiner	withKeyValueSeparator(String keyValueSeparator)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

on

public static Joiner on(String separator)

on

public static Joiner on(char separator)

skipNulls

public Joiner skipNulls()

useForNull

public Joiner useForNull(String nullText)

join

public String join(Iterable<?> parts)

join

public String join(Iterator<?> parts)

join

public String join(Object[] parts)

join

public String join(Object first,
 Object second,
 Object... rest)

appendTo

public <A extends Appendable> A appendTo(A appendable,
 Iterable<?> parts)

appendTo

public <A extends Appendable> A appendTo(A appendable,
 Iterator<?> parts)

appendTo

public StringBuilder appendTo(StringBuilder builder,
 Iterable<?> parts)

withKeyValueSeparator

public Joiner.MapJoiner withKeyValueSeparator(String keyValueSeparator)

withKeyValueSeparator

public Joiner.MapJoiner withKeyValueSeparator(char keyValueSeparator)