package com.midm.model.org;
import com.midm.model.file.BaseFile;
import com.mitac.cell.io.McFile;
import java.util.Date;
import java.util.UUID;
import org.springframework.data.mongodb.core.mapping.DBRef;
import org.springframework.data.mongodb.core.mapping.Document;
/**
* 【MongoDB 文档实体】{@code SiteFile}
*
* 类职责:
*
* - 作为 MongoDB 集合文档,承载该领域对象的持久化字段与索引。
* - 通过字段/依赖注入持有运行期状态,字段含义见下方“核心字段”。
*
*
* 核心字段(按声明顺序):
*
* - {@code category}(String):字段 category
* - {@code forWhat}(String):用于What
* - {@code requested}(Date):时间字段
* - {@code expiry}(Date):时间字段
* - {@code siteName}(String):站点名称
* - {@code requestedFrom}(User):requested从
*
*
* 协作对象:{@code User}。
*
* 持久化/框架标记:{@code @Document} 映射为 MongoDB 集合。
*
* 学习提示:先看字段与 @Field/@Indexed,再看对应 Service/Repository 如何构造查询条件。
*/
@Document
public class SiteFile extends BaseFile {
/**
* 字段 category。
*/
private String category;
/**
* 用于What。
*/
private String forWhat;
/**
* 时间字段。
*/
private Date requested;
/**
* 时间字段。
*/
private Date expiry;
/**
* 站点名称。
*/
private String siteName;
/**
* requested从;以 DBRef 引用其他文档。
*
* 注解:{@code @DBRef}。
*/
@DBRef
private User requestedFrom;
/**
* 构造 {@code SiteFile} 实例。
* 使用默认字段值,后续通常由 Spring/Mongo 或调用方填充。
*/
public SiteFile() {
}
/**
* 构造 {@code SiteFile} 实例。
*
* @param requestedFrom 参数 {@code requestedFrom}({@code User})
* @param fileUuid 文件 UUID({@code UUID})
* @param file 文件({@code McFile})
*/
public SiteFile(User requestedFrom, UUID fileUuid, McFile file) {
this.setUserUuid(requestedFrom);
this.setFileUuid(fileUuid);
this.setFileInfo(file);
}
/**
* 获取 {@code category}。
* @return 字符串结果
*/
public String getCategory() {
return this.category;
}
/**
* 设置 {@code category}。
*
* @param category 分类(app/ota/other/report 等)({@code String})
*/
public void setCategory(String category) {
this.category = category;
}
/**
* 获取 {@code requestedFrom}。
* @return 用户对象;未找到时返回 {@code null}
*/
public User getRequestedFrom() {
return this.requestedFrom;
}
/**
* 设置 {@code requestedFrom}。
*
* @param requestedFrom 参数 {@code requestedFrom}({@code User})
*/
public void setRequestedFrom(User requestedFrom) {
this.requestedFrom = requestedFrom;
}
/**
* 获取 {@code requested}。
* @return 字段/派生属性 {@code requested} 的值
*/
public Date getRequested() {
return this.requested;
}
/**
* 设置 {@code requested}。
*
* @param requested 参数 {@code requested}({@code Date})
*/
public void setRequested(Date requested) {
this.requested = requested;
}
/**
* 获取 {@code expiry}。
* @return 字段/派生属性 {@code expiry} 的值
*/
public Date getExpiry() {
return this.expiry;
}
/**
* 设置 {@code expiry}。
*
* @param expiry 参数 {@code expiry}({@code Date})
*/
public void setExpiry(Date expiry) {
this.expiry = expiry;
}
/**
* 获取 {@code siteName}。
* @return 字符串结果
*/
public String getSiteName() {
return this.siteName;
}
/**
* 设置 {@code siteName}。
*
* @param siteName 参数 {@code siteName}({@code String})
*/
public void setSiteName(String siteName) {
this.siteName = siteName;
}
/**
* 获取 {@code forWhat}。
* @return 字符串结果
*/
public String getForWhat() {
return this.forWhat;
}
/**
* 设置 {@code forWhat}。
*
* @param forWhat 参数 {@code forWhat}({@code String})
*/
public void setForWhat(String forWhat) {
this.forWhat = forWhat;
}
}