2017-12-07 33 views
2

私はソフトウェアをモデリングし、コードスケルトンを生成するためにEnterprise Architectを使用しています。このプロセスの一環として、ツールはクラス、関数、およびデータメンバーのドキュメントブロックを自動的に追加します。これは問題ありませんが、出力をカスタマイズする明確な方法はありません。たとえば、これはクラスFooのために出てくるものです:私はコードテンプレートエディタで見てきたが、このすべてのようなものが魔法の機能の背後に隠されているように見えるEnterprise Architectが生成するドキュメントブロックをどのようにカスタマイズできますか?

/** 
* Text from the properties window in EA for Foo. 
* @author My Name 
* @version 1.0 
* @created 26-Oct-2017 12:32:57 
*/ 
class Foo 
{ 

。たとえば、C++ Class Notesテンプレートには%JAVADOC_COMMENT($wrapLen)が含まれていますが、そのコメントに何が影響するかはわかりません。

EAのJavaDoc出力をカスタマイズする方法はありますか?あるいは、私自身の「コメントスタイル」を定義するのでしょうか?たとえば、アイテムが表示される順番を入れ替えたい場合は、パラメータの間に空白行を追加するか、マニュアルブロックから@createdを削除したい場合があります。あなたはあまりにも言及している

答えて

1

魔法機能は、マクロdocumentedです:

JAVADOC_COMMENT([wrap_length])
は、現在のjavadocスタイルのコメントへのスコープ内の要素のためのノートを変換します。

マクロが動作する方法を微調整することはできません。
しかし、本当にその価値があると思うのであれば、標準マクロを自分のコメントセクションに置き換えることはもちろん可能です。

+0

私はコード生成テンプレートでJAVADOC_COMMENT()を見たことがありますが、調整が必要なことではないことを確認していただきありがとうございます。 – CodingHero