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

Question

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

这是我能想到的一些...

• 始终使用 LOCAL 范围
• 总是包括 init() 返回自身的方法，因为 New 如果找到，将调用 init()。
• 做 不是 将所需的参数放入 init() 如果它是一个 ORM 实体，否则会出现异常...
• 总是使用 THIS.setXXX 其中 XXX 是 init() 内的属性名称，以便它将调用隐式 setter 或自定义 setter（如果可用）。
• 放弃 CF8 之前的 INSTANCE 范围约定，请参阅： 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
• 使用更清洁、更高效 isNull(arguments.optionalArg) 代替 isDefined()

Answer 1

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

我不这么认为。 <cfscript> 本质上抑制任何空白和需求 writeOutput() 为了有任何输出。

Answer 2

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

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

“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