Вопросы с тегом «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что указывает на то , должно быть , breakили returnзаявление где - то внутри блока. int offset = 0; …

13 c#  code-quality  readability 

В большинстве языков программирования переменные не имеют идентифицирующих символов, как в PHP. В PHP вы должны префикс переменной с $символом. Пример; var $foo = "something"; echo $foo; Я разрабатываю новый язык сценариев для бизнес-приложений, и у моих целевых пользователей нет опыта программирования. Эти символы облегчают чтение и использование кода? Одна …

13 programming-languages  readability 

Я новичок в Clojure. Я могу понять код, который я пишу, но это становится слишком трудно понять позже. Становится трудно сопоставлять скобки. Какие общие соглашения следует соблюдать в отношении соглашений об именах и отступов в различных ситуациях? Например, я написал пример примера деструктуризации, чтобы понять, но он выглядит совершенно нечитаемым …

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, Barи …

12 c#  .net  readability  enum 

Я стараюсь следовать принципу единой ответственности (SRP), а также опускать повторения кода. Однако часто есть места, где есть повторения кода, которые являются не чем иным, как кодовыми блоками вызовов, которые устойчивы к извлечению их в по крайней мере значащий именованный метод: DoAction1(); DoAction2(); if (value) DoAction3(); DoAction4(); Каков наилучший способ …

11 refactoring  readability  single-responsibility  code-reuse 

Недавно я провел рефакторинг проекта среднего размера в Java, чтобы вернуться и добавить модульные тесты. Когда я понял, что такое издеваться над статуэтками и статикой, мне было больно, я наконец-то «получил» то, что читал о них все это время. (Я один из тех людей, которым нужно учиться на собственном опыте. …

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 

Я работаю над проектом в Delphi, и я создаю установщик для приложения, состоит из трех основных частей. Установка / удаление PostgreSQL myapplication (настройка myapplication создается с использованием nsi) установка / удаление. Создание таблиц в Postgres через скрипт (пакетные файлы). Все работает нормально и гладко, но если что-то не получается, я …

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