库软件包和关键类

如需了解最常用的类，请参阅键类。

如需查看数据源 Java 库软件包的介绍，请访问以下链接：

• 数据源
• datasource.base
• datasource.datatable
• datasource.query
• datasource.render
• datasource.util

关键类

关键类包括 DataSourceServlet、DataTable、Query 和 DataSourceHelper。

该库最简单的实现涉及从 DataSourceServlet 继承，编写您自己的 generateDataTable() 实现，然后在 WebView 中运行该实现。使用入门部分介绍了此类实现。

DataTable 类定义了数据表的列、列类型、标签、ID 和自定义属性。

Query 类是数据查询的基类，可处理可视化生成的查询。

对于更复杂的用例，辅助类 DataSourceHelper 提供了一组辅助函数。定义功能和事件流中介绍了这种实现方式。

datasource

这是顶级软件包，其中包含大多数数据源开发者与之交互的 API 类。

此顶层还有 Capabilities，用于定义数据源的查询功能。capabilities

base

此软件包包含由多个软件包使用的所有类，以防止软件包之间的循环依赖关系。其中最显著的是采用默认语言区域（美国英语）的错误消息。如需国际化您的实现，您需要转换这些消息。

datatable

此软件包包含用于处理数据表结构（列、行、单元格）和功能（插入、添加）的类。

此软件包还包含用于处理库支持的值和值类型的 value 软件包。可用的值类型在 ValueType 枚举中定义，包括：布尔值、日期、时间、日期和时间、null、数字和文本。

query

此软件包包含处理查询的类，基类为 Query。此软件包还包含以下软件包：

• parser - 处理查询解析的类。
  
• engine - 处理查询执行的类。
• scalarfunction - 用于处理查询中使用的标量函数的类。

render

此软件包包含设置响应格式的类。例如：

• CsvRenderer 将数据表呈现为 CSV。
• HtmlRenderer 会将数据表格呈现为 HTML。
• JsonRenderer 将数据表呈现为 JSON。
• EscapeUtil 提供了一个用于转义字符串的实用程序。

util

此软件包提供了两组辅助函数：

• CsvDataSourceHelper 和 CsvDataSourceException 提供将 CSV 文件用作数据存储区的辅助函数，但它们不提供数据源的完整实现。如需查看示例实现，请参阅使用外部数据存储区。
• SqlDataSourceHelper 和 SqlDatabaseDescription 提供了将 mySQL 数据库用作数据存储区的辅助函数，但它们不提供数据源的完整实现。如需查看示例实现，请参阅 examples 软件包中的 SqlDataSourceServlet。