在 CF9 中编写 cfc 的编码约定？

Question

有了 CF9 中编写 CFC 的新方法，CF9 有哪些新的编码约定？

以下是我能想到的一些...

• 始终使用 LOCAL 范围
• 始终包含返回自身的 init() 方法，因为 New 如果找到，将调用 init() 。
• 如果它是 ORM 实体，请不要将必需的参数放入 init() 中，否则会出现异常...
• 始终在其中使用 THIS.setXXX XXX 是 init() 中的属性名称，因此它将调用隐式 setter 或自定义 setter（如果可用）。
• 放弃 CF8 之前的实例范围约定，请参阅：http://henrylearnstorock.blogspot.com/2009/08/should-we-abandon-instance-scope-in​​-cf9.html
• 对于脚本样式 CFC 中的组件和函数，没有输出 = false，请参见： http://www.coldfusionjedi.com/index.cfm/2009/8/26/Ask-a-Jedi-Impact-of-whitespace-and-script-based-CFCs
• 使用清洁剂和比 isDefined() 更高效

Answer 1

在脚本风格的CFC中，我们还需要为组件和函数设置属性output=false吗？

我不这么认为。 本质上会抑制任何空格，并且需要 writeOutput() 才能获得任何输出。

Answer 2

如果您使用“new my.cfc()”语法调用 init() 方法，则不必返回“this”作用域。真实的故事。

如果您在 cfc 中并且想要设置属性，请不要使用 this.setFoo()，只需使用 setFoo() 即可。
getFoo() 也是如此。
this.xxx() 就像走出前门只是为了回来。此外，您的 access=private 自定义 getters 和 setters 不会工作，因为函数不会在 this 范围内。

“var foo”与“local.foo” - 就我个人而言，我更喜欢 var 变量，因为 a) 需要输入的代码更少，b) 需要阅读的代码更少。

// there isnt a huge difference here
var today = now();
var tomorrow = dateAdd( 'd', 1, today );
local.today = now();
local.tomorrow = dateAdd( 'd', 1, local.today );

// but when you start getting more complex examples, it quickly blows out
var out = method( var1, var2, var3, var4, var5 );
local.out = method( local.var1, local.var2, local.var3, local.var4, local.var5 );

使用 javadocs 风格的注释。文档是你的朋友。

/**
* @hint This is a hint for the whole function
* @arg1 This is an argument hint
* @arg2 This is another argument hint
**/
public void function myFunction( string arg1 = 'default', boolean arg2 ) {
    return true;
}

Answer 3

所有更改数据的函数都应该返回某个值，即使它是当前始终为 true 的布尔值。函数最终需要返回 false