yuroyoroのブックマーク - はてなブックマーク

enum basics - しげるメモ
仕事柄、Javaのenumを使うことが多いのですが、あまり世の中のプログラムでenumを全力で使ってるところをあまり見かけません。ということで、自分でもどうなのと思うときがちらほらあるenumの使い方をまとめてみようと思いますが、とりあえず今回は普通の復習用に基本的な機能を。型付の定数が宣言できる enumはもともとCのint形の値に名前をつけただけじゃなくて、型安全な列挙定数が作れるってことでJava5から導入されました。こんな感じ。 public enum Sample { HOGE, FOO, BAR, } で、世の中で見かけるenumは上記くらいのシンプルなのが多いみたいです。クラス本体が宣言できる定数定義のあとに ";" で区切ると、以降をクラスの本体としてメソッドとか定義できます。 public enum Sample { HOGE, FOO, BAR, ; // セ
yuroyoro 2009/01/19
implementsで親インターフェース。

java

programming
リンク
Javadocを書かない - しげるメモ
前回はJavadocを書く - しげるメモというタイトルで話を進めましたが、今回は逆にJavadocを減らすプラクティスについてメモがてら。私は別にJavadocを書くのが好きなわけではなく、単純に書いたほうがめんどくさくないと思うのでそうしてます。ただ、Javadocを書くのもかなりめんどくさいとは自分自身で感じているので、そのめんどくささをできるだけ減らす道を現在も模索中です。やり方としては単純で、次のうちどちらかです。 Javadocをそもそも書かない Javadocに書くことを減らすかなりの部分がEffective Java (Java Series)に紹介されているプラクティスとかぶりますが、ここではあくまで"めんどくさくないJavadoc"という視点でいきます。 Javadocをそもそも書かない If an API is to be usa ble, it must be
yuroyoro 2008/08/01
JDD(Javadoc Driven Development)? 当り前のことだけど、シンプルで分かりやすいクラス名、メソッド名にするとか引数名を意味がわかるもにするとかでだいぶ記述量は減らせると思う。

java

javadoc
リンク
Javadocを書く - しげるメモ
最近は時間を作ってEffective Javaの2版をよんでます。 Effective Java (Java Series) 作者: Joshua Bloch出版社/メーカー: Prentice Hall発売日: 2008/05/08メディア: ペーパーバック購入: 6人クリック: 65回この商品を含むブログ (42件) を見るほとんど1版と同じ内容ですが、"It em 44: Write doc comments for all exposed API elements" を読んでよくまとまってるなと思ったので、触発されてメモがてらに私のやり方を。引用の2段落目は基本的に超約。どこに書くか If an API is to be usa ble, it must be documented. ユーザが利用可能なすべてのAPIにJavadocを書く。これはとりあえず必須だと思います。ち
yuroyoro 2008/07/30
javadocダメ=設計ダメというのは激しく同意。プラクティス→使い方のサンプルコードを書く。TemplateMethodパターンなどではサブクラス化するときの注意点を書く。

javadoc

java
リンク
1