graphql_switch 是一个 Flutter 插件，用于在 Flutter 应用中轻松切换不同的 GraphQL 客户端。这个插件特别适用于需要根据不同的环境（如开发、测试、生产）或不同的用户角色来切换 GraphQL 客户端的场景。

安装

首先，你需要在 pubspec.yaml 文件中添加 graphql_switch 依赖：

dependencies:
  flutter:
    sdk: flutter
  graphql_switch: ^1.0.0  # 请根据实际情况使用最新版本

然后运行 flutter pub get 来安装依赖。

基本用法

1. 导入包

   在你的 Dart 文件中导入 graphql_switch：

   import 'package:graphql_switch/graphql_switch.dart';
   

2. 创建 GraphQL 客户端

   你可以使用 graphql_flutter 或其他 GraphQL 客户端库来创建不同的 GraphQL 客户端。例如：

   import 'package:graphql_flutter/graphql_flutter.dart';
   
   final client1 = GraphQLClient(
     cache: GraphQLCache(),
     link: HttpLink('https://api1.example.com/graphql'),
   );
   
   final client2 = GraphQLClient(
     cache: GraphQLCache(),
     link: HttpLink('https://api2.example.com/graphql'),
   );
   

3. 配置 GraphQLSwitch

   使用 GraphQLSwitch 来管理这些客户端，并根据需要切换：

   final graphQLSwitch = GraphQLSwitch(
     clients: {
       'client1': client1,
       'client2': client2,
     },
     defaultClientId: 'client1',  // 设置默认客户端
   );
   

4. 切换客户端

   你可以通过 switchClient 方法来切换客户端：

   graphQLSwitch.switchClient('client2');
   

5. 使用当前客户端

   你可以通过 currentClient 属性来获取当前使用的客户端：

   final currentClient = graphQLSwitch.currentClient;
   

6. 执行 GraphQL 查询

   使用当前客户端执行 GraphQL 查询或变更：

   final query = '''
     query {
       exampleQuery {
         field
       }
     }
   ''';
   
   final result = await currentClient.query(QueryOptions(
     document: gql(query),
   ));
   
   if (result.hasException) {
     print(result.exception);
   } else {
     print(result.data);
   }
   

示例

以下是一个完整的示例，展示了如何使用 graphql_switch 来切换不同的 GraphQL 客户端：

import 'package:flutter/material.dart';
import 'package:graphql_switch/graphql_switch.dart';
import 'package:graphql_flutter/graphql_flutter.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'GraphQL Switch Demo',
      home: GraphQLSwitchDemo(),
    );
  }
}

class GraphQLSwitchDemo extends StatefulWidget {
  [@override](/user/override)
  _GraphQLSwitchDemoState createState() => _GraphQLSwitchDemoState();
}

class _GraphQLSwitchDemoState extends State<GraphQLSwitchDemo> {
  final graphQLSwitch = GraphQLSwitch(
    clients: {
      'client1': GraphQLClient(
        cache: GraphQLCache(),
        link: HttpLink('https://api1.example.com/graphql'),
      ),
      'client2': GraphQLClient(
        cache: GraphQLCache(),
        link: HttpLink('https://api2.example.com/graphql'),
      ),
    },
    defaultClientId: 'client1',
  );

  String? selectedClientId = 'client1';

  Future<void> _fetchData() async {
    final query = '''
      query {
        exampleQuery {
          field
        }
      }
    ''';

    final result = await graphQLSwitch.currentClient.query(QueryOptions(
      document: gql(query),
    ));

    if (result.hasException) {
      print(result.exception);
    } else {
      print(result.data);
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('GraphQL Switch Demo'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            DropdownButton<String>(
              value: selectedClientId,
              onChanged: (String? newValue) {
                setState(() {
                  selectedClientId = newValue;
                  graphQLSwitch.switchClient(newValue!);
                });
              },
              items: <String>['client1', 'client2']
                  .map<DropdownMenuItem<String>>((String value) {
                return DropdownMenuItem<String>(
                  value: value,
                  child: Text(value),
                );
              }).toList(),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _fetchData,
              child: Text('Fetch Data'),
            ),
          ],
        ),
      ),
    );
  }
}