org.apache.dubbo.config.annotation

Annotation Type DubboReference

@Documented
 @Retention(value=RUNTIME)
 @Target(value={FIELD,METHOD,ANNOTATION_TYPE})
public @interface DubboReference

An annotation used for referencing a Dubbo service

Since:

2.7.7

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
int	actives Maximum active requests allowed, default value is 0
String	application Application associated name
boolean	async Whether to enable async invocation, default value is false
String	cache Specify cache implementation for service invocation, legal values include: lru, threadlocal, jcache
int	callbacks The callback instance limit peer connection
boolean	check Check if service provider is available during boot up, default value is true
String	client Client transport type, default value is "netty"
String	cluster Cluster strategy, legal values include: failover, failfast, failsafe, failback, forking
int	connections Maximum connections service provider can accept, default value is 0 - connection is shared
String	consumer Consumer associated name
String[]	filter Filters for service invocation
boolean	generic Whether to enable generic invocation, default value is false
String	group Service group, default value is empty string
String	id The id
boolean	init Whether eager initialize the reference bean when all properties are set, default value is false
boolean	injvm When enable, prefer to call local service in the same JVM if it's present, default value is true
Class<?>	interfaceClass Interface class, default value is void.class
String	interfaceName Interface class name, default value is empty string
String	layer Service layer, default value is empty string
boolean	lazy Whether to make connection when the client is created, the default value is false
String[]	listener Listeners for service exporting and unexporting
String	loadbalance Load balance strategy, legal values include: random, roundrobin, leastactive
String	merger Service merger
Method[]	methods methods support
String	mock Service mock name, use interface name + Mock if not set
String	module Module associated name
String	monitor Monitor associated name
String	onconnect Callback method name when connected, default value is empty string
String	ondisconnect Callback method name when disconnected, default value is empty string
String	owner Service owner, default value is empty string
String[]	parameters Customized parameter key-value pair, for example: {key1, value1, key2, value2}
String	protocol The communication protocol of Dubbo Service
String	proxy How the proxy is generated, legal values include: jdk, javassist
String	reconnect Whether to reconnect if connection is lost, if not specify, reconnect is enabled by default, and the interval for retry connecting is 2000 ms
String[]	registry Registry associated name
int	retries Service invocation retry times
boolean	sent Whether the async request has already been sent, the default value is false
boolean	sticky Whether to stick to the same node in the cluster, the default value is false
String	stub Service stub name, use interface name + Local if not set
boolean	stubevent Export an stub service for event dispatch, default value is false.
String	tag Service tag name
int	timeout Timeout value for service invocation, default value is 0
String	url Service target URL for direct invocation, if this is specified, then registry center takes no effect.
String	validation Whether to use JSR303 validation, legal values are: true, false
String	version Service version, default value is empty string

Element Detail

interfaceClass

public abstract Class<?> interfaceClass

Interface class, default value is void.class

Default:

void.class

interfaceName

public abstract String interfaceName

Interface class name, default value is empty string

Default:

""

version

public abstract String version

Service version, default value is empty string

Default:

""

group

public abstract String group

Service group, default value is empty string

Default:

""

url

public abstract String url

Service target URL for direct invocation, if this is specified, then registry center takes no effect.

Default:

""

client

public abstract String client

Client transport type, default value is "netty"

Default:

""

generic

public abstract boolean generic

Whether to enable generic invocation, default value is false

Default:

false

injvm

public abstract boolean injvm

When enable, prefer to call local service in the same JVM if it's present, default value is true

Default:

true

check

public abstract boolean check

Check if service provider is available during boot up, default value is true

Default:

true

init

public abstract boolean init

Whether eager initialize the reference bean when all properties are set, default value is false

Default:

false

lazy

public abstract boolean lazy

Whether to make connection when the client is created, the default value is false

Default:

false

stubevent

public abstract boolean stubevent

Export an stub service for event dispatch, default value is false.

see org.apache.dubbo.rpc.Constants#STUB_EVENT_METHODS_KEY

Default:

false

reconnect

public abstract String reconnect

Whether to reconnect if connection is lost, if not specify, reconnect is enabled by default, and the interval for retry connecting is 2000 ms

see org.apache.dubbo.remoting.Constants#DEFAULT_RECONNECT_PERIOD

Default:

""

sticky

public abstract boolean sticky

Whether to stick to the same node in the cluster, the default value is false

see Constants#DEFAULT_CLUSTER_STICKY

Default:

false

proxy

public abstract String proxy

How the proxy is generated, legal values include: jdk, javassist

Default:

""

stub

public abstract String stub

Service stub name, use interface name + Local if not set

Default:

""

cluster

public abstract String cluster

Cluster strategy, legal values include: failover, failfast, failsafe, failback, forking

Default:

""

connections

public abstract int connections

Maximum connections service provider can accept, default value is 0 - connection is shared

Default:

0

callbacks

public abstract int callbacks

The callback instance limit peer connection

see org.apache.dubbo.rpc.Constants#DEFAULT_CALLBACK_INSTANCES

Default:

0

onconnect

public abstract String onconnect

Callback method name when connected, default value is empty string

Default:

""

ondisconnect

public abstract String ondisconnect

Callback method name when disconnected, default value is empty string

Default:

""

owner

public abstract String owner

Service owner, default value is empty string

Default:

""

layer

public abstract String layer

Service layer, default value is empty string

Default:

""

retries

public abstract int retries

Service invocation retry times

see Constants#DEFAULT_RETRIES

Default:

2

loadbalance

public abstract String loadbalance

Load balance strategy, legal values include: random, roundrobin, leastactive

see Constants#DEFAULT_LOADBALANCE

Default:

""

async

public abstract boolean async

Whether to enable async invocation, default value is false

Default:

false

actives

public abstract int actives

Maximum active requests allowed, default value is 0

Default:

0

sent

public abstract boolean sent

Whether the async request has already been sent, the default value is false

Default:

false

mock

public abstract String mock

Service mock name, use interface name + Mock if not set

Default:

""

validation

public abstract String validation

Whether to use JSR303 validation, legal values are: true, false

Default:

""

timeout

public abstract int timeout

Timeout value for service invocation, default value is 0

Default:

0

cache

public abstract String cache

Specify cache implementation for service invocation, legal values include: lru, threadlocal, jcache

Default:

""

filter

public abstract String[] filter

Filters for service invocation

see Filter

Default:

{}

listener

public abstract String[] listener

Listeners for service exporting and unexporting

see ExporterListener

Default:

{}

parameters

public abstract String[] parameters

Customized parameter key-value pair, for example: {key1, value1, key2, value2}

Default:

{}

application

public abstract String application

Application associated name

Default:

""

module

public abstract String module

Module associated name

Default:

""

consumer

public abstract String consumer

Consumer associated name

Default:

""

monitor

public abstract String monitor

Monitor associated name

Default:

""

registry

public abstract String[] registry

Registry associated name

Default:

{}

protocol

public abstract String protocol

The communication protocol of Dubbo Service

Returns:

the default value is ""

Since:

2.6.6

Default:

""

tag

public abstract String tag

Service tag name

Default:

""

merger

public abstract String merger

Service merger

Default:

""

methods

public abstract Method[] methods

methods support

Default:

{}

id

public abstract String id

The id

Returns:

default value is empty

Since:

2.7.3

Default:

""