Class GString

src/main/java/groovy/lang/GString.java:40–299

Represents a String which contains embedded values such as "hello there ${user} how are you?" which can be evaluated lazily. Advanced users can iterate over the text and values to perform special processing, such as for performing SQL operations, the values can be substituted for ? and the actual va

 * and was such a good idea, I couldn't resist :)
 */
public abstract class GString extends GroovyObjectSupport implements Comparable, CharSequence, Writable, Buildable, Serializable {

    @Serial private static final long serialVersionUID = -2638020355892246323L;

    /**
     * Shared empty string array.
     */
    public static final String[] EMPTY_STRING_ARRAY = new String[0];

    /**
     * Shared empty object array.
     */
    public static final Object[] EMPTY_OBJECT_ARRAY = new Object[0];

    /**
     * A GString containing a single empty String and no values.
     */
    public static final GString EMPTY = new GString(EMPTY_OBJECT_ARRAY) {
        @Serial private static final long serialVersionUID = -7676746462783374250L;
        private static final String EMPTY_STRING = "";

        /**
         * {@inheritDoc}
         */
        @Override
        public String[] getStrings() {
            return new String[]{EMPTY_STRING};
        }

        /**
         * {@inheritDoc}
         */
        @Override
        public String toString() {
            return EMPTY_STRING;
        }
    };

    private final Object[] values;

    /**
     * Creates a GString from the supplied values array reference.
     *
     * @param values the interpolated values
     */
    public GString(Object values) {
        this.values = (Object[]) values;
    }

    /**
     * Creates a GString from the supplied values.
     *
     * @param values the interpolated values
     */
    public GString(Object[] values) {
        this.values = values;
    }