user/super/com/google/gwt/emul/java/util/StringJoiner.java

/*
 * Copyright 2015 Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */
package java.util;

/**
 * See <a href="https://docs.oracle.com/javase/8/docs/api/java/util/StringJoiner.html">
 * the official Java API doc</a> for details.
 */
public final class StringJoiner {

  private final String delimiter;
  private final String prefix;
  private final String suffix;

  private StringBuilder builder;
  private String emptyValue;

  public StringJoiner(CharSequence delimiter) {
    this(delimiter, "", "");
  }

  public StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix) {
    this.delimiter = delimiter.toString();
    this.prefix = prefix.toString();
    this.suffix = suffix.toString();
    this.emptyValue = this.prefix + this.suffix;
  }

  public StringJoiner add(CharSequence newElement) {
    initBuilderOrAddDelimiter();
    builder.append(newElement);
    return this;
  }

  public int length() {
    if (builder == null) {
      return emptyValue.length();
    }
    return builder.length() + suffix.length();
  }

  public StringJoiner merge(StringJoiner other) {
    if (other.builder != null) {
      // in case of other == this we need the length before adding delimiter to this (and thus other)
      // so we can skip the trailing delimiter of other when merging into this.
      int otherLength = other.builder.length();
      initBuilderOrAddDelimiter();
      builder.append(other.builder, other.prefix.length(), otherLength);
    }
    return this;
  }

  public StringJoiner setEmptyValue(CharSequence emptyValue) {
    this.emptyValue = emptyValue.toString();
    return this;
  }

  @Override
  public String toString() {
    if (builder == null) {
      return emptyValue;
    } else if (suffix.isEmpty()) {
      return builder.toString();
    } else {
      return builder.toString() + suffix;
    }
  }

  private void initBuilderOrAddDelimiter() {
    if (builder == null) {
      builder = new StringBuilder(prefix);
    } else {
      builder.append(delimiter);
    }
  }
}