《精通Spring MVC 4》——2.9 使用WebJars实现质感设计

2.9 使用WebJars实现质感设计

现在,我们的应用已经很棒了,但是在美学方面却差得很多。你可能听说过质感设计(material design),这是Google的扁平化设计。

如图2-10所示,我们将会使用Materialize,这是一个非常漂亮的CSS和JavaScript库,与Bootstrap类似。

图2-10

在第1章中,我们曾经简单介绍过WebJars,现在要开始使用它们了。在依赖中,我们要添加jQuery和Materialize CSS:

compile 'org.webjars:materializecss:0.96.0'
compile 'org.webjars:jquery:2.1.4'

每个WebJar的结构都是标准的,每个库的JS和CSS文件都会位于/webjars/{lib}/ {version}/*.js中。

例如,如果要添加jQuery到我们的页面中,那Web页面需要如下所示:

``
接下来修改一下控制器,让它显示所有Tweet对象的列表,而不是只显示简单的文本:

package masterSpringMvc.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.social.twitter.api.SearchResults;
import org.springframework.social.twitter.api.Tweet;
import org.springframework.social.twitter.api.Twitter;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

import java.util.List;

@Controller
public class TweetController {

    @Autowired
    private Twitter twitter;

    @RequestMapping("/")
    public String hello(@RequestParam(defaultValue =
"masterSpringMVC4") String search, Model model) {
        SearchResults searchResults = twitter.searchOperations().
search(search);
        List<Tweet> tweets = searchResults.getTweets();
        model.addAttribute("tweets", tweets);
        model.addAttribute("search", search);
        return "resultPage";
    }
}

在视图中,将Materialize CSS包含进来:

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head lang="en">
    <meta charset="UTF-8"/>
    <title>Hello twitter</title>

    <link href="/webjars/materializecss/0.96.0/css/materialize.css"
type="text/css" rel="stylesheet" media="screen,projection"/>
</head>
<body>
<div class="row">

    <h2 class="indigo-text center" th:text="|Tweet results for
${search}|">Tweets</h2>

    <ul class="collection">
        <li class="collection-item avatar" th:each="tweet :
${tweets}">
            <img th:src="${tweet.user.profileImageUrl}" alt=""
class="circle"/>
            <span class="title" th:text="${tweet.user.
name}">Username</span>
            <p th:text="${tweet.text}">Tweet message</p>
        </li>
    </ul>

</div>

<script src="/webjars/jquery/2.1.4/jquery.js"></script>
<script src="/webjars/materializecss/0.96.0/js/materialize.js"></
script>
</body>
</html>

如图2-11所示结果看起来会好很多。

..\tu\0211.tif{}

图2-11

2.9.1 使用布局
我们最后想实现的就是将UI中可重用的代码块放到模板之中。为了实现该功能,我们需要使用thymeleaf-layout-dialect依赖,它已经包含在项目的spring-boot-starter-thymeleaf依赖里面。

我们会创建一个新的文件,名为default.html,并将其放在src/main/resources/templates/ layout之中,它包含了每个页面中都重复出现的代码:

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"
      xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout">
<head>
    <meta http-equiv="Content-Type" content="text/html;
charset=UTF-8"/>
    <meta name="viewport" content="width=device-width, initial-
scale=1, maximum-scale=1.0, user-scalable=no"/>
    <title>Default title</title>

    <link href="/webjars/materializecss/0.96.0/css/materialize.css"
type="text/css" rel="stylesheet" media="screen,projection"/>
</head>
<body>
<section layout:fragment="content">
    <p>Page content goes here</p>
</section>

<script src="/webjars/jquery/2.1.4/jquery.js"></script>
<script src="/webjars/materializecss/0.96.0/js/materialize.js"></
script>
</body>
</html>

现在,我们要修改resultPage.html文件,让它使用布局,这会简化它的内容:

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"
      xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
      layout:decorator="layout/default">
<head lang="en">
    <title>Hello twitter</title>
</head>
<body>
<div class="row" layout:fragment="content">

    <h2 class="indigo-text center" th:text="|Tweet results for
${search}|">Tweets</h2>

    <ul class="collection">
        <li class="collection-item avatar" th:each="tweet :
${tweets}">

            <img th:src="${tweet.user.profileImageUrl}" alt=""
class="circle"/>
            <span class="title" th:text="${tweet.user.
name}">Username</span>

            <p th:text="${tweet.text}">Tweet message</p>
        </li>
    </ul>
</div>
</body>
</html>

其中,layout:decorator="layout/default"能够表明去哪里查找布局。这样,我们可以将内容注入到布局的不同layout:fragment区域中。需要注意的是,每个模板都是合法的HTML文件,我们可以非常容易地重写它的标题。

2.9.2 导航
我们现在已经有了一个很棒的用于展现Tweet的小应用,但是,我们的用户需要提供一个“search”请求参数,这该如何实现呢(见图2-12)?

图2-12

如果我们能够在应用上增加一个小表单的话,那就非常完美了。

我们接下来要做的事情如下所示。

首先,我们需要修改TweetController,为应用增加第二个视图。访问应用的根目录会展现出搜索页面,在search域中点击回车键会展现结果页面:

@Controller
public class TweetController {

    @Autowired
    private Twitter twitter;

    @RequestMapping("/")
    public String home() {
        return "searchPage";
    }

    @RequestMapping("/result")
    public String hello(@RequestParam(defaultValue =
"masterSpringMVC4") String search, Model model) {
        SearchResults searchResults = twitter.searchOperations().
search(search);
        List<Tweet> tweets = searchResults.getTweets();
        model.addAttribute("tweets", tweets);
        model.addAttribute("search", search);
        return "resultPage";
    }
}

我们会添加另外一个页面到templates文件夹下,并将其命名为searchPage.html文件。这个页面会包含一个简单的表单,它会通过get方法将要搜索的术语传递到结果页面:

<!DOCTYPE html>
<html xmlns:th="http://www.w3.org/1999/xhtml"
      xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
      layout:decorator="layout/default">
<head lang="en">
    <title>Search</title>
</head>
<body>

<div class="row" layout:fragment="content">

    <h4 class="indigo-text center">Please enter a search term</h4>

    <form action="/result" method="get" class="col s12">
        <div class="row center">
            <div class="input-field col s6 offset-s3">
                <i class="mdi-action-search prefix"></i>
                <input id="search" name="search" type="text"
class="validate"/>
                <label for="search">Search</label>
            </div>
        </div>
    </form>
</div>

</body>
</html>

这是一个很简单的HTML,但是已经可以正常运行了,你现在可以尝试一下。

如果不允许展现某些搜索结果的话,该怎么办呢?假设如果用户输入struts的话,我们想展现一个出错页面。

要实现该功能,最好的方式就是修改提交数据的表单。在控制器中,我们可以拦截提交的内容并实现该业务相关的规则。

首先,要修改searchPage中的表单,原来的内容如下所示:

<form action="/result" method="get" class="col s12">
现在,我们将表单改成如下的形式:

<form action="/postSearch" method="post" class="col s12">
我们还需要在服务器端处理该POST请求。在TweetController中添加如下的方法:

@RequestMapping(value = "/postSearch", method = RequestMethod.POST)
public String postSearch(HttpServletRequest request,
    RedirectAttributes redirectAttributes) {
        String search = request.getParameter("search");
        redirectAttributes.addAttribute("search", search);
        return "redirect:result";
}

在这里,有几项比较新鲜的内容:

在请求映射的注解中,指定了想要处理的HTTP方法,也就是POST;
在方法参数中,直接注入了两个属性,它们是request和RedirectAttributes;
检索到请求中post提交过来的数据,并将其传递给下一个视图;
现在不是直接返回视图的名称,而是重定向到另一个URL。
RedirectAttributes是一个Spring的模型,专门用于redirect场景下传送值。

在Java Web应用中,Redirect/Forward是典型的可选方案。它们都会改变展现给用户的视图,其中的区别在于Redirect会发送一个302头信息,它会在浏览器内部触发导航,而Forward则不会导致URL的变化。在Spring MVC中,我们可以任意使用这两种方案,只需在方法返回的字符串上添加“redirect:”或“forward:”前缀即可。在这两种场景中,我们所返回的字符串都不会像前面看到的那样解析为视图,而是触发到特定URL的导航。
之前的样例有些牵强,在下一章中会进行更加巧妙的处理。如果你在postSearch方法上添加一个断点的话,就会发现它会在post表单之后进行调用。

那么,该怎样显示错误信息呢?

我们改一下postSearch方法:

@RequestMapping(value = "/postSearch", method = RequestMethod.POST)
public String postSearch(HttpServletRequest request,
    RedirectAttributes redirectAttributes) {
        String search = request.getParameter("search");
        if (search.toLowerCase().contains("struts")) {
                redirectAttributes.addFlashAttribute("error", "Try
using spring instead!");
                return "redirect:/";
        }
        redirectAttributes.addAttribute("search", search);
        return "redirect:result";
}

如果用户的搜索包含“struts”这个术语的话,我们会将其重定向到searchPage页面并且使用flash属性添加一点错误信息。

这个特殊的属性会在该请求的时间范围内一直存活,直到页面渲染完成才消失。当使用POST-REDIRECT-GET模式的时候,它是非常有用的,就像刚刚做的这样。

我们接下来需要在searchPage结果页面中展现这个错误信息:

<!DOCTYPE html>
<html xmlns:th="http://www.w3.org/1999/xhtml"
      xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
      layout:decorator="layout/default">
<head lang="en">
    <title>Search</title>
</head>
<body>

<div class="row" layout:fragment="content">

    <h4 class="indigo-text center">Please enter a search term</h4>

    <div class="col s6 offset-s3">
        <div id="errorMessage" class="card-panel red lighten-2"
th:if="${error}">
            <span class="card-title" th:text="${error}"></span>
        </div>
        <form action="/postSearch" method="post" class="col s12">
            <div class="row center">
                <div class="input-field">
                    <i class="mdi-action-search prefix"></i>
                    <input id="search" name="search" type="text"
class="validate"/>
                    <label for="search">Search</label>
                </div>
            </div>
        </form>
    </div>
</div>

</body>
</html>

现在,如果用户试图搜索包含“struts2”的Tweet,将会得到有用且合适的答案(见图2-13)。

图2-13

时间: 2024-10-31 06:22:02

《精通Spring MVC 4》——2.9 使用WebJars实现质感设计的相关文章

《精通Spring MVC 4》——1.6 幕后的Spring Boot

1.6 幕后的Spring Boot 如果你之前搭建过Spring MVC应用,那么可能已经习惯于编写相关的XML文件或Java注解配置类. 一般来讲,初始的步骤如下所示: 1.初始化Spring MVC的DispatcherServlet: 2.搭建转码过滤器,保证客户端请求进行正确地转码: 3.搭建视图解析器(view resolver),告诉Spring去哪里查找视图,以及它们是使用哪种方言编写的(JSP.Thymeleaf模板等): 4.配置静态资源的位置(CSS.JS): 5.配置所支

《精通Spring MVC 4》——2.11 小结

2.11 小结 在本章中,我们学习了如何实现良好的MVC架构,看到了Spring MVC内部的一些运行机制,并通过非常少量的配置使用了Spring Social Twitter的功能.通过使用WebJars,可以设计非常漂亮的Web应用. 在下一章中,我们会要求用户填写其基本信息(profile),这样就能自动获取他们可能感兴趣的Tweet.这也给了我们一个机会来更深入地学习表单.格式化.校验以及国际化的功能.

《精通Spring MVC 4》——1.5 那就正式开始吧

1.5 那就正式开始吧 现在Web应用已经准备就绪,先看一下它是如何编写的.在进一步学习之前,我们可以将工作的成果保存到Git上. 在Windows下,需要安装Git bash,这可以在https://msysgit.github.io找到.在Mac下,如果你使用homebrew的话,很可能已经安装过Git了,否则的话,使用brew install git命令来进行安装. 如果要使用Git版本化我们的工作内容,那么可以在控制台中输入如下的命令: $ cd app $ git init 使用Int

《精通Spring MVC 4》——第1章 快速搭建Spring Web应用 1.1Spring Tool Suite简介

第1章 快速搭建Spring Web应用 在本章中,我们将会直接接触代码并搭建一个Web应用,本书的其他章节将会基于该应用进行讲解. 在这里,我们将会使用Spring Boot的自动配置功能来构建应用,这样的话,就能完全避免使用样板式的配置文件. 本书中将会使用Gradle和Java 8,但是也不必为此感到担心.如果你还在使用Maven和更早版本的Java的话,相信你会发现这些技术也是很易于使用的. 很多官方的Spring教程同时提供了Gradle构建和Maven构建,因此,如果你决定继续使用M

《精通Spring MVC 4》——2.3 Spring MVC 1-0-1

2.3 Spring MVC 1-0-1 在Spring MVC中,模型是由Spring MVC的Model或ModelAndView封装的简单Map.它可以来源于数据库.文件.外部服务等,这取决于你如何获取数据并将其放到模型中.与数据层进行交互的推荐方式是使用Spring Data库:Spring Data JPA.Spring Data MongoDB等. Spring MVC的控制层是通过使用@Controller注解来进行处理的.在Web应用中,控制器的角色是响应HTTP请求.带有@Co

《精通Spring MVC 4》——2.5 Spring MVC架构

2.5 Spring MVC架构 让我们从这个新的"Hello World"页面后退一步,尝试去理解在这个Web应用中到底发生了什么.为了做到这一点,需要跟踪浏览器所发送的HTTP请求的行程以及它是如何从服务器端得到响应的. 2.5.1 DispatcherServlet 每个Spring Web应用的入口都是DispatcherServlet.图2-3展现了DispatcherServlet的架构. 图2-3 这个一个典型的HttpServlet类,它会将HTTP请求分发给Handl

《精通Spring MVC 4》——2.4 使用Thymeleaf

2.4 使用Thymeleaf Thymeleaf是一个模板引擎,在Spring社区中,它备受关注. 它的成功在很大程度上要归因于对用户友好的语法(它几乎就是HTML)以及扩展的便利性. 如表2-1所示,现在有各种可用的扩展,并且能够与Spring Boot进行集成. 闲言少叙,现在我们将spring-boot-starter-thymeleaf依赖添加进来,这样就能启动Thymeleaf模板引擎了: buildscript { ext { springBootVersion = '1.2.5.

《精通Spring MVC 4》——1.9 小结

1.9 小结 我们现在已经有了一个非常简陋的Spring Web应用,虽然我们没有对其进行什么配置,但是它可以输出RESTful JSON的"Hello world".我们已经看到过Spring Boot做了什么.是如何实现的,也了解到如何重写默认的自动配置. 单是详细介绍Spring Boot如何运行就够写一本书了.如果你想更深入探究的话,我推荐一本很棒的书,这就是由Greg Turnquist编写的<Learning Spring Boot>,它和本书是同一个系列的.

《精通Spring MVC 4》——2.2 对MVC的质疑及其最佳实践

2.2 对MVC的质疑及其最佳实践 尽管MVC依然是当前设计UI的首选方案,但是随着它的流行,也有很多对它的批评.实际上,大多数的批评都指向了该模式的错误用法. 2.2.1 贫血的领域模型 Eric Evans编写过一本很有影响力的书,名为<领域驱动设计>(Domain Driven Design,DDD).在这本书中,定义了一组架构规则,能够指导我们更好地将业务领域集成到代码之中. 其中有一项核心的理念就是将面向对象的范式应用到领域对象之中.如果违背这一原则的话,就会被称之为贫血的领域模型(