Konsep Awal
API Ekonomi Sponge memiliki beberapa bagian-bagian dasar yang harus dikenal pengembang:
EconomyService
Mata uang
Akun-akun
Transaksi
LayananEkonomi
EconomyService adalah sebagai dasar dari API Ekonomi, Itu digunakan untuk berinteraksi melalui API Ekonomi, menyimpan mata uang ekonomi dan menyediakan metode untuk pengelolaan akun.
Peringatan
Sponge tidak menyediakan pelaksanaan dasar untuk EconomyService
. Hal itu tergantung pada plugin secara penuh untuk melaksanakan API Ekonomi. Yang berarti anda harus bergantung pada plugin yang lain yang menjalankan layanan tersebut atau anda harus menjalankannya sendiri, jika anda ingin memanfaatkannya.
Mata uang
The Currency object represents a form of Currency. Currency
stores a display name (plural and singular),
a symbol, the number of fractional digits, and whether the currency is the default currency for the economy. If the
economy plugin chooses, it can support multiple currencies.
Akun-akun
Accountdigunakan untuk menyimpan informasi ekonomi tentang pengguna spesifik atau objek lain (contohnya bank. bisnis, badan usaha). Ada 2 tipe akun didalam API ekonomi Sponge:
Akun Virtual
Akun Virtual dikaitkan kedalam sebuah pengenalan, yang disimpan sebagai String, akun Virtual bisa dikaitkan hampir kedalam apapun, tapi biasanya digunakan untuk sesuatu seperti bank, atau yang bukan pengguna. Untuk mendapatkan id dari akun virtual, gunakan getIdentifier()
.
Akun yang unik
Akun yang unik dikaitkan kedalam UUID, biasanya seorang pengguna. Untuk mendaptkan UUID dari akun yang unik, gunakan getUUID()
.
Transaksi
Transaksi melambangkan sebuah perubahan saldo akun. Saat ini ada 3 jenis transaksi:
Penyetoran: Terjadi ketika sebuah akun memiliki dana yang ditambahkan kedalamnya
Penarikan: Terjadi ketika sebuah akun memiliki dana yang ditarik dari dalamnya
Pengiriman: Terjadi ketika sebuah akun bertukar dana dengan akun lainnya
Ketika pengiriman terjadi, :javadoc:`EconomyTransactionEvent`dihentikan. Menggunakan kejadian ini, anda dapat memperoleh :javadoc:`TransactionResult`. TransactionResult
menyimpan data tentang transaksi yang terjadi, termasuk:
Akun yang terlibat
Mata uang yang terlibat
Jumlah mata uang yang terlibat
Jenis transaksi
Hasil dari transaksi
Anda dapat melihat semua kemungkinan hasil transaksi di ResultType laman JavaDocs,.