2012-01-20 5 views
1

엔티티 컬렉션의 이름 지정 규칙에 대한 의견을 듣고 싶습니다. 특히 나는 RESTful URI 구조를 설계하고있다.명명 규칙 - 컬렉션을위한 복수형

예 : 예 : Account, 나는 그러한 엔티티 Accounts의 콜렉션을 호출 할 것이다. 마찬가지로 : 고객 및 고객, 주문 및 주문. 일반적으로 엔티티 이름의 끝에 's'를 추가합니다. 이는 명명 규칙에 적합한 일관된 패턴입니다.

하지만 복수 단어가 단순히 끝에 's'태그가없는 경우 어떻게해야합니까? 예 : 마우스와 마우스, 사람과 사람 또는 물고기와 물고기 (복수형과 단수가 동일)?

간단한 패턴으로 붙이면서 영어 언어 규칙과 관련없는 's'에 태그를 달거나 적절한 복수형 형태로 단어를 표시해야합니까?

나는 내 컬렉션 이름을 유혹 받았다. PersonCollection 또는 FishCollection하지만 일관성있는 동안 그것은 못생긴 것이고 내가 가능한 간결하게하려는 URI에 입력하고 싶은 일이 아닙니다.

답변

2

영어로 붙이세요! 영어를 잘 이해하고있는 누군가가 앉아서 함께 작업 할 수있게되면 코드 또는 인터페이스 사용이 훨씬 읽기 쉽고 유지 보수가 쉽고 직관적입니다. 클래스 이름, 필드 이름, URI 부분 등의 오타가 포함 된 코드 나 인터페이스를 유지하는 것은 매우 실망 스러울 수 있습니다. 따라서 "마우스"의 복수형으로 "마우스"를 사용하지 않습니다.

약자도 중요 할 수 있습니다. 알려진 약어라면 자유롭게 사용하십시오. 그러나 첫 번째 문자가 대문자, 나머지 소문자 또는 모두 대문자 인 것처럼 이름을 짓는 엄격한 규칙을 유지하십시오. 혼합하지 않도록하십시오.

변수 또는 필드의 유형을 추가하는 것은 접두사와 같습니다. 문제의 프로그래밍 언어에 따라 일반적인 가이드 라인 (예 : Java에서는 "Collection"파트를 제거합니다. URI에 관한 한, 나는 그것을 사용하지 않을 것이다. 가독성은 향상되지 않습니다.