Creidの日記

Java言語コーディング規約より自分向けメモ。

3.1 Java ソースファイル

public なクラスは、そのファイルのいちばん最初に記述しなければならない。

3.1.1 冒頭のコメント

すべてのソースファイルに、下記の内容を冒頭に付け加えるべきである。

/*

* クラス名

*

* バージョン情報

*

* 日付け

*

* 著作権

*/

3.1.3 クラスとインタフェースの宣言

ソースは以下の順番に書かれているべきである。

1.ドキュメンテーション・コメント

ドキュメンテーションコメントとはJava のクラス、インタフェース、コンストラクタ、

メソッド，フィールドについての内容である。

ドキュメンテーション・コメントはすべてコメント区切り文字の

/**...*/ の中に書きクラス、インタフェース、メンバのそれぞれに対して

一つずつ書く。このコメントは、対応する宣言の直前に書くべきである．。

2.クラス、及びインターフェイスの宣言

3.クラス、及びインターフェイスの宣言に関するコメント

4.クラス (static) 変数

public、protected、無し、privateの順に記述する。

5.インスタンス変数

public、protected、無し、privateの順に記述する。

6.コンストラクタ

7.メソッド

ただし、メソッドは機能によってグループ化されるべきである

4 インデント

インデントの単位として、4個分の半角スペースであるべきだ。

そのインデントはタブによって行われても良い。

4.1 1行の長さ

一行は半角80字以内になるようにする。

4.2 行の折り返し

折り返しは以下の条件にそって行われるべきである。

・コンマの後で区切る。

・演算子の前で区切る。

・low-level よりも hi-level において分割する。（何のこっちゃい？）

・2つ目以降のインデントでは、前の行と同じ位置に左端を揃える。

・以上のルールによって分かりにくいコードになったり右の方に偏ってしまう場合には、

4個分の半角スペースではなく8個分の半角スペースを使用する。

眠くなってきたので以下は後日に・・・

さて、私はmsnの方でもblogを書いてる訳だが(注1)

msnのblogではHTML直打ち（注2）でも記事を書ける様になっており

今日の記事を更新している時にふと思ったことがある。

別ページへのリンクを貼る時のtarget指定をblankにし、

新しいウィンドウを開かせるべきか、

それとも指定無しにして、同じウィンドウに開かせるべきかという事である。（注3）

参照リンク

1　http://car.s35.xrea.com/better/target.php

2　http://deztec.jp/design/04/02/000143.html

3　http://www.playnote.net/archives/000187.html

4　http://www.zspc.com/documents/wcag10-tech/

上記の参考リンク1と4を読むとW3C(注4)としては

>>ユーザーエージェント(注5)で新しいウインドウを開かない設定ができるようになるまでは、

>>ユーザーに知らせることなしに新しいウインドウを開いたり

>>現在のウインドウを変更しないようにする。[優先度2]

とし、優先度2とは

>>ウェブコンテンツ制作者は、このチェックポイントを満たすべきです。

>>そうしないと、その文書の情報にアクセスするのが難しい人達が出てきます。

>>このチェックポイントを満たすことは、ウェブ文書にアクセスする上での

>>重要な障害を取り除くことになります。

ただし、上記の話はウェブコンテンツ・アクセシビリティ・ガイドライン1.0 技術書には

>>10. 暫定的な解決策をとる

の欄にあり、あくまで暫定的なものの様だ。

そして、参考リンク1の

>>環境による物もありますし、

や

>>新たなウィンドウが開くたびに「戻れなくなった!!」と驚く人もいます。

後者はこれらはリテラシーの不足によるものであると思われ

”慣れ”より一応の解決は可能だと考えられます。

前者に関して言えば、まず参考リンク1にあったブラウザの違いやマシンのリソース

の余裕の有無にもよる所はあると思います。

つまり、参考リンク1にあるように

製作者側として

・JavaScriptの使用により閲覧者に選択権を用意する

　　これは全てのHP製作者が実現できる訳ではないのが問題

・別ウィンドウに開くリンクと同じウィンドウに開くリンクを二つ用意する

　　最も単純かつ閲覧者にも分かりやすい

・css3(Cascading Style Sheets level 3)を待つ(注6)

　　あまり開発が進んでるとは言えない状況の様子。アテにはできない

もしくは、

全ての製作者は全てのリンクは同じウィンドウに開く様にしておき

閲覧者が「ただクリックするだけ」や「右クリック→新しいウィンドウで開く」

もしくは「shiftキーを押しながらクリック」といった選択肢があることを

強く広める

という方法もアリだと私は思う。

だが、最も現実的なのは

>別ウィンドウに開くリンクと同じウィンドウに開くリンクを二つ用意する

ではなかろうか。

製作者側としても(絶対的に見て)殆ど手間は掛からず

閲覧者側としても分かりやすいのでは無かろうか。

私としてもこれらの事に留意しながら次から（これ大事）

日記を書いていきたいと思う。

注1：痛いネタはmsn、くだらないネタはココと分けてるつもり。

食い逃げの件はキニスルナ

注2：直打ち・・・俺用語。HPビルダー等を使わず、テキストエディタ等でコーディングする事

こっちの方がカッコいい！(気がするだけ)　だが、面倒なのであんまりやらない

注3：どっちでも良いというのは無し。そう思った人は

”あまり”技術者向きでは無いかも

注4：参考リンク

注5：参考リンク

注6：参考リンク

食い逃げしますた！

・・・ラーメン屋にてお金払うの忘れて、普通に店を出ていきました。

後で店主が追っかけてきやがったのでその場でお金を払いました　とさ。

ホントに天然でお金払うの忘れてたよ・・・お店の人ごめんなさい

つ　http://s03.2log.net/home/programmer/archives/blog38.html

以下内容を断片的にまとめ。

・軍曹殿の部隊は最高司令部から3階層下の部隊であるという事。

・仕様について何も知らされず現地入り

・前任者は鬱で戦線離脱

・引継ぎ無し

・ドキュメントすら無し

・勤務時間中にドキュメントは作ってはならない

・隣のチームとの仕様書のverが違う

・チーム毎に主張する「仕様」が違う、それを調整する部門も機能せず

・知らないウチに仕様書のverが5つも上がっていた

・上位会社への質問の回答は2週間たって1/20の割合でしか帰ってこない

・10万行のスパゲッティコード

・変数名がval0, val1, val2

・関数名がfunc001, func002

・バグ報告書の厚さは3cm

・指示の内容が1日5回変わる

・新兵が2人脱走、もちろん代わりは来ない

・乱闘騒ぎ

・残業代が（ry

・業務上の連絡手段は口頭と紙切れ

・開発環境はWin98 PenPro200M HDDは4GB メモリは32M

・が、しかしMS-Office2000がフルにインストールされている

・設備の予算申請手続きに半年以上かかる

---

・次に出張旅費の清算に戻った時には、ガラクタ置き場にされていた俺の机の

引き出しに何やら包み物があった。

「？」

俺は警戒しながら封を開けてみた。

中にはワイヤレス光学マウスが1個入っていた。

手紙もあった。

「軍曹殿。この度は戦線離脱の非礼を申し訳ありませんでした。

　自分にはあの地獄は耐えられませんでした。ただ、軍曹殿には

　本当にお世話になりました。いつも僕たちを人間扱いしてくれたのは

　軍曹殿だけでした。

　これはほんの気持ちです。軍曹殿は現場でいつも朝一番にマウスの動きが

　渋いって愚痴をこぼしていたので」

2等兵の1人は、夏の寸志の全額を使って俺にマウスをプレゼントしてくれた。

俺はガラクタ置き場の机の前で、暫くフリーズしていた。

・Roads To Node→http://www5e.biglobe.ne.jp/~aji/

3 Minutes Networkingというコンテンツがあり、とても分かりやすく書いてあるのでお勧め。

CCNA受験者向けの内容。

ちなみに30 Minutes Networkingというコンテンツもあり

こちらはCCNP受験者向けの内容となっている。（実際はCCNAの内容もちらほら？）

---

・NHKにようこそ！（滝本竜彦）

少年エースで連載されてる漫画の原作である。先日、文庫版がでていたので購入

これを始めて読んだのは学校の友人に本を貸して貰ったので

高校の授業中に読んだのがきっかけ。内容はそう多くないので私は2h程で読みきった。

（以下引用）

俺はまさしく、現在日本で大ブレイク中の「ひきこもり」なのである。

しかも、かなりのベテランひきこもりだ。

外出は週に一度。コンビニに食料とタバコを買い出しに行くその時だけ。

友人の数は、ゼロ。睡眠は一日十六時間。

ひきこもり継続時間は、今年で早くも四年。

実績は、大学中退。

という熱い男が逝きかけの電波娘と繰り広げる素晴らしいストーリー

その内容と言うと

・ドラッグでトリップトリップ

・一週間ひきこもって30GのHDDをエロ画像（ロリ系only）で一杯にする

・幼女の盗撮

・同人エロゲ製作

・怪しげな宗教のミサ（？）に変装して参加

・意図的に崖からダイブ

・・・という内容である。

ヲタクを自称する貴方、一読の価値ありです。

小説読むなんてメンドクセ　って猛者は漫画版購入を推奨する。

ただし、半ばエロマンガなので電車内では読むなよ（俺は読んだが