Javaで「良いスタイル」を作る理由は何ですか？[閉まっている]

私はStackoverflowでこの質問をしましたが、それがブーイングする前に、PéterTörökから投稿するのにこれがより良い場所であるかもしれないという有益な提案を受けました。

数年前からJavaでプログラミングしています。私は、「良いスタイル」を構成する要素に基づいて、同僚と設計上の決定についてよく話し合いました。実際、何かが「良いスタイル」であるかどうかに基づいてデザインを検討するStackOverflowの質問/回答がいくつかあります。

しかし、「良いスタイル」を作るものは何ですか？多くのことと同様に、私はそれを見るとそれを知っています...しかし、このデザインは正しくないと感じているという私の良心よりも良い考えを知りたかったのです。

適切に設計された優れたコードを作成するために、あなたは何を考えていますか？

（これはやや主観的なものであることを認めます。「良いスタイル」とは、目前のタスクに依存するためです）。（また、「4ではなく2スペースのインデントを使用する」など、チームスタイルには興味がないことも付け加えておきます。Javaコードの規則には興味がありません。）

編集：これまでのすべての良い答え/コメントをありがとう。私は特に、プログラマーの良心（そして場合によってはお腹も）のレンチを成し遂げることを成文化するのに役立つ答えを求めていますか？

いくつかの簡単なポイント：

• 意図を明らかにする名前
• 非有益なコメントはありません
• 一度にすべてを頭に収めることができないほど複雑な方法はありません
• 単一責任オブジェクト
• コードの規則に従ってください（あなたはそれを気にしなかったと言いましたが、それは非常に重要です）

ライアンのリストに追加：

• SOLIDの原則に従う
• コードに周期的な複雑さがあまりないことを確認してください
• テスト駆動 Javaは常に良いことです
• あなたがxFactoryFactoryクラスを持っているなら、あなたはそれを間違っています:-)
• Javaエコシステムのオープンソースライブラリを考えると、車輪の再発明は悪いスタイルです
• 日付と時刻にJoda時間を使用する

私はそこで止まります。

他の人の答えには感謝しながら、良いコードを書こうとするときに私が考えるいくつかのことを共有するのは公平だと思いました。

• このクラス/メソッド/変数について何を知る必要がありますか？つまり、この知識はどこにあるのでしょうか。

• このコードはアプリケーションのメモリ/パフォーマンスにどのように影響しますか？（私は「時期尚早な最適化がすべての悪の根源である」ことを認めます。そのため、最適化に多くの時間を費やすことを提案するのではなく、最初に私のコードを書くときの意識です。）

• （コードとコード構造から）これが何をするかは明らかですか？（私は格言に従うようにしています：「人々が理解できないように努力し、人々が誤解できないように努力しなさい」。）

適切なJavaプログラミングの優れた例については、StringおよびArrayListクラスをお読みください。しかし、それらは非常に簡潔で、ほぼCスタイルであり、最小のJavaドキュメントを含む保守可能なコードには必ずしも最適ではありません。私の店での一般的な習慣はコメントではないので、詳細なcamelCase変数名を使用し、改行を過度に使用して、ある行を別の行と区切ることにより、コードでコメントしようとしています。タブを使用して変数とその値を分離することについては、まだ議論しています。タブは読みやすさ、IMOを向上させることができますが、最小限に抑えられた場合に限り、非常に主観的です。それは本当に聴衆の問題だと思います。ここで最良の答えはありません。