2011-09-30 19 views
2

在我的grails 1.3.7項目中,我已經將所有類放在com.mycompany.myapp中,就像你一樣。所以這適用於服務,控制器和域類。我有一個過濾器,它在自己的包中。我的應用工作正常。grails-doc在默認包中創建我的類的副本

然而,當我運行grails doc,Grails的決定爲每類中創建兩個頁面:在其右側comp.mycompany.myapp包

  • 一個擁有所有正確的Groovy文件
  • 其他需要所有上述類和假裝,如果這些也住在默認包。

因此,目標/ docs包含兩個目錄:「DefaultPackage」和「COM」,與DefaultPackage持有/,根據COM住所有內容的副本

因此,我的常規文檔看起來雜亂無章,因爲在兩個每個班級的副本。

我該如何解決這個問題?

回答

1

它已被記錄爲GRAILS-6605的錯誤。此處沒有列出該錯誤的解決方法。

+0

在這裏找到了些更多的信息:http://groovy.329449.n5.nabble.com/Problem-with-groovydoc-td4263338.html –

1

我也面臨同樣的問題,因此創建了一個插件「Grails Runtime Docs」(http://grails.org/plugin/grails-runtime-docs),它解決了這個問題,並且正確地生成Java和Groovy文檔,每個類只有一個副本。它能夠識別Grails,並將這些類分類爲Controllers,Commands,Domains,Services和Tag Libraries。 Groovy文檔實際上是從運行時生成的,以便包含動態方法,在生成的html文檔中添加「動態方法摘要」&「動態方法詳細信息」,以提供其源信息。希望你覺得它有用。

+0

這個插件不支持grails 2.2.0,有兩個問題它。收到錯誤 「顯示java.lang.NullPointerException \t在com.imaginea.labs.grails.runtimedocs.GroovyRuntimeDocWriter.writePackages(GroovyRuntimeDocWriter.java:39) \t在RuntimeDocs $ _run_closure4.doCall(RuntimeDocs:137)」 –