feat: ResultSet meta/value getter

Author: CorvusYe

lib/src/driver.dart

@@ -1,7 +1,26 @@
 part of dart_gdbc;
 
+/// A [Driver] is a software component enabling a [Connection] to a database.
+/// ---
+/// 數據庫驅動接口，提供兩個方法：
+/// * 給定 url 的格式，通過 url 格式來確定使用的驅動
+/// * 通過 url 和 properties 來創建一個 [Connection]
+///---
+/// 数据库驱动接口，提供两个方法：
+/// * 给定 url 的格式，通过 url 格式来确定使用的驱动
+/// * 通过 url 和 properties 来创建一个 [Connection]
 abstract class Driver {
+  /// Attempts to make a database connection to the given URL.
+  /// ---
+  /// 嘗試通過給定的 url 來創建一個數據庫連接。
+  /// ---
+  /// 尝试通过给定的 url 来创建一个数据库连接。
   Future<Connection> connect(String url, {Map<String, dynamic> properties});
 
+  /// Retrieves whether the driver thinks that it can open a connection to the given URL.
+  /// ---
+  /// 獲取驅動程序是否認為它可以打開到給定URL的連接。
+  /// ---
+  /// 获取驱动程序是否认为它可以打开到给定URL的连接。
   bool acceptsURL(String url);
 }

lib/src/driver_manager.dart

@@ -1,15 +1,44 @@
 part of dart_gdbc;
 
+/// The basic service for managing a set of GDBC drivers.
+/// Two things are supported in DriverManager:
+/// * You can register a driver with the [DriverManager.registerDriver(driver)].
+/// * You can request a connection using the [DriverManager.getConnection] method.
+/// ---
+/// 驅動程序管理器的基本服務。
+/// DriverManager支持兩件事：
+/// * 您可以使用[DriverManager.registerDriver(driver)]註冊驅動程序。
+/// * 您可以使用[DriverManager.getConnection]方法請求連接。
+///---
+/// 驱动程序管理器的基本服务。
+/// DriverManager支持两件事：
+/// * 您可以使用[DriverManager.registerDriver(driver)]注册驱动程序。
+/// * 您可以使用[DriverManager.getConnection]方法请求连接。
 class DriverManager {
   static const String usrKey = 'username';
   static const String pwdKey = 'password';
 
   static final Map<String, Driver> _drivers = {};
 
+  /// Register a driver with the driver manager.
+  ///---
+  /// 使用驱动程序管理器注册驱动程序。
+  ///---
+  /// 使用驅動程序管理器註冊驅動程序。
   static void registerDriver(Driver driver, [String? driverId]) {
     _drivers[driverId ?? driver.runtimeType.toString()] = driver;
   }
 
+  /// Get a connection from the first driver that recognizes the given URL.
+  /// username and password are optional, if you don't provide them in the url, you can provide them in the properties.
+  /// ---
+  /// 通過url獲取第一個格式相符的驅動程序的連接。
+  /// username和password是可選的，可以通過 properties 傳入，可以通過 url 傳入。
+  /// 不過通過 url 傳入的方式是不可靠的，依托具體的數據庫驅動包。
+  /// ---
+  /// 通过url获取第一个格式相符的驱动程序的连接。
+  /// username和password是可选的，可以通过 properties 传入，可以通过 url 传入，
+  /// 不过通过 url 传入的方式是不可靠的，依托具体的数据库驱动包。
   static Future<Connection> getConnection(
     String url, {
     Map<String, dynamic>? properties,

lib/src/result_set.dart

@@ -1,7 +1,7 @@
 part of dart_gdbc;
 
 abstract class ResultSet {
-  bool success = false;
+  bool success = true;
 
   List<ValueMetaData> get metas;
 
@@ -13,4 +13,35 @@ abstract class ResultSet {
   String toString() {
     return '$runtimeType{\n\tsuccess: $success,\n\tmetas: ${metas.map((e) => e.toJson()).toList()},\n\tcolumns: $columns,\n\trows: ${jsonEncode(rows)}\n}';
   }
+
+  ValueMetaData? meta(List<int> indexes, [List<ValueMetaData>? metas]) {
+    indexes = [...indexes];
+    metas ??= this.metas;
+    if (indexes.isEmpty) {
+      return null;
+    }
+
+    var currentLevelColumnIndex = indexes.removeAt(0);
+    if (indexes.isEmpty) {
+      return metas[currentLevelColumnIndex];
+    } else {
+      return meta(indexes, metas[currentLevelColumnIndex].submetas);
+    }
+  }
+
+  dynamic value(List<int> colIndexes,
+      [int rowIndex = 0, List<dynamic>? values]) {
+    colIndexes = [...colIndexes];
+    values ??= rows[rowIndex];
+    if (colIndexes.isEmpty) {
+      return null;
+    }
+
+    var c = colIndexes.removeAt(0);
+    if (colIndexes.isEmpty) {
+      return values[c];
+    } else {
+      return value(colIndexes, values[c]);
+    }
+  }
 }