Questions tagged «naming»

此问题是从Stack Overflow 迁移而来的，因为可以在Software Engineering Stack Exchange上回答。 迁移 8年前。 我们拥有长寿的产品已有8年之久。随着时间的流逝，概念和实体的名称会发生​​变化。我们是否应该进行工作以重命名所有代码库，数据库表和列以匹配这些新名称？ 是否已对此研究或一些最佳实践进行了研究？ 谢谢

20 naming  modeling  marketing 

已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗？更新问题，以便通过编辑此帖子以事实和引用的形式回答。 3年前关闭。 在命名软件产品（应用程序或库）时，您要做什么？ 选择一个其他软件尚未使用的名称似乎是不可能的，无论是某人的小型业余项目还是出售它的公司。我们都知道Phoenix成为Firebird成为Firefox，因为它与其他软件产品名称发生冲突。 名称必须有多独特？Phoenix是计算机BIOS的名称-与Web浏览器几乎没有，不是吗？作为反例，很高兴地将操作系统Fedora和存储库软件Fedora并存。另一个反例是Java框架midori和Web浏览器midori。 您将采取什么步骤来确保他人不使用您的应用程序或库的名称，以及在查找具有相同名称的其他内容时，从产品类型的角度来看，您会走多远？

20 open-source  naming  marketing 

已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗？更新问题，以便通过编辑此帖子以事实和引用的形式回答。 5年前关闭。 假设我有一个名为的抽象类Task。 是否有标准或约定建议我AbstractTask改用它命名？

20 java  naming  coding-standards 

在异常类上指定Exception的后缀感觉对我来说像是代码的味道（冗余信息-名称的其余部分表示错误状态，并且它继承自Exception）。但是，似乎每个人都这样做，这似乎是一种好习惯。 我想了解为什么这是个好习惯。 我已经阅读并阅读了以下问题：为什么异常通常在类名中带有后缀异常 问题是针对PHP，而响应可能对Java有效。还有其他论点吗？或者真的和区分它们一样简单吗？ 如果我们从上一个问题中选取示例，那么java中是否确实存在名称FileNoFound并非例外的类？如果可能的话，是否应该加上后缀Exception？ 纵观eclipse的快速层次结构Exception，可以肯定的是，它们中的绝大多数确实有例外后缀，但也有一些例外。javassist是一个库的示例，该库似乎有一些没有后缀的异常-例如BadByteCode，BadHttpRequest等。 BouncyCastle 是另一个lib，但有例外 CompileError 我在Google上搜索的信息也很少。

19 java  naming  exceptions 

已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗？更新问题，以便通过编辑此帖子以事实和引用的形式回答。 4年前关闭。 我想用Java发布一个小的开源库。我想知道应该选择哪个软件包名称？我不是公司，我没有一个可根据命名约定命名软件包的基础的域。我还是想以某种方式遵循命名约定，以防止意外冲突并使事情保持标准。

19 java  naming  coding-standards  packages 

在引用用户资料时，应使用My或Your，例如： 我的购物车 我的帐号| 我的收藏 要么 您的购物车 您的帐号| 您的心愿单 我发现这篇文章主张您使用。它说flikr这样做。它还说MySpace和MyYahoo是错误的。 我今天还注意到，亚马逊使用术语Your。但是，我听说他们是测试变体并找到最佳变体的大师，因此您在他们的站点上看到的可能是最佳变体，或者仅仅是他们当前正在测试的东西。 我个人喜欢我看起来更好的方式，但这仅是我的意见。 你怎么看？什么会对客户产生更好的影响？真的重要吗？

19 naming  usability  wording 

就像一个稻草人考虑的那样，java.util它是各种课程的垃圾场，在大多数情况下，除了让他们在那里的人懒惰或没有动力为他们的课程提出一个语义上更正确的软件包名称外，大多数情况下没有其他共同点。 作为一个示例，使用该类UUID在该语义上正确的包名称是什么？ 我正在努力实现自己的UUID类，以使其更加轻巧。我不想使用me.myproject.util.UUID我的包裹名称。 我考虑过，me.myproject.rfc4122.UUID但这并不意味着使用的语义UUID。 我也考虑过，me.myproject.uuid.UUID但我不喜欢重言式，尽管在Python中将同名的类放入模块中是一种流行的方法，而packagesJava在语义上并不等同modules于Python。 我也考虑me.myproject.UUID但拒绝了它，因为我不想用不相关的内容污染名称空间的那一部分。这只是使问题更上一层楼。 我也考虑过，me.myproject.lib.UUID但这并没有更多的语义含义.util，只是重命名了问题。 semantics：与意义有关的语言学和逻辑学分支。

18 naming  packages  namespace 

为两个通用目的相同的名称完全不同的文件将它们分成不同的目录，这是一种不好的做法吗？ <script src="client_scripts/app/player_stats/generator.js"></script> <script src="client_scripts/app/coach_settings/generator.js"></script> 我想使文件名简短，并且两个文件具有相同的通用目的，但不完全相同。我不确定在专业编程环境中这是否会被视为不良做法。我想知道在这种情况下的最佳做法。 或者，以牺牲名称的简短长度为代价，我可以使用： <script src="client_scripts/app/player_stats/player_stats_generator.js"></script> <script src="client_scripts/app/coach_settings/coach_settings_generator.js"></script>

18 naming  file-structure 

我很早以前问过这个问题：如何在C＃中命名私有变量？ 在一个答案中，我被指向Microsoft的MSDN页面，该页面显示私有变量/字段应按以下方式命名： private int myInteger; 但是参数将是： void SomeMethod(int myInteger) 局部变量是这样的： int myInteger; 所以当你这样引用它们时 myInteger = 10; 您无法知道您在谈论哪个。 我现在开始一个新项目，我的一位同事问我为什么我们不做点什么来区别其中至少一些。 我在想同样的事情。微软的标准为什么没有使这些保持不同？

18 .net  coding-standards  naming 

多年来，我在应用程序中为服务使用了各种命名约定 例如： [ClassName]服务 [ClassName]管理员 [ClassName]工厂 [ClassName] Provider [ClassName]助手 我通常只对没有外部依赖项的实用程序类使用“ Helper”后缀。 但是，我发现彼此之间存在一些交叉，并想知道是否有关于使用什么以及何时使用的任何建议/标准/准则。

18 c#  naming 

想要改善这篇文章吗？提供此问题的详细答案，包括引文和答案正确的解释。答案不够详细的答案可能会被编辑或删除。 这更多是一个风格问题，但这是我目前正在考虑的我的一个项目。 假设您正在创建对学校进行建模的应用程序。因此存在诸如学生，学校等实体。现在，一切都很好而且很直观，直到您上课为止，因为（在大多数语言中）Class是保留字。那么，如果这Class是一个保留关键字，那么您将如何称呼这种模拟学校课程的实体？

18 object-oriented  coding-style  naming 

TL; DR-我正在尝试设计一种最佳的数据结构，以定义度量单位内的单位。 A Unit of measure本质上是value与关联的（或数量）unit。 SI单位有七个基准或尺寸。即：长度，质量，时间，电流，温度，物质量（摩尔）和发光强度。 这足够简单，但是我们经常使用许多派生单位和费率。示例组合单位为牛顿：kg * m / s^2示例比率为tons / hr。 我们的应用程序严重依赖隐含单位。我们将把单元嵌入变量或列名中。但这在我们需要指定具有不同单位的度量单位时会产生问题。是的，我们可以在输入和显示时转换值，但这会生成很多开销代码，我们希望将其封装在自己的类中。 在Codeplex和其他协作环境上有许多解决方案。项目的许可是可以接受的，但是项目本身通常最终会变得太轻或太重。我们正在追逐自己的“正当”独角兽。 理想情况下，我可以使用以下方法定义新的度量单位： UOM myUom1 =新的UOM（10伏）; UOM myUom2 =新的UOM（43.2，牛顿）; 当然，我们会根据客户的需求混合使用英制和SI单位。 我们还需要使这种单位结构与将来的数据库表保持同步，以便我们也可以在数据中提供相同程度的一致性。 定义创建计量单位类别所需的单位，派生单位和费率的最佳方法是什么？我可以看到使用了一个或多个枚举，但这对于其他开发人员可能会感到沮丧。一个单一的枚举包含200多个条目，将是巨大的，而基于SI与英制单位的多个枚举可能会造成混淆，而基于单位本身的分类的其他细分可能会造成混淆。 枚举示例显示了我的一些担忧： myUnits.Volt myUnits.Newton myUnits.meter SIUnit.meter ImpUnit.foot DrvdUnit.Newton DrvdUnitSI.Newton DrvdUnitImp.FtLbs 我们正在使用的单位集非常明确，而且空间有限。当我们有客户需求时，我们确实需要能够扩展和添加新的派生单位或费率。尽管我认为更广泛的设计方面适用于多种语言，但是该项目使用C＃。 我看过的一个库允许通过字符串自由输入单位。然后，他们的UOM类解析该字符串，并相应地添加内容。这种方法的挑战在于，它迫使开发人员思考并记住正确的字符串格式是什么。如果我们不在代码内添加其他检查以验证在构造函数中传递的字符串，则会冒运行时错误/异常的风险。 实质上，另一个库创建了太多开发人员必须使用的类。随着等效值单位它提供了一个DerivedUnit和RateUnit等。本质上，对于我们要解决的问题，代码过于复杂。该库实际上允许任何组合（在单位世界中是合法的），但是我们很高兴通过不允许所有可能的组合来扩大问题范围（简化代码）。 其他库非常简单，甚至都没有考虑过运算符重载。 另外，我也不担心尝试进行错误的转换（例如：伏特到米）。开发人员是目前唯一可以在此级别访问的人员，我们不一定需要防止这些类型的错误。

17 c#  design  naming  data-structures 

已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗？更新问题，以便通过编辑此帖子以事实和引用的形式回答。 5年前关闭。 我正在查看一些PHP函数，但我不禁注意到以下内容： <?php function foo(&$var) { } foo($a); // $a is "created" and assigned to null $b = array(); foo($b['b']); var_dump(array_key_exists('b', $b)); // bool(true) $c = new StdClass; foo($c->d); var_dump(property_exists($c, 'd')); // bool(true) ?> 注意array_key_exists()和property_exists()功能。在第一个中，属性名（数组的键）是第一个参数，而在第二个中，属性名是第二个参数。凭直觉，人们会期望它们具有相似的签名。这可能会导致混淆，并且通过进行此类更正可能会浪费显影时间。 PHP或任何与此相关的语言是否不应该考虑使相关功能的签名保持一致？

17 php  naming  functions 

已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗？更新问题，以便通过编辑此帖子以事实和引文回答。 5年前关闭。 我认为使用代号非常普遍。我们公司也在使用它们。 但我主要担心的是这些名称通常在任何地方都没有记录。意思是通过口耳相传。这些名称与它所命名的工具或实体的功能无关。 我看到了内部测试机以星座命名的模式，面向公众的服务器是以希腊众神命名的。项目以地名或一些随机选择的电影明星或人物的名字命名。但是，无论机器是Windows还是Linux，都无法直接从名称中获得任何信息。32或64位服务器。或项目是什么。 当我看到VCS的提交消息，即有人刚刚分支了“ Gandalf”项目或“ Callanish”项目或任何项目时，我只是感到不好过。出于同样的原因，您通常不会这样命名函数和变量。 我提议，至少对于新实体，我们应该使用更具描述性的名称，但是我面临着强烈的反对。显然，除我以外，组织中的每个人都喜欢这样命名。 那么为什么要使用非描述性的代号呢？ 不要误会我的意思，我没有问题地命名程序版本和里程碑，也没有出于营销原因而使用好的产品名称。但在所有其他地方，我希望看到描述性名称。 编辑： 为您提供一些背景信息：Gandalf是移植代码64位的项目。Callanish是将其移植到Android的...我宁愿将前一个分支称为64bitporting，将后者称为androidporting。也许附有后缀，表示我们计划将其发布的目标版本。所以每个人都知道它的名字。 有问题的服务器是我们在其上测试产品的虚拟机映像。不过，我不知道它实际运行的物理机。因此，将它们称为windowsxp_32，windows7_64，debian_32或solaris_64完全可以。

16 naming  organization 

已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗？更新问题，以便通过编辑此帖子以事实和引文回答。 4年前关闭。 这是一个相对较小的问题，但我无法找到官方文档，甚至找不到关于它的博客意见/讨论。 简而言之：当我有一个私有对象，其唯一目的是为私有服务时lock，该对象该如何命名？ class MyClass { private object LockingObject = new object(); void DoSomething() { lock(LockingObject) { //do something } } } 我们LockingObject在这里应该命名什么？还不仅要考虑变量的名称，还要考虑变量在锁定时的代码外观。 我看过各种示例，但似乎没有可靠的建议： SyncRoot（和的各种变体形式_syncRoot）的用法很多。 代码示例： lock(SyncRoot)，lock(_syncRoot) 这似乎受到VB的等效SyncLock语句，SyncRoot某些ICollection类上存在的属性以及某种SyncRoot设计模式的一部分的影响（这可能是一个坏主意） 在C＃上下文中，不确定是否要使用VBish命名。更糟糕的是，在VB中将变量命名为与关键字相同。不知道这是否会引起混乱。 thisLock并lockThis来自MSDN文章：C＃lock语句，VB SyncLock语句 代码示例： lock(thisLock)，lock(lockThis) 不知道这些名称是否仅出于示例目的而最少命名 如果我们在static类/方法中使用它，那有点奇怪。 编辑：关于锁的Wikipedia文章也使用此命名作为其示例 PadLock（不同大小写的）的几种用法 代码示例： lock(PadLock)，lock(padlock) 不错，但是我唯一的牛肉就是它毫无意外地调用了物理 “挂锁” 的图像，而我倾向于将其与抽象线程概念无关。 根据锁定意图命名锁定 代码示例： lock(messagesLock)，lock(DictionaryLock)，lock(commandQueueLock) 在VB SyncRoot MSDN页面示例中，它包含一个simpleMessageList带有私有messagesLock对象的示例 …

16 c#  naming  multithreading  vb.net