์ด๊ฒ์ Swagger-core1.6.12released!sourcecode.zip์ผ๋ก ์ต์ ๋ฆด๋ฆฌ์ค๋ฅผ ๋ค์ด๋ก๋ํ ์ ์๋ Swagger Core๋ผ๋ Windows ์ฑ์ ๋๋ค. ์ํฌ์คํ ์ด์ ์ฉ ๋ฌด๋ฃ ํธ์คํ ์ ๊ณต์ ์ฒด์ธ OnWorks์์ ์จ๋ผ์ธ์ผ๋ก ์คํํ ์ ์์ต๋๋ค.
OnWorks์ ํจ๊ป Swagger Core๋ผ๋ ์ด ์ฑ์ ๋ฌด๋ฃ๋ก ๋ค์ด๋ก๋ํ์ฌ ์จ๋ผ์ธ์ผ๋ก ์คํํ์ญ์์ค.
์ด ์ฑ์ ์คํํ๋ ค๋ฉด ๋ค์ ์ง์นจ์ ๋ฐ๋ฅด์ธ์.
- 1. ์ด ์ ํ๋ฆฌ์ผ์ด์ ์ PC์ ๋ค์ด๋ก๋ํ์ต๋๋ค.
- 2. ํ์ผ ๊ด๋ฆฌ์ https://www.onworks.net/myfiles.php?username=XXXXX์ ์ํ๋ ์ฌ์ฉ์ ์ด๋ฆ์ ์ ๋ ฅํฉ๋๋ค.
- 3. ์ด๋ฌํ ํ์ผ ๊ด๋ฆฌ์์์ ์ด ์์ฉ ํ๋ก๊ทธ๋จ์ ์ ๋ก๋ํฉ๋๋ค.
- 4. ์ด ์น์ฌ์ดํธ์์ ๋ชจ๋ OS OnWorks ์จ๋ผ์ธ ์๋ฎฌ๋ ์ดํฐ๋ฅผ ์์ํ์ง๋ง ๋ ๋์ Windows ์จ๋ผ์ธ ์๋ฎฌ๋ ์ดํฐ๋ฅผ ์์ํฉ๋๋ค.
- 5. ๋ฐฉ๊ธ ์์ํ OnWorks Windows OS์์ ์ํ๋ ์ฌ์ฉ์ ์ด๋ฆ์ผ๋ก ํ์ผ ๊ด๋ฆฌ์ https://www.onworks.net/myfiles.php?username=XXXXX๋ก ์ด๋ํฉ๋๋ค.
- 6. ์ ํ๋ฆฌ์ผ์ด์ ์ ๋ค์ด๋ก๋ํ์ฌ ์ค์นํฉ๋๋ค.
- 7. Linux ๋ฐฐํฌ ์ํํธ์จ์ด ์ ์ฅ์์์ Wine์ ๋ค์ด๋ก๋ํฉ๋๋ค. ์ค์น๊ฐ ์๋ฃ๋๋ฉด ์ฑ์ ๋ ๋ฒ ํด๋ฆญํ์ฌ Wine๊ณผ ํจ๊ป ์คํํ ์ ์์ต๋๋ค. ์ธ๊ธฐ ์๋ Windows ํ๋ก๊ทธ๋จ ๋ฐ ๊ฒ์์ ์ค์นํ๋ ๋ฐ ๋์์ด ๋๋ Wine์ ํตํ ๋ฉ์ง ์ธํฐํ์ด์ค์ธ PlayOnLinux๋ฅผ ์ฌ์ฉํด ๋ณผ ์๋ ์์ต๋๋ค.
Wine์ Linux์์ Windows ์ํํธ์จ์ด๋ฅผ ์คํํ๋ ๋ฐฉ๋ฒ์ด์ง๋ง Windows๊ฐ ํ์ํ์ง ์์ต๋๋ค. Wine์ ๋ชจ๋ Linux ๋ฐ์คํฌํ์์ ์ง์ Windows ํ๋ก๊ทธ๋จ์ ์คํํ ์ ์๋ ์คํ ์์ค Windows ํธํ์ฑ ๊ณ์ธต์ ๋๋ค. ๋ณธ์ง์ ์ผ๋ก Wine์ Windows๊ฐ ํ์ํ์ง ์๊ณ ๋ชจ๋ Windows ์์ฉ ํ๋ก๊ทธ๋จ์ ์คํํ ์ ์๋๋ก Windows๋ฅผ ์ฒ์๋ถํฐ ์ถฉ๋ถํ ๋ค์ ๊ตฌํํ๋ ค๊ณ ํฉ๋๋ค.
์คํฌ๋ฆฐ ์ท
Ad
์ค์จ๊ฑฐ ์ฝ์ด
๊ธฐ์
Swagger Core๋ OpenAPI ์ฌ์์ Java ๊ตฌํ์ ๋๋ค. ํ์ฌ ๋ฒ์ ์ JAX-RS2(javax ๋ฐ jakarta ๋ค์์คํ์ด์ค)๋ฅผ ์ง์ํฉ๋๋ค. ์ผ๋ฐ์ ์ธ ์ฌ์ฉ ์๋๋ฆฌ์ค ์ค ํ๋๋ swagger-jaxrs2๋ฅผ ๊ธฐ์กด ๋๋ ์๋ก์ด JAX-RS ๊ธฐ๋ฐ ํ๋ก์ ํธ("์ฝ๋ ์ฐ์ ")์ ํตํฉํ์ฌ ํ๋ก์ ํธ ์๋ช ์ฃผ๊ธฐ ๋์ ๋๊ธฐํ๋ ์ํ๋ก ์ ์ง๋๋ API ์ ์๋ฅผ ์๋์ผ๋ก ์ ๊ณตํ๊ณ ๋ ธ์ถํ๋ ๊ฒ์ ๋๋ค. ์ด๋ฌํ ์ ์๋ API ๋ฌธ์(์: swagger-ui ์ฌ์ฉ, ๋ค์ํ ์ธ์ด๋ก API ํด๋ผ์ด์ธํธ ์์ฑ(์: swagger-codegen ์ฌ์ฉ)), ์ฌ์ฉ์ ์ ์ ์ฒ๋ฆฌ ๋ฑ์ ํฌํจํ ์ถ๊ฐ ์ฒ๋ฆฌ/์๋น์ ๊ธฐ๋ฐ์ด ๋ ์ ์์ต๋๋ค. ์ด๋ฌํ ๊ฒฐ๊ณผ๋ JAX๋ฅผ ์ค์บํ์ฌ ๋ฌ์ฑ๋ฉ๋๋ค. -RS ๋ฆฌ์์ค ๋ฐ ํด๋น ์์ ๋ฐ ์ฌ์ฉ๋ ์ ํ ํด๊ฒฐ, (๋ํ) ์ ์ฉ๋ ์ฃผ์ ์ฒ๋ฆฌ(์: Swagger, JAX-RS, Jackson, JAXB ๋ฑ) ํ์ฅ ๋ฉ์ปค๋์ฆ์ ํตํด ์ถ๊ฐ ์ฌ์ฉ์ ์ ์ ๋ฐ ์ฌ์ /์ฌํ ์ฒ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ํ์ฉํฉ๋๋ค.
๊ธฐ๋ฅ
- OpenAPI ์ฌ์ Java ๊ตฌํ
- (์ฃผ์์ด ์๋) Java POJO๋ฅผ OpenAPI ์คํค๋ง๋ก ํด์ํ๊ณ ์ง๋ ฌํ/์ญ์ง๋ ฌํ๋ฅผ ์ฒ๋ฆฌํ๊ณ ํตํฉ ๋ฉ์ปค๋์ฆ์ ์ ๊ณตํฉ๋๋ค.
- JAX-RS(์ฃผ์์ด ์๋) ๋ฆฌ์์ค๋ฅผ OpenAPI ์ ์๋ก ํด์ํ๊ณ ํตํฉ ๋ฉ์ปค๋์ฆ์ ์ ๊ณตํฉ๋๋ค.
- swagger-core, swagger-jaxrs2 ๋ฐ/๋๋ ๊ธฐํ ํ๋ก์ ํธ์์ ์์ฑ๋ ์ถ๋ ฅ์ ์ ์ธํ๊ณ ์กฐ์ํ๊ธฐ ์ํ ์ฃผ์
- ๋น๋ ์ OpenAPI ์ ์๋ฅผ ํด๊ฒฐํ๊ธฐ ์ํ maven ํ๋ฌ๊ทธ์ธ ์ ๊ณต(swagger-jaxrs2 ์ฌ์ฉ)
- ๋น๋ ์ OpenAPI ์ ์๋ฅผ ํด๊ฒฐํ๊ธฐ ์ํ gradle ํ๋ฌ๊ทธ์ธ ์ ๊ณต(swagger-jaxrs2 ์ฌ์ฉ)
ํ๋ก๊ทธ๋๋ฐ ์ธ์ด
์๋ฐ
์นดํ ๊ณ ๋ฆฌ
์ด๊ฒ์ https://sourceforge.net/projects/swagger-core.mirror/์์๋ ๊ฐ์ ธ์ฌ ์ ์๋ ์ ํ๋ฆฌ์ผ์ด์ ์ ๋๋ค. ์ฐ๋ฆฌ์ ๋ฌด๋ฃ ์ด์ ์ฒด์ ์ค ํ๋์์ ๊ฐ์ฅ ์ฌ์ด ๋ฐฉ๋ฒ์ผ๋ก ์จ๋ผ์ธ์ผ๋ก ์คํํ๊ธฐ ์ํด OnWorks์์ ํธ์คํ ๋์์ต๋๋ค.