[Web] URL&URI 설계 원칙

URI(Uniform Resource Identifier)란? - 식별자

- 인터넷에 있는 자원을 나타내는 유일한 주소로 하위개념인 URL, URN을 포함한다.

 

URL(Uniform Resource Locator)란? - 위치

- 네트워크 상에서 자원의 위치를 나타내기 위한 규약으로 각각의 URL은 유일한 자원(HTML Page, CSS doc ...)을 가리킨다. 

ex) https://naekang.com/page.htm

 

URN(Uniform Resource Name)란? - 이름

- urn:scheme을 사용하는 URI를 위한 역사적인 이름

ex) naekang.com/page.htm

 

URI 설계 원칙(RFC-3986)

1. 슬래시 구분자(/)는 계층관계를 의미

ex) https://naekang.tistory.com/manage/design/skin

 

2. URL 마지막에는 슬래시 구분자(/)를 포함하지 않음

 

3. 하이픈(-)은 가독성을 높이기 위해 사용

ex) https://www.udemy.com/courses/development/web-development/

 

4. 언더바(_)는 사용하지 않음

 

5. 소문자 사용

 

6. 파일 확장자를 포함하지 않음

ex) .jsp 같은 확장자 포함 X

 

7. 의존적 확장자를 사용하지 않음

ex) .do

 

8. 구현에 의존적인 경로를 사용하지 않음

ex) servlet/ 등

 

9. 세션 ID 포함하지 않음

 

10. Method명 포함하지 않음

 

11. 명사에는 단수보다는 복수형 사용, 컬렉션에 대한 표현은 복수

ex) classes, curriculums, categories

 

12. 컨트롤러 이름에는 동사나 동사구 사용

 

13. 경로 중 변하는 부분은 유일한 값으로 대체

ex) lesson-id, user-id

 

14. CRUD 기능을 나타내는 것은 URI에 사용하지 않음

 

15. URI Query Parameter 디자인은 결과 필터링 및 페이지 구분 용도

ex) ?chapter=2&page=0&size=10