docs:项目说明文档更新

Docs/项目说明.md

@@ -1,12 +1,13 @@
 项目说明
 =======
+
 项目主要学习WebAPI启动项设置，特别是默认启始页设置。特别是在部署为子站点时的默认启动页。
 
 常用方法：
 
 + 路由+重定向
   
-  ```charp
+  ```csharp
     //6.0及以上版本
     app.Map("/", async context =>
     {
@@ -16,8 +17,6 @@
     }); 
   
     //或者MapGet方法
-    
-   
     //老版本写法
     app.UseEndpoints(endpoints => 
     {
@@ -28,9 +27,10 @@
         });
     });
   ```
+
 + 路由+自定义内容
 
-  ```charp
+  ```csharp
     namespace LaunchUrlStudy.SubSite2
     {
         public class Program
@@ -128,7 +128,8 @@
   ```
 
 + 自定义中间件+重定向
-  ```charp
+  
+  ```csharp
     namespace LaunchUrlStudy.SubSite4
     {
       public class Program
@@ -163,12 +164,10 @@
                   }
               });
   
-
               app.Run();
           }
       }
     }
-  
   ```
 
 + 第三方中间件:`Swagger中间件` 不支持子站点
@@ -197,8 +196,6 @@
               });
 
               app.UseAuthorization();
-
-
               app.MapControllers();
 
               app.Run();
@@ -210,7 +207,7 @@
 
 + 第三方中间件:`健康检查中间件` 即默认为健康检查地址
   
-  ```charp
+    ```csharp
       namespace LaunchUrlStudy.SubSite6
       {
           public class Program
@@ -241,7 +238,47 @@
 + 使用静态文件服务器：UseDefaultFiles和UseStaticFiles
   
     ```csharp
+      namespace LaunchUrlStudy.SubSite7
+      {
+          public class Program
+          {
+              public static void Main(string[] args)
+              {
+                  var builder = WebApplication.CreateBuilder(args);
+  
+                  // Add services to the container.
   
+                  builder.Services.AddControllers();
+                  builder.Services.AddEndpointsApiExplorer();
+                  builder.Services.AddSwaggerGen();
+  
+                  var app = builder.Build();
+  
+                  app.UseSwagger();
+                  app.UseSwaggerUI();
+  
+                  app.UseAuthorization();
+                  app.MapControllers();
+  
+                  // 配置启动地址(支持子站点):静态文件服务器默认页
+                  // 只能是wwwroot里的静态真实文件，不能是"swagger/index.html"(因为它是㠌入的资源文件，不在wwwroot中)
+                  app.UseDefaultFiles(new DefaultFilesOptions()
+                  {
+                      DefaultFileNames = new[] 
+                      { 
+                          //可以是静态文件
+                          "index.html",
+                      
+                          //不能是虚拟文件：因为它是㠌入的资源文件，不在wwwroot中
+                          //"swagger/index.html"
+                      }
+                  });
+                  app.UseStaticFiles();
+  
+                  app.Run();
+              }
+          }
+      }
     ```
 
 + 环境变量与配置文件：不推荐
@@ -250,9 +287,9 @@
   这需要事先知道子站点的值，不灵活。环境变量可以在Docker中使用，配置文件就太不灵活了。
 
 + 部署配置
-  在部署ASP.NET 6 Web API时，配置服务器或反向代理服务器（如Nginx或Apache）来处理默认请求。例如，在Nginx配置中设置默认页面：
+  在部署 ASP.NET 6 Web API时，配置服务器或反向代理服务器（如Nginx或Apache）来处理默认请求。例如，在Nginx配置中设置默认页面：
   
-  ``` txt
+    ```lua
       server {
         listen 80;
         server_name yourdomain.com;
@@ -265,13 +302,13 @@
             proxy_cache_bypass $http_upgrade;
           }
         }
-
     ```
 
 + 使用URL重写规则 不推荐
   在使用IIS或Nginx等软件代理时，可以设置URL重写规则。因为需要引入组件和配置规则，相对来说太麻烦，不推荐使用。
 
 总结：
+
 + 优先使用: 自定义路由(重定向或自定义内容或文件) 和 自定义中间件，简单、灵活、支持站点也支持子站点；
 + 如果启用了静态站点服务，可以配置 UseDefaultFiles ，可以指定静态站点中的html文档；
 + 如果默认地址，用作 `健康检查路径`，也可以直接设置`健康检查路径`为站点首页；