Go Academy · Pelajaran

Mendesain Interface Plugin

Kontrak interface bersama antara host dan plugin

Pelajaran 2 dari 413 langkah

Mendesain Interface Plugin adalah pelajaran Go Academy gratis di CoddyKit. Ini adalah pelajaran 2 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Go Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Go Academy mencakup 4 pelajaran total.

Pengaya berbasis antarmuka

Definisikan antarmuka Go yang stabil dan wajib diimplementasikan oleh pengaya. Program utama memuat pengaya, mendapatkan implementasinya, lalu memanggilnya melalui antarmuka — tanpa pemeriksaan tipe pada setiap metode.

type Processor interface {
    Name() string
    Process(ctx context.Context, data []byte) ([]byte, error)
}

Titik masuk pengaya

Setiap pengaya mengekspor simbol yang telah ditentukan (misalnya, Plugin) yang mengembalikan implementasi antarmuka:

// In the plugin:
var Plugin processor // exported symbol

type processor struct{}
func (p processor) Name() string { return "my-processor" }
func (p processor) Process(ctx context.Context, data []byte) ([]byte, error) {
    return bytes.ToUpper(data), nil
}

Memuat melalui antarmuka

Di program utama, muat simbol tersebut dan lakukan pemeriksaan tipenya terhadap antarmuka:

sym, _ := p.Lookup("Plugin")
proc, ok := sym.(Processor)
if !ok { log.Fatal("plugin does not implement Processor") }

Pola registri

Pelihara registri pengaya yang telah dimuat berdasarkan nama:

var registry = map[string]Processor{}

func register(p Processor) { registry[p.Name()] = p }
func get(name string) (Processor, bool) {
    p, ok := registry[name]
    return p, ok
}

Pembuatan versi antarmuka

Tambahkan metode Version() ke antarmuka agar program utama dapat memverifikasi kompatibilitas sebelum mendaftarkan pengaya.

type Versioned interface {
    APIVersion() string
}
if v, ok := proc.(Versioned); ok && v.APIVersion() != "1.0" {
    log.Fatalf("incompatible plugin version: %s", v.APIVersion())
}

Konteks dan pembatalan

Teruskan konteks melalui pemanggilan metode pengaya agar program utama dapat membatalkan operasi pengaya yang berjalan lama saat penghentian atau ketika waktu tunggu permintaan tercapai.

Kontrak penanganan kesalahan

Tentukan apakah pengaya harus memicu kepanikan atau mengembalikan kesalahan saat gagal. Mengembalikan kesalahan lebih aman — kepanikan dalam pengaya mungkin tidak dapat ditangkap oleh middleware pemulihan milik program utama.

Konfigurasi

Berikan konfigurasi kepada pengaya saat pemuatan melalui metode Init(config map[string]string) error. Dengan demikian, pembuatan pengaya terpisah dari konfigurasinya.

Pengelolaan siklus hidup

Tambahkan Close() error ke antarmuka untuk pengaya yang menahan sumber daya (koneksi DB, goroutine) yang perlu dibersihkan saat penghentian.

Menguji pengaya secara mandiri

Uji implementasi pengaya secara langsung (sebagai paket Go) tanpa memuat biner .so. Antarmuka membuat pengujian dengan tiruan menjadi mudah.

Kontrak dokumentasi

Dokumentasikan kontrak antarmuka dengan jelas: metode mana yang dipanggil dan kapan, jaminan konkurensi, serta hal yang dianggap sebagai kesalahan dan hal yang dianggap sebagai kondisi fatal.

Pemeriksaan Singkat

Mengapa mendefinisikan antarmuka Go yang stabil untuk pengaya, alih-alih mencari simbol fungsi satu per satu?

Jawab di pelajaran interaktif

Rangkuman: Desain Antarmuka Pengaya

Poin utama:

Definisikan antarmuka stabil yang wajib diimplementasikan pengaya
Ekspor simbol yang telah ditentukan (variabel Plugin bertipe InterfaceType) dari pengaya
Satu pemeriksaan tipe saat pemuatan; semua pemanggilan aman terhadap tipe melalui antarmuka
Tambahkan Version(), Init(), dan Close() untuk pengelolaan siklus hidup

Gratis untuk memulai

Belajar Go dengan tutor AI — gratis

Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.

Kursus: 51
Pelajaran: 203

Mulai belajar gratis Lihat kursus lengkapnya

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Mendesain Interface Plugin” gratis?

Ya — teks lengkap “Mendesain Interface Plugin” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Go Academy, upgrade ke CoddyKit PRO. Kursus Go Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Mendesain Interface Plugin”?

Kontrak interface bersama antara host dan plugin Kamu berlatih Go Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Go Academy?

Tidak diperlukan pengalaman sebelumnya. Go Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 2 dari 4.

Berapa lama pelajaran “Mendesain Interface Plugin” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Go Academy ini?

Ya. Setiap pelajaran Go Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke Go Academy