Documentation

You are viewing the documentation for the 2.1.5 release in the 2.1.x series of releases. The latest stable release series is 2.4.x.

§アプリケーションのグローバル設定

§Global オブジェクト

プロジェクト内に Global オブジェクトを定義して、アプリケーションのグローバル設定をカスタマイズすることができます。このオブジェクトは、デフォルトパッケージ (無名パッケージ) 内に定義されている必要があります。

import play.api._

object Global extends GlobalSettings {

}

Tip: Global という名前のオブジェクトを使う代わりに、application.global という設定キーに GlobalSettings の実装クラスの名前を指定するという方法もあります。

§アプリケーションの開始と停止をフックする

onStartonStop メソッドをオーバーライドして、アプリケーションのライフサイクルにおけるイベント通知を受け取ることができます。

import play.api._

object Global extends GlobalSettings {

  override def onStart(app: Application) {
    Logger.info("Application has started")
  }  
  
  override def onStop(app: Application) {
    Logger.info("Application shutdown...")
  }  
    
}

§アプリケーションのエラーページを提供する

アプリケーションで例外が発生した場合、 onError が呼び出されます。デフォルトの onError は、フレームワーク標準のエラーページを出力します。

import play.api._
import play.api.mvc._
import play.api.mvc.Results._

object Global extends GlobalSettings {

  override def onError(request: RequestHeader, ex: Throwable) = {
    InternalServerError(
      views.html.errorPage(ex)
    )
  }  
    
}

§アクションが存在しない、またはバインドエラーが発生したときの処理

フレームワークがリクエストに対応する Action を見つけられなかった場合、 onHandlerNotFound が呼び出されます。

import play.api._
import play.api.mvc._
import play.api.mvc.Results._

object Global extends GlobalSettings {

  override def onHandlerNotFound(request: RequestHeader): Result = {
    NotFound(
      views.html.notFoundPage(request.path)
    )
  }  
    
}

フレームワークが受け取ったリクエストから実行すべきアクションへのルートを見つけたものの、必要なリクエストパラメータをバインドできなかった場合、 onBadRequest が呼び出されます。

import play.api._
import play.api.mvc._
import play.api.mvc.Results._

object Global extends GlobalSettings {

  override def onBadRequest(request: RequestHeader, error: String) = {
    BadRequest("Bad Request: " + error)
  }  
    
}

次ページ: リクエストインターセプター