Flutter高级平台认证插件senior_platform_authentication的使用

本项目旨在成为连接用于与Senior-X进行身份验证的端点和Dart语言的桥梁，而无需直接依赖于Flutter SDK。因此，它不仅可用于Flutter应用程序，还可以与其他使用Dart的语言的应用程序一起使用。

我们还提供了senior_platform_authentication_ui包，该包已经集成了此项目，并提供了可供Flutter应用程序使用的现成界面和与Senior-X相关的业务规则。

建议仅在开发项目需要对Flutter前端界面进行自定义，而senior_platform_authentication_ui库不支持的情况下，直接使用此包。

架构

架构基于清洁架构（Clean Architecture），但在项目范围分析后进行了某些适应性调整。该项目仅提供数据层和领域层，以便独立使用。

如何使用

加载senior_platform_authentication包：

import 'package:senior_platform_authentication/senior_platform_authentication.dart';

配置基础URL（可选）

远程数据源被配置为使用包含请求基础URL的单例。默认情况下，使用的是Senior X生产环境的基础URL。

SeniorAuthentication.initialize(
  encryptionKey: '您的32个字符的加密密钥',
);

也可以初始化选择请求将被定向到的环境：

SeniorAuthentication.initialize(
  platformEnvironment: PlatformEnvironment.homolog,
  encryptionKey: '您的32个字符的加密密钥',
);

此外，initialize方法还有其他可用的配置选项，详情如下：

注意: encryptionKey参数始终应该是相同的，否则将无法解密数据。

调用一个用例

用例可以按照以下方式调用：

final credentials = UserLogin(
  username: '{YOUR_USERNAME}',
  password: '{YOUR_PASSWORD}',
  scope: 'mobile',
);

final loginUsecase = LoginUsecase();
await loginUsecase(credentials);

或者，我们可以直接调用call方法：

await loginUsecase.call(credentials);

注意事项

建议仅使用已经实现的用例及其与Senior X相关的业务规则。如果需要任何自定义，请联系Senior Sistemas的集成联系人。

示例代码

example/main.dart

import 'package:senior_platform_authentication/senior_platform_authentication.dart';

void main() async {
  final getConnectionStatus = GetConnectivityStatusUsecase();
  final connStatus = await getConnectionStatus(NoParams());

  print('是否连接: $connStatus.');

  final credentials = UserLogin(
    username: '{YOUR_USERNAME}',
    password: '{YOUR_PASSWORD}',
    scope: 'mobile',
  );

  final tenantLogin = TenantLogin(
    userName: '{YOUR_USERNAME}',
    tenantDomain: '{YOUR_TENANT}',
  );

  SeniorAuthentication.initialize(
    platformEnvironment: PlatformEnvironment.production,
    encryptionKey: SeniorAuthentication.encryptionKey,
  );

  final getRecaptchaUrlUsecase = GetRecaptchaUrlUsecase();
  final loginUsecase = LoginUsecase();
  final getUserUsecase = GetUserUsecase();
  final logoutOnlineUsecase = LogoutUsecase();
  final getTenantLoginSettingsUsecase = GetTenantLoginSettingsUsecase();
  final refreshTokenUsecase = RefreshTokenUsecase();
  final getTenantSettingsUsecase = GetTenantSettingsUsecase();

  try {
    final url = await getRecaptchaUrlUsecase(NoParams());
    print('RECAPTCHA URL >>> $url');

    final authenticationResponse = await loginUsecase(credentials);
    print('AUTHENTICATION RESPONSE >>> ${authenticationResponse.toString()}');

    final tenantSettings = await getTenantSettingsUsecase(
        authenticationResponse.token?.accessToken ?? '');
    print('TENANT SETTINGS >>> ${tenantSettings.toString()}');

    final getUserInput = GetUserInput(
      accessToken: authenticationResponse.token?.accessToken ?? '',
      username: authenticationResponse.token?.username ?? '',
      includePhoto: false,
    );

    final user = await getUserUsecase(getUserInput);
    print('USER >>> ${user.toString()}');

    final refreshToken = RefreshToken(
        token: authenticationResponse.token?.refreshToken ?? '',
        scope: authenticationResponse.token?.accessToken ?? '',
        tenant: user.tenantName);

    final refreshAuthenticationResponse =
        await refreshTokenUsecase(refreshToken);

    print('REFRESH AUTHENTICATION RESPONSE >>> $refreshAuthenticationResponse');

    // Call method is optional when calling usecase to be executed.
    final logout = await logoutOnlineUsecase
        .call(refreshAuthenticationResponse.token?.accessToken ?? '');
    print('LOGOUT >>> $logout');

    final tenantLoginSettings =
        await getTenantLoginSettingsUsecase.call(tenantLogin);
    print('TENANT LOGIN SETTINGS >>> $tenantLoginSettings');
  } on ServerException catch (e) {
    print('服务器异常 >>> ${e.toString()}');
  } on UnauthorizedException catch (e) {
    print('未授权异常 >>> ${e.toString()}');
  } on BadRequestException catch (e) {
    print('错误请求异常 >>> ${e.toString()}');
  } on TenantNotFoundException catch (e) {
    print('租户未找到异常 >>> ${e.toString()}');
  } on UnknownException catch (e) {
    print('未知异常 >>> ${e.toString()}');
  }
}