«readability» 태그된 질문

다음 메소드를 포함하는 인터페이스를 가정하십시오. Car find(long id); List<Car> find(String model); 이렇게 이름을 바꾸는 것이 더 낫습니까? Car findById(long id); List findByModel(String model); 실제로,이 API를 사용하는 개발자는 초기 find()메소드의 가능한 인수를 알기 위해 인터페이스를 볼 필요가 없습니다 . 그래서 내 질문은 더 일반적입니다 : 가독성을 줄이기 때문에 코드에 과부하 된 …

14 design  naming  readability  method-overloading 

최근에 특정 프로젝트의 특정 클래스에 대해 체인 방법을 구현하여 코드의 가독성을 향상시킬 수 있다고 제안했습니다. 나는 "편의를 위해서가 아니라 의미론을 위해 유창한 인터페이스를 구현해야한다"라는 대답을 얻었고 제 제안은 거절되었습니다. 나는 유창한 인터페이스를 제안하는 것이 아니라 가독성과 코딩 편의성을 향상시키기 위해 메서드 체인 자체 ( 서로 혼란 스러울 수 있음) 에 …

14 architecture  coding-standards  readability  method-chaining 

가치 검증을 다루는 많은 클래스가 있습니다. 예를 들어, RangeValidator클래스는 값이 지정된 범위 내에 있는지 확인합니다. 모든 유효성 검사기 클래스에는 값 is_valid(value)을 반환 True하거나 False값에 따라 달라지며 ensure_valid(value)지정된 값을 확인하고 값이 유효한 경우 아무 것도 수행하지 않거나 값이 미리 정의 된 규칙과 일치하지 않으면 특정 예외가 발생합니다. 현재이 방법과 관련된 두 …

13 unit-testing  exceptions  readability 

읽을 항목 수를 알 수없는 판독기를 반복해야하는 경우 끝까지 닿을 때까지 계속 읽으십시오. 이것은 종종 끝없는 루프가 필요한 곳입니다. 블록 안에 어딘가에 또는 문 true이 있어야 함을 나타내는 항상 있습니다 .breakreturn int offset = 0; while(true) { Record r = Read(offset); if(r == null) { break; } // do work …

13 c#  code-quality  readability 

대부분의 프로그래밍 언어에서 변수에는 PHP에서와 같이 식별 문자가 없습니다. PHP에서는 $문자 앞에 변수를 접두어로 붙여야합니다 . 예; var $foo = "something"; echo $foo; 비즈니스 응용 프로그램을위한 새로운 스크립팅 언어를 개발 중이며 대상 사용자에게 프로그래밍 배경이 없습니다. 이 문자들은 코드를 읽고 사용하기 쉽게합니까? PHP가 사용하는 한 가지 이유는 $그것이 없으면 PHP가 …

13 programming-languages  readability 

Clojure를 처음 사용합니다. 작성한 코드를 이해할 수 있지만 나중에 이해하기가 너무 어려워집니다. 괄호를 일치시키기가 어렵습니다. 다양한 상황에서 명명 규칙 및 들여 쓰기와 관련하여 따라야 할 일반적인 규칙은 무엇입니까? 예를 들어 이해하기 위해 샘플 구조 해제 예제를 작성했지만 두 번째로 완전히 읽을 수없는 것처럼 보입니다. (defn f [{x :x y :y …

13 readability  clojure 

나는 꽤 긴 속성 이름을 가진 if 문을 작성하고 있었고이 문제를 겪었습니다. 다음과 같은 if 문이 있다고 가정 해 봅시다. if(_someViewModelNameThatIsLong.AnotherPropertyINeedToCheck == someValue && !_someViewModelNameThatIsLong.ThisIsABooleanPropertyThatIsImportant) { //Do something } 두 번째 속성은 부울 유형이며 다음과 같은 전략을 갖는 것은 의미가 없습니다. if(boleanValue == true) (가) 넣어 그 부정을 강조하기 위해 …

13 readability 

폐쇄되었습니다 . 이 질문은 더 집중되어야 합니다. 현재 답변을받지 않습니다. 이 질문을 개선하고 싶습니까? 이 게시물 을 편집 하여 한 가지 문제에만 집중할 수 있도록 질문을 업데이트하십시오 . 휴일 2 년 전 . 나는 기능적인 언어를 배우기 전에 기억하기 때문에 이것에 대해 궁금합니다. 모두 끔찍하고 끔찍하게 읽을 수 없다고 생각했습니다. …

13 object-oriented  functional-programming  readability 

내 이해는 [Flag]열거 형은 일반적으로 개별 값이 상호 배타적이지 않은 결합 될 수있는 것들에 사용된다는 것입니다 . 예를 들면 다음과 같습니다. [Flags] public enum SomeAttributes { Foo = 1 << 0, Bar = 1 << 1, Baz = 1 << 2, } 어디에서 어떤 SomeAttributes값의 조합이 될 수 있습니다 Foo, …

12 c#  .net  readability  enum 

SRP (Single Responsibility Principle)를 따르고 코드 반복을 생략하려고합니다. 그러나 종종 코드 반복이 적어도 의미있는 명명 된 메소드로 추출하기 어려운 호출 코드 블록에 불과한 곳이 종종 있습니다. DoAction1(); DoAction2(); if (value) DoAction3(); DoAction4(); 그러한 코드를 메소드로 추출하는 가장 좋은 방법은 무엇이며 어떻게 이름을 지정합니까?

11 refactoring  readability  single-responsibility  code-reuse 

최근 Java로 돌아가서 단위 테스트를 추가하기 위해 중간 크기의 프로젝트를 리팩토링했습니다. 싱글 톤과 스태틱을 조롱하는 것이 얼마나 고통 스러운지 깨달았을 때, 나는이 시간 동안 내가 읽은 것을 마침내 "얻었다". (나는 경험을 통해 배워야 할 사람들 중 하나입니다. 아.) 이제 Spring을 사용하여 객체를 만들고 주변을 연결하고 있으므로 static키워드를 왼쪽과 오른쪽으로 제거 …

11 coding-standards  readability  coding-style  static-methods 

어느 것이 유지 보수가 용이 한 것으로 간주됩니까? if (a == b) c = true; else c = false; 또는 c = (a == b); Code Complete를 살펴 보았지만 답변을 찾을 수 없습니다. 나는 첫 번째가 더 읽기 쉽다고 생각합니다 (문자 그대로 큰 소리로 읽을 수 있음). 두 번째 것은 …

11 .net  code-quality  readability  maintainability  clean-code 

델파이 에서 프로젝트를 진행 중이며 응용 프로그램 설치 프로그램을 작성 중입니다. 세 가지 주요 부분이 있습니다. PostgreSQL 설치 / 제거 myapplication ( myapplication 설정은 nsi를 사용하여 작성 됨) 설치 / 제거 스크립트 (배치 파일)를 통해 Postgres에 테이블 생성 모든 일이 잘 실행하고 원활하게,하지만 뭔가가 실패 할 경우 I, 프로세스의 모든 …

11 code-quality  readability  logging 

나는이 질문이 즉시 주관적으로 표시 될 것이라고 생각하지만, 어느 것이 더 낫다고 생각합니까? double volume(double pressure, double n_moles, double temperature) { return n_moles * BOLTZMANN_CONSTANT * temperature / pressure; } 또는 double volume(double P, double n, double T) { return n*R*T/P; } 다시 말해, 일부 방정식을 구현하는 함수가 해당 방정식의 …

11 math  coding-style  readability 

다음 중 유지 관리가 더 좋은 것은 무엇입니까? if (byteArrayVariable != null) if (byteArrayVariable .Length != 0) //Do something with byteArrayVariable 또는 if ((byteArrayVariable != null) && (byteArrayVariable.Length != 0)) //Do something with byteArrayVariable 나는 두 번째를 읽고 쓰는 것을 선호하지만, 코드로 읽는 것은 그와 같은 일을하는 것이 유지 관리에 …

11 programming-practices  coding-standards  maintenance  readability