Nancy之给我们的网站添加自定义图标

当我们在做一个网站时，可能经常会有这样一个需求，要给我们做的网站添加一个自定义的图标。

在Nancy中，默认是的下面这样

一个妹子的头像，其实也是挺好看的！！

那么当我们想要替换这个默认的，应该要怎么做呢？

下面就来看看具体的实现

首先，准备一张名为 favicon.ico或 favicon.png 图片

这里有两种实现方法提供参考

方法一：替换默认的图标(IRootPathProvider的实现)

如果我们是使用默认的IRootPathProvider的实现，这个时候，我们直接添加图片在我们的项目根目录即可

Nancy会去搜索这个默认的RootPath的favicon资源，它找到的第一个就将会是我们网站的图标。

效果如下：

有时候，默认的不一定是最好的，所以我们可以

自己去实现IRootPathProvider这个接口，但一个项目中，只能有一个实现(除了默认的)

具体如下

     public class CustomRootPathProvider : IRootPathProvider
     {
         public string GetRootPath()
         {
             return AppDomain.CurrentDomain.GetData(".appPath").ToString();
         }
     }  

其中，GetRootPath返回的是绝对路径！！

这个路径可以用你能想到的任何方式得到！

然后，我们需要在“引导程序”中做点事

      protected override IRootPathProvider RootPathProvider
         {
             get { return new CustomRootPathProvider(); }
         } 

这样做是比较保险的一种做法(不需要特地将我们的图片资源设置为嵌入的资源)

方法二：使用嵌入的图标(Override FavIcon)

这种方法需要我们去重写 FacIcon这个方法

     protected override byte[] FavIcon
         {
             get { return this.favicon ?? (this.favicon = LoadFavIcon()); }
         }
         private byte[] LoadFavIcon()
         {
             using (var resourceStream = GetType().Assembly.GetManifestResourceStream("NancyFavIconDemo.favicon.ico"))
             {
                 var tempFavicon = new byte[resourceStream.Length];
                 resourceStream.Read(tempFavicon, , (int)resourceStream.Length);
                 return tempFavicon;
             }
         }  

其中，GetMainifestResourceStream的参数是“程序集名称.资源名称”(NancyFavIconDemo是我这个Demo的程序集名称，favicon.ico是我在根目录的一个图片)

还有重要的一步是

将我们的图片属性中的Build Action设置为 Embedded Resource(嵌入的资源)

具体原因我们可以参考Assembly.GetManifestResourceStream Method (String)里面的Remark

A manifest resource is a resource (such as an image file) that is embedded in the assembly at compile time. 

此时，我们同样可以看到相同的效果

如果 我们没有设置为嵌入的资源，那么我们的resourceStream对象将一直为空

 

下面我们来看看Nancy这一块内容的内部实现

关于favicon的实现就是在FavIconApplicationStartup.cs里面

来看看它的描述

就像前面说的，它会去找favicon，找到就用找到的，没找到就用默认的。

 

里面有一个带IRootPathProvider参数构造函数，可以简单理解为指定要搜索的范围。

         /// <summary>
         /// Initializes a new instance of the <see cref="FavIconApplicationStartup"/> class, with the
         /// provided <see cref="IRootPathProvider"/> instance.
         /// </summary>
         /// <param name="rootPathProvider">The <see cref="IRootPathProvider"/> that should be used to scan for a favicon.</param>
         public FavIconApplicationStartup(IRootPathProvider rootPathProvider)
         {
             FavIconApplicationStartup.rootPathProvider = rootPathProvider;
         }

下面是默认的图标实现方法，我们override的实现和它的基本一致！！

         private static byte[] ExtractDefaultIcon()
         {
             var resourceStream =
                 typeof(INancyEngine).Assembly.GetManifestResourceStream("Nancy.favicon.ico");

             if (resourceStream == null)
             {
                 return null;
             }

             var result =
                 new byte[resourceStream.Length];

             resourceStream.Read(result, , (int)resourceStream.Length);

             return result;
         }    

默认图标在ErrorPipeline.cs和FormatterExtensions.cs之间(不细心去看，压根就看不见)

 

里面还有一个“搜索”图标的方法

          private static byte[] LocateIconOnFileSystem()
         {
             if (rootPathProvider == null)
             {
                 return null;
             }

             var extensions = new[] { "ico", "png" };

             var locatedFavIcon = extensions.SelectMany(EnumerateFiles).FirstOrDefault();
             if (locatedFavIcon == null)
             {
                 return null;
             }

             try
             {
                 return File.ReadAllBytes(locatedFavIcon);
             }
             catch (Exception e)
             {
                 if (!StaticConfiguration.DisableErrorTraces)
                 {
                     throw new InvalidDataException("Unable to load favicon", e);
                 }

                 return null;
             }
         }

我们可以发现，我们用的后缀可以是.ico和.png。