jacking75/edu_learn_aspnetcore_apiserver

ASP.NET Core Web API 학습을 위한 저장소

ASP.Net Core Web API Server 학습

• 닷넷에서 API Server용 게임서버 개발을 위해 학습을 하기 위한 것이다.
• ASP.NET Core 7.0의 새로운 기능
• Announcing ASP.NET Core in .NET 7
• C# 비동기 프로그래밍 정리
• (YOUTUBE) VisualAcademy
• practical-aspnetcore ASP.NET Core의 다양한 샘플 코드를 볼 수 있다.

1. 학습하기

직접 예제 코드를 만들어 보면서 학습을 잘하자

Redis 프로그래밍

• Redis의 기본 데이터 유형 및 명령
• (영상) Redis 야무지게 사용하기
• Redis 기능 학습하기
• C# Redis 프로그래밍 학습
  • CloudStructures - Redis 라이브러리 - jacking75
  • CloudStructures를 이용한 C# Redis 프로그래밍

MySQL 프로그래밍

• MySqlConnector 간단 정리
• 프로그래밍 라이브러리는 SalKata 소개
  • 예제 프로그램: github_sqlkata_demo.zip
• 코드에서 DB 트랜잭션 하기

2022년 인턴 사원이 만든 학습 자료

학습자료_2022년_인턴 이라는 디렉토리에 2022년 인턴 사원으로 근무한 분이 만든 학습 자료가 있다.
이 자료들을 순서대로 한번 보기 바란다.
이것들을 본 후 실습을 하나씩 한다. 03_Dapper, 06연습 프로젝트 구현은 따라서 실습을 할 필요는 없다. 그냥 보기만 한다.

학습에서는 데이터 베이스 프로그래밍으로 Dapper를 사용하고 있는데 실제 실습에서는 SqlKata를 사용한다
SqlKata 소개
demo 프로그램 codes 디렉토리에 있는 github_sqlkata_demo.zip 파일이다.

서버 캠퍼스 1기 수료생 정리 자료

• https://sueshin.tistory.com/category/%EA%B0%9C%EC%9D%B8%EA%B3%B5%EB%B6%80/Web%20API%20%EA%B2%8C%EC%9E%84%20%EC%84%9C%EB%B2%84%20%EA%B3%B5%EB%B6%80
• https://gist.github.com/jacking75/344fd3c8c16fc27fe51d4c983a3a6306
• https://paper-tub-6ae.notion.site/0be4168f7f224f82a89110423e3943cb
• ASP.NET Core로 Web API 만들기
• 워리할수있다 (tistory.com)
• Intro - WebAPI Server (gitbook.io)
• ASP (notion.site)
• https://velog.io/@oak_cassia/%EC%84%9C%EB%B2%84%EC%BA%A0%ED%8D%BC%EC%8A%A4-1%EA%B8%B0-ASP.NET-Core
• https://beathe.at/2023-04/ASP.NET-Core-GameServer
  • GitHub Com2usEduProject

서버 캠퍼스 1기 수료생 정리 자료

학습자료_2024_서버캠퍼스2기 디렉토리를 보기 바란다

문서

• Web서비스의 서버구성과목적
• DAO, DTO, VO 란? 간단한 개념 정리
• ASP.NET Core Web
  • 시작
  • 컨트롤러와 route 규칙
  • Request 처리
  • Response 처리
• ASP.NET Core 입문 – 미들웨어와 파이프라인 해설
• ASP.NET Core의 속도 제한 미들웨어
• 요청 본문을 Stream 또는 PipeReader로 바인딩
• STREAM
• ASP.NET Core 출력 캐싱 미들웨어
• 외부 자료:
  • 모바일 게임 개발 개요
  • 게임 엔진 아웃라인
  • 데이터 설계
  • 통신

단계 별로 따라하면서 API 서버 만들기

아래 영상과 예제 코드를 참고하면서 단계 별로 만들면서 배운다.

• (YOUTUBE)1~6단계로 ASP.NET Core 기본 실습
• 설명 문서
• 예제 코드는 codes 디렉토리의 basic2 디렉토리 안에 있다.

API Server 개발하기

• code 디렉토리의 APIServer_Templete 디렉토리에 있는 코드를 참고해서 만들기 바란다.
• 프로젝트는 새로 만들고 구조나 코드 등을 참고한다.
• APIServer_Templete에 있는 코드 보다 더 좋은 코드를 만드는 것을 목표로 한다.

example_filter_APIServer

• 아래 프로그램은 codes 디렉토리 안에 있다.
• 기획데이터(마스터 데이터)가 json으로 된 것을 로딩
• 미들웨어로 라우팅을 커스텀마이징
• 미들웨어로 클라이언트 보낸 요청 데이터의 암호를 풀어서 핸들러에 전달하도록 한다
• 필터로 클라이언트에 보내는 응답의 포맷을 변환하거나 암호화 하도록 한다

gRPC Server

• 아래 프로그램은 codes 디렉토리 안에 있다.
• 아래 기능을 사용하여 JSON을 주고 받을 수 있도록 한다. 아직 클라이언트에서 gRPC 통신을 쉽게 할 수 없는 경우가 많다.
• MS Docs
  • ASP.NET Core gRPC 앱에서 gRPC JSON 코드 변환
  • gRPC JSON 코드 변환에 대한 HTTP 및 JSON 구성
    • .NET 앱에 대한 Protobuf 메시지 만들기
    • .NET용 gRPC 구성
    • .NET의 gRPC에서 로깅 및 진단
    • gRPC와 프로세스 간 통신
• 샘플코드 Transcoder
• ASP.NET Core gRPC 앱에서 gRPC JSON 코드 변환 프로젝트 만들기

참고할 실습 프로젝트

• (2022년) 신입 사원 교육 프로젝트
  • codes/practice_robotmon-go 디렉토리에 있다.
  • .NET 6 버전 사용
• 2023년 지니어스 인턴 프로젝트
  • https://github.com/jacking75/com2us_edu_GenieFarm
• (2024년 1월) 신입 사원 교육 프로젝트
  • 미니게임천국 모작
  • codes/practice_MiniGameHeavenAPIServer 디렉토리에 있다.
  • .NET 8 버전 사용

API 서버의 디렉토리 구성 예

• Controllers: 컨트롤러 클래스를 저장하는 곳
• Dto: 클라이언트와 데이터를 주고받을 때 모델 클래스를 저장하는 곳
• Infrastructure: DB, 메일, 기타 시스템 연동 등의 설정파일을 저장하는 곳
• Libraries: 프로젝트 내 공통 처리를 저장하는 곳
• Repositories: DB 접근 처리를 저장하는 곳
• Services : 비즈니스 로직을 저장하는 곳

│   ├── Controllers
│   │   └── TodoController.cs
│   ├── Dto
│   │   ├── CreateRequestDto.cs
│   │   └── CreateResponseDto.cs
│   ├── Infrastructure
│   │   ├── Configure
│   │   │   ├── DatabaseConfigure.cs
│   │   │   └── ServiceConfigure.cs
│   │   └── Database
│   │       └── TodoEntity.cs
│   ├── Libraries
│   │   ├── Exception
│   │   │   └── ValidationException.cs
│   │   └── Middleware
│   │       └── CustomExceptionMiddleware.cs
│   ├── Program.cs
│   ├── Properties
│   │   └── launchSettings.json
│   ├── Repositories
│   │   └── Todo
│   │       ├── ITodoRepository.cs
│   │       └── TodoRepository.cs
│   ├── Services
│   │   └── Todo
│   │       ├── ITodoService.cs
│   │       └── TodoService.cs
│   ├── TodoApi.csproj
│   ├── TodoApi.sln	
│   ├── TodoApi.http
│   ├── appsettings.Development.json
│   └── appsettings.json
├── Api.Tests
│   ├── Api.Tests.csproj
│   ├── Api.Tests.sln	
│   ├── GlobalUsings.cs
│   └── UnitTests
│       └── Services
│           └── TodoServiceTests.cs
└── dotnet-todo-web-api.sln	

C# 학습 자료

• 학습에는 LinqPad라는 툴을 사용하면 편리하다
  • 2019-03_LinqPad
  • LinqPad 무료 버전에서 nuget을 사용하고 싶을 때
• 빠르게 핵심 위주로 배우고 싶다면 예제로 배우는 C# 프로그래밍 사이트의 글을 본다.
  • 문법
  • 6.0 버전 이후의 새 기능
  • 자료구조
  • 멀티쓰레딩
• (인프런 무료 영상) C# 초보 강좌 예제로 배우는 C# - 11 강 ∙ 8시간 17분
• (인프런 무료 영상) C# 처음부터 배우기 - 커리큘럼 총 11 개 ˙ 3시간 53분의 수업
• (인프런 무료 영상) C# 프로그래밍 - 커리큘럼 총 63 개 ˙ 29시간 56분의 수업
• YOUTUBE 닷넷데브