.NET Core Kestrel 호스팅 - Razor 지원 추가
지난 글을 통해,
.NET Core Kestrel 호스팅 - Web API 추가
; https://www.sysnet.pe.kr/2/0/12505
기본 콘솔 프로젝트로 시작해 Web API까지 추가해봤는데요, 사실 Web API만 구현하는 거라면 거기서 만족할 수 있겠지만 웹 페이지까지 호스팅해야한다면 MapGet과 같은 식으로 만드는 것은,
app.UseEndpoints(endpoints =>
{
endpoints.MapControllers();
endpoints.MapGet("/", async context =>
{
await context.Response.WriteAsync("Hello World!");
});
});
현실성이 거의 없습니다. 대개의 경우 편의성을 위해 Razor 페이지를 이용한 UI 호스팅을 원할 텐데요, 이를 위한 작업은 Web API에서 변경했던 것과 동일한 방식을 사용합니다. 즉, ConfigureServices에서 Razor 지원을 추가하고, Configure에서 Razor 페이지로의 redirection을 명시하는 것입니다.
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
services.AddControllers();
services.AddRazorPages();
}
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
if (env.IsDevelopment())
{
Console.WriteLine("IsDevelopment");
app.UseDeveloperExceptionPage();
}
app.UseRouting();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllers();
endpoints.MapRazorPages();
});
}
}
테스트를 위해 간단하게 내용 구성을 한 razor 파일 하나(index.cshtml)를 추가하고,
@page
<h1>Hello, world!</h1>
<h2>The time on the server is @DateTime.Now</h2>
실행하면 될 텐데. ^^
실제로 저렇게 해보면 index.cshtml로의 redirection이 안 돼 File Not Found 오류가 발생합니다. 지난번에 추가한 Web API(
ValuesController 예제)와는 달리 Razor는 기본 지정된 경로가 있기 때문입니다.
// https://learn.microsoft.com/en-us/aspnet/core/razor-pages/
/Pages/Index.cshtml ==> / or /Index
/Pages/Contact.cshtml ==> /Contact
/Pages/Store/Contact.cshtml ==> /Store/Contact
/Pages/Store/Index.cshtml ==> /Store or /Store/Index
따라서, 반드시 Pages 디렉터리를 만들어 그 안에 cshtml 파일을 두고 호출을 해야만 정상적으로 endpoints.MapRazorPages() 설정에 의한 razor 페이지가 보입니다. 기타 자세한 route 정책은 다음의 문서를 참고하시고.
Razor Pages route and app conventions in ASP.NET Core
; https://learn.microsoft.com/en-us/aspnet/core/razor-pages/razor-pages-conventions
참고로 WebAPI의 경우 [Route] 특성을 이용해 경로 조정을 했던 것을 razor의 경우에는 @page로 제어할 수 있습니다.
@page "/Test2"
@model ConsoleApp1.TestModel
@{
}
<h1>TEST</h1>
(
첨부 파일은 이 글의 예제 코드를 포함합니다.)
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]