RESTful 웹 서비스-주소 지정

주소 지정은 서버에있는 리소스 또는 여러 리소스를 찾는 것을 의미합니다. 사람의 우편 주소를 찾는 것과 유사합니다.

REST 아키텍처의 각 리소스는 URI (Uniform Resource Identifier)로 식별됩니다. URI는 다음 형식입니다-

<protocol>://<service-name>/<ResourceType>/<ResourceID>

URI의 목적은 웹 서비스를 호스팅하는 서버에서 리소스를 찾는 것입니다. 요청의 또 다른 중요한 속성은 리소스에서 수행 할 작업을 식별하는 VERB입니다. 예를 들어 RESTful 웹 서비스-첫 번째 애플리케이션 장에서 URI는http://localhost:8080/UserManagement/rest/UserService/users 그리고 동사는 GET입니다.

표준 URI 구성

다음은 URI를 설계 할 때 고려해야 할 중요한 사항입니다.

  • Use Plural Noun− 자원을 정의하기 위해 복수 명사를 사용합니다. 예를 들어 사용자를 리소스로 식별하기 위해 사용자를 사용했습니다.

  • Avoid using spaces− 긴 리소스 이름을 사용할 때는 밑줄 (_) 또는 하이픈 (-)을 사용하십시오. 예를 들어, authorized % 20users 대신 authorized_users를 사용하십시오.

  • Use lowercase letters − URI는 대소 문자를 구분하지 않지만 URL을 소문자로만 유지하는 것이 좋습니다.

  • Maintain Backward Compatibility− 웹 서비스는 공용 서비스이므로 일단 공개 된 URI는 항상 사용할 수 있어야합니다. URI가 업데이트되는 경우 HTTP 상태 코드 300을 사용하여 이전 URI를 새 URI로 리디렉션합니다.

  • Use HTTP Verb− 리소스에 대한 작업을 수행하려면 항상 GET, PUT 및 DELETE와 같은 HTTP 동사를 사용하십시오. URI에서 작업 이름을 사용하는 것은 좋지 않습니다.

다음은 사용자를 가져 오기위한 잘못된 URI의 예입니다.

http://localhost:8080/UserManagement/rest/UserService/getUser/1

다음은 사용자를 가져 오기위한 좋은 URI의 예입니다.

http://localhost:8080/UserManagement/rest/UserService/users/1