dubbo:service

2022-04-15 12:00 更新

dubbo:service 配置

服務(wù)提供者暴露服務(wù)配置。對應(yīng)的配置類：org.apache.dubbo.config.ServiceConfig

屬性	對應(yīng)URL參數(shù)	類型	是否必填	缺省值	作用	描述	兼容性
interface		class	必填		服務(wù)發(fā)現(xiàn)	服務(wù)接口名	1.0.0以上版本
ref		object	必填		服務(wù)發(fā)現(xiàn)	服務(wù)對象實(shí)現(xiàn)引用	1.0.0以上版本
version	version	string	可選	0.0.0	服務(wù)發(fā)現(xiàn)	服務(wù)版本，建議使用兩位數(shù)字版本，如：1.0，通常在接口不兼容時(shí)版本號才需要升級	1.0.0以上版本
group	group	string	可選		服務(wù)發(fā)現(xiàn)	服務(wù)分組，當(dāng)一個(gè)接口有多個(gè)實(shí)現(xiàn)，可以用分組區(qū)分	1.0.7以上版本
path	<path>	string	可選	缺省為接口名	服務(wù)發(fā)現(xiàn)	服務(wù)路徑 (注意：1.0不支持自定義路徑，總是使用接口名，如果有1.0調(diào)2.0，配置服務(wù)路徑可能不兼容)	1.0.12以上版本
delay	delay	int	可選	0	性能調(diào)優(yōu)	延遲注冊服務(wù)時(shí)間(毫秒) ，設(shè)為-1時(shí)，表示延遲到Spring容器初始化完成時(shí)暴露服務(wù)	1.0.14以上版本
timeout	timeout	int	可選	1000	性能調(diào)優(yōu)	遠(yuǎn)程服務(wù)調(diào)用超時(shí)時(shí)間(毫秒)	2.0.0以上版本
retries	retries	int	可選	2	性能調(diào)優(yōu)	遠(yuǎn)程服務(wù)調(diào)用重試次數(shù)，不包括第一次調(diào)用，不需要重試請?jiān)O(shè)為0	2.0.0以上版本
connections	connections	int	可選	100	性能調(diào)優(yōu)	對每個(gè)提供者的最大連接數(shù)，rmi、http、hessian等短連接協(xié)議表示限制連接數(shù)，dubbo等長連接協(xié)表示建立的長連接個(gè)數(shù)	2.0.0以上版本
loadbalance	loadbalance	string	可選	random	性能調(diào)優(yōu)	負(fù)載均衡策略，可選值：random,roundrobin,leastactive，分別表示：隨機(jī)，輪詢，最少活躍調(diào)用	2.0.0以上版本
async	async	boolean	可選	false	性能調(diào)優(yōu)	是否缺省異步執(zhí)行，不可靠異步，只是忽略返回值，不阻塞執(zhí)行線程	2.0.0以上版本
local	local	class/boolean	可選	false	服務(wù)治理	設(shè)為true，表示使用缺省代理類名，即：接口名 + Local后綴，已廢棄，請使用stub	2.0.0以上版本
stub	stub	class/boolean	可選	false	服務(wù)治理	設(shè)為true，表示使用缺省代理類名，即：接口名 + Stub后綴，服務(wù)接口客戶端本地代理類名，用于在客戶端執(zhí)行本地邏輯，如本地緩存等，該本地代理類的構(gòu)造函數(shù)必須允許傳入遠(yuǎn)程代理對象，構(gòu)造函數(shù)如：public XxxServiceStub(XxxService xxxService)	2.0.0以上版本
mock	mock	class/boolean	可選	false	服務(wù)治理	設(shè)為true，表示使用缺省Mock類名，即：接口名 + Mock后綴，服務(wù)接口調(diào)用失敗Mock實(shí)現(xiàn)類，該Mock類必須有一個(gè)無參構(gòu)造函數(shù)，與Local的區(qū)別在于，Local總是被執(zhí)行，而Mock只在出現(xiàn)非業(yè)務(wù)異常(比如超時(shí)，網(wǎng)絡(luò)異常等)時(shí)執(zhí)行，Local在遠(yuǎn)程調(diào)用之前執(zhí)行，Mock在遠(yuǎn)程調(diào)用后執(zhí)行。	2.0.0以上版本
token	token	string/boolean	可選	false	服務(wù)治理	令牌驗(yàn)證，為空表示不開啟，如果為true，表示隨機(jī)生成動(dòng)態(tài)令牌，否則使用靜態(tài)令牌，令牌的作用是防止消費(fèi)者繞過注冊中心直接訪問，保證注冊中心的授權(quán)功能有效，如果使用點(diǎn)對點(diǎn)調(diào)用，需關(guān)閉令牌功能	2.0.0以上版本
registry		string	可選	缺省向所有registry注冊	配置關(guān)聯(lián)	向指定注冊中心注冊，在多個(gè)注冊中心時(shí)使用，值為<dubbo:registry>的id屬性，多個(gè)注冊中心ID用逗號分隔，如果不想將該服務(wù)注冊到任何registry，可將值設(shè)為N/A	2.0.0以上版本
provider		string	可選	缺省使用第一個(gè)provider配置	配置關(guān)聯(lián)	指定provider，值為<dubbo:provider>的id屬性	2.0.0以上版本
deprecated	deprecated	boolean	可選	false	服務(wù)治理	服務(wù)是否過時(shí)，如果設(shè)為true，消費(fèi)方引用時(shí)將打印服務(wù)過時(shí)警告error日志	2.0.5以上版本
dynamic	dynamic	boolean	可選	true	服務(wù)治理	服務(wù)是否動(dòng)態(tài)注冊，如果設(shè)為false，注冊后將顯示后disable狀態(tài)，需人工啟用，并且服務(wù)提供者停止時(shí)，也不會自動(dòng)取消冊，需人工禁用。	2.0.5以上版本
accesslog	accesslog	string/boolean	可選	false	服務(wù)治理	設(shè)為true，將向logger中輸出訪問日志，也可填寫訪問日志文件路徑，直接把訪問日志輸出到指定文件	2.0.5以上版本
owner	owner	string	可選		服務(wù)治理	服務(wù)負(fù)責(zé)人，用于服務(wù)治理，請?zhí)顚懾?fù)責(zé)人公司郵箱前綴	2.0.5以上版本
document	document	string	可選		服務(wù)治理	服務(wù)文檔URL	2.0.5以上版本
weight	weight	int	可選		性能調(diào)優(yōu)	服務(wù)權(quán)重	2.0.5以上版本
executes	executes	int	可選	0	性能調(diào)優(yōu)	服務(wù)提供者每服務(wù)每方法最大可并行執(zhí)行請求數(shù)	2.0.5以上版本
proxy	proxy	string	可選	javassist	性能調(diào)優(yōu)	生成動(dòng)態(tài)代理方式，可選：jdk/javassist	2.0.5以上版本
cluster	cluster	string	可選	failover	性能調(diào)優(yōu)	集群方式，可選：failover/failfast/failsafe/failback/forking	2.0.5以上版本
filter	service.filter	string	可選	default	性能調(diào)優(yōu)	服務(wù)提供方遠(yuǎn)程調(diào)用過程攔截器名稱，多個(gè)名稱用逗號分隔	2.0.5以上版本
listener	exporter.listener	string	可選	default	性能調(diào)優(yōu)	服務(wù)提供方導(dǎo)出服務(wù)監(jiān)聽器名稱，多個(gè)名稱用逗號分隔
protocol		string	可選		配置關(guān)聯(lián)	使用指定的協(xié)議暴露服務(wù)，在多協(xié)議時(shí)使用，值為<dubbo:protocol>的id屬性，多個(gè)協(xié)議ID用逗號分隔	2.0.5以上版本
layer	layer	string	可選		服務(wù)治理	服務(wù)提供者所在的分層。如：biz、dao、intl:web、china:acton。	2.0.7以上版本
register	register	boolean	可選	true	服務(wù)治理	該協(xié)議的服務(wù)是否注冊到注冊中心	2.0.8以上版本

以上內(nèi)容是否對您有幫助：

← dubbo:registry

配置中心參考手冊 →

寫筆記

我要補(bǔ)充