public URL(String protocol,
           String username,
           String password,
           String host,
           int port,
           String path,
           Map<String, String> parameters,
           Map<String, Map<String, String>> methodParameters) {
    if (StringUtils.isEmpty(username)
        && StringUtils.isNotEmpty(password)) {
        throw new IllegalArgumentException("Invalid url, password without username!");
    }
    this.protocol = protocol;
    this.username = username;
    this.password = password;
    this.host = host;
    this.port = Math.max(port, 0);
    this.address = getAddress(this.host, this.port);

    // trim the beginning "/"
    while (path != null && path.startsWith("/")) {
        path = path.substring(1);
    }
    this.path = path;
    if (parameters == null) {
        parameters = new HashMap<>();
    } else {
        parameters = new HashMap<>(parameters);
    }
    this.parameters = Collections.unmodifiableMap(parameters);
    this.methodParameters = Collections.unmodifiableMap(methodParameters);
}

可以看到，Dubbo对于URL的核心封装，基本与互联网中的URL封装是一致的。

在Dubbo的dubbo-common模块提供了处理URL的工具类：URLBuilder和URLStrParser。如下所示。

这两个类的实现还是比较简单的，小伙伴们可以自行阅读Dubbo的源码。

接下来，我们一起来看看在Dubbo内部，URL是如何实现统一契约的？

Dubbo中URL的实际应用

这里，我们主要通过三方面来简单聊聊URL在Dubbo内部的实际应用：

• URL在SPI中的应用。
• URL在服务注册中的应用。
• URL在服务发现中的应用。

URL在SPI中的应用

稍微了解过Dubbo的小伙伴都知道，Dubbo具有高度的可扩展性，而这种扩展性是基于Dubbo自身的SPI来实现的。在Dubbo实现的SPI中，URL又起到了非常重要的作用。

在Dubbo SPI的实现中，一个典型的场景就是被@Adaptive注解修饰的接口方法，例如，在dubbo-registry-api 模块中的RegistryFactory接口中的getRegistry()方法上被@Adaptive({"protocol"})注解修饰。如下所示。

说明RegistryFactory接口中的getRegistry()方法是一个适配器方法，Dubbo在运行的过程中，会为getRegistry()方法动态生成RegistryFactory$Adaptive类型。例如，生成的RegistryFactory$Adaptive类型如下所示。

public class RegistryFactory$Adaptive
              implements RegistryFactory { 
    public Registry getRegistry(org.apache.dubbo.common.URL arg0) { 
        if (arg0 == null) throw new IllegalArgumentException(""); 
        org.apache.dubbo.common.URL url = arg0; 
        String extName = (url.getProtocol() == null ? "dubbo" :  url.getProtocol()); 
        if (extName == null) 
            throw new IllegalStateException(""); 
        RegistryFactory extension = (RegistryFactory) ExtensionLoader.getExtensionLoader(RegistryFactory.class).getExtension(extName); 
        return extension.getRegistry(arg0); 
    } 
}

consumer://192.168.175.1/org.apache.dubbo.demo.DemoService?application=dubbo-demo-annotation-consumer&category=providers,configurators,routers&dubbo=2.0.2&init=false&interface=org.apache.dubbo.demo.DemoService&methods=sayHello,sayHelloAsync&pid=15184&side=consumer&sticky=false&timestamp=1610860963037