Package groovy.lang
Class GString
java.lang.Object
groovy.lang.GroovyObjectSupport
groovy.lang.GString
- All Implemented Interfaces:
- Buildable,- GroovyObject,- Writable,- Serializable,- CharSequence,- Comparable
- Direct Known Subclasses:
- GStringImpl
public abstract class GString
extends GroovyObjectSupport
implements Comparable, CharSequence, Writable, Buildable, Serializable
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 value objects can be bound to a JDBC statement.
 
James Strachan: The lovely name of this class was suggested by Jules Gosnell and was such a good idea, I couldn't resist :)
- See Also:
- 
Field SummaryFields
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionvoidbuild(GroovyObject builder) protected intcharcharAt(int index) intbooleanbooleanbyte[]getBytes()byte[]abstract String[]getValue(int idx) intObject[]inthashCode()invokeMethod(String name, Object args) Overloaded to implement duck typing for Strings so that any method that can't be evaluated on this object will be forwarded to the toString() object instead.intlength()negate()Turns a String into a regular expression patternsubSequence(int start, int end) toString()Writes this object to the given writer.Methods inherited from class groovy.lang.GroovyObjectSupportgetMetaClass, setMetaClassMethods inherited from class java.lang.Objectclone, finalize, getClass, notify, notifyAll, wait, wait, waitMethods inherited from interface java.lang.CharSequencechars, codePoints, isEmptyMethods inherited from interface groovy.lang.GroovyObjectgetProperty, setProperty
- 
Field Details- 
EMPTY_STRING_ARRAY
- 
EMPTY_OBJECT_ARRAY
- 
EMPTYA GString containing a single empty String and no values.
 
- 
- 
Constructor Details- 
GString
- 
GString
 
- 
- 
Method Details- 
getStrings
- 
invokeMethodOverloaded to implement duck typing for Strings so that any method that can't be evaluated on this object will be forwarded to the toString() object instead.- Specified by:
- invokeMethodin interface- GroovyObject
- Parameters:
- name- the name of the method to call
- args- the arguments to use for the method call
- Returns:
- the result of invoking the method
 
- 
getValues
- 
plus
- 
plus
- 
getValueCountpublic int getValueCount()
- 
getValue
- 
toString- Specified by:
- toStringin interface- CharSequence
- Overrides:
- toStringin class- Object
 
- 
calcInitialCapacityprotected int calcInitialCapacity()
- 
writeToDescription copied from interface:WritableWrites this object to the given writer.This is used to defer content creation until the point when it is streamed to the output destination. Oftentimes, content will be defined but not necessarily created (as it may be the case with a Closure definition.) In that case, the output is then 'deferred' to the point when it is serialized to the writer. This class may be used whenever an object should be responsible for creating its own textual representation, but creating the entire output as a single String would be inefficient (such as outputting a multi-gigabyte XML document.) - Specified by:
- writeToin interface- Writable
- Parameters:
- out- the Writer to which this Writable should output its data.
- Returns:
- the Writer that was passed
- Throws:
- IOException- if an error occurred while outputting data to the writer
 
- 
build
- 
hashCodepublic int hashCode()
- 
equals
- 
equals
- 
compareTo- Specified by:
- compareToin interface- Comparable
 
- 
charAtpublic char charAt(int index) - Specified by:
- charAtin interface- CharSequence
 
- 
lengthpublic int length()- Specified by:
- lengthin interface- CharSequence
 
- 
subSequence- Specified by:
- subSequencein interface- CharSequence
 
- 
negateTurns a String into a regular expression pattern- Returns:
- the regular expression pattern
 
- 
getBytespublic byte[] getBytes()
- 
getBytes- Throws:
- UnsupportedEncodingException
 
 
-