MySQL Database Connect

Czym jest MySQL Database Connect

Ta wtyczka została zaprojektowana dla deweloperów, aby umożliwić dostęp do prostej wtyczki, która potrafi łączyć się z bazą danych MySQL.

Ogólne

To narzędzie przeznaczone dla deweloperów wtyczek i trzeba je pobrać tylko wtedy, gdy jesteś deweloperem lub inna wtyczka wymaga tej wtyczki do działania.

Ta wtyczka została zaprojektowana, aby zapewnić prosty interfejs dostępu do bazy danych MySQL. Nie ma konfiguracji bazy danych ani wstępnie zdefiniowanych konfiguracji przechowywania. To wyłącznie łącznik.

Jak zainstalować

Musisz zainstalować Java MySQL Connector, aby ta wtyczka działała poprawnie. Zrób to przed uruchomieniem wtyczki. Pobierz Java MySQL Connector

Skopiuj plik Jar do folderu wtyczek serwera Bukkit / Spigot. Podczas pierwszego uruchomienia wtyczki plik konfiguracyjny zostanie automatycznie wygenerowany. Z tego pliku konfiguracyjnego będziesz musiał edytować konfigurację, aby dopasować ją do swoich potrzeb (szczegóły połączenia).

Jeśli pobrałeś inną wtyczkę, która wymaga tej wtyczki, przeczytaj tutaj.

Gdy ponownie uruchomisz serwer, w konsoli powinna pojawić się wiadomość, która mówi 'Connected to Database'. Jeśli pojawi się błąd, oznacza to, że prawdopodobnie masz źle skonfigurowany config lub baza danych MySQL nie została uruchomiona.

Jeśli jesteś deweloperem, przeczytaj tutaj

Zaleca się rozwijanie z użyciem tej wtyczki tylko wtedy, gdy masz wiedzę na temat SQL oraz sposobu działania statycznego tworzenia instancji biblioteki, ale możesz poradzić sobie, znając tylko część dotyczącą SQL.

Po pobraniu wtyczki będziesz musiał ją połączyć z projektem. Aby to zrobić w Eclipse:

1. 1 Kliknij prawym przyciskiem myszy swój projekt i wybierz Właściwości
2. 2 Przejdź do Java Build Path, Biblioteki
3. 3 Kliknij 'Dodaj zewnętrzne JAR-y' i znajdź plik JAR Połączenia z Bazą Danych, który pobrałeś. Kliknij Otwórz, a następnie OK.
4. 4 Teraz, gdy plik JAR został dodany do Twojego projektu

Istnieją dwie metody/funkcje, na które musisz zwrócić uwagę. Są to:

update(String sql);
Resultset data = get(String sql);

Obie z nich rzucają SQLException, jeśli coś pójdzie nie tak.

Funkcja update ma być używana z operacjami SQL takimi jak 'INSERT INTO' lub 'UPDATE'. Funkcja get ma być używana z operacjami SQL takimi jak 'SELECT'.

Aby uzyskać dostęp do tych funkcji potrzebujesz dostępu do instancji wtyczki. Dokonuje się to poprzez statyczną zmienną będącą typem klasy JavaPlugin wtyczki Database.

Są dwa sposoby dostępu.

Najłatwiejszy sposób dostępu do wtyczki bazy danych to kod poniższy. W rzadkich przypadkach, z powodu Bukkit Class Loaders i wzorców inicjalizacji, może zwrócić null.

Connect dbInstance = Connect.getInstance();

Sposób na uniknięcie tego to wykonanie połączenia po onEnable wszystkich wtyczek. Robi się to poprzez użycie Runnable w Bukkit Scheduler. Wykonuje również sprawdzenie na null, aby upewnić się, że wtyczka została poprawnie zainicjalizowana.

Connect dbInstance = null;

private void pendConnection() {
	Bukkit.getScheduler().scheduleSyncDelayedTask(this, new Runnable() {
		public void run() {
			if(Connect.getInstance() != null)
				dbInstance  = Connect.getInstance();
			else
				pendConnection();
		}
	});
}

Po wykonaniu tego powinieneś przechowywać zmienną obiektową w swoim projekcie, a nie ciągle odwoływać się do metody getInstance(). Wszystkie dane z bazy danych zwracane są w formie ResultSet, który jest częścią biblioteki java.sql.

Znane problemy

• Jeśli serwer pozostaje bez użytkowników, konektor MySQL zostanie rozłączony i będzie wymagał ponownego uruchomienia serwera (nie przeładowania), aby ponownie się połączyć.

Dziennik zmian

• 1.0.0 - Pierwsze wydanie wtyczki

Bungee Cord

Jeśli chcesz uruchomić wersję Bungee Cord, na stronie pobierania dla niej znajduje się lista wymagań. Wtyczka jest eksperymentalna i może rzadko powodować pewne problemy na serwerze Bungee Cord.