【GO】基于共享内存的跨进程通信方案

使用Golang实现了基于共享内存的跨进程通信,高效通信

【GO】基于共享内存的跨进程通信方案

By img Microanswer Create at:Mar 24, 2025, 2:34:27 PM 

Tags: go 跨进程通信 IPC 共享内存

使用Golang实现了基于共享内存的跨进程通信,高效通信


一、背景

最近遇到一新需求,需要将一个功能模块单独提取出来作为一个项目实现,然后这个功能模块可以被编译为一个单独运行的应用,且此应用中的功能可以被其它应用调用,其它应用可以是任意语言实现的。

我希望此功能模块能够高效的为其它应用提供交互能力,为此我不愿使用web、socket 等方案来实现,这不仅效率低,延迟还高。于是我打算使用基于共享内存的方法实现。

二、原理

在 golang 中,我们可以通过 syscall.CreateFileMappingsyscall.MapViewOfFile 这两个函数来实现共享内存的创建和映射到应用中读取内存地址。基于这两个函数就可以开始我们的共享内存实现跨进程通信了。

通过共享内存来实现通信,本质上就是两个不同的应用,都可以拿到这块内存的地址,然后读取里面的内容。要实现相互之间的通信,就必须制定一个相互之间的读写沟通规范,从而实现你读我写或我读你写的这么一个状态。下面简单的描述一下本代码实现的沟通规范:

// 口口口口口口口口 | 口 | 口口口口口口口口 | 口 | 口口口口 | 口口口口口口口......口口口口口口口
// 时间戳8字节|读写状态1字节|数据体大小8字节|数据体状态1字节|预留4字节|数据体区(任意字节)

上面一个“口”表示一个字节,这些所有“口”构成一整个共享内存区域的内容。其中被划分为了几个功能区域。

  1. 时间戳区域,占用8个字节:我们定义每10毫秒将发送方的当前时间写入该8个字节中,这样接收方可以通过判断这8个字节读取出来的时间戳和当前时间戳是否小于10毫秒,如果大于了,说明发送方没有运行或断线了。
  2. 读写状态区域,占用1个字节:这里只需要保存 0 和 1 两个值,因此使用1个字节搓搓有余了,0 表示后面的“数据体”的内容无意义,里面的数据没用。1 表示里面的数据是发送方写进去的,并且等待接收方将其读取,接收方读取完成后将该区域的值又设置为 0。发送方发现是0了,认为接收方已读取,并重新写入新值。
  3. 数据体大小区域,占用8字节:这里保存了数据体区域的实际数据长度。
  4. 数据体状态区域,占用1字节:这里保存了一个非常有用的状态,1=数据体的数据是否要发送的数据的部分数据;2=数据体的数据是否是要发送的数据结束部分;这在发送相当大的内容时非常有用,接收方和发送方都会多次分片发送来确保一个很大的数据能够完整被发送和接受。

三、代码实现

下面,是整个代码实现上面的逻辑。

此代码适用于Windows环境,如果是Linux下,那么创建共享内存的实现方式有所不同,你如果要用,需要自己修改那部分代码。
  1. import (
  2. "encoding/binary"
  3. "fmt"
  4. "slices"
  5. "syscall"
  6. "time"
  7. "unsafe"
  8. )
  9. // 口口口口口口口口|口|口口口口口口口口|口|口口口口|口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口
  10. // 时间戳|读写状态|数据体大小|数据体状态|预留4byte|数据体区
  11. const (
  12. RW_STATUS_NOTHING = 0
  13. RW_STATUS_WAITING = 1
  14. DATA_TYPE_THUNK = 1
  15. DATA_TYPE_FULL = 2
  16. )
  17. // uint642bytes uint64 转为
  18. func int642bytes(i int64) []byte {
  19. b := make([]byte, 8)
  20. binary.BigEndian.PutUint64(b, uint64(i))
  21. return b
  22. }
  23. func bytes2int64(b []byte) int64 {
  24. return int64(binary.BigEndian.Uint64(b))
  25. }
  26. // 时间戳 偏移量
  27. func _timePosition() (int64, int64) {
  28. return 0, 8
  29. }
  30. // 读写状态区 偏移量
  31. func _RWstatusPosition() (int64, int64) {
  32. _, end := _timePosition()
  33. return end, end + 1
  34. }
  35. // 数据体大小区 偏移量
  36. func _DataLenPosition() (int64, int64) {
  37. _, end := _RWstatusPosition()
  38. return end, end + 8
  39. }
  40. // 数据体状态区 偏移量
  41. func _DataStatusPosition() (int64, int64) {
  42. _, end := _DataLenPosition()
  43. return end, end + 1
  44. }
  45. // 预留去空白区 偏移量
  46. func _EmptyPosition() (int64, int64) {
  47. _, end := _DataStatusPosition()
  48. return end, end + 4
  49. }
  50. type MemSender struct {
  51. ID string // 共享内存的 ID,一般这个应该唯一,多个Sender不能用同一个ID。
  52. DataAreaSize int64 // 数据体区大小
  53. shareMemSize int64 // 整个共享内存区大小。
  54. isWatching bool
  55. handle syscall.Handle
  56. memAddr uintptr
  57. needSendData chan []byte
  58. destoryed bool
  59. }
  60. // Send 发送数据
  61. func (s *MemSender) Send(data []byte) {
  62. s.needSendData <- slices.Clone(data)
  63. }
  64. func (s *MemSender) Close() {
  65. s.destoryed = true
  66. err := syscall.UnmapViewOfFile(s.memAddr)
  67. if err != nil {
  68. fmt.Println(err)
  69. }
  70. err = syscall.CloseHandle(s.handle)
  71. if err != nil {
  72. fmt.Println(err)
  73. }
  74. }
  75. // 数据体区 偏移量
  76. func (s *MemSender) _DataPosition() (int64, int64) {
  77. _, end := _EmptyPosition()
  78. return end, s.shareMemSize
  79. }
  80. // 进行时间戳更新
  81. func (s *MemSender) _update() {
  82. data := (*[1 << 30]byte)(unsafe.Pointer(s.memAddr))[:s.shareMemSize]
  83. for !s.destoryed {
  84. now := time.Now().UnixMilli()
  85. // 第一位,写入当前时间
  86. start, end := _timePosition()
  87. copy(data[start:end], int642bytes(now))
  88. //fmt.Printf("%v\r", now)
  89. // 每 10 毫秒进行一次。
  90. time.Sleep(10 * time.Millisecond)
  91. }
  92. }
  93. // 进行数据检测并发送
  94. func (s *MemSender) _run() {
  95. data := (*[1 << 30]byte)(unsafe.Pointer(s.memAddr))[:s.shareMemSize]
  96. // 开始运行时,将数据体内的数据设置为无意义。
  97. rwStatusStart, rwStatusEnd := _RWstatusPosition()
  98. data[rwStatusStart:rwStatusEnd][0] = RW_STATUS_NOTHING
  99. for !s.destoryed {
  100. sendData := <-s.needSendData
  101. dataPositionStart, _ := s._DataPosition()
  102. total := int64(len(sendData))
  103. processedLen := int64(0)
  104. startOfNeedData := int64(0)
  105. //fmt.Printf("来数据了:%v\n", sendData)
  106. // 还没发完,就持续发送。
  107. for processedLen < total && !s.destoryed {
  108. // 先看数据体的读写状态,如果是待读取的,那么不要做任何事情,等待
  109. if data[rwStatusStart:rwStatusEnd][0] == RW_STATUS_WAITING {
  110. time.Sleep(1 * time.Millisecond)
  111. continue
  112. }
  113. // 不是待读取,说明数据已经被读取,此时写入新数据
  114. nextData := sendData[startOfNeedData:min(startOfNeedData+s.DataAreaSize, total)]
  115. currentLength := int64(len(nextData))
  116. copy(data[dataPositionStart:dataPositionStart+currentLength], nextData)
  117. // 写入本次数据体的大小
  118. lenPositionStart, lenPositionEnd := _DataLenPosition()
  119. copy(data[lenPositionStart:lenPositionEnd], int642bytes(currentLength))
  120. processedLen += currentLength
  121. startOfNeedData += currentLength
  122. // 写入 数据体是否到达尾部
  123. isEnd := processedLen >= total
  124. isEndStart, isEndEnd := _DataStatusPosition()
  125. if isEnd {
  126. data[isEndStart:isEndEnd][0] = DATA_TYPE_FULL
  127. } else {
  128. data[isEndStart:isEndEnd][0] = DATA_TYPE_THUNK
  129. }
  130. // 标记数据体的数据待读取
  131. data[rwStatusStart:rwStatusEnd][0] = RW_STATUS_WAITING
  132. //fmt.Printf("已写出%v:%v\n", currentLength, nextData)
  133. }
  134. //fmt.Printf("已发送完一波:%v\n", processedLen)
  135. }
  136. }
  137. func (s *MemSender) Watching() error {
  138. if s.isWatching {
  139. return nil
  140. }
  141. s.needSendData = make(chan []byte)
  142. s.shareMemSize = 8 /*时间戳区*/ + 1 /*读写状态区*/ + 8 /* 1个数据大小区战8字节 */ + 1 /*数据体状态区*/ + 4 /*预留4byte*/ + s.DataAreaSize /* 数据区 */
  143. file, err := syscall.UTF16PtrFromString("Local\\" + s.ID)
  144. if err != nil {
  145. return err
  146. }
  147. s.handle, err = syscall.CreateFileMapping(0, nil, syscall.PAGE_READWRITE, 0, uint32(s.shareMemSize), file)
  148. if err != nil {
  149. return err
  150. }
  151. s.memAddr, err = syscall.MapViewOfFile(s.handle, syscall.FILE_MAP_WRITE, 0, 0, uintptr(s.shareMemSize))
  152. if err != nil {
  153. return err
  154. }
  155. s.isWatching = true
  156. go s._update()
  157. go s._run()
  158. return nil
  159. }
  160. func NewMemSender(ID string) *MemSender {
  161. s := &MemSender{
  162. ID: ID,
  163. DataAreaSize: 1024 * 1024, // // 默认 1mb 数据区大小
  164. }
  165. err := s.Watching()
  166. if err != nil {
  167. panic(err)
  168. }
  169. return s
  170. }
  171. type MemReceiver struct {
  172. ID string // 指定要从哪个ID的共享内存发送器进行接收
  173. DataAreaSize int64
  174. shareMemSize int64
  175. isPending bool
  176. receiveChan chan []byte
  177. handle syscall.Handle
  178. memAddr uintptr
  179. senderOffLine bool
  180. destoryed bool
  181. }
  182. // 数据体区 偏移量
  183. func (s *MemReceiver) _DataPosition() (int64, int64) {
  184. _, end := _EmptyPosition()
  185. return end, s.shareMemSize
  186. }
  187. func (s *MemReceiver) IsSenderOffLine() bool {
  188. return s.senderOffLine
  189. }
  190. func (s *MemReceiver) Pending() error {
  191. if s.isPending {
  192. return nil
  193. }
  194. s.receiveChan = make(chan []byte)
  195. s.shareMemSize = 8 /*时间戳区*/ + 1 /*读写状态区*/ + 8 /* 1个数据大小区战8字节 */ + 1 /*数据体状态区*/ + 4 /*预留4byte*/ + s.DataAreaSize /* 数据区 */
  196. file, err := syscall.UTF16PtrFromString("Local\\" + s.ID)
  197. if err != nil {
  198. return err
  199. }
  200. s.handle, err = syscall.CreateFileMapping(0, nil, syscall.PAGE_READWRITE, 0, uint32(s.shareMemSize), file)
  201. if err != nil {
  202. return err
  203. }
  204. s.memAddr, err = syscall.MapViewOfFile(s.handle, syscall.FILE_MAP_WRITE, 0, 0, uintptr(s.shareMemSize))
  205. if err != nil {
  206. return err
  207. }
  208. s.isPending = true
  209. go s._update()
  210. go s._run()
  211. return nil
  212. }
  213. func (s *MemReceiver) GetData() []byte {
  214. return <-s.receiveChan
  215. }
  216. func (s *MemReceiver) Close() {
  217. s.destoryed = true
  218. err := syscall.UnmapViewOfFile(s.memAddr)
  219. if err != nil {
  220. fmt.Println(err)
  221. }
  222. err = syscall.CloseHandle(s.handle)
  223. if err != nil {
  224. fmt.Println(err)
  225. }
  226. }
  227. func (s *MemReceiver) _update() {
  228. data := (*[1 << 30]byte)(unsafe.Pointer(s.memAddr))[:s.shareMemSize]
  229. for !s.destoryed {
  230. // 第一位,获取记录的是发送器写入的当前时间,将其获取出来,如果这个时间和此时超过了10毫秒,说明发送器可能已被关闭。
  231. start, end := _timePosition()
  232. senderLastUpdateTime := bytes2int64(data[start:end])
  233. s.senderOffLine = time.Now().UnixMilli()-senderLastUpdateTime > 10
  234. // 每 10 毫秒进行一次。
  235. time.Sleep(10 * time.Millisecond)
  236. }
  237. }
  238. func (s *MemReceiver) _run() {
  239. data := (*[1 << 30]byte)(unsafe.Pointer(s.memAddr))[:s.shareMemSize]
  240. // 开始接受数据
  241. rwStatusStart, rwStatusEnd := _RWstatusPosition()
  242. for !s.destoryed {
  243. // 先看数据体的读写状态,如果是无意义的,那么不要做任何事情,等待
  244. if data[rwStatusStart:rwStatusEnd][0] == RW_STATUS_NOTHING {
  245. time.Sleep(1 * time.Millisecond)
  246. continue
  247. }
  248. // 读取数据体大小
  249. lenPositionStart, lenPositionEnd := _DataLenPosition()
  250. // 定义一个变量保存收到的数据
  251. recData := make([]byte, 0)
  252. // 读取数据是否达到结尾
  253. isEndStart, isEndEnd := _DataStatusPosition()
  254. for !s.destoryed {
  255. // 再看数据体的读写状态,如果是无意义的,那么不要做任何事情,等待
  256. if data[rwStatusStart:rwStatusEnd][0] == RW_STATUS_NOTHING {
  257. time.Sleep(10 * time.Millisecond)
  258. continue
  259. }
  260. dataLength := bytes2int64(data[lenPositionStart:lenPositionEnd])
  261. //fmt.Printf("dataLength: %v\n", dataLength)
  262. dataPositionStart, _ := s._DataPosition()
  263. recData = append(recData, data[dataPositionStart:dataPositionStart+dataLength]...)
  264. // 读取完成数据,将读写状态区,修改为 无意义,这样 发送器就会发送下一个数据。
  265. data[rwStatusStart:rwStatusEnd][0] = RW_STATUS_NOTHING
  266. if data[isEndStart:isEndEnd][0] == DATA_TYPE_FULL {
  267. // 接收完成,退出循环
  268. break
  269. }
  270. }
  271. s.receiveChan <- recData
  272. }
  273. }
  274. func NewMemReceiver(ID string) *MemReceiver {
  275. mr := &MemReceiver{
  276. ID: ID,
  277. DataAreaSize: 1024 * 1024,
  278. }
  279. err := mr.Pending()
  280. if err != nil {
  281. panic(err)
  282. }
  283. return mr
  284. }
以上代码适用于Windows环境,如果是Linux下,那么创建共享内存的实现方式有所不同,你如果要用,需要自己修改那部分代码。

四、使用方法

这个实现使得我们在实现跨进程通信时变得非常简单:

A 应用中的代码

  1. sender := NewMemSender("com_myapp_a")
  2. sender.Send([]byte("Hello App B"))
  3. time.Sleep(60 * time.Second)

B 应用中的代码

  1. // com_myapp_a 这个值必须和发送方保持一致,相当于是大家一起在这个频道上进行通信。
  2. receiver := NewMemReceiver("com_myapp_a")
  3. data := receiver.GetData()
  4. fmt.Println(string(data)) // 输出:Hello App B

如果你启动 A 应用后,在启动 B 应用,那么你将会看到B应用输出对应发过来的消息。

如果你只启动了B,没启动A,那么 B 会卡在 GetData 这里等待发送消息。

如果发送方多次调用 Send 函数发送数据,而接收方没有读取出数据,那么发送方会在第二次发送时卡住,应为第一次发送的内容还没被读取。

Full text complete, Reproduction please indicate the source. Help you? Not as good as one:
Comment(Comments need to be logged in. You are not logged in.)
You need to log in before you can comment.

Comments (0 Comments)