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>