毎日の作業記録APIDOCアプリケーション--JAVA

まず、何APIDOCこと?

apidocは自動的にAPIインタフェースのドキュメントを生成するためのツールである、というシンプルな人気のポイント。このようなC#、Java(登録商標)は、JavaScript、PHPなど、多言語インターフェースのドキュメント生成をサポートし 、Pythonの詳細については、を参照してくださいなど、公式ドキュメントJavaコードはapidoc注釈で実現することができます。

二、APIDOCインストール

  1. apidocのNode.jsのが依存するので、あなたは最初のNode.jsをインストールする必要があるため

 2. apidocをインストールします。

Runコマンドボックスを開くためにcmdを、コマンド入力NPMは-g apidocをインストールし、インストールします。

コマンドの使用-h apidocをインストールが成功したことを確認します。

 三、APIDOCの使用

 1.設定のapidoc.json

Apidoc.jsonファイルをプロジェクトに作成され、プロジェクトの場所は、ルートディレクトリ(srcディレクトリと同じレベル)で推奨されて、あなたはまた、選択することができます。

次のように内容の例apidoc.json:

1  {
 2    "名": "プロジェクト名" 3    "バージョン": "プロジェクトバージョン" 4    "説明": "プロジェクトの説明" 5    "タイトル": "ブラウザのタイトル" 6    "URL":「API接頭辞パスの前に、経路を自動的@apiにスプライスされた空の文字列に設定することができる「
 7 }

 具体的な設定パラメータの名前とその意味はを参照してください公式文書

中国のリファレンスドキュメント

 2. インタフェースはapidocコメントを追加します

具体的な設定パラメータの名前とその意味はを参照してください公式文書

中国のリファレンスドキュメント

  3.インタフェースのドキュメントを生成

実行コマンドボックスオープンCMD、ディレクトリapidoc.jsonにcd使用apidoc -iのsrc / -o apidocは/インターフェースのHTMLドキュメントの形式を生成します 

コマンドパラメータ詳細リスト:

パラメータ 説明
 -h、--help  私たちのヘルプドキュメント
 -f --file-フィルタ

指定されたファイル名フィルタは、以下のようなファイルの正規表現(複数指定することができます)読み:apidocの-f - "* \ JS&QUOTを、-f" * TS&QUOT ;; -f&QUOT * \\ TS ......" .cljの.cls .coffeeた.cppは.cs .dart .erl .exs .GOの.groovy .inoの.java ??:fは ".. * tsが" 唯一のjsサフィックスTSファイルとデフォルト値を読み出します。 JS .jsxの.kt .litcoffee LUA .Pの.php?.plの.PMの.py .RB .scala .TS .vue

 -e --exclude-フィルタ  (複数を指定することができます)正規表現をフィルタリングし、指定したファイル名を読んなどしないでください:apidoc -e「.. * \ Jsの$は、」ファイルのjsサフィックスデフォルトを読み取れません意味: 『』
 -i、--input  ディレクトリたとえば、ソースファイルが読み込まれ、指定:apidoc -i myappのリード/ライトは、myappの/ソースファイルディレクトリのデフォルトを意味します./
 -o、--output  DOC /出力-o apidocはdocディレクトリのデフォルトを文書化することを意味します。次のような出力ディレクトリ文書を指定します./のdoc /
 -t、--template  テンプレートファイルには出力例を指定します。apidoc -t MyTemplateに/デフォルト:path.join(__ dirnameは、 '... /テンプレート/')(デフォルトのテンプレート)
 -c、--config  例えば、コンフィギュレーション・ファイル(apidoc.json)を含むディレクトリを指定します。apidoc -c設定/デフォルト:./
 -p、--private  apidoc -p○デフォルト値:出力ドキュメントは、独自のAPIの例が含まれているかどうかはfalse
 -v、--verbose  apidoc -v○デフォルト値:次のような出力するかどうかのデバッグ情報の詳細はfalse

おすすめ

転載: www.cnblogs.com/ntfblogs/p/10974705.html