Play2.0でATNDのイベントサーチAPIを使うクラス (mutableな変数を極力使わないver)

gistfile1.scala

package com.github.daiksy.play2.ATND

import play.api.libs.ws.WS
import collection.mutable.ListBuffer
import play.api.libs.json.JsValue

/**
 * ATNDのイベントを検索し、取得する。
 * https://gist.github.com/2584254を
 * http://blog.rafaelferreira.net/2008/07/type-safe-builder-pattern-in-scala.html を参考に
 * 極力mutableな変数を使わないように書き換えてみた。
 *
 * ・使い方
 * メソッドチェーンで検索条件を指定し、executeを実行する。
 *
 * ex) TwitterIDに"daiksy"を指定して結果を15件取得する場合
 *   import com.github.daiksy.play2.ATND.EventSearch.searcher
 *   val ret = searcher.twitterId("daiksy").count(15).execute
 *
 * 取得結果は、取得件数、対象イベントの総件数、イベント詳細[List]で取得されます。
 *
 *  ret.resultReturned //イベント件数
 *  ret.resultAvailable // 対象の総イベント件数
 *  ret.events //イベントの詳細
 *
 * ex) 取得してきたイベントのタイトルを抽出する場合。
 *  ret.events.map(_.title)
 *
 *  取得されるイベントデータの項目はATND APIのリファレンスに準じています。
 *   http://api.atnd.org/#events-response
 *
 */
object EventSearch {
  class Searcher(
      _eventId: Option[String],
      _keywordAnd: Option[String],
      _keywordOr: Option[String],
      _ym: Option[String],
      _ymd: Option[String],
      _userId: Option[String],
      _nickname: Option[String],
      _twitterId: Option[String],
      _ownerId: Option[String],
      _ownerNickname: Option[String],
      _ownerTwitterId: Option[String],
      _start: Option[Int],
      _count: Option[Int]
  ) {

    /** 検索結果を返却するためのcase class */
    case class EventSearchResult(
                  /** 実際に取得したイベントデータの件数 */
                  resultReturned: Int,
                  /** 指定した条件で存在するイベントデータの総件数 */
                  resultAvailable: Int,
                  /** 取得したイベントデータ */
                  events: List[Events]
                                  )
    /** イベントの詳細データ */
    case class Events(
                  /** イベントID */
                  eventId: Int,
                  /**　タイトル */
                  title: String,
                  /** キャッチ */
                  catchCopy: Option[String],
                  /** 概要 */
                  description: Option[String],
                  /** ATNDのURL */
                  eventUrl: Option[String],
                  /** イベント開始日時 */
                  startedAt: Option[String],
                  /** イベント終了日時 */
                  endedAt: Option[String],
                  /** 参考URL */
                  url: Option[String],
                  /** 定員 */
                  limit: Option[Int],
                  /** 開催場所 */
                  address: Option[String],
                  /** 開催会場 */
                  place: Option[String],
                  /** 開催会場の緯度 */
                  lat: Option[String],
                  /** 開催会場の軽度 */
                  lon: Option[String],
                  /** 主催者のID */
                  ownerId: Option[Int],
                  /** 主催者のニックネーム */
                  ownerNickname: Option[String],
                  /** 主催者のTwitterId */
                  ownerTwitterId: Option[String],
                  /** 参加者 */
                  accepted: Option[Int],
                  /** 補欠者 */
                  waiting: Option[Int],
                  /** 更新日時 */
                  updatedAt: Option[String]
                  )

    /**
     * イベント毎に割り当てられた番号で検索します。複数指定可能です(カンマ区切り)
     */
    def eventId(value: String) = new Searcher(Some(value), _keywordAnd, _keywordOr,  _ym, _ymd, _userId, _nickname, _twitterId, _ownerId, _ownerNickname, _ownerTwitterId, _start, _count)

    /**
     * イベントのタイトル、キャッチ、概要、住所をAND条件部分一致で検索します。複数指定可能です(カンマ区切り)
     */
    def keywordAnd(value: String) = new Searcher(_eventId, Some(value), _keywordOr,  _ym, _ymd, _userId, _nickname, _twitterId, _ownerId, _ownerNickname, _ownerTwitterId, _start, _count)

    /**
     *　イベントのタイトル、キャッチ、概要、住所をOR条件部分一致で検索します。複数指定可能です(カンマ区切り)
     */
    def keywordOr(value: String) = new Searcher(_eventId, _keywordAnd, Some(value),  _ym, _ymd, _userId, _nickname, _twitterId, _ownerId, _ownerNickname, _ownerTwitterId, _start, _count)

    /**
     *　指定した年月に開催されているイベントを検索します。複数指定可能です(カンマ区切り)
     *  ex) 201204
     */
    def ym(value: String) = new Searcher(_eventId, _keywordAnd, _keywordOr,  Some(value), _ymd, _userId, _nickname, _twitterId, _ownerId, _ownerNickname, _ownerTwitterId, _start, _count)

    /**
     * 指定した年月日に開催されているイベントを検索します。複数指定可能です(カンマ区切り)
     * ex) 20120501
     */
    def ymd(value: String) = new Searcher(_eventId, _keywordAnd, _keywordOr,  _ym, Some(value), _userId, _nickname, _twitterId, _ownerId, _ownerNickname, _ownerTwitterId, _start, _count)

    /**
     * 指定したユーザIDのユーザが参加しているイベントを検索します。複数指定可能です(カンマ区切り)
     */
    def userId(value: String) = new Searcher(_eventId, _keywordAnd, _keywordOr,  _ym, _ymd, Some(value), _nickname, _twitterId, _ownerId, _ownerNickname, _ownerTwitterId, _start, _count)

    /**
     * 指定したニックネームのユーザが参加しているイベントを検索します。複数指定可能です(カンマ区切り)
     */
    def nickname(value: String) = new Searcher(_eventId, _keywordAnd, _keywordOr,  _ym, _ymd, _userId, Some(value), _twitterId, _ownerId, _ownerNickname, _ownerTwitterId, _start, _count)

    /**
     *  指定したTwitter IDのユーザが参加しているイベントを検索します。複数指定可能です(カンマ区切り)
     */
    def twitterId(value: String) = new Searcher(_eventId, _keywordAnd, _keywordOr,  _ym, _ymd, _userId, _nickname, Some(value), _ownerId, _ownerNickname, _ownerTwitterId, _start, _count)

    /**
     * 指定したユーザIDのユーザが主催しているイベントを検索します。複数指定可能です(カンマ区切り)
     */
    def ownerId(value: String) = new Searcher(_eventId, _keywordAnd, _keywordOr,  _ym, _ymd, _userId, _nickname, _twitterId, Some(value), _ownerNickname, _ownerTwitterId, _start, _count)

    /**
     * 指定したニックネームのユーザが主催しているイベントを検索します。複数指定可能です(カンマ区切り)
     */
    def ownerNickname(value: String) = new Searcher(_eventId, _keywordAnd, _keywordOr,  _ym, _ymd, _userId, _nickname, _twitterId, _ownerId, Some(value), _ownerTwitterId, _start, _count)

    /**
     * 指定したtwitter IDのユーザが主催しているイベントを検索します。複数指定可能です(カンマ区切り)
     */
    def ownerTwitterId(value: String) = new Searcher(_eventId, _keywordAnd, _keywordOr,  _ym, _ymd, _userId, _nickname, _twitterId, _ownerId, _ownerNickname, Some(value), _start, _count)

    /**
     * 検索結果の何件目から出力するかを指定します
     * ※初期値:1
     */
    def start(value: Int) = new Searcher(_eventId, _keywordAnd, _keywordOr,  _ym, _ymd, _userId, _nickname, _twitterId, _ownerId, _ownerNickname, _ownerTwitterId, Some(value), _count)

    /**
     * 検索結果の最大出力データ数を指定します
     * ※初期値:10, 最小値:1, 最大値:100
     */
    def count(value: Int) = new Searcher(_eventId, _keywordAnd, _keywordOr,  _ym, _ymd, _userId, _nickname, _twitterId, _ownerId, _ownerNickname, _ownerTwitterId, _start, Some(value))

    /** 検索実行 */
    def execute = {
      requestEventSearchApi
    }

    /** URLパラメータを組み立てて検索APIをコールし、結果をcase classにセットして返却するよ。 */
    private def requestEventSearchApi = {

      val apiUrl = "http://api.atnd.org/events/"

      val paramBuilder = new ListBuffer[String]

      _eventId.foreach(_.split(",").foreach(paramBuilder += "event_id=" + _))
      _keywordAnd.foreach(_.split(",").foreach(paramBuilder += "keyword=" + _))
      _keywordOr.foreach(_.split(",").foreach(paramBuilder += "keyword_or=" + _))
      _ym.foreach(_.split(",").foreach(paramBuilder += "ym=" + _))
      _ymd.foreach(_.split(",").foreach(paramBuilder += "ymd=" + _))
      _userId.foreach(_.split(",").foreach(paramBuilder += "user_id=" + _))
      _nickname.foreach(_.split(",").foreach(paramBuilder += "nickname=" + _))
      _twitterId.foreach(_.split(",").foreach(paramBuilder += "twitter_id=" + _))
      _ownerId.foreach(_.split(",").foreach(paramBuilder += "owner_id=" + _))
      _ownerNickname.foreach(_.split(",").foreach(paramBuilder += "owner_nickname=" + _))
      _ownerTwitterId.foreach(_.split(",").foreach(paramBuilder += "owner_twitter_id=" + _))
      _start.foreach(paramBuilder += "start=" + _.toString)
      _count.foreach(paramBuilder += "count=" + _.toString)

      paramBuilder += "format=json"

      val urlParam = paramBuilder.result.mkString("&")

      val url = if (urlParam != "") {
        apiUrl + "?" + urlParam
      } else {
        apiUrl
      }

      val ret = WS.url(url).get().value.get.json

      EventSearchResult(
        (ret \ "results_returned").as[Int],
        (ret \ "results_available").as[Int],
        (ret \ "events").asOpt[List[JsValue]].getOrElse(Nil).map { e =>
          Events(
            (e \ "event_id").as[Int],
            (e \ "title").as[String],
            (e \ "catch").asOpt[String],
            (e \ "description").asOpt[String],
            (e \ "event_url").asOpt[String],
            (e \ "started_at").asOpt[String],
            (e \ "ended_at").asOpt[String],
            (e \ "url").asOpt[String],
            (e \ "limit").asOpt[Int],
            (e \ "address").asOpt[String],
            (e \ "place").asOpt[String],
            (e \ "lat").asOpt[String],
            (e \ "lon").asOpt[String],
            (e \ "owner_id").asOpt[Int],
            (e \ "owner_nickname").asOpt[String],
            (e \ "owner_twitter_id").asOpt[String],
            (e \ "accepted").asOpt[Int],
            (e \ "waiting").asOpt[Int],
            (e \ "updated_at").asOpt[String]
          )
        }
      )
    }
  }

  def searcher = new Searcher(None, None, None, None, None, None, None, None, None, None, None, None, None)

}