Symfony2 Jobeet Day 4: 控制器与视图

今天，我们要继续完成昨天创建的job控制器。它已经拥有了Jobeet所需的大部分的代码：

显示职位列表
创建一个新的职位
修改一个职位
删除一个职位

虽然我们的代码已经可以使用了,但还需要在此基础上重构一下模板，使得它更匹配Jobeet模型。

MVC架构

对于Web开发来说，组织你代码的方式有很多种，但其中最为常见的解决方案就是MVC设计模式。
简而言之, MVC设计模式是定义了一种最自然的方式来组织代码。

这种模式将代码分为三个层： Model层定义了业务逻辑（数据库属于这一层）。通过前一天的实战，你已经知道在Symfony2中存储所有和model相关的类和文件都在Entity/文件夹下。
View层是用于和用户进行交互的图形界面（模板引擎就是该层的一部分）。在Symfony2中,视图层主要是使用Twig模板。它们存储在Resources/views/文件夹下，我们会在稍后看到。
Controller层是一段调用Model层的代码，以此来获得一些数据,并传递给View层，进而呈现给客户端。

当我们在安装Symfony开始本教程时，可以看到所有的请求都是由前端控制器（app.php和app_dev.php）进行管理的。这些前端控制器将实际工作委派给具体的action。

页面布局

如果你有仔细观察我们的设计,就会注意到的每个页面看起来都很相似。众所周知，重复的代码是一种不好的设计，无论是html还是php。所以我们需要找到一种方式来防止这些公用元素所造成的重复代码。

解决这个问题的一个方法是定义一个页眉和页脚,并将它们包含在每个模板里面。另一个更好的方法是使用设计模式来解决这个问题:装饰器模式。它可以将渲染好的模板置于一个全局模板中输出，该全局模板我们就称之为称之为布局

与Symfony 1.x不同，Symfony 2中并没有一个默认的布局模板，因此我们首先将创建一个，并用它来装饰我们的应用程序页面。

创建一个新的layout.html.twig文件在src/Ens/JobeetBundle/Resources/views/目录下

代码：

<!DOCTYPE html>
<html>
  <head>
    <title>
      {% block title %}
        Jobeet - Your best job board
      {% endblock %}
    </title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    {% block stylesheets %}
      <link rel="stylesheet" href="{{ asset('bundles/ensjobeet/css/main.css') }}" type="text/css" media="all" />
    {% endblock %}
    {% block javascripts %}
    {% endblock %}
    <link rel="shortcut icon" href="{{ asset('bundles/ensjobeet/images/favicon.ico') }}" />
  </head>
  <body>
    <div id="container">
      <div id="header">
        <div class="content">
          <h1><a href="{{ path('ens_job') }}">
            <img src="{{ asset('bundles/ensjobeet/images/logo.jpg') }}" alt="Jobeet Job Board" />
          </a></h1>
 
          <div id="sub_header">
            <div class="post">
              <h2>Ask for people</h2>
              <div>
                <a href="{{ path('ens_job') }}">Post a Job</a>
              </div>
            </div>
 
            <div class="search">
              <h2>Ask for a job</h2>
              <form action="" method="get">
                <input type="text" name="keywords" id="search_keywords" />
                <input type="submit" value="search" />
                <div class="help">
                  Enter some keywords (city, country, position, ...)
                </div>
              </form>
            </div>
          </div>
        </div>
      </div>
 
      <div id="content">
      {% for flashMessage in app.session.flashbag.get('notice') %}
           <div class="flash_notice">
               {{ flashMessage }}
           </div>
       {% endfor %}

       {% for flashMessage in app.session.flashbag.get('error') %}
           <div class="flash_error">
               {{ flashMessage }}
           </div>
       {% endfor %}
 
        <div class="content">
            {% block content %}
            {% endblock %}
        </div>
      </div>
 
      <div id="footer">
        <div class="content">
          <span class="symfony">
            <img src="{{ asset('bundles/ensjobeet/images/jobeet-mini.png') }}" />
            powered by <a href="http://www.symfony.com/">
              <img src="{{ asset('bundles/ensjobeet/images/symfony.gif') }}" alt="symfony framework" />
            </a>
          </span>
          <ul>
            <li><a href="">About Jobeet</a></li>
            <li class="feed"><a href="">Full feed</a></li>
            <li><a href="">Jobeet API</a></li>
            <li class="last"><a href="">Affiliates</a></li>
          </ul>
        </div>
      </div>
    </div>
  </body>
</html>

小提示，path函数中的名称为你在路由中定义的名称，请仔细查看src\Ens\JobeetBundle\Resources\config\routing\job.yml，以防找不到路由

Twig Blocks

Twig是Symfony2默认的模板引擎。你能像我们上面所展示的那样定义一块blocks，一个Twig block可以有一个默认的内容（例如上面的title block）也能使用子模板替换或扩展其中的内容（我们稍后将会看到）。

现在，我们利用创建的新布局文件编辑所有的job模板（在src/En/JobeetBundle/Resources/views/Job/目录下的edit, index, new 和show模板），并重写content block

{% extends 'EnsJobeetBundle::layout.html.twig' %}
 
{% block content %}
  <!-- original template code goes here -->
{% endblock %}

小提示：此处自动生成的几个模板其实是在app\Resources\views\job目录下，你可以将其拷贝到src/En/JobeetBundle/Resources/views/Job/目录下再进行修改

样式表、图片与javascript

由于本教程不是关于网页设计的，所以在此我们已经准备好本项目所需的资源下载图片文件并解压到src/Ens/JobeetBundle/Resources/public/images/目录下下载样式表文件并解压到src/Ens/JobeetBundle/Resources/public/css/目录下

然后运行：

php app/console assets:install web --symlink

以此通知Symfony这些资源是公共的。

译者注：此处如果是Linux下实际上是在web/bundles/下生成一个项目名的软连接，而Windows下则是直接将Resources下的所有文件直接复制过来，所以Windows下如果在Resources下更新文件之后必须记得再次执行上述命令进行同步

我们有4个css文件admin.css, job.css, jobs.css 和main.css。其中main.css需要在所有的页面中都引用，其他css文件我们只需要在特定文件中引用即可。

在模板中添加一个新的css文件需要重写stylesheets block，但在加入新的css文件之前需要先调用父模板方法

<!-- src/Ens/JobeetBundle/Resources/views/Job/index.html.twig -->
{% extends 'EnsJobeetBundle::layout.html.twig' %}
 
{% block stylesheets %}
  {{ parent() }}
  <link rel="stylesheet" href="{{ asset('bundles/ensjobeet/css/jobs.css') }}" type="text/css" media="all" />
{% endblock %}
<!-- the rest of the code -->

<!-- src/Ens/JobeetBundle/Resources/views/Job/show.html.twig -->
{% extends 'EnsJobeetBundle::layout.html.twig' %}
{% block stylesheets %}
  {{ parent() }}
  <link rel="stylesheet" href="{{ asset('bundles/ensjobeet/css/job.css') }}" type="text/css" media="all" />
{% endblock %}
<!-- the rest of the code -->

首页Action

每个action对应于类中的一个方法，对于主页来说就是JobController中的indexAction()方法。它从数据库中检索所有的职位：

public function indexAction()
{
    $em = $this->getDoctrine()->getManager();
 
    $entities = $em->getRepository('EnsJobeetBundle:Job')->findAll();
 
    return $this->render('EnsJobeetBundle:Job:index.html.twig', array(
        'entities' => $entities
    ));
}

译者注：原文中使用的getEntityManager方法已被废弃，现改为getManager方法效果一样。但因为原文使用地方较多，故代码已直接修改，以后文章出现亦同

小提示：请记得将job/index.html.twig替换为EnsJobeetBundle:Job:index.html.twig否则你的修改将无效，下方showAction也相同

现在让我们仔细观察代码，首先在indexAction()方法中得到Doctrine entity manager对象，它会负责把数据持久化到数据库或者把数据从数据库中取出，然后repository对象生成一个查询并去数据库检索所有的职位信息，同时返回一个Doctrine ArrayCollection类型的Job对象并传递给模板(视图)

Job主页模板

index.html.twig模板生成的所有职位的HTML表格。下面是当前模板的代码

<!-- src/Ens/JobeetBundle/Resources/views/Job/index.html.twig -->
{% extends 'EnsJobeetBundle::layout.html.twig' %}
 
{% block stylesheets %}
  {{ parent() }}
  <link rel="stylesheet" href="{{ asset('bundles/ensjobeet/css/jobs.css') }}" type="text/css" media="all" />
{% endblock %}
 
{% block content %}
    <h1>Job list</h1>
 
    <table class="records_list">
        <thead>
            <tr>
                <th>Id</th>
                <th>Type</th>
                <th>Company</th>
                <th>Logo</th>
                <th>Url</th>
                <th>Position</th>
                <th>Location</th>
                <th>Description</th>
                <th>How_to_apply</th>
                <th>Token</th>
                <th>Is_public</th>
                <th>Is_activated</th>
                <th>Email</th>
                <th>Expires_at</th>
                <th>Created_at</th>
                <th>Updated_at</th>
                <th>Actions</th>
            </tr>
        </thead>
        <tbody>
        {% for entity in entities %}
            <tr>
                <td><a href="{{ path('ens_job_show', { 'id': entity.id }) }}">{{ entity.id }}</a></td>
                <td>{{ entity.type }}</td>
                <td>{{ entity.company }}</td>
                <td>{{ entity.logo }}</td>
                <td>{{ entity.url }}</td>
                <td>{{ entity.position }}</td>
                <td>{{ entity.location }}</td>
                <td>{{ entity.description }}</td>
                <td>{{ entity.howtoapply }}</td>
                <td>{{ entity.token }}</td>
                <td>{{ entity.ispublic }}</td>
                <td>{{ entity.isactivated }}</td>
                <td>{{ entity.email }}</td>
                <td>{% if entity.expiresat %}{{ entity.expiresat|date('Y-m-d H:i:s') }}{% endif%}</td>
                <td>{% if entity.createdat %}{{ entity.createdat|date('Y-m-d H:i:s') }}{% endif%}</td>
                <td>{% if entity.updatedat %}{{ entity.updatedat|date('Y-m-d H:i:s') }}{% endif%}</td>
                <td>
                    <ul>
                        <li>
                            <a href="{{ path('ens_job_show', { 'id': entity.id }) }}">show</a>
                        </li>
                        <li>
                            <a href="{{ path('ens_job_edit', { 'id': entity.id }) }}">edit</a>
                        </li>
                    </ul>
                </td>
            </tr>
        {% endfor %}
        </tbody>
    </table>
 
    <ul>
        <li>
            <a href="{{ path('ens_job_new') }}">
                Create a new entry
            </a>
        </li>
    </ul>
{% endblock %}

现在让我们清理一下，只显示有用的列，用如下代码替换掉twig block content里的内容

{% block content %}
    <div id="jobs">
      <table class="jobs">
        {% for entity in entities %}
          <tr class="{{ cycle(['even', 'odd'], loop.index) }}">
            <td class="location">{{ entity.location }}</td>
            <td class="position">
              <a href="{{ path('ens_job_show', { 'id': entity.id }) }}">
                {{ entity.position }}
              </a>
            </td>
            <td class="company">{{ entity.company }}</td>
          </tr>
        {% endfor %}
      </table>
    </div>
{% endblock %}

day5_the_job_homepage_template_01

职位详情页模板

现在开始定制职位详情页模板，打开show.html.twig文件并将下方内容进行替换：

<!-- src/Ens/JobeetBundle/Resources/views/Job/show.html.twig -->
{% extends 'EnsJobeetBundle::layout.html.twig' %}
 
{% block title %}
    {{ entity.company }} is looking for a {{ entity.position }}
{% endblock %}
 
{% block stylesheets %}
    {{ parent() }}
    <link rel="stylesheet" href="{{ asset('bundles/ensjobeet/css/job.css') }}" type="text/css" media="all" />
{% endblock %}
 
{% block content %}
    <div id="job">
      <h1>{{ entity.company }}</h1>
      <h2>{{ entity.location }}</h2>
      <h3>
        {{ entity.position }}
        <small> - {{ entity.type }}</small>
      </h3>
 
      {% if entity.logo %}
        <div class="logo">
          <a href="{{ entity.url }}">
            <img src="/uploads/jobs/{{ entity.logo }}"
              alt="{{ entity.company }} logo" />
          </a>
        </div>
      {% endif %}
 
      <div class="description">
        {{ entity.description|nl2br }}
      </div>
 
      <h4>How to apply?</h4>
 
      <p class="how_to_apply">{{ entity.howtoapply }}</p>
 
      <div class="meta">
        <small>posted on {{ entity.createdat|date('m/d/Y') }}</small>
      </div>
 
      <div style="padding: 20px 0">
        <a href="{{ path('ens_job_edit', { 'id': entity.id }) }}">
          Edit
        </a>
      </div>
    </div>
{% endblock %}

day5_the_job_page_template_01

职位详情页Action

在JobController中创建showAction()方法

public function showAction($id)
{
    $em = $this->getDoctrine()->getManager();
    $entity = $em->getRepository('EnsJobeetBundle:Job')->find($id);
 
    if (!$entity) {
        throw $this->createNotFoundException('Unable to find Job entity.');
    }
    $deleteForm = $this->createDeleteForm($id);
 
    return $this->render('EnsJobeetBundle:Job:show.html.twig', array(
        'entity'      => $entity,
        'delete_form' => $deleteForm->createView(),
    ));
}

在action中这次我们使用EnsJobeetBundle:Job repository的find()方法，该方法接收一个能唯一标识Job表的参数，一般是主键值，此处为职位id

如果寻找的职位详情不存在于数据库中时，将会调用 $this->createNotFoundException()方法抛出一个404页面不过值得注意的是，在生产环境和开发环境显示给用户的404页面是的不同：

生产环境：

开发环境：

译者注：关于生产环境中如何使用自定义错误页面，可参考官方cookbook

小提示：由于新版本中自动生成的代码与上面所示会有部分出入，如showAction传入的是一个job对象，此时可直接判断是否存在而无须查表，诸如此类，可自行稍作修改，在此不再过多叙述

OK，今天的课程就到这里了。明天我们将熟悉如何使用路由。

huajie / Jobeet-Tutorial

Symfony2 Jobeet Day 4: 控制器与视图

MVC架构

页面布局

Twig Blocks

样式表、图片与javascript

首页Action

Job主页模板

职位详情页模板

职位详情页Action

简介

发行版

贡献者

近期动态

huajie / Jobeet-Tutorial .gitee-modal { width: 500px !important; }

Symfony2 Jobeet Day 4: 控制器与视图

MVC架构

页面布局

Twig Blocks

样式表、图片与javascript

首页Action

Job主页模板

职位详情页模板

职位详情页Action

简介

发行版

贡献者

近期动态

搜索帮助

huajie / Jobeet-Tutorial