JS&CSS文件请求合并及压缩处理研究(五)

时间:2021-05-23 03:47:15

接上篇。在我们最终调用 @Html.RenderResFile(ResourceType.Script) 或者 @Html.RenderResFile(ResourceType.StyleSheet) 将页面中添加的文件路径合并成类似以下格式后:

<script type="text/JavaScript" src="Resource/script?href=[Scripts/common/jquery][Scripts/functionA/A1,A2][Scripts/functionB/B1,B2]&compress"></script>

接下来需要做的就是在 Resource/script 中接收压缩后的路径href参数,按顺序读取服务器存取的资源文件,合并,压缩(如果有compress参数传入的话),输出至客户端。有了基本的流程和思路,代码实现其实没有什么难度。看代码:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using Mcmurphy.Common;

namespace Mcmurphy.Web.Controllers
{
    /// <summary>
    /// 资源文件请求处理
    /// </summary>
    public class ResourceController : Controller
    {
        /// <summary>
        /// 处理脚本文件
        /// </summary>
        /// <returns></returns>
        public void Script()
        {
            //原始Url链接
            var rawUri = new Uri(Request.Url.Scheme + "://" + Request.Url.Host + Request.RawUrl);
            //是否压缩参数
            var isCompressJs = rawUri.Query.IndexOf("&compress", StringComparison.OrdinalIgnoreCase) >= 0 
                || rawUri.Query.IndexOf("?compress", StringComparison.OrdinalIgnoreCase) >= 0;
            var queryHref = Request["href"];
            //如果参数为空或者参数中包含有危险字符
            if (string.IsNullOrEmpty(queryHref) || !UrlFilter.FiltUrl(Server.UrlDecode(rawUri.Query)))
            {
                Response.Write("请求参数错误!");
            }
            try
            {
                //请求参数拆分成文件列表
                var jsPaths = PathHelper.QueryToFileList(queryHref, ".js");
                //转成成物理文件列表
                jsPaths = PathHelper.GetPhysicPaths(jsPaths, Request);
                //获取合并后的文件内容(如果标识isCompressJs == true,则需要压缩)
                var finalJsContent = JsCombiner.CombineJs(jsPaths, Server.MapPath("~/"), isCompressJs);
                //替换内容中模板(就简单的替换了一下时间)
                finalJsContent = finalJsContent.Replace("{{now}}", DateTime.Now.ToString("yyyyMMddHHmmss"));
                //输出字节流
                Response.ContentType = "text/javascript";
                Response.BinaryWrite(EncodingHelper.ConvertToUTF8BomEncodingStringBytes(finalJsContent));
                Response.AddHeader("Vary", " Accept-Encoding");
            }
            catch (Exception ex)
            {
                Response.Write(ex.StackTrace);
            }
        }

        /// <summary>
        /// 处理样式文件
        /// </summary>
        /// <returns></returns>
        public void Style()
        {
            var rawUri = new Uri(Request.Url.Scheme + "://" + Request.Url.Host + Request.RawUrl);
            //是否压缩参数
            var isCompressJs = rawUri.Query.IndexOf("&compress", StringComparison.OrdinalIgnoreCase) >= 0
                             || rawUri.Query.IndexOf("?compress", StringComparison.OrdinalIgnoreCase) >= 0;
            var queryHref = Request["href"];
            if (string.IsNullOrEmpty(queryHref) || !UrlFilter.FiltUrl(Server.UrlDecode(rawUri.Query)))
            {
                Response.Write("请求参数错误!");
            }
            try
            {
                //请求参数拆分成文件列表
                var cssPaths = PathHelper.QueryToFileList(queryHref, ".css");
                //转成成物理文件列表
                cssPaths = PathHelper.GetPhysicPaths(cssPaths,Request);
                //获取合并后的文件内容
                var finalCssContent = CssCombiner.CombineAndCompressCss(cssPaths, Server.MapPath("~/"), isCompressJs);
                //输出字节流
                Response.ContentType = "text/css";
                Response.BinaryWrite(EncodingHelper.ConvertToUTF8BomEncodingStringBytes(finalCssContent));
                Response.AddHeader("Vary", " Accept-Encoding");
                
            }
            catch (Exception ex)
            {
                Response.Write(ex.StackTrace);
            }
        }
    }
}

以处理脚本文件的Script Action为例:

1,首先对接收的参数进行常规的空值及危险字符检查。

检查是否存在危险字符的UrlFilter.FiltUrl方法代码为

namespace Mcmurphy.Common
{
    public class UrlFilter
    {
        /// <summary>
        /// 判断是否有特殊字符
        /// </summary>
        /// <param name="url"></param>
        /// <returns></returns>
        public static bool FiltUrl(string url)
        {
            if (url.Contains("&_="))
            {
                return false;
            }
            if (url.Contains("(") || url.Contains(")"))
            {
                return false;
            }
            if (url.Contains("{") || url.Contains("}"))
            {
                return false;
            }
            if (url.Contains(";") || url.Contains(":"))
            {
                return false;
            }

            return true;
        }
    }
}

2,将获取到的诸如“[Scripts/common/jquery][Scripts/functionA/A1,A2][Scripts/functionB/B1,B2]”类型的路径参数,拆分为单独的路径数组,并获取其真实的物理路径,以便读取内容。

3,调用JsCombiner.CombineJs方法,传入物理路径集合,对脚本文件进行合并。如果标记压缩,则需要进行压缩处理。
其中,JsCombiner.CombineJs 方法代码为:

namespace Mcmurphy.Common
{
    public class JsCombiner
    {
        /// <summary>
        /// 拼接js文件内容
        /// </summary>
        /// <param name="jsPaths"></param>
        /// <param name="serverPath"></param>
        /// <param name="isCompress"></param>
        /// <returns></returns>
        public static string CombineJs(string[] jsPaths, string serverPath, bool isCompress)
        {
            var jsBuilder = new StringBuilder();
            foreach (string path in jsPaths)
            {
                if (File.Exists(path))
                {
                    var sourceFileContent = AutoDetectEncodingFileReader.ReadFileContent(path, Encoding.Default);
                    if (string.IsNullOrEmpty(sourceFileContent) == false)
                    {
                        if (isCompress)
                        {
                            var compressor = new JavaScriptCompressor();
                            //ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8, Default (default).
                            compressor.Encoding = Encoding.UTF8;
                            //True (default) | False.  True => Obfuscate function and variable names
                            compressor.ObfuscateJavascript = true;
                            //True | False (default).  True => compress any functions that contain 'eval'. Default is False, which means a function that contains
                            compressor.IgnoreEval = false;
                            //True | False (default).
                            compressor.DisableOptimizations = false;
                            //True | False (default).  True => preserve redundant semicolons (e.g. after a '}'
                            compressor.PreserveAllSemicolons = false;
                            //The position where a line feed is appened when the next semicolon is reached. 
                            compressor.LineBreakPosition = -1;
                            sourceFileContent = compressor.Compress(sourceFileContent);
                        }
                        jsBuilder.Append(sourceFileContent);
                    }
                }
                else
                {
                    jsBuilder.Append(string.Format("/*未找到文件{0}*/", path.Replace(serverPath, "")));
                }
            }
            return jsBuilder.ToString();
        }
    }
}

由上述代码可以看到,对脚本文件的压缩,我们调用了 YUI Compressor for .Net 这个第三方类库。

YUI Compressor for .Net 为脚本的压缩提供了丰富的选项,比如是否进行代码混淆,是否自动在'}'后添加分号,是否进行代码优化,错误日志记录,文件编码等。上面的代码仅仅是最常规的应用。更多信息可以参考其开源地址:http://yuicompressor.codeplex.com/,在该页面的 documentation 标签下,可以查看到更多的使用说明。

需要说明的是,在调用最新的YUI Compressor for .Net 对脚本文件进行压缩时,需要添加三个引用:

EcmaScript.NET.dll
Yahoo.Yui.Compressor.Build.MsBuild.dll
Yahoo.Yui.Compressor.dll

4,将合并[压缩]后的内容,以UTF-8 BOM的字符流形式输出至客户端。

其中EncodingHelper.ConvertToUTF8BomEncodingStringBytes代码为:

namespace Mcmurphy.Common
{
    public static class EncodingHelper
    {
        /// <summary>
        /// 为字符串添加BOM头信息
        /// 让客户端正确识别UTF-8编码
        /// </summary>
        /// <param name="originalString"></param>
        /// <returns></returns>
        public static byte[] ConvertToUTF8BomEncodingStringBytes(string originalString)
        {
            var bom = Encoding.UTF8.GetPreamble();
            var content = Encoding.UTF8.GetBytes(originalString);
            var resultBytes = new byte[bom.Length + content.Length];
            bom.CopyTo(resultBytes, 0);
            content.CopyTo(resultBytes, bom.Length);
            return resultBytes;
        }
    }
}

接下来我们定位到Mcmurphy.Web项目,在Scripts文件夹下添加几个脚本文件,测试一下。

Scripts/common/jquery.js   

Scripts/functionA/A1.js :   
$(function() {
    console.log("folder:functionA,name:A1.js");
});

Scripts/functionA/A2.js :
$(function() {
    console.log("folder:functionA,name:A2.js");
});

Scripts/functionB/B1.js :
$(function () {
    console.log("folder:functionB,name:B1.js");
});

Scripts/functionB/B2.js :   
$(function () {
    console.log("folder:functionB,name:B2.js");
});

然后我们将 Views/Shared/_Layout.cshtml 布局文件修改为:

<!DOCTYPE html>
<html>
<head>
    <title>@ViewBag.Title</title>
    @{
        Html.AppendResFile(ResourceType.StyleSheet, "[Content/common]");
        Html.AppendResFile(ResourceType.Script, "[Scripts/common/jquery]");
        
        @RenderSection("Head_Section", false)
    }
    @Html.RenderResFile(ResourceType.StyleSheet)
</head>

<body>
    @RenderBody()
    
    @RenderSection("Foot_Section", false)

    @Html.RenderResFile(ResourceType.Script)
</body>
</html>

再定位到 Views/Home/Index.cshtml 文件,修改其内容为:

@{
    ViewBag.Title = "Index";
}
@section Head_Section{
    @{
        //添加样式文件A
        Html.AppendResFile(ResourceType.StyleSheet, "[Content/Styles/styleA]"); 
        //添加样式文件B,但设置了高优先级
        Html.AppendResFile(ResourceType.StyleSheet, "[Content/Styles/styleB]","",PriorityType.High);

        //添加脚本文件functionA/A1,functionB/B1
        Html.AppendResFile(ResourceType.Script, "[Scripts/functionA/A1],[Scripts/functionB/B1]");
    }
}
@section Foot_Section{
    @{
        //添加脚本文件functionA/A2,functionB/B2
        Html.AppendResFile(ResourceType.Script, "[Scripts/functionA/A2],[Scripts/functionB/B2]");
    }
}
<h2>Index</h2>

(关于ASP.NET MVC及Razor,在此不再赘述)

Okay,Ctrl + F5 直接运行。查看浏览器网络请求及控制台

JS&CSS文件请求合并及压缩处理研究(五)

可以看到已合并的样式及脚本文件网络请求,而控制台也得到了正确的输出。

当然,也可以直接在浏览器地址栏输出Url,查看到合并[压缩]后的脚本或样式文件。

http://localhost:17509/Resource/Script?href=[Scripts/common/jquery][Scripts/functionA/A1,A2][Scripts/functionB/B1,B2]&compress

或者:

http://localhost:17509/Resource/Style?href=[Content/Styles/styleB][Content/common][Content/Styles/styleA]&compress

至此关于JS&CSS文件的请求合并及压缩处理的实现就告一段落。当然,在此优化的基础上其实还有很多其它方面的工作可做。比如可将Resource/[Script][Style]的处理,放到独立的资源服务器,可以得到额外的CDN的好处。另外,诸如脚本样式等文件通常都为静态资源,并不会经常变动,可以考虑在服务器做一些缓存及版本号方面的控制等。

最后附上全部源码种子:

MvcResourceHandle.rar