Cluster Expansion
Expansion Description
When there are multiple service providers, organize multiple service providers into a cluster and pretend to be one provider.
Extension ports
org.apache.dubbo.rpc.cluster.Cluster
Extended configuration
<dubbo:protocol cluster="xxx" />
<!-- Default value configuration, if <dubbo:protocol> is not configured with cluster, use this configuration -->
<dubbo:provider cluster="xxx" />
Known extensions
org.apache.dubbo.rpc.cluster.support.wrapper.MockClusterWrapperorg.apache.dubbo.rpc.cluster.support.FailoverClusterorg.apache.dubbo.rpc.cluster.support.FailfastClusterorg.apache.dubbo.rpc.cluster.support.FailsafeClusterorg.apache.dubbo.rpc.cluster.support.FailbackClusterorg.apache.dubbo.rpc.cluster.support.ForkingClusterorg.apache.dubbo.rpc.cluster.support.AvailableClusterorg.apache.dubbo.rpc.cluster.support.MergeableClusterorg.apache.dubbo.rpc.cluster.support.BroadcastClusterorg.apache.dubbo.rpc.cluster.support.registry.ZoneAwareCluster
Extended example
Maven project structure:
src
 |-main
    |-java
        |-com
            |-xxx
                |-XxxCluster.java (implements the Cluster interface)
    |-resources
        |-META-INF
            |-dubbo
                |-org.apache.dubbo.rpc.cluster.Cluster (plain text file, content: xxx=com.xxx.XxxCluster)
XxxCluster.java:
package com.xxx;
 
import org.apache.dubbo.rpc.cluster.Cluster;
import org.apache.dubbo.rpc.cluster.support.AbstractClusterInvoker;
import org.apache.dubbo.rpc.cluster.Directory;
import org.apache.dubbo.rpc.cluster.LoadBalance;
import org.apache.dubbo.rpc.Invoker;
import org.apache.dubbo.rpc.Invocation;
import org.apache.dubbo.rpc.Result;
import org.apache.dubbo.rpc.RpcException;
 
public class XxxCluster implements Cluster {
    public <T> Invoker<T> merge(Directory<T> directory) throws RpcException {
        return new AbstractClusterInvoker<T>(directory) {
            public Result doInvoke(Invocation invocation, List<Invoker<T>> invokers, LoadBalance loadbalance) throws RpcException {
                //...
            }
        };
    }
}
META-INF/dubbo/org.apache.dubbo.rpc.cluster.Cluster:
xxx=com.xxx.XxxCluster
Last modified January 2, 2023: Enhance en docs (#1798) (95a9f4f6c1)
