Dreamine.Identity.SqliteUserStore에 대한 상속 다이어그램 :

Dreamine.Identity.SqliteUserStore에 대한 협력 다이어그램:

클래스
class	TableColumn

Public 멤버 함수
	SqliteUserStore (IDatabaseProvider database)
async Task< AuthUser >	UpsertAsync (string provider, string providerKey, string email, string displayName, string avatarUrl, CancellationToken cancellationToken=default)
async Task< AuthUser?>	GetByIdAsync (long id, CancellationToken cancellationToken=default)
async Task< AuthUser?>	UpdateDisplayNameAsync (long id, string displayName, CancellationToken cancellationToken=default)
async Task< AuthUser?>	AcceptRequiredConsentsAsync (long id, DateTime acceptedAtUtc, CancellationToken cancellationToken=default)
async Task< AuthUser?>	ChangeLocalPasswordAsync (long id, string currentPassword, string newPassword, CancellationToken cancellationToken=default)
async Task< AuthUser >	CreateLocalAsync (string email, string displayName, string password, CancellationToken cancellationToken=default)
async Task< AuthUser?>	ValidateLocalAsync (string email, string password, CancellationToken cancellationToken=default)

Private 멤버 함수
async Task< AuthUser?>	FindLocalByEmailAsync (string email, CancellationToken cancellationToken)
void	EnsureSchema ()
void	AddNullableDateColumnIfMissing (HashSet< string > columns, string columnName)

정적 Private 멤버 함수
static string	NormalizeEmail (string email)

Private 속성
readonly IDatabaseProvider	_database

정적 Private 속성
const string	SelectSql
const string	LocalProvider = "Local"

상세한 설명

Dreamine 데이터베이스 추상화를 사용하는 SQLite 기반 IUserStore 구현입니다.

SqliteUserStore.cs 파일의 14 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

◆ SqliteUserStore()

Dreamine.Identity.SqliteUserStore.SqliteUserStore ( IDatabaseProvider database )

inline

데이터베이스 공급자로 저장소를 초기화하고 사용자 테이블과 필수 열을 보장합니다.

매개변수

database 사용자 데이터를 저장할 데이터베이스 공급자입니다.

예외

ArgumentNullException database 가 null인 경우 발생합니다.

SqliteUserStore.cs 파일의 73 번째 라인에서 정의되었습니다.

    {
        _database = database ?? throw new ArgumentNullException(nameof(database));
        _database.CreateTable<AuthUser>();
        EnsureSchema();
    }

다음을 참조함 : _database, EnsureSchema().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

멤버 함수 문서화

◆ AcceptRequiredConsentsAsync()

async Task< AuthUser?> Dreamine.Identity.SqliteUserStore.AcceptRequiredConsentsAsync	(	long	id,
		DateTime	acceptedAtUtc,
		CancellationToken	cancellationToken = default )

inline

사용자의 세 필수 동의 시각을 동일한 UTC 값으로 기록합니다.

매개변수

id	내부 사용자 식별자입니다.
acceptedAtUtc	동의를 수락한 UTC 시각입니다.
cancellationToken	갱신 취소 토큰입니다.

반환값: 갱신된 사용자 또는 없으면 null입니다.

Dreamine.Identity.IUserStore를 구현.

SqliteUserStore.cs 파일의 369 번째 라인에서 정의되었습니다.

    {
        var user = await GetByIdAsync(id, cancellationToken).ConfigureAwait(false);
        if (user is null)
        {
            return null;
        }
 
        user.TermsAcceptedAtUtc = acceptedAtUtc;
        user.PrivacyPolicyAcceptedAtUtc = acceptedAtUtc;
        user.AgeConfirmedAtUtc = acceptedAtUtc;
        await _database.UpdateAsync(user, cancellationToken).ConfigureAwait(false);
        return user;
    }

다음을 참조함 : _database, GetByIdAsync().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ AddNullableDateColumnIfMissing()

void Dreamine.Identity.SqliteUserStore.AddNullableDateColumnIfMissing	(	HashSet< string >	columns,
		string	columnName )

inlineprivate

열 집합에 없으면 nullable 날짜 텍스트 열을 Users 테이블에 추가합니다.

매개변수

columns	현재 열 이름 집합입니다.
columnName	확인하고 추가할 열 이름입니다.

SqliteUserStore.cs 파일의 780 번째 라인에서 정의되었습니다.

    {
        if (!columns.Contains(columnName))
        {
            _database.ExecuteNonQuery($"ALTER TABLE Users ADD COLUMN {columnName} TEXT NULL");
        }
    }

다음을 참조함 : _database.

다음에 의해서 참조됨 : EnsureSchema().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ ChangeLocalPasswordAsync()

async Task< AuthUser?> Dreamine.Identity.SqliteUserStore.ChangeLocalPasswordAsync	(	long	id,
		string	currentPassword,
		string	newPassword,
		CancellationToken	cancellationToken = default )

inline

로컬 사용자의 현재 비밀번호를 검증하고 강도가 확인된 새 해시를 저장합니다.

매개변수

id	내부 사용자 식별자입니다.
currentPassword	현재 평문 비밀번호입니다.
newPassword	새 평문 비밀번호입니다.
cancellationToken	변경 취소 토큰입니다.

반환값: 갱신된 사용자 또는 없으면 null입니다.

예외

ArgumentNullException	newPassword 가 `null`인 경우 발생합니다.
ArgumentException	newPassword 가 비어 있거나 공백인 경우 발생합니다.
InvalidOperationException	소셜 계정이거나 현재 비밀번호가 틀렸거나 새 비밀번호가 8자 미만인 경우 발생합니다.

Dreamine.Identity.IUserStore를 구현.

SqliteUserStore.cs 파일의 459 번째 라인에서 정의되었습니다.

    {
        var user = await GetByIdAsync(id, cancellationToken).ConfigureAwait(false);
        if (user is null)
        {
            return null;
        }
 
        if (!string.Equals(user.Provider, LocalProvider, StringComparison.OrdinalIgnoreCase))
        {
            throw new InvalidOperationException("소셜 로그인 계정의 비밀번호는 해당 로그인 제공자에서 관리됩니다.");
        }
 
        if (!DreaminePasswordHasher.VerifyPassword(currentPassword, user.PasswordHash))
        {
            throw new InvalidOperationException("현재 비밀번호가 올바르지 않습니다.");
        }
 
        ArgumentException.ThrowIfNullOrWhiteSpace(newPassword);
        if (newPassword.Length < 8)
        {
            throw new InvalidOperationException("새 비밀번호는 8자 이상이어야 합니다.");
        }
 
        user.PasswordHash = DreaminePasswordHasher.HashPassword(newPassword);
        await _database.UpdateAsync(user, cancellationToken).ConfigureAwait(false);
        return user;
    }

다음을 참조함 : _database, GetByIdAsync(), Dreamine.Identity.DreaminePasswordHasher.HashPassword(), LocalProvider, Dreamine.Identity.DreaminePasswordHasher.VerifyPassword().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ CreateLocalAsync()

async Task< AuthUser > Dreamine.Identity.SqliteUserStore.CreateLocalAsync	(	string	email,
		string	displayName,
		string	password,
		CancellationToken	cancellationToken = default )

inline

이메일을 정규화하고 중복 및 비밀번호 길이를 검증한 뒤 로컬 계정을 만듭니다.

매개변수

email	로컬 계정 이메일입니다.
displayName	선택적 표시 이름이며 비어 있으면 이메일을 사용합니다.
password	해시할 평문 비밀번호입니다.
cancellationToken	생성 취소 토큰입니다.

반환값: 데이터베이스에서 다시 읽은 생성 사용자입니다.

예외

ArgumentNullException	email 또는 password 가 `null`인 경우 발생합니다.
ArgumentException	email 또는 password 가 비어 있거나 공백인 경우 발생합니다.
InvalidOperationException	비밀번호가 8자 미만이거나 이메일이 이미 등록된 경우 발생합니다.

Dreamine.Identity.IUserStore를 구현.

SqliteUserStore.cs 파일의 564 번째 라인에서 정의되었습니다.

    {
        email = NormalizeEmail(email);
        ArgumentException.ThrowIfNullOrWhiteSpace(password);
 
        if (password.Length < 8)
        {
            throw new InvalidOperationException("비밀번호는 8자 이상이어야 합니다.");
        }
 
        var existing = await FindLocalByEmailAsync(email, cancellationToken).ConfigureAwait(false);
        if (existing is not null)
        {
            throw new InvalidOperationException("이미 가입된 이메일입니다.");
        }
 
        var now = DateTime.UtcNow;
        var user = new AuthUser
        {
            Provider = LocalProvider,
            ProviderKey = email,
            Email = email,
            DisplayName = string.IsNullOrWhiteSpace(displayName) ? email : displayName.Trim(),
            AvatarUrl = string.Empty,
            PasswordHash = DreaminePasswordHasher.HashPassword(password),
            CreatedAt = now,
            LastLoginAt = now
        };
 
        await _database.InsertAsync(user, cancellationToken).ConfigureAwait(false);
 
        return (await FindLocalByEmailAsync(email, cancellationToken).ConfigureAwait(false))!;
    }

다음을 참조함 : _database, FindLocalByEmailAsync(), Dreamine.Identity.DreaminePasswordHasher.HashPassword(), LocalProvider, NormalizeEmail().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ EnsureSchema()

void Dreamine.Identity.SqliteUserStore.EnsureSchema ( )

inlineprivate

기존 Users 테이블에 비밀번호 및 필수 동의 열이 존재하도록 마이그레이션합니다.

SqliteUserStore.cs 파일의 740 번째 라인에서 정의되었습니다.

    {
        var columns = _database.Query<TableColumn>("PRAGMA table_info(Users)")
            .Select(column => column.Name)
            .ToHashSet(StringComparer.OrdinalIgnoreCase);
 
        if (!columns.Contains(nameof(AuthUser.PasswordHash)))
        {
            _database.ExecuteNonQuery("ALTER TABLE Users ADD COLUMN PasswordHash TEXT NOT NULL DEFAULT ''");
        }
 
        AddNullableDateColumnIfMissing(columns, nameof(AuthUser.TermsAcceptedAtUtc));
        AddNullableDateColumnIfMissing(columns, nameof(AuthUser.PrivacyPolicyAcceptedAtUtc));
        AddNullableDateColumnIfMissing(columns, nameof(AuthUser.AgeConfirmedAtUtc));
    }

다음을 참조함 : _database, AddNullableDateColumnIfMissing(), Dreamine.Identity.Models.AuthUser.AgeConfirmedAtUtc, Dreamine.Identity.Models.AuthUser.PasswordHash, Dreamine.Identity.Models.AuthUser.PrivacyPolicyAcceptedAtUtc, Dreamine.Identity.Models.AuthUser.TermsAcceptedAtUtc.

다음에 의해서 참조됨 : SqliteUserStore().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ FindLocalByEmailAsync()

async Task< AuthUser?> Dreamine.Identity.SqliteUserStore.FindLocalByEmailAsync	(	string	email,
		CancellationToken	cancellationToken )

inlineprivate

정규화된 이메일을 로컬 공급자 키로 사용해 사용자를 조회합니다.

매개변수

email	정규화된 이메일입니다.
cancellationToken	조회 취소 토큰입니다.

반환값: 찾은 로컬 사용자 또는 없으면 null입니다.

SqliteUserStore.cs 파일의 718 번째 라인에서 정의되었습니다.

    {
        var rows = await _database.QueryAsync<AuthUser>(
            "SELECT Id, Provider, ProviderKey, Email, DisplayName, AvatarUrl, PasswordHash, " +
            "TermsAcceptedAtUtc, PrivacyPolicyAcceptedAtUtc, AgeConfirmedAtUtc, CreatedAt, LastLoginAt " +
            "FROM Users WHERE Provider = @Provider AND ProviderKey = @ProviderKey LIMIT 1",
            new { Provider = LocalProvider, ProviderKey = email },
            cancellationToken).ConfigureAwait(false);
 
        return rows.FirstOrDefault();
    }

다음을 참조함 : _database, LocalProvider.

다음에 의해서 참조됨 : CreateLocalAsync(), ValidateLocalAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetByIdAsync()

async Task< AuthUser?> Dreamine.Identity.SqliteUserStore.GetByIdAsync	(	long	id,
		CancellationToken	cancellationToken = default )

inline

내부 식별자로 사용자를 비동기 조회합니다.

매개변수

id	내부 사용자 식별자입니다.
cancellationToken	조회 취소 토큰입니다.

반환값: 찾은 사용자 또는 없으면 null입니다.

Dreamine.Identity.IUserStore를 구현.

SqliteUserStore.cs 파일의 239 번째 라인에서 정의되었습니다.

    {
        var rows = await _database.QueryAsync<AuthUser>(
            "SELECT Id, Provider, ProviderKey, Email, DisplayName, AvatarUrl, PasswordHash, " +
            "TermsAcceptedAtUtc, PrivacyPolicyAcceptedAtUtc, AgeConfirmedAtUtc, CreatedAt, LastLoginAt " +
            "FROM Users WHERE Id = @Id LIMIT 1",
            new { Id = id },
            cancellationToken).ConfigureAwait(false);
 
        return rows.FirstOrDefault();
    }

다음을 참조함 : _database.

다음에 의해서 참조됨 : AcceptRequiredConsentsAsync(), ChangeLocalPasswordAsync(), UpdateDisplayNameAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ NormalizeEmail()

string Dreamine.Identity.SqliteUserStore.NormalizeEmail ( string email )

inlinestaticprivate

이메일 양끝 공백을 제거하고 소문자 불변 문화권 형식으로 정규화합니다.

매개변수

email 정규화할 이메일입니다.

반환값: 정규화된 이메일입니다.

예외

ArgumentNullException	email 이 `null`인 경우 발생합니다.
ArgumentException	email 이 비어 있거나 공백인 경우 발생합니다.

SqliteUserStore.cs 파일의 828 번째 라인에서 정의되었습니다.

    {
        ArgumentException.ThrowIfNullOrWhiteSpace(email);
        return email.Trim().ToLowerInvariant();
    }

다음에 의해서 참조됨 : CreateLocalAsync(), ValidateLocalAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ UpdateDisplayNameAsync()

async Task< AuthUser?> Dreamine.Identity.SqliteUserStore.UpdateDisplayNameAsync	(	long	id,
		string	displayName,
		CancellationToken	cancellationToken = default )

inline

사용자의 공백 제거된 표시 이름을 갱신합니다.

매개변수

id	내부 사용자 식별자입니다.
displayName	저장할 표시 이름입니다.
cancellationToken	갱신 취소 토큰입니다.

반환값: 갱신된 사용자 또는 없으면 null입니다.

예외

NullReferenceException	displayName 이 `null`인 경우 발생합니다.
InvalidOperationException	공백을 제거한 표시 이름이 비어 있는 경우 발생합니다.

Dreamine.Identity.IUserStore를 구현.

SqliteUserStore.cs 파일의 307 번째 라인에서 정의되었습니다.

    {
        var user = await GetByIdAsync(id, cancellationToken).ConfigureAwait(false);
        if (user is null)
        {
            return null;
        }
 
        displayName = displayName.Trim();
        if (string.IsNullOrWhiteSpace(displayName))
        {
            throw new InvalidOperationException("표시 이름을 입력해 주세요.");
        }
 
        user.DisplayName = displayName;
        await _database.UpdateAsync(user, cancellationToken).ConfigureAwait(false);
        return user;
    }

다음을 참조함 : _database, GetByIdAsync().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ UpsertAsync()

async Task< AuthUser > Dreamine.Identity.SqliteUserStore.UpsertAsync	(	string	provider,
		string	providerKey,
		string	email,
		string	displayName,
		string	avatarUrl,
		CancellationToken	cancellationToken = default )

inline

외부 공급자 키로 사용자를 추가하거나 프로필과 마지막 로그인 시각을 갱신합니다.

매개변수

provider	로그인 공급자 이름입니다.
providerKey	공급자 사용자 키입니다.
email	사용자 이메일입니다.
displayName	사용자 표시 이름입니다.
avatarUrl	프로필 이미지 URL입니다.
cancellationToken	저장 취소 토큰입니다.

반환값: 저장된 최신 사용자 레코드입니다.

예외

ArgumentNullException	provider 또는 providerKey 가 `null`인 경우 발생합니다.
ArgumentException	provider 또는 providerKey 가 비어 있거나 공백인 경우 발생합니다.

Dreamine.Identity.IUserStore를 구현.

SqliteUserStore.cs 파일의 160 번째 라인에서 정의되었습니다.

    {
        ArgumentException.ThrowIfNullOrWhiteSpace(provider);
        ArgumentException.ThrowIfNullOrWhiteSpace(providerKey);
 
        var now = DateTime.UtcNow;
        var existing = (await _database.QueryAsync<AuthUser>(
            SelectSql,
            new { Provider = provider, ProviderKey = providerKey },
            cancellationToken).ConfigureAwait(false)).FirstOrDefault();
 
        if (existing is not null)
        {
            existing.Email = email ?? string.Empty;
            existing.DisplayName = displayName ?? string.Empty;
            existing.AvatarUrl = avatarUrl ?? string.Empty;
            existing.LastLoginAt = now;
            await _database.UpdateAsync(existing, cancellationToken).ConfigureAwait(false);
            return existing;
        }
 
        var created = new AuthUser
        {
            Provider = provider,
            ProviderKey = providerKey,
            Email = email ?? string.Empty,
            DisplayName = displayName ?? string.Empty,
            AvatarUrl = avatarUrl ?? string.Empty,
            PasswordHash = string.Empty,
            CreatedAt = now,
            LastLoginAt = now
        };
 
        await _database.InsertAsync(created, cancellationToken).ConfigureAwait(false);
 
        return (await _database.QueryAsync<AuthUser>(
            SelectSql,
            new { Provider = provider, ProviderKey = providerKey },
            cancellationToken).ConfigureAwait(false)).First();
    }

다음을 참조함 : _database, SelectSql.

◆ ValidateLocalAsync()

async Task< AuthUser?> Dreamine.Identity.SqliteUserStore.ValidateLocalAsync	(	string	email,
		string	password,
		CancellationToken	cancellationToken = default )

inline

로컬 이메일과 비밀번호를 검증하고 마지막 로그인 및 필요한 해시 업그레이드를 저장합니다.

매개변수

email	정규화할 이메일입니다.
password	검증할 평문 비밀번호입니다.
cancellationToken	검증 취소 토큰입니다.

반환값: 인증된 사용자 또는 실패하면 null입니다.

예외

ArgumentNullException	email 이 `null`인 경우 발생합니다.
ArgumentException	email 이 비어 있거나 공백인 경우 발생합니다.

Dreamine.Identity.IUserStore를 구현.

SqliteUserStore.cs 파일의 658 번째 라인에서 정의되었습니다.

    {
        email = NormalizeEmail(email);
        var user = await FindLocalByEmailAsync(email, cancellationToken).ConfigureAwait(false);
        if (user is null)
        {
            return null;
        }
 
        var verification = DreaminePasswordHasher.VerifyPassword(password, user.PasswordHash, out var upgradedHash);
        if (verification is PasswordHashVerificationResult.Failed)
        {
            return null;
        }
 
        user.LastLoginAt = DateTime.UtcNow;
        if (verification is PasswordHashVerificationResult.SuccessRehashNeeded && upgradedHash is not null)
        {
            user.PasswordHash = upgradedHash;
        }
 
        await _database.UpdateAsync(user, cancellationToken).ConfigureAwait(false);
        return user;
    }

다음을 참조함 : _database, FindLocalByEmailAsync(), NormalizeEmail(), Dreamine.Identity.DreaminePasswordHasher.VerifyPassword().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

◆ _database

readonly IDatabaseProvider Dreamine.Identity.SqliteUserStore._database

private

database 값을 보관합니다.

SqliteUserStore.cs 파일의 47 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : AcceptRequiredConsentsAsync(), AddNullableDateColumnIfMissing(), ChangeLocalPasswordAsync(), CreateLocalAsync(), EnsureSchema(), FindLocalByEmailAsync(), GetByIdAsync(), SqliteUserStore(), UpdateDisplayNameAsync(), UpsertAsync(), ValidateLocalAsync().

◆ LocalProvider

const string Dreamine.Identity.SqliteUserStore.LocalProvider = "Local"

staticprivate

Local Provider 값을 보관합니다.

SqliteUserStore.cs 파일의 37 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ChangeLocalPasswordAsync(), CreateLocalAsync(), FindLocalByEmailAsync().

◆ SelectSql

const string Dreamine.Identity.SqliteUserStore.SelectSql

staticprivate

초기값:

                           =
"SELECT Id, Provider, ProviderKey, Email, DisplayName, AvatarUrl, PasswordHash, " +
"TermsAcceptedAtUtc, PrivacyPolicyAcceptedAtUtc, AgeConfirmedAtUtc, CreatedAt, LastLoginAt " +
"FROM Users WHERE Provider = @Provider AND ProviderKey = @ProviderKey LIMIT 1"

Select Sql 값을 보관합니다.

SqliteUserStore.cs 파일의 24 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UpsertAsync().

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

SqliteUserStore.cs

클래스

Public 멤버 함수

Private 멤버 함수

정적 Private 멤버 함수

Private 속성

정적 Private 속성

상세한 설명

생성자 & 소멸자 문서화

◆ SqliteUserStore()

멤버 함수 문서화

◆ AcceptRequiredConsentsAsync()

◆ AddNullableDateColumnIfMissing()

◆ ChangeLocalPasswordAsync()

◆ CreateLocalAsync()

◆ EnsureSchema()

◆ FindLocalByEmailAsync()

◆ GetByIdAsync()

◆ NormalizeEmail()

◆ UpdateDisplayNameAsync()

◆ UpsertAsync()

◆ ValidateLocalAsync()

멤버 데이터 문서화

◆ _database

◆ LocalProvider

◆ SelectSql