From 7b34921445b290f1bed08323abb793e68d57f7a7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=B8=85?= <1474983351@qq.com>
Date: Fri, 4 Oct 2024 21:28:05 +0800
Subject: [PATCH] =?UTF-8?q?style:=20=E4=B8=BA=E6=9C=89=E4=BA=89=E8=AE=AE?=
 =?UTF-8?q?=E7=9A=84=20API=20=E6=B7=BB=E5=8A=A0=E6=B3=A8=E9=87=8A=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../mybatisflex/core/query/QueryWrapper.java  | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/mybatis-flex-core/src/main/java/com/mybatisflex/core/query/QueryWrapper.java b/mybatis-flex-core/src/main/java/com/mybatisflex/core/query/QueryWrapper.java
index 9d0f41d3..f58837cd 100644
--- a/mybatis-flex-core/src/main/java/com/mybatisflex/core/query/QueryWrapper.java
+++ b/mybatis-flex-core/src/main/java/com/mybatisflex/core/query/QueryWrapper.java
@@ -241,6 +241,35 @@ public class QueryWrapper extends BaseQueryWrapper<QueryWrapper> {
         return from(new SelectQueryTable(queryWrapper));
     }
 
+    /**
+     * <p>为 FROM 语句后的第一个表起别名，而不是为整个 SELECT 语句起别名。
+     *
+     * <p>例如：以下示例，
+     *
+     * <p><pre>{@code
+     * QueryWrapper.create().from(ACCOUNT).as("a");
+     * }</pre>
+     *
+     * <p>等价于，
+     *
+     * <p><pre>{@code
+     * QueryWrapper.create().from(ACCOUNT.as("a"));
+     * }</pre>
+     *
+     * <p>最终生成的 SQL 为，
+     * <p><pre>{@code
+     * SELECT a.* FROM tb_account a
+     * }</pre>
+     *
+     * <p>而不是，
+     *
+     * <p><pre>{@code
+     * (SELECT * FROM tb_account) AS "a"
+     * }</pre>
+     *
+     * @param alias 别名
+     * @return 当前查询包装器
+     */
     public QueryWrapper as(String alias) {
         if (CollectionUtil.isEmpty(queryTables)) {
             throw new IllegalArgumentException("query table must not be empty.");