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.