我是后端Swift的新手,并且以为我会使用Vapor来快速在边项目上启动和运行…我运行了vapor new WebServer --template=auth-template,现在我试图弄清楚类似的return \.email意思。有关更多上下文,我在WebServer>源>应用程序>模型> Users.swift中查找:
vapor new WebServer --template=auth-template
return \.email
import Authentication import FluentSQLite import Vapor /// Allows users to be verified by basic / password auth middleware. extension User: PasswordAuthenticatable { /// See `PasswordAuthenticatable`. static var usernameKey: WritableKeyPath<User, String> { return \.email } // ... }
这是User类的定义:
/// A registered user, capable of owning todo items. final class User: SQLiteModel { // {omit extra code} ... var email: String // {omit extra code} ... /// Creates a new `User`. init(id: Int? = nil, name: String, email: String, passwordHash: String) { // {omit extra code} ... self.email = email // {omit extra code} ... } }
这个反斜杠点表示什么意思?
tl; dr: 我们看一下Swift语言参考,可以肯定的是,这种反斜杠点表示法的用法称为key-path- expression。
(到目前为止,该问题已得到充分回答。)
有关如何获取该部分埋藏文档的更实际的方法:
从发布的代码中可以看到,User类包含一个名为的属性email。
email
请注意,假设您使用的是Xcode,如果将其替换return \.email为return \,则会出现compile-error "Expected expression path in Swift key path",因此这表明该反斜杠点表示法可能与称为关键路径的东西有关。
return \
"Expected expression path in Swift key path"
从关于key-path的文档中,我们看到我们也可以编写\User.email(并且您可以在Xcode中尝试它,而没有编译器错误)。
\User.email
了解该代码中发生的事情的更多上下文:
因此,从语义上讲,要了解usernameKey您正在查看的声明的含义,我们可能想了解a WritableKeyPath是什么。简而言之,从文档中,我们看到a WritableKeyPath是:“支持对结果值进行读写的键路径。”
usernameKey
WritableKeyPath
因此,我们看到该usernameKey声明接受一个WritableKeyPath对象并返回一个Stringis User.email。
String
User.email
此外,很明显,User类需要此usernameKey属性才能与PasswordAuthenticatable协议兼容,该协议是在第一行中导入的import Authentication(如果您愿意在此处进行探索,请查看Dependencies> Auth 2.0.0> Authentication> Basic> BasicAuthenticatable.swift)。
PasswordAuthenticatable
import Authentication