超轻量级spring模板方案

2021-07-19 03:14:03

最近从事的工作是web方面的，主要j2ee，spring jsp这些内容，由于刚入门，很多的技术都不了解。所谓初生牛犊不怕虎，刚入门，各种不顺手，比如写jsp，总是重复很多的代码，各种不爽，然后就去看jsp的模板技术，

看来看去也是各种不爽，于是就有了自己写一个工具的想法。

ok，废话一堆。先说说jsp模板，最简单的include，成熟的解决有tiles，还有什么setmesh，当日还有更强大的什么fremaker，volocity（是这样写的吗，记不清楚）等等。

include不说，实在太简陋，tiles其实是很不错的，不是很重，学习成本还算好，用的也比较广吧，当然要说广，肯定有后面那几个了。可是这些对我来说，都太重。我要的是什么样的？我记得rails里面的模板，大概就是layout里面写一句yield就ok了。

没错，这就是我想要的。写好layout，把什么header、menu什么的搞定，内容里面一个div套着一个yield，你就可以专注于你的子视图了，框架自动把layout应用到你的视图上去。

就这个简单的功能，为什么要那么复杂的框架、插件呢？

不过jsp，看看好像还真没有。那就自己实现吧，反正我是初入门，什么都不知道，不知者无畏嘛。

屁话一堆，总算到该说些正题了。

那么，怎么实现呢？我的思路是，layout里面写好布局后，正文部分就用${yield}代替，

当请求子视图的时候，自动的将子视图插入到layout中，替换${yield}，然后生成一个新的合成视图，存入缓存文件中，由新的视图相应前端的请求。

我们知道spring里面有个配置viewresolver的类，可以在有请求的时候，查找视图，构建视图，并返回给前端。我们就在这里做我们的事情。

我们继承一个InternalResourceViewResolver，该resolver会根据视图查找相应的InternalResourceView来处理jsp视图。InternalResourceViewResolver有一个buildView的调用，该调用根据视图名称构建view。

我们就重载这个方法，根据前面的思路，首先找到模板文件和子视图，然后替换掉模板文件中的${yield}，写入到新的jsp文件，然后重定向到该文件，就ok了。具体看代码：

 package lin.layoutsample.framework;

 import lin.layoutsample.utils.FileUtils;

 import lin.layoutsample.utils.StringUtils;

 import org.springframework.web.servlet.view.AbstractUrlBasedView;

 import org.springframework.web.servlet.view.InternalResourceViewResolver;

 public class LayoutViewResolver extends InternalResourceViewResolver {

     private static String DEFUALT_YIELD_CMD = "${yield}";

     private static String DEFUALT_LAYOUT_TEMP_DIR = "/WEB-INF/layout/layout_temp";

     private static String DEFUALT_LAYOUT = "/WEB-INF/layout/layout.jsp";

     /**

      * layout文件。默认为/WEB-INF/layout/layout.jsp。

      * */

     private String layout = DEFUALT_LAYOUT;

     /**

      * 经过替换后的视图缓存目录，默认为/WEB-INF/layout/layout_temp。

      * */

     private String temp_path = DEFUALT_LAYOUT_TEMP_DIR;

     /**

      * 默认为${yield}。模板中该命令会被子视图替换。类似rails的yield。

      * */

     private String yield_cmd = DEFUALT_YIELD_CMD;

     /**

      *

      * 函数首先根据指定的view在缓存区生成对应的文件，然后将模板文件（默认为layout.jsp）中的${yield}替换成视图的内容。

      * 再调用超类的buildview函数生成新的被视图并返回。这样就完成了模板的替换和重定向到新生成的视图。

      * */

     @Override

     protected AbstractUrlBasedView buildView(String viewName) throws Exception {

         String url = getPrefix() + viewName + getSuffix();

         String target_view_real_path = super.getServletContext().getRealPath(

                 getTemp_path())

                 + url;

         FileUtils.createFile(target_view_real_path);

         String layout_real_path = super.getServletContext().getRealPath(

                 getLayout());

         String layout_content = FileUtils.read(layout_real_path);

         String view_content = FileUtils.read(super.getServletContext()

                 .getRealPath(url));

         String result_view_content = StringUtils.replace(layout_content, "\\Q"

                 + getYield_cmd() + "\\E", view_content);

         FileUtils.write(target_view_real_path, result_view_content);

         AbstractUrlBasedView view = super.buildView(getTemp_path() + getPrefix()+ viewName);

         return view;

     }

     public String getLayout() {

         return layout;

     }

     public void setLayout(String layout) {

         this.layout = layout;

     }

     public String getTemp_path() {

         return temp_path;

     }

     public void setTemp_path(String temp_path) {

         this.temp_path = temp_path;

     }

     public String getYield_cmd() {

         return yield_cmd;

     }

     public void setYield_cmd(String yield_cmd) {

         this.yield_cmd = yield_cmd;

     }

 }

是不是很简单？只需要一个方法，然后就是在web的配置里面将默认的InternalResourceViewResolver 替换成我们的就可以了。

 <?xml version="1.0" encoding="UTF-8"?>

 <beans xmlns="http://www.springframework.org/schema/beans"

     xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

     xmlns:p="http://www.springframework.org/schema/p" xmlns:context="http://www.springframework.org/schema/context"

     xmlns:dwr="http://www.directwebremoting.org/schema/spring-dwr"

     xmlns:security="http://www.springframework.org/schema/security"

     xsi:schemaLocation="http://www.springframework.org/schema/beans

 http://www.springframework.org/schema/beans/spring-beans.xsd

 http://www.springframework.org/schema/context

 http://www.springframework.org/schema/context/spring-context.xsd

 http://www.springframework.org/schema/mvc

 http://www.springframework.org/schema/mvc/spring-mvc.xsd

 http://www.directwebremoting.org/schema/spring-dwr

 http://www.directwebremoting.org/schema/spring-dwr-2.0.xsd

 http://www.springframework.org/schema/security

 http://www.springframework.org/schema/security/spring-security-3.2.xsd

 ">

     <!-- 自动扫描controller包下的所有类，使其认为spring mvc的控制器 -->

     <context:component-scan base-package="lin.layoutsample.controller" />

     <!-- 通过注解，把URL映射到Controller上，该标签默认注册DefaultAnnotationHandlerMapping和AnnotationMethodHandlerAdapter -->

     <mvc:annotation-driven />

     <!-- 对模型视图名称的解析，即在模型视图名称添加前后缀 -->

     <bean class="lin.layoutsample.framework.LayoutViewResolver">

         <property name="prefix" value="/" />

         <property name="suffix" value=".jsp" />

         <property name="layout" value="/WEB-INF/layout/layout.jsp" />

     </bean>

 </beans>

这里我们可以配置我们的模板文件（一般叫layout.jsp）的路径，当然你也可以不用${yield}来占位，你可以自己配置成属性就行了。

完整的layout.jsp文件如下，路径我一般放在/WEB-INF/layout/下面。

 <%@ page language="java" contentType="text/html; charset=UTF-8"

     pageEncoding="UTF-8"%>

 <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>

 <!DOCTYPE html>

 <html>

 <%

     String path = request.getContextPath();

     String basePath = request.getScheme() + "://"

             + request.getServerName() + ":" + request.getServerPort()

             + path + "/";

 %>

 <base href="<%=basePath%>">

 <head>

 <%@include file="/WEB-INF/layout/_include.jsp"%>

 <title>花花世界</title>

 </head>

 <body>

     <%@include file="/WEB-INF/layout/_header.jsp"%>

     <div class="container-fluid">

         <div class="row">

             <%@ include file="/WEB-INF/layout/_menu.jsp"%>

             <div class="page-content">

                 <div class="container-fluid" data-role="main">

                     <!-- Main component for a primary marketing message or call to action -->

                     ${yield}

                 </div>

                 <!-- container-fluid -->

             </div>

             <!-- page-content -->

         </div>

     </div>

     <!-- /container -->

     <%@include file="/WEB-INF/layout/_import.jsp"%>

 </body>

 </html>

子视图就很简单了只需要一行示例代码就行了，文件say-hi.jsp如下。

 <h2>hi world!!</h2>

我们的控制器完全不需要考虑模板的事情，新建一个子视图返回就行了。

 package lin.layoutsample.controller;

 import org.slf4j.Logger;

 import org.slf4j.LoggerFactory;

 import org.springframework.stereotype.Controller;

 import org.springframework.web.bind.annotation.RequestMapping;

 import org.springframework.web.servlet.ModelAndView;

 @Controller

 @RequestMapping("/hello")

 public class HelloController {

     private Logger logger = LoggerFactory.getLogger(HelloController.class);

     @RequestMapping("/say-hi")

     public ModelAndView sayHi(){

         logger.debug("HelloController:sayHi");

         ModelAndView mv = new ModelAndView("WEB-INF/views/say-hi");

         return mv;

     }

 }

效果如下图：

是不是很简单，对开发者来说，只需要配置一下，别的都不需要关心，就可以完成模板布局的应用了。

不过我是初学，入门，哪些商业的模板工具自然有他得用武之地，我这个超轻量级的模板解决方案，写写小网页还是足够了。

有兴趣的tx可以去github上下载我的代码https://github.com/linbirg/wish。

欢迎大神批评指正。

码农公寓

相关文章