2011-08-04 6 views
2

Web APIをRESTfulな方法で作成しています。 Grailsはもちろん、REST Webサービスの作成をサポートしています。 Enunciateは、ドキュメントやクライアントライブラリなどが重要なAPIの部分を助けると主張しています。GrailsでEnunciateを使用する

この投稿の目的は、Enabling with Grailsを使用した経験をどのようにするか、またはそれがどのようにできるかについてのアイデアを紹介することです。

  1. 発音するが、JAX-RS、GrailsのによるRESTのではないネイティブ実装で動作します:

    は、それらを一緒に使用して二つの主要な問題があります。ありがたいことに、利用可能なJAX-RSプラグインがありますが、Enunciateがそのプラグインを使用できるかどうかはわかりません。

  2. GrailsドメインクラスはGroovyにあり、EnunciateはJava ソースコード(example)で動作します。

答えて

1

Enunciateは、JavaソースコードとJavaコンパイル済みバイトコードの両方で動作します。しかし、Javaソースコードを持っていないと、Enunciateは生成されたドキュメンテーションを強化するためにJavaDocsから抜き出すことができません。それで、EnunciateをコンパイルされたGroovyバイトコードに適用する方法があるはずですが、EnunciateはJavaDocのドキュメントを見ることができないため、ドキュメントは豊富ではありません。私は理論的に言っています。なぜなら、私はそれについて個人的な経験をしていないし、それをやり遂げるのがどれほど辛いかも分かっていないからです。

ENUNCIATE-356にはこの複雑さを調査するための公開された問題があります。 ENUNCIATE-356ENUNCIATE-584に依存しています。これはもうすぐ勢いを増し、APT(Java 5で導入され、Java 7では非推奨)からJava 6で導入されたJavacツールに移行すると、ENUNCIATE-585によって駆動されます。 JavacツールがJava以外の言語をサポートしているかどうかを知ることは興味深いでしょう。この場合、Groovyのサポートは無料になります。

関連する問題