DbLib 是一个库,它捆绑了数据库驱动程序,以便与您的插件一起简单使用。
功能
如何使用插件(服务器所有者必读)
如果任何插件需要 DbLib,您只需下载并安装它。通常,这就足够了。但如果您打算使用 MySQL 或其他 SQLite 文件,则需要配置插件(请参阅配置部分)。
插件开发者注意事项
ORMLite 是一个流行的引擎,它使用 ORM 技术提供对数据库的访问。实际上,这意味着您可以在不编写 SQL 查询的情况下读取和保存数据到数据库中。
DbLib 还包括以下数据库驱动程序:
如何连接到通用 DbLib 存储
DbLib 建议为所有插件使用通用数据库(默认情况下是位于服务器文件夹中的 nukkit.db 文件,或用户定义的 MySQL 数据库)。如果服务器上安装了 DbLib,您无需考虑数据库驱动程序、URL、名称和密码。
以下是创建新表的示例(更多信息请查看 API 部分):
Maven 依赖
XML:
示例:
Java:
但如果您打算使用任何其他数据库,则必须使用以下方法:
功能
- 提供对流行数据库引擎的访问:SQLite 和 MySQL;
- 包含流行的 ORMLite 库,提供无需使用 SQL 查询即可访问数据库的功能;
- 为所有使用 DbLib 的插件组织通用数据存储。服务器所有者只需配置一次 DbLib,所有使用 DbLib 的插件都能正常工作!
如何使用插件(服务器所有者必读)
如果任何插件需要 DbLib,您只需下载并安装它。通常,这就足够了。但如果您打算使用 MySQL 或其他 SQLite 文件,则需要配置插件(请参阅配置部分)。
插件开发者注意事项
ORMLite 是一个流行的引擎,它使用 ORM 技术提供对数据库的访问。实际上,这意味着您可以在不编写 SQL 查询的情况下读取和保存数据到数据库中。
DbLib 还包括以下数据库驱动程序:
- SQLite 驱动程序
- MySQL 驱动程序
如何连接到通用 DbLib 存储
DbLib 建议为所有插件使用通用数据库(默认情况下是位于服务器文件夹中的 nukkit.db 文件,或用户定义的 MySQL 数据库)。如果服务器上安装了 DbLib,您无需考虑数据库驱动程序、URL、名称和密码。
以下是创建新表的示例(更多信息请查看 API 部分):
Maven 依赖
XML:
代码:
<repositories>
<repository>
<id>nukkit-repo</id>
<url>https://repo.nukkitx.com/snapshot</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>ru.nukkit.dblib</groupId>
<artifactId>DbLib</artifactId>
<version>1.0-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
</dependencies>
示例:
Java:
代码:
public boolean connectToDbLib(){
if (this.getServer().getPluginManager().getPlugin("DbLib") == null){
this.getLogger().info(TextFormat.RED+"DbLib plugin not found");
return false;
}
connectionSource = DbLib.getConnectionSource();
if (connectionSource == null) return false;
try {
passDao = DaoManager.createDao(connectionSource, PasswordsTable.class);
TableUtils.createTableIfNotExists(connectionSource, PasswordsTable.class);
} catch (Exception e) {
return false;
}
return true;
}
但如果您打算使用任何其他数据库,则必须使用以下方法:
代码:
DbLib.getConnectionSource(String url, String userName, String password)