refactor: rename examples/ directory to lib/ and update all path references

This commit is contained in:
2026-07-17 19:21:21 +09:00
parent 8f183d597e
commit 8bb11fe205
17 changed files with 49 additions and 49 deletions
+7 -7
View File
@@ -25,7 +25,7 @@
grpccanary/
├── README.md # 본 프로젝트 종합 소개 및 실행 가이드 (교육용)
├── go.mod / go.sum # Go 모듈 의존성 정의 (Go 1.25.4+)
├── examples/
├── lib/
│ ├── main.go # 학습 예제 통합 실행 진입점 (수동 전환)
│ ├── jsonexample/ # 1단계: JSON 데이터 다루기 실습 예제
│ ├── httpentity/ # 2단계: HTTP & Gin 웹 서버 실습 예제 (WIP)
@@ -39,13 +39,13 @@ grpccanary/
└── GRPC.md # 3단계: gRPC 통신 구현 상세 가이드
```
### 1단계: JSON 데이터 다루기 (`examples/jsonexample`)
### 1단계: JSON 데이터 다루기 (`lib/jsonexample`)
* Go 표준 라이브러리인 `encoding/json`을 활용하여 구조체(Struct)와 JSON 데이터 간의 마샬링(Serialization) 및 언마샬링(Deserialization) 기법을 학습합니다.
### 2단계: HTTP & Gin 웹 서버 (`examples/httpentity`)
### 2단계: HTTP & Gin 웹 서버 (`lib/httpentity`)
* 대중적인 Go 웹 프레임워크 `gin-gonic`을 활용해 RESTful API 사양을 구축하는 방법을 이해합니다. (현재 주석 해제 후 실습하도록 설계된 Work-in-Progress 단계)
### 3단계: gRPC 통신 구현 (`examples/grpcentity`)
### 3단계: gRPC 통신 구현 (`lib/grpcentity`)
* `.proto` 정의를 바탕으로 통신 스키마 계약을 강제하고, Go 언어로 gRPC 서버를 띄워 클라이언트가 날짜/시간, 무작위 비밀번호 및 정수 데이터를 실시간 원격 호출로 송수신하는 분산 통신 기초를 학습합니다.
* `.proto` 정의를 바탕으로 통신 스키마 계약을 강제하고, Go 언어로 gRPC 서버를 띄워 클라이언트가 날짜/시간, 무작위 비밀번호 및 정수 데이터를 실시간 원격 호출로 송수신하는 분산 통신 기초를 학습합니다.
@@ -73,13 +73,13 @@ grpccanary/
### 2. 실습 예제 실행 방법 (진입점 전환)
이 프로젝트는 교육적 목적을 위해 **하나의 `main.go` 파일 안에서 주석 처리를 통해 학습 단계를 수동 전환**하여 실행하도록 설계되어 있습니다.
1. **[examples/main.go](examples/main.go)** 파일을 엽니다.
1. **[lib/main.go](lib/main.go)** 파일을 엽니다.
2. 아래와 같이 실행하고자 하는 예제의 주석을 해제하고 다른 예제는 주석 처리합니다.
* *JSON 예제 실행 시*: `jsonexample.JsonParsingExample()` 활성화
* *gRPC 예제 실행 시*: `grpcSample()` 활성화 (미사용 import 에러를 피하기 위해 `jsonexample` import는 주석 처리 필요)
3. 루트 디렉토리에서 다음 명령어로 실행합니다:
```bash
go run ./examples
go run ./lib
```
### 3. gRPC 예제 동작 흐름 및 기대 출력
@@ -106,4 +106,4 @@ Sensing Update Message: Sensing data updated successfully for device sensor-room
* **[docs/JSON.md](docs/JSON.md)**: 1단계 JSON 데이터 다루기 상세 학습 가이드
* **[docs/HTTP.md](docs/HTTP.md)**: 2단계 HTTP & Gin 웹 프레임워크 상세 학습 가이드
* **[docs/GRPC.md](docs/GRPC.md)**: 3단계 gRPC & Protobuf 상세 학습 가이드 (컴파일 절차 및 소스코드 구현체 분석 포함)
* **[examples/grpcentity/README.md](examples/grpcentity/README.md)**: gRPC 실습 디렉토리 안내 및 `docs/GRPC.md` 심화 가이드로의 링크
* **[lib/grpcentity/README.md](lib/grpcentity/README.md)**: gRPC 실습 디렉토리 안내 및 `docs/GRPC.md` 심화 가이드로의 링크