io.micrometer.core.instrument.util.StringEscapeUtils Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of micrometer-core Show documentation
Core module of Micrometer containing instrumentation API and implementation
There is a newer version: 1.13.2
/*
 * Copyright 2017 VMware, 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
 *
 * https://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 io.micrometer.core.instrument.util;

import io.micrometer.core.lang.Nullable;

/**
 * Utilities for JSON escaping {@code String}.
 *
 * Implementation Approach This uses a replacement char array to perform
 * escaping, an idea from Square/Moshi. In their case, it was an internal detail of
 * {@code com.squareup.moshi.JsonUtf8Writer}, licensed Apache 2.0 Copyright 2010 Google
 * Inc. The comments and initialization of {@code REPLACEMENT_CHARS} came directly from
 * Moshi's {@code JsonUtf8Writer}.
 *
 * @author Jon Schneider
 * @author Johnny Lim
 */
public final class StringEscapeUtils {

    /*
     * @param v The string to escape.
     *
     * @return An escaped JSON string.
     */
    public static String escapeJson(@Nullable String v) {
        if (v == null)
            return "";
        int length = v.length();
        if (length == 0)
            return v;

        int afterReplacement = 0;
        StringBuilder builder = null;
        for (int i = 0; i < length; i++) {
            char c = v.charAt(i);
            String replacement;
            if (c < 0x80) {
                replacement = REPLACEMENT_CHARS[c];
                if (replacement == null)
                    continue;
            }
            else if (c == '\u2028') {
                replacement = U2028;
            }
            else if (c == '\u2029') {
                replacement = U2029;
            }
            else {
                continue;
            }
            if (afterReplacement < i) { // write characters between the last replacement
                                        // and now
                if (builder == null)
                    builder = new StringBuilder(length);
                builder.append(v, afterReplacement, i);
            }
            if (builder == null)
                builder = new StringBuilder(length);
            builder.append(replacement);
            afterReplacement = i + 1;
        }
        if (builder == null)
            return v; // then we didn't escape anything

        if (afterReplacement < length) {
            builder.append(v, afterReplacement, length);
        }
        return builder.toString();
    }

    /*
     * From RFC 7159, "All Unicode characters may be placed within the quotation marks
     * except for the characters that must be escaped: quotation mark, reverse solidus,
     * and the control characters (U+0000 through U+001F)."
     *
     * We also escape '\u2028' and '\u2029', which JavaScript interprets as newline
     * characters. This prevents eval() from failing with a syntax error.
     * https://github.com/google/gson/issues/341
     */
    private static final String[] REPLACEMENT_CHARS;

    static {
        REPLACEMENT_CHARS = new String[128];
        for (int i = 0; i <= 0x1f; i++) {
            REPLACEMENT_CHARS[i] = String.format("\\u%04x", (int) i);
        }
        REPLACEMENT_CHARS['"'] = "\\\"";
        REPLACEMENT_CHARS['\\'] = "\\\\";
        REPLACEMENT_CHARS['\t'] = "\\t";
        REPLACEMENT_CHARS['\b'] = "\\b";
        REPLACEMENT_CHARS['\n'] = "\\n";
        REPLACEMENT_CHARS['\r'] = "\\r";
        REPLACEMENT_CHARS['\f'] = "\\f";
    }

    private static final String U2028 = "\\u2028";

    private static final String U2029 = "\\u2029";

    private StringEscapeUtils() {
    }

}