Veritabanları

SQL

Sponge, bir JDBC URL’sinden verimli bir havuzlanmış bağlantı kurmanın karmaşıklıklarını işleyen JDBC veritabanı bağlantılarını oluşturmak için uygun bir soyutlama sağlar.

SQL hizmeti herhangi bir JDBC bağlayıcısını desteklerken, Sponge Forge uygulaması yalnızca en yaygın olanıyla birlikte gelir:

  • MySQL
  • Sqlite
  • H2

Uyarı

Sqlite’in birçok kısıtlaması olduğundan, eski uyumluluğun gerekli olduğu durumlar haricinde kullanımı kesinlikle önerilmemektedir. H2, önerilen dosya destekli veritabanı uygulamasıdır.

Kullanım

Veri tabanına eklentinin servis yöneticisi ile erişilebilir:

import org.spongepowered.api.Sponge;
import org.spongepowered.api.service.sql.SqlService;

import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import javax.sql.DataSource;

private SqlService sql;
public DataSource getDataSource(String jdbcUrl) throws SQLException {
    if (sql == null) {
        sql = Sponge.getServiceManager().provide(SqlService.class).get();
    }
    return sql.getDataSource(jdbcUrl);
}

// Later on
public void myMethodThatQueries() throws SQLException {
    String uri = "jdbc:h2:imalittledatabaseshortandstout.db";
    String sql = "SELECT * FROM test_tbl";

    try (Connection conn = getDataSource(uri).getConnection();
         PreparedStatement stmt = conn.prepareStatement(sql);
         ResultSet results = stmt.executeQuery()) {

        while (results.next()) {
            // ...
        }

    }

}

JDBC URLleri Sponge’un evrensel düzenlemesinde (config/sponge/global.conf) listelenen``sponge.sql.aliases``anahtarının altındaki JDBC URL takma adlarından biri ile eşleşen :javadoc:`SqlService#getConnectionUrlFromAlias(String)`den alınmış olmalıdır.

SQL servisi birleştirilmiş bir bağlantı sağlar,dolayısıyla geri göndürülmüş DataSource``Bir bağlantı almak pahalı değildir. Bu yüzden, bağlantıların yakınlarda bulundurulmamasını ve kullanımdan sonra yukarıda gösterildiği gibi kapatılmasını tavsiye ediyoruz. Oluşturulan her ``PreparedStatement ve ResultSet kullanıldıktan sonra object.close() ile veya,tercihe bağlı olarak, bir kaynakla dene engeli vasıtası ile kapatılmalıdır.

NoSQL

Sponge şu anda NoSQL veritabanları üzerinde herhangi bir özel soyutlama sağlamamaktadır (MongoDB vb.). NoSQL veritabanlarını kullanmak isteyen eklentiler kendi bağlayıcılarını sağlamalıdır.