kevin
f307781f58
- 48 个 Go 文件所有注释（行注释/块注释/行尾注释，含 _test.go）翻译为中文 - 保留技术标识符：SECURITY_TODO(n)、unsafe-inline、sqlite/mysql、路由参数等 - 代码、字符串字面量、日志消息保持英文原文，零逻辑改动 - go build/vet 通过，go test -count=1 ./... 全绿
46 lines
2.1 KiB
Go
46 lines
2.1 KiB
Go
package models
|
||
|
||
import (
|
||
"time"
|
||
|
||
"gorm.io/gorm"
|
||
)
|
||
|
||
// Attachment 表示附加到文章的文件。
|
||
//
|
||
// 生命周期（方案 A——先上传后绑定）：
|
||
// - 在文章创建页面上文章尚不存在，因此 ArticleID 为 0，
|
||
// 该行暂时由 SessionToken（为页面会话生成的随机值）持有。
|
||
// - 保存文章时，ArticleCreate 通过 SessionToken 绑定待处理行，
|
||
// 设置它们的 ArticleID 并清除令牌。
|
||
// - 在编辑页面上，上传直接携带真实的 ArticleID。
|
||
//
|
||
// 磁盘去重：StoredName 是文件内容的 SHA-256。写入前，
|
||
// 处理器会检查磁盘上是否已存在同名文件；若已存在则复用（不重写）。
|
||
// 删除采用引用计数——仅当没有任何 Attachment 行引用时，才删除磁盘文件。
|
||
type Attachment struct {
|
||
ID uint `gorm:"primarykey" json:"id"`
|
||
ArticleID uint `gorm:"index" json:"article_id"` // 在创建页面上待绑定时为 0
|
||
SessionToken string `gorm:"size:64;index" json:"-"` // 创建页面上的临时归属令牌
|
||
UploaderID uint `gorm:"index" json:"uploader_id"`
|
||
Filename string `gorm:"size:255" json:"filename"` // 原始文件名
|
||
StoredName string `gorm:"size:64;index" json:"stored_name"` // SHA-256 十六进制字符串，磁盘文件名
|
||
Ext string `gorm:"size:32" json:"ext"`
|
||
MIME string `gorm:"size:128" json:"mime"`
|
||
Size int64 `gorm:"default:0" json:"size"`
|
||
Category string `gorm:"size:32" json:"category"` // image/document/archive/video/other
|
||
CreatedAt time.Time `json:"created_at"`
|
||
UpdatedAt time.Time `json:"updated_at"`
|
||
DeletedAt gorm.DeletedAt `gorm:"index" json:"deleted_at"`
|
||
}
|
||
|
||
// TableName 覆盖 GORM 默认的表名。
|
||
func (Attachment) TableName() string {
|
||
return "attachments"
|
||
}
|
||
|
||
// IsImage 报告该附件是否为图片（用于决定 Markdown 插入形式：![]() 还是 []()）。
|
||
func (a *Attachment) IsImage() bool {
|
||
return a.Category == CategoryImage
|
||
}
|