feat: 信令跟踪功能接口

src/modules/trace/controller/packet.go

@@ -0,0 +1,111 @@
+package controller
+
+import (
+	"be.ems/src/framework/i18n"
+	"be.ems/src/framework/utils/ctx"
+	"be.ems/src/framework/vo/result"
+	traceService "be.ems/src/modules/trace/service"
+	"github.com/gin-gonic/gin"
+	"github.com/gin-gonic/gin/binding"
+)
+
+// 实例化控制层 PacketController 结构体
+var NewPacket = &PacketController{
+	packetService: traceService.NewPacket,
+}
+
+// 信令跟踪
+//
+// PATH /trace/packet
+type PacketController struct {
+	packetService *traceService.Packet // 信令跟踪服务
+}
+
+// 网元跟踪网卡设备列表
+//
+// GET /devices
+func (s *PacketController) Devices(c *gin.Context) {
+	data := s.packetService.NetworkDevices()
+	c.JSON(200, result.OkData(data))
+}
+
+// 网元跟踪开始
+//
+// POST /start
+func (s *PacketController) Start(c *gin.Context) {
+	language := ctx.AcceptLanguage(c)
+	var body struct {
+		Device string `json:"device" binding:"required"` // 网卡设备
+		TaskNo string `json:"taskNo" binding:"required"` // 任务编号
+		Output string `json:"output" `                   // 输出PCAP文件路径，为空则不输出
+	}
+	if err := c.ShouldBindBodyWith(&body, binding.JSON); err != nil {
+		c.JSON(400, result.CodeMsg(400, i18n.TKey(language, "app.common.err400")))
+		return
+	}
+
+	msg, err := s.packetService.LiveStart(body.TaskNo, body.Device, body.Output)
+	if err != nil {
+		c.JSON(200, result.ErrMsg(i18n.TKey(language, err.Error())))
+		return
+	}
+	c.JSON(200, result.OkData(msg))
+}
+
+// 网元跟踪结束
+//
+// POST /stop
+func (s *PacketController) Stop(c *gin.Context) {
+	language := ctx.AcceptLanguage(c)
+	var body struct {
+		TaskNo string `json:"taskNo" binding:"required"` // 任务编号
+	}
+	if err := c.ShouldBindBodyWith(&body, binding.JSON); err != nil {
+		c.JSON(400, result.CodeMsg(400, i18n.TKey(language, "app.common.err400")))
+		return
+	}
+
+	if err := s.packetService.LiveStop(body.TaskNo); err != nil {
+		c.JSON(200, result.ErrMsg(i18n.TKey(language, err.Error())))
+		return
+	}
+	c.JSON(200, result.Ok(nil))
+}
+
+// 网元跟踪过滤
+//
+// PUT /filter
+func (s *PacketController) Filter(c *gin.Context) {
+	language := ctx.AcceptLanguage(c)
+	var body struct {
+		TaskNo string `json:"taskNo" binding:"required"` // 任务编号
+		Expr   string `json:"expr" binding:"required"`   // 过滤表达式（port 33030 or 33040）
+	}
+	if err := c.ShouldBindBodyWith(&body, binding.JSON); err != nil {
+		c.JSON(400, result.CodeMsg(400, i18n.TKey(language, "app.common.err400")))
+		return
+	}
+
+	if err := s.packetService.LiveFilter(body.TaskNo, body.Expr); err != nil {
+		c.JSON(200, result.ErrMsg(i18n.TKey(language, err.Error())))
+		return
+	}
+	c.JSON(200, result.Ok(nil))
+}
+
+// 网元跟踪续期保活
+//
+// PUT /keep-alive
+func (s *PacketController) KeepAlive(c *gin.Context) {
+	language := ctx.AcceptLanguage(c)
+	var body struct {
+		IntervalIn int `json:"intervalIn" ` // 服务续约的频率，默认设置为60秒
+		Duration   int `json:"duration" `   // 服务失效的时间，默认设置为120秒
+	}
+	err := c.ShouldBindBodyWith(&body, binding.JSON)
+	if err != nil {
+		c.JSON(400, result.CodeMsg(400, i18n.TKey(language, "app.common.err400")))
+		return
+	}
+	c.JSON(200, result.Ok(nil))
+}