面向 Java 开发人员的 Scala 指南 增强 Scitter 库-3

look_w

连接（到朋友）Twitter API 表明，friends_timeline API 调用 “返回认证用户和该用户的朋友发表的最近 20 条状态”。（它还指出，对于直接从 Twitter Web 站点使用 Twitter 的用户，“这相当于 Web 上的 ‘/home’”。）对于任何 Twitter API 来说，这是非常基本的要求，所以让我们将它添加到 Scitter 类中。之所以将它添加到类而不是对象中，是因为正如文档中指出的那样，这是以验证用户的身份做的事情，而我已经决定归入 Scitter 类，而不是 Scitter 对象。
但是，这里我们碰到一块绊脚石：friends_timeline 调用接受一组 “可选参数”，包括 since_id、max_id、count 和 page，以控制返回的结果。这是一项比较复杂的操作，因为 Scala 不像其他语言（例如 Groovy、JRuby 或 JavaScript）那样原生地支持 “可选参数” 的思想，但是我们首先来处理简单的东西 — 我们来创建一个 friendsTimeline 方法，该方法只执行一般的、非参数化的调用：
清单 6.“告诉我你身边的朋友是怎样的...”

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28

package com.tedneward.scitter {   class Scitter   {     def friendsTimeline : List[Status] =     {       val (statusCode, statusBody) =        Scitter.execute("http://twitter.com/statuses/friends_timeline.xml",                         username, password)       if (statusCode == 200)       {         val responseXML = XML.loadString(statusBody)         val statusListBuffer = new ListBuffer[Status]         for (n <- (responseXML \\ "status").elements)           statusListBuffer += (Status.fromXml(n))                   statusListBuffer.toList       }       else       {         Nil       }     }   } }

到目前为止，一切良好。用于测试的相应方法看上去如下所示：
清单 7. “我能判断您是怎样的人”（Miguel de Cervantes）

1 2 3 4 5 6 7 8 9 10 11 12 13 14

package com.tedneward.scitter.test {   class ScitterTests   {     // ...           @Test def scitterFriendsTimeline =     {       val scitter = new Scitter(testUser, testPassword)       val result = scitter.friendsTimeline       assertTrue(result.length > 0)     }   } }

好极了。看上去就像 Scitter 对象中的 publicTimeline() 方法，并且行为也几乎完全相同。
将来……在撰写本文时，我向 Programming in Scala 的作者 — Bill Venners、Martin Odersky 和 Lex Spoon — 询问他们认为最好和/或最地道的处理可选参数的方式是什么，在随后的讨论中，Martin 提到这正是他们正在研究的领域，最可能应用于 2.8 发行版。最终将采取 “默认参数” 还是 “可选参数” 的形式现在还不清楚，至少对我来说是这样，但是如果您对这个领域特别感兴趣，那么现在正好可以在邮件列表上提一提。

对于我们来说，那些可选参数仍然有问题。因为 Scala 并没有可选参数这样的语言特性，乍一看来，惟一的选择就是完整地创建重载的 friendsTimeline() 方法，让该方法带有一定数量的参数。
幸运的是，还有一种更好的方式，即通过一种有趣的方式将 Scala 的两个语言特性（有一个特性我还没有提到过） — case 类和 “重复参数” 结合起来（见清单 8）：
清单 8. “我有多爱你？……”

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55

package com.tedneward.scitter {   // ...       abstract class OptionalParam   case class Id(id : String) extends OptionalParam   case class UserId(id : Long) extends OptionalParam   case class Since(since_id : Long) extends OptionalParam   case class Max(max_id : Long) extends OptionalParam   case class Count(count : Int) extends OptionalParam   case class Page(page : Int) extends OptionalParam       class Scitter(username : String, password : String)   {     // ...           def friendsTimeline(options : OptionalParam*) : List[Status] =     {       val optionsStr =         new StringBuffer("http://twitter.com/statuses/friends_timeline.xml?")       for (option <- options)       {         option match         {           case Since(since_id) =>             optionsStr.append("since_id=" + since_id.toString() + "&")           case Max(max_id) =>             optionsStr.append("max_id=" + max_id.toString() + "&")           case Count(count) =>             optionsStr.append("count=" + count.toString() + "&")           case Page(page) =>             optionsStr.append("page=" + page.toString() + "&")         }       }              val (statusCode, statusBody) =         Scitter.execute(optionsStr.toString(), username, password)       if (statusCode == 200)       {         val responseXML = XML.loadString(statusBody)         val statusListBuffer = new ListBuffer[Status]         for (n <- (responseXML \\ "status").elements)           statusListBuffer += (Status.fromXml(n))                   statusListBuffer.toList       }       else       {         Nil       }     }   } }

看到标在选项参数后面的 * 吗？这表明该参数实际上是一个参数序列，这类似于 Java 5 中的 varargs 结构。和 varargs 一样，传递的参数数量可以像前面那样为 0（不过，我们将需要回到测试代码，向 friendsTimeline 调用增加一对括号，否则编译器无法作出判断：是调用不带参数的方法，还是出于部分应用之类的目的而调用该方法）；我们还可以开始传递那些 case 类型，如下面的清单所示：
清单 9. “……听我细细说”（William Shakespeare）

1 2 3 4 5 6 7 8 9 10 11 12 13 14

package com.tedneward.scitter.test {   class ScitterTests   {     // ...           @Test def scitterFriendsTimelineWithCount =     {       val scitter = new Scitter(testUser, testPassword)       val result = scitter.friendsTimeline(Count(5))       assertTrue(result.length == 5)     }   } }

当然，总是存在这样的可能性：客户机传入古怪的参数序列，例如  friendsTimeline(Count(5), Count(6), Count(7))，但是在这里，我们只是将列表传递给 Twitter（希望它们的错误处理足够强大，能够只采用指定的最后那个参数）。当然，如果真的担心这一点，也很容易在构造发送到 Twitter 的 URL 之前，从头至尾检查重复参数列表，并采用指定的每种参数的最后一个参数。不过，后果自负。