He creado una ObjectParser
clase que analiza los datos en objetos fuertemente tipados utilizando IObjectParserDataSource
como fuente de datos (los datos pueden ser un archivo de Excel, un archivo de texto, una matriz, una cadena de consulta, etc.).
Ejemplos de mis implementaciones de IObjectParserDataSource
son:
TextFileObjectParserDataSource
ExcelFileObjectParserDataSource
Estos nombres de clase se sienten realmente largos y complicados para mí.
Podría nombrarlos:
TextFileDataSource
ExcelFileDataSource
Pero esto introduce un nivel de ambigüedad y no se relacionan tan claramente a IObjectParserDataSource
primera vista. Esto se vuelve importante porque la definición de estas fuentes de datos ocurrirá en el código del cliente y deseo minimizar la posible confusión e incertidumbre.
¿Cómo nombrarías estas clases en tal escenario?
c#
.net
naming
coding-standards
Dave New
fuente
fuente
ExcelFileOPDS
,TextFileOPDS
. Ahorra un poco en escribir y espacio en la pantalla, pero es opaco para alguien que no está familiarizado con el código.Respuestas:
Generalmente trato de solucionar este problema pegando todos los objetos similares en un espacio de nombres y simplificando sus nombres (si puedo hacerlo).
Por ejemplo, tendría
O, si la colección de objetos que trabajan con / mantenimiento se
ObjectParser
vuelve lo suficientemente grande, haría un árbol de carpetas o proyecto separado dedicado solo a ObjectParser:Dentro de cualquier archivo dado, las declaraciones de importación y el contexto del código generalmente dejarían bastante claro que
TextFileSource
es laObjectParser
fuente de datos. Si hay varias clases con nombres similares en el mismo fragmento de código, puede consultarTextFileSource
por su nombre completo:Por lo general, ocurre muy raramente y no me importa escribir algunas palabras adicionales.
fuente