日本综合一区二区|亚洲中文天堂综合|日韩欧美自拍一区|男女精品天堂一区|欧美自拍第6页亚洲成人精品一区|亚洲黄色天堂一区二区成人|超碰91偷拍第一页|日韩av夜夜嗨中文字幕|久久蜜综合视频官网|精美人妻一区二区三区

RELATEED CONSULTING
相關(guān)咨詢
選擇下列產(chǎn)品馬上在線溝通
服務(wù)時間:8:30-17:00
你可能遇到了下面的問題
關(guān)閉右側(cè)工具欄

新聞中心

這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
PlayFramework介紹:控制器層

業(yè)務(wù)邏輯代碼通常位于模型(model)層??蛻舳耍ū热鐬g覽器)無法直接調(diào)用其中的代碼,所以模型對象提供的功能,必須作為資源以URI方式暴露給外部。

創(chuàng)新互聯(lián)建站專注于金口河網(wǎng)站建設(shè)服務(wù)及定制,我們擁有豐富的企業(yè)做網(wǎng)站經(jīng)驗。 熱誠為您提供金口河營銷型網(wǎng)站建設(shè),金口河網(wǎng)站制作、金口河網(wǎng)頁設(shè)計、金口河網(wǎng)站官網(wǎng)定制、成都微信小程序服務(wù),打造金口河網(wǎng)絡(luò)公司原創(chuàng)品牌,更為您提供金口河網(wǎng)站排名全網(wǎng)營銷落地服務(wù)。

客戶端使用HTTP協(xié)議來操作這些資源,從而調(diào)用了內(nèi)部的業(yè)務(wù)邏輯。但是,這種從資源到模型之間的映射是單向的:我們可以根據(jù)需要提供不同粒度的資源,可以虛擬出一些資源,還可以給某些資源起別名...

Controller層就是專門做這件事的:在模型層與傳輸層之間搭起一座橋梁。它使用與模型層同一種語言,以便訪問和修改模型對象,但同時它又跟HTTP接口一樣,是面向請求(Request)和響應(yīng)(Response)的。

Controller層減少了HTTP與模型層之間的“阻抗不匹配”。

注意

不同的模型方案使用了不同的策略。有一些可以讓我們直接訪問模型對象,比如EJB或者Corba協(xié)議,它們使用RPC(遠(yuǎn)程過程調(diào)用)。這種交互方式與web很難兼容。

另一些技術(shù)如SOAP,嘗試通過Web來訪問模型層,但它也是一種PRC風(fēng)格的協(xié)議,只是以HTTP為傳輸協(xié)議。它也不是一種程序協(xié)議。

Web的理念在根本上與面向?qū)ο蟛煌?,所以我們需要一個層來協(xié)調(diào)。


Controller綜述

一個Controller就是一個位于 controllers 包中的類,其繼承于 play.mvc.Controller :

示例:

 
 
 
  1. package controllers;
  2. import models.Client;
  3. import play.mvc.Controller;
  4. public class Clients extends Controller {
  5. public static void show(Long id) {
  6. Client client = Client.findById(id);
  7. render(client);
  8. }
  9. public static void delete(Long id) {
  10. Client client = Client.findById(id);
  11. client.delete();
  12. }
  13. }

Controller中每一個public static方法都被稱為一個action。它的簽名形如:

 
 
 
  1. public static void action_name(params...);

你可以在action的方法簽名中定義各種參數(shù)。Play會自動從相應(yīng)的HTTP參數(shù)中,取出對應(yīng)的值賦過去(并進行恰當(dāng)?shù)霓D(zhuǎn)換),這一點非常方便。

通常一個action不需要返回值。當(dāng)我們在action中調(diào)用了一個能產(chǎn)生“結(jié)果”的方法后,action就退出了。在本例中, render(…) 就是一個顯示一個模板的可產(chǎn)生結(jié)果的方法。


獲取HTTP參數(shù)

HTTP請求中可包含數(shù)據(jù),這些數(shù)據(jù)可位于:

  • URI路徑中: 如 /clients/1541, 1541就是一個動態(tài)產(chǎn)生的參數(shù).
  • Query String: /clients?id=1541.
  • request body: 如果提交了一個HTML表彰,將request body中將包含以 x-www-urlform-encoded 方式轉(zhuǎn)換過的數(shù)據(jù)。

對于這些情況,Play都可以取得數(shù)據(jù),并生成一個 Map 。Key是參數(shù)名,來源于:

  • 在conf/routes文件中定義的規(guī)則中的動態(tài)參數(shù)名
  • Query String中的name=value
  • 通過表單提交的數(shù)據(jù)的name.

使用參數(shù)map

在所有的Controller類中都可以直接使用 params 這個對象。它是在 play.mvc.Controller 中定義的。這個對象中,包含了當(dāng)前請求的所有數(shù)據(jù)。

示例:

 
 
 
  1. public static void show() {
  2. String id = params.get("id");
  3. String[] names = params.getAll("names");
  4. }

你還可以轉(zhuǎn)換參數(shù)值的類型:

 
 
 
  1. public static void show() {
  2. Long id = params.get("id", Long.class);
  3. }

其實,還有更好的辦法來轉(zhuǎn)換 ????

直接利用action方法的參數(shù)類型定義來轉(zhuǎn)換

我們可以直接從action方法的參數(shù)定義中,直接拿到對應(yīng)的參數(shù)值。方法中的參數(shù)名必須跟http傳過來的參數(shù)名相同。

比如,對于如下的URL:

 
 
 
  1. /clients?id=1451

我們可以定義一個包含 id 參數(shù)的action:

 
 
 
  1. public static void show(String id) {
  2. System.out.println(id); 
  3. }

我們還可以使用其它的類型,play會自動進行轉(zhuǎn)換:

 
 
 
  1. public static void show(Long id) {
  2. System.out.println(id); 
  3. }

如果同一個參數(shù)有多個值,還可以把它聲明為數(shù)組:

 
 
 
  1. public static void show(Long[] id) {
  2. for(String anId : id) {
  3. System.out.println(anid); 
  4. }
  5. }

甚至集合:

 
 
 
  1. public static void show(List id) {
  2. for(String anId : id) {
  3. System.out.println(anid); 
  4. }
  5. }

這一功能非常方便,其它的框架都很少提供(有一些提供了,但要求每個參數(shù)前都要加一個annotation,不太方便)。

內(nèi)部原理是,Play會對每個action進行掃描,得到其參數(shù)信息(包括類型與參數(shù)名)。能過反射很容易得到參數(shù)類型,但得不到參數(shù)名,因為javac在編譯java代碼時,會忽略參數(shù)名信息。而Play內(nèi)置了eclipse的編譯器,并在編譯時打開相關(guān)選項以記錄參數(shù)名信息,所以才能成功取到。

異  常
 

如果action方法中定義的某個參數(shù),在http請求中找不到對應(yīng)的數(shù)據(jù),則將會把它設(shè)為默認(rèn)值(對象類型設(shè)為null,基礎(chǔ)數(shù)字類型設(shè)為0,boolean類型設(shè)為false)。如果找到了,但是其值無法轉(zhuǎn)換為指定的Java類型,則會將這一錯誤記錄在validation對象中,并使用默認(rèn)值代替。


HTTP to Java 高級綁定

簡單類型

Java中所有基礎(chǔ)和常用類型,都可以自動綁定:

int, long, boolean, char, byte, float, double, Integer, Long, Boolean, Char, String, Byte, Float, Double.

注意如果某個參數(shù)HTTP請求中沒有提供,或者自動轉(zhuǎn)換失敗,則Object類型會被設(shè)為null,而基礎(chǔ)類型會被設(shè)為它們的默認(rèn)值。

Date

如果一個日期格式如下,則它可以自動轉(zhuǎn)換并綁定:

  • yyyy-MM-dd’T’hh:mm:ss’Z' // ISO8601 + timezone
  • yyyy-MM-dd’T’hh:mm:ss" // ISO8601
  • yyyy-MM-dd
  • yyyyMMdd’T’hhmmss
  • yyyyMMddhhmmss
  • dd'/‘MM’/'yyyy
  • dd-MM-yyyy
  • ddMMyyyy
  • MMddyy
  • MM-dd-yy
  • MM'/‘dd’/'yy

使用@As注解,我們可以指定日期格式。

例如:

 
 
 
  1. archives?from=21/12/1980
 
 
 
  1. public static void articlesSince(@As("dd/MM/yyyy") Date from) {
  2. List
     articles = Article.findBy("date >= ?", from);
  3. render(articles);
  4. }

我們可還以對不同的語種定義不同的格式,例如:

 
 
 
  1. public static void articlesSince(@As(lang={"fr,de","*"}, 
  2. value={"dd-MM-yyyy","MM-dd-yyyy"}) Date from) {
  3. List
     articles = Article.findBy("date >= ?", from);
  4. render(articles);
  5. }

在這個例子中,我們將法國和德國的日期定義為 dd-MM-yyyy ,其它都為 MM-dd-yyyy. 注意語種可用逗號分隔。注意參數(shù)lang的個數(shù)必須與value的個數(shù)相等。

如果沒有使用@As注解,則Play將使用你的區(qū)域?qū)?yīng)的默認(rèn)日期格式。我們可在“conf/application.conf”中使用“date.format”為key來配置該格式.

日歷(Calendar)

Calendar的綁定與date幾乎完全一樣,除了play將會根據(jù)你的區(qū)域設(shè)置選擇相應(yīng)的Calendar對象。@Bind注解也可在這里使用。

文件(File)

在Play中處理文件上傳非常簡單。使用經(jīng) multipart/form-data 編碼的請求將文件post到服務(wù)器端,同時使用 java.io.File 來獲取文件:

 
 
 
  1. public static void create(String comment, File attachment) {
  2. String s3Key = S3.post(attachment);
  3. Document doc = new Document(comment, s3Key);
  4. doc.save();
  5. show(doc.id);
  6. }

Play將先取得上傳的文件,保存在臨時目錄下,并使用上傳的文件名。當(dāng)這個request結(jié)束后,該文件將被刪除,所以我們必須將它拷貝到一個安全的目錄中,否則就找不到了。

上傳的文件的MIME類型通常應(yīng)該在HTTP request的head中,以 Content-type 方式指定。但當(dāng)我們通過瀏覽器上傳文件時,一些不常見類型的文件不會指定。在這種情況下,我們可以使用 play.libs.MimeTypes 類將該文件的后綴名映射到一個MIME類型上。

 
 
 
  1. String mimeType = MimeTypes.getContentType(attachment.getName()); 

play.libs.MimeTypes 類在 $PLAY_HOME/framework/src/play/libs/mime-types.properties 中以文件的后綴為來尋找對應(yīng)的MIME類型。

你也可以 通過 自定義MIME類型 來增加你自己的類型。

數(shù)組或集合

所有支持的類型,都可以通過數(shù)組或集合的形式取得:

 
 
 
  1. public static void show(Long[] id) {
  2. }

或者:

 
 
 
  1. public static void show(List id) {
  2. }

或者:

 
 
 
  1. public static void show(Set id) {
  2. }

Play還可以處理像Map這樣的綁定:

 
 
 
  1. public static void show(Map client) {
  2. }

一個如下的query string:

 
 
 
  1. ?client.name=John&client.phone=111-1111&client.phone=222-2222

將會把變量client綁定到一個含有兩個元素的map上。第一個元素的key是 name ,值是 John ,第二個key是 phone 值是 111-1111, 222-2222.

POJO對象綁定

Play還可以使用簡單的命名約定將參數(shù)綁定到一個pojo對象上。

 
 
 
  1. public static void create(Client client ) {
  2. client.save();
  3. show(client);
  4. }

可以使用像下面這樣的query string,來調(diào)用該action以創(chuàng)建一個client對象:

 
 
 
  1. ?client.name=Zenexity&client.email=contact@zenexity.fr

Play創(chuàng)建一個Client的實例,然后將HTTP參數(shù)中與Client對象屬性同名的值賦過去。無法處理的參數(shù)將被安全的忽略,類型不匹配的也將安全忽略。

參數(shù)綁定是遞歸的,我們可以通過query string來創(chuàng)建一個完全的對象圖:

 
 
 
  1. ?client.name=Zenexity
  2. &client.address.street=64+rue+taitbout
  3. &client.address.zip=75009
  4. &client.address.country=France

如果我們想更新一列對象,我們可以使用數(shù)組形式來引用對象的ID。舉例來說,假設(shè)Client模型有一列Customer模型,并聲明為 List customers 形式。為了更新這一列Customers,我們應(yīng)該提供一個如下的query string:

 
 
 
  1. ?client.customers[0].id=123
  2. &client.customers[1].id=456
  3. &client.customers[2].id=789

JPA對象綁定

我們可以將一個JPA對象與HTTP自動綁定起來。

我們可以在HTTP參數(shù)中提供 user.id 字段。當(dāng)Play發(fā)現(xiàn)這個字段時,它會先到數(shù)據(jù)庫中取出相應(yīng)的實例,然后把HTTP請求中其它的參數(shù)賦過去。所以我們可以直接save它。

 
 
 
  1. public static void save(User user) {
  2. user.save(); // ok with 1.0.1
  3. }

我們可以使用同樣的方式來更新完整的對象圖,但是必須對每一個子對象提供ID:

 
 
 
  1. user.id = 1
  2. &user.name=morten
  3. &user.address.id=34
  4. &user.address.street=MyStreet 

自定義綁定

綁定系統(tǒng)還支持自定義。

@play.data.binding.As

首先要講的是@play.data.binding.As這個新注解,使用它,我們可以配置一個綁定??聪旅娴睦?,我們使用它來指定一個Date的格式(該格式將被 DateBinder 使用):

 
 
 
  1. public static void update(@As("dd/MM/yyyy") Date updatedAt) {
  2. }

@As注解同樣支持國際化,我們可以這樣使用:

 
 
 
  1. public static void update(
  2. @As(
  3. lang={"fr,de","en","*"},
  4. value={"dd/MM/yyyy","dd-MM-yyyy","MM-dd-yy"}
  5. )
  6. Date updatedAt
  7. ) {
  8. }

@As注解可以與所有支持它的binder一起使用,包括你自己的定義的。例如,使用 ListBinder:

 
 
 
  1. public static void update(@As(",") List items) {
  2. }

它將會把一個以逗號分隔的字符串綁定到一個 List 上。

@play.data.binding.NoBinding

新的@play.data.binding.NoBinding注解允許我們定義一些“不應(yīng)該被綁定”的字段,以防出現(xiàn)安全問題。例如:

 
 
 
  1. public class User extends Model {
  2. @NoBinding("profile") public boolean isAdmin;
  3. @As("dd, MM yyyy") Date birthDate;
  4. public String name;
  5. }
  6. public static void editProfile(@As("profile") User user) {
  7. }

在這種情況下, 在 editProfile action中,就算某個居心不良的用戶通過偽造請求提交了一個包含 user.isAdmin=true 的字段, isAdmin 字段也不會被綁定.

play.data.binding.TypeBinder

@As注解同樣允許我們自定義一個完整的binder. 一個自定義的binder是 TypeBinder 的子類,我們可以在自己的項目中定義它。例如:

 
 
 
  1. public class MyCustomStringBinder implements TypeBinder {
  2. public Object bind(String name, Annotation[] anns, String value, Class clazz) { return "!!"; } }

我們可以在任意一個action中使用它:

 
 
 
  1. public static void anyAction(@As(binder=MyCustomStringBinder.class) 
  2. String name) {
  3. }

@play.data.binding.Global

我們還可以自定義一個全局的binder來處理某一個特定的類型。比如,我們給 java.awt.Point 類定義了一個這樣的binder:

 
 
 
  1. @Global
  2. public class PointBinder implements TypeBinder {
  3. public Object bind(String name, Annotation[] anns, String value, Class class) {
  4. String[] values = value.split(“,”);
  5. return new Point( Integer.parseInt(values0), Integer.parseInt(values1) );
  6.  }
  7.  }

你可以看到這個全局binder是一個典型的binder,只是使用了*@play.data.binding.Global*注解。我們在外部模塊中定義這種binder,以在不同的項目中復(fù)用。

結(jié)果類型

一個action方法必須產(chǎn)生一個HTTP響應(yīng)。最簡單的方式就是生成一個Result對象。一旦某一個Result對象生成,該方法將立刻返回(后面的代碼將不會被執(zhí)行)。

舉例:

 
 
 
  1. public static void show(Long id) {
  2. Client client = Client.findById(id);
  3. render(client);
  4. System.out.println("This message will never be displayed !");
  5. }

render(…) 方法產(chǎn)生了一個Result對象,后面的代碼都不會被執(zhí)行。

返回一些文本內(nèi)容

renderText(…) 方法將產(chǎn)生一個簡單的Result事件,該事件將直接向HTTP Response中寫入一些文本數(shù)據(jù)。

舉例:

 
 
 
  1. public static void countUnreadMessages() {
  2. Integer unreadMessages = MessagesBox.countUnreadMessages();
  3. renderText(unreadMessages);
  4. }

你還可以使用Java的標(biāo)準(zhǔn)格式化語法來格式化文本信息:

 
 
 
  1. public static void countUnreadMessages() {
  2. Integer unreadMessages = MessagesBox.countUnreadMessages();
  3. renderText("There are %s unread messages", unreadMessages);
  4. }

返回二進制內(nèi)容

為了處理如 存儲在服務(wù)器上的文件 這樣的二進制數(shù)據(jù),我們可使用 renderBinary 方法。例如,如果我們有一個 User 模型,它有一個 play.db.jpa.Blob photo 屬性, 我們可以使用以下方式使用保存的MIME類型向客戶端發(fā)送圖片數(shù)據(jù):

 
 
 
  1. public static void userPhoto(long id) { 
  2. final User user = User.findById(id); 
  3. response.setContentTypeIfNotSet(user.photo.type());
  4. java.io.InputStream binaryData = user.photo.get();
  5. renderBinary(binaryData);

把文件當(dāng)作附件下載

我們可以通過設(shè)置HTTP頭,來指導(dǎo)瀏覽器把二進制數(shù)據(jù)當(dāng)作“附件”來保存。我們只需要在 renderBinary 方法中傳入一個文件名即可。Play會自動在響應(yīng)頭中把文件名設(shè)給 Content-Disposition 。舉例來說,前面例子中的 User 模型有一個 photoFileName 屬性:

 
 
 
  1. renderBinary(binaryData, user.photoFileName); 

執(zhí)行一個模板

如果需要產(chǎn)生的內(nèi)容很復(fù)雜,我們通常會在模板中來創(chuàng)建內(nèi)容:

 
 
 
  1. public class Clients extends Controller {
  2. public static void index() { render(); } }

這里有一個命名約定,Play會根據(jù)controller名和action名來尋找默認(rèn)的模板路徑。對于上例是:

 
 
 
  1. app/views/Clients/index.html

把數(shù)據(jù)加入到模板域中

模板通常都需要數(shù)據(jù)。我們可以把這些數(shù)據(jù)放在 renderArgs 對象中:

 
 
 
  1. public class Clients extends Controller {
  2. public static void show(Long id) {
  3. Client client = Client.findById(id);
  4. renderArgs.put(“client”, client); render();
  5. }
  6. }

當(dāng)執(zhí)行模板的時候,會自動創(chuàng)建 client 變量。

例如,我們可在模板中使用client變量:

 
 
 
  1. Client ${client.name}

將數(shù)據(jù)加入到模板類中的更簡單的方法

我們可以直接將數(shù)據(jù)傳入到 render(...) 中:

 
 
 
  1. public static void show(Long id) {
  2. Client client = Client.findById(id);
  3. render(client); 
  4. }

在這種情況下,模板中也將有一個與action中的局部變量名一樣的變量(client)。

我們還可以傳入更多的變量:

 
 
 
  1. public static void show(Long id) {
  2. Client client = Client.findById(id);
  3. render(id, client); 
  4. }

重要!

你只能通過這種方式來傳入局部變量

h4. 使用其它模板

如果你不想使用默認(rèn)模板,可以通過在 renderTemplate(…) 中的第一個參數(shù)中指定另一個模板名稱。

舉例:

 
 
 
  1. public static void show(Long id) {
  2. Client client = Client.findById(id);
  3. renderTemplate("Clients/showClient.html", id, client); 
  4. }

重定向到另一個URL

redirect(…) 方法會產(chǎn)生一個重定向事件,接著會產(chǎn)生一個HTTP Redirect響應(yīng)。

 
 
 
  1. public static void index() {
  2. redirect("http://www.zenexity.fr");
  3. }

Action鏈

在play中沒有Servlet API forward 的等價物。每一個HTTP request只能調(diào)用一個action。如果我們需要調(diào)用另一個,必須通過重定向,讓瀏覽器訪問另一個URL來訪問它。這樣的話,瀏覽器的URL始終與被執(zhí)行的action保持一致,實現(xiàn)Back/Forward/Refresh的管理就容易多了。

你可以發(fā)送到任何一個action的Redirect,只需要直接在Java中調(diào)用該action即可。該調(diào)用將會自動被Play攔截,并生成一個HTTP重定向。

舉例:

 
 
 
  1. public class Clients extends Controller {
  2. public static void show(Long id) {
  3. Client client = Client.findById(id);
  4. render(client);
  5. }
  6. public static void create(String name) {
  7. Client client = new Client(name);
  8. client.save();
  9. show(client.id);
  10. }
  11. }

With these routes:

 
 
 
  1. GET /clients/{id} Clients.show
  2. POST /clients Clients.create 
  • 瀏覽器向 /clients URL發(fā)送一個POST。
  • Router調(diào)用 Clients controller的 create action.
  • Action方法直接調(diào)用 show 方法
  • 該Java調(diào)用被攔截,Router根據(jù)它產(chǎn)生一個調(diào)用Clients.show(id)所需要的新URL。
  • HTTP響應(yīng)為 302 Location:/clients/3132.
  • 瀏覽器接著發(fā)送 GET /clients/3132.

自定義編碼集

Play強調(diào)使用UTF-8,但有時候某些響應(yīng),或者整個應(yīng)用的響應(yīng),都必須使用一個不同的編碼集。

給當(dāng)前response定義encoding

要改變當(dāng)前response的編碼集,我們需要在controller中這樣做:

 
 
 
  1. response.encoding = "ISO-8859-1";

如果要使用一個與服務(wù)器默認(rèn)的不同的編碼集,我們必須在form中包含兩次encoding/charset。一次在 accept-charset 屬性中,一次在一個hidden類型的字段 _charset_ 中。 accept-charset 告訴瀏覽器使用哪種字符集,而 _charset_ 告訴play使用哪種字符集:

 
 
 

自定義整個程序的編碼集

配置application.web_encoding 來指定Play使用哪種編碼集。


攔截器(Interceptions)

一個controller可以定義多個攔截器方法。攔截器作用于一個controller及其所有子類的所有action方法上。對于定義一些所有action共用的操作時,使用攔截器非常有用,比如:檢查用戶是否已經(jīng)登錄(有沒有訪問權(quán)),截入request范圍內(nèi)的數(shù)據(jù),等等。

這些方法必須為static,但不一定是public。你必須給它們增加合適的注解以表明它們是攔截器。

@Before

如果方法上有@Before注解,則它將在該controller中的每一個action被調(diào)用前被執(zhí)行。

所以可以進行一下安全檢查:

 
 
 
  1. public class Admin extends Application {
  2. @Before static void checkAuthentification() {
  3. if(session.get(“user”) == null) login();
  4. }
  5. public static void index() {
  6. List users = User.findAll();
  7. render(users);
  8. }
  9. }

如果你想給某些方法開綠燈,可按下面的方法排除一些action:

 
 
 
  1. public class Admin extends Application {
  2. @Before(unless=“l(fā)ogin”)
  3. static void checkAuthentification() {
  4. if(session.get(“user”) == null) login();
  5. }
  6. public static void index() {
  7. List users = User.findAll();
  8. render(users);
  9. }
  10. }

或者僅對于某些方法調(diào)用該攔截器,可使用“only”:

 
 
 
  1. public class Admin extends Application {
  2. @Before(only={“l(fā)ogin”,“l(fā)ogout”})
  3. static void doSomething()
  4. {
  5. }
  6. }

@After, @Before 和 @Finally這三個注解,都提供了 unless 和 only 參數(shù)。

@After

使用@After注解的方法,將在該Controller中的每一個action之后被調(diào)用。

 
 
 
  1. public class Admin extends Application {
  2. @After static void log(){
  3. Logger.info(“Action executed ...”);
  4. }
  5. public static void index() {
  6. List users = User.findAll();
  7. render(users);
  8. }
  9. … }

@Catch

使用了@Catch注解的方法,將會在某個拋出了它所指定的異常時,被調(diào)用。異常類型將被傳入到@Catch方法的參數(shù)中。

 
 
 
  1. public class Admin extends Application {
  2. @Catch(IllegalStateException.class)
  3. public static void logIllegalState(Throwable throwable) {
  4. Logger.error(“Illegal state %s…”, throwable);
  5. }
  6. public static void index() { List users = User.findAll();
  7. if (users.size() == 0) {
  8. throw new IllegalStateException(“Invalid database - 0 users”);
  9. }
  10. render(users);
  11. }
  12. }

與Java的異常處理一樣,我們可以使用一個超類來捕獲更多的異常類型。如果我們有多個catch方法,可以通過指定其priority來定義它們的執(zhí)行順序(priority為1的最先執(zhí)行)。

 
 
 
  1. public class Admin extends Application {
  2. @Catch(value = Throwable.class, priority = 1)
  3. public static void logThrowable(Throwable throwable) {
  4. // Custom error logging… Logger.error(“EXCEPTION %s”, throwable);
  5. }
  6. @Catch(value = IllegalStateException.class, priority = 2)
  7. public static void logIllegalState(Throwable throwable) {
  8. Logger.error(“Illegal state %s…”, throwable);
  9. }
  10. public static void index() {
  11. List users = User.findAll();
  12. if(users.size() == 0) {
  13. throw new IllegalStateException(“Invalid database - 0 users”);
  14. }
  15. render(users); }
  16. }

@Finally

使用@Finally注解的方法,總是在該Controller中每一個action執(zhí)行完之后再執(zhí)行。不論action執(zhí)行成功或者失敗,它都將會被執(zhí)行。跟Java中finally的意思相同。

 
 
 
  1. public class Admin extends Application {
  2. @Finally static void log() {
  3. Logger.info(“Response contains : ” + response.out);
  4. }
  5. public static void index() {
  6. List users = User.findAll(); render(users);
  7. }
  8. }

如果@Finally方法有一個Throwable類型的參數(shù),則異常對象會被傳入(如果有的話):

 
 
 
  1. public class Admin extends Application {
  2. @Finally static void log(Throwable e) {
  3. if( e == null ){
  4. Logger.info(“action call was successful”);
  5. }
  6. else
  7. {
  8. Logger.info(“action call failed”, e);
  9. }
  10. }
  11. public static void index() {
  12. List users = User.findAll(); render(users);
  13. }
  14. }

Controller繼承

如果一個Controller類是另一個的子類,則父類中定義的攔截器同樣對子類有效。

通過@With注解,加入更多的攔截器

因為Java中沒有多重繼承,所以通過Controller繼承來共用攔截器很難。但是通過@With注解,我們可以把一些攔截器定義在一個完全不同的類中,然后在當(dāng)前Controller中使用它們。

舉例:

 
 
 
  1. public class Secure extends Controller {
  2. @Before static void checkAuthenticated() {
  3. if(!session.containsKey(“user”)) {
  4. unAuthorized();
  5. }
  6. }
  7. }

把它加到另一個Controller中:

 
 
 
  1. @With(Secure.class)
  2. public class Admin extends Application {
  3. … }

Session和Flash scopes

如果你打算在多個HTTP請求之間共用數(shù)據(jù),可以把它們保存在Session或Flash域中。保存在Session中的數(shù)據(jù),對于整個user session都可用,而保存在flash域中的數(shù)據(jù),則僅僅在下一個請求可用。

有一點非常重要,需要理解的是,在play中,Session和Flash數(shù)據(jù)并沒有保存在服務(wù)器端,而是通過Cookie被加入到每一個HTTP請求中。所以能保存的數(shù)據(jù)量非常小(不超過4KB),并且只能保存字符串。

當(dāng)然,cookies都使用了一個密鑰進行了加密,所以客戶端無法修改cookie數(shù)據(jù)(否則該數(shù)據(jù)將無效)。Play的session不是用來當(dāng)作數(shù)據(jù)緩存。如果我們需要緩存與session相關(guān)的某些數(shù)據(jù),可以使用Play內(nèi)置的緩存機制,并使用session.getId()作為key來保存。

舉例:

 
 
 
  1. public static void index() {
  2. List messages = Cache.get(session.getId() + "-messages", List.class);
  3. if(messages == null) {
  4. // Cache miss
  5. messages = Message.findByUser(session.get("user"));
  6. Cache.set(session.getId() + "-messages", messages, "30mn");
  7. }
  8. render(messages);
  9. }

當(dāng)我們關(guān)閉瀏覽器時,session數(shù)據(jù)將過期,除非我們通過 application.session.maxAge 進行了配置。

緩存使用了與傳統(tǒng)Servlet HTTP session不同的定義,所以我們不能假設(shè)這些數(shù)據(jù)只是在cache中。這將強迫我們處理cache中沒有數(shù)據(jù)的情況,并強迫我們的程序是完全無狀態(tài)的。


網(wǎng)站欄目:PlayFramework介紹:控制器層
地址分享:http://www.dlmjj.cn/article/dpigdch.html