タグ

ブックマーク / megascus.hatenablog.com (2)

  • 日本語でのJavaDocの書き方 - 水まんじゅう2

    JavaDocを何で書くの?とか、書き方とかをまとめたページはたくさんありますが、日語特有の情報が抜け落ちていたり、英語でのJavaDocの書き方を説明するものばかりなので、日語特有の情報をいくつか書きたいと思います。 なお、JDK 8u144あたりでの挙動です。将来では変わるかもしれません。 JavaDocの書き方の一般的なものを知りたい場合は公式のマニュアルを見るのが一番良いと思います。 https://docs.oracle.com/javase/jp/8/docs/technotes/tools/windows/javadoc.html サマリー文の後は2つ改行を入れましょう。 /** * 一行目はサマリー文としてその処理(クラス、メソッド等)の概要として扱われます。 * * <p>英語では行末に「.」(ピリオド)が入り、JavaDocではピリオドまでを1行目のサマリーとして扱

    日本語でのJavaDocの書き方 - 水まんじゅう2
  • パーフェクトJava EEを読み始めた(パラ見した感想) - 水まんじゅう2

    ポケモンに飽きてきたので さて、こそこそっとパーフェクトJava EEを読み始めてみました。 とはいってもまだ1章のみ。 以前からパーフェクトJava EEが発売されるという話は聞いていて、JPAの章についてはレビューにも参加しているので、 JPAの章については安心してみてください的な感じはあります。*1 そのうち全部読むのですが、1章と全体をパラ見した感想としては、 こののターゲットはこうですと記載されているものと、実際に読める人間には随分と隔たりがありそうだなぁという印象でした。 JSPどこいった このではJSPについての説明はありません。ただ、JSPを使った説明はたくさんあります。 そのため、JSPを理解していることが前提となっており、少なくとも、これからJava EEを始めたい人が読むべきではないのではないかなぁと思いました。 そういえば、パーフェクトJavaのおまけにJav

    パーフェクトJava EEを読み始めた(パラ見した感想) - 水まんじゅう2
    heignamerican
    heignamerican 2016/08/12
    oh... 購入迷ってたけど辛そうな感じだ。
  • 1