[250204] URI 이해하기

URI 란? 🌍

1. URI 정의

URI (Uniform Resource Identifier, 통합 자원 식별자)는 웹에서 특정 리소스(자원)를 식별하는 고유한 주소이다.

✅ 쉽게 말하면:

👉 인터넷상의 리소스를 찾고 접근하기 위한 주소 체계

📌 URI의 두 가지 주요 유형

URL (Uniform Resource Locator, 통합 자원 위치자)

• 특정 리소스의 위치를 명확하게 알려주는 식별자
• 예: `https://www.example.com/index.html`

URN (Uniform Resource Name, 통합 자원 이름)

• 리소스를 고유하게 식별하지만, 위치 정보는 포함하지 않음
• 예: `urn:isbn:0451450523` (특정 책의 ISBN)

---

2. URI의 기본 구조

URI는 다음과 같은 구성 요소로 이루어져 있다.

scheme://userinfo@host:port/path?query#fragment

✅ URI 구성 요소 상세 설명

구성요소 설명 예시:

scheme	프로토콜 (http, https, ftp 등)	`https://`
userinfo	(선택적) 사용자 정보 (ID, PW)	`user:pass@`
host	도메인 이름 또는 IP 주소	`www.example.com`
port	(선택적) 포트 번호 (기본: 80, 443)	`:8080`
path	자원의 경로	`/products/item123`
query	(선택적) 추가적인 데이터	`?color=red&size=large`
fragment	(선택적) 문서 내 특정 위치 지정	`#section2`

---

3. URI의 실제 예시 분석

예제 URI:

https://user:password@www.example.com:8080/products/item123?color=red&size=large#reviews

구성요소값 설명:

scheme	`https`	HTTP 보안 프로토콜
userinfo	`user:password@`	로그인 정보 (생략 가능)
host	`www.example.com`	웹사이트 도메인
port	`:8080`	포트 번호 (80이 기본)
path	`/products/item123`	특정 상품 페이지 경로
query	`?color=red&size=large`	상품 색상과 사이즈 선택
fragment	`#reviews`	리뷰 섹션으로 이동

---

4. URL과 URI의 차이

✅ URI는 URL을 포함하는 더 넓은 개념이다.

구분 설명 예시:

URI	리소스를 고유하게 식별	`https://example.com/index.html` (URL) / `urn:isbn:0451450523` (URN)
URL	리소스의 위치를 지정하는 URI	`https://example.com/index.html`

즉, 모든 URL은 URI이지만, 모든 URI가 URL은 아니다. 

---

5. URI 관련 주요 개념

(1) 절대 URI vs 상대 URI

유형 설명 예시:

절대 URI	전체 주소 포함	`https://example.com/page`
상대 URI	기준이 되는 URI에 따라 달라짐	`/page` (현재 도메인 기준)

 

---

(2) URL Encoding (퍼센트 인코딩)

• 웹에서 특수 문자(공백, 한글, &, ? 등)를 인코딩하는 방식
• 공백( ) → `%20`
• `한글` → `%ED%95%9C%EA%B8%80`
• `https://example.com/search?q=안녕`
  → `https://example.com/search?q=%EC%95%88%EB%85%95`

📌 이유:

• URL에 사용할 수 없는 문자를 안전한 형식으로 변환
• 서버가 정상적으로 해석할 수 있도록 하기 위함

---

(3) Query String과 Path Parameter

✅ Query String (`?key=value` 형식)

• `?` 뒤에 `key=value` 쌍으로 데이터 전달
• 여러 개일 경우 `&`로 연결
• 예:

# arduino
https://example.com/products?category=shoes&size=42

• `category=shoes`, `size=42` 값이 서버로 전달됨

✅ Path Parameter (`/key/value` 형식)

• 경로 안에 데이터를 포함하여 전달
• RESTful API에서 자주 사용
• 예:

# arduino
https://example.com/products/123

 

• `123`이 상품 ID를 나타냄

---

6. RESTful API에서 URI 설계 원칙

📌 좋은 URI 설계 가이드라인

명확하고 일관된 리소스 이름 사용

• 좋음: `/users/123`
• 나쁨: `/getUser?id=123`

소문자 사용 & 하이픈(-) 사용

• 좋음: `/blog-posts`
• 나쁨: `/BlogPosts`

HTTP 메서드(GET, POST, PUT, DELETE 등)와 함께 사용

• `GET /users/` → 사용자 목록 조회
• `POST /users/` → 새 사용자 추가
• `GET /users/123` → 특정 사용자 조회
• `PUT /users/123` → 사용자 정보 수정
• `DELETE /users/123` → 사용자 삭제

쿼리스트링은 검색/필터링에만 사용

• 좋음: `/products?category=shoes&color=red`
• 나쁨: `/getProductsByCategoryAndColor?cat=shoes&clr=red`

---

✅ URI 요약 정리

개념 설명:

URI	웹 자원의 고유한 식별자
URL	자원의 위치를 포함한 URI
URN	자원의 위치 없이 고유한 이름만 포함
절대 URI	전체 주소를 포함
상대 URI	현재 위치를 기준으로 지정
퍼센트 인코딩	특수 문자 변환 (예: `공백 → %20`)
Query String	`?key=value` 형식의 데이터 전달 방식
Path Parameter	RESTful API에서 자원 식별에 사용

---

🎯 결론

✅ URI는 웹에서 특정 리소스를 식별하는 중요한 개념이다~
✅ URL은 URI의 한 종류이며, 자원의 위치를 포함한다~
✅ RESTful API 설계 시 명확하고 일관된 URI 사용이 중요하다~