Microservices Engine:Configure HTTP-to-Dubbo conversion

Procedure

1. Log on to the MSE console. In the top navigation bar, select a region.

2. In the left-side navigation pane, choose Cloud-native Gateway > Gateways. On the Gateways page, click the name of the gateway.

3. In the left-side navigation pane, click Routes, and click the Routes tab.

4. In the upper-left corner of the page that appears, click Add Route. In the Add Route panel, configure the parameters. The following table describes protocol conversion parameters.

   Parameter	Description
   Dubbo Service Name	The full name of the Dubbo service.
   Service Version	The version of the Dubbo service. If no version is configured for the backend service, this parameter is set to 0.0.0 by default.
   Service Group	The group of the Dubbo service. You can leave the parameter empty if no group is configured for the backend service.
   Method Mapping Note The mapping rules of a Dubbo method. You can click +Method Mapping to configure multiple method mapping rules. The Method Mapping parameter contains the following configuration items:
   Dubbo Method Name	The full name of the Dubbo method.
   HTTP Method	The Method parameter in the HTTP request.
   Method Match Path	The match path parameter. You must specify this parameter based on the path that you specified for prefix match. For example, if the prefix match path is /dubboDemo, you need to enter the method match path based on the /dubboDemo path, such as /dubboDemo/hello.
   Header Pass-through Type	Specifies whether to pass through HTTP request headers as implicit parameters to the backend Dubbo service based on the Attachment mechanism. Valid values: Pass-through of All Headers No Pass-through Pass-through of Specific Headers: Separate multiple header keys with commas (,). Example: content-length,content-type.
   Parameter Mapping	The parameter mapping rule of the Dubbo method. The parameters of the Dubbo method are extracted from the HTTP request. The extracted parameters are in the key-value format. You can click + Parameter Mapping to add multiple parameter mapping rules. Input Parameter Location: the location from which the parameters are extracted in an HTTP request. Valid values: Request Parameter: extracted from the Query parameter in the HTTP request. Request Header: extracted from the HTTP request header. Request Path: extracted from the path in the HTTP request. Request Body: extracted from the body of the HTTP request. Extract Key: the key of the current parameter. Backend Parameter Type: the full type name of the current parameter. The following Java types are supported based on specifications: java.lang.String java.lang.Long java.lang.Double java.lang.Boolean java.util.List java.util.Map Custom types, such as org.apache.dubbo.samples.basic.api.DubboTest Important Parameters of the java.util.List, java.util.Map, or a custom type can be extracted only from request bodies.

Examples

This section provides configuration examples to describe how to initiate HTTP requests to access Dubbo services by using HTTP-to-Dubbo conversion.

package com.alibaba.nacos.example.dubbo.service;
import java.util.List;
import java.util.Map;
public interface DemoService {
    String sayHello(String name);
    String echoList(List<String> input);
    String echoMap(Map<String, String> map);
    String echoPerson(Person p);
}

package com.alibaba.nacos.example.dubbo.service;
import java.io.Serializable;
public class Person implements Serializable {
    public String name;
    public String second_name;
    public int age;
}

curl "http://xxx.xxx.xxx/dubboDemo/hello?param1=abcd"

curl "http://xxx.xxx.xxx/dubboDemo/hello" -H "param1: abcd"

curl "http://xxx.xxx.xxx/dubboDemo/hello/abcd"

curl "http://xxx.xxx.xxx/dubboDemo/hello/" -X POST -d '{"param1": "abcd"}'

curl "http://xxx.xxx.xxx/dubboDemo/echolist/" -X POST -d '{"param1": ["abc", "def", "ghi"]}'

curl "http://xxx.xxx.xxx/dubboDemo/echomap/" -X POST -d '{"param1": {"key1": "value1", "key2": "value2", "key3": "value3"}}'

curl "http://xxx.xxx.xxx/dubboDemo/echoperson/" -X POST -d '{"param1": {"name": "Tom", "second_name": "John", "age": 21}}'