<<ABP框架>> 會話

文檔目錄

本節內容：

• 簡介
  • 關於 IAbpSeesion
• 註入會話
• 會話屬性
• 用戶標識符

簡介

如果一個應用需要登錄，它就需要知道當前用戶在執行的操作。儘管Asp.net自身在展現層提供了Session（會話）對象，而ABP提供IAbpSession介面來獲取當前用戶和租戶，而不用Asp.net的Session。

關於 IAbpSession

必須實現IAbpSession介面，以便獲取真實的會話信息。儘管你可以用自己的方式實現它，但在module-zero項目里已經完全地實現了。

IAbp同樣也是完成集成的，它可用在ABPr其它結構里（設置系統和授權系統）。

註入會話

IAbpSession通常被屬性註入到需要的類，否則不可能有會話信息。如果我們使用屬性註入，可以使用NullAbpSession.Instance作為預設值，如上所示：

public class MyClass : ITransientDependency
{
    public IAbpSession AbpSession { get; set; }

    public MyClass()
    {
        AbpSession = NullAbpSession.Instance;
    }

    public void MyMethod()
    {
        var currentUserId = AbpSession.UserId;
        //...
    }
}

由於認證/授權一個應用層任務，所以建議在應用層或更上面的層使用IAbpSession（通常我們不在領域層里使用它）。ApplicationService.AbpController、AbpApiController和其它基類已經完全註入AbpSession。所以在應用服務實例的方法里，你可以直接使用AbpSession屬性。

會話屬性

AbpSession定義了幾個關鍵屬性：

• UserId：當前用戶的Id或空（如果沒有當前用戶），如果調用需要授權的代碼，它就不能為空。
• TenantId：當前租戶的Id或空（如果沒有當前租戶：尚未登錄或是個宿主用戶）。
• ImpersonatorUserId：模擬用戶的Id（如果其它用戶模擬當前會話），如果不是模擬登錄就為空。
• ImpersonatorTenantId：模擬用戶的租戶的Id（如果其它用戶模擬當前會話），如果不是模擬登錄就為空。
• MultiTenancySide：可能是宿主或租戶。

UserId和TenantId都可為空，有不可為空的方法GetUserId和GetTenantId，如果你能確保有當前用戶，你可以調用GetUserId()。如果當前用戶為空，這個方法拋出異常，GetTenantId()雷同。

Impersonator（模擬）屬性與其它屬性不能共同使用，一般只為了審核日誌的目的才用它。

用戶標識符

你可用.ToUserIdentifier()擴展方法，從IAbpSession創建一個UserIdentifier對象。由於UserIdentifier用在眾多的API里，所以這將簡化為當前用戶創建一個UserIdentifier。