User documentation of Apache Dubbo - Enterprise Distributed Application Service

Başlarken

Ortamınızı kurun ve bir Dubbo uygulamasını çalıştırın.

Konu	Açıklama
Arka plan bilgileri	Apache Dubbo'nun temel kavramları ve dağıtık sistemlerdeki rolü
Gereksinimler	Yazılım ve ortam ön koşulları
Mimari 2.6.1	Dubbo 2.6.1 için bileşen düzeni ve etkileşim modeli
Mimari 2.7.1	Dubbo 2.7.1'deki güncellenmiş mimari ve yeni yetenekler
Kullanım	Dubbo hizmetlerini oluşturma ve çalıştırma için temel kalıplar
Hızlı başlangıç	İlk Dubbo uygulamanızı kullanmaya başlamak için adım adım kılavuz
Bağımlılıklar	Gerekli kitaplıklar ve bağımlılıklar
Olgunluk	Özellik kararlılık düzeyleri ve üretim hazırlığı göstergeleri

Yapılandırma

Dubbo hizmetlerini XML, özellik dosyaları, ek açıklamalar veya API aracılığıyla yapılandırın.

Konu	Açıklama
XML yapılandırması	Hizmetleri, başvuruları ve kayıt defterlerini XML dosyalarında tanımlayın
Özellik yapılandırması	Hafif yapılandırma için `.properties` dosyalarını kullanın
API yapılandırması	Dubbo'yu Java koduyla programatik olarak yapılandırın
Ek açıklama yapılandırması	Hizmetleri ve başvuruları bildirmek için Java ek açıklamalarını kullanın
Dinamik yapılandırma merkezi	Çalışma zamanında yapılandırma değişikliklerini anında yayınlayın
Yapılandırma yükleme süreci	Dubbo'nun birden çok kaynaktan gelen yapılandırmayı nasıl çözdüğü ve birleştirdiği
Ortam değişkenlerinin otomatik yüklenmesi	Ortam değişkenlerini Dubbo yapılandırma özellikleriyle eşleyin

Örnekler

Kategoriye göre düzenlenen yaygın Dubbo özellikleri için çalışan örnekler.

Hizmet kaydı ve keşfi

Konu	Açıklama
Ön kontrol	Tüketici başlamadan önce sağlayıcının kullanılabilirliğini doğrulayın
Açık hedef	Kayıt defterini atlayarak doğrudan belirli bir sağlayıcıya bağlanın
Yalnızca abonelik	Yerel hizmeti kaydetmeden kayıt defteri aracılığıyla sağlayıcıları keşfedin
Yalnızca kayıt	Diğer sağlayıcılara abone olmadan yerel hizmeti kayıt defterine kaydedin
Statik hizmet	Dinamik olarak değişmeyen sabit bir adresle hizmetleri kaydedin
Çoklu kayıt defterleri	Hizmetleri birden fazla kayıt defteri sunucusu arasında yönlendirin

Yük dengeleme ve hata toleransı

Konu	Açıklama
Yük dengeleme	Hizmet çağrıları için yük dengeleme stratejilerini yapılandırın
Hata toleransı stratejisi	Yapılandırılabilir hata toleransı ilkeleriyle hataları yönetin
Hizmet düşürme	Bir sağlayıcı kullanılamadığında veya yavaş olduğunda geri dönüş sonuçları döndürün
Yönlendirme kuralı	Trafiği koşullara göre belirli sağlayıcılara yönlendirin
Kuralları yapılandırın	Yönetim kurallarını çalışma zamanında dinamik olarak uygulayın

Hizmet modeli ve sürüm oluşturma

Konu	Açıklama
Hizmet grubu	Aynı arayüzün farklı uygulamalarını gruba göre izole edin
Çoklu sürümler	Güvenli dağıtım için bir hizmetin birden çok sürümünü yan yana çalıştırın
Çoklu protokoller	Aynı hizmeti aynı anda birden fazla protokol üzerinden sunun
Grup birleştirme	Farklı hizmet gruplarındaki sağlayıcılardan gelen sonuçları toplayın

Çağrı kalıpları

Konu	Açıklama
Eşzamansız çağrı	Çağıran iş parçacığını engellemeden uzak hizmetleri çağırın
Eşzamansız yürütme	Aktarım hızını artırmak için sağlayıcı tarafındaki mantığı eşzamansız çalıştırın
Yerel çağrı	Ağ ek yükünü atlayarak aynı JVM içinde bir hizmeti çağırın
Geri arama parametresi	Eşzamansız sonuçları bir geri arama arayüzü üzerinden alın
Olay bildirimi	Çağrı başarısı, hatası veya tamamlanması durumunda olayları tetikleyin
Genel başvuru	Derleme zamanı arayüz bağımlılığı olmadan herhangi bir hizmeti çağırın
Genel hizmet	Rastgele hizmet arayüzlerini işleyen bir sağlayıcı uygulayın
Yankı hizmeti	Hafif bir yankı isteğiyle hizmet kullanılabilirliğini test edin
Bağlam	Çağrılar sırasında istek kapsamındaki meta verileri iletin ve alın
Örtük parametreler	Arayüz imzasını değiştirmeden RPC çağrılarına gizli anahtar-değer çiftleri ekleyin

Trafik kontrolü ve bağlantı yönetimi

Konu	Açıklama
Eşzamanlılık kontrolü	Bir sağlayıcının veya tüketicinin işlediği eşzamanlı istek sayısını sınırlayın
Bağlantıları yapılandırın	Bağlantı havuzu boyutunu, zaman aşımını ve keep-alive parametrelerini ayarlayın
Tembel bağlantı	İlk istek gönderilene kadar TCP bağlantısı oluşturmayı geciktirin
Yapışkan bağlantı	Oturum yakınlığı kullanım durumları için bir tüketiciyi aynı sağlayıcıya sabitleyin
Jeton yetkilendirmesi	Sağlayıcılara yetkisiz doğrudan erişimi önlemek için bir jeton gerektirin
İş parçacığı modeli	Netty iş parçacığı havuzunu ve dağıtım stratejisini özelleştirin

Gelişmiş özellikler

Konu	Açıklama
Yerel saplama (stub)	Uzak bir çağrıdan önce veya sonra tüketici tarafında ön/son işlem mantığını çalıştırın
Yerel taklit (mock)	Sağlayıcı kullanılamadığında taklit veriler döndürün; test ve degradasyon için kullanışlıdır
Gecikmeli yayın	Uygulama tamamen başlatılana kadar hizmet kaydını bekletin
Parametre doğrulama	Çağrı çalışmadan önce yöntem parametrelerini doğrulayın
Sonucu önbelleğe al	Tekrarlanan uzak çağrıları azaltmak için çağrı sonuçlarını önbelleğe alın
ReferenceConfig önbelleği	Yinelenen proxy'ler oluşturmayı önlemek için `ReferenceConfig` örneklerini yeniden kullanın
Dağıtılmış işlem	Birden çok hizmet arasında işlemleri koordine edin
Otomatik yığın dökümü	Dubbo bir sorun algıladığında otomatik olarak bir iş parçacığı yığın dökümü tetikleyin
Kusursuz kapatma	JVM çıkmadan önce devam eden istekleri tamamlayın ve sağlayıcının kaydını silin

Günlük kaydı, ağ ve serileştirme

Konu	Açıklama
Ana makine adı bağlama	Dubbo'nun hangi ağ arabirimine ve ana makine adına bağlanacağını kontrol edin
Günlükçü stratejisi	Log4j, SLF4J, JCL ve JDK günlük çerçeveleri arasında geçiş yapın
Erişim günlüğü	Denetim ve hata ayıklama için her gelen çağrıyı kaydedin
Hizmet kapsayıcısı	Dubbo hizmetlerini bir web kapsayıcısı olmadan bağımsız çalıştırın
Netty4	Geliştirilmiş performans için Netty 4 aktarımını etkinleştirin
Dubbo'da verimli Java serileştirmesini kullanma (Kryo ve FST)	Daha hızlı serileştirme için varsayılan serileştiriciyi Kryo veya FST ile değiştirin
Kayıt defteri URL'lerini basitleştirin	Gereksiz parametreleri kaldırarak kayıt defteri URL uzunluğunu azaltın

API referansı

Dubbo sınıfları ve arayüzleri için Java API dokümantasyonu.

XML yapılandırma referansı

Her Dubbo XML etiketi için ayrıntılı nitelik ve kullanım açıklamaları.

Etiket	Açıklama
Giriş	Dubbo XML etiketleri arasında paylaşılan ortak nitelikler ve kurallar
`dubbo:service`	Yerel bir Java sınıfını uzak bir Dubbo hizmeti olarak sunun
`dubbo:reference`	Uzak bir Dubbo hizmetini tüketmek için bir proxy oluşturun
`dubbo:protocol`	İletişim protokolünü (bağlantı noktası, serileştirme, iş parçacığı havuzu) yapılandırın
`dubbo:registry`	Hizmet keşfi için bir kayıt defteri sunucusuna bağlanın
`dubbo:monitor`	Çağrı ölçümlerinin toplanmasını ve raporlanmasını etkinleştirin
`dubbo:application`	Ad ve sahip gibi uygulama düzeyindeki özellikleri ayarlayın
`dubbo:module`	İlgili hizmetleri mantıksal bir modülde gruplandırın
`dubbo:provider`	Aynı yapılandırmadaki tüm `dubbo:service` etiketleri için varsayılan değerleri ayarlayın
`dubbo:consumer`	Aynı yapılandırmadaki tüm `dubbo:reference` etiketleri için varsayılan değerleri ayarlayın
`dubbo:method`	Bir hizmet veya başvuru içindeki belirli bir yöntem için ayarları geçersiz kılın
`dubbo:argument`	Belirli bir yöntem bağımsız değişkeni için serileştirme veya doğrulama kurallarını yapılandırın
`dubbo:parameter`	Rastgele anahtar-değer çiftlerini uzantı parametreleri olarak iletin
`dubbo:config-center`	Merkezi yönetim için harici bir yapılandırma merkezine bağlanın

Protokol referansları

Desteklenen iletişim protokolleri; her biri bağlantı ayrıntıları, kullanım durumları ve kısıtlamalarla birlikte sunulmaktadır.

Protokol	Açıklama
Giriş	Protokol seçimi rehberliği ve karşılaştırma
`dubbo://`	Yüksek aktarım hızı ve düşük gecikme süresi senaryoları için uygun olan varsayılan yüksek performanslı ikili protokol
`rmi://`	Eski RMI hizmetleriyle entegrasyon için Java RMI protokolü
`hessian://`	Yerleşik HTTP aktarımına sahip Hessian ikili protokolü; diller arası çağrılar için kullanışlıdır
`http://`	Basit RESTful tarzı çağrılar için standart HTTP protokolü
`webservice://`	Kurumsal sistem entegrasyonu için SOAP tabanlı Web Hizmetleri protokolü
`thrift://`	Diller arası RPC için Apache Thrift protokolü
`memcached://`	Dubbo hizmet arayüzü üzerinden Memcached sunucularına erişin
`redis://`	Dubbo hizmet arayüzü üzerinden Redis sunucularına erişin
`rest://`	HTTP tabanlı hizmet çağrıları için RESTful protokol

Kayıt defteri sunucusu referansları

Hizmet keşfi için kayıt defteri seçenekleri; her biri kurulum talimatları ve ödünleşimlerle birlikte sunulmaktadır.

Kayıt Defteri	Açıklama
Giriş	Kayıt defteri seçimi rehberliği ve karşılaştırma
Çoklu yayın kayıt defteri	Yerel ağda geliştirme ve test için sıfır bağımlılık sağlayan kayıt defteri
ZooKeeper kayıt defteri sunucusu	Apache ZooKeeper tarafından desteklenen üretim düzeyinde kayıt defteri
Nacos kayıt defteri merkezi	Alibaba Nacos tarafından desteklenen kayıt defteri ve yapılandırma merkezi
Redis kayıt defteri sunucusu	Hizmet bildirimleri için Redis pub/sub kullanan kayıt defteri uygulaması
Basit kayıt defteri sunucusu	Standart bir Dubbo hizmeti olarak uygulanan, test amaçlı hafif kayıt defteri

Meta veri referansı

Hizmet meta veri yönetimi: Dubbo'nun sağlayıcılar ve tüketiciler arasında arayüz meta verilerini nasıl işlediği.

Telnet komut referansı

Çalışan hizmetleri incelemek, yöntemleri çağırmak ve komut satırından sorunları gidermek için yerleşik Telnet arayüzünü kullanın.

QoS komut kullanımı

Hizmet Kalitesi (QoS) komut bağlantı noktası sağlık kontrolleri, kusursuz kapatma ve çalışma zamanı tanılama işlevleri sağlar.

Maven eklentisi referansı

Dubbo uygulamaları için Maven eklentisi.

En iyi uygulamalar

Konu	Açıklama
Önerilen kullanım	Yaygın yapılandırma senaryoları için tercih edilen yaklaşımlar
Kapasite planı	Beklenen trafiğe göre donanım ve küme boyutunu tahmin edin
Performans raporu	Dubbo aktarım hızını ve gecikme süresini optimize etmeye yönelik kıyaslama verileri ve ayarlama yönergeleri
Test kapsamı raporu	Dubbo hizmetleri için kod kapsamı ölçümleri ve test stratejileri

Sürüm yükseltme

Konu	Açıklama
2.7.x yükseltme prosedürleri ve notları	Dubbo 2.7.x'e yükseltmek için kırıcı değişiklikler, geçiş adımları ve uyumluluk notları

Erlang

Apache Dubbo bir Erlang istemcisi sağlar. Aşağıdaki konular, Erlang tabanlı tüketiciler ve sağlayıcılar için kurulum ve yapılandırmayı kapsar.

Konu	Açıklama
Hızlı başlangıç	Bir Erlang Dubbo projesi kurun ve temel bir tüketici-sağlayıcı örneğini çalıştırın
Tüketici yapılandırması	Erlang tüketicileri için hizmet başvurularını, zaman aşımlarını ve yük dengelemeyi yapılandırın
Sağlayıcı yapılandırması	Erlang hizmetlerini Dubbo ekosistemine kaydedin ve sunun
Serileştirme yapılandırması	Erlang Dubbo iletişimi için bir serileştirme formatı seçin ve yapılandırın