YMP 온라인 매뉴얼 / 数据实体操作

数据实体操作

上面阐述的是基于ISession会话对象完成一系列数据库操作,接下来介绍的操作过程更加简单直接,完全基于数据实体对象;

注意:本小节所指的数据实体对象必须通过继承框架提供BaseEntity抽象类;

插入(Insert)
User _user = new User();
_user.setId(UUIDUtils.UUID());
_user.setUsername("suninformation");
_user.setPwd(DigestUtils.md5Hex("123456"));
_user.setAge(20);
_user.setSex("F");
// 执行数据插入
_user.save();

// 或者在插入时也可以指定/排除某些字段
_user.save(Fields.create(User.FIELDS.SEX, User.FIELDS.AGE).excluded(true));

// 或者插入前判断记录是否已存在,若已存在则执行记录更新操作
_user.saveOrUpdate();

// 或者执行记录更新操作时仅更新指定的字段
_user.saveOrUpdate(Fields.create(User.FIELDS.SEX, User.FIELDS.AGE));
更新(Update)
User _user = new User();
_user.setId("bc19f5645aa9438089c5e9954e5f1ac5");
_user.setPwd(DigestUtils.md5Hex("654321"));
_user.setAge(20);
_user.setSex("F");
// 执行记录更新
_user.update();

// 或者仅更新指定的字段
_user.update(Fields.create(User.FIELDS.SEX, User.FIELDS.AGE));
查询(Find)
  • 根据记录ID加载:

    User _user = new User();
    _user.setId("bc19f5645aa9438089c5e9954e5f1ac5");
    // 根据记录ID加载全部字段
    _user = _user.load();
    
    // 或者根据记录ID加载指定的字段
    _user = _user.load(Fields.create(User.FIELDS.USER_NAME, User.FIELDS.SEX, User.FIELDS.AGE));
  • 通过数据实体设置条件(非空属性之间将使用and条件连接),查询所有符合条件的记录;

    User _user = new User();
    _user.setUsername("suninformation");
    _user.setPwd(DigestUtils.md5Hex("123456"));
    // 返回所有字段
    IResultSet<User> _users = _user.find();
    
    // 或者返回指定的字段
    _users = _user.find(Fields.create(User.FIELDS.ID, User.FIELDS.AGE));
    
    // 或者分页查询
    _users = _user.find(Page.create(1).pageSize(10));
  • 分页查询:

    User _user = new User();
    _user.setSex("F");
    
    // 分页查询,返回全部字段
    IResultSet<User> _users = _user.find(Page.create(1).pageSize(10));
    
    // 或者分页查询,返回指定的字段
    _users = _user.find(Fields.create(User.FIELDS.ID, User.FIELDS.AGE), Page.create(1).pageSize(10));
  • 仅返回符合条件的第一条记录(FindFirst):

    User _user = new User();
    _user.setUsername("suninformation");
    _user.setPwd(DigestUtils.md5Hex("123456"));
    
    // 返回与用户名称和密码匹配的第一条记录
    _user = _user.findFirst();
    
    // 或者返回与用户名称和密码匹配的第一条记录的ID和AGE字段
    _user = _user.findFirst(Fields.create(User.FIELDS.ID, User.FIELDS.AGE));
删除(Delete)
User _user = new User();
_user.setId("bc19f5645aa9438089c5e9954e5f1ac5");

// 根据实体主键删除记录
_user.delete();

:以上介绍的两种数据库操作方式各有特点,请根据实际情况选择更适合的方式,亦可混合使用;