groovy.lang
Class GString
java.lang.Object
groovy.lang.GroovyObjectSupport
groovy.lang.GString
- All Implemented Interfaces:
- Buildable, GroovyObject, Writable, java.io.Serializable, java.lang.CharSequence, java.lang.Comparable
- Direct Known Subclasses:
- GStringImpl
public abstract class GString
- extends GroovyObjectSupport
- implements java.lang.Comparable, java.lang.CharSequence, Writable, Buildable, java.io.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. The lovely name of
this class was suggested by Jules Gosnell and was such a good idea, I
couldn't resist :)
- Version:
- $Revision: 13100 $
- Author:
- James Strachan
- See Also:
- Serialized Form
Field Summary |
static GString |
EMPTY
A GString containing a single empty String and no values. |
(package private) static long |
serialVersionUID
|
private java.lang.Object[] |
values
|
Constructor Summary |
GString(java.lang.Object values)
|
GString(java.lang.Object[] values)
|
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
serialVersionUID
static final long serialVersionUID
- See Also:
- Constant Field Values
EMPTY
public static final GString EMPTY
- A GString containing a single empty String and no values.
values
private java.lang.Object[] values
GString
public GString(java.lang.Object values)
GString
public GString(java.lang.Object[] values)
getStrings
public abstract java.lang.String[] getStrings()
invokeMethod
public java.lang.Object invokeMethod(java.lang.String name,
java.lang.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.
- Specified by:
invokeMethod
in interface GroovyObject
- Overrides:
invokeMethod
in class GroovyObjectSupport
- Parameters:
name
- the name of the method to callargs
- the arguments to use for the method call
- Returns:
- the result of invoking the method
getValues
public java.lang.Object[] getValues()
plus
public GString plus(GString that)
plus
public GString plus(java.lang.String that)
getValueCount
public int getValueCount()
getValue
public java.lang.Object getValue(int idx)
toString
public java.lang.String toString()
- Specified by:
toString
in interface java.lang.CharSequence
- Overrides:
toString
in class java.lang.Object
writeTo
public java.io.Writer writeTo(java.io.Writer out)
throws java.io.IOException
- Description copied from interface:
Writable
- writes this object to the given stream
- Specified by:
writeTo
in interface Writable
- Throws:
java.io.IOException
build
public void build(GroovyObject builder)
- Specified by:
build
in interface Buildable
equals
public boolean equals(java.lang.Object that)
- Overrides:
equals
in class java.lang.Object
equals
public boolean equals(GString that)
hashCode
public int hashCode()
- Overrides:
hashCode
in class java.lang.Object
compareTo
public int compareTo(java.lang.Object that)
- Specified by:
compareTo
in interface java.lang.Comparable
charAt
public char charAt(int index)
- Specified by:
charAt
in interface java.lang.CharSequence
length
public int length()
- Specified by:
length
in interface java.lang.CharSequence
subSequence
public java.lang.CharSequence subSequence(int start,
int end)
- Specified by:
subSequence
in interface java.lang.CharSequence
negate
public java.util.regex.Pattern negate()
- Turns a String into a regular expression pattern
- Returns:
- the regular expression pattern
Copyright © ${year} The Codehaus. All Rights Reserved.