Groovy Tip 34 Groovy语言的here-docs
Groovy Tip 34 Groovy语言的here-docs
Groovy语言对Java字符串的改变，除了String对象的很多新功能，最大的好处就是引入了Gstring的概念，这些都在前面的文字中有过详细的阐述。除此之外，Groovy语言还引入了here-docs的概念，这就是本篇将要谈到的。
简单来说，here-docs就是用来解决字符串换行的问题。
在Java语言中，字符串换行有两种解决方法。
一种是通过"+"号连接，这种本身对字符串没有换行，因为字符串本身太长，通过换行来方便我们的阅读。这种场合最常用的是sql语句。如下：
private static final String sql = "select t.qdbid as itemdbid, "+
"t.itemtype as itemlev, "+
"t.itemname as itemname, "+
"t.sourceid as parentid "+
"from t_sp_qcddvbase t "+
"where t.yearmonth=? and "+
"t.isview LIKE '%Y%' "+
"order by t.itemtype, t.qdbid";
我们可能都写过了类似于上面的sql语句，在上面的语句中，为了方便我们的阅读，我们不得不为了一句sql语句，输入多个"+"号，还有多对引号。这大大的降低了我们的编码效率。同时，由于每一行的字符串都需要引号和"+"号连接，所以阅读性也并不是太好。
在Groovy语言中，我们引入了here-docs的概念，所谓"here-docs"，在Groovy语言中，就是由三对双引号引起来的，可以换行的字符串。例如，使用"here-docs"，我们就可以把上面的sql语句写成下面的样子：
private static final String sql = """select t.qdbid as itemdbid,
t.itemtype as itemlev,
t.itemname as itemname,
t.sourceid as parentid
from t_sp_qcddvbase t
where t.yearmonth=? and
t.isview LIKE '%Y%'
order by t.itemtype, t.qdbid""";
可以看到，使用"here-docs"的阅读性就比上面的Java语言的方式要强得多。而且编码也方便了很多。
同时，"here-docs"中的换行也是字符串中的真正换行。曾经，我们在Java语言中要用到字符串的换行，就必须借助于"\n"字符串。比如，一个网上书店的通知单的编码可能是如下的样子：
String name = "Wallace";
String sex = "male";
String[] books = new String[]{"Groovy in action","Grails in action"};
String time = "2009-05-20";
StringBuffer sb = new StringBuffer();
sb.append("Dear ");
if("male".equalsIgnoreCase(sex))
{
sb.append("Mr.");
}
else if("female".equalsIgnoreCase(sex))
{
sb.append("Ms.");
}
sb.append(name).append(",\n ");
sb.append("You has bought ");
sb.append(books.length).append(" books: ");
for(int i=0;i<books.length;i++)
{
sb.append(books[i]).append(",");
}
sb.append(" You will receive it at ").append(time);
sb.append("\n");
sb.append(" Thank You!");
System.out.println(sb.toString());
运行结果为：
Dear Mr.Wallace,
You has bought 2 books: Groovy in action,Grails in action, You will receive it at 2009-05-20
Thank You!
可以看到，编码十分的繁琐，代码的阅读性也很差。如果使用"here-docs"的话，编码将会是如下的样子：
String name = "Wallace"
String sex = "male"
String[] books = ["Groovy in action","Grails in action"]
String time = "2009-05-20"
def mrms = sex=='male'?'Mr':'Ms'
def bookNames = books.join(',')
def letter =
"""Dear ${mrms}.${name},
You has bought ${books.size()} books: ${bookNames}, You will receive it at $time
Thank You!"""
println letter
运行结果为：
Dear Mr.Wallace,
You has bought 2 books: Groovy in action,Grails in action, You will receive it at 2009-05-20
Thank You!
可以看到，由于"here-docs"也支持Gstring，所以使用"here-docs"对多行字符串进行编码，无论是代码量上，还是可读性上，都强了很多。
最后，值得注意的是，由于"here-docs"也是字符串，同样可以进行字符串的各种操作，请看如下的一个生成html标签的代码：
def list = ['Groovy in action','Grails in action']
def name = 'select1'
def select =
"""<select name="${name}">
"""
StringBuffer sb = new StringBuffer()
list.each{
sb <<" <option>${it}</option>\n"
}
select = select+sb.toString()
select = select+
"""
</select>"""
println select
里面既有"here-doc"，又有双引号的字符串加上Gstring，然后再把它们连接起来，整个编码显得十分的灵活。
运行结果为：
<select name="select1">
<option>Groovy in action</option>
<option>Grails in action</option>
</select>