play框架手册-09.异步任务可编辑范本.docVIP

PAGE1

09.异步Jobｓ

因为play是一个wｅｂ应用程序,因此许多应用程序逻辑都是由控制器返回给htｔp请求的。

但有些时候,我们需要在ｈtｔp请求外执行一些应用逻辑．比如非常有用的初始化任务，维护任务或运行不能被hｔｔｐ请求池中断的长时运行的任务等等。

Jobs可以被框架全面进行管理。意思是play负责管理所有的数据库连接原料stuff,JPＡ实体管理器负责管理数据同步和事务管理.要想创建一个job，只需要继承pｌay。jobs。Job即可。

paｃkagejobs;

impｏrtplay。jobs.＊；

pubｌｉcclaｓｓMｙＪｏbextendsJob{

puｂliｃvｏｉddｏJob()｛

//在这儿执行某些逻辑

}

｝

有些时候需要任务返回结果,这时就需要重载doJｏbWｉthRｅｓｕlt(）方法。

ｐacｋagejoｂs;

importplaｙ。ｊobs.*;

puｂlicclasｓＭyJobextenｄsＪｏｂ〈Sｔring{

puｂlicStriｎgdoJoｂＷｉｔｈＲesｕｌｔ（)｛

//在这儿执行某些逻辑

reｔurnreｓuｌt;

}

}

本示例仅使用了Ｓtriｎｇ作为返回类型，当然可以返回任何对象类型。

引导程序任务Bｏｏtstrapｊobs

引导程序任务会在play应用启动时执行。要想实现该任务，只需要在你的任务上添加@OnAppｌicationStaｒt注释：

iｍpoｒｔplay.jobｓ.*;

@OnAｐpｌicatiｏnSｔart

publicｃlasｓBootsｔｒapeｘtendsJob{

publicｖｏｉddoJob(){

if(Pａge。couｎt（)==0)｛

nｅwPage(root”).sａvｅ（)；

Loggeｒ.iｎfo(”Aroｏtｐagehasbｅeｎｃｒｅatｅd。)；

}

}

｝

注意：在这里不需要返回结果，即使这样做了,结果也会丢失.

默认情况下，所有标识为＠OnＡppliｃａtioｎStart的任务都将以队列方式执行．当所有的jｏb执行结束后，应用程序才正式启动并开始处理请求。

如果你打算让你的任务在应用程序启动时执行，但你又想立即管理进行请求处理,那么可以使用@ＯnApplicatｉonSｔart（asyｎc=true)注释。然后,你的ｊob将在后台启动。

警告!

当运行于DＥＶ模式时，应用程序将在第一个请求到达时才启动。此外，在DEV模式时,在需要的时候，应用程序会自动重启。

当运行于PＲＯD模式时,应用程序将和服务器一起同步启动。

预定义任务Sｃheｄuledｊobs

预定义任务由框架周期性执行。你可以使用@Eveｒy注释要求pｌay在一个特定的周期内运行ｊob．

importｐｌay.jobｓ.*;

＠Everｙ(”1h)

puｂlｉcclａsｓBootstrapexteｎdｓJob｛

pｕｂlicvoｉddoJｏb（）{

Lisｔ〈Ｕser＞nｅwUｓerｓ=User。find(”newAccounｔ=true）。fetch();

for（Uｓerｕser：ｎewUｓerｓ){

Notiｆier。sayWeｌｃoｍe(useｒ);

｝

}

}

如果@Every注释还不足以满足需要，你可使用带有CRＯＮ表达式的@On注释来运行你的job。

impoｒtplay。joｂs．＊；

/＊*Fireａｔ12pm(ｎoon)eｖeｒｙｄａｙ**／

＠Ｏn(00１2**？）

pubｌicｃlaｓsBｏotstrapexｔｅnｄsJoｂ｛

pｕbliｃvoiddoJob（){

Logｇｅr。iｎfo(Maiｎtenancejｏb．。．”);

。。。

｝

｝

小建议我们是使用HYPERLＩNKhｔtp://ｗww。qｕartz—scheｄuler。ｏｒｇ/docs/tuｔoｒialｓ/ｃrｏntrigger．html”Ｑuartｚlibrary来解析CRON表达式的。

你不能返回结果,即使这样做了,结果也会被丢弃。

触发任务job

调用Job实例的now(）方法可以在任何时候触发job来执行一段特定的任务．这个时候,ｊob将以非阻塞方式立即执行。

puｂlicstaticv