2010-06-17 2 views
4

내가 이해 한대로, WADL을 사용하여 RESTful 웹 서비스를 설명해야합니다. 그래도 사용자가 WADL 사용에 강력하게 반대하는 관련 게시물에서 많은 답변을 읽었습니다.RESTful 서비스 설명

WADL의 단점은 무엇입니까? 다른 해결책이 있습니까?

+1

무엇을하려고합니까? 왜 당신은 당신의 서비스에 대한 공식적인 설명이 필요합니까? –

+0

@ 윌리엄 : 도구로 인해 소비 될 수있는 설명이 있으면 좋겠지 만 액세스 코드를 생성하는 데 도움이됩니다. –

+0

@ 존 : 좋을 수도 있고, 도구가 문제에 잘 적응하지 못했다는 신호 일 수도 있습니다. 코드 생성은 중복을 추출하고 표현력을 높이기위한 불량한 대체 방법입니다. –

답변

4

HTTP 사양은 리소스 검색 및 업데이트 방법을 알려줍니다. 리소스는 URI로 식별되며 함께 연결되어야하므로 웹 사이트의 페이지처럼 모든 데이터가 서비스 루트 URL에서 검색 가능해야합니다. 그 나뭇잎은 당신이 전선을 통해 전송할 미디어 유형을 문서화하는 것입니다.

이 방법을 사용하고 서비스에서 미디어 유형을 다시 사용하면 미디어 유형을 한 번만 문서화하면 모든 서비스에 적용 할 수 있습니다.

이러한 단계를 수행하면 WADL이 문서화하기 위해 남은 것이 없습니다.

REST를 수행하려는 경우 WADL을 사용하여 클라이언트 생성 코드를 생성 할 수 없으므로 클라이언트와 서버 간의 긴밀한 결합이 생성됩니다. 그래도 괜찮 으면 좋겠지 만 REST를하지 않으므로 REST의 이점 중 일부를 인식하지 못합니다.

+1

정확합니다. 자세한 내용은 REST라는 용어를 사용하는 사람 Roy Fielding의이 게시물을 참조하십시오. http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven –