查詢（Query）

本節主要介紹YMP框架v2版本中新增的特性，輔助開發人員像寫Java程式碼一樣編寫SQL語句，在一定程度上取代傳統字串拼接的模式，再配合資料實體的字段常數一起使用，這樣做的好處就是降低字串拼接過程中出錯的機率，一些特定問題編譯期間就能發現，因為Java程式碼就是SQL語句！

基礎參數物件

Fields：欄位名稱集合對象，用於輔助拼接資料表欄位名稱，支援前綴、別名等；

範例程式碼：

// 创建Fields对象
Fields _fields = Fields.create("username", "pwd", "age");
// 带前缀和别名
_fields.add("u", "sex", "s");
// 带前缀
_fields = Fields.create().add("u", "id").add(_fields);
// 标记集合中的字段为排除的
_fields.excluded(true);
// 判断是否存在排除标记
_fields.isExcluded();
// 输出
System.out.println(_fields.fields());

執行結果：

[u.id, username, pwd, age, u.sex s]

Params：參數集合對象，主要用於儲存替換SQL語句中?號佔位符；

#範例程式碼：

// 创建Params对象，任何类型参数
Params _params = Params.create("p1", 2, false, 0.1).add("param");
// 
_params = Params.create().add("paramN").add(_params);
// 输出
System.out.println(_params.params());

執行結果：

[paramN, p1, 2, false, 0.1, param]

#Pages：分頁參數物件；

範例程式碼：

// 查询每1页, 默认每页20条记录
Page.create(1);
// 查询第1页, 每页10条记录
Page.create(1).pageSize(10);
// 查询第1页, 每页10条记录, 不统计总记录数
Page.create(1).pageSize(10).count(false);

Cond：條件參數對象，用於產生SQL條件和儲存條件參數；

範例程式碼：

產生如下SQL條件：
(username like ? and age >= ?) or (sex = ? and age < ?)

Cond _cond = Cond.create()
    .bracketBegin().like("username").param("%ymp%").and().gtEq("age").param(20).bracketEnd()
    .or()
    .bracketBegin().eq("sex").param("F").and().lt("age").param(18).bracketEnd();

System.out.println("SQL: " + _cond.toString());
System.out.println("参数: " + _cond.params().params());

執行結果：

SQL: ( username LIKE ? AND age >= ? )  OR  ( sex = ? AND age < ? ) 
参数: [%ymp%, 20, F, 18]

OrderBy：排序對象，用於產生SQL條件中的Order By語句；

範例程式碼：

OrderBy _orderBy = OrderBy.create().asc("age").desc("u", "birthday");
//
System.out.println(_orderBy.toSQL());

執行結果：

ORDER BY age, u.birthday DESC

GroupBy：分組對象，用於產生SQL條件中的Group By語句；

範例程式碼：

GroupBy _groupBy = GroupBy.create(Fields.create().add("u", "sex").add("dept"))
    .having(Cond.create().lt("age").param(18));

System.out.println("SQL: " + _groupBy.toString());
System.out.println("参数: " + _groupBy.having().params().params());

執行結果：

SQL: GROUP BY u.sex, dept HAVING age < ?
参数: [18]

#Where：Where語句對象，用於產生SQL語句中的Where子句；

範例程式碼：

Cond _cond = Cond.create()
        .like("username").param("%ymp%")
        .and().gtEq("age").param(20);

OrderBy _orderBy = OrderBy.create().asc("age").desc("u", "birthday");

GroupBy _groupBy = GroupBy.create(Fields.create().add("u", "sex").add("dept"));

Where _where = Where.create(_cond).groupBy(_groupBy).orderDesc("username");

_where.orderBy().orderBy(_orderBy);
//
System.out.println("SQL: " + _where.toString());
System.out.println("参数: " + _where.getParams().params());

執行結果：（為方便閱讀，此處美化了SQL的輸出格式: P）

SQL: WHERE
         username LIKE ?
     AND age >= ?
     GROUP BY
         u.sex,
         dept
     ORDER BY
         username DESC,
         age,
         u.birthday DESC
参数: [%ymp%, 20]

Join：連接語句對象，用於產生SQL語句中的Join子句，支援left、right和inner連接；

範例程式碼：

Join _join = Join.inner("user_ext").alias("ue")
    .on(Cond.create().opt("ue", "uid", Cond.OPT.EQ, "u", "id"));

System.out.println(_join);

#執行結果：

INNER JOIN user_ext ue ON ue.uid = u.id

##Union：聯合語句對象，用於將多個Select查詢結果合併；

Select _select = Select.create("user").where(Where.create(Cond.create().eq("dept").param("IT")))
        .union(Union.create(
                Select.create("user").where(Where.create(Cond.create().lt("age").param(18)))));
//
System.out.println("SQL: " + _select.toString());
System.out.println("参数: " + _select.getParams().params());

執行結果：

SQL: SELECT  *  FROM user WHERE dept = ?  UNION SELECT  *  FROM user WHERE age < ?   
参数: [IT, 18]

#Select：查詢語句物件

#########################################################################

示例代码：

    Cond _cond = Cond.create()
            .like("u", "username").param("%ymp%")
            .and().gtEq("u", "age").param(20);
    //
    GroupBy _groupBy = GroupBy.create(Fields.create().add("u", "sex").add("u", "dept"));
    //
    Where _where = Where.create(_cond).groupBy(_groupBy).orderDesc("u", "username");
    //
    Join _join = Join.inner("user_ext").alias("ue")
            .on(Cond.create().opt("ue", "uid", Cond.OPT.EQ, "u", "id"));
    //
    Select _select = Select.create(User.class, "u")
            .field("u", "username").field("ue", "money")
            .where(_where)
            .join(_join)
            .distinct();
    //
    System.out.println("SQL: " + _select.toString());
    System.out.println("参数: " + _select.getParams().params());

执行结果：（为方便阅读，此处美化了SQL的输出格式:P）

    SQL: SELECT DISTINCT
                u.username,
                ue.money
            FROM
                USER u
            INNER JOIN user_ext ue ON ue.uid = u.id
            WHERE
                u.username LIKE ?
            AND u.age >= ?
            GROUP BY
                u.sex,
                u.dept
            ORDER BY
                u.username DESC 
    参数: [%ymp%, 20]

###############Insert：插入語句物件##########

示例代码：

    Insert _insert = Insert.create(User.class)
            .field(User.FIELDS.ID).param("123456")
            .field(User.FIELDS.AGE).param(18)
            .field(User.FIELDS.USER_NAME).param("suninformation");
    //
    System.out.println("SQL: " + _insert.toString());
    System.out.println("参数: " + _insert.params().params());

执行结果：

    SQL: INSERT INTO user (id, age, username) VALUES (?, ?, ?)
    参数: [123456, 18, suninformation]

######

Update：更新語句物件

示例代码：

    Update _update = Update.create(User.class)
            .field(User.FIELDS.PWD).param("xxxx")
            .field(User.FIELDS.AGE).param(20)
            .where(Where.create(
                    Cond.create().eq(User.FIELDS.ID).param("123456")));
    //
    System.out.println("SQL: " + _update.toString());
    System.out.println("参数: " + _update.getParams().params());

执行结果：

    SQL: UPDATE user SET pwd = ?, age = ? WHERE id = ? 
    参数: [xxxx, 20, 123456]

Delete：刪除語句物件

示例代码：

    Delete _delete = Delete.create(User.class)
            .where(Where.create(
                    Cond.create().eq(User.FIELDS.ID).param("123456")));
    //
    System.out.println("SQL: " + _delete.toString());
    System.out.println("参数: " + _delete.getParams().params());

执行结果：

    SQL: DELETE  FROM user WHERE id = ? 
    参数: [123456]

SQL：自訂SQL語句

同時也用於ISession會話介面參數封裝；

範例程式碼：

// 自定义SQL语句
SQL _sql = SQL.create("select * from user where age > ? and username like ?").param(18).param("%ymp%");
// 执行
session.find(_sql, IResultSetHandler.ARRAY);

// 或封装语句对象
SQL.create(_select);
SQL.create(_insert);
SQL.create(_update);
SQL.create(_delete);

BatchSQL：批次SQL語句物件

主要用於ISession會話對批次操作的參數封裝；

範例程式碼：

// 定义批操作
BatchSQL _sqls = BatchSQL.create("INSERT INTO user (id, age, username) VALUES (?, ?, ?)")
        .addParameter(Params.create("xxxx", 18, "user0"))
        .addParameter(Params.create("xxx1", 20, "user1"))
        .addParameter(Params.create("xxxN", 20, "userN"))
        .addSQL("DELETE  FROM user WHERE age > 30")
        .addSQL("DELETE  FROM user WHERE age < 18");
// 执行
session.executeForUpdate(_sqls);

#EntitySQL：實體參數封裝物件

主要用於ISession會話的參數封裝；

範例程式碼：

session.find(EntitySQL.create(User.class)
            .field(Fields.create(User.FIELDS.ID, User.FIELDS.USER_NAME)
                    .excluded(true)));

查詢（Query）

基礎參數物件

Update：更新語句物件

Delete：刪除語句物件

SQL：自訂SQL語句

BatchSQL：批次SQL語句物件

#EntitySQL：實體參數封裝物件

PHP中文網