자신감 평안한 튜토리얼을 설정하는 인터페이스
I. 서론
자신감은 많은 기업들이 이제 전면 및 후면 끝, 자신감 점점 더 인기의 분리를 실현 자동으로, 기능 테스트 기능 + 소프트웨어를 생성하는 문서 편안 온라인 인터페이스입니다.
중국어 공식 웹 사이트 : http://www.sosoapi.com/
둘째, (절판 건조 제품) 역사적 버전
사실, 자신감의 두 가지 버전이 있습니다,하지만 차이가 너무 커서있는 자신감-▽를 swagger1이며, 거기 springfox - 자신감이 swagger2이며, 많은 사람들이 두 버전 각각을 혼동 모른다 각각의 특징이 블로그는 먼저 자신감-UI가 말할 것이다.
셋째, 버전 A (자신감-UI)
입력하여 HTTP : // localhost를 경로로 8080 / 프로젝트 /dist/index.html 직접 액세스 페이지에.
I이었다 통해 http : // localhost : 8080 / swagger_springmvc / DIST / index.html을 # /
작업 준비 넷째,
프론트 엔드의 HTML 다운로드
다운로드 DIST의 파일
- 자신감-UI HTML 버전을 다운로드 할 수있는 최초의 필요성, 두 가지 방법이있다
- 첫 번째 : GitHub의에서 다운로드 HTML · · ·
https://github.com/swagger-api/swagger-ui
주의
당신이 그것을 다운로드 할 수있는 첫 번째 방법을하면 자신감-UI는 지원되지 않습니다 그렇지 않으면 최신 버전 DIST를 다운로드하지 마십시오 버전을 유의해야합니다. 2.x는 버전을 다운로드합니다.
주소 : HTTPS : //github.com/swagger-api/swagger-ui/tree/2.x/dist
어떻게 든 준 한 모든 후, 개인 권고 또는 내 블로그에서 다운로드.
항아리 패키지 다운로드
<! - 자신감包-> 자신감-springmvc 1.0.2 자신감-모델 1.0.2 자신감-주석 1.3.11 <! - JSON包-> JSON-lib 디렉토리 2.4 <! - JACKSON包-> 잭슨 -annotations 2.6.5 잭슨 - 데이터 바인딩 2.6.5 잭슨 코어 2.6.5
참고
이성의 버전을 달성 할 수 없기 때문에 버전이 아마 변경 한 경우 이러한 버전 항아리 패키지, 변경할 수 없습니다, 변경 한 경우 간단한 버전 자신감 항아리 패키지는이 블로거가 개인적으로 테스트하기 전에, 그것은 매우 가능성이 없습니다 말한다 .
프로젝트는 Maven 프로젝트 일 경우, 다음 제안은 메이븐 저장소에 자신의 병 패키지에 다음을 제공하는 것입니다. 폼은 파일 및 다음 내 경우처럼, 소개했다.
물론, 당신은 직접 개인 권고 또는 매우 표준의 치어에 대한 소개를 추가 할 수 있습니다.
다섯째, 코드 구현
항아리 패키지 소개
(제 III) 전에 항아리 패키지의 도입 그런 말을합니다.
프런트 엔드 파일 DIST의 도입
dist 파일 웹 애플리케이션 디렉토리에 다운로드 한 파일을 복사합니다. (필자는은 MyEclipse를 사용하여 다른 소프트웨어 이름은 다를 수 있습니다)
프로젝트 자신감 명명 규칙을 수정 URL URL이 될 것입니다 DIST 폴더의 index.html을 파일을 수정 URL IP +의 포트 번호 + 프로젝트 루트 경로 + API를-문서 (당신은 프로젝트 루트 경로 경우가있는 경우)
주의 사항
는 URL 후 API-문서 고정
구성 구성
새로운 config 폴더, 파일의 새 swagger.java 파일, 구성 정보를 시작합니다.
본 문서 프로필의 다음에 소개
컨트롤러 노트
우리의 환경 설정에 따라 표시 될 레이어를 제어하는 방법은 두 가지가 있습니다.
길
두 번째 방법
두 가지 접근법은 서면의 종류처럼 당신을 볼 수 있습니다.
여섯째, 결과는 접근을 보여
시작 프로젝트 액세스 주소
경로 + / DIST / index.html을 #으로 프로젝트의 주소 + IP + 포트 번호는 /
// localhost를 : 8080 / swagger_springmvc 난을 http / DIST / index.html을 # / 접미사를 변경하지 마십시오하는 것은 고정