feat: add memory region interface and base class

wanshenmean

2026-03-13 eec4c84f34af5b1bf7da4774be13a6d8c27498b6

feat: add memory region interface and base class

- Add IMemoryRegion interface
- Add MemoryRegion base class with thread-safe read/write
- Support offset-based read/write operations

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

 Code/WCS/WIDESEAWCS_S7Simulator/WIDESEAWCS_S7Simulator.Core/Interfaces/IMemoryRegion.cs

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,38 @@
namespace WIDESEAWCS_S7Simulator.Core.Interfaces
{
    /// <summary>
    /// å†…存区域接口
    /// </summary>
    public interface IMemoryRegion
    {
        /// <summary>
        /// åŒºåŸŸç±»åž‹ï¼ˆM/DB/I/Q/T/C）
        /// </summary>
        string RegionType { get; }

        /// <summary>
        /// åŒºåŸŸå¤§å°ï¼ˆå­—节）
        /// </summary>
        int Size { get; }

        /// <summary>
        /// è¯»å–字节数据
        /// </summary>
        /// <param name="offset">偏移量</param>
        /// <param name="length">长度</param>
        /// <returns>字节数组</returns>
        byte[] Read(ushort offset, ushort length);

        /// <summary>
        /// å†™å…¥å­—节数据
        /// </summary>
        /// <param name="offset">偏移量</param>
        /// <param name="data">数据</param>
        void Write(ushort offset, byte[] data);

        /// <summary>
        /// æ¸…空区域
        /// </summary>
        void Clear();
    }
}

 Code/WCS/WIDESEAWCS_S7Simulator/WIDESEAWCS_S7Simulator.Core/Memory/MemoryRegion.cs

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,108 @@
using System.Threading;
using WIDESEAWCS_S7Simulator.Core.Interfaces;

namespace WIDESEAWCS_S7Simulator.Core.Memory
{
    /// <summary>
    /// å†…存区域基类
    /// </summary>
    public abstract class MemoryRegion : IMemoryRegion
    {
        /// <summary>
        /// å†…存数据
        /// </summary>
        protected readonly byte[] _memory;

        /// <summary>
        /// è¯»å†™é”ï¼ˆæ”¯æŒå¹¶å‘访问）
        /// </summary>
        protected readonly ReaderWriterLockSlim _lock;

        /// <summary>
        /// åŒºåŸŸç±»åž‹
        /// </summary>
        public abstract string RegionType { get; }

        /// <summary>
        /// åŒºåŸŸå¤§å°ï¼ˆå­—节）
        /// </summary>
        public int Size { get; }

        /// <summary>
        /// æž„造函数
        /// </summary>
        /// <param name="size">区域大小</param>
        protected MemoryRegion(int size)
        {
            Size = size;
            _memory = new byte[size];
            _lock = new ReaderWriterLockSlim();
        }

        /// <summary>
        /// è¯»å–字节数据
        /// </summary>
        public virtual byte[] Read(ushort offset, ushort length)
        {
            _lock.EnterReadLock();
            try
            {
                if (offset + length > Size)
                    throw new ArgumentOutOfRangeException(
                        $"读取超出{RegionType}区范围: offset={offset}, length={length}, size={Size}");

                byte[] result = new byte[length];
                Array.Copy(_memory, offset, result, 0, length);
                return result;
            }
            finally
            {
                _lock.ExitReadLock();
            }
        }

        /// <summary>
        /// å†™å…¥å­—节数据
        /// </summary>
        public virtual void Write(ushort offset, byte[] data)
        {
            _lock.EnterWriteLock();
            try
            {
                if (offset + data.Length > Size)
                    throw new ArgumentOutOfRangeException(
                        $"写入超出{RegionType}区范围: offset={offset}, length={data.Length}, size={Size}");

                Array.Copy(data, 0, _memory, offset, data.Length);
            }
            finally
            {
                _lock.ExitWriteLock();
            }
        }

        /// <summary>
        /// æ¸…空区域
        /// </summary>
        public virtual void Clear()
        {
            _lock.EnterWriteLock();
            try
            {
                Array.Clear(_memory, 0, Size);
            }
            finally
            {
                _lock.ExitWriteLock();
            }
        }

        /// <summary>
        /// é‡Šæ”¾èµ„源
        /// </summary>
        public virtual void Dispose()
        {
            _lock?.Dispose();
        }
    }
}