Я создал ObjectParser
класс, который анализирует данные в строго типизированные объекты, используя в IObjectParserDataSource
качестве источника данных (данные могут быть файлом Excel, текстовым файлом, массивом, строкой запроса и т. Д.).
Примеры моих реализаций IObjectParserDataSource
:
TextFileObjectParserDataSource
ExcelFileObjectParserDataSource
Эти названия классов кажутся мне действительно длинными и запутанными.
Я мог бы назвать их:
TextFileDataSource
ExcelFileDataSource
Но это вносит определенный уровень двусмысленности, и они не стали так явно связаны с IObjectParserDataSource
первого взгляда. Это становится важным, потому что определение этих источников данных будет происходить в клиентском коде, и я хочу минимизировать потенциальную путаницу и неопределенность.
Как бы вы назвали эти классы в таком сценарии?
c#
.net
naming
coding-standards
Дэйв Нью
источник
источник
ExcelFileOPDS
,TextFileOPDS
. Это немного экономит время при наборе текста и на экране, но непрозрачно для тех, кто не знаком с кодом.Ответы:
Обычно я пытаюсь обойти эту проблему, помещая все похожие объекты в одно пространство имен и упрощая их имена (если я могу это сделать).
Например, будет иметь
Или, если коллекция объектов, работающих с / servicing,
ObjectParser
станет достаточно большой, я бы создал отдельное дерево папок или проект, предназначенный только для ObjectParser:Внутри любого файла операторы импорта и контекст кода обычно ясно дают понять, что
TextFileSource
этоObjectParser
источник данных. Если в одном и том же фрагменте кода есть несколько классов с одинаковыми именами, вы можете ссылаться наTextFileSource
их полное имя:Обычно это происходит очень редко, и я не против набрать лишние слова.
источник