2012-01-20 26 views
1

エンティティコレクションの命名規則に関する意見を聞きたいと思います。特に、私はRESTfulなURI構造を設計しています。命名規則 - コレクションの複数形

エンティティがある場合、アカウント、私はそのようなエンティティのアカウントのコレクションを呼び出します。同様に、顧客および顧客、注文および注文。一般にエンティティ名の末尾に 's'を追加します。これは命名規則に適した一貫したパターンです。

しかし、複数の単語が単純に末尾にタグが付けられていない場合はどうすればよいですか?マウスとマウス、人と人、あるいは魚と魚(複数形と単数形は同じです)?

英語の慣習に関係なく、単純なパターンをつけて、タグを付けるだけでよいですか、適切な複数形の単語を使用してください。

私のコレクションに名前をつけるように誘惑されました。 PersonCollectionやFishCollectionは一貫していますが、醜いのですが、可能な限り簡潔にしたいURIに入力したいものではありません。

答えて

2

英語のスティック!これは、英語の理解が深い人が座って作業することができるようになると、コードやインタフェースの使用をより読みやすく、保守しやすく直感的にします。クラス名、フィールド名、URI部分、またはその他の問題に誤植が含まれているコードやインタフェースを維持することは、あなたが言及したように間違った複数形を使用するのと同じように、非常にイライラすることがあります。したがって、私は決して "マウス"の複数形として "マウス"を使用しません。

略語も問題である可能性があります。既知の略語の場合は、自由に使用してください。ただし、最初の文字は大文字、小文字の後ろは小文字、大文字はすべて大文字にしてください。それらを混ぜないようにしてください。

変数またはフィールドのタイプを追加することは、変数の接頭辞に似ています。問題のプログラミング言語によっては、一般的なガイドライン(例: Javaでは "Collection" -partを削除します。 URIに関する限り、私はそれを使用しません。読みやすさは向上しません。