SQLibrary

Gorąco polecam użycie Bukkit's plugin databases API zamiast tej wtyczki.

SQLibrary

SQLibrary został przejęty od alta189 przez PatPeter. Jak dotąd obsługuje 13 baz danych, fabrykę oraz jeden builder zapytań.

Instrukcja

Najpierw dodaj te elementy do swojego pom.xml, jeśli korzystasz z Mavena:

<repository>
  <id>dakani</id>
  <name>Dakani Nexus Repo</name>
  <url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>

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

You should always save implementations to a superclass, unless that child class has more functionality. So, start off by creating your variable:

private Database sql;

Constructing your database object can be either hardcoded into the definition, or assigned in the method. The constructor does not automatically open the database connection so that it does not have to throw an SQLException (though this was considered for quite some time). Below are the constructors for the most popular databases: MySQL, SQLite, and 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");

For SQLite and H2, the extension is optional but will default to ".db". For MySQL, the hostname and port number are optional, but will default to those values. Next, we need to open our database connection:

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

If you know that your plugin will only use the database intermittently, you should check to see if it is open first:

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

If any errors occur while opening the database connection, they will print to console.

Obsługiwane bazy danych

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

Instalacja

1. Pobierz plik jar.
2. W Eclipse przejdź do Właściwości projektu -> Ścieżka kompilacji Java -> Dodaj zewnętrzny plik JAR i dodaj SQLibrary.jar.
3. Poinformuj swoich użytkowników, aby zainstalowali SQLibrary.jar razem ze swoją wtyczką

Nie instaluj ze źródeł!

Jeśli zainstalujesz SQLibrary bezpośrednio w swojej wtyczce, nastąpią następujące problemy:

1. Nie można uruchomić swojej wtyczki razem z wtyczkami SQLibrary.jar. Bukkit (zwykle) najpierw znajdzie klasy SQLibrary w twojej wtyczce i zablokuje zależność SQLibrary.jar.
2. Nie można uruchomić swojej wtyczki razem z innymi wtyczkami korzystającymi z SQLibrary bezpośrednio ze źródeł. Ten sam problem.
3. Aktualizacje na pewno spowodują te problemy i przyniosą ci wiele bólu.

Pobierz SQLibrary ze swojej wtyczki

Możesz teraz umieścić ten kod w swojej wtyczce, aby pobrać i załadować SQLibrary z twojej wtyczki w czasie działania:

http://dev.bukkit.org/bukkit-plugins/sqlibrary/pages/soft-dependency-download/

Specjalne podziękowania

• alta189, za rozpoczęcie tej biblioteki.
• Belphemur, za dodanie pierwszej wersji naszego pakietu fabryki.
• omwah, za dodanie Maven do SQLibrary.
• moose51789, za dodanie wsparcia Spout.
• Mitsugaru, za hostowanie naszego repozytorium Maven, znajdowanie błędów i wprowadzanie poprawek.
• max9403, za dostarczenie kodu do pobierania SQLibrary w czasie działania.

Linki

• Przejdź tutaj, aby omówić SQLibrary!
• Przejdź tutaj, jeśli potrzebujesz pomocy!
• Przejdź tutaj, aby wspomnieć o swojej wtyczce, jeśli używasz SQLibrary razem z nią!
• Wątek na forum