Module-Zero之启动模板

返回《Module Zero学习目录》

---

• 概览介绍
• 社交登录
• 基于Token的认证
• 单元测试

概览介绍##

使用ABP和Module-Zero开始一个新的项目最简单的方式通过ABP官网的模板页面创建一个解决方案的模板。进入页面之后，选择选项卡"ABP + module zero"，然后创建你的项目。当前，该模板只支持EntityFramework作为ORM（还不支持NHiberbate）。

创建并下载你的项目之后，使用Visual Studio打开你的解决方案。
选择Web项目作为起始项目。
打开包管理控制台，选择“EntityFramework”项目作为默认项目，然后运行EF的'Update-Database'命令。该命令会创建数据库。
运行该应用，默认的用户名是'admin'，密码是'123qwe'。
在该模板中，默认是开启多租户的。如果你不需要的话可以在Core项目的module文件中关闭它。

社交登录##

启动模板支持Facebook, Twitter和Google+登录，在Web.config中，你可以看到下面的设置：

 <appSettings>
  <add key="webpages:Version" value="3.0.0.0" />
  <add key="webpages:Enabled" value="false" />
  <add key="ClientValidationEnabled" value="true" />
  <add key="UnobtrusiveJavaScriptEnabled" value="true" />

  <add key="ExternalAuth.Facebook.IsEnabled" value="false" />
  <add key="ExternalAuth.Facebook.AppId" value="" />
  <add key="ExternalAuth.Facebook.AppSecret" value="" />

  <add key="ExternalAuth.Twitter.IsEnabled" value="false" />
  <add key="ExternalAuth.Twitter.ConsumerKey" value="" />
  <add key="ExternalAuth.Twitter.ConsumerSecret" value="" />

  <add key="ExternalAuth.Google.IsEnabled" value="false" />
  <add key="ExternalAuth.Google.ClientId" value="" />
  <add key="ExternalAuth.Google.ClientSecret" value="" />

</appSettings> 

这里，你可以设置你需要的社交登录。当然，你必须要有从相关的社交网站获得的keys和密码。你可以从网页上学习如何获得这个keys。一旦你开启了社交登录，你会在登录页面看到一个按钮。类似地，你也可以实现其他的登录。

基于Token的认证##

启动模板使用了基于cookie的浏览器认证。如果你想在一个移动端应用上使用Web APIs或者应用服务（通过动态web api暴露），你很可能想使用基于token的认证机制。启动模板包括了不记名token认证基础。.WebApi项目中的AccountController包含了获取token的认证action，以后我们就可以对后面的请求使用这个token了。
这里，我会使用Postman（chrome插件）演示请求和响应。

认证（Authentication）

向localhost:6334/api/Account/Authenticate 发送一个post请求，头部的Context-Type="application/json"，如下所示：

我们发送了一个包含userNameOrEmailAddress和password的Json请求体，还有，对于租户用户来说，也应该发送tenancyName。正如上面看到的，返回Josn的result属性包含了token。我们可以保存该token，用于后面的请求。

使用API

认证并获得token之后，我们可以使用它来调用任何授权的的action。所有的应用服务都是可以远程使用的。比如，我们可以使用Tenant服务获取租户的列表：

向 localhost:6334/api/services/app/tenant/GetTenants 发送Post请求，请求头部包含Content-Type="application/json" 和Authorization="Bearer your-auth-token" 。请求体是一个空的{}。当然，请求和响应体对于不同的APIs是不同的。
几乎所有UI上的可使用的操作，同样也可以作为Web API使用（因为UI使用了相同的Web API）,并且很容易使用。

单元测试##

启动模板包含了测试基础设施的安装，并且在.Test项目下面有一些测试。你可以检查它们并能很容易地写一些类似的测试。实际上，它们是集成测试而不是单元测试，因为它们使用所有的ABP框架的基础设施（包括验证，授权和工作单元...）来测试你的代码。