URI 설계

URI(Uniform Resource Identifier)는 인터넷에서 리소스를 식별하는 일반적인 방법을 제공하는 문자열이다

 

URI을 설계할 때는 리소스(명사)에 중점을 두고 설계하고 행위(동사)는 메서드로 구현해야 함

 

HTTP 프로토콜에서 주로 사용되는 메서드(Method)는 아래와 같다

 

• GET은 리소스를 조회할 때 사용되며 헤드에 쿼리를 통하여 서버에 데이터 전달
• POST는 데이터 처리와 대부분 등록할 때 사용되며 메시지 바디를 통하여 데이터 전달
• PUT은 리소스가 없으면 생성하고 있으면 기존 리소스를 덮어쓰며 클라이언트가 리소스 위치를 알고 URI를 지정하여 사용하기 때문에 대부분 값을 수정할 때나 파일 등록할 때 사용되며 메시지 바디를 통하여 데이터 전달
• PATCH는 리소스의 일부분을 변경할 때 사용되기 때문에 대부분 값을 수정할 때 사용되며 메시지 바디를 통하여 데이터 전달
• DELETE는 리소스를 삭제할때 사용되며 헤드에 쿼리를 통하여 서버에 데이터 전달

 

예시) 

• 상품 목록 조회(GET) /products ( O ), /readProducts ( X )
• 상품 조회(GET) /products/{id} ( O ), /readProducts/{id} ( X )
• 상품 등록폼(GET) /products/new ( O ), /productsCreateForm ( X )
• 상품 등록(POST) /products ( O ), /products/new ( O ), /createProducts ( X )
• 상품 수정폼(GET) /products/{id}/edit ( O ), /productsUpdateForm/{id} ( X )
• 상품 수정(POST/PUT/PATCH) /products/{id} ( O ), /products/{id}/edit ( O ), /updateProducts/{id} ( X )
• 상품 삭제(POST/DELETE) /products/{id} ( O ), /products/{id}/delete ( O ), /deleteProducts/{id} ( X )

 

하지만 모든 URI를 리소스에 중점을 두고 설계할 수는 없기 때문에 컨트롤 URI를 사용하여 행위를 포함시킬 때도 많음