2011-08-04 2 views
2

웹 API를 RESTful 방식으로 작성하고 있습니다. 물론 Grails는 REST 웹 서비스를 만드는 데 도움이된다. Enunciate은 문서, 클라이언트 라이브러리 등과 같은 것이 중요한 API 부분에서 도움을 청합니다.Grails로 Enunciate 사용

이 글의 목적은 Enablesiate with Grails를 사용하여 경험을 초대하거나 어떻게 할 수 있는지에 대한 아이디어입니다.

  1. 하게 발음이 JAX-RS, Grails가 REST 아닌 기본 구현에서 작동합니다

    함께 그들을 사용하여 두 가지 문제가 있습니다. 고맙게도 사용할 수있는 JAX-RS 플러그인이 있지만 Enunciate가이 플러그인을 사용할 수 있는지 확실하지 않습니다.

  2. Grails 도메인 클래스는 Groovy에 있으며 Enunciate는 소스 코드 (example)와 함께 작동합니다.

답변

1

Enunciate는 Java 소스 코드와 Java 컴파일 된 바이트 코드로 작동합니다. 그러나 Java 소스 코드가 없으면 Enunciate는 생성 된 문서를 향상시키기 위해 JavaDocs에서 물건을 가져올 수 없습니다. 그렇다면 Enunciate를 컴파일 된 Groovy 바이트 코드에 적용하는 방법이 있어야하지만, Enunciate가 JavaDoc 문서를 볼 수 없기 때문에 문서가 풍부하지는 않습니다. 이론적으로 나는 개인적인 경험이 없기 때문에 이론적으로 말하지도 않고 그것이 얼마나 고통 스러운지도 알지 못한다.

이 복잡성을 조사하기 위해 ENUNCIATE-356에 공개 문제가 있습니다. ENUNCIATE-356ENUNCIATE-584에 따라 달라 지므로 APT (Java 5에서 소개 된 Java 5에서 소개 된 Java 7에서 사용되지 않음)에서 Java 6에 도입 된 Javac 도구로 이동하면서 곧 더 많은 견인력을 얻을 수 있습니다. ENUNCIATE-585으로 구동됩니다. Javac 도구가 Java 이외의 언어를 지원하는지 여부는 흥미로울 것입니다.이 경우 우리는 Groovy 지원을 무료로 얻을 수 있습니다.