Полное решение для объединения, минимизации и GZIP ваших стилей и скриптов на Asp.Net MVC3 с использованием Razor - PullRequest
7 голосов
/ 26 октября 2011

Извините за мой плохой английский, но я думаю, это не будет проблемой. Я просто не хочу делиться хорошим классом помощника, который я создал для объединения , минимизации и gzip наших скриптов и стилей с использованием Microsoft Ajax Minifier . Перед началом загрузите ICSharpCode.SharpZipLib . Это библиотека с открытым исходным кодом для использования gzip .

Давайте начнем с web.config (я сосредоточусь на IIS7). Здесь мы говорим нашему приложению, что любой запрос, сделанный к расширениям cssh или jsh , будет перенаправлен в класс MinifierHelper . Я решил использовать эти расширения ( cssh и jsh ), чтобы, если мы хотим по какой-либо причине не минимизировать конкретный сценарий или стиль, используйте его обычным образом.

<system.webServer>
  <handlers>
    <remove name="ScriptHandler" />
    <remove name="StyleHandler" />
    <add name="ScriptHandler" verb="*" path="*.jsh" type="Site.Helpers.MinifierHelper" resourceType="Unspecified" />
    <add name="StyleHandler" verb="*" path="*.cssh" type="Site.Helpers.MinifierHelper" resourceType="Unspecified" />
  </handlers>
</system.webServer>

Я использую папки Scripts и Styles для хранения файлов. Я не использую папку Content, как это предлагается Visual Studio.

Следующим шагом является настройка global.asax. Мы должны указать нашему приложению не маршрутизировать эти папки. Добавьте эти строки в ваш RegisterRoutes метод.

public static void RegisterRoutes(RouteCollection routes)
{
    routes.IgnoreRoute("Scripts/{*path}");
    routes.IgnoreRoute("Styles/{*path}");
    ...
}

OK. Теперь я покажу, как использовать наш класс. В представлении:

<link href="/Styles/Folder/File.cssh" type="text/css" rel="stylesheet" />
<script src="/Scripts/Folder/File.jsh" type="text/javascript"></script>

В моем примере я сделал логику для всех моих скриптов и стилей, чтобы они находились внутри папок внутри скриптов / стилей. Пример: Сайт -> Сценарии -> Домой -> index.css . Я использую ту же структуру, что и в представлениях к сценариям и стилям. Пример: Сайт -> Просмотры -> Главная страница -> index.cshtml . Вы можете изменить этот шаблон, если хотите.

Теперь код для создания магии:

using System;
using System.Collections.Generic;
using System.Configuration;
using System.Globalization;
using System.IO;
using System.Reflection;
using System.Text;
using System.Text.RegularExpressions;
using System.Web;
using System.Web.Caching;
using System.Web.SessionState;
using ICSharpCode.SharpZipLib.GZip;
using Microsoft.Ajax.Utilities;

namespace Site.Helpers
{
    public abstract class MinifierBase : IHttpHandler, IRequiresSessionState
    {
        #region Fields

        private HttpContext context;
        private byte[] responseBytes;
        private bool isScript;

        protected string fileName;
        protected string folderName;
        protected List<string> files;

        #endregion

        #region Properties

        public bool IsReusable
        {
            get { return false; }
        }

        #endregion

        #region Methods

        public static string setUrl(string url)
        {
            var publishDate = ConfigurationManager.AppSettings["PublishDate"];
            return url + "h" + ((publishDate != null) ? "?id=" + publishDate : "");
        }

        public void ProcessRequest(HttpContext context)
        {
            this.context = context;
            this.isScript = context.Request.Url.PathAndQuery.Contains("/Scripts/");
            this.process();
        }

        private void process()
        {
            if (this.context.Request.QueryString.HasKeys())
            {
                string url = this.context.Request.Url.PathAndQuery;

                if (this.context.Cache[url] != null)
                {
                    this.responseBytes = this.context.Cache[url] as byte[];
                }
                else
                {
                    this.writeResponseBytes();
                    this.context.Cache.Add
                    (
                        url,
                        this.responseBytes,
                        null,
                        DateTime.Now.AddMonths(1),
                        Cache.NoSlidingExpiration,
                        CacheItemPriority.Low,
                        null
                    );
                }
            }
            else
            {
                this.writeResponseBytes();
            }

            this.writeBytes();
        }

        private void writeResponseBytes()
        {
            using (MemoryStream ms = new MemoryStream(8092))
            {
                using (Stream writer = this.canGZip() ? (Stream)(new GZipOutputStream(ms)) : ms)
                {
                    var sb = new StringBuilder();
                    var regex = new Regex(@"^/.+/(?<folder>.+)/(?<name>.+)\..+");
                    var url = regex.Match(this.context.Request.Path);
                    var folderName = url.Groups["folder"].Value;
                    var fileName = url.Groups["name"].Value;

                    this.getFileNames(fileName, folderName).ForEach(delegate(string file)
                    {
                        sb.Append(File.ReadAllText(this.context.Server.MapPath(file)));
                    });

                    var minifier = new Minifier();
                    var minified = string.Empty;

                    if (this.isScript)
                    {
                        var settings = new CodeSettings();

                        settings.LocalRenaming = LocalRenaming.CrunchAll;
                        settings.OutputMode = OutputMode.SingleLine;
                        settings.PreserveImportantComments = false;
                        settings.TermSemicolons = true;

                        minified = minifier.MinifyJavaScript(sb.ToString(), settings);
                    }
                    else
                    {
                        var settings = new CssSettings();

                        settings.CommentMode = CssComment.Important;
                        settings.OutputMode = OutputMode.SingleLine;

                        minified = minifier.MinifyStyleSheet(sb.ToString(), settings);
                    }

                    var bts = Encoding.UTF8.GetBytes(minified);

                    writer.Write(bts, 0, bts.Length);
                }

                this.responseBytes = ms.ToArray();
            }
        }

    private List<String> getFileNames(string fileName, string folderName = "")
    {
        this.files = new List<String>();
        this.fileName = fileName;
        this.folderName = folderName;

        if (folderName == "Global" && fileName == "global-min")
        {
            if (this.isScript) this.addGlobalScripts();
            else this.addDefaultStyles();
        }
        else
        {
            var flags = BindingFlags.NonPublic | BindingFlags.InvokeMethod | BindingFlags.Instance;
            var mi = this.GetType().GetMethod
            (
                "add" +
                this.folderName +
                CultureInfo.CurrentCulture.TextInfo.ToTitleCase(fileName).Replace("-", "") +
                (this.isScript ? "Scripts" : "Styles"),
                flags
            );

            if (mi != null)
            {
                mi.Invoke(this, null);
            }
            else
            {
                if (this.isScript) this.addDefaultScripts();
                else this.addDefaultStyles();
            }
        }

        return files;
    }

    private void writeBytes()
    {
        var response = this.context.Response;

        response.AppendHeader("Content-Length", this.responseBytes.Length.ToString());
        response.ContentType = this.isScript ? "text/javascript" : "text/css";

        if (this.canGZip())
        {
            response.AppendHeader("Content-Encoding", "gzip");
        }
        else
        {
            response.AppendHeader("Content-Encoding", "utf-8");
        }

        response.ContentEncoding = Encoding.Unicode;
        response.OutputStream.Write(this.responseBytes, 0, this.responseBytes.Length);
        response.Flush();
    }

    private bool canGZip()
    {
        string acceptEncoding = this.context.Request.Headers["Accept-Encoding"];
        return (!string.IsNullOrEmpty(acceptEncoding) && (acceptEncoding.Contains("gzip") || acceptEncoding.Contains("deflate")));
    }

    protected abstract void addGlobalScripts();
    protected abstract void addGlobalStyles();
    protected abstract void addDefaultScripts();
    protected abstract void addDefaultStyles();

    #endregion
}

Это базовый класс. Теперь мы создадим класс Helper, который наследуется от базового класса. Это класс, в котором мы выбираем, какие сценарии следует добавить.

public class MinifierHelper : MinifierBase
{
    #region Methods

Чтобы объединить и минимизировать глобальные сценарии / стили, добавьте текущую строку в ваш просмотр:

<link href="@MinifierHelper.setUrl("/Styles/Global/global-min.css")" type="text/css" rel="stylesheet" />
<script src="@MinifierHelper.setUrl("/Scripts/Global/global-min.js")" type="text/javascript"></script>

Он вызовет методы addGlobalScripts / addGlobalStyles в нашем MinifierHelper классе.

    protected override void addGlobalScripts()
    {
        this.files.Add("~/Scripts/Lib/jquery-1.6.2.js");
        this.files.Add("~/Scripts/Lib/jquery-ui-1.8.16.js");
        this.files.Add("~/Scripts/Lib/jquery.unobtrusive-ajax.js");
        this.files.Add("~/Scripts/Lib/jquery.validate.js");
        ...
    }

    protected override void addGlobalStyles()
    {
        this.files.Add("~/Styles/Global/reset.css");
        this.files.Add("~/Styles/Global/main.css");
        this.files.Add("~/Styles/Global/form.css");
        ...
    }

Чтобы минимизировать конкретный скрипт / стиль (специфичный для страницы), добавьте текущую строку в ваш просмотр:

<link href="@MinifierHelper.setUrl("/Styles/Curriculum/index.css")" type="text/css" rel="stylesheet" />

Класс MinifierHelper попытается найти метод с именем «add» + FolderName + FileName + «Styles» . В нашем случае он будет искать addCurriculumIndexStyles . В моем примере он существует, поэтому метод будет запущен.

    public void addCurriculumIndexStyles()
    {
        this.files.Add("~/Styles/Global/curriculum.css");
        this.files.Add("~/Styles/Curriculum/personal-info.css");
        this.files.Add("~/Styles/Curriculum/academic-info.css");
        this.files.Add("~/Styles/Curriculum/professional-info.css");
    }

Если класс не найдет этот конкретный метод, он вызовет метод по умолчанию. Метод по умолчанию минимизирует сценарий / стиль, используя ту же самую папку / указанное имя.

protected override void addDefaultScripts()
{
    this.files.Add("~/Scripts/" + this.folderName + "/" + this.fileName + ".js");
}

protected override void addDefaultStyles()
{
    this.files.Add("~/Styles/" + this.folderName + "/" + this.fileName + ".css");
}

Не забудьте закрыть регион и класс.

    #endregion
}

Вот и все. Надеюсь, вы, ребята, поняли.

Я забыл сказать одну последнюю вещь. В файле web.config добавьте ключ в AppSettings с именем PublishDate. Я вставил в значение строку с полной датой и временем (например, 261020111245). Цель - быть уникальным. Этот ключ будет использоваться для кэширования наших минимизированных скриптов. Если вы не создадите этот ключ, ваше приложение не будет использовать кеш. Я рекомендую использовать это. Поэтому каждый раз, когда вы обновляете свои скрипты / стили, обновляйте и свою PublishDate.

<add key="PublishDate" value="261020111245" />

1 Ответ

1 голос
/ 19 ноября 2011

Mindscape Web Workbench - отличный инструмент для выполнения искомых предметов.

http://visualstudiogallery.msdn.microsoft.com/2b96d16a-c986-4501-8f97-8008f9db141a

Вот хороший пост в блоге об этом:

http://visualstudiogallery.msdn.microsoft.com/2b96d16a-c986-4501-8f97-8008f9db141a

...