<T extends Model> T newInstance()

创建Model的实例对象.

结果:

• 返回创建的Model实例对象

<T extends Model> T newInstance(Object id)

创建Model的实例对象,并给该对象的id设置值.

参数:

• id:创建的实例对象的id

结果:

• 返回创建的Model实例对象

Dao dao()

返回当前Model类的dao对象

结果:

• 返回当前Model类的dao对象

Dmo dmo()

返回当前Model类的dmo对象

结果:

• 返回当前Model类的dmo对象

EntityMapping metamodel()

返回当前Model类的实体映射对象,这个对象用于记录Model类和数据库表的映射关系

结果:

• 返回当前Model类的实体映射对象

Db db()

返回当前Model类的Db对象,这个对象表示的是数据库对象,包含了数据库的信息

结果:

• 返回当前Model类的Db对象

long count()

返回当前Model类对应数据库表的记录数

结果:

• 返回当前Model类对应的数据库表记录行数

String getEntityName()

获取Model类的类名

结果:

• 返回Model类名

boolean contains(String field)

检验Model类是否包含指定属性

参数:

• field:需要校验的属性名

结果:

• 如果Model类包含属性field则返回true,否则返回false

Object get(String field)

从model对象中获取指定属性名的属性值.

这里要特别注意,这个属性值并不一定是Model类中显式声明的属性值,举例如下:

public class model1 extends Model{
    private String id;
    private String name;

    // 省略get和set方法
}
public class model2 extends Model{
    private String id;
    private Integer age;

    // 省略get和set方法
}

假设我们执行sql如下:

SELECT m.name,m.id,n.age FROM model1 m JOIN model2 n ON m.id=n.id

将最终返回的结果解析到List<Model1> list中的话,我们会发现,n.age的属性通过model1的实例属性是无法获取的,这个时候我们就可以通过这个方法来获取了:

model1.get("age")

此时就可以获得这个字段的查询结果了.

另外,如下两个方式获取字段值的结果是等价的:

model1.getName();
model1.get("name");

参数:

• field:需要获取值的属性名

结果:

• 属性field的值

Object get(Named field)

效果与Object get(String field)一致,参数类型不同而已.

参数:

• field:Named的实例对象,Named是一个接口,这个实例对象的field.getName()返回属性名.

结果:

• 属性field的值

String getString(String field)

获取属性field的值并转换成String类型返回

参数:

• field:属性名.

结果:

• 属性field的值

Integer getInteger(String field)

获取属性field的值并转换成Integer类型返回

参数:

• field:属性名.

结果:

• 属性field的值

Map<String, Object> fields()

以Map的方式返回Model对象实例的所有属性值(包括没有显式声明但是有设置的值),这里返回的是属性副本,对这个副本的操作不会影响model实例对象.

结果:

• Model实例对象的所有属性值.

Object id()

返回Model实例对象的id

结果:

• Model实例对象的id

<T extends Model> T id(Object id)

设置Model实例对象的id

结果:

• Model实例对象本身

<T extends Model> T set(String field,Object value)

设置Model实例对象的属性,这个属性不一定是要Model类显式声明的属性.

参数:

• field:要设置的属性名
• value:要设置的属性值

结果:

• 返回Model实例对象本身

Timestamp createdAt()

返回Model实例对象的创建时间,如果实例对象没有createdAt属性则抛出异常

结果:

返回Model实例对象的createdAt属性值

Timestamp updatedAt()

返回Model实例对象的创建时间,如果实例对象没有updatedAt属性则抛出异常

结果:

• 返回Model实例对象的updatedAt属性值

<T extends Model> T set(Named field,Object value)

与<T extends Model> T set(String field,Object value)类似

<T extends Model> T setAll(Map<String,? extends Object> fields)

同时设置多个属性值到Model的实例对象中,效果与多次调用<T extends Model> T set(String field,Object value)相同

boolean refresh()

刷新Model实例对象,重新从数据库读取各属性的值.

结果:

• 刷新成功则返回true.

boolean validate()

根据Model类的字段限制(@Column注解或者数据库字段的其他限制)校验Model实例对象.

结果:

• 校验不通过则返回false,通过则返回true

Errors errors()

返回Model的校验出错的结果,当调用validate()等校验方法时,如果校验失败,就会将校验失败的信息放到这个error对象中.

结果:

• Model实例对象校验失败的错误信息

boolean validate(int maxErrors)

根据Model类的字段限制(@Column注解或者数据库字段的其他限制)校验Model实例对象.

参数:

maxErrors:最大校验失败数

结果:

• 校验不通过的属性值大于maxErrors时返回false,反之这返回true

Object getProperty(String name)

与Object get(String field)效果相同

void setProperty(String name, Object value)

与<T extends Model> T set(String field,Object value)效果相同,但是没有返回值

Map<String, Object> getProperties()

与Map<String, Object> fields()效果相同