이전에 프로젝트 인터페이스 제공에 webapi를 사용했는데, 프로젝트 내에서 webapi 메서드와 주석에 따라 도움말 문서가 자동으로 생성되는 기능을 발견했고, 매우 강력한 Webapi 메서드도 테스트할 수 있습니다. 이제 여러분과 공유하겠습니다. 먼저 생성된 webapi 문서를 살펴보세요. 1. 다음 그림은 생성 도움말 문서의 상단 페이지를 보여주며, 여기서 Values가 컨트롤러이고, API 아래 목록에는 http 메서드(Get, POST 등), 요청의 동작, 메서드 설명이 나와 있습니다. 2. 아래 그림과 같이 빨간 상자의 링크를 클릭하여 API 메서드의 세부 정보 페이지를 엽니다. 3. 테스트 API를 클릭하여 다음 페이지를 열어
4. 매개변수를 입력하고 전송 버튼을 클릭한 후 다음 페이지를 열면 반환 값을 확인할 수 있습니다.
설정 단계는 다음과 같습니다: 개발 환경 VS2012 + MVC4 + WEB API 1. NuGet을 통한 웹 API 테스트 클라이언트 참조
DLL을 참조하면 다음과 같은 파일이 생성됩니다: 이것이 저희의 도움말 문서 인터페이스입니다
2. 프로젝트 속성에서 다음 설정을 하고, XMl 문서 파일을 확인하며, 경로를 설정하세요 3. 프로젝트의 App_Data 폴더 아래에 XmlDocument.xml 생성 4. AreasHelpPageApp_StartHelpPageConfig.cs 파일을 열고 다음 코드 주석을 취소합니다
프로젝트를 실행하고 http://localhost:3619/Help 를 열면 자동으로 생성된 API 문서를 볼 수 있는데, 이는 해당 문서의 이미지입니다
프로젝트 다운로드:
|