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

Objek :javadoc:`Currency`melambangkan bentuk dari mata uang. ``Currency`` menyimpan tampilan nama (jamak atau tunggal), simbol, jumlah dari angka kecil, dan apakah mata uang tersebut adalah mata uang dasar untuk ekonomi. Jika plugin ekonomi dipilih, itu dapat membantu beberapa mata uang.

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,.