Merge branch 'feature/yg/meego-6739740273-endpoint-standard-resolver' into 'integration_2025-11-06_1076839247618'

feat: [development task] core (1806269)

See merge request iaasng/volcengine-java-sdk!730

Author: BitsAdmin

SDK_Integration_zh.md

@@ -17,6 +17,7 @@
   - [自定义RegionId](#自定义regionid)
   - [自动化Endpoint寻址](#自动化endpoint寻址)
     - [Endpoint默认寻址逻辑](#endpoint默认寻址)
+    - [Endpoint标准寻址](#endpoint标准寻址)
 - [HTTP连接池配置](#http连接池配置)
 - [HTTPS请求配置](#https请求配置)
   - [指定Scheme](#指定scheme)
@@ -254,7 +255,7 @@ public class SampleCode {
 >   默认支持自动寻址，无需手动指定Endpoint
 
 为了简化用户配置，Vocoengine 提供了灵活的 Endpoint 自动寻址机制。用户无需手动指定服务地址，SDK 会根据服务名称、区域（Region）等信息自动拼接出合理的访问地址，并支持用户自定义DualStack（双栈）支持。  
-### Endpoint默认寻址 
+### Endpoint默认寻址
 **Endpoint默认寻址逻辑**
 1. 是否自动寻址Region  
 内置自动寻址Region列表代码:[./volcengine-java-sdk-core/src/main/java/com/volcengine/endpoint/DefaultEndpointProvider.java#BOOTSTRAP_REGION](./volcengine-java-sdk-core/src/main/java/com/volcengine/endpoint/DefaultEndpointProvider.java#L25)  
@@ -294,6 +295,39 @@ public class SampleCode {
 }
 ```
 
+### Endpoint标准寻址
+**标准寻址规则**
+
+| Global服务 | 双栈 | 格式                                                                                                               |
+|----------|----|------------------------------------------------------------------------------------------------------------------|
+| 是        | 是  | `{Service}.volcengine-api.com`                                                                                   |
+| 是        | 否  | `{Service}.volcengineapi.com`                                                                                    |
+| 否        | 是  | `{Service}.{region}.volcengine-api.com`|
+| 否        | 否  | `{Service}.{region}.volcengineapi.com` |
+**代码示例：**
+
+是否global服务根据具体调用的服务决定的，是否global无法修改的。  
+可以参考列表：[./volcengine-java-sdk-core/src/main/java/com/volcengine/endpoint/StandardEndpointProvider.java#SERVICE_INFOS](./volcengine-java-sdk-core/src/main/java/com/volcengine/endpoint/StandardEndpointProvider.java#L142)
+```java
+import com.volcengine.ApiClient;
+import com.volcengine.sign.Credentials;
+import java.util.HashSet;
+import com.volcengine.endpoint.StandardEndpointProvider;
+
+public class SampleCode {
+  public static void main(String[] args) {
+    String regionId = "cn-beijing";
+    ApiClient apiClient = new ApiClient()
+            .setCredentials(Credentials.getEnvCredentials())
+            .setEndpointResolver(new StandardEndpointProvider()) // 设置标准寻址
+            .setRegion(regionId) // 设置region
+            .setUseDualStack(true); // 设置是否双栈
+  }
+}
+```
+
+
+
 # Http连接池配置
 
 > **默认**