当前位置：首页 > news >正文

本地开发用ASP.NET Core Web API项目创建及测试

news 2025/9/17 1:16:29

1. 服务端代码（C#）

1.1 创建ASP.NET Core Web API项目

打开Visual Studio 2022。
选择“创建新项目”。
选择“ASP.NET Core Web API”模板，点击“下一步”。
输入项目名称（如OracleApi），选择项目位置，点击“创建”。

1.2 安装Oracle数据库依赖

使用NuGet管理包工具在项目中安装Oracle数据库的EF Core依赖：Oracle.EntityFrameworkCore

1.3 配置数据库上下文

在项目中创建一个AppDbContext类，用于连接和操作users表。

`AppDbContext.cs`代码：

using Microsoft.EntityFrameworkCore;namespace OracleApi
{public class AppDbContext : DbContext{public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }public DbSet<User> Users{ get; set; }  // 对应users表}
}

创建实体类User

User.cs代码：

using System.ComponentModel.DataAnnotations.Schema;namespace OracleApi
{[Table("users")]  // 显式指定表名public class User{[Key]  //指定主键为Idpublic string Id{ get; set; }  // 对应数据库中的 Id 字段public string Name{ get; set; }  // 对应数据库中的 Name 字段}
}

1.4 创建控制器

在Controllers文件夹中创建一个TeachersController类，用于处理按TEACHCODE查询TEACHERNAME的请求。

`TeachersController.cs`代码：

using Microsoft.AspNetCore.Mvc;
using Microsoft.EntityFrameworkCore;
using System.Linq;
using System.Threading.Tasks;namespace OracleApi.Controllers
{[ApiController][Route("api/[controller]")]public class TeachersController : ControllerBase{private readonly AppDbContext _context;public TeachersController(AppDbContext context){_context = context;}[HttpGet("{Id}")]public async Task<IActionResult> GetTeacherName(string Id){try{var user = await _context.Users.Where(t => t.Id == Id).Select(t => new { t.Id, t.Name }).FirstOrDefaultAsync();if (user == null){return NotFound($"User with Id {Id} not found.");}return Ok(user);}catch (DbException ex){return StatusCode(500, $"Database error: {ex.Message}");}catch (Exception ex){return StatusCode(500, $"Internal server error: {ex.Message}");}}}
}

1.5 配置数据库连接

在appsettings.json中添加Oracle数据库的连接字符串。假设你的Oracle数据库配置如下：

用户名：your_username
密码：your_password
数据库服务器地址：your_oracle_server
端口：1521
服务名：your_service_name

`appsettings.json`代码：

{"ConnectionStrings": {"DefaultConnection": "User Id=your_username;Password=your_password;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=your_oracle_server)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=your_service_name)));Persist Security Info=True"},"Logging": {"LogLevel": {"Default": "Information","Microsoft.AspNetCore": "Warning"}},"AllowedHosts": "*"
}

1.6 配置依赖注入

在Program.cs中配置数据库上下文和中间件。

`Program.cs`代码：


// 这段代码是 ASP.NET Core Web API 应用程序的入口点，它配置了应用程序的中间件、服务和数据库上下文。
using Microsoft.AspNetCore.HttpsPolicy; // 引入用于 HTTPS 策略的命名空间
using Microsoft.EntityFrameworkCore; // 引入 Entity Framework Core 命名空间，用于数据库操作
using Microsoft.Extensions.Options; // 引入用于配置选项的命名空间namespace WebApplication1 // 定义命名空间，通常是项目名称
{public class Program // 定义一个名为 Program 的类，作为应用程序的入口{public static void Main(string[] args) // 定义主方法，程序的入口点{// 创建一个 WebApplicationBuilder 实例，用于配置应用程序var builder = WebApplication.CreateBuilder(args);// 添加 CORS 配置// CORS（跨域资源共享）允许前端应用从不同的源（域名、协议或端口）发送请求builder.Services.AddCors(options =>{// 添加默认的 CORS 策略options.AddDefaultPolicy(policy =>{// 允许来自 http://localhost 的请求policy.WithOrigins("http://localhost").AllowAnyHeader() // 允许任何请求头.AllowAnyMethod(); // 允许任何 HTTP 方法（GET、POST 等）});// 可以定义多个 CORS 策略，并在需要时指定使用哪个策略options.AddPolicy("AllowLocalhost3000", policy =>{policy.WithOrigins("http://localhost:3000").AllowAnyHeader().AllowAnyMethod();});options.AddPolicy("AllowAll", policy =>{policy.AllowAnyOrigin().AllowAnyHeader().AllowAnyMethod();});});// 添加控制器支持builder.Services.AddControllers();// 添加数据库上下文服务builder.Services.AddDbContext<AppDbContext>(options =>// 配置数据库上下文使用 Oracle 数据库options.UseOracle(builder.Configuration.GetConnectionString("DefaultConnection")));// 构建应用程序实例var app = builder.Build();// 使用 CORS 中间件// 确保应用程序能够处理跨域请求。app.UseCors();  // 使用默认策略//app.UseCors("AllowLocalhost3000"); // 使用指定的策略// 使用授权中间件，用于处理用户授权逻辑。app.UseAuthorization();// 映射控制器路由，使得应用程序能够处理 HTTP 请求并调用相应的控制器方法。app.MapControllers();// 启动应用程序，开始监听 HTTP 请求。app.Run();}}
}

2. 客户端代码（JQuery）

2.1 创建HTML页面

创建一个简单的HTML页面，用于输入TEACHCODE并调用服务端接口。

`index.html`代码：

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Teacher Query</title><script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
</head>
<body><h1>Query Teacher by TEACHCODE</h1><input type="text" id="userId" placeholder="Enter TEACHCODE" /><button id="queryButton">Query</button><div id="result"></div><script>$(document).ready(function () {$('#queryButton').click(function () {var userId= $('#userId').val();$.ajax({url: `http://localhost:5000/api/users/${userId}`, // 修改为你的API地址type: 'GET',success: function (data) {$('#result').html(`ID: ${data.Id}, Name: ${data.Name}`);},error: function (xhr, status, error) {$('#result').html(`Error: ${error}`);}});});});</script>
</body>
</html>

3. 部署到Windows上的Apache服务器

3.1 准备发布文件

在Visual Studio中，选择“发布”选项，将项目发布为自包含的可执行文件。
选择目标框架（如net6.0）和目标运行时（如win-x64）。
选择发布目标路径，例如bin\Release\publish。
点击“发布”。

3.2 配置Apache

安装Apache：确保Apache服务器已安装并运行。
安装mod_proxy模块：确保mod_proxy模块已启用。打开httpd.conf文件，取消注释以下行：

apache复制
```
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
```
配置虚拟主机：在httpd.conf文件中，添加以下虚拟主机配置：

<VirtualHost *:80>ServerName localhostDocumentRoot "C:/Apache24/htdocs"ProxyPreserveHost OnProxyPass /api/ http://localhost:5000/api/ProxyPassReverse /api/ http://localhost:5000/api/
</VirtualHost>