feat: ZIP streaming decompression

Starward.sln

@@ -16,6 +16,8 @@ Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "Starward.Launcher", "src\St
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Starward.Language", "src\Starward.Language\Starward.Language.csproj", "{5FC2380B-F424-4EAE-BDEE-C0D4D4B1C7CF}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Starward.Core.ZipStreamDownload", "src\Starward.Core.ZipStreamDownload\Starward.Core.ZipStreamDownload.csproj", "{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -92,6 +94,22 @@ Global
 		{5FC2380B-F424-4EAE-BDEE-C0D4D4B1C7CF}.Release|x64.Build.0 = Release|Any CPU
 		{5FC2380B-F424-4EAE-BDEE-C0D4D4B1C7CF}.Release|x86.ActiveCfg = Release|Any CPU
 		{5FC2380B-F424-4EAE-BDEE-C0D4D4B1C7CF}.Release|x86.Build.0 = Release|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Debug|ARM64.ActiveCfg = Debug|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Debug|ARM64.Build.0 = Debug|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Debug|x64.Build.0 = Debug|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Debug|x86.Build.0 = Debug|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Release|Any CPU.Build.0 = Release|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Release|ARM64.ActiveCfg = Release|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Release|ARM64.Build.0 = Release|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Release|x64.ActiveCfg = Release|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Release|x64.Build.0 = Release|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Release|x86.ActiveCfg = Release|Any CPU
+		{AAD0ECEC-1814-4CCE-AF0D-EF1C9EB627DA}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

src/Starward.Core.ZipStreamDownload/Exceptions/CrcVerificationFailedException.cs

@@ -0,0 +1,39 @@
+using System.Diagnostics.CodeAnalysis;
+using Starward.Core.ZipStreamDownload.Resources;
+
+namespace Starward.Core.ZipStreamDownload.Exceptions;
+
+/// <summary>
+/// 当CRC校验失败时引发的异常
+/// </summary>
+public class CrcVerificationFailedException : ZipStreamDownloadException
+{
+    /// <summary>
+    /// 创建一个当CRC校验失败时引发的异常的实例。
+    /// </summary>
+    /// <param name="message">异常消息</param>
+    public CrcVerificationFailedException(string? message) : base(message)
+    {
+    }
+
+    /// <summary>
+    /// 创建一个当CRC校验失败时引发的异常的实例。
+    /// </summary>
+    /// <param name="message">异常消息</param>
+    /// <param name="innerException">引发该异常的异常</param>
+    public CrcVerificationFailedException(string? message, Exception? innerException) : base(message, innerException)
+    {
+    }
+
+    /// <summary>
+    /// 使用ZipEntry的名称引发CRC校验失败时引发的异常。
+    /// </summary>
+    /// <param name="zipEntryName">ZipEntry的名称</param>
+    /// <exception cref="InvalidZipEntryNameException">当CRC校验失败时引发此异常。</exception>
+    [DoesNotReturn]
+    internal static void ThrowByZipEntryName(string zipEntryName)
+    {
+        throw new InvalidZipEntryNameException(
+            string.Format(ExceptionMessages.CrcVerificationFailedExceptionMessage, zipEntryName));
+    }
+}

src/Starward.Core.ZipStreamDownload/Exceptions/FeatureNotSupportedException.cs

@@ -0,0 +1,39 @@
+using System.Diagnostics.CodeAnalysis;
+using Starward.Core.ZipStreamDownload.Resources;
+
+namespace Starward.Core.ZipStreamDownload.Exceptions;
+
+/// <summary>
+/// 当解压ZIP文件所需的功能不受支持时引发的异常。
+/// </summary>
+public class FeatureNotSupportedException : ZipStreamDownloadException
+{
+    /// <summary>
+    /// 创建一个当解压ZIP文件所需的功能不受支持时引发的异常的实例。
+    /// </summary>
+    /// <param name="message">异常消息</param>
+    public FeatureNotSupportedException(string? message) : base(message)
+    {
+    }
+
+    /// <summary>
+    /// 创建一个当解压ZIP文件所需的功能不受支持时引发的异常的实例。
+    /// </summary>
+    /// <param name="message">异常消息</param>
+    /// <param name="innerException">引发该异常的异常</param>
+    public FeatureNotSupportedException(string? message, Exception? innerException) : base(message, innerException)
+    {
+    }
+
+    /// <summary>
+    /// 使用原因引发解压ZIP文件所需的功能不受支持的异常。
+    /// </summary>
+    /// <param name="reason">引发该异常的原因</param>
+    /// <exception cref="InvalidZipEntryNameException">当解压ZIP文件所需的功能不受支持时引发此异常。</exception>
+    [DoesNotReturn]
+    internal static void ThrowByReason(string reason)
+    {
+        throw new InvalidZipEntryNameException(
+            string.Format(ExceptionMessages.FeatureNotSupportedExceptionMessage, reason));
+    }
+}

src/Starward.Core.ZipStreamDownload/Exceptions/InvalidZipEntryNameException.cs

@@ -0,0 +1,39 @@
+using System.Diagnostics.CodeAnalysis;
+using Starward.Core.ZipStreamDownload.Resources;
+
+namespace Starward.Core.ZipStreamDownload.Exceptions;
+
+/// <summary>
+/// 当ZIP实体的名称无效时引发的异常。
+/// </summary>
+public class InvalidZipEntryNameException : ZipStreamDownloadException
+{
+    /// <summary>
+    /// 创建一个当ZIP实体的名称无效时引发的异常的实例。
+    /// </summary>
+    /// <param name="message">异常消息</param>
+    public InvalidZipEntryNameException(string? message) : base(message)
+    {
+    }
+
+    /// <summary>
+    /// 创建一个当ZIP实体的名称无效时引发的异常的实例。
+    /// </summary>
+    /// <param name="message">异常消息</param>
+    /// <param name="innerException">引发该异常的异常</param>
+    public InvalidZipEntryNameException(string? message, Exception? innerException) : base(message, innerException)
+    {
+    }
+
+    /// <summary>
+    /// 使用ZIP实体名称引发ZIP实体的名称无效的异常。
+    /// </summary>
+    /// <param name="zipEntryName">ZIP实体名称</param>
+    /// <exception cref="InvalidZipEntryNameException">当ZIP实体的名称无效时引发此异常。</exception>
+    [DoesNotReturn]
+    internal static void ThrowByZipEntryName(string zipEntryName)
+    {
+        throw new InvalidZipEntryNameException(
+            string.Format(ExceptionMessages.ZipEntryFileNameNotFoundExceptionMessage, zipEntryName));
+    }
+}

src/Starward.Core.ZipStreamDownload/Exceptions/ThrowException.cs

@@ -0,0 +1,36 @@
+using System.Runtime.CompilerServices;
+using ICSharpCode.SharpZipLib.Zip;
+using Starward.Core.ZipStreamDownload.Resources;
+
+namespace Starward.Core.ZipStreamDownload.Exceptions;
+
+/// <summary>
+/// 异常帮助类（当满足特定条件时抛出特定异常）
+/// </summary>
+internal static class ThrowException
+{
+    /// <summary>
+    /// 如果给定的目录不存在则引发找不到路径的异常。
+    /// </summary>
+    /// <param name="directoryInfo">要进行检查的目录信息</param>
+    /// <exception cref="DirectoryNotFoundException">当给定的路径不存在时引发此异常</exception>
+    public static void ThrowDirectoryNotFoundExceptionIfDirectoryNotExists(DirectoryInfo directoryInfo)
+    {
+        if (!directoryInfo.Exists)
+            throw new DirectoryNotFoundException(
+                string.Format(ExceptionMessages.DirectoryNotFoundExceptionMessage, directoryInfo.FullName));
+    }
+
+    /// <summary>
+    /// 如ZipEntry不为文件时引发异常。
+    /// </summary>
+    /// <param name="zipEntry"><see cref="ZipEntry"/>的实例</param>
+    /// <param name="paramName">参数名称</param>
+    /// <exception cref="ArgumentException">当参数错误时引发的异常</exception>
+    public static void ThrowArgumentExceptionIfZipEntryNotIsFile(ZipEntry zipEntry,
+        [CallerArgumentExpression(nameof(zipEntry))] string? paramName = null)
+    {
+        if (!zipEntry.IsFile)
+            throw new ArgumentException(ExceptionMessages.ZipEntryNotIsFileArgumentExceptionMessage, paramName);
+    }
+}

src/Starward.Core.ZipStreamDownload/Exceptions/ZipFileTestFailedException.cs

@@ -0,0 +1,52 @@
+using System.Diagnostics.CodeAnalysis;
+using Starward.Core.ZipStreamDownload.Resources;
+
+namespace Starward.Core.ZipStreamDownload.Exceptions;
+
+/// <summary>
+/// 当ZIP文件测试失败时引发的异常。
+/// </summary>
+public class ZipFileTestFailedException : ZipStreamDownloadException
+{
+    /// <summary>
+    /// 创建一个当ZIP文件测试失败时引发的异常的实例。
+    /// </summary>
+    /// <param name="message">异常消息</param>
+    public ZipFileTestFailedException(string? message) : base(message)
+    {
+    }
+
+    /// <summary>
+    /// 创建一个当ZIP文件测试失败时引发的异常的实例。
+    /// </summary>
+    /// <param name="message">异常消息</param>
+    /// <param name="innerException">引发该异常的异常</param>
+    public ZipFileTestFailedException(string? message, Exception? innerException) : base(message, innerException)
+    {
+    }
+
+    /// <summary>
+    /// 根据ZIP实体名称和异常原因引发ZIP文件测试失败的异常。
+    /// </summary>
+    /// <param name="zipEntryName">ZIP实体名称</param>
+    /// <param name="reason">异常原因</param>
+    /// <exception cref="InvalidZipEntryNameException">当ZIP文件测试失败时引发此异常。</exception>
+    [DoesNotReturn]
+    internal static void ThrowByZipEntryNameAndReason(string zipEntryName, string reason)
+    {
+        throw new InvalidZipEntryNameException(
+            string.Format(ExceptionMessages.ZipFileTestFailedExceptionMessage, zipEntryName, reason));
+    }
+
+    /// <summary>
+    /// 根据中心文件下载时的异常原因引发ZIP文件测试失败的异常。
+    /// </summary>
+    /// <param name="reason">异常原因</param>
+    /// <exception cref="InvalidZipEntryNameException">当ZIP文件测试失败时引发此异常。</exception>
+    [DoesNotReturn]
+    internal static void ThrowByReasonCentralDirectory(string reason)
+    {
+        throw new InvalidZipEntryNameException(
+            string.Format(ExceptionMessages.ZipFileTestFailedExceptionCentralDirectoryMessage, reason));
+    }
+}

src/Starward.Core.ZipStreamDownload/Exceptions/ZipStreamDownloadException.cs

@@ -0,0 +1,24 @@
+namespace Starward.Core.ZipStreamDownload.Exceptions;
+
+/// <summary>
+/// 当ZIP流式下载时出现错误引发的异常。
+/// </summary>
+public class ZipStreamDownloadException : Exception
+{
+    /// <summary>
+    /// 创建一个当ZIP流式下载时出现错误引发的异常的实例。
+    /// </summary>
+    /// <param name="message">异常消息</param>
+    public ZipStreamDownloadException(string? message) : base(message)
+    {
+    }
+
+    /// <summary>
+    /// 创建一个当ZIP流式下载时出现错误引发的异常的实例。
+    /// </summary>
+    /// <param name="message">异常消息</param>
+    /// <param name="innerException">引发该异常的异常</param>
+    public ZipStreamDownloadException(string? message, Exception? innerException) : base(message, innerException)
+    {
+    }
+}