Flutter Azure服务集成插件pip_services4_azure的使用

Flutter Azure服务集成插件pip_services4_azure的使用

此模块是Pip.Services多语言微服务工具包的一部分。

该模块包含用于创建通过Azure函数协议进行操作的容器和服务的组件。

模块包含以下软件包：

• Clients - 用于与Azure云函数交互的客户端组件。
• Connect - 用于安装和连接设置的组件。
• Containers - 包含作为容器来实例化和运行组件的类。
• Controllers - 包含用于通过Azure函数协议进行操作的控制器接口和类。

快速链接

• 配置
• API参考文档
• 变更日志
• 获取帮助
• 贡献

使用

在您的包的pubspec.yaml文件中添加以下内容：

dependencies:
  pip_services4_azure: version

然后从命令行安装包：

pub get

开发

对于开发，你需要安装以下依赖项：

• Dart SDK 3
• Visual Studio Code 或您选择的其他IDE
• Docker

安装依赖项：

pub get

运行自动化测试：

pub run test

生成API文档：

./docgen.ps1

在提交更改之前，运行Docker化的构建和测试：

./build.ps1
./test.ps1
./clear.ps1

联系方式

Dart版本的Pip.Services由以下人员创建和维护：

• Sergey Seroukhov
• Levichev Dmitry

文档由以下人员编写：

• Levichev Dmitry

示例代码

以下是完整的示例代码，演示如何使用pip_services4_azure插件创建和操作Azure函数服务。

import 'dart:io';

import 'package:pip_services4_components/pip_services4_components.dart';
import 'package:pip_services4_data/pip_services4_data.dart';

import './Dummy.dart';
import 'DummyCommandableAzureFunctionClient.dart';
import 'DummyCommandableAzureFunction.dart';

void main() async {
  var appName = Platform.environment['AZURE_FUNCTION_APP_NAME'];
  var functionName = Platform.environment['AZURE_FUNCTION_NAME'];
  var protocol = Platform.environment['AZURE_FUNCTION_PROTOCOL'];
  var authCode = Platform.environment['AZURE_FUNCTION_AUTH_CODE'];
  var uri = Platform.environment['AZURE_FUNCTION_URI'];
  var config = ConfigParams.fromTuples([
    'logger.descriptor',
    'pip-services:logger:console:default:1.0',
    'service.descriptor',
    'pip-services-dummies:service:default:default:1.0'
  ]);
  var azureConfig = ConfigParams.fromTuples([
    'connection.uri',
    uri,
    'connection.protocol',
    protocol,
    'connection.app_name',
    appName,
    'connection.function_name',
    functionName,
    'credential.auth_code',
    authCode,
  ]);

  DummyCommandableAzureFunction azureFunction;
  DummyCommandableAzureFunctionClient client;

  azureFunction = DummyCommandableAzureFunction();
  azureFunction.configure(config);

  await azureFunction.open(null);

  client = DummyCommandableAzureFunctionClient();

  client.configure(azureConfig);
  await client.open(null);

  var dummy1 = Dummy(id: null, key: 'Key 1', content: 'Content 1');
  var dummy2 = Dummy(id: null, key: 'Key 2', content: 'Content 2');

  // 创建一个dummy对象
  try {
    var dummy = await client.createDummy(null, dummy1);
    // 处理创建的项目

    dummy1 = dummy!;
  } catch (err) {
    // 错误处理
  }

  // 创建另一个dummy对象
  try {
    var dummy = await client.createDummy(null, dummy2);
    // 处理第二个创建的项目
    dummy2 = dummy!;
  } catch (err) {
    // 错误处理
  }

  // 获取所有dummies
  try {
    var dummies = await client.getDummies(
        null, FilterParams(), PagingParams(0, 5, false));
    print(dummies);
    // 处理接收到的项目
  } catch (err) {
    // 错误处理
  }

  // 更新dummy对象
  try {
    dummy1.content = 'Updated Content 1';
    var dummy = await client.updateDummy(null, dummy1);
    // 处理更新后的项目
    dummy1 = dummy!;
  } catch (err) {
    // 错误处理
  }

  // 删除dummy对象
  try {
    await client.deleteDummy(null, dummy1.id!);
  } catch (err) {
    // 错误处理
  }

  // 尝试获取已删除的dummy对象
  try {
    var dummy = await client.getDummyById(null, dummy1.id!);
    print(dummy);
    // 处理已删除的项目
  } catch (err) {
    // 错误处理
  }

  // 关闭服务和客户端
  await client.close(null);
}