2025年Play 概述

大家好，我是讯享网，很高兴认识大家。

注：此文摘自某位大神文笔，但是因为我不小心把那个链接弄不见了，所以木有加上，忘原作者见谅。

Play框架架构于标准的Java体系之上，小巧精致，简洁轻便。却包含了从Web框架到对象持久、从动态编译到单元测试、从缓存到异步作业框架、从插件到模块扩展体系等众多功能，是一个全栈框架，它吸收并重用了大量已有Java类库，却依然能够独树一帜、标新立异。
八大美学特征：
1、没有了“编译-打包-部署”，直接“修改-保存-刷新”；
2、非常详细的编译错误提示
3、简单的无状态MVC架构
4、HTTP直接映射到代码调用
5、高效的模板引擎
6、强化的JPA 7、测试驱动开发
8、全栈式应用框架
八大暴力特征：
1、自带嵌入式的Java编译器，不再需要构建工具编译、打包代码；
2、自带嵌入式的HTTP服务器，不再需要打包部署到Servlet容器；
3、自带在嵌入式服务器中运行的测试框架，所有的测试类，必须以测试模式启动服务器方式执行
4、严格按MVC组织应用代码，各层组件类必须继承基类，没有“优雅”的接口实现，也不用依赖注入；
5、对渲染响应结果的跳转控制，居然使用“异常”抛出机制 ；
6、控制器类的Action方法通通是静态的，直接调用静态方法即为Action链重定向；
7、将模型类的字段声明为public，再通过框架编译成私有字段和公共属性访问方法，访问模型对象的属性时也不使用get/set；
8、打破Java的封闭类定义，可以为Java类库中的类定义增强方法，并在响应模板中嵌入的增强对象上调用。

主要概念 MVC设计模式Play框架采用了良好的MVC设计模式，这个模式把应用分为三层：模型层（Model），控制层（Controller）和表示层（View）。关于MVC设计模式的具体思想可以参考其他资料，本资料主要讲解Play的知识，在这里不再叙述。 play应用针对MVC三层结构在app目录下分别定义了三个目录。 app/controllers 一个Play控制器（Controller）就是一个Java类，在Controller里定义的每一个public,static,void方法就是action。Action获取HTTP请求数据，查询或者更新模型对象，并返回结果。 app/models 模式层是一个个Java实体类的集合，模型包含数据结构和操作，可以采用JPA或者是DAO模式对模型进行持久化。 app/views Play提供了一个高效的模板引擎来生成视图，控制层获取有用的数据后，视图层来展示，装饰这些数据。视图层通常包含HTML，XML，JSON或者其他的模板文件。

请求生命周期
Play框架是一个无状态的框架，所有的HTTP请求过程如下：
1、Play框架接收一个HTTP请求
2、Router组件尝试找到最匹配的路由来接受请求，对应的action方法通过反射机制被调用
3、应用代码执行
4、渲染模板文件
5、Action方法返回响应结果下图展示了一个完整的HTTP请求响应过程：

标准的目录结构

标准化的目录结构能够让很多事情看起来非常简单，下图展示了Play项目的目录结构： app 此目录包含所有的Java源代码和视图文件。即可app目录下有一个固定的views文件夹存放所有的视图文件，也可以在此目录新建自己需要的包，例如utils。app/controllers存放所有的控制器类文件。

注意：我的class文件在哪里呢？Play框架是在运行时编译Java源代码，并且把class文件和相应的二制进缓存到tmp文件夹。在tmp文件夹有bytecode和classes两个子文件夹，存放运行时编译的字节码文件和对应的二进制缓存文件。
此外，可在views文件夹下可以建立子文件夹，存放action对应的视图文件。例如有一个控制器app/controller/User.java，对应的视图文件夹可以推荐为app/views/User。

public
Play应用程序所有的资源文件保存在此目录。这是一个公开的静态目录，可以通过服务器直接访问/public/images，/public/javascripts，/public/stylesheets默认分别用来保存图片，js文件和css样式文件。
public目录的默认访问方式被映射成“/public”URL路径，但是你用以在conf文件中改变它的访问方式，甚至可以配置自定义目录。 
conf conf这个目录用于保存Play框架的所有配置文件，有两个必须的配置文件。 application.conf 框架的主配置文件，包含标准的配置参数 routes HTTP路由配置文件Play.configuration.get("propertyName")可以取得配置的属性。 application.conf用来配置框架的属性，例如服务器端口，默认日期格式，数据库连接，日志级别等。
 lib 这个目录存放独立的jar包，这些jar包将会自动加入到应用的classpath中。

开发生命周期

Play没有编译，打包，部署这个过程，但它实现了两种截然不同的环境：DEV开发模式和PROD产品模式。
关于DEV/PROD模式

你可以在这两种模式这中运行程序。application.mode configuration用于配置这两种模式。开发模式时，Play检查文件变化，在必要的时候热加载，在开发模式中，可以连接Javadebugger到8000端口进行调试。产品
模式最优于产品:所有的源码和模板文件已经被事先编译并缓存。

开始Play

下载Play的官方网址是：http://www.playframework.org，Play官网是学习Play开发最好的地方。下载Play的最新版本，解压缩此包，可以看到如下结构： NO:文件夹说明
1 documentation Play的api文档和官方教程
2 frameword 框架的jar包，配置，测试，源码等
3 modules 推荐的模块组件
4 python Play底层采用python语言
5 resources 支持开发工具所需的资源
6 samples-and-tests 例子程序和测试
7 support 支持不同IDE所需要的jar frameword下“play-2.0jar”文件是play的主包，而frameword/lib目录下所有的jar文件是play提供的第三方jar包。

安装与配置Play

无需安装，解压即可用。为了开发方便，请配置PLAY_HOME环境变量，与配置JAVE_HOME一样，如下：配置path:

命令行中文乱码解决：修改play-1.2.4\framework\pym\play下application.py文件第258行。

基本命令 play new命令创建一个新的play项目。 play eclipsify命令使项目支持eclipse开发，此命令会在项目下生成eclipse文件夹。 play run命令启动服务器。 play stop命令停止服务器。 play help查看当前可使用的命令。

举个栗子：新建一个HelloWorld项目，并使其支持eclipseIDE。

HelloWorld

在eclipse导入“HelloWorld”项目。此时项目会报错，查看项目属性中JavaBuilderPath，新建一个用户库“play1.2.4”，加入Play的jar文件“play1.2.4.jar”和lib目录下所有的jar文件。如下图所示：修改Application.java文件：package controllers;import play.mvc.Controller;publicclassApplicationextendsController{ 
    / * action方法，此方法响应请求，并返回请求页面 * @param name */publicstaticvoid sayhello(String name){ 
    String message ="Hello World!";if(name !=null){ 
     message +=" I am "+ name;}// 设置属性 renderArgs.put("message", message);//返回页面 render("/Application/index.html");}}

可以看到，所有的控制器都位于controllers包中，并且都是继承自play.mvc.Controller类，所有的action方法都是有publicstaticvoid申声的。修改conf/routes文件: \# Routes \# This file defines all application routes (Higher priority routes first) \# HelloWorld page GET /sayhello/?Application.sayhello 修改views/index.html文件，play的页面直接是html文件，并支持EL表达式，通过EL表达式取数据。<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>HelloWorldPage</title> </head><body><h1>${ 
    message}</h1></body> </html>
使用play run运行程序，此时可以看到程序以DEV模式运行，服务器已经开始监听9000端口。
打开浏览始，在地址栏输入：http://localhost:9000/sayhello/?name=Jock访问应用程序，name=Jock作为URL参数传入，结果如下图所示：
至此，HelloWorld程序已经完成。同样可以在Eclipse中右键/eclipse/Connect JPDA to HelloWorld.launch文件运行程序，此时可以在EclipseConsole观察服务器运行状态。

Http路由
Play框架是如何配置请求路径并根据请求找到对应的action方法的呢？答案就是Router。通过路由组件把HTTP请求交给action方法（Controller包中通过static，public，void修饰的方法）。一个HTTP请求包含请求路径和请求方式。

请求路径（Request path）例如/clients/1542, /photos/list，包含查询参数字符串。

请求方式（GET，POST，PUT，DELETE）

路由配置 conf/routes文件用来配置请求路径，这个文件供Router组件使用。routes文件包含应用程序所有的请求路径，配置的格式：HTTP method + URL pattern +Java调用。
下面是一个普通的请求路径的定义： GET /clients/{ 
    id}Clients.show 每一个route以HTTP请求方式开始，接着是URL路径，最后是Java调用，即控制器中影响此请求的一个方法。可以使用#符号行注释。
# Display a client GET /clients/{ 
    id}Clients.show HTTP请求方式Play支持以下的请求方式： GET POST PUT DELETE HEAD 如果你使用*，就可以匹配所有请求方式，不管以任种方式请求，都会被接收。*/clients/{ 
    id}Clients.show URI模式 URI模式用来定义请求路径，分静态路径和动态路径，动态路径的参数必须放在一对“{}”之间，可以用正则表达式对参数进行限定匹配。
下面展示静态路径和动态路径的区别：/clients/all 仅匹配如下请求：/clients/all 看下面动态:/clients/{ 
    id}能够匹配/clients/12121/clients/toto 一个路径可以配置多个动态部分/clients/{ 
    id}/accounts/{ 
    accountId}

动态路径的参数可以用正则表达式进行限定，而路径中的参数对应action方法中的参数。

这个正则用来限定参数id只能为数字/clients/{<[0-9]+>id}

这个正则限定id只能为4到10个小写字母/clients/{<[a-z]{ 
    4,10}>id}

默认的，Play认为路径最的斜杠“/”是重要的，路径最后有或者没有“/”是有区别的。 GET /clients Clients.index 将会匹配/clients但不会匹配/clients/.用如下的配置办法可以让框架匹配两种情况. GET /clients/?Clients.index
Java调用 route最后一个部分我们称为Java调用。这部分被定义成完整的控制器类和action方法名称，这个action方法必须是公开的，静态的，无返回静的。控制器类必须定义在Controller包中，并且必须是play.mvc.Controller的子类。你可以自定义控制器的包，但在route中必须指定包名,因为默认的是controller包，所以默认不需要指定包名。 GET /admin admin.Dashboard.index 404 action 可以直接使用404作用一个action，它将返回404页面。
例如：# Ignore favicon requests GET /favicon.ico 
404

指定静态参数
有的时候，你想重复使用一个action方法，为它配置多个请求路径route，且每个route有一个固定的参数。
看如下例子：控制器方法的代码：publicstaticvoid user(String id){ 
    User user =User.findById(id); renderArgs.put(“user”, user); render(“/application/user.html”);}

绑定的路由 GET /pages/{ 
    id}Application.page 现在，想要针对管理员配置一个专门的路径，此管理员的ID为‘king’，可以作如下配置： GET /admin/?Application.user(id:’king’) GET /user/{ 
    id}/?Application.user 变量和脚本在route文件中可以使用 ${…}提示变量，使用%{…}写脚本，和在模板文件中一样。例如：%{ 
     context = play.configuration.getProperty('context','')}%# Home page GET ${ 
    context}Secure.login GET ${ 
    context}/Secure.login 路由优先级当多个route配置匹配到同一个请求时，以哪一个匹配为准，这就是路由优先级。在routes文件中，越在前的，优先级越高，优先配置请求。例如： GET /clients/all Clients.listAll GET /clients/{ 
    id}Clients.show
用如下的URL请求
/clients/all
虽然这两条route都能匹配这个请求，但只有第一条被用来响应在实际的开发过程中，要小心配置routes，以免造成路由冲突，解决路由冲突的办法就是采用如上的配置方案，还有一种就是在参数中采用正则表达式进行匹配限定。

静态资源路由
有时候需要将某些目录或者文件静态化，不通过程序直接访问，可以这样配置：

#这样配置，public目录就可以直接访问了 GET /public/ staticDir:public# index.html将作为一个静态文件直接返回 GET /home staticFile:/public/html/index.html 
路由反转
既然可以通过URL找到调用action方法，自然也可以通过action生成此方法对应的URL。 route定义如下： GET /clients/{ 
    id}Clients.show 在代码中可以通过client.show生成URL。 map.put("id",1541);
String url =Router.reverse("Clients.show", map).url;// GET /clients/1541

控制器Controller
Controller简介
控制层位于模型层和视图层之间，作控制转发用。在Play框架，一个控制器Controller就是一个Java类，它位于controllers包，继承play.mvc.Controller类。
如下是一个Controller。

讯享网

讯享网package controllers; import java.util.*; import play.modules.spring.Spring; import dao.EmpDAO; public class EmpAction extends Controller{ public static void empList(){ EmpDAO empDao = (EmpDAO)Spring.getBean("empDAO"); List empList = empDao.getAllEmp(); renderArgs.put("empList",empList); render("/Emp/empList.html"); } public static void list(int limit,int ordertype){ EmpDAO empDao =(EmpDAO)Spring.getBean("empDAO"); List empList = empDao.getEmpList(limit, ordertype); renderArgs.put("empList", empList); render("/Emp/ajax.html"); } }

相关推荐