問題タブ [taglet]

私は、Javadocs の変更 (SVN のソース コードへのリンク、引用の追加など) などに使用されるいくつかのカスタム Taglet クラスがあるプロジェクトに取り組んでいます。私たちがやりたいことの 1 つは、ソースで使用されている注釈を取得し、そこから情報を操作できます。

Taglet インターフェイスは、Java ソース コード内の注釈に簡単にアクセスする方法を提供していないようです。これが可能かどうかは誰にもわかりますか？

私はJDK 1.5を使用しています

javadoc html ファイルに mathML ファイルを含めるためのカスタム タグレットを作成しています。すべての *.mml ファイルを同じフォルダーに保存したいと考えています。

フォルダ。私の質問は: Taglet オブジェクト内 (より具体的には、メソッド内) で @docRoot 文字列の値を知るにはどうすればよいtoString(com.sun.javadoc.Tag tag)ですか? どうもありがとう!

note新しいタグを追加するカスタム Javadoc タグレットを作成しました。

これまでのところ動作しますが、インライン タグは展開されません。コメントの例を次に示します。

{@link}インライン タグは展開されません。ただし、組み込みのparamjavadoc タグでは問題なく機能します。

カスタムJavadocタグレットでネストされたインラインタグを展開する方法はありますか?

ありがとう！

カスタムタグレットを作成してコンパイルし、現在使用しようとしていますが、javadocで実行しようとするとClassNotFoundExceptionが発生し続けます。

javadoc: error - Error - Exception java.lang.ClassNotFoundException thrown while trying to register Taglet proj2.javadoc.CustomTaglet...

ドキュメントの下のnetbeansで、次の引数を指定しました。

-taglet proj2.javadoc.CustomTaglet -tagletpath c:\

クラスファイルをC：\に入れ（少なくとも今のところ）、クラス名を3回チェックしましたが、それでも例外が発生します。ここに欠けているものはありますか？

マルチエージェント システム ベースのフォーカス クロールの作成を検討しています。Aglet や JADE など、さまざまなモバイル フレームワークを見てきました。私の仕事は、常駐ローカルホストに多数のエージェントを作成し、常駐リモートホストにパラメータで移動したいです。私の質問は、エージェントを作成するためにどのフレームワークを使用すればよいですか? エージェントを作成し、中間エージェントを介してリモート ホストに移行する方法。エージェントを作成して移行する方法のサンプル コードを教えてください。ありがとうございました。

Netbeans によって生成された javadoc に LaTeX 式を含める方法はありますか? 次のタグレットを見つけました: http://users.informatik.uni-halle.de/~grau/LaTeXlet/index.html

javadocs引数を変更する必要があります...

どうやってやるの？

カスタム JavaDoc タグレットを作成しており、JavaDoc が処理されているクラスのインスタンスを読み込んで作成したいと考えています。これは私が持っているコードです (パブリック クラス CDKIOOptionsTaglet は Taglet を実装しています):

これは、ロードするクラスが呼び出し中に使用されるクラスパスに追加される jar を含む Ant スクリプトです。

私がJavaDocを作成しているクラスがdist/jarにあるjar。完全を期すために (および要求に応じて)、完全な呼び出しを次に示します。

「ant -v」で、適切なjarにロードされているクラスが実際に含まれていることを確認しました。それでも、私はこのスタックトレースを取得します:

JavaDoc を作成しているクラスを Taglet にロードさせて、リフレクション (など) を使用してそのクラスの詳細を確認し、それを Taglet 出力の一部として返すにはどうすればよいですか?

単体テスト済みのサンプル コード (ソース コード、出力、および任意の入力ファイル) を JavaDoc に挿入するライブラリを作成しており、多くのカスタマイズが可能です。このライブラリを使用する主な方法は、次のようなインライン タグレットを使用することです。

カスタムタグレット(およびドックレットでさえも) は requireであるためcom.sun、これは Java 自体ほどクロス プラットフォームではないことを意味します。(これが関連しているかどうかはわかりませんが、「javadoc」という単語、および部分文字列「doc」でさえもJava 8 言語仕様にはありません。)

このように制限されたライブラリを作成するという考えは好きではありません。それで、私は何をしますか？これまでの私の考えは、

• 既存の javadoc パーサーを利用するために、私はcom.sunタグレットを使い続けています。ただし、私はこの信頼をcom.sunできる限り「薄い」ものにしています。つまり、taglet クラスに入れるコードはできるだけ少なくし、大部分のコードは に依存しない別の場所に残しますcom.sun。
• 私は、特定のタグレットのみを検索する独自のパーサーの作成に取り組んでいます。これは苦痛ですが、それほどひどいものではありません。を検索しながら、各 Java ソース ファイルの行を反復処理します\{@\.myTagletName (.*?)\}。com.sunそのテキストをキャプチャすると、タグレット内のコードとほとんど同じになります。
• このパーサーは、javadoc を実行する前に実行する必要があるため、ディレクトリ構造を複製する必要があります。(1) 解析されていないカスタム タグを含む元のコード、(2) 解析された出力を含むそのコードの複製。すべてのコードを重複したディレクトリにコピーし、これらのタグレット (何らかの方法でパーサーに「登録」されているクラス) を持つことがわかっている Java ファイルのみを解析します。

これは合理的なアプローチですか？クロスプラットフォームの javadoc/taglet パーサーがすでにあるので、自分で作成する必要はありませんか? タグレットのようなクロスプラットフォームは既に存在しますか? JavaDoc自体はクロス プラットフォームではありませんか、それともカスタムのタグレットとドックレットだけですか?

この決定 (インライン タグレットを使用するため) により、ライブラリからロックアウトされている人の数を大まかに把握したいのですが、ほとんどの場合、長期的な解決策を探しています。

(上記の Java 8 リンクにもかかわらず、私は Java 7 を使用しています。)

私の元のアイデアよりもエレガントなタグレットの提案については@fgeに、不吉だが役立つcom.sun警告については@Michaelに感謝します。

私が見る限り、タグレット API のパッケージには 1 つのクラスしかありませんTaglet。Taglet.htmlpackage-summary.html

JDK バージョン 1.5 以降、com.sun.tools.doclets.internal.toolkit.util.

Tagletインターフェイス自体には影響しないと思います。)

タグレットが存在するクラスについて何かを知っているインターフェイスには何もありません。つまり、そのコンテキストについては何もありません。

タグレットが「呼び出されている」クラスの名前を取得する方法はありますか? JavaDocブロックが{@.myTaglet}存在するクラスは?

ハックとして{@.thisClass my.package.AClass}、カスタムタグレットを使用する前に、ユーザーが上部に設定することを強制することを考えています。

より良いアイデアは素晴らしいでしょう。

(Sun のタグレットの概要は次のとおりです。)

(また、別のタグレットの質問である私の以前の質問を検討することを検討してください:インラインタグレット (com.sun が必要) をよりクロスプラットフォームにする方法は? 非 Oracle/よりクロスプラットフォームの javadoc パーサーはありますか? )

javadoc で新しい種類のタグを作成する必要があるため、プロジェクトに Taglet または Tag を使用しようとしています。しかし、始めるのに役立つ例は見つかりません。
私が知る必要があるのは、使用法の良い例が存在するかどうかです。それについて教えているビデオが見つかりません。Oracle APIのドキュメントのみ - http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#tag。どんなヒントでも役に立ちます。