引入后端API项目并重构前后端桥接与路由
本次提交新增了 Avalonia-API(Web API)与 Avalonia-Services(业务服务)两个项目,完善了解决方案结构。重构了 Avalonia-PC 前端与后端的桥接逻辑,实现了基于前缀的路由分发、静态服务、开发者工具等功能。同步更新了 .gitignore、api.js 及相关配置文件,为后续业务扩展和维护打下基础。
This commit is contained in:
parent
9b90a471c2
commit
506ab4857a
4
.gitignore
vendored
4
.gitignore
vendored
@ -5,3 +5,7 @@
|
||||
/Avalonia-PC/bin
|
||||
/Avalonia-PC/.vs
|
||||
/Avalonia-PC/obj
|
||||
/Avalonia-API/bin
|
||||
/Avalonia-API/obj
|
||||
/Avalonia-Services/bin
|
||||
/Avalonia-Services/obj
|
||||
18
Avalonia-API/Avalonia-API.csproj
Normal file
18
Avalonia-API/Avalonia-API.csproj
Normal file
@ -0,0 +1,18 @@
|
||||
<Project Sdk="Microsoft.NET.Sdk.Web">
|
||||
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net10.0</TargetFramework>
|
||||
<Nullable>enable</Nullable>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
<RootNamespace>Avalonia_API</RootNamespace>
|
||||
</PropertyGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="10.0.5" />
|
||||
</ItemGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<ProjectReference Include="..\Avalonia-Services\Avalonia-Services.csproj" />
|
||||
</ItemGroup>
|
||||
|
||||
</Project>
|
||||
6
Avalonia-API/Avalonia-API.csproj.user
Normal file
6
Avalonia-API/Avalonia-API.csproj.user
Normal file
@ -0,0 +1,6 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<Project ToolsVersion="Current" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||
<PropertyGroup>
|
||||
<ActiveDebugProfile>https</ActiveDebugProfile>
|
||||
</PropertyGroup>
|
||||
</Project>
|
||||
6
Avalonia-API/Avalonia-API.http
Normal file
6
Avalonia-API/Avalonia-API.http
Normal file
@ -0,0 +1,6 @@
|
||||
@Avalonia_API_HostAddress = http://localhost:5206
|
||||
|
||||
GET {{Avalonia_API_HostAddress}}/weatherforecast/
|
||||
Accept: application/json
|
||||
|
||||
###
|
||||
15
Avalonia-API/Configuration/ServicesConfiguration.cs
Normal file
15
Avalonia-API/Configuration/ServicesConfiguration.cs
Normal file
@ -0,0 +1,15 @@
|
||||
using Avalonia_Services.Services;
|
||||
|
||||
namespace Avalonia_API.Configuration
|
||||
{
|
||||
public static class ServicesConfiguration
|
||||
{
|
||||
public static void ConfigureServices(this IServiceCollection services)
|
||||
{
|
||||
// Register your services here
|
||||
// For example:
|
||||
// services.AddSingleton<IMyService, MyService>();
|
||||
services.AddScoped<WeatherForecastService>();
|
||||
}
|
||||
}
|
||||
}
|
||||
20
Avalonia-API/Controllers/WeatherForecastController.cs
Normal file
20
Avalonia-API/Controllers/WeatherForecastController.cs
Normal file
@ -0,0 +1,20 @@
|
||||
using Avalonia_Services.Models;
|
||||
using Avalonia_Services.Services;
|
||||
using Microsoft.AspNetCore.Mvc;
|
||||
|
||||
namespace Avalonia_API.Controllers
|
||||
{
|
||||
[ApiController]
|
||||
[Route("[controller]")]
|
||||
public class WeatherForecastController(WeatherForecastService weatherForecastService) : ControllerBase
|
||||
{
|
||||
|
||||
private readonly WeatherForecastService _weatherForecastService = weatherForecastService;
|
||||
|
||||
[HttpGet(Name = "GetWeatherForecast")]
|
||||
public IEnumerable<WeatherForecast> Get()
|
||||
{
|
||||
return _weatherForecastService.GetWeatherForecasts();
|
||||
}
|
||||
}
|
||||
}
|
||||
23
Avalonia-API/Program.cs
Normal file
23
Avalonia-API/Program.cs
Normal file
@ -0,0 +1,23 @@
|
||||
var builder = WebApplication.CreateBuilder(args);
|
||||
|
||||
// Add services to the container.
|
||||
|
||||
builder.Services.AddControllers();
|
||||
// Learn more about configuring OpenAPI at https://aka.ms/aspnet/openapi
|
||||
builder.Services.AddOpenApi();
|
||||
|
||||
var app = builder.Build();
|
||||
|
||||
// Configure the HTTP request pipeline.
|
||||
if (app.Environment.IsDevelopment())
|
||||
{
|
||||
app.MapOpenApi();
|
||||
}
|
||||
|
||||
app.UseHttpsRedirection();
|
||||
|
||||
app.UseAuthorization();
|
||||
|
||||
app.MapControllers();
|
||||
|
||||
app.Run();
|
||||
23
Avalonia-API/Properties/launchSettings.json
Normal file
23
Avalonia-API/Properties/launchSettings.json
Normal file
@ -0,0 +1,23 @@
|
||||
{
|
||||
"$schema": "https://json.schemastore.org/launchsettings.json",
|
||||
"profiles": {
|
||||
"http": {
|
||||
"commandName": "Project",
|
||||
"dotnetRunMessages": true,
|
||||
"launchBrowser": false,
|
||||
"applicationUrl": "http://localhost:5206",
|
||||
"environmentVariables": {
|
||||
"ASPNETCORE_ENVIRONMENT": "Development"
|
||||
}
|
||||
},
|
||||
"https": {
|
||||
"commandName": "Project",
|
||||
"dotnetRunMessages": true,
|
||||
"launchBrowser": false,
|
||||
"applicationUrl": "https://localhost:7165;http://localhost:5206",
|
||||
"environmentVariables": {
|
||||
"ASPNETCORE_ENVIRONMENT": "Development"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
8
Avalonia-API/appsettings.Development.json
Normal file
8
Avalonia-API/appsettings.Development.json
Normal file
@ -0,0 +1,8 @@
|
||||
{
|
||||
"Logging": {
|
||||
"LogLevel": {
|
||||
"Default": "Information",
|
||||
"Microsoft.AspNetCore": "Warning"
|
||||
}
|
||||
}
|
||||
}
|
||||
9
Avalonia-API/appsettings.json
Normal file
9
Avalonia-API/appsettings.json
Normal file
@ -0,0 +1,9 @@
|
||||
{
|
||||
"Logging": {
|
||||
"LogLevel": {
|
||||
"Default": "Information",
|
||||
"Microsoft.AspNetCore": "Warning"
|
||||
}
|
||||
},
|
||||
"AllowedHosts": "*"
|
||||
}
|
||||
@ -1,3 +1,5 @@
|
||||
<Solution>
|
||||
<Project Path="../Avalonia-API/Avalonia-API.csproj" Id="e33aba9a-a56b-4f6b-8eaa-3acbed65ebad" />
|
||||
<Project Path="../Avalonia-Services/Avalonia-Services.csproj" Id="b8757cf9-5422-4c67-acae-3c967c95f866" />
|
||||
<Project Path="Avalonia-PC.csproj" />
|
||||
</Solution>
|
||||
|
||||
@ -15,6 +15,7 @@ namespace Avalonia_PC.Views
|
||||
public partial class MainWindow : Window
|
||||
{
|
||||
private const string AppScheme = "app";
|
||||
//private const string? OnlineStartupUrl = "https://re.laitool.cn";
|
||||
private const string? OnlineStartupUrl = null;
|
||||
private const string? LocalStartupPath = null;
|
||||
private static readonly JsonSerializerOptions BridgeJsonSerializerOptions = new()
|
||||
@ -30,6 +31,11 @@ namespace Avalonia_PC.Views
|
||||
private string? _localHttpBaseUrl;
|
||||
private string? _localHttpRoot;
|
||||
|
||||
#region 生命周期与 WebView 事件
|
||||
|
||||
/// <summary>
|
||||
/// 初始化窗口并注册生命周期事件。
|
||||
/// </summary>
|
||||
public MainWindow()
|
||||
{
|
||||
InitializeComponent();
|
||||
@ -38,6 +44,9 @@ namespace Avalonia_PC.Views
|
||||
Closed += OnClosed;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 窗口打开后初始化 WebView、挂载事件并加载入口页面。
|
||||
/// </summary>
|
||||
private async void OnOpened(object? sender, EventArgs e)
|
||||
{
|
||||
if (_eventsAttached)
|
||||
@ -59,11 +68,17 @@ namespace Avalonia_PC.Views
|
||||
await LoadInitialContentAsync();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// WebView 适配器创建后缓存实例,用于后续打开开发者工具。
|
||||
/// </summary>
|
||||
private void OnAdapterCreated(object? sender, WebViewAdapterEventArgs e)
|
||||
{
|
||||
_webViewAdapter = e.GetType().GetProperty("Adapter")?.GetValue(e);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 窗口关闭时解绑事件并释放本地资源。
|
||||
/// </summary>
|
||||
private void OnClosed(object? sender, EventArgs e)
|
||||
{
|
||||
if (_webView is not null)
|
||||
@ -77,11 +92,21 @@ namespace Avalonia_PC.Views
|
||||
StopLocalHttpServer();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 页面导航完成后注入 JS 桥接脚本。
|
||||
/// </summary>
|
||||
private async void OnNavigationCompleted(object? sender, WebViewNavigationCompletedEventArgs e)
|
||||
{
|
||||
await InjectBridgeScriptAsync();
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 前端桥接与页面加载
|
||||
|
||||
/// <summary>
|
||||
/// 接收前端消息并进行分发(打开调试工具 / 处理 app 请求)。
|
||||
/// </summary>
|
||||
private async void OnWebMessageReceived(object? sender, WebMessageReceivedEventArgs e)
|
||||
{
|
||||
var messageJson = e.Body;
|
||||
@ -137,6 +162,9 @@ namespace Avalonia_PC.Views
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 加载初始页面:优先在线地址,其次本地路径(通过本地 HTTP 服务托管)。
|
||||
/// </summary>
|
||||
private async Task LoadInitialContentAsync()
|
||||
{
|
||||
if (_webView is null)
|
||||
@ -174,6 +202,9 @@ namespace Avalonia_PC.Views
|
||||
_webView.Source = new Uri(new Uri(_localHttpBaseUrl), Path.GetFileName(localHtmlPath));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 向页面注入桥接脚本,接管 app:// 请求并回传到 C# 处理。
|
||||
/// </summary>
|
||||
private async Task InjectBridgeScriptAsync()
|
||||
{
|
||||
if (_webView is null)
|
||||
@ -278,6 +309,13 @@ if (!window.__appBridgeInstalled) {
|
||||
await _webView.InvokeScript(script);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 请求分发与通用响应
|
||||
|
||||
/// <summary>
|
||||
/// 解析前端请求消息并转发到统一请求处理入口。
|
||||
/// </summary>
|
||||
private async Task<AppResponse> HandleAppRequestAsync(JsonElement request)
|
||||
{
|
||||
var id = request.TryGetProperty("id", out var idProperty) ? idProperty.GetString() : null;
|
||||
@ -289,6 +327,9 @@ if (!window.__appBridgeInstalled) {
|
||||
return await HandleAppRequestAsync(id, url, method, body, headers);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 统一请求处理:构建上下文、处理 OPTIONS、按前缀分发并封装标准响应。
|
||||
/// </summary>
|
||||
private async Task<AppResponse> HandleAppRequestAsync(
|
||||
string? id,
|
||||
string? rawUrl,
|
||||
@ -308,10 +349,7 @@ if (!window.__appBridgeInstalled) {
|
||||
try
|
||||
{
|
||||
var uri = new Uri(rawUrl ?? throw new InvalidOperationException("请求地址不能为空。"));
|
||||
var path = uri.AbsolutePath.TrimStart('/');
|
||||
var normalizedPath = path.StartsWith("api/", StringComparison.OrdinalIgnoreCase)
|
||||
? path
|
||||
: $"api/{path}";
|
||||
var requestContext = CreateRouteRequestContext(uri, body);
|
||||
var authorization = GetAuthorizationHeader(headers);
|
||||
_ = authorization;
|
||||
|
||||
@ -323,27 +361,12 @@ if (!window.__appBridgeInstalled) {
|
||||
return response;
|
||||
}
|
||||
|
||||
if (string.Equals(normalizedPath, "api/getUser", StringComparison.OrdinalIgnoreCase))
|
||||
var routeResult = await DispatchByPrefixAsync(requestContext);
|
||||
if (routeResult.IsMatched)
|
||||
{
|
||||
var user = await GetUserFromDatabaseAsync();
|
||||
response.Body = JsonSerializer.Serialize(new { success = true, data = user });
|
||||
return response;
|
||||
}
|
||||
|
||||
if (string.Equals(normalizedPath, "api/processData", StringComparison.OrdinalIgnoreCase))
|
||||
{
|
||||
var input = string.Empty;
|
||||
if (!string.IsNullOrWhiteSpace(body))
|
||||
{
|
||||
using var jsonDocument = JsonDocument.Parse(body);
|
||||
if (jsonDocument.RootElement.TryGetProperty("input", out var inputProperty))
|
||||
{
|
||||
input = inputProperty.GetString() ?? string.Empty;
|
||||
}
|
||||
}
|
||||
|
||||
var result = await ProcessDataAsync(input);
|
||||
response.Body = JsonSerializer.Serialize(new { success = true, result });
|
||||
response.StatusCode = routeResult.StatusCode;
|
||||
response.StatusMessage = routeResult.StatusMessage;
|
||||
response.Body = BuildSuccessResponseBody(routeResult.Data);
|
||||
return response;
|
||||
}
|
||||
|
||||
@ -361,6 +384,137 @@ if (!window.__appBridgeInstalled) {
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 按请求前缀分发处理器(例如 api、sys、admin 等)。
|
||||
/// </summary>
|
||||
private async Task<RouteDispatchResult> DispatchByPrefixAsync(RouteRequestContext requestContext)
|
||||
{
|
||||
if (requestContext.PathSegments.Length > 0 &&
|
||||
string.Equals(requestContext.PathSegments[0], "api", StringComparison.OrdinalIgnoreCase))
|
||||
{
|
||||
return await HandleApiPrefixAsync(requestContext);
|
||||
}
|
||||
|
||||
return RouteDispatchResult.NotMatched();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 处理 api 前缀下的具体业务路由。
|
||||
/// </summary>
|
||||
private static async Task<RouteDispatchResult> HandleApiPrefixAsync(RouteRequestContext requestContext)
|
||||
{
|
||||
if (string.Equals(requestContext.NormalizedPath, "api/getUser", StringComparison.OrdinalIgnoreCase))
|
||||
{
|
||||
var user = await GetUserFromDatabaseAsync();
|
||||
return RouteDispatchResult.Success(user);
|
||||
}
|
||||
|
||||
if (string.Equals(requestContext.NormalizedPath, "api/processData", StringComparison.OrdinalIgnoreCase) ||
|
||||
(requestContext.PathSegments.Length > 1 &&
|
||||
string.Equals(requestContext.PathSegments[1], "processData", StringComparison.OrdinalIgnoreCase)))
|
||||
{
|
||||
var input = ExtractInput(requestContext);
|
||||
var result = await ProcessDataAsync(input);
|
||||
return RouteDispatchResult.Success(result);
|
||||
}
|
||||
|
||||
return RouteDispatchResult.NotMatched();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 统一构建成功响应体,保持前后端响应结构一致。
|
||||
/// </summary>
|
||||
private static string BuildSuccessResponseBody(object? data)
|
||||
{
|
||||
return JsonSerializer.Serialize(new { success = true, data });
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 从 URI 解析路径段、查询参数和 body,构建路由上下文。
|
||||
/// </summary>
|
||||
private static RouteRequestContext CreateRouteRequestContext(Uri uri, string? body)
|
||||
{
|
||||
var host = uri.Host ?? string.Empty;
|
||||
var absolutePath = uri.AbsolutePath ?? string.Empty;
|
||||
var combinedPath = $"{host}/{absolutePath}";
|
||||
|
||||
var pathSegments = combinedPath
|
||||
.Split('/', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
|
||||
.Select(Uri.UnescapeDataString)
|
||||
.ToArray();
|
||||
|
||||
var normalizedPath = string.Join('/', pathSegments);
|
||||
var query = ParseQueryParameters(uri.Query);
|
||||
|
||||
return new RouteRequestContext
|
||||
{
|
||||
NormalizedPath = normalizedPath,
|
||||
PathSegments = pathSegments,
|
||||
Query = query,
|
||||
Body = body,
|
||||
};
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 解析查询字符串为忽略大小写的字典。
|
||||
/// </summary>
|
||||
private static Dictionary<string, string> ParseQueryParameters(string? queryString)
|
||||
{
|
||||
var query = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
|
||||
if (string.IsNullOrWhiteSpace(queryString))
|
||||
{
|
||||
return query;
|
||||
}
|
||||
|
||||
var raw = queryString.TrimStart('?');
|
||||
foreach (var pair in raw.Split('&', StringSplitOptions.RemoveEmptyEntries))
|
||||
{
|
||||
var separatorIndex = pair.IndexOf('=');
|
||||
if (separatorIndex < 0)
|
||||
{
|
||||
query[Uri.UnescapeDataString(pair)] = string.Empty;
|
||||
continue;
|
||||
}
|
||||
|
||||
var key = Uri.UnescapeDataString(pair[..separatorIndex]);
|
||||
var value = Uri.UnescapeDataString(pair[(separatorIndex + 1)..]);
|
||||
query[key] = value;
|
||||
}
|
||||
|
||||
return query;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 按 body -> query -> path 的优先级提取业务输入参数。
|
||||
/// </summary>
|
||||
private static string ExtractInput(RouteRequestContext requestContext)
|
||||
{
|
||||
if (!string.IsNullOrWhiteSpace(requestContext.Body))
|
||||
{
|
||||
using var jsonDocument = JsonDocument.Parse(requestContext.Body);
|
||||
if (jsonDocument.RootElement.TryGetProperty("input", out var inputProperty))
|
||||
{
|
||||
return inputProperty.GetString() ?? string.Empty;
|
||||
}
|
||||
}
|
||||
|
||||
if (requestContext.Query.TryGetValue("input", out var inputFromQuery) &&
|
||||
!string.IsNullOrWhiteSpace(inputFromQuery))
|
||||
{
|
||||
return inputFromQuery;
|
||||
}
|
||||
|
||||
if (requestContext.PathSegments.Length > 2)
|
||||
{
|
||||
return string.Join('/', requestContext.PathSegments.Skip(2));
|
||||
}
|
||||
|
||||
return string.Empty;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 创建桥接响应的默认 JSON/CORS 头。
|
||||
/// </summary>
|
||||
private static Dictionary<string, string> CreateJsonHeaders() => new()
|
||||
{
|
||||
["Content-Type"] = "application/json; charset=utf-8",
|
||||
@ -369,6 +523,9 @@ if (!window.__appBridgeInstalled) {
|
||||
["Access-Control-Allow-Headers"] = "Content-Type, Authorization",
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// 从前端请求消息中提取请求头。
|
||||
/// </summary>
|
||||
private static Dictionary<string, string> ExtractHeaders(JsonElement request)
|
||||
{
|
||||
if (!request.TryGetProperty("headers", out var headersElement) ||
|
||||
@ -386,12 +543,18 @@ if (!window.__appBridgeInstalled) {
|
||||
return headers;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 获取授权头,供鉴权逻辑扩展使用。
|
||||
/// </summary>
|
||||
private static string? GetAuthorizationHeader(Dictionary<string, string> headers)
|
||||
{
|
||||
return headers.FirstOrDefault(
|
||||
entry => string.Equals(entry.Key, "Authorization", StringComparison.OrdinalIgnoreCase)).Value;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 在异常情况下尝试提取请求 id,确保前端可收到对应错误响应。
|
||||
/// </summary>
|
||||
private static string? TryGetRequestId(string messageJson)
|
||||
{
|
||||
try
|
||||
@ -405,6 +568,13 @@ if (!window.__appBridgeInstalled) {
|
||||
}
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 页面地址配置与本地静态服务
|
||||
|
||||
/// <summary>
|
||||
/// 获取在线启动地址配置(仅允许 http/https)。
|
||||
/// </summary>
|
||||
private static Uri? GetConfiguredOnlineStartupUrl()
|
||||
{
|
||||
if (string.IsNullOrWhiteSpace(OnlineStartupUrl))
|
||||
@ -420,6 +590,9 @@ if (!window.__appBridgeInstalled) {
|
||||
return uri.Scheme is "http" or "https" ? uri : null;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 获取本地启动文件路径,未配置时默认使用输出目录 www/index.html。
|
||||
/// </summary>
|
||||
private static string? GetConfiguredLocalStartupPath()
|
||||
{
|
||||
if (!string.IsNullOrWhiteSpace(LocalStartupPath))
|
||||
@ -430,6 +603,9 @@ if (!window.__appBridgeInstalled) {
|
||||
return Path.Combine(AppContext.BaseDirectory, "www", "index.html");
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 确保本地 HTTP 静态服务已启动;根目录变化时会重启。
|
||||
/// </summary>
|
||||
private async Task EnsureLocalHttpServerStartedAsync(string localRoot)
|
||||
{
|
||||
if (!string.IsNullOrWhiteSpace(_localHttpBaseUrl) &&
|
||||
@ -454,6 +630,9 @@ if (!window.__appBridgeInstalled) {
|
||||
_ = Task.Run(() => RunLocalHttpServerLoopAsync(_localHttpServer, _localHttpServerCts.Token, localRoot));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 本地静态服务主循环,持续接收并分发请求。
|
||||
/// </summary>
|
||||
private static async Task RunLocalHttpServerLoopAsync(HttpListener listener, CancellationToken cancellationToken, string wwwRoot)
|
||||
{
|
||||
try
|
||||
@ -469,6 +648,9 @@ if (!window.__appBridgeInstalled) {
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 处理本地静态资源请求并返回文件内容。
|
||||
/// </summary>
|
||||
private static async Task HandleLocalHttpRequest(HttpListenerContext context, string wwwRoot)
|
||||
{
|
||||
try
|
||||
@ -509,6 +691,9 @@ if (!window.__appBridgeInstalled) {
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 根据后缀返回静态资源 Content-Type。
|
||||
/// </summary>
|
||||
private static string GetContentType(string filePath)
|
||||
{
|
||||
return Path.GetExtension(filePath).ToLowerInvariant() switch
|
||||
@ -521,6 +706,9 @@ if (!window.__appBridgeInstalled) {
|
||||
};
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 获取一个可用本地端口,用于启动本地静态服务。
|
||||
/// </summary>
|
||||
private static int GetAvailableTcpPort()
|
||||
{
|
||||
var listener = new TcpListener(IPAddress.Loopback, 0);
|
||||
@ -530,6 +718,9 @@ if (!window.__appBridgeInstalled) {
|
||||
return port;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 尝试打开 WebView 开发者工具(兼容不同适配器方法名)。
|
||||
/// </summary>
|
||||
private void TryOpenDevTools()
|
||||
{
|
||||
if (_webViewAdapter is null)
|
||||
@ -543,6 +734,9 @@ if (!window.__appBridgeInstalled) {
|
||||
method?.Invoke(_webViewAdapter, null);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 停止并释放本地静态服务资源。
|
||||
/// </summary>
|
||||
private void StopLocalHttpServer()
|
||||
{
|
||||
try
|
||||
@ -564,18 +758,32 @@ if (!window.__appBridgeInstalled) {
|
||||
}
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 业务示例方法
|
||||
|
||||
/// <summary>
|
||||
/// 示例:模拟读取用户数据。
|
||||
/// </summary>
|
||||
private static async Task<object> GetUserFromDatabaseAsync()
|
||||
{
|
||||
await Task.Delay(100);
|
||||
return new { id = 1, name = "张三", email = "zhangsan@example.com" };
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 示例:模拟处理输入数据。
|
||||
/// </summary>
|
||||
private static async Task<string> ProcessDataAsync(string? input)
|
||||
{
|
||||
await Task.Delay(200);
|
||||
return $"Processed: {input?.ToUpperInvariant()}";
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region DTO / 路由上下文模型
|
||||
|
||||
private sealed class AppResponse
|
||||
{
|
||||
public string Kind { get; set; } = string.Empty;
|
||||
@ -590,5 +798,46 @@ if (!window.__appBridgeInstalled) {
|
||||
|
||||
public Dictionary<string, string> Headers { get; set; } = new();
|
||||
}
|
||||
|
||||
private sealed class RouteRequestContext
|
||||
{
|
||||
public string NormalizedPath { get; init; } = string.Empty;
|
||||
|
||||
public string[] PathSegments { get; init; } = [];
|
||||
|
||||
public Dictionary<string, string> Query { get; init; } = new(StringComparer.OrdinalIgnoreCase);
|
||||
|
||||
public string? Body { get; init; }
|
||||
}
|
||||
|
||||
private sealed class RouteDispatchResult
|
||||
{
|
||||
public bool IsMatched { get; init; }
|
||||
|
||||
public int StatusCode { get; init; } = 200;
|
||||
|
||||
public string StatusMessage { get; init; } = "OK";
|
||||
|
||||
public object? Data { get; init; }
|
||||
|
||||
public static RouteDispatchResult Success(object? data)
|
||||
{
|
||||
return new RouteDispatchResult
|
||||
{
|
||||
IsMatched = true,
|
||||
Data = data,
|
||||
};
|
||||
}
|
||||
|
||||
public static RouteDispatchResult NotMatched()
|
||||
{
|
||||
return new RouteDispatchResult
|
||||
{
|
||||
IsMatched = false,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
#endregion
|
||||
}
|
||||
}
|
||||
|
||||
@ -45,6 +45,6 @@ async function callApi(endpoint, options = {}) {
|
||||
}
|
||||
|
||||
window.api = {
|
||||
getUser: () => callApi("getUser"),
|
||||
getUser: () => callApi("getUser?t=1"),
|
||||
processData: (input) => callApi("processData", { method: "POST", body: { input } })
|
||||
};
|
||||
|
||||
10
Avalonia-Services/Avalonia-Services.csproj
Normal file
10
Avalonia-Services/Avalonia-Services.csproj
Normal file
@ -0,0 +1,10 @@
|
||||
<Project Sdk="Microsoft.NET.Sdk">
|
||||
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net10.0</TargetFramework>
|
||||
<RootNamespace>Avalonia_Services</RootNamespace>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
<Nullable>enable</Nullable>
|
||||
</PropertyGroup>
|
||||
|
||||
</Project>
|
||||
13
Avalonia-Services/Models/WeatherForecast.cs
Normal file
13
Avalonia-Services/Models/WeatherForecast.cs
Normal file
@ -0,0 +1,13 @@
|
||||
namespace Avalonia_Services.Models
|
||||
{
|
||||
public class WeatherForecast
|
||||
{
|
||||
public DateOnly Date { get; set; }
|
||||
|
||||
public int TemperatureC { get; set; }
|
||||
|
||||
public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);
|
||||
|
||||
public string? Summary { get; set; }
|
||||
}
|
||||
}
|
||||
23
Avalonia-Services/Services/WeatherForecastService.cs
Normal file
23
Avalonia-Services/Services/WeatherForecastService.cs
Normal file
@ -0,0 +1,23 @@
|
||||
using Avalonia_Services.Models;
|
||||
|
||||
namespace Avalonia_Services.Services
|
||||
{
|
||||
public class WeatherForecastService
|
||||
{
|
||||
private static readonly string[] Summaries =
|
||||
[
|
||||
"Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
|
||||
];
|
||||
|
||||
public IEnumerable<WeatherForecast> GetWeatherForecasts()
|
||||
{
|
||||
return Enumerable.Range(1, 5).Select(index => new WeatherForecast
|
||||
{
|
||||
Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
|
||||
TemperatureC = Random.Shared.Next(-20, 55),
|
||||
Summary = Summaries[Random.Shared.Next(Summaries.Length)]
|
||||
})
|
||||
.ToArray();
|
||||
}
|
||||
}
|
||||
}
|
||||
Loading…
x
Reference in New Issue
Block a user