Вопросы с тегом «naming»

27
Считается ли плохой практикой включать номер ошибки в имя метода для временного решения проблемы?

Мой коллега, который является старшим, блокирует меня при проверке кода, потому что он хочет, чтобы я назвал метод PerformSqlClient216147Workaround, потому что это обходной путь для некоторого дефекта ###. Теперь, мое предложение имени метода является чем-то вроде PerformRightExpressionCast,...

26
Почему это называется «хэш-таблица» или «хэш-функция»? Хэш не имеет никакого смысла для меня здесь [закрыто]

Закрыто . Этот вопрос основан на мнении . В настоящее время не принимает ответы. Хотите улучшить этот вопрос? Обновите вопрос, чтобы ответить на него фактами и цитатами, отредактировав этот пост . Закрыто 5 месяцев назад . Сейчас около 4 лет разработки, которую я использую, слышу, говорю и...

26
Пространство имен C # и соглашение об именах классов для библиотек

Я создаю библиотеки с различными небольшими служебными функциями в C # и пытаюсь принять решение относительно именования пространств и классов. Моя текущая организация выглядит так: Company Company.TextUtils public class TextUtils {...} Company.MathsUtils public class MathsUtils {...} public class...

25
Содержательные и краткие рекомендации по присвоению имен

Недавно я начал выпускать проект с открытым исходным кодом, хотя я был единственным пользователем библиотеки, который не заботился об именах, но знаю, что хочу назначить умные имена для каждого метода, чтобы его было легче выучить, но мне также нужно использовать краткие имена, чтобы их было легко...

25
Как вы называете ваши личные переменные в C #? [закрыто]

В настоящее время этот вопрос не очень подходит для нашего формата вопросов и ответов. Мы ожидаем, что ответы будут подтверждены фактами, ссылками или опытом, но этот вопрос, скорее всего, вызовет дебаты, споры, опрос или расширенное обсуждение. Если вы считаете, что этот вопрос можно улучшить и,...

25
Что делать, если я ненавижу заголовочные файлы C ++?

Меня всегда смущали заголовочные файлы. Они такие странные: вы включаете файл .h, который не включает .cpp, но .cpp тоже как-то компилируется. Недавно я присоединился к командному проекту, и, конечно, используются как .h, так и .cpp. Я понимаю, что это очень важно, но я не могу жить с копированием...

25
Является ли плохой практикой называть свойство / элемент таким же, как объявленный тип в C #?

Например, такой класс: class Dog { } //never mind that there's nothing in it... а затем свойство как: Dog Dog { get; set; } Мне сказали, что если я не могу придумать более оригинальное название для этого, то я должен использовать: Dog DogObject { get; set; } Любые мысли о том, как назвать их...

23
Является ли система венгерской нотации полезной практикой? [закрыто]

Трудно сказать, что здесь спрашивают. Этот вопрос является двусмысленным, расплывчатым, неполным, чрезмерно широким или риторическим, и на него нельзя дать разумный ответ в его нынешней форме. Чтобы получить разъяснения по этому вопросу, чтобы его можно было снова открыть, посетите справочный...

23
Называя метод «делай X, если нужно»

Какой хороший способ назвать метод, который проверяет, нужно ли делать X, и делает ли он это в случае необходимости? Например, как назвать метод, который обновляет список пользователей, если в систему вошли новые пользователи? UpdateListIfNeededкажется слишком длинным, в то время как просто...

23
Есть ли хорошие методы или тесты для именования типов?

Неловкий, открытый вопрос, но я всегда сталкиваюсь с этой проблемой: Программное обеспечение, которое легко поддерживать и работать, хорошо спроектировано. Попытка сделать дизайн интуитивно понятным означает присвоение имен вашим компонентам таким образом, чтобы следующий разработчик мог определить...

23
Соглашение об именах: конечные поля (не статические)

Сегодня у меня была дискуссия с коллегой по поводу именования finalполей в классах Java. В его мнениях finalполя также должны учитываться как константы, так как их значения не изменятся после создания экземпляра. Это приведет к следующему соглашению об именах для finalполей: public class Foo {...

22
Каковы преимущества префикса имен параметров функции с p *?

Я часто вижу проекты (в Java-проектах и ​​командах, использующих Eclipse), с которыми префиксные параметры функции p. Например public void filter (Result pResult) ... Лично я не вижу в этом никакой пользы, но хотел бы знать, в чем причина. Лучшее объяснение, которое я слышал, состоит в том, что оно...

21
Соглашения об именах для классов Java, которые имеют статический метод main?

После прочтения ответа комара на Почему статический основной метод в Java и C #, а не конструктор? Я полагаю, что его ответ означает, что цель Java-класса со статическим основным методом заключается в define a program entry pointтом, что он не предназначен для самой программы. Возможно, есть лучший...

21
Почему XML не называется EML?

Из Википедии Расширяемый язык разметки (XML) представляет собой набор правил для кодирования документов в машиночитаемой форме. Он определен в Спецификации XML 1.0 [4], разработанной W3C, и нескольких других связанных спецификациях, которые все являются открытыми стандартами. [5] Каковы...

21
Разница между обработчиком, менеджером и контроллером

Есть ли разница между именованием класса «Обработчик», «Менеджер» или «Контроллер»? IE: PurchaseManager, PurchaseHandler, PurchaseController. Достаточно ли одного и того же значения, или между ними есть четкая разница? Если нет никакого независимого от языка ответа, рассмотрите Java как...

21
Как верблюжьим случаем, когда в последовательных словах есть цифры?

Этот вопрос был перенесен из переполнения стека, потому что на него можно ответить в Software Engineering Stack Exchange. Мигрировал 7 лет назад . Просто интересно, есть ли у кого-нибудь хорошее соглашение, чтобы следовать в этом угловом случае. Я действительно использую Java, но подумал, что у...

20
Какова идея именования классов с суффиксом «Info», например: «SomeClass» и «SomeClassInfo»?

Я работаю в проекте, который имеет дело с физическими устройствами, и меня смутило, как правильно назвать некоторые классы в этом проекте. Учитывая фактические устройства (датчики и приемники) - это одно, а их представление в программном обеспечении - другое, я думаю о присвоении имен некоторым...

20
Следует ли изменить внутреннее наименование (классы, методы, таблицы базы данных и т. Д.) Сущностей при изменении наименования маркетинга и пользовательского интерфейса?

У нас был долгоживущий продукт уже около 8 лет. Со временем названия понятий и сущностей меняются. Должны ли мы провести работу по переименованию всех таблиц кода, а также таблиц и столбцов базы данных в соответствии с этими новыми именами? Было ли проведено исследование по этому вопросу или...

20
Нужно ли всегда знать, что делает API, просто взглянув на код?

Недавно я занимался разработкой своего собственного API, и с таким большим интересом к разработке API меня очень интересовало, как я могу улучшить свой дизайн API. Один аспект, который возник несколько раз: (не пользователями моего API, а в моем наблюдении за обсуждением этой темы): нужно просто...

20
Почему библиотека C использует макросы и функции с одинаковыми именами?

Я читаю «Стандартную библиотеку С» П. Дж. Плаугера, которая действительно интересна. Книга объясняет не только как использовать библиотеку, но и как она реализована. Я закончил чтение ctype.hраздела и в шапке функции объявлены как макросы и функции. Например int isdigit(int); но и #define...