Go Academy · Ders

Bir Plugin Arayüzü Tasarlama

Ana uygulama ve plugin arasındaki paylaşılan arayüz sözleşmeleri

Bir Plugin Arayüzü Tasarlama, CoddyKit'te ücretsiz bir Go Academy dersidir. Bu, 4 dersinin 2. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, Go Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. Go Academy kursu toplamda 4 dersten oluşur.

Arayüz tabanlı eklentiler

Eklentilerin uygulaması gereken kararlı bir Go arayüzü tanımlayın. Ana uygulama eklentiyi yükler, uygulamayı alır ve arayüz üzerinden çağırır; her yöntemde tür doğrulaması gerekmez.

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

Eklenti giriş noktası

Her eklenti, arayüz uygulamasını döndüren bilinen bir sembolü (örneğin Plugin) dışa aktarır:

// 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
}

Arayüz üzerinden yükleme

Ana uygulamada sembolü yükleyin ve türünü arayüz olarak doğrulayın:

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

Kayıt defteri deseni

Yüklenen eklentilerin adlarına göre bir kayıt defterini koruyun:

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
}

Arayüz sürümleme

Ana uygulamanın eklentiyi kaydetmeden önce uyumluluğu doğrulayabilmesi için arayüze bir Version() yöntemi ekleyin.

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

Bağlam ve iptal

Ana uygulamanın kapanma sırasında veya istek zaman aşımına uğradığında uzun süren eklenti işlemlerini iptal edebilmesi için bağlamı eklenti yöntemi çağrıları boyunca aktarın.

Hata işleme sözleşmesi

Hata durumunda eklentilerin panik oluşturup oluşturmayacağını veya hata döndürüp döndürmeyeceğini tanımlayın. Hata döndürmek daha güvenlidir; eklentilerdeki panikler ana uygulamanın recover ara katmanı tarafından yakalanamayabilir.

Yapılandırma

Yapılandırmayı yükleme sırasında Init(config map[string]string) error yöntemiyle eklentilere aktarın. Bu, eklenti oluşturmayı yapılandırmadan ayırır.

Yaşam döngüsü yönetimi

Kapanma sırasında temizlenmesi gereken kaynakları (DB bağlantıları, Go rutinleri) tutan eklentiler için arayüze Close() error ekleyin.

Eklentileri bağımsız olarak sınama

Eklenti uygulamasını .so ikilisini yüklemeden doğrudan (Go paketi olarak) sınayın. Arayüz, sahte nesnelerle sınamayı kolaylaştırır.

Belgeleme sözleşmesi

Arayüz sözleşmesini açıkça belgeleyin: hangi yöntemlerin ne zaman çağrıldığı, iş parçacığı garantileri ve neyin hata, neyin kritik durum sayıldığı.

Hızlı Kontrol

Ayrı işlev sembollerini aramak yerine eklentiler için neden kararlı bir Go arayüzü tanımlanmalıdır?

Özet: Eklenti Arayüzü Tasarımı

Temel noktalar:

Eklentinin uygulaması gereken kararlı bir arayüz tanımlayın
Eklentiden bilinen bir sembolü dışa aktarın (var Plugin InterfaceType)
Yükleme sırasında tek tür doğrulaması yapın; tüm çağrılar arayüz üzerinden tür güvenli olur
Yaşam döngüsü yönetimi için Version(), Init() ve Close() ekleyin

Sıkça Sorulan Sorular

“Bir Plugin Arayüzü Tasarlama” dersi ücretsiz mi?

Evet — “Bir Plugin Arayüzü Tasarlama” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve Go Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. Go Academy kursu toplamda 4 dersten oluşur.

“Bir Plugin Arayüzü Tasarlama” dersinde ne öğreneceğim?

Ana uygulama ve plugin arasındaki paylaşılan arayüz sözleşmeleri Go Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

Go Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te Go Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 2. dersidir.

“Bir Plugin Arayüzü Tasarlama” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu Go Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her Go Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

← Go Academy Sayfasına Dön