有什么方法可以在 CFC 中强制执行属性类型？

Question

我在这里遇到了一些奇怪的类型转换问题，并非特定于 Lucee（也在 Railo 中）。可能是我只是在这里错过了一些关键点......

我有一个组件：

<cfcomponent output="false">
    <cfproperty name="thisId" type="String" default="-1" />
    <cfproperty name="thatId" type="String" default="-1" />
</cfcomponent>

这两个属性都明确地输入为字符串。我希望当我尝试将对象或数字设置为其中之一时，代码将返回错误。 但是，由于我现在已经习惯了 cfml 为我进行类型转换，所以我从来没有考虑过在这里设置一个数字根本没有问题的事实。事实上，我假设我在这里尝试设置的所有数字都会为我转换为字符串。

但似乎情况并非如此。 在以序列化结构的形式实现了一些包含这些组件的派生类的 REST 调用之后，我注意到有些作为整数包含，有些作为字符串包含。当我注意到这一点时，我转储了组件本身，并注意到在预期字符串作为属性的地方设置了一个数字，输入已被覆盖为数字。

Railo / Lucee 仍然验证的事实在我看来毫无用处。验证严格类型并抛出错误/传入正确类型的变量，或者验证松散类型并在可能的情况下转换为 CFC 期望的类型。 Railo / lucee 在这里实现了松散的类型验证，但仍然决定以原始类型传递变量，而不是 cfc 期望的每个 sé。

鉴于我现在不想将每个数字都转换为字符串，这里是否有一个简单的疏忽可以挽救我的打字？

（我已经在 Lucee 邮件列表中发布了这个，但没有任何结果，只是人们确认了我已经说过的话/忽略了这不是预期行为的可能性。）

---

更新（亚当要求）： 我看到的是以下内容（在我上面描述的 cfc 组件中）：

<!--- setting a string returns a string afterwards, as expected since the property is a type string initialy --->
<cfset componentName.setThisId('1') />
<cfset local.thisIsStillAString = componentName.getThisId() />

<!--- setting a number returns a number, which means we can no longer assume the property is a string, as it was initially set up --->
<cfset componentName.setThatId(12345) />
<cfset local.thisIsNoLongerAString = componentName.getThatId() />

在这两种情况下，我都希望： - 输入变量将被严格评估为字符串，这意味着第二个示例会引发错误，因为它实际上是一个数字 - 输入变量将被松散地评估为字符串，但在通过评估时将被强制转换为字符串，这意味着第二个示例将通过但最终将返回一个字符串，而不是数字。

在任何情况下，我都希望保留属性的原始类型，而是将其更改为您尝试设置的任何类型，只要它通过当前的松散评估即可。

Answer 1

据我了解，内置的访问器设置器会自动进行类型验证，但只会在必要的情况下进行转换和。

数字/字符串/日期/布尔值都被认为是“简单的”，这就是数字数据通过“字符串”类型验证的原因。因此，因为它通过了验证，所以跳过了强制转换。就个人而言，我希望它进行更严格的验证，但这是 bugtracker 的问题。

现在，如果您必须确保只有实际的字符串数据可以进入这些属性，您可以覆盖为属性生成的设置器以进行更严格的类型转换和/或验证（我只在 Lucee 上测试过）：

/** Example.cfc */
component accessors=true {
    property type="string" name="thisId";
    property type="string" name="thatId";

    public function setThisId(required string newId) {
        // convert numeric value to string value
        if (isNumeric(newId)) {
            newId = toString(newId);

        // throw an exception for non-string/numeric values
        // !isSimpleValue() is a catch-all btw, structs and arrays will
        // be prevented by the "newId" argument's type hint
        } else if (isBoolean(newId) || isDate(newId) || !isSimpleValue(newId)) {
            throw(message="Invalid value specified for thisId");
        }

        variables.thisId = newId;
        return this;
    }
}

var example = new Example();

example.setThisId(54321);
example.setThatId(54321);
writeoutput(serializeJson(example)); //{"thisId":"54321","thatId":54321}

// throws exceptions:
example.setThisId(true);
example.setThisId({});

最后，回到“必要时和可能的投射”部分。对于给定的示例，如果您尝试将组件实例传递给 setThisId() 方法，则类型验证步骤将失败，这意味着类型转换对于操作成功是必要的。然后检查该值是否存在类型转换的可能性。如果组件（并且这只适用于 Railo/Lucee）定义了 _toString()“魔法方法”，那么类型转换是可能的。由于这是可能的，然后将组件转换为字符串，然后将结果传递给setThisId()。如果组件上没有定义该魔术方法，则无法进行类型转换，并引发异常。类似地，对于结构/数组，类型转换是必要的，但不是可能的，因为没有为这些类型定义自动序列化，从而导致抛出异常。

TL;DR

您可以覆盖 setter 访问器以执行更严格的类型验证/类型转换。

Answer 2

要将它们强制为字符串（不是数组或结构），请将accessor=true 与您的<cfproperty> 一起使用并使用setter。

但是，如果您在谈论 SerializeJSON() 将数字字符串视为整数，则 type="string" 无法强制执行。它与SerializeJSON() 函数的行为有关。如果您真的想将它们作为字符串强制执行，请尝试https://github.com/bennadel/JsonSerializer.cfc