Torutk

2020/03/08

高徹 18:58 ソフトウェアエンジニアリング つれづれ Java編: .idea/misc.xml をリポジトリで管理し共有するかどうか

Javadocを生成する際の設定（出力先、javadocコマンドラインオプションなど）がmisc.xmlに保持されます。
出力先は、ホームディレクトリからのパスとなっているため、リポジトリで共有するとやっかいです。
しかし、misc.xmlを共有から外すと、プロジェクトで使用するJDKが不明となります。
misc.xmlの記載内容（１）　使用するJDKの設定 高橋 徹

高徹 10:15 ソフトウェアエンジニアリング つれづれ Java編: Ant生成

[Build]メニュー > [Generate Ant Build]でAntファイルを生成できます。
Antファイルの生成方法は次の2つがあります。
* 複数ファイルの生成（モジュール毎に1つとメインを1つ） → Generate multiple-file ant buildにチェック
* 単一ファイルの生成 → Generate single-file ant buildにチェック
小さなアプリケーションやライブラリでは、単一ファイルの生成を、マ... 高橋 徹

2020/03/07

高徹 13:04 ソフトウェアエンジニアリング つれづれ Java編: IntelliJ IDEA画面に背景画像

日本語ドキュメントの以下URLに背景画像の設定方法があります。
https://pleiades.io/help/idea/setting-background-image.html
ショートカットでCtrl+Alt+S、または[File]メニュー > [Settings]で、左ペインの[Appearance & Behavior] > [Appearance]をドリルダウンし、右ペイン中付近の[Background Image]ボタンで設定を開きます。
... 高橋 徹

2020/03/05

高徹 11:12 ソフトウェアエンジニアリング つれづれ Java編: NetBeans 11.3

NetBeans 11.3がリリースされていました。
https://netbeans.apache.org/download/nb113/index.html
目玉機能は、
* Java開発支援
** プレビュー機能 Records (JEP 359）
** instanceofのパターンマッチング（JEP 305）
** シングルソースファイルの実行（JEP 330）
** テキストブロック改善（JEP 355）
** Gradle 6.0
... 高橋 徹

2020/02/25

高徹 00:09 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. Windows上でUTF-8でソースコードを記述した際、PlantUMLの図で文字化け
Windows日本語版のデフォルト文字コードはWindows-31J（シフトJIS系）のため、ソースコードをUTF-8で記述していると、ASCII文字以外の文字がPlantUMLの生成した図で文字化けしてしまう。
そこで、明示的に文字コードを指定する。 高橋 徹

2020/02/24

高徹 23:54 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. javadoc実行時にplantumlの記述が警告にならないようにしたい
Javadocのドキュメントコメント内にplantumlの記述をすると、
* @startumlや、@endumlが未定義タグとして警告
* 大なり・小なり記号（<、>）が警告（エラー）
などがあります。
-そこで、plantumlの記述をドキュメントコメントではなくjavadoc処理対象外のブロックコメントに記述します。-
以下はダメ 高橋 徹

高徹 23:28 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. PNGではなくSVGを生成
build.xmlで、plantumlタスクの属性 format に"svg"を指定します。 高橋 徹

高徹 23:24 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. javadoc-umlビルド後、ブラウザに表示するところまで自動化したい
build.xmlでjavadoc-umlターゲットの最後に-javadoc-browseターゲットを呼び出すantcallを追加します。 高橋 徹

高徹 23:21 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. 独自のAntターゲットを実行するのは面倒
* 左側ペインで[ファイル]タブを選択、build.xmlを展開し、javadoc-umlを右クリック > [ショートカットを作成]
ウィザードが表示されるので、メニューなりツールバーに追加する
以下はツールバーへの追加設定例
{{thumbnail(create_shortcut_toolbar-1.png, size=320)}}
{{thumbnail(create_shortcut_tool... 高橋 徹

高徹 23:14 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. imgタグにパッケージの深さに応じた相対パスではなくdoc-filesに生成するようにしたい
Javaソースコードコメントには次のように記述する。 高橋 徹

高徹 22:16 ソフトウェアエンジニアリング 調査 #104 (進行中): Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

javadocで生成したドキュメント例。シーケンス図が貼られている。
{{thumbnail(umlsequence-1.png, size=320)}}
高橋 徹

高徹 22:10 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

次の環境で、PlantUMLのUML図（シーケンス図）をJavadocコメントに貼る方法を調査する。
|_. OS | Windows 10 Pro 1909 64bit 日本語版 |
|_. JDK | Oracle JDK 8u241 Windows 64bit版 |
|_. NetBeans IDE | 8.2 日本語版 |
NetBeans IDEを起動し、Javaアプリケーションプロジェクトを新規作成する。
その際、パッケージ名： com... 高橋 徹

高徹 19:30 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

javaソースコードのコメントにPlantUMLのUML記述を記載し、Antでビルドする方法が次のドキュメントにあり。
https://plantuml.com/ja/ant-task
NetBeans IDEのAntプロジェクトで上述のAntタスクを使用してJavadocコメントにPlantUMLで生成したUML図を貼る方法が次のドキュメントにあり。
http://randomthoughtsonjavaprogramming.blogspot.com/20... 高橋 徹

高徹 13:18 ソフトウェアエンジニアリング 調査 #104 (進行中): Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

調査目的：JavaソースファイルのコメントにPlantUMLツール用の言語（テキスト）を記述し、それから生成したUML図（シーケンス図、クラス図など）をJavadocで生成するドキュメントに含めたい
調査結果：
* [#104-2] に JavadocでPlantUMLの図を生成しドキュメントに貼る手順を記載。
課題：
* imgタグにパッケージの深さに応じた相対パスを記載するのは億劫、doc-filesに生成するようにしたい
⇒ 解決[#10... 高橋 徹

高徹 13:35 ソフトウェアエンジニアリング 調査 #105: 主要ダウンロード先サイトへのホップ数調査

h5. 2020-02-24調査
|_. サイトURL |_. IPv6 |_. ホップ数 |
|ftp.tsukuba.wide.ad.jp | yes | 14 |
|ftp.yz.yamagata-u.ac.jp | yes | 10 |
|ftp.nara.wide.ad.jp | yes | 15 |
|ftp.riken.jp | no ... 高橋 徹

高徹 13:22 ソフトウェアエンジニアリング 調査 #105 (解決): 主要ダウンロード先サイトへのホップ数調査

調査目的：大きなファイルをダウンロードする際、ネットワーク的な遠近を判断するためにトレースルートする
調査結果：
完了条件： 高橋 徹

2020/02/22

高徹 23:58 ソフトウェアエンジニアリング 調査 #101: WSL上のCentOS 7でリモートXで日本語入力をする

ibus-kkc を入れてうまく動かなかった
https://torutk.hatenablog.jp/entry/2019/11/24/110818
ibus がWSLで動かない？　動く事例が散見される。何が不足しているのか？
dbus-x11 が必要との記述が散見される。ibus-kkcをyumでインストールした際はdbus-x11は依存関係で一緒にインストールされていた。
以下のブログによると、デスクトップ起動時にdbusが起動されるので、デス... 高橋 徹

高徹 20:33 ソフトウェアエンジニアリング 調査 #101: WSL上のCentOS 7でリモートXで日本語入力をする

CentOS 7では、日本語入力手段はibusが標準である。
WSL上では、ibusが動くとか動かないとか情報が一貫していない。
Ubuntuでは、日本語入力手段にfcitxを使う模様。
古くはuim、scim、scimなどがある。
高橋 徹

高徹 20:27 ソフトウェアエンジニアリング 調査 #101 (進行中): WSL上のCentOS 7でリモートXで日本語入力をする

* 調査目的
WindowsのWSLでCentOS 7を動かし、その上でGUIを持つアプリケーションを実行する。Windows側にXサーバーを入れることで、Windowsデスクトップ上にWSLのCentOS 7で動くアプリケーションの画面が表示する。そのX画面上で日本語を入力する方法を調査する。
但し、GNOMEデスクトップ等の重い機能は使わず、Xウィンドウマネージャも使わないで実現したい。
* 調査結果：
uim-anthyについては、[[CentOS 7... 高橋 徹

2020/02/19

高徹 22:58 ソフトウェアエンジニアリング 調査 #100: Javadocで生成するドキュメントにUML図を埋め込む方法を調査する

UMLGraph というツールがあるらしい。PlantUMLとは別のツールで、テキストで記述した情報からクラス図、シーケンス図を生成できる。Javadocと連携できるらしい。
https://www.spinellis.gr/umlgraph/
EPEL 7リポジトリにumlgraphと、umlgraph-javadocのパッケージがある。CentOS 7で取り込むのが容易かも。 高橋 徹

2020/02/17

高徹 01:04 ソフトウェアエンジニアリング 調査 #100: Javadocで生成するドキュメントにUML図を埋め込む方法を調査する

ソースコードのコメントにPlantUMLの記述をして、javadoc生成時にUML図を生成し生成されたHTMLに貼ることができるツールを探してみた。
docletではなくtagletで実現しているツールを発見
https://github.com/mnlipp/jdrupes-taglets
要試行 高橋 徹

高徹 00:55 ソフトウェアエンジニアリング 調査 #100 (進行中): Javadocで生成するドキュメントにUML図を埋め込む方法を調査する

PlantUMLのサイトに、javadocに埋め込む関連の記述を発見
https://plantuml.com/ja/doclet
UMLDocletを試してみた。
https://github.com/talsma-ict/umldoclet
まずは、JDK 9以降対応のumldoclet-2.0.7.jarをダウンロードし、graphviz 2.38へのPATHを通して実行。 高橋 徹

高徹 00:38 ソフトウェアエンジニアリング 調査 #100 (進行中): Javadocで生成するドキュメントにUML図を埋め込む方法を調査する

調査目的：Javadocで生成するドキュメントに、UML図（シーケンス図、クラス図など）を含めたい
調査結果：
完了条件：入手物、生成手順、サンプルをWikiに記載する。
高橋 徹

2020/02/16

高徹 15:27 ソフトウェアエンジニアリング つれづれ Java編: QAPlug - Checkstyleの調査

QAPlugシリーズの一つ QAPlug - Checkstyleを入れて使い勝手を調査してみた。
* [Analyze]メニュー > [Analyze Code]でチェック実施（手動）
* 「Settings」で[Editor] > [Inspections] で [QAPlug]にチェックを付けるとリアルタイムスキャンが有効になる
解説動画
https://www.youtube.com/watch?v=syAcj-FEaAU
リアルタイムスキャン... 高橋 徹

2020/02/15

高徹 16:00 ソフトウェアエンジニアリング つれづれ Java編: 静的解析ツール Checkstyle

ソースコードを編集中にチェックを実施できるプラグインがあるか調査
* [File]メニュー > [Settings] で「Settings」画面を開き、左側ペインで[Plugins]を選択、真ん中上部の[Type / to see options]に、"checkstyle"と入れると、中側ペインに関係するプラグインがリストされます。プラグインを選択すると右側に説明が表示されます。checkstyleを扱うプラグインは多数リストされていますが、日付が新しく、ダウン... 高橋 徹

2020/02/11

高徹 11:42 ソフトウェアエンジニアリング つれづれ Java編: NetBeans 11.2 設定メモ

h4. プラグインインストール
h5. nb-javacライブラリ・プラグイン
|Java開発にはほぼ必須|
Javaを有効にすると（初回Javaプロジェクト作成時）、NB-Javac Libraryプラグインをインストールするよう要請されます。
インターネットに接続されていない環境では、プラグインポータルからダウンロードしたNBM（NetBeansモジュール）ファイルを手動で運んでインストールします。
http://plugins.netbean... 高橋 徹