io.whitfin.dottie.joiner

Class NotationJoiner

java.lang.Object

io.whitfin.dottie.joiner.NotationJoiner

public class NotationJoiner
extends Object

Joining class for notation, to allow joining many property keys efficiently and fluently. Uses a StringBuilder under the hood for performance reasons, and due to the inability to extend. A joiner instance can only append, due to the nature of how notation works it would be unnecessary and complex to implement removal.

Constructor Summary

Constructors

Constructor and Description
NotationJoiner() Initializes the internal builder.

Method Summary

Modifier and Type	Method and Description
NotationJoiner	append(Integer... indices) Appends some amount of index values to the builder.
NotationJoiner	append(NotationSegment... segments) Appends some existing segments to the builder.
NotationJoiner	append(String... properties) Appends some amount of property values to the builder.
String	print() Converts the current state of the builder to a String.
NotationJoiner	reset() Resets the joiner to an initial state.
String	toString() Converts this instance to a String.

Methods inherited from class java.lang.Object

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

Constructor Detail

NotationJoiner

public NotationJoiner()

Initializes the internal builder.

Method Detail

append

@Nonnull
public NotationJoiner append(@Nonnull
                                      Integer... indices)

Appends some amount of index values to the builder.

Parameters:

indices - the index values to add to the joiner.

Returns:

this NotationJoiner for chaining.

append

@Nonnull
public NotationJoiner append(@Nonnull
                                      NotationSegment... segments)

Appends some existing segments to the builder.

Parameters:

segments - the segment values to add to the joiner.

Returns:

this NotationJoiner for chaining.

append

@Nonnull
public NotationJoiner append(@Nonnull
                                      String... properties)

Appends some amount of property values to the builder.

Parameters:

properties - the property values to add to the joiner.

Returns:

this NotationJoiner for chaining.

print

@Nonnull
public String print()

Converts the current state of the builder to a String.

Returns:

a new String instance.

reset

@Nonnull
public NotationJoiner reset()

Resets the joiner to an initial state.

Returns:

this NotationJoiner for chaining.

toString

@Nonnull
public String toString()

Converts this instance to a String.

Overrides:

toString in class Object

Returns:

a String representation.