如何通过 Firestore Query Protos 自动生成多语言支持查询的代码实现？

本文共计728个文字，预计阅读时间需要3分钟。

原文：

在开发使用 Firestore 数据库的桌面应用程序时，经常需要在不同的编程语言中实现相同的查询逻辑。手动编写不同语言的查询代码不仅效率低下，而且容易出错。本文提供了一种利用 Google Protobuf 框架自动生成多语言查询方法代码的解决方案。

以下是如何使用 Java 的 String.format 和 StructuredQuery 类解决此问题的示例：

首先，使用 Java Firestore SDK 构建一个查询：

import com.google.cloud.firestore.Firestore; import com.google.cloud.firestore.Query; import com.google.firestore.v1.RunQueryRequest; import com.google.firestore.v1.StructuredQuery; import com.google.cloud.firestore.Query.Direction; // 假设 db 是 Firestore 实例 Firestore db = // ... 获取 Firestore 实例 Query query = db.collection("col2") .whereGreaterThanOrEqualTo("name", "a") .orderBy("name", Direction.ASCENDING) .limit(50); RunQueryRequest runQueryRequest = query.toProto(); StructuredQuery structuredQuery = runQueryRequest.getStructuredQuery(); System.out.println("structuredQuery: " + structuredQuery);

这段代码会打印出 StructuredQuery 的 Protobuf 格式字符串，例如：

from { collection_id: "col2" } where { field_filter { field { field_path: "name" } op: GREATER_THAN_OR_EQUAL value { string_value: "a" } } } order_by { field { field_path: "name" } direction: ASCENDING } limit { value: 50 }

接下来，可以使用 Java 的 String.format 方法，根据 StructuredQuery 的内容，生成目标语言的查询代码。 以下是一个 Python 示例，展示如何使用 StructuredQuery 的信息来构建相应的查询代码：

collection_id = "col2" field_path = "name" op = "GREATER_THAN_OR_EQUAL" string_value = "a" direction = "ASCENDING" limit = 50 python_query = f""" db.collection("{collection_id}") \ .where("{field_path}", "{op}", "{string_value}") \ .order_by("{field_path}", direction="{direction}") \ .limit({limit}) """ print(python_query)

这段 Python 代码会生成以下查询代码：

db.collection("col2") .where("name", "GREATER_THAN_OR_EQUAL", "a") .order_by("name", direction="ASCENDING") .limit(50)

注意事项：

• 需要根据目标语言的语法和 Firestore SDK 的 API 调整字符串格式化的模板。
• 对于复杂的查询条件，可能需要编写更复杂的代码来解析 StructuredQuery 的内容。
• 确保对用户输入进行适当的验证和转义，以防止安全漏洞。
• 此方法依赖于Firestore SDK的内部实现，未来的SDK版本可能会改变StructuredQuery的结构，因此需要定期维护和更新代码。

总结：

通过将 Firestore 查询转换为 Protobuf 格式的字符串，并使用字符串格式化技术，可以方便地生成多种编程语言的查询代码。这种方法可以提高开发效率，减少错误，并实现跨平台 Firestore 查询逻辑的统一管理。 尽管需要维护模板和处理复杂查询，但它提供了一个强大的工具，用于在不同的编程环境中保持查询一致性。