SQLibrary

插件

· 作者 PatPeter

SQLibrary 旨在简化 Java 中每种数据库引擎的驱动程序封装

0 本站下载 0 关注 更新于 9 年前

最新 SQLibrary 7.1 - Bukkit/Spout

一键开服(送7天)

强烈建议使用 Bukkit 的插件数据库 API 来替代此插件。

SQLibrary

SQLibrary 由 PatPeter 从 alta189 接手维护。截至目前,它支持 13 种数据库、一个工厂类以及一个查询构建器。

教程

首先,如果您正在使用 Maven,请将以下元素添加到您的 pom.xml 中:

<repository>
  <id>dakani</id>
  <name>Dakani Nexus 仓库</name>
  <url></url>
</repository>

<dependency> <groupId>lib.PatPeter.SQLibrary</groupId> <artifactId>SQLibrary</artifactId> <version>7.1</version> </dependency>

除非子类具有更多功能,否则你应始终将实现保存至父类。因此,首先创建你的变量:

private Database sql;

构造数据库对象可以硬编码到定义中,也可以在方法中赋值。构造函数不会自动打开数据库连接,以避免抛出 SQLException(尽管这一点曾被考虑过相当长一段时间)。以下是针对最流行的数据库的构造函数:MySQL、SQLite 和 H2。

sql = new MySQL(Logger.getLogger("Minecraft"), 
            "[MyPlugin] ", 
            "localhost", 
            3306, 
            "myplugin", 
            "minecraft", 
            "password1");
sql = new SQLite(Logger.getLogger("Minecraft"), 
             "[MyPlugin] ", 
             this.getDataFolder().getAbsolutePath(), 
             "MyPlugin", 
             ".sqlite");
sql = new H2(Logger.getLogger("Minecraft"), 
         "[MyPlugin] ", 
         this.getDataFolder().getAbsolutePath(), 
         "MyPlugin", 
         ".h2");

对于 SQLite 和 H2,扩展名是可选的,但默认会使用“.db”。对于 MySQL,主机名和端口号是可选的,但会默认为这些值。接下来,我们需要打开数据库连接:

if (sql.open()) {
    // ...
}

如果你知道你的插件只会间歇性地使用数据库,你应该先检查它是否已打开:

if (!sql.isOpen()) {
    sql.open();
}

如果在打开数据库连接时发生任何错误,它们将被打印到控制台。

支持的数据库

  1. Firebird
  2. FrontBase
  3. DB2
  4. H2
  5. Informix
  6. Ingres
  7. MaxDB
  8. MicrosoftSQL
  9. MySQL
  10. Mongo
  11. mSQL
  12. Oracle
  13. Ovrimos
  14. PostgreSQL
  15. SQLite

安装

  1. 下载 jar 文件。
  2. 在 Eclipse 中,进入项目属性 ==> Java 构建路径 ==> 添加外部 Jar,并添加 SQLibrary.jar。
  3. 告知用户在与你的插件一起安装时也要安装 SQLibrary.jar

请勿从源代码安装!

如果你直接将 SQLibrary 安装到你的插件中,将会出现以下问题:

  1. 你无法让插件与 SQLibrary.jar 插件并行运行。Bukkit 通常会先在你的插件中找到 SQLibrary 类,从而阻止 SQLibrary.jar 依赖项的运行。
  2. 你无法让你的插件与其他直接从源代码使用 SQLibrary 的插件并行运行。存在相同的问题。
  3. 更新肯定会引发这些问题并给你带来诸多麻烦。

从你的插件下载 SQLibrary

你现在可以将此代码放入你的插件中,以便在运行时从你的插件下载并加载 SQLibrary:

特别感谢

  • alta189,为启动该库。
  • Belphemur,为添加我们工厂包的首个版本。
  • omwah,为向 SQLibrary 添加 Maven。
  • moose51789,为添加 Spout 支持。
  • Mitsugaru,为主持我们的 Maven 仓库、发现 bug 并进行修复。
  • max9403,为提供在运行时下载 SQLibrary 的代码。

链接

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源