From 9085c3003aa48e399a6dc2d41aebad896865e61b Mon Sep 17 00:00:00 2001 From: BobSong <605277374@qq.com> Date: Mon, 11 Aug 2025 16:09:33 +0800 Subject: [PATCH] fist commit --- .gitignore | 2 + .idea/.idea.FantasyNetTest/.idea/.gitignore | 13 + .../.idea.FantasyNetTest/.idea/encodings.xml | 4 + .../.idea/indexLayout.xml | 8 + .../DesignTimeBuild/.dtbcache.v2 | Bin 0 -> 116420 bytes ...1b16a2e7-1bb2-4c3c-9d14-af55c9c33fc6.vsidx | Bin 0 -> 48012 bytes ...63aeb925-4ffa-4456-9651-416f182bf989.vsidx | Bin 0 -> 4674 bytes ...64c8bdfc-9971-43cd-9e5b-02cd88a5d378.vsidx | Bin 0 -> 17093 bytes ...803edca7-6048-4b38-896e-1c612aa4ddfb.vsidx | Bin 0 -> 8344 bytes ...a276d935-05f6-4ffd-9ee0-d04eb5db88f8.vsidx | Bin 0 -> 712427 bytes .vs/FantasyNetTest/v17/.futdcache.v2 | Bin 0 -> 132 bytes .vs/FantasyNetTest/v17/.suo | Bin 0 -> 52224 bytes .vs/FantasyNetTest/v17/DocumentLayout.json | 101 + .../fantasynettest.metadata.v7.bin | Bin 0 -> 202235 bytes .../fantasynettest.projects.v7.bin | Bin 0 -> 736814 bytes FantasyNetTest.sln | 16 + FantasyNetTest.sln.DotSettings.user | 9 + FantasyNetTest/Config.cs | 25 + FantasyNetTest/Config.json | 6 + FantasyNetTest/FantasyNetTest.csproj | 31 + FantasyNetTest/FantasyNetTest.csproj.user | 8 + FantasyNetTest/Form1.Designer.cs | 210 ++ FantasyNetTest/Form1.cs | 757 ++++++ FantasyNetTest/Form1.resx | 126 + FantasyNetTest/Loader/ScriptLoader.cs | 67 + FantasyNetTest/Log.cs | 157 ++ FantasyNetTest/LoginTask.cs | 45 + FantasyNetTest/NBC.zip | Bin 0 -> 342269 bytes .../NBC/Core/Assembly/AssemblyInfo.cs | 89 + .../NBC/Core/Assembly/AssemblySystem.cs | 286 +++ FantasyNetTest/NBC/Core/Assembly/IAssembly.cs | 27 + .../NBC/Core/Attributes/Attributes.cs | 20 + .../Collection/CircularBuffer.cs | 346 +++ .../Collection/ConcurrentOneToManyListPool.cs | 197 ++ .../ConcurrentOneToManyQueuePool.cs | 194 ++ .../DataStructure/Collection/HashSetPool.cs | 134 + .../Core/DataStructure/Collection/ListPool.cs | 101 + .../Collection/OneToManyHashSetPool.cs | 208 ++ .../Collection/OneToManyListPool.cs | 253 ++ .../Collection/OneToManyQueuePool.cs | 204 ++ .../DataStructure/Collection/ReuseList.cs | 69 + .../SortedConcurrentOneToManyListPool.cs | 226 ++ .../Collection/SortedOneToManyHashSetPool.cs | 192 ++ .../Collection/SortedOneToManyListPool.cs | 217 ++ .../Dictionary/DictionaryExtensions.cs | 31 + .../Dictionary/DictionaryPool.cs | 70 + .../Dictionary/DoubleMapDictionaryPool.cs | 289 +++ .../Dictionary/EntityDictionary.cs | 91 + .../Dictionary/OneToManyDictionaryPool.cs | 247 ++ .../OneToManySortedDictionaryPool.cs | 250 ++ .../Dictionary/ReuseDictionary.cs | 70 + .../Dictionary/SortedDictionaryPool.cs | 70 + .../PriorityQueue/PriorityQueueGenerics.cs | 121 + .../PriorityQueue/PriorityQueueItem.cs | 30 + .../PriorityQueue/PriorityQueueSimple.cs | 116 + .../Core/DataStructure/SkipTable/SkipTable.cs | 190 ++ .../DataStructure/SkipTable/SkipTableBase.cs | 282 +++ .../DataStructure/SkipTable/SkipTableDesc.cs | 188 ++ .../DataStructure/SkipTable/SkipTableNode.cs | 68 + .../Component/CoroutineLock/CoroutineLock.cs | 140 ++ .../CoroutineLock/CoroutineLock.cs.meta | 11 + .../CoroutineLock/CoroutineLockComponent.cs | 100 + .../CoroutineLockComponent.cs.meta | 11 + .../CoroutineLock/CoroutineLockQueue.cs | 35 + .../CoroutineLock/CoroutineLockQueue.cs.meta | 11 + .../CoroutineLock/WaitCoroutineLock.cs | 146 ++ .../CoroutineLock/WaitCoroutineLock.cs.meta | 11 + .../Core/Entitas/Component/EntityComponent.cs | 472 ++++ .../EventComponent/EventComponent.cs | 255 ++ .../EventComponent/EventComponent.cs.meta | 11 + .../Component/EventComponent/Interface.meta | 8 + .../EventComponent/Interface/IEvent.cs | 112 + .../EventComponent/Interface/IEvent.cs.meta | 11 + .../Entitas/Component/MessagePoolComponent.cs | 139 ++ .../TimerComponent/Interface/TimerHandler.cs | 10 + .../Interface/TimerHandler.cs.meta | 11 + .../Component/TimerComponent/TimerAction.cs | 27 + .../TimerComponent/TimerComponent.cs | 45 + .../TimerScheduler/TimerSchedulerNet.cs | 383 +++ .../TimerScheduler/TimerSchedulerNetUnity.cs | 371 +++ .../Component/TimerComponent/TimerType.cs | 25 + FantasyNetTest/NBC/Core/Entitas/Entity.cs | 837 +++++++ FantasyNetTest/NBC/Core/Entitas/EntityPool.cs | 66 + .../NBC/Core/Entitas/EntityReference.cs | 59 + .../Supported/ISingleCollectionRoot.cs | 17 + .../Supported/ISingleCollectionRoot.cs.meta | 11 + .../Interface/Supported/ISupportedDataBase.cs | 19 + .../Supported/ISupportedDataBase.cs.meta | 11 + .../Supported/ISupportedMultiEntity.cs | 20 + .../Supported/ISupportedMultiEntity.cs.meta | 11 + .../Supported/ISupportedSingleCollection.cs | 47 + .../ISupportedSingleCollection.cs.meta | 11 + .../Interface/Supported/ISupportedTransfer.cs | 16 + .../Supported/ISupportedTransfer.cs.meta | 11 + .../Entitas/Interface/System/IAwakeSystem.cs | 32 + .../Interface/System/IAwakeSystem.cs.meta | 11 + .../Interface/System/ICustomEntitiesSystem.cs | 59 + .../System/ICustomEntitiesSystem.cs.meta | 11 + .../Interface/System/IDeserializeSystem.cs | 32 + .../System/IDeserializeSystem.cs.meta | 11 + .../Interface/System/IDestroySystem.cs | 32 + .../Interface/System/IDestroySystem.cs.meta | 11 + .../Interface/System/IEntitiesSystem.cs | 22 + .../Interface/System/IEntitiesSystem.cs.meta | 11 + .../Interface/System/IFrameUpdateSystem.cs | 31 + .../System/IFrameUpdateSystem.cs.meta | 11 + .../Entitas/Interface/System/IUpdateSystem.cs | 31 + .../Interface/System/IUpdateSystem.cs.meta | 11 + FantasyNetTest/NBC/Core/Event/EventArgs.cs | 128 + .../NBC/Core/Event/EventDispatcher.cs | 217 ++ .../NBC/Core/Event/IEventDispatcher.cs | 71 + .../AsyncFTaskCompletedMethodBuilder.cs | 52 + .../FTask/Builder/AsyncFTaskMethodBuilder.cs | 140 ++ .../FTask/Builder/AsyncFVoidMethodBuilder.cs | 62 + .../FCancellationToken/FCancellationToken.cs | 121 + .../FTask/FTask.Extension/FTask.Factory.cs | 115 + .../Core/FTask/FTask.Extension/FTask.Tools.cs | 344 +++ FantasyNetTest/NBC/Core/FTask/Task/FTask.cs | 263 ++ .../NBC/Core/FTask/Task/FTaskCompleted.cs | 31 + FantasyNetTest/NBC/Core/FTask/Task/FVoid.cs | 29 + FantasyNetTest/NBC/Core/Helper/ByteHelper.cs | 344 +++ .../NBC/Core/Helper/EncryptHelper.cs | 59 + FantasyNetTest/NBC/Core/Helper/FileHelper.cs | 186 ++ .../NBC/Core/Helper/HashCodeHelper.cs | 143 ++ .../Helper/HttpClient/HttpClientHelper.cs | 145 ++ .../HttpClient/HttpClientHelper.cs.meta | 3 + .../Core/Helper/HttpClient/HttpClientPool.cs | 44 + .../Helper/HttpClient/HttpClientPool.cs.meta | 3 + .../Core/Helper/HttpClient/IJsonRpcRequest.cs | 20 + .../Helper/HttpClient/IJsonRpcRequest.cs.meta | 3 + FantasyNetTest/NBC/Core/Helper/JsonHelper.cs | 57 + .../NBC/Core/Helper/NetworkHelper.cs | 443 ++++ .../NBC/Core/Helper/RandomHelper.cs | 310 +++ .../NBC/Core/Helper/RandomHelperWebgl.cs | 295 +++ .../NBC/Core/Helper/SocketHelper.cs | 70 + FantasyNetTest/NBC/Core/Helper/TimeHelper.cs | 80 + .../NBC/Core/Helper/WebSocketHelper.cs | 38 + FantasyNetTest/NBC/Core/Helper/WinPeriod.cs | 24 + .../Core/IdFactory/Default/EntityIdStruct.cs | 136 ++ .../Core/IdFactory/Default/RuntimeIdStruct.cs | 138 ++ .../NBC/Core/IdFactory/IdFactoryHelper.cs | 133 + .../NBC/Core/IdFactory/IdFactoryType.cs | 23 + .../Core/IdFactory/Interface/IIdFactory.cs | 24 + .../IdFactory/Interface/IIdFactoryTool.cs | 27 + .../IdFactory/World/WorldEntityIdFactory.cs | 153 ++ .../IdFactory/World/WorldRuntimeIdFactory.cs | 155 ++ FantasyNetTest/NBC/Core/InnerErrorCode.cs | 66 + FantasyNetTest/NBC/Core/Log/ILog.cs | 64 + FantasyNetTest/NBC/Core/Log/Log.cs | 156 ++ FantasyNetTest/NBC/Core/Log/UnityLog.cs | 73 + .../NBC/Core/LowLevel/FixedBytes.cs | 105 + FantasyNetTest/NBC/Core/LowLevel/XxHash.cs | 171 ++ .../Core/Network/MemoryStreamBufferPool.cs | 97 + .../Network/Message/Dispatcher/Interface.meta | 8 + .../Dispatcher/Interface/IMessageHandler.cs | 219 ++ .../Interface/IMessageHandler.cs.meta | 11 + .../Interface/IRouteMessageHandler.cs | 490 ++++ .../Interface/IRouteMessageHandler.cs.meta | 11 + .../Dispatcher/MessageDispatcherComponent.cs | 402 +++ .../MessageDispatcherComponent.cs.meta | 11 + .../NBC/Core/Network/Message/IMessage.cs | 95 + .../NBC/Core/Network/Message/InnerMessage.cs | 319 +++ .../Handler/BufferPacketParser.cs | 376 +++ .../Handler/BufferPacketParser.cs.meta | 11 + .../Handler/CircularBufferPacketParser.cs | 170 ++ .../CircularBufferPacketParser.cs.meta | 11 + .../Handler/OuterBufferPacketParserHelper.cs | 72 + .../OuterBufferPacketParserHelper.cs.meta | 11 + .../Handler/ReadOnlyMemoryPacketParser.cs | 357 +++ .../ReadOnlyMemoryPacketParser.cs.meta | 11 + .../PacketParser/Interface/APackInfo.cs | 61 + .../PacketParser/Interface/APackInfo.cs.meta | 11 + .../PacketParser/Interface/APacketParser.cs | 30 + .../Interface/APacketParser.cs.meta | 11 + .../Network/Message/PacketParser/OpCode.cs | 125 + .../PacketParser/Pack/InnerPackInfo.cs | 79 + .../PacketParser/Pack/InnerPackInfo.cs.meta | 11 + .../PacketParser/Pack/OuterPackInfo.cs | 73 + .../PacketParser/Pack/OuterPackInfo.cs.meta | 11 + .../PacketParser/Pack/ProcessPackInfo.cs | 160 ++ .../PacketParser/Pack/ProcessPackInfo.cs.meta | 11 + .../Network/Message/PacketParser/Packet.cs | 49 + .../PacketParser/PacketParserFactory.cs | 173 ++ .../Scheduler/ClientMessageScheduler.cs | 85 + .../Scheduler/InnerMessageScheduler.cs | 211 ++ .../Interface/ANetworkMessageScheduler.cs | 31 + .../Scheduler/MessageHelper/MessageSender.cs | 107 + .../NetworkMessagingComponent.cs | 273 +++ .../OnNetworkMessageUpdateCheckTimeout.cs | 59 + .../Scheduler/OuterMessageScheduler.cs | 38 + .../Protocol/Exception/ScanException.cs | 21 + .../Protocol/HTTP/HTTPServerNetwork.cs | 128 + .../Protocol/HTTP/SceneContextFilter.cs | 54 + .../Protocol/Interface/AClientNetwork.cs | 38 + .../Network/Protocol/Interface/ANetwork.cs | 149 ++ .../Interface/ANetworkServerChannel.cs | 55 + .../Protocol/Interface/INetworkChannel.cs | 14 + .../NBC/Core/Network/Protocol/KCP/Base/Kcp.cs | 451 ++++ .../Network/Protocol/KCP/Base/Kcp.cs.meta | 11 + .../NBC/Core/Network/Protocol/KCP/Base/c.meta | 8 + .../Core/Network/Protocol/KCP/Base/c/kcp.cs | 1367 +++++++++++ .../Network/Protocol/KCP/Base/c/kcp.cs.meta | 11 + .../Network/Protocol/KCP/Base/define.meta | 8 + .../Protocol/KCP/Base/define/system.cs | 41 + .../Protocol/KCP/Base/define/system.cs.meta | 11 + .../Network/Protocol/KCP/Base/include.meta | 8 + .../Network/Protocol/KCP/Base/include/kcp.cs | 127 + .../Protocol/KCP/Base/include/kcp.cs.meta | 11 + .../Protocol/KCP/Client/KCPClientNetwork.cs | 690 ++++++ .../KCP/Client/KCPClientNetwork.cs.meta | 11 + .../Core/Network/Protocol/KCP/KCPSettings.cs | 69 + .../Core/Network/Protocol/KCP/KcpHeader.cs | 14 + .../KCP/Server/KCPServerNetworkByArrayPool.cs | 575 +++++ .../KCPServerNetworkByArrayPool.cs.meta | 11 + .../KCP/Server/KCPServerNetworkByPipe.cs | 619 +++++ .../KCP/Server/KCPServerNetworkByPipe.cs.meta | 11 + .../KCP/Server/KCPServerNetworkChannel.cs | 165 ++ .../Server/KCPServerNetworkChannel.cs.meta | 11 + .../Protocol/NetworkProtocolFactory.cs | 86 + .../Network/Protocol/NetworkProtocolType.cs | 69 + .../Protocol/NetworkThreadComponent.cs | 101 + .../NBC/Core/Network/Protocol/TCP/Client.meta | 8 + .../Protocol/TCP/Client/TCPClientNetwork.cs | 412 ++++ .../TCP/Client/TCPClientNetwork.cs.meta | 11 + .../NBC/Core/Network/Protocol/TCP/Server.meta | 8 + .../Protocol/TCP/Server/TCPServerNetwork.cs | 161 ++ .../TCP/Server/TCPServerNetwork.cs.meta | 11 + .../TCP/Server/TCPServerNetworkChannel.cs | 294 +++ .../Server/TCPServerNetworkChannel.cs.meta | 11 + .../NBC/Core/Network/Roaming/Component.meta | 8 + .../Roaming/Component/RoamingComponent.cs | 254 ++ .../Component/RoamingComponent.cs.meta | 11 + .../Component/SessionRoamingComponent.cs | 279 +++ .../Component/SessionRoamingComponent.cs.meta | 11 + .../Component/SessionRoamingFlgComponent.cs | 23 + .../SessionRoamingFlgComponent.cs.meta | 11 + .../Roaming/Component/TerminusComponent.cs | 138 ++ .../Component/TerminusComponent.cs.meta | 11 + .../NBC/Core/Network/Roaming/Entity.meta | 8 + .../Core/Network/Roaming/Entity/Roaming.cs | 132 + .../Network/Roaming/Entity/Roaming.cs.meta | 11 + .../Core/Network/Roaming/Entity/Terminus.cs | 338 +++ .../Network/Roaming/Entity/Terminus.cs.meta | 11 + .../NBC/Core/Network/Roaming/Handler.meta | 8 + .../Handler/I_GetTerminusIdRequestHandler.cs | 32 + .../I_GetTerminusIdRequestHandler.cs.meta | 11 + .../Handler/I_LinkRoamingRequestHandler.cs | 26 + .../I_LinkRoamingRequestHandler.cs.meta | 11 + .../Handler/I_LockTerminusIdRequestHandler.cs | 35 + .../I_LockTerminusIdRequestHandler.cs.meta | 11 + .../I_TransferTerminusRequestHandler.cs | 22 + .../I_TransferTerminusRequestHandler.cs.meta | 11 + .../Handler/I_UnLinkRoamingRequestHandler.cs | 16 + .../I_UnLinkRoamingRequestHandler.cs.meta | 11 + .../I_UnLockTerminusIdRequestHandler.cs | 36 + .../I_UnLockTerminusIdRequestHandler.cs.meta | 11 + .../NBC/Core/Network/Route/RouteComponent.cs | 82 + .../Core/Network/Route/RouteComponent.cs.meta | 11 + .../NBC/Core/Network/Session/Component.meta | 8 + .../ConsoleSessionHeartbeatComponent.cs | 156 ++ .../ConsoleSessionHeartbeatComponent.cs.meta | 11 + .../Component/SessionIdleCheckerComponent.cs | 103 + .../SessionIdleCheckerComponent.cs.meta | 11 + .../UnitySessionHeartbeatComponent.cs | 153 ++ .../UnitySessionHeartbeatComponent.cs.meta | 11 + .../Core/Network/Session/ProcessSession.meta | 8 + .../ProcessSession/ProcessScheduler.cs | 269 ++ .../ProcessSession/ProcessScheduler.cs.meta | 11 + .../Session/ProcessSession/ProcessSession.cs | 124 + .../ProcessSession/ProcessSession.cs.meta | 11 + .../ProcessSession/ProcessSessionInfo.cs | 17 + .../ProcessSession/ProcessSessionInfo.cs.meta | 11 + .../NBC/Core/Network/Session/Session.cs | 278 +++ .../NBC/Core/Network/Session/Session.cs.meta | 11 + .../Attributes/BsonDefaultValueAttribute.cs | 9 + .../BsonDefaultValueAttribute.cs.meta | 11 + .../Unity/Attributes/BsonElementAttribute.cs | 11 + .../Attributes/BsonElementAttribute.cs.meta | 11 + .../Unity/Attributes/BsonIdAttribute.cs | 9 + .../Unity/Attributes/BsonIdAttribute.cs.meta | 11 + .../Unity/Attributes/BsonIgnoreAttribute.cs | 9 + .../Attributes/BsonIgnoreAttribute.cs.meta | 11 + .../BsonIgnoreIfDefaultAttribute.cs | 11 + .../BsonIgnoreIfDefaultAttribute.cs.meta | 11 + .../Attributes/BsonIgnoreIfNullAttribute.cs | 9 + .../BsonIgnoreIfNullAttribute.cs.meta | 11 + .../NBC/Core/Platform/Unity/Entry.cs | 94 + .../NBC/Core/Platform/Unity/Temp.cs | 108 + .../Unity/ThreadSynchronizationContext.cs | 40 + .../Core/Pool/Concurrent/MultiThreadPool.cs | 37 + .../Pool/Concurrent/MultiThreadPool.cs.meta | 11 + .../Pool/Concurrent/MultiThreadPoolQueue.cs | 76 + .../Concurrent/MultiThreadPoolQueue.cs.meta | 11 + .../NBC/Core/Pool/Interface/IPool.cs | 18 + .../NBC/Core/Pool/Interface/IPool.cs.meta | 11 + FantasyNetTest/NBC/Core/Pool/Normal/Pool.cs | 77 + .../NBC/Core/Pool/Normal/Pool.cs.meta | 11 + .../NBC/Core/Pool/Normal/PoolCore.cs | 203 ++ .../NBC/Core/Pool/Normal/PoolCore.cs.meta | 11 + .../Core/Pool/Normal/PoolWithDisposable.cs | 140 ++ .../Pool/Normal/PoolWithDisposable.cs.meta | 11 + FantasyNetTest/NBC/Core/Pool/PoolHelper.cs | 79 + FantasyNetTest/NBC/Core/Scene/ISceneUpdate.cs | 15 + FantasyNetTest/NBC/Core/Scene/Scene.cs | 399 +++ .../NBC/Core/Scene/SceneRuntimeMode.cs | 21 + .../NBC/Core/Scene/SceneRuntimeType.cs | 21 + .../Core/Scene/Scheduler/ISceneScheduler.cs | 11 + .../NBC/Core/Scene/Scheduler/MainScheduler.cs | 77 + .../Scene/Scheduler/MultiThreadScheduler.cs | 103 + .../Scene/Scheduler/ThreadPoolScheduler.cs | 140 ++ .../Core/Scene/Scheduler/ThreadScheduler.cs | 66 + FantasyNetTest/NBC/Core/Scene/SubScene.cs | 154 ++ .../NBC/Core/Serialize/BsonPack.meta | 8 + .../Serialize/BsonPack/BsonPackHelperUnity.cs | 58 + .../BsonPack/BsonPackHelperUnity.cs.meta | 11 + .../NBC/Core/Serialize/Interface.meta | 8 + .../Core/Serialize/Interface/ASerialize.cs | 55 + .../Serialize/Interface/ASerialize.cs.meta | 11 + .../Core/Serialize/Interface/ISerialize.cs | 87 + .../Serialize/Interface/ISerialize.cs.meta | 11 + .../NBC/Core/Serialize/MemoryStreamBuffer.cs | 73 + .../Core/Serialize/MemoryStreamBuffer.cs.meta | 11 + .../Core/Serialize/ProtoBufPackHelper.meta | 8 + .../Serialize/ProtoBufPackHelper/IProto.cs | 9 + .../ProtoBufPackHelper/IProto.cs.meta | 11 + .../ProtoBufPackHelperUnity.cs | 200 ++ .../ProtoBufPackHelperUnity.cs.meta | 11 + .../NBC/Core/Serialize/SerializerManager.cs | 136 ++ .../Core/Serialize/SerializerManager.cs.meta | 11 + .../NBC/Core/Services/ISingletonAwake.cs | 22 + .../NBC/Core/Services/MonoManager.cs | 85 + FantasyNetTest/NBC/Core/Services/Singleton.cs | 65 + FantasyNetTest/NBC/Core/Services/TimeInfo.cs | 77 + FantasyNetTest/NBC/JWT/JWTParseComponent.cs | 74 + FantasyNetTest/NBC/JsonHelper.cs | 54 + FantasyNetTest/NBC/NetMessageDelegate.cs | 29 + FantasyNetTest/NBC/PACK/OuterOpcode.cs | 10 + FantasyNetTest/NBC/PACK/Pack.cs | 143 ++ .../NBC/Plugins/Protobuf-net/BclHelpers.cs | 712 ++++++ .../Plugins/Protobuf-net/BufferExtension.cs | 78 + .../NBC/Plugins/Protobuf-net/BufferPool.cs | 149 ++ .../Protobuf-net/CallbackAttributes.cs | 33 + .../Protobuf-net/Compiler/CompilerContext.cs | 1435 +++++++++++ .../Compiler/CompilerDelegates.cs | 7 + .../Plugins/Protobuf-net/Compiler/Local.cs | 58 + .../NBC/Plugins/Protobuf-net/DataFormat.cs | 49 + .../DiscriminatedUnion.Serializable.cs | 176 ++ .../Protobuf-net/DiscriminatedUnion.cs | 416 ++++ .../NBC/Plugins/Protobuf-net/Extensible.cs | 284 +++ .../Plugins/Protobuf-net/ExtensibleUtil.cs | 118 + .../Protobuf-net/GlobalSuppressions.cs | Bin 0 -> 2750 bytes .../NBC/Plugins/Protobuf-net/Helpers.cs | 638 +++++ .../NBC/Plugins/Protobuf-net/IExtensible.cs | 23 + .../NBC/Plugins/Protobuf-net/IExtension.cs | 58 + .../NBC/Plugins/Protobuf-net/IProtoInputT.cs | 13 + .../NBC/Plugins/Protobuf-net/IProtoOutputT.cs | 55 + .../Plugins/Protobuf-net/ImplicitFields.cs | 29 + .../Plugins/Protobuf-net/KeyValuePairProxy.cs | 44 + .../Plugins/Protobuf-net/Meta/AttributeMap.cs | 108 + .../Plugins/Protobuf-net/Meta/BasicList.cs | 267 ++ .../Plugins/Protobuf-net/Meta/CallbackSet.cs | 110 + .../NBC/Plugins/Protobuf-net/Meta/MetaType.cs | 2171 +++++++++++++++++ .../Plugins/Protobuf-net/Meta/ProtoSyntax.cs | 17 + .../Protobuf-net/Meta/RuntimeTypeModel.cs | 2036 ++++++++++++++++ .../NBC/Plugins/Protobuf-net/Meta/SubType.cs | 97 + .../Protobuf-net/Meta/TypeAddedEventArgs.cs | 33 + .../Protobuf-net/Meta/TypeFormatEventArgs.cs | 64 + .../Meta/TypeModel.InputOutput.cs | 45 + .../Plugins/Protobuf-net/Meta/TypeModel.cs | 1696 +++++++++++++ .../Plugins/Protobuf-net/Meta/ValueMember.cs | 855 +++++++ .../Plugins/Protobuf-net/NetObjectCache.cs | 190 ++ .../NBC/Plugins/Protobuf-net/PrefixStyle.cs | 26 + .../Protobuf-net/ProtoContractAttribute.cs | 175 ++ .../Protobuf-net/ProtoConverterAttribute.cs | 13 + .../Protobuf-net/ProtoEnumAttribute.cs | 36 + .../Plugins/Protobuf-net/ProtoException.cs | 30 + .../Protobuf-net/ProtoIgnoreAttribute.cs | 40 + .../Protobuf-net/ProtoIncludeAttribute.cs | 60 + .../Plugins/Protobuf-net/ProtoMapAttribute.cs | 29 + .../Protobuf-net/ProtoMemberAttribute.cs | 228 ++ .../NBC/Plugins/Protobuf-net/ProtoReader.cs | 1444 +++++++++++ .../NBC/Plugins/Protobuf-net/ProtoWriter.cs | 1003 ++++++++ .../Protobuf-net/SerializationContext.cs | 76 + .../NBC/Plugins/Protobuf-net/Serializer.cs | 514 ++++ .../Serializers/ArrayDecorator.cs | 310 +++ .../Serializers/BlobSerializer.cs | 59 + .../Serializers/BooleanSerializer.cs | 41 + .../Serializers/ByteSerializer.cs | 42 + .../Serializers/CharSerializer.cs | 32 + .../Serializers/CompiledSerializer.cs | 88 + .../Serializers/DateTimeSerializer.cs | 65 + .../Serializers/DecimalSerializer.cs | 42 + .../Serializers/DefaultValueDecorator.cs | 259 ++ .../Serializers/DoubleSerializer.cs | 42 + .../Serializers/EnumSerializer.cs | 267 ++ .../Serializers/FieldDecorator.cs | 104 + .../Serializers/GuidSerializer.cs | 43 + .../Serializers/IProtoSerializer.cs | 64 + .../Serializers/IProtoTypeSerializer.cs | 20 + .../Serializers/ISerializerProxy.cs | 10 + .../ImmutableCollectionDecorator.cs | 304 +++ .../Serializers/Int16Serializer.cs | 42 + .../Serializers/Int32Serializer.cs | 42 + .../Serializers/Int64Serializer.cs | 41 + .../Protobuf-net/Serializers/ListDecorator.cs | 579 +++++ .../Protobuf-net/Serializers/MapDecorator.cs | 298 +++ .../Serializers/MemberSpecifiedDecorator.cs | 76 + .../Serializers/NetObjectSerializer.cs | 64 + .../Protobuf-net/Serializers/NullDecorator.cs | 167 ++ .../Serializers/ParseableSerializer.cs | 111 + .../Serializers/PropertyDecorator.cs | 167 ++ .../Serializers/ProtoDecoratorBase.cs | 24 + .../Serializers/ReflectedUriDecorator.cs | 90 + .../Serializers/SByteSerializer.cs | 45 + .../Serializers/SingleSerializer.cs | 45 + .../Serializers/StringSerializer.cs | 41 + .../Serializers/SubItemSerializer.cs | 138 ++ .../Serializers/SurrogateSerializer.cs | 157 ++ .../Serializers/SystemTypeSerializer.cs | 46 + .../Protobuf-net/Serializers/TagDecorator.cs | 108 + .../Serializers/TimeSpanSerializer.cs | 63 + .../Serializers/TupleSerializer.cs | 339 +++ .../Serializers/TypeSerializer.cs | 798 ++++++ .../Serializers/UInt16Serializer.cs | 43 + .../Serializers/UInt32Serializer.cs | 43 + .../Serializers/UInt64Serializer.cs | 43 + .../Protobuf-net/Serializers/UriDecorator.cs | 62 + .../ServiceModel/ProtoBehaviorAttribute.cs | 35 + .../ProtoBehaviorExtensionElement.cs | 29 + .../ServiceModel/ProtoEndpointBehavior.cs | 82 + .../ServiceModel/ProtoOperationBehavior.cs | 52 + .../ServiceModel/XmlProtoSerializer.cs | 208 ++ .../NBC/Plugins/Protobuf-net/SubItemToken.cs | 16 + .../NBC/Plugins/Protobuf-net/WireType.cs | 50 + FantasyNetTest/NBC/SessionHelper.cs | 27 + FantasyNetTest/Network.zip | Bin 0 -> 251267 bytes FantasyNetTest/Program.cs | 16 + FantasyNetTest/TestProtocol.cs | 26 + FantasyNetTest/UnityEngine/Mathf.cs | 6 + FantasyNetTest/UnityEngine/Time.cs | 18 + FantasyNetTest/Utils/CoderLoader.cs | 122 + FantasyNetTest/Utils/NamespaceHelper.cs | 44 + global.json | 7 + 443 files changed, 53734 insertions(+) create mode 100644 .gitignore create mode 100644 .idea/.idea.FantasyNetTest/.idea/.gitignore create mode 100644 .idea/.idea.FantasyNetTest/.idea/encodings.xml create mode 100644 .idea/.idea.FantasyNetTest/.idea/indexLayout.xml create mode 100644 .vs/FantasyNetTest/DesignTimeBuild/.dtbcache.v2 create mode 100644 .vs/FantasyNetTest/FileContentIndex/1b16a2e7-1bb2-4c3c-9d14-af55c9c33fc6.vsidx create mode 100644 .vs/FantasyNetTest/FileContentIndex/63aeb925-4ffa-4456-9651-416f182bf989.vsidx create mode 100644 .vs/FantasyNetTest/FileContentIndex/64c8bdfc-9971-43cd-9e5b-02cd88a5d378.vsidx create mode 100644 .vs/FantasyNetTest/FileContentIndex/803edca7-6048-4b38-896e-1c612aa4ddfb.vsidx create mode 100644 .vs/FantasyNetTest/FileContentIndex/a276d935-05f6-4ffd-9ee0-d04eb5db88f8.vsidx create mode 100644 .vs/FantasyNetTest/v17/.futdcache.v2 create mode 100644 .vs/FantasyNetTest/v17/.suo create mode 100644 .vs/FantasyNetTest/v17/DocumentLayout.json create mode 100644 .vs/ProjectEvaluation/fantasynettest.metadata.v7.bin create mode 100644 .vs/ProjectEvaluation/fantasynettest.projects.v7.bin create mode 100644 FantasyNetTest.sln create mode 100644 FantasyNetTest.sln.DotSettings.user create mode 100644 FantasyNetTest/Config.cs create mode 100644 FantasyNetTest/Config.json create mode 100644 FantasyNetTest/FantasyNetTest.csproj create mode 100644 FantasyNetTest/FantasyNetTest.csproj.user create mode 100644 FantasyNetTest/Form1.Designer.cs create mode 100644 FantasyNetTest/Form1.cs create mode 100644 FantasyNetTest/Form1.resx create mode 100644 FantasyNetTest/Loader/ScriptLoader.cs create mode 100644 FantasyNetTest/Log.cs create mode 100644 FantasyNetTest/LoginTask.cs create mode 100644 FantasyNetTest/NBC.zip create mode 100644 FantasyNetTest/NBC/Core/Assembly/AssemblyInfo.cs create mode 100644 FantasyNetTest/NBC/Core/Assembly/AssemblySystem.cs create mode 100644 FantasyNetTest/NBC/Core/Assembly/IAssembly.cs create mode 100644 FantasyNetTest/NBC/Core/Attributes/Attributes.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/CircularBuffer.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/ConcurrentOneToManyListPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/ConcurrentOneToManyQueuePool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/HashSetPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/ListPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyHashSetPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyListPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyQueuePool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/ReuseList.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/SortedConcurrentOneToManyListPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/SortedOneToManyHashSetPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Collection/SortedOneToManyListPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Dictionary/DictionaryExtensions.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Dictionary/DictionaryPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Dictionary/DoubleMapDictionaryPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Dictionary/EntityDictionary.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Dictionary/OneToManyDictionaryPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Dictionary/OneToManySortedDictionaryPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Dictionary/ReuseDictionary.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/Dictionary/SortedDictionaryPool.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueGenerics.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueItem.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueSimple.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTable.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableBase.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableDesc.cs create mode 100644 FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableNode.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLock.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLock.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockComponent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockQueue.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockQueue.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/WaitCoroutineLock.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/WaitCoroutineLock.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/EntityComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/EventComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/EventComponent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface/IEvent.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface/IEvent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/MessagePoolComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/Interface/TimerHandler.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/Interface/TimerHandler.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerAction.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerScheduler/TimerSchedulerNet.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerScheduler/TimerSchedulerNetUnity.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerType.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Entity.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/EntityPool.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/EntityReference.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISingleCollectionRoot.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISingleCollectionRoot.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedDataBase.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedDataBase.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedMultiEntity.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedMultiEntity.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedSingleCollection.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedSingleCollection.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedTransfer.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedTransfer.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IAwakeSystem.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IAwakeSystem.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/ICustomEntitiesSystem.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/ICustomEntitiesSystem.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IDeserializeSystem.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IDeserializeSystem.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IDestroySystem.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IDestroySystem.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IEntitiesSystem.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IEntitiesSystem.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IFrameUpdateSystem.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IFrameUpdateSystem.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IUpdateSystem.cs create mode 100644 FantasyNetTest/NBC/Core/Entitas/Interface/System/IUpdateSystem.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Event/EventArgs.cs create mode 100644 FantasyNetTest/NBC/Core/Event/EventDispatcher.cs create mode 100644 FantasyNetTest/NBC/Core/Event/IEventDispatcher.cs create mode 100644 FantasyNetTest/NBC/Core/FTask/Builder/AsyncFTaskCompletedMethodBuilder.cs create mode 100644 FantasyNetTest/NBC/Core/FTask/Builder/AsyncFTaskMethodBuilder.cs create mode 100644 FantasyNetTest/NBC/Core/FTask/Builder/AsyncFVoidMethodBuilder.cs create mode 100644 FantasyNetTest/NBC/Core/FTask/FCancellationToken/FCancellationToken.cs create mode 100644 FantasyNetTest/NBC/Core/FTask/FTask.Extension/FTask.Factory.cs create mode 100644 FantasyNetTest/NBC/Core/FTask/FTask.Extension/FTask.Tools.cs create mode 100644 FantasyNetTest/NBC/Core/FTask/Task/FTask.cs create mode 100644 FantasyNetTest/NBC/Core/FTask/Task/FTaskCompleted.cs create mode 100644 FantasyNetTest/NBC/Core/FTask/Task/FVoid.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/ByteHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/EncryptHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/FileHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/HashCodeHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientHelper.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientPool.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientPool.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Helper/HttpClient/IJsonRpcRequest.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/HttpClient/IJsonRpcRequest.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Helper/JsonHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/NetworkHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/RandomHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/RandomHelperWebgl.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/SocketHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/TimeHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/WebSocketHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Helper/WinPeriod.cs create mode 100644 FantasyNetTest/NBC/Core/IdFactory/Default/EntityIdStruct.cs create mode 100644 FantasyNetTest/NBC/Core/IdFactory/Default/RuntimeIdStruct.cs create mode 100644 FantasyNetTest/NBC/Core/IdFactory/IdFactoryHelper.cs create mode 100644 FantasyNetTest/NBC/Core/IdFactory/IdFactoryType.cs create mode 100644 FantasyNetTest/NBC/Core/IdFactory/Interface/IIdFactory.cs create mode 100644 FantasyNetTest/NBC/Core/IdFactory/Interface/IIdFactoryTool.cs create mode 100644 FantasyNetTest/NBC/Core/IdFactory/World/WorldEntityIdFactory.cs create mode 100644 FantasyNetTest/NBC/Core/IdFactory/World/WorldRuntimeIdFactory.cs create mode 100644 FantasyNetTest/NBC/Core/InnerErrorCode.cs create mode 100644 FantasyNetTest/NBC/Core/Log/ILog.cs create mode 100644 FantasyNetTest/NBC/Core/Log/Log.cs create mode 100644 FantasyNetTest/NBC/Core/Log/UnityLog.cs create mode 100644 FantasyNetTest/NBC/Core/LowLevel/FixedBytes.cs create mode 100644 FantasyNetTest/NBC/Core/LowLevel/XxHash.cs create mode 100644 FantasyNetTest/NBC/Core/Network/MemoryStreamBufferPool.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IMessageHandler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IMessageHandler.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IRouteMessageHandler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IRouteMessageHandler.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Dispatcher/MessageDispatcherComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Dispatcher/MessageDispatcherComponent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/IMessage.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/InnerMessage.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/BufferPacketParser.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/BufferPacketParser.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/CircularBufferPacketParser.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/CircularBufferPacketParser.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/OuterBufferPacketParserHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/OuterBufferPacketParserHelper.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/ReadOnlyMemoryPacketParser.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/ReadOnlyMemoryPacketParser.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APackInfo.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APackInfo.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APacketParser.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APacketParser.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/OpCode.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/InnerPackInfo.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/InnerPackInfo.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/OuterPackInfo.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/OuterPackInfo.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/ProcessPackInfo.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/ProcessPackInfo.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/Packet.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/PacketParser/PacketParserFactory.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Scheduler/ClientMessageScheduler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Scheduler/InnerMessageScheduler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Scheduler/Interface/ANetworkMessageScheduler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/MessageSender.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/NetworkMessagingComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/OnNetworkMessageUpdateCheckTimeout.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Message/Scheduler/OuterMessageScheduler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/Exception/ScanException.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/HTTP/HTTPServerNetwork.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/HTTP/SceneContextFilter.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/Interface/AClientNetwork.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/Interface/ANetwork.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/Interface/ANetworkServerChannel.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/Interface/INetworkChannel.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/Kcp.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/Kcp.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c/kcp.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c/kcp.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define/system.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define/system.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include/kcp.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include/kcp.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Client/KCPClientNetwork.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Client/KCPClientNetwork.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/KCPSettings.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/KcpHeader.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByArrayPool.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByArrayPool.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByPipe.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByPipe.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkChannel.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkChannel.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/NetworkProtocolFactory.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/NetworkProtocolType.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/NetworkThreadComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client/TCPClientNetwork.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client/TCPClientNetwork.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetwork.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetwork.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetworkChannel.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetworkChannel.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Component.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Component/RoamingComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Component/RoamingComponent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingComponent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingFlgComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingFlgComponent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Component/TerminusComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Component/TerminusComponent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Entity.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Entity/Roaming.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Entity/Roaming.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Entity/Terminus.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Entity/Terminus.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_GetTerminusIdRequestHandler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_GetTerminusIdRequestHandler.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LinkRoamingRequestHandler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LinkRoamingRequestHandler.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LockTerminusIdRequestHandler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LockTerminusIdRequestHandler.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_TransferTerminusRequestHandler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_TransferTerminusRequestHandler.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLinkRoamingRequestHandler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLinkRoamingRequestHandler.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLockTerminusIdRequestHandler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLockTerminusIdRequestHandler.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Route/RouteComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Route/RouteComponent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Session/Component.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Session/Component/ConsoleSessionHeartbeatComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Session/Component/ConsoleSessionHeartbeatComponent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Session/Component/SessionIdleCheckerComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Session/Component/SessionIdleCheckerComponent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Session/Component/UnitySessionHeartbeatComponent.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Session/Component/UnitySessionHeartbeatComponent.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Session/ProcessSession.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessScheduler.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessScheduler.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSession.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSession.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSessionInfo.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSessionInfo.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Network/Session/Session.cs create mode 100644 FantasyNetTest/NBC/Core/Network/Session/Session.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonDefaultValueAttribute.cs create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonDefaultValueAttribute.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonElementAttribute.cs create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonElementAttribute.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIdAttribute.cs create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIdAttribute.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreAttribute.cs create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreAttribute.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfDefaultAttribute.cs create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfDefaultAttribute.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfNullAttribute.cs create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfNullAttribute.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Entry.cs create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/Temp.cs create mode 100644 FantasyNetTest/NBC/Core/Platform/Unity/ThreadSynchronizationContext.cs create mode 100644 FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPool.cs create mode 100644 FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPool.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPoolQueue.cs create mode 100644 FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPoolQueue.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Pool/Interface/IPool.cs create mode 100644 FantasyNetTest/NBC/Core/Pool/Interface/IPool.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Pool/Normal/Pool.cs create mode 100644 FantasyNetTest/NBC/Core/Pool/Normal/Pool.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Pool/Normal/PoolCore.cs create mode 100644 FantasyNetTest/NBC/Core/Pool/Normal/PoolCore.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Pool/Normal/PoolWithDisposable.cs create mode 100644 FantasyNetTest/NBC/Core/Pool/Normal/PoolWithDisposable.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Pool/PoolHelper.cs create mode 100644 FantasyNetTest/NBC/Core/Scene/ISceneUpdate.cs create mode 100644 FantasyNetTest/NBC/Core/Scene/Scene.cs create mode 100644 FantasyNetTest/NBC/Core/Scene/SceneRuntimeMode.cs create mode 100644 FantasyNetTest/NBC/Core/Scene/SceneRuntimeType.cs create mode 100644 FantasyNetTest/NBC/Core/Scene/Scheduler/ISceneScheduler.cs create mode 100644 FantasyNetTest/NBC/Core/Scene/Scheduler/MainScheduler.cs create mode 100644 FantasyNetTest/NBC/Core/Scene/Scheduler/MultiThreadScheduler.cs create mode 100644 FantasyNetTest/NBC/Core/Scene/Scheduler/ThreadPoolScheduler.cs create mode 100644 FantasyNetTest/NBC/Core/Scene/Scheduler/ThreadScheduler.cs create mode 100644 FantasyNetTest/NBC/Core/Scene/SubScene.cs create mode 100644 FantasyNetTest/NBC/Core/Serialize/BsonPack.meta create mode 100644 FantasyNetTest/NBC/Core/Serialize/BsonPack/BsonPackHelperUnity.cs create mode 100644 FantasyNetTest/NBC/Core/Serialize/BsonPack/BsonPackHelperUnity.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Serialize/Interface.meta create mode 100644 FantasyNetTest/NBC/Core/Serialize/Interface/ASerialize.cs create mode 100644 FantasyNetTest/NBC/Core/Serialize/Interface/ASerialize.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Serialize/Interface/ISerialize.cs create mode 100644 FantasyNetTest/NBC/Core/Serialize/Interface/ISerialize.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Serialize/MemoryStreamBuffer.cs create mode 100644 FantasyNetTest/NBC/Core/Serialize/MemoryStreamBuffer.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper.meta create mode 100644 FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/IProto.cs create mode 100644 FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/IProto.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/ProtoBufPackHelperUnity.cs create mode 100644 FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/ProtoBufPackHelperUnity.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Serialize/SerializerManager.cs create mode 100644 FantasyNetTest/NBC/Core/Serialize/SerializerManager.cs.meta create mode 100644 FantasyNetTest/NBC/Core/Services/ISingletonAwake.cs create mode 100644 FantasyNetTest/NBC/Core/Services/MonoManager.cs create mode 100644 FantasyNetTest/NBC/Core/Services/Singleton.cs create mode 100644 FantasyNetTest/NBC/Core/Services/TimeInfo.cs create mode 100644 FantasyNetTest/NBC/JWT/JWTParseComponent.cs create mode 100644 FantasyNetTest/NBC/JsonHelper.cs create mode 100644 FantasyNetTest/NBC/NetMessageDelegate.cs create mode 100644 FantasyNetTest/NBC/PACK/OuterOpcode.cs create mode 100644 FantasyNetTest/NBC/PACK/Pack.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/BclHelpers.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/BufferExtension.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/BufferPool.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/CallbackAttributes.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/CompilerContext.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/CompilerDelegates.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/Local.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/DataFormat.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/DiscriminatedUnion.Serializable.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/DiscriminatedUnion.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Extensible.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ExtensibleUtil.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/GlobalSuppressions.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Helpers.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/IExtensible.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/IExtension.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/IProtoInputT.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/IProtoOutputT.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ImplicitFields.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/KeyValuePairProxy.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/AttributeMap.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/BasicList.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/CallbackSet.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/MetaType.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/ProtoSyntax.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/RuntimeTypeModel.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/SubType.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeAddedEventArgs.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeFormatEventArgs.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeModel.InputOutput.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeModel.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/ValueMember.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/NetObjectCache.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/PrefixStyle.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoContractAttribute.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoConverterAttribute.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoEnumAttribute.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoException.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoIgnoreAttribute.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoIncludeAttribute.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoMapAttribute.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoMemberAttribute.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoReader.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoWriter.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/SerializationContext.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ArrayDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/BlobSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/BooleanSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ByteSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/CharSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/CompiledSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DateTimeSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DecimalSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DefaultValueDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DoubleSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/EnumSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/FieldDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/GuidSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/IProtoSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/IProtoTypeSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ISerializerProxy.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ImmutableCollectionDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int16Serializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int32Serializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int64Serializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ListDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/MapDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/MemberSpecifiedDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/NetObjectSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/NullDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ParseableSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/PropertyDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ProtoDecoratorBase.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ReflectedUriDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SByteSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SingleSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/StringSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SubItemSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SurrogateSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SystemTypeSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TagDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TimeSpanSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TupleSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TypeSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt16Serializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt32Serializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt64Serializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UriDecorator.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoBehaviorAttribute.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoBehaviorExtensionElement.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoEndpointBehavior.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoOperationBehavior.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/XmlProtoSerializer.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/SubItemToken.cs create mode 100644 FantasyNetTest/NBC/Plugins/Protobuf-net/WireType.cs create mode 100644 FantasyNetTest/NBC/SessionHelper.cs create mode 100644 FantasyNetTest/Network.zip create mode 100644 FantasyNetTest/Program.cs create mode 100644 FantasyNetTest/TestProtocol.cs create mode 100644 FantasyNetTest/UnityEngine/Mathf.cs create mode 100644 FantasyNetTest/UnityEngine/Time.cs create mode 100644 FantasyNetTest/Utils/CoderLoader.cs create mode 100644 FantasyNetTest/Utils/NamespaceHelper.cs create mode 100644 global.json diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..afc62bb --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +obj/ +bin/ diff --git a/.idea/.idea.FantasyNetTest/.idea/.gitignore b/.idea/.idea.FantasyNetTest/.idea/.gitignore new file mode 100644 index 0000000..e08cf47 --- /dev/null +++ b/.idea/.idea.FantasyNetTest/.idea/.gitignore @@ -0,0 +1,13 @@ +# 默认忽略的文件 +/shelf/ +/workspace.xml +# Rider 忽略的文件 +/contentModel.xml +/modules.xml +/projectSettingsUpdater.xml +/.idea.FantasyNetTest.iml +# 基于编辑器的 HTTP 客户端请求 +/httpRequests/ +# Datasource local storage ignored files +/dataSources/ +/dataSources.local.xml diff --git a/.idea/.idea.FantasyNetTest/.idea/encodings.xml b/.idea/.idea.FantasyNetTest/.idea/encodings.xml new file mode 100644 index 0000000..df87cf9 --- /dev/null +++ b/.idea/.idea.FantasyNetTest/.idea/encodings.xml @@ -0,0 +1,4 @@ + + + + \ No newline at end of file diff --git a/.idea/.idea.FantasyNetTest/.idea/indexLayout.xml b/.idea/.idea.FantasyNetTest/.idea/indexLayout.xml new file mode 100644 index 0000000..7b08163 --- /dev/null +++ b/.idea/.idea.FantasyNetTest/.idea/indexLayout.xml @@ -0,0 +1,8 @@ + + + + + + + + \ No newline at end of file diff --git a/.vs/FantasyNetTest/DesignTimeBuild/.dtbcache.v2 b/.vs/FantasyNetTest/DesignTimeBuild/.dtbcache.v2 new file mode 100644 index 0000000000000000000000000000000000000000..bc2f8ef4bcdce76034ca53a9ba134d7b78e7d4e9 GIT binary patch literal 116420 zcmdUY4V)Zheg9Yip~uwY9a{+S=OM+S=OM+S=NA8e6TE_W%7o&-`{~pPkvA z+nG80htDtf+nw+1^ZR}0dHFrBv(mtSXAGJX^{KnJ6=zor4DY|&xM+JlU&sw)veV{3 zsaVV8i`C&wrIybW1~avcanjCAp=ugShbyJSX12C7Uz{>4&>;f$t{zca+!@=wrtqAA-AbNyU{ew4VyP?*^-%@nA|Wq*+1F0Wy6+r z8~WC6FqX+=M`w%K=}M`XztgM?lyauAV58AHXjb!6MYA$eFV^xi=Fm*JV9uDZua++r zZDaP;Yvp=vSEW=h8`FbZ$7g1%W?^!CS7yenj_=F>T%Fx(*2c_gP5)S$I6N+i7%!T& z&8faM$MVHo>6m_7DrcJkrCd!Nu9k|%rOm(W1xdmf<0b8I#!2eOc12{iF&KsO#`M6} zagaMz$;_dCI21NMqQ zSmV?&N%3%|Hf=22SuYf%cFIVpR2$4!@D-j|5t-juwBvZqELKrcjMGNU0?N!$lMsvW z4+?RqGHWazF|+kb)xNNBD2K9@ugx0g4VshrB1$p|N>ELP|4xUT3po#RKI8((g^=Ztmq0FpTnxDcvI24`YiIMd`|hjPG7|+el`9mCJo5Ses#&RyZ|vK!cGGyOSVt)tFK4nxGE*pD)!Ayz zoJm#8$pW4Xo>*$etYvbjddIh*y!DM2@)LF)H9o4aBMx?tjg?7V+~NAs4yMdBigXsW zaHg0k%vST&RJJrTQ!0+HPxY^FHYe*Y>r`=X<6A0bwN$TU&8oC(RZw8m2IfpxHPz0* zpungN#PfG*uyzIp1x9V)WF?@1L4i>ln6CviFeor;0}p2c8Wbvjci&nb);7^Pbf8@Z#2lz%kgiI3V`|5(8@d2|o`ik&Au zYIFS~2hZeFbHqn&u74ciZSEZLQJd=@Rd|~_M|{-g`o|dF=FSlxwYmNghqt+N#7Awe zfBfNX?i}&=Er__{Z5xYtn%qD4TcRe}KREHUI5kIn)aLq!D&FSK5r2Qwd7?wm;%W4{ zZf=Una^D!Ho#k`8>CsS}r>faXzFflqTQ{N5DBr9FMVmVYMSge2=uOAS$IqtCUEdj_ zHyr~bUvIj;Ge&PZ#!bH7bbV)x-gFGBe7))V&KSMv7Er zeoKt@`^SpD_Rsy68146u4t?#P`z^KTFh+l7-;FN$C^le>8uCDbLngouFIvfzGly9>8$^+jAM2t+NHBt zRNGj<8p(3mvz*0d_M%mjN@Gzk zb_QgRn7K8^3S2*ysT8;NZ|dv63jeI7e{5}SU*Bfq)ZR&~7cOIgaus^9RITN(e)US@ z>|V1{DS;na1HKh2cxTEr?C&zp>>TKs5}0TKmRMWu5

dYUkk{9|M{RIP4-IaQ>qLTdJ7;8PAop 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⒞c$BLvMpYVi)CyL}dIq@xFYd9sG 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 SQ~3||^?wg_D_M6$$^QpEw5}ll literal 0 HcmV?d00001 diff --git a/.vs/FantasyNetTest/FileContentIndex/63aeb925-4ffa-4456-9651-416f182bf989.vsidx b/.vs/FantasyNetTest/FileContentIndex/63aeb925-4ffa-4456-9651-416f182bf989.vsidx new file mode 100644 index 0000000000000000000000000000000000000000..6bee42f1c1118ed3422b535ece22aa1874ff14d8 GIT binary patch literal 4674 zcmbW432anV6ozldmPLdDLIBZH#vl^O&=wSE5tvS=(}7vqd9MU;Fd`O^0420BV$_TZ zZfK0gJ&|Y>jk}__B#OqkM-vgZ1mc<)7u=!}Lsb0#bN`t%nwV(Y`+xVGcka38E;A1j zZK+X1oU0q{>}Q{cOM-39#SL5fde*NlrdDp~=_|Ic+}OXeZ%eMHKkVu2|GSy!-MISP zHL+EFKEtI)=4C${dZ6lmC0Wek3`3 zl&{QVt8-OVE>h)2R=FWnuG*BQ_j`@Fi2YSZ+{lO<0(I^P${H9muwNN&X(Mulx!|~&-0Fzi zi(ZABCK7j<@Y)d6wjmjpA993sdDN#vU=xfU`pq%&3IEW4q0DMOY+OQ3I+% zr@xJu0#}Yt;k1A;wqy+C&iENE74pO_35xWW6CF%fsjXyTN^5M38x=h*QOB;wd2WOqU%K z8{}^ko5Y#oERcCm6X(c3S8N8kho_@4ZUGwSS%^k|0*!W?m;~wXKx6zOG(KM}Ww5{b=-`C!Q}}0J7eT&=_|y8skc6v@b!UeVOd7vM-l?g?OcSm3Xzd zUA#uT7G%Eb#Ovk1LH3QZZxU}7ZxL@5Zxe3^S^pifcYw@)r|i3A-!1zdai@5%cpu1d z_sf1jd{BG{lKPo;ZJ}&MOp8y%ZTlQ1p)8aGYvmon#PWJQS9+2Z-6kifw26-;8 zh_8yTiLZ-qh;M?-^Oo$lLC*J%?7bkL@00zW_`djo_@Vd_$npDS9{@T2WARh*bC7j@ zfyVeR(HQp?8vS3({#N!u@jLN*@dxoo@h6aZeinZPng2K0hsEDP&hv-(r+5V9czmbZ zbG$dr#+SO~87x1(&+Yk8@n~@v$nnEvj}U7`ypV0&C~-8%c)YC4KUVfQ+2h3t;&I|c z@pzEq>%@BbCyP;#>z^X~Byp;EvN#Q7+;ounV)DbkzrstZ^L)%Ta7AK*<$4NU0?Q4y7+xVl#BagLd$LgNoX1Z&R2r#1rm4cPk6!%vA12 z6lcJD6NjeZ@4(0cl+~AaJ%M?-ZhAP9+GWa};QpjhEBoAcDswGIe=+(kwwnQzJ3(Cm zWpzAJdYF&89Lndcp6AWX8DvPn%3oye0g4WYa<)I5|n zm1oO%eo~vEoY&tM-f7m(z4y0`nzO#o!pP9Z@|F~^>iM>k6qIAQUsUcR)%Q6kPlcL? zGABPR{H(BE(%-fQ^mxDR3_oqWr%}_a zsn5%s%iBlgdU%ig-g7?g2Up8k(@@UiZ+wV({oZ9z4OhXMvQVC3HzL!{?+a&Wv09Th zhRQWknT2)nj<&ip%wM#ci*{T5XN8)?%)D7e#3Z1MqLx2h>}Smr*f%t#8m(5=H{wA$ K@w4d|&%Xe)4z+Lq literal 0 HcmV?d00001 diff --git a/.vs/FantasyNetTest/FileContentIndex/64c8bdfc-9971-43cd-9e5b-02cd88a5d378.vsidx b/.vs/FantasyNetTest/FileContentIndex/64c8bdfc-9971-43cd-9e5b-02cd88a5d378.vsidx new file mode 100644 index 0000000000000000000000000000000000000000..88f97c8f4353964e37dcaa17e805bd3b1c899b52 GIT binary patch literal 17093 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 literal 0 HcmV?d00001 diff --git a/.vs/FantasyNetTest/FileContentIndex/803edca7-6048-4b38-896e-1c612aa4ddfb.vsidx b/.vs/FantasyNetTest/FileContentIndex/803edca7-6048-4b38-896e-1c612aa4ddfb.vsidx new file mode 100644 index 0000000000000000000000000000000000000000..f1339df72bf0c1b626fa3c516d69c14162529ad7 GIT binary patch literal 8344 zcmZ9R2Ygh;7RJYhUBupv*bzB?OY)u)B~1P!bizf~diQh(xgW-V65Ld&h#< zd+)FJ_k6|Y>-v4?{`dKQFWG$mx#!NDIWu!+?qz9dZ5y^+N;7Lx{4{1rBgNL;Cr_U> zF!j&_Cb#uZpE@vkRR3W!`v+zfrp~NP9hmw5mmM<>%u&j?3XGHKsHt%KN0WYD$Vp_2or%bZhl6%D#43WYpcJl$MQx zD#)SkE?vDGkVKbtnIGI#Qd>$2Qq5(oiH}C1 zvU=C0?5eNN!jxvjgez@i*E}><*HmRy%POm()>Khl6?YXS^BBkh*(q2hUQ0Qb)mbvMxilu@PDGpB9vvBl(wrb zhnmPTFDfhS;n9&Imr)ltp3dQo(3SHH|83Xxmq} zhVH8O%=4(YtMw{}Pfd<;UUyYz^YEtm?~BVLQfiKQP(yiZNojgY%crzMbq;I7uGr>B zHTh`_4|1il2CiEwtL=g)tGC$qzzt>baAE*gtIYN**(imJ(ou=GcEeHZ0< zu`$;QZ&`i0RkcOYaIa{khHJ)5LQ!7E7loExp=O2d(VRnszQVr!zZvPc$%CqF8v_j%!MFb1fas-_HIGP+Y> zDyXeg74*^E)<#3knZcYRQAjjo{jF9k?!B53Ub4fEz+hXtduL*1%2RaJVVl3~C2O zyDi|BP%9YrI=B_w8rH*YU=D5zN5Ji%c6RvN0qzKQf;+=qpbn>~zZ={gHb8B~xW5O~ zsUO!$j$k8fg3Yi6w!%ErArtM|;Aq$m$H1|$19rj!EW$204whgUYHvh;+NZ$@up8=( z4SO$~2q(eGaBsK|oC5n`Kin7Y2lt0l;Q{bKI1L^I4~BZbh`0`gI$-1aFgODq4v&CG z!T~rF9tDqv$G~Huo(|z(hfq+5LhyK~x2?E70nUYk@I*Kd&W9(#li?}wRCpRZ9i9Qt zglECC;W_YJcpf|-UH~tI7r~3+CGb*s8N3``0k4Et!K>jl@LIS4UI(v-H^3X=P4H%T z3%nKH25*OVz&qhx@NReyycgaF?}rb-2jN5TVfYAq6g~zYhflyK;ZyKw_zYYKpM}rC z=iv)*5quFYhA+XF;VbY}_!@j2z5(BaZ^5_WJMdlj9(*5u06&Bu!H?l5@Kg91{2YD( zzl2}GAHg5PpTM8OpTVEQU%+3&U%_9)-@xC(-@)I*KftfyAK{ez-5(5AF}A!UN!ea2h-a9t;nG zhr;RbFgODq4v&CG!T~rF9tDqv$G~IZEO;E84UdO&;0bUp9E2yrd2l{F37!m3fv3XL z;OX!TcqTjxo(<1|=fd;g`S1dGA-o7)3@?F~!pq?0@CtY(yb4|ouYuRX1@Jm}J-h+l z2ycQn!&~63@HTimyaV0|?}B&3d*HqBK6pQT06qvGf)B$-;G^&{_&9t5J_(+lWuCVUIN4c~$9!uR0&@B{cE{0M#wKY^dZ z&*10q3-~4c3XWM(4?+D5(cdQe2BjjMlG^nJ&TN%8)fYkqX-V8HY_(C#Iz|7AuhXx! zLE5A*J!|!yN>SRbR<)@k$_2HpRjFB8(j99>T1lg&Q&h`d8q(JKtxGxi>5?|fo|Css zi%~8~TjebmQCV#nCEq!H_h!5MwU(u0LOXPolht=Uikz%1p;>vn$`$o#wZ&0cd!^m7 zkBm|5sYvVe#lobtw`?AnTeQ%wN#7}Y{4Mfe9V>0sueCk2DD^n4wsc0#PQ}us*xY}Y zew!4b{gm`)wYQQ+W-WxerpIP=FXix1R;M~C)` zp2N|qUzWP2vm~!;?|Wycv#dpPWpzF0j{7V~y;Ho>uJ4Gg?%VgQU7_Pboi$$lcJ)$} zdcRn0@yuB3Lfw}mY}Z^jNhiv`_dtWxtL+n{s3@E{&f^AYS?Zl^&2rki(B)pK^TnFw zdO>B6!a z*l!B%$?MY;b+R`MzbV+_wvNy0bGljcX7wojr1kSVJ0Ck$_Rg`omB(ZCDejf?`Q_ey zzGi2c)pnme*;(k*#jBbLVwnhCGVY}LqXUYrA-oqW7aTb9<}P_DY+5Wi;YXT3Eueh>V#0pS1u literal 0 HcmV?d00001 diff --git a/.vs/FantasyNetTest/FileContentIndex/a276d935-05f6-4ffd-9ee0-d04eb5db88f8.vsidx b/.vs/FantasyNetTest/FileContentIndex/a276d935-05f6-4ffd-9ee0-d04eb5db88f8.vsidx new file mode 100644 index 0000000000000000000000000000000000000000..cc0838b86103f15f5e21e14b83590174654b2dbd GIT binary patch literal 712427 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π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�?+BZsk{t9L1b z7`=-p`|!z;#wtX|Fsc)E0^bQy5i;Bsxr5fryk-g z(FH1V?hsa`i>_wzIv%U8bdp#^H!}DbJ3emxvK`0*=X!IUB0{W`-c23F_Eye9@PDt| zJN!S&_L3~V;om6t#H@;aoyvG&UCCx7-t*{Nz|2MF6_Z`g2`5i9M;f8Tg{yIBJ=$+X z@)O9^z;_GE9TTp{X2cPUAPYM4;~q?rwrUE8iu0Moq(UZdVu8-UiKwZ`pc;_1Sh5=5 zuE!JWEXqN^Qq#Q*bs0j82kZ&VK7wpAqcg|!U~|oLwL7mixsaK4kvRc-*P?ubt+Fm& zk8%e@gQ9K4*&eVs>EI!Ql>WoW)m(!N$Mdsouogptv3@4lXw#i3u>r>v)+pi`X+*Vr zUBtAy7&-wjEwS*08&>1Zb$D^TEkShJit}5r_<-RGjeZ0&d+7`IV{Hk^##&FOS>(?O zSyu$CVhdDF^j{RHv=(Wr(RV%SXgzi-f_m5V?e^+*wmnl}j6lBqS@pB$i?~~>-`aVX zMNd7*pC>CB3*BL|p#fe`#LKC8z?~-_)y3S#I97e6oK8c%*pYHI9?+?hjt5$zz*+Px zjh!tSm~w+H#C7e0yKjbfjS=a$YOh?Ir`pkW%cry5c5PKR+dr*)al3Xf{KIk8T_yw5 z5_f{z?dn;C^KQ4R+ZfwOjZViYw~@Mc4hmuik@nNwSu|JMULN*7fGb7RFEHujvm)x} z;mXz6untYc&p!{}3#joNsyJmc_GaJk^(8wM$P&aSPhHbE3ZFiOd*b zlH=8GmuJrqc8x)=&Fm`fYY9%dr%R*fYu97fMl^JfdR6R6+i4GKxt_NJ==mnL9LDS; zm`#q3XGJ^aU&qqx`DJHTh-CsI#GW{m)VbZr`8B?cD)2B`|7rvjn@mUU*_k{0O1aHA; zJtVzBjmg?$b{^jBi-y_=(9@!o2kDvh%xKCs5Df>Qp(buaor-1{E-!#@Fly@&a#Gu9 zwbV8`&I(x_C$;S`5rapX)K-%SNo_xygud0!RkT`an_FxqX2qo@wH;l8d=)zl@9qa< zPg?9Tn{UT#vQyhGb%UYMgC^wDQ}@mC3#orv|Dz_Z z-mo5#b$C<{XC-`(gHmWqh$}hnlWt4p34}Jo|4Z9QjXZ^#&m-^x>OY75Pg@Ml%`aXM z<$nH>F}hK8#CKwtc0H;P5izCRMvW2nC1Ze~0fIgij;#4->`l2l({H zok!%HbG4ONF za0Vl78M(%cN`BPFP&;O8p4;AVNL!r)H!|XS^RGH-kA?*|**>y*b6gHc=;+*6fa!IV72UrYxuEK6t8`hRXPbPx#TfZ6i1)D zpeQbmDT*)0A7vcW6A`V+%)oEvW9w4zA*5D|!HzwJ4$nD*6qRzftWeHS`$xxxf*-dq3(Jt*@|pc-YL976mBnD_lp}U zR?u+B=lk$QCM(_SyFqt;FY-__r#4VNlbSS&V)|wh-AhizScZcxD19)EYjP6XF#>yg==$jUr6m!#Rrt0_4 zK+<}oylM4F^Ws$5M%~H-vzRl4IfZtMH%<FH;-#>B9tBD6B_LwI)PQphRW*3=w&Z z^fBFamsxy3U~dTTcA@j1I4Oc(Jj{9|9x!injTrp5@*BSO0;KDidMnS|%C-WN zn#He1#ya@)k)E)lvi26^@h;cgob+q_eR19`*g2F&a*jk;GC8R$9aYY21=ZkPXX^B- z&hT!uIu-pHya>FX!|MgFBWmT_Tq$}Rygu-5x3%=scPLgK-cY$2z$<_^9H~9i zFQ^~9}Wo`m-ccu(NlUs|BpCz2EIf%gi$SB=1ryaDgG z@O}sHWxE|^2XN{jet6%m!`VN<`!l>hn1)BkuXh~YU*LUW8G_$^0q?Ky_QU%c-rwN; z9o|3S{a_j2-dT8`!UMhUO)Bu6pPr9ifL<+nLE|UAE8N~hh+YFK$iS7{c35`WBu$5qp8m=!>3P~+mh6zsn1})oP ze~C=DtCI2!D!)Za6yNKu+=fn)oz!K69=0Juz2KTb_hwFi?$6`vx*&ZS9Ka-9kbKq} z&Z?;dq2xF|q?DfdnXb)RtGgfNU@;p{*)Z(P<0jJWZ!~KKGS1YEd1(PJQ<_#7Rvw-$t~N1o#^uLtalV>6@EvC13AabJe^4tQx@J zFs7<+a^G%VfsG(njwGF4$a6ilcApzfx1y8a@$?j1qrSa}D<-kd5+=;&h(fm5WGBW? zYq@t9^w_*IifL-e-7btyybeoEs9dKlUX0BRyR(kEb%mzsJdsGdkOdM|s_AP}9ea0! z`D=x9%uP;ejZinsyz4T$I`gg=e$T`Ji({_rPJQA1Oa9%9(1j}4f$lqP0vrA{yw~7+ z6F)nEJqJzgrWaGIk$VoK&xi0%T*$(!ukpc2gwFg|99~fp!*#0T@Em2~OJhXKLBr{d zWZYneVzh&s>v>anT1i7g%oykUT)ydUcg^|qxx1_-iy6`n2m?$s5xdN$Ja+}OoFdZC zE8+*L3rkF)9oD7jjeCaUirMHc{o5-1=`m#NGatgxN!+Qv@)X)+nog{wJCA8h@6?sr zHcEB7=aL|{)PY~fA<)r*;yC2gK(cEq7>_%yG-bsp=Wvy-<-24wXo$=PXp@N1sYq;u zT8)tzMtl>nIclXLs|8A%A^vLQH$`PS60e2-dP{+P>N@yug4Y@T8{z*M{1Nzn4u3EB z^A)}ce;@d7hyM=v2f;rS{vq%em}y2_4@9QHKiNn~-iOS71`IN1A#T3$$=*VXruA3A z|1kV(;C}@EmGG}c@+zEt)ZPoB?%!zlP4K%C{!Q>d3I8ulwUxXX(|>8b^PCq@=Q$jE z8gVb8rsU->nS0f~ow$1s{8jLtMUn;qufYGRg&=#cqrn^S{}%q=!T+)?gVcHx-@J|T z-&?NbYht>jOq2ZPefU3s_b$9Y*#@`&7_NK|4L-zGe}Mmw@Eq-)lZt)%Dg58V52`Fmlw12JA%WoST?0Uk^U4Dtd?qA)l$?6y|(nOv7wd!2Kw96f1}k1MMC?3W_wse zw9(Lu((~v5^xtW+Pn83~67gdZRVL|YBo%On+b8oGrw90PKI4=j9W_bRh-4~{&$pdW z{lN-7=K@YcSSY4w3Ga7YXioiL-T#iVA$Ce(5w zk}I-QMhCIxko;GTGn9NqmFvhThSj#`@^wMJ5!|h#cna?-Vxu7}b!xY~B@E0rX~)JH zwt10#K%tYS?U$HPlcwC3XgQFD!dimXLwMOx(=-O=nCx)PT4Q&00Qy_wXiMBEACfsd zJcNse@&U=brS9H^kOn=P+GvkhlY)QQFI$UDv8=1{_IiA@5n*?vXSe~nrsvvD(qt+m zI_rSVq*`evrG2!cNF=q_ph0BPHVyPISx*zeH9#9;#v|!x9dC`sJM8F?FXi?X=3m{d zoB?_9O*E-0cNo$W8dRkY=&~2Gw9<~3KKhQl3b6q0d}IjlXqJgePFr4xH5)F8^w`F{-}osUFPH zB(4|x^)@TTy@D?JnsBjw0qYK8_dfh;Bx~v^6=>;hNPFW5o|?!Z_t>IDkyI{a2Ez3K zpHf5Qv9z4q9WoiT#8w4={V3a3vgTU8D7N-;=(LxdBRrDN$`NabRXyz@2?j^*HjP|l zEcAbm3CWM(o%dLY%##3SCOM0j6|-UvAN0%^@XSIsAHv@(;-Aa;=3?HjAGg$A0ci#_ zXgIx!wN`N3YGz6^@UUqHyfqvVg9I11MMiLt%4KW(*b*C7AUKe<=a{eNmqYoO7^)%s zou+<6d5rk9hWP+z)CB9{7gw2o!q1XzRpBMwcWFWz;TMUhUDx~!e-Xxx=J-Vu>`24q zEzH*P0XJj1UbYEt&@kWaDV%m1r*f@4i|~{7Blw$HwtOVS81>AhNA#)YDK)j5 zpn9>Cjr10%|5fw5hS_dON=$-a(kZ=n(l4z=@69NkLX(3Q;f(|4TAAf6n5exHH6T;0 zlu!mfIzWieYM9lef0bp`=?QFi6#Gx&l*p@Il*5vy^BLXw+mR+tYo>GFH7uHd=pahc zQ8S6zLs)C60Wixal4wW43KD3o<(Q$Y)f($sVrmb(BqOzj2t5V)N`(%Zm$(YFXs)oL zlhf$A#v#z3EAzNS2lX%;UiF z%jfao{HB1V-Fe3#*672*BbnmnyrpBTz^Rl=$1-~ybH{VzM7Gnln#x(Tm_5gME&rvL ztDKi<^+SE7uGkXh%;&L{yn6*}uVIx&Z;#sY%Y_X!;bB1zNp=NdHT4jV)kIY|R%hL% zP*!u*NHv<(bX9=1y$K=yJ*MqpGHF!-zb36y-I%qX+5bj_W;J8|?`SqQbrqV`;57zf z)#$}=tV6KD*zDB-S4qTuG2kl5D$#EYwK}%pzfkJ|L>yifF`}(5|G$7$jklx?7E;y8 z90RK{r0QU5#9>tR6hUFs7&;X+6)qJhjUiIO(TiAAK=ceGo$?Ed{)muJ=tcZ_5q!FF zf8@Wx&d4RO)A!#2rzXO}oNdTUV5h2snsLF-d@cS9c1rbhw^j4AI%h;jXhUu z38Oi?R^9dDbk}3!u;|J8?74*9*D%?^QPqyNtML3|sBsI^g%+Ah5wiwcE8}$FRMTTXawh7Jd9@o<^z zyDwd5*mub~!?}}K?-bghuMqk6!aBn}|7YtAf`8Q;4V^Ed>s&Gc5eI-rwL*=SxKbFn z6UsD>7s1%k8R>|x?q_U!a>~HhtGGnSLrVkc|=NyDa==yo@9_r1t?JfRqx0e#;YjH zO??JtNeJy2-B;HlVFSumW6yeg<92VU5tti(X@4sJDTJOw&8N-VR)ekD&lq7P5+mgR zzI_w7I@R<|NASTe3_FSlSvzW2v0xjjx={qXRCDpJKBlV86wkbv+w^4}#GOF=#=U5v z%ix!bZ%zEz7RNGCsPdPMly1nm+j;Nzz=_c)P%9)8egOjs-X_7PTR9oN>F~{kH```~ zVj+Sv?R%wae}BGhUKH;@&TjL5taSi24&thJtYN%YnX|j#--{AS1x_OV3~v1ifA~=! zfZ8w#*k7A3qSWrP^QuUVgRramQ)x1##2djsOL#ezlRT4o?FWw^S7|UTHZU9&l0ENke;B`FnsS^i#7d^CLli5{D@0WMCX`HS{oWhOOMEV|9sG>*AaHNKxQ z^FQVD+yF-J^(hN6SAD!2t*kgMY9YXKBVQ03&I)fTd81_Hlwz`=2p0 zf5Xr5&eOXS!d(&0g1@7!tjdpFe7=Zot;qS_LPQG%#|+E_#p-`-x+77w;>vgi5iOql zWJjD&ePtSB^QI~>BpN03Kw~WkU27e2TXlgzfGHpoeU=(Q08<3iT_)ZAwV|T<$GEr3M ztwJc;qjxu4J{*C&%s1=}ah_vwncCYD6nnNM^oIwKIu8l*k&Bg*C*a?V^IAK7-Z)H^ z65p?!V16fFc?N}BjHpy8$$AU-2$>(i%eoW?G3^k3a>M=Ohp|8y?_=5gdMR9-)q1+itNGW7;rtqLMMru+!0%gXuG zA|^b@RM+%H^rS6e{Cs}2iZwL^SiSb^V~7&tl=&#S90wcvcquL&ZCqJ);VDEr}c=lyvaxk<7ox z{0GYKWrarPQ|T8`Gn*B~43(M{PyPE@E`N*?qw;pj-*^#y6{d^xFSfSv&SflLZu=U0 z9%A`wM%FR)VWvL9RQYRF^5j~6rjIQjoH&uvWb*DsA^4u55vZi(NbM9^KmxY%PQ(}`3}Vuj|> zY35hJLUylfJ_EXFUw3DlA@n3=AHrgXF}xS-QLN!Ae$^ft$f=5V_G@r%HZ? zfVP|>2o@V$b-Gbni#f!|>NKDX8N1_G~JP=Oh&M)))A7eE!V zI*MLGR$m~X)v&)Jupfah!LJd}j@aK2_zK~_Bk&Ep)7bwH1Y}eB0|F`{=du4B0%sBU z6oE6S`8@()KxtfY6zS;mGw>tQqEN3IsKHQxfy->uClF+yHUpR2vX8$eLsu|xB|`}e zC2{&Tq}1Wky7bkvt${!T1{yI?pMk3wNM=D}+a377sC)CUs_Xo1{JswdM6^UgBQ^Vg zXs(4zre=CXFtto_DYp<2_Y_<*cMb@OsJW(+si4_ni`H1pWF=-+j+K>V&RD5aIZIPE z-=?e-dG6Qyh@(yOeR`hf`}^Z}U31N4g@<#_=e@jM_x6g2VT6on@r-CpPp)cLoCoDo zOX6#?sF#8fC|Y6TzsX?f2zFDcIfV1vDV;pl z8rxmY`zC3$Uxdg6wo*`oQxnMqr$hTP=YuP~mr2tZKZ7ZPR{HS!S!_C!<@2~_4x7$4 zA6&dhjeItp&!!G2%bvo~d2H&=_UvNkhSS-&*bH$QOIYUOgFbVfIFXMkCz2mvx22rA zkUu&fkZf`L*D`56GX!xzWGHvRI+kvtzl<3h>1}0nsfmb^9yQnPnaAu5ms(!)M0{6Y zniQH~_Qs0(@WuZ;CUiyOFUN$oZHXVQ!?adt(9x#XNqrqqua{!Xa%8sI{J#(4rx|!| zHuf&S>?MdO#P_REz8BvMn!3p)<=wLJn!md;n%84q?qX$l6nL7=}0HTw>BGi8Qa1jL*y zWQ(qyVD^8G!Y+4DW!`IyjBcwJb+}D57fCnA-f|%#Mcpn#e2A;9B5J#fs11>`VrC`J zcn+(cHFCDvcC#3WpZ#(bPKlfi(XwJ=#lY^fNR1yw!aBG>*IeZ>^gWEqqv(1F$4;Q@ z=eYier4^YZOr)yl)Kkd*3Y)~Dev3^aPk+E^QaQ#7FjP}%JgMl>r%-W$6%`G7f&CP} znaK8{IGy>CZtj&Q>OsY=vf}msEi7i%muc>al{4}BB7E4-{?ohJjGl;sS(f&!zqMny z^A2Zm%xwFwbENWGK@DyY%g-`P+KhH4k@|Ak%NP=hPmzoyixo2s$JTHB#9hRPbLg!# z+p<(5LT<}vBB?L;45u&6!dt?0?as8a1&e6>8r59jhp z%*f&&^lE@dB>d-n6!@im6#NhSh%FIlZMLJp4PYzOY-`|&ZeFjG-MPHc?W~)@fMF@! zdV{xts*1JI(!krz!6!Ev?*s>dL%?)!7?@#rb?!*SX<|+$Vsel=0KDIl^GjEP%fSc1 zb>KtbYH%Z13T_4;1s?~Wu%M*!7vb#&%i+BWz7D=@a#_9wz5~7lz5)OH@ZPpuwWIrR zP`RTYfq#VeA-s>lPr(nsKY+)LCHdQD@cwkZkgog!{EO98zmx0yZ>EOjYjz*;8xz6u zG`xSB{FUe6Re)!}KZ78@2mQKu$Otlurhly|F}iW_yo#((UP)eUL_Edv#v3mt51OtF z?|QNw*`91ewr2Q^^g5C^kvEgw*-Y}J+t^Pd4Ac@1;E!5J!+BT%K@##wPLpBhziQ@t zdvV@GZo7xKN)s}PKWV{CwR|mwH;$RYbD^@_LFK0w@^&Q%Z8EAcvW%sroV3{v-j{Xi zCP70AqLftD0b@icj6mi{><-bLnKrmnK5=z4;Q~@-;GJdYRf1TTPF%hMZ>=|QtiYw{ zB&+p)8hJYrzY5iNV4M^~3A&f?K#*#L5tM@5l5}CQd8JVoEj#4P&g>lN@$%_}C(S zz>U1Bl)Xy$T{=$@--p3h4WHLAlXXfhcwz*q)FCIj zXq5A|;}#@4wB$44B*QU8!ADgIx;Hv_MDdB8m7qHbowG4uilJ4t1w zoHGyV@JCsD3M&Ypzxw47dZS zDNrQWW8HDcEqgD^TyIY*=P(mqRo?IRNx0tOw6b`l=b%QYBfbwUrefzj6wkr%Tr8Z3 z({mA?ho`Er?lXc@W@Fw0WGq6ipnyV@tud7TYk`65v0?*eKa3QucGn7Nsn2=NTIn4- z(OmI*uh{g2{#x5R;C~Z64w`CL3;TursE}&+uo-ra9mOQA>OJ^Mg07SH2sX;UAoGIr zETmSiGAzXMIW1||GQ8M;Pq*NY&G|z!ZdWv)Tfj9H&?i1rDQyAzyYlJI?3%(mlKFcD zmAkROy9L5%CEv!VTS@8Io$%sLDLZeu1u)*NRqbrEK`m^hFD~TQOId$4?_I?uYZ$qfTh{+8 zda>Uoz9uhW8P9ICB&Fr0taK1}kxC<1?a$H5tN~WXpLRiCMaOX5P~AYbG^x8KfeS8O76-v~)$UO2AgQ)^vA*gDZC4UN}l4SSXYI=&B6Hc{`x0F~-c-*6tUuZaYrR4UKFcUp)0z>5SJIvA-XREx`s`qZP>=CQfjlWc|v8rHWs9;mIrkd?n7Hq24RI{mI zYh{{AUR8lnS&_xJ^-$KiHnxV<7=P;RQX}+~Q>jqUywG#hL!8E> zdl^05f*^!iru5;kS=7`m&qWP;vlSF*_@vT}Sje99&9}=uMh7jINpeg?~nCdoE+pC8GvcGa`q3lz+R5@4D@&fSSOA3_N5QY_w*RZM4fMOmSyr zWT}bLH5x#Xq4#yyijX4OvKDt&!|8Bztq!>nc_o4|29^6g1avzzmLSuFgf%U zYew}dm&W_Xuq^L1BL8V9mUqtB5Pt={Gw}WlU9;Zz@ci_A^eWL@KKclHQS>6|)ueYh zy;{6OGOeeuI-1^9^y<^QlHS$yuAvu0FP>hK1{pB&dV1~XwWrs{aHq(Y7GUn(MDJ!B znK7cXWyX5Caa1++Wrb=aT`p=fM_XwWkdQK!yGB}9+rVilKXk~yWLMoa$4#}+B)&D3 zg^p2@m41q@iJ-+D=oC6v#NCVeS`NRJ#4*z%c?T`EE@OBZ3rhHm&UroY*+yji{CMoj z$0pjX)OnbxFCtwT->ph%>6-xFW0-l-WHdX9F=HrEt5&{_=xiyq^s;GYLJ#IxIO;)N zB63e(2msXOmCi;r;8n+iv+c47=nK5V?9~x>(U;05qm1296LBt!J*Tp|K1((qcOu)D zbNH7`RxD+p)bwC`G{P^Itrcn^yzVYW>x&W~kjheNP4#A`SX5g7O+4jpx(Z!$(qziP zJ>34QM6GJo2T8&tbVxGPkZ4VTcoHCmqVSaAmZIT$*x4P`MWT(aio#Q*+eK-3Z~aml z-u3dcy8y=H$Nm+9xATPg(D(eO_`8cU;x2^Xb*)N@QyN~DNnV$$C71qL+GaWQ=ki6t z8uDxGHO@tr2W8TVaPiVPLsGqA{M`LnVOBcjdhWvGQW|K`#sv-YFdorBS65-23CkkvITD^_Yin6~DpVbBa6gN0k zy^^a5&**RMM~bHY?L&7FxQS-!38ZpnHXl?bz$_HcM4egKJQJzAFuE7Nn`L>+iIVfh z*h!-O9=q2q%YCS=gm5RHP@t^JT{@ET3tW4PdKcMt^w4E2 z`hSVD7`h*c2k^lmymZt+fZ8X2X$qCL>Mx4PwX{e_f#&q8;^*dNWF=$>tO-3=M2`6Yf4y zu%Y1kDXb%6QEHY<-dw`v>6Ehl_%KfHW!uLuTt!8rD-qAP7#I2r)rYek#i@cb#|AO$ zExo!^=$Y}?>In24)d%@1;OnF@h;Dk|Y53lU??vm6bhU{G@wG9Poljo%cih0iZ;akD z7q+hqeCG6V3)MXSY%U^yj}gJO3AMf}z~sISBm0Wo7GS zZ?cQn_Yiy^xmSK2zPH@`vS|1=n(N#bfSI`U|N2S2c(h#DZoc6S&a18;(2MIm%W=%3(HTncb}y)3 zRPJ6@U&x2>>EG)I^z%dD8{np}=_BjQDRu8h@Agsn^sZ#a*Dumf$~mt0p!eL*{g~dT zzOHrdZR_8sxo<{aZkSE@YRHUMtv5&8U4R(=Ca=FLFo1MKULiN67(Kw z+LH}T7n5kmg$`IjojzIk^?;(>Y`AIey`6LKSw4Ebv2u$D@ZAaDEW>_P0QkC9jV>B{ z(cB`jiceawfSe`*b1VZ*2G#eB*GSZm*>HYU$Bh~4YicF68#-Y+4RyJiSsdl&3I*p` z<=IaKr@P=ZOX&60HuAoU=0RwRkUQcAl>KXvP}!$0XkE`ma z5~7NK+p%j;c%XP}CUJ8=|($Cy90WBq`2a7<&z3nh&% zb7w?3T3^iF7s;rpGD)JNo;J%bls%G=f(B9_wL!8IAVqaY1C>vM5p@@$oCYbX2RcmB zIS(&1s&6vhyYG@YeMJ+|E#Cxzk$Fg&iQ4lmIfOIpDlA%Pu^|eNEm~~-MbT2EEW_j_ z2q+|E4Vr91gSGff8psv6=3%f54Yt@+zByZQ`IERtEA3fa{xmvoN3G`(;qcXO?uP#v zW7TIU+2eOee8aGUGY9eKcR_`C9731x5cU(Qsq;IFvteYoge45CYh&{0vM;=bjPfjM zGR2L#-7IkLJ6f%*O-CazXo}dmKJv;qDa#o$9dZ0Qdb%yA8QP>3$ z9fs&?(oos07oB2qEGE;xmGW!LZ z*Jkn^0VZp0#D<}lIxzKDbm%R2>qlplPDLGw`n@{1w5asPbVzD{?a>Kox3f!RHbb%p(1g>iJL~;hKm*D!ovSlQ@p? z802Qn*o-qZ0&;(=3s8NoZl^=66c`3SC3*t^o7#QC%)JF#VeLHX3=lu5I{*wCqw%X{(gW(I%OK{%gU z>3?b;G*2OeNivn|-k-uRvzf2t3Wbv^=-av5RFeH44C-BD8s^_f39q9#bo@%Vm2JFp zsK*~zO=H0^P(8kSc}dfo!RrX!EE4+#Iv}B!F?#F+UmK(;ML)~puOFFU;rSWktvB~X zq|U-0XX1^ZtEguqap2y%ovM?Dw8gX(aLI9y$@ zV9!kE%A2#4*RA2_lCG7~d)SOQrdzwkW=mHLUPW^Vn2lmdVKnx_gbot zo?WFDyq3CZs@tV-aJRhvtWB!TB6Q_y{NK2NWOtm8}GYJJB3M`t+lRbiz5T__beHo&F^ z6bRGSXn+e4Sr+qWvymQws-t1N(n<2}(3O|N($x&eJLWDmJ%Uwgj&#H+J8l-TXX2$2 z+`rbM-qd*wlv!AlGE$kVjXZ-9Q#m)ta6R9}{Cg4Sy2rZE<@jyy#c#K;jZlafEbk&O zyzAg%5MSR2j@T|(*}=RL<*QIomtk?N-jFc@0Y;fN=7WV6niouGw`!36GewKo%`eyFd-~ zNb3h*%Vd0s=@ar{O>2BZ+;}0xwId=rW8FFc(AP4v)~Q_JxSRZ$mUo&zk2_}baTjQroX`A1(|G&mGe3{{!&u>+a$R2nDLzDEael@sbRF#LaJp1UIK{@>@hhsM5iAN_wg z&wUn}&a|;>;S+JIE;Zd~3;riZy8rb5^O5c!^yhr7XE)XTHpf&NL^i^-8I5#|kNV}2 z?y|nh$E0klu5aGxAbRe- z8mJ6MWi9-rHolf5I~LO%XL0&!ycGwf@1CiL=~v-UjQM3M60oSgW$=pQzR$xaja>$B z3$#x}$L6SP;t~|EMaea|uPGKa!&faa>^d}Phjy)SrafjSVWLyh9dsSak#3fpxi%U7 zQjOX;-3xnf#o|7=QWJ=7!5>p_<_?T#gPDDi-5=pngAByT!3e(#;lq(X)TB_SM&pN( z=3vUzMJaK}1l%_kQ|`fSWAOV?s1#A2jl<(np@X`LC|~c0@+D4hoSTc?BFgiv5))Vc z(gs z>@mq-%1KmwiP{(Hz3(vL2UL=$&*EGd3xC2tD-kQYL=xX{z9eyPb>1PaM6zC23hur_ zzH*MP%a!%$#c^N*-rtD6#>{GBBHnWzA8Enb%{j0cYc=IZ34HoGo2~XjTlVZ=ritfo z;K5G(G{Eg$xxF*Dci|e5_(D^~!$Pfj?LfbZiM2QTr-ay=dgG-Tja9$T+YsC@q8OCSDD9RZ7Xdqu^Yua zwulcb=3u!qmh;XfoO?fCk_Sx}!Afq{MX-zq9$>*zD|8hD*nbW0US(4)`mN`k53>0~ zY`%f_uH)`aTvEnwoP1ZnLd`7#7`aP26ITzv@R;Q@$iSsD)2E>i8g#PH!Xn}hAZZug zR{`9EO>Z%#VDmIaWf}Xa-0a;s?4%FwSccMxn54!eWF?Rsr6qjVSxT)aq{{9lBMFYT z4kG9j9a>%L5yCYv@c^10HaTD35yXdEw{_(etkKCrCt?#V-Ahtx8HyXHvbDQy|EOQ* zT)@7dwp1SboJy7fpr#K06Bh4(<+{ftW=WINWUwGMpYvxir5oL-cPEeBLH>=rO57QAo01 zNm&BK_9Ni{vJN5RC^Ao=_7S|f$8wDV-$AqL)Jmwm^3`KOb4E5}Ac4WwtlN^;1eo8I zO*=C#*{Ssur<}+iZ=qk}mcD$hzjfRk%)h7c-4Vv1334y&$1g{*r;772JUGrGR;0p` zcD=e2IULL4xoN!pUT&XmGo5dk%Afj3^2*Yg+%b=Fb8K$HQ@Je7XX#w4f6C{xw1CM$ zewasVtF!rSF~b+J?i98w;vv~G3 zx~d|5@Knp`%E-1ce6>Z;XrPkPqy;Mtp-;_`Zo|2}N*%`%ll~@`7^FYWp`by16;pYc z3#<^+`d>k|S!DAFIu`Lum!ucHkP{T0w~jBCaGnMO{hDD_vk;tV4iw*v|Dlmp>KR8_ zkE6F55T2k~^jA!+`dU+~9QUCZIx!&HdTHWi^r_V;3jo)H8^+6;h`nM^+g6g-3#Wwo zBYm;yyjFIwx#+XTl;>1P+CjYgu1$!3t{VH*V9aHVsm}hj*uOSo6uI1*)jKn4u)#Y$ zrHfm}mU^8`#%!<@P#rQ}D|8Db4faRkK-@YQiFYA!IAVGjlo7WKPwKa9Lg`v8-+(+f zalWMs<*WHTZVL^UZ^(d0e`pqbU-~rdUCB#9YurY;!R{aF)0NnQQ5;aa(B!o=>-Yjw z7?WcUU5iK5upatmb&*;Ix+C-o`YKi#&8okvz@Oa?gJl?4%?fOZrYPI54ntXJ9Sz!L zhMD8OR6Mor^b#CfgUC%taH6;$H@Hc`p{VMuHtF)*Z*4$NI>;Vim_wqAH&3POzg!r?lg#Y z*)mO?lf^%YW3%`-O`g4vQTH-xy5-`=PURo_Fj9l;XWD!*<>G4ImZsQigngn0*)O2K zkP!up);Rm1QM9@f#b4W8TwHe{M!EB$+XIYMaOFb&Wi_u` z#l~xxvzAfo8FisKTF0iFOm@|0Ba=(Haf|s`o_yG{q#~p}9*ucfI5q(vjI|*wZB@%j zh*gAwV)R^u0gqU$Xi)YmrGe>+*^l`LkfZ#rD;Vf%;=s;>Nu3p%x;V;?7wNwIPR=Lc z5NFUom7N@$AhKr992@^lCD!W&RvN) zP9A+C4fvKWDCE!yZZ=%&r*w85jl?X3PpI;PjJGkMrxnbld1S-+nAmVP`z&?_%Y&@Y zSGtf9ZpF^mH7YOI4oAmyrXJk_qUGkHQ!uh7e;oosM4TPuyhVDvTV25Ud(rGdzk2Bl}`)p zLKi%%haO#9haRG0P~I5jO^{aQSqpST&Cc+3z@8LKg$?vK&zd+s-(5CAz&F{hzrZpZ z{w2Gs?^*M@`eig*g(NA64#B5eOwg2bK=TSCXw(k)6B*qYiA~T`OIM%qf6yltVle;R zZz#W#-bq7)i&f#MN>uL<)n2eak~$+&7(y2$I*PN&r4*;9vcC;{{~=%@ZbemEg1E(l zmM7_n$aXYh*jXfnGs0yfWQY)K3_b_H%G45zSQL+@)#C3CSqVb)Xrvy&WTah6k48#t z>9|q<%=4_M6e*%aBMT9^7TyL#Z+D#LL2Deea{MC4&pH-HhMimlMXlx`FyE1?RjVbq z#vYa?`TEX61)i2i&=t=b7yA#b2Y0+A22D5@1giR>Z5$99<}@?c39)@CYvq zUNv~(kigGd2rjjiP}}jdzD@QH%Qqln1tQB((~+|^w<6+6)O6&m|7pZ+w-QK8rREEk z#u?{mS?>*FOt$Ppk)vh(hafwbPi*X2DD@?&rG=w5Q) zlL<~w+KQSkQ77_gm#CvG9o+>w1jq*A%+PwSdkH)2^Nbx1w01jPgr?p=6Ppp4$4f^{ zcCqiuzYKvjHVrCzt>v+E1)|jw$~5t$g;D7H(cB6ulHvs{S8<}=P#vN>g1o~hCo{rX zt~M}%en&<}wsmB*W1@rliV~@hpReCO8|Bg$iP+UUS9`8MYpR6^FG*`e>57|K07AHBlg-M{bXlu;|4U@68)s`PKt;gb$W zdMeGT&^ys@*V~p<$r0yj1e2lS=sP3r%}=Ig!b zE$QP+s&PH-eSY9xTok|lr+*aHs4q%ig1%L~AN%0&bx|%TqsF0n98(%Hn83~2jE~qX zFpsv1!sW;R5|@l>6+qF^vOu+eOB+y&O@FIqs%=L0H`!Z81Bk`*)UfD|Xa)U2r<})?1te9;B(jz#4dwAyCSqE<^SeZviT{1)D)9y68S zX7j&PW=PGRX{qB8deBO7(Kn-SV1SdN)v%su>IF5Frbarmb9gSTvg zmkoSu}T$rga-7u)N+iqRUE5XxQGe1uUJ zhNf|HFRC63UXs2Zy9W82OkSnb`hI1$Z2ZE6pNDdLybGfc-b1-FRjF=~sVaEleB!zy zmHg6vNENT>2FKm&;_$)^S@M*-9-3buHH8oW`KLP5muML^T4S2lBn4(DOgKuF?FgIv z>!q^kC|+?SIg9SQ*iFQ2pIPzOs}D1pR5`p9ECW zi;BMA%tVJ|R_N=xIM{hKd|A!|tHV=?%@^d&(ijY&CtHm|gLUeLvV!$iRpPqb(Ehez-1I9xQqfz5DEncy?}Bh1xX{V zj37+{I)G`4ygLjp6a=LFA0_{ErqX^^Co(}4q!cm=R17H}-1=OoT6e0&>Kb%YKnA(W zEx8`5c#HT{RiS&vr6-k0^WX+^U*Z%F`GO~#WiKdS@N8V>tikU%_;j|j1_x!w+lG7O zGnKUCZR}8St}10ejvc_M!{!Cf-G$5L1wM($AM9!ix~n$$6a+Iys&K7SQqY}i5~F|fDd?aJ=n#{1Q;^_ZQw&yac4v|P zU$?-gPGTpaT}V@>)7Vdwf9NjLvFxr7O=q^lP(Lsp6ZhEw3-v5QTm_bDZEFc>@kmB; zo4_l{41^gfj#3Kebl$CionMk+|9_t5olU`FF?~5>6cffUP+*n3r}zJ{yC3Vj>r!`| zK3BO@j>+1r4>-~!L#hcG1XVyTwV>2em63Nat1r8zv3fuHR2yp%x_Jt_70fH|s&;58 z8A~6;cZ5cnEVTajkL$RngvZkPH-U;>5XiJCGm076oQJQ1cy$5d3K9DV zO1GgK+0Fe@ueSy4XN)v~%3b?JWh}_y zL;89jFwbN4)f};g{a10#Lf*ZWt=BX9K}J5rNKyamm{&qO3FRyfjrLfITU>S8O)?cB zhdTYFt;l%rlnURL5&Kiy5u^Wf(`SFfX1A0L>r%-FPJW_n^z-qM;F3qXb zeOFRGN2xzm!E?l}kFh7={T0z)BJva>ze4ms5c#e3m6Boxe}YdD7iZOck(JhCwtEVt zaje#mX*V!li2W@LOg3vqBVh$octF;PVN4dvoykwNih81!8uJ4dP3#?U2fo_C1S3ks z`!tkpyi{^f1ax$aVtrjwo5)fFScEL~mZq*R%g6BJiFTeBXYn;DGuPQGN0+k6c=RbT zxV!TP{As;ik)CQ2{jMadALOA9x-wD-h8jsdpd=~JGwDgVRmvx_u~MM4z%ezLisc!` zS6Wxind;<*Ox=uNplZTY8iKc1&6XN;>0qe=7RB)547@42ZRNjBl`1h$qE4j5Qqztm zZ>}0I^#p=ar>o~$g~xXPYrNFC-&+P?)3>T7OexajZ9EZzwm!01HWeRN4Vn4_g2&yc zsXw_PQ@fCS1jqjN>*h@P8T2t&iBjbnMO-v$N*PC&TNa1nu!2`zG;Qjds!>zdGuZCZ z@lrRNA4es+(wr2TIQ%+%(h7sG$1^G{RaIu9d1&NTXikf#Pqm`3FR+;+0fYc}D@^mwkBJ5ONXm?9%tQ=@L4;pNtE{@lecm~y75g4vGmtLgi;z@Cd2tG z7wH%k=Q0|_Ss2sFsTcxm|x3Tl00#EhKyij%b z9fJD!?Y}j3jVHDc`uSxBvMJ9n!O&li^~U_S+$We z74f8*_<0>p}|-S#He`>YK}tOc(j}cy70ibx$xy#Z>w_a z{U9P1AYw5hq(du2M9B55cHqH_T+iwY)*^1B-H8vaM_8%#>7zHpdla6G&yQfs6Luut zyVDLCPfnaytyx?0I=sCGk4SDBeZlp-4|xt`PC9^$kKl#;&PNS@Uh%<2uIE2l#ar}+ z$@s%$d6wB(3;s2D7tGH8bWZ1=d7Q(9-Lb!)UL~&a(Tljq<{ZwUaym=5BV}y#f3P`+ zO110hwX3o@Uobe|Zr9!Q}vR=R~?TgOj5xY|63wd|Z0L^os5A02acUoqyZH+r9zo|+ z1X3_S&7gSp9(GHS7sYh!~{cEpg;KZ2N}?W6g}i{o`tq~CD2uSsO%|&iG0?& zhKtBks@r&Eh}XMELNaS5f_2T*Us?}IF(|E%2oEU@P+RbLL*z9<(?-JCkRX`40}5AR zOK1B^hxg)#?i%&aHdFKFprN(viulB0CM{#RM%^h}U>zSX;rHo`nS<)$_e;z_t6u4Z zerX9~Z?Qf5t|Jlh7FZ*YcZ-ei){PvkoQ)dD*TG)P(l$;>PLqSu(C%~d-2yu?`~^46 z?su2YcN5*?hP$O5K^@Jx3upGg^KW*%quq+pobvT4# zjW=$K?tZE1?w1PzS)Xmg&S$akY5Y$3s*Dec$$9|`o~u2dQWL`Xi1;}Bd?{Hh2t$)(VR7!GO?M#cL^=6M=ln6 zrU50wOzxsD&77X!4zWwN$*A)(GiqR87T=l5*7JDVT*e1^P-b?40Ir~|?aszsOSwve ziWV9?;@fDomZ(0Z-M`6hV;=mlZ7vpWaZ`}b)CwZ4)GAGkS6nc@Vs`VSrNxA zvmvw6u8iAYiee2wly*ghy)R@=$-}cjj9P%>I^{CaNn~PQ+sKDRMCw7LYfGZHvcJ+f zKgpP{+mtx;oMpkaR)Ehw(-X!Xwkqg0ok9xjk%L&_JWAtf#wE>pL}@&UT%i_2O=uzF zb<=;+8}}}#&L(!NT}ON z(v_!F&ne7UWPMg3IS8E zZK#fIYK3@<#MeO)SH~9f9b1u~ZH@UQ^Ujpgb0M5Z$XKDv=lK~vHjulO%rk<%u~x&J zmb!1UjfLIhzHkK_{<+9*)w^<7zM2Z&32e3#Lr~18Yf&alpce<|p_HI+=zHFPFIC}d zv%HPM{qP?!TWhmJmM%N)2#QYP_)qE|?X3RVEpPcg-j{*BkTGsy7v-=llPfiWQR69B zv!>eKH59s)@|e+2!brbwkLpQ?(rw-b&DSDK!);xKqdPHipCe&+p^etqPhhxB_WA8l z8~Ul2)f6GFqL?gUtzjA`r=6=}xIM5MH!F`S*Wrpk4{sfH#yQvZzs;OHh2}p6< z)4z(Ptpwo1YiE;KdnKWI8$^vq)aQosdAc#3wI@zknOnHk-)Q9!~$MN29r!g0g#YnI3LBcja(Yrc|I+2W;qc?SUTB zdO2y+*Cpm7Q{%5fU3=}jhcT+E$(5o>82-OzPwcS46YXRoa~0{kZ=CR%m3ZTWM;AUd`lkot$!B%NAXNZ#Li)B?EV|5;vwjCbmIh z3BC<|qB1mn1btm-YUQ&id>YX&VAl?8cnp7i+hD5^Ar0*zG?fMB6C5H(RpQ5RcF|qn zR*^T#aHOzFtd_;E<_SpU!EA=K@cx){9Mta=Ta+@g~DKU^Opy&h(en)UV@!5N0L$@jm45 zN1E`B&<0t9A9vw5=>~%rIOF*lO|bnBN#^A)#{8#WiZK^FRl6$2T=bUbA+IsQ8Y0X| ze8sw!H$w1QL|%gnG3H9lXe|b<74%8BBw3K=RjeOkol)`OSUsO-1c_Zs>{YDI^JI z9^#x#C1VDBRcYitMUm^-Ekc}f$d`bj1o8{1<1TW%M3|By$II+^PZdqP717&J{YiMg zv3^<7i=asA-y-pOlb7gH&U?WHjK6|NJ;WW@vlorTBP&ka;Z8ZOzv%v+C9W(uW<5p9 zQ8YP(I4#A`k#Pdl0lUZI!3Uf~&41@29T=s&-}8yzZvXnLF3o-3Tnv^`r}`IL791KOvG>F!FeGpnWiE2g{l zMKRqX0RvST-TekL!v%Cp-W(ih{FDIX@lM{KJk|obpB;C;R~6Wme`!GXab*y>fNr6_ zLK?jp4yT$$ZzcotG>@L1n5;tpo`|#RicTOUhyT-+)@+|6y7VPtLs*D zx5`bE_JD!Csi6UL(&?=+ZNCD+Z2IIw7R@alYMqPb_BPV1isp`f)I=kHbTJ(6^|k5~HIL_7{DRlp_wQcs31;+G_OBVegU$+f zskvJ+V<8XGTkvbm-M>5U>=sk3&nWw6v{=i3cXsm^Jl(;z&eOfqkcSH0Wg%^Nw*>P?b`WOFNf?gL1!0>@*9$ zneZ<}=`wVE0LdljFF%yKop-NCZ#C4RWYIEw`-r*MRdrnNKrkV?CXA^ zrX`rfS`N!vFwf2bqichVQ8MQgzLCwNiSL`x;GX^zj|9m%5O zLaoiU>v)+Kd^$%G{xJBf!GD?RSomwBUv&X5xcq9w#3ANNTviXsS0OnD5p|H9Ad&*U zc<8cA_K@FL+6;uZfYeRCCh$3wAm&>5n!?x2vY~vfaCwr++oHQbTGsGh_{%M(RE%i@ zO$!nl95updJ71=$GNQ&HVw5s)jNFNob!C>#Qj|%-Uu-%hpP-Bq^jnME4R}GgR@Ec; zFFk^7mbUS|L(b3aG^x@xJFrYoVIL9?;-BxDlV!Pa~8Vatd*^K_CCOlwgp3-bu1+sy+aq z1~z77ajXUnyJJ~OgJVKyLnDTlF>WDWUd><`{TrF@&eh<?#&AKwnp*Zu2xtt|xuH8P>ysb`{Q`e4gT4d6hG( zu8>+lV2GZhv=ExsDlR^aZ;oa{KgNyX83(Y-7Z#yWt&;9&s`$NZGo9^b@YqxyoW(Xy zy3=kRr_biWT(-++8zQ*TLZW$PA%*8m-AL>4!~lYa{$q zm|io4w?vY7E?1Yv++a!ONv#mw7QrO!=!iZc=1UBM$ggD77XQ@&vwI_Wo7Je*ZdG6} zBE^NdHZx9)Sa-zqL-0-ne@2S+!0t@+9E(3z#XeWlW*={v=hFSgjzjCoI6W27_hHE# z{3#dn^CW&SS+Bwza%bY)415^Gd^H6Eg%+UJA|!>FwPnaFM6D&b{6PfQA@~r2s}WT4 z!y4?~gz~kRA+Bu$URr^3qT2))=-k+hU>WvoLB*qx)Gh3Bn}@4u0>N$Q>ZVliY50B% z?|DpHg@5eCc2%(AuR;m!+&qw+|Y}-x&7)ig%7C5d=IAuMT(&d z(Q}8f{V0wrFZ}}qLp@nCs{pZzz)| z&^Mm`$tIlBmB(pJxYudtrgF&)9==F8mo}TXOE{-{FrNv9T&7q#b$o@uw~>br(FlQ)O1QUd4D1zWm+(>L240d`Tc;%vo=?5dbn{kzN&b}9Jg91 ze8a&z1AFotNj)X$8O*fd7Q}tK9`_gn${tsQ^DwbT{rIGV&e%#(5|Lg)Q&M9vv zo4+aIjf&%5!tVDQCU(djl4@HTFJ#3U7H(kTI^JHwKP!=ycs9&N-fPfU)|FUN4?SYg zO;4mgmU~#y0G%6SM?>^(felSC;u;h-!;P(QXBRx$0e7TeU3WAYVe+BR#-dvf%pPOq z$Ek@JJ_|=@Vzx%e&9)5Ea#wyl=Fr_~8?bvDj=g|w&zNbYcrUW$m~&mp8wc=%PJlz0 zuYG+4^WD9+=OohNc&GuR8uGNqPnBZYjBLuwuVeML+;RgabmDYTD*YKLVS~aGBt8)s zsC=hUJnlmIPGwnU`#OO+b2&fgf@`FCn8M*wA4$59$qpqZvOTufu&gaAaaDB)y4j2T zH&K1BnGPhh5Ck`UFFx95<&bKjNC%P&3(~csPQfgGdlCI6&c2Q7_Mz*3M5yVIq;M}f zyouC(=y?!fZyRfr*$g1Lqc-B{Q(VKou>d>V;NisaL94 zkH89q3s~M_a|*sy|M(jeY{M7NA+Q}4s;`{4{pDwn=8%&pncUsiE+2Z$eK@=yK1pbf zVz2B8Cu{~s_z^Q`zj6}WR78nqC%+5l#4A`o)+U+-;&`|rM` zfQ)rKp&1!lDMO-c&H@R~xF-@h!O6Lumb+XR%|s?-F-mW#%=+kxQfABQvJ+iZ__>2f zl%?Qh6-AmLDX}Hxe%c4$cC?fvUgcj3QWU(b2@&m0-=5XMgwQLyBhyh!8ex+kdL2nq zqy*4kQRygZDKuvK|GI--P!%S#1ktL!omcnQHqml*iP+WA{U)r~e#0iE>J$CEo8D!b zRloL^tEfT!$|0tcEn7<93RjO@AhO5>xR^cx@4Ji`L zc-##lzkDB3b@=SZNADTizWp$&9mSSI`1S;j??RXWMptyrIf({8AkI}#h2cEtpu!PX za8Mmqt84kg$2I1!g(aE>5)2ho*>j>ZmnHJgS~g<#lWf7PP}$&ootPuu zHkCnz7&u<3U@JXo;Y!T@5NK!xb5SmurxTly|lFApc$1o;J47QM2nQSi} za}9&5n77r+u-nA8WWw)0FZD?)G4eV-+?FFc@zoSN=xX=17uWe#C(Dfg;hFq+4gES& zoY+joiQKOdVp_#=iWKO8wYm5%h%O88Mxh};N$brU6~6_471|(zX&Y(^UQoTQxjaun zgCnI;FKxzB9jDH9YuC3xo7slbs=8BNR#0^L7Q1<=6MLW3AOd0Fb4XgqNhjPaun$kW zA21NC6ZiL}&;}9EI-UHZ?5ns;kXi*LSM=eDhLVIa4^`%L3rJ-Y6SymU` zmGIYt&l5uguc3L_L~8h3p?Q1dmLo-y)c)`WB66@8b9loM?SP#;NyL|-s03%7zpSAO zrxi#mGeO-0zeVx$2$SdTZbUz0N10#c$3C07sNy8*5Yps()xqTis28T$`o2Z*JBtqX z%YgHfSt*k|o0#SW%qjnQBAaQP!2otqDK)}iUKLS|MXL7VF*Oufd}ta=?_;^k;9cov zUv82rY!-`VGJGCCn!|NM)pEJcO$7e7fN?I2_l-Oj72B+h1H*Xp6qYQuUOuCU>C0KZ zgw^lo;v9azf`u#j*fJh<*IC|D%SP6)r}$Om8n#}`J?mNiAWI)&=>~S*WU`0hj+{E@ zzWFbuLf02Qj5%etq25)5U@RZFf^ADJuwn}F;iVYeAO8)b%XApsM-HP?>02Y-BCXW; z&u@&}hPbi?YA52A<_6PMHp2F6(B@ja*c6q`P`e7Ii|B~=yCI^Bjk7uEkh(Hw1qyRW zUF8Uq*)I{Sl!>(h>#Dl=+z@0p9%sg3n~ImOBKRo(Ijq&E zUWIczP4pr;<$=8z^#=CrLxpRcwE(2ysdWg~9!1g#Bz|ILr|;x>HS*6EgB>a1TMXTq1sHgQRYwe=3uYdDyrU30o%1d|-H z*K!maNi)`qZ%$;!P%3o7m&J-{HY6f@CjIkN1{iv;Iw!%weGRnBvRSQ|enGNsoREKs zb#N8SI3$PlmKq+rdo_zznYO|2MxdsaF?ORJ4m!v3HuEMa0n|>8;shPP*-Y;CEAshO z+l*nfL=;mQ?Q}bmYN-C7-^&yl5+O)`6~39CuJSrIqQ&1FY-Z-u==Sh*bLn0d)hKSU z2ksw>fCh?nE6}l2xW)O-_ z#YlG%OUo48Xv9r@N`P@2I z2>K2oW{P&qGAKZeLqs}vWHVP0nis+|Z>oyTyxC=D_Ws`mW-1=@enhWyshAf>Vk!@_ z)P-R_>XI;@K;(;v-i^p|M8As2*Ae+LqJNLbOVcj{ioX2grMZ_?p_j`)yEOFj*C$^3 zUEJl*f-a-~bGT(Qe%Z>#7Du)d?v zKTi7%)HlWym(sVIQPQR8DM+Ud0N z{W?|BuU$$;GAD)SL|mRQx?vXn7AU2^fIcF;F0!x0b1`=BWVb}+b*OBG$`qt^M{FjZ zAB%b+qDNg=HstacsUl$;+Nd4ViLn=7t0_B*{9VZ1W9HCj96_Tay=HSh?N0I$4kwwR z%YBryo=HF@VP1i$@=gc2K*GEtD{K_j{mw#Wui{smOw3kU9Y57~exeSRyZHN%l=J~K z*@8V!;__9fSBXwfVdr3O5tSqCMJ5zY6kWo9^s>TR$GCvLw_2O)JkS<_PBvvea5Dk{ z1bQQI8vm2xavEv2;#>S+zTf?9;Lzha=Y79nt#5tnTdT`uQIoy@|L3`f>%Ok*{tKXM_?s!ieKQN(wkne2 z4Z8YmJz$0=2q&(@7?%!ZQ@58{_bE1Ew4DR1ira@TN`)_8RlLA(=1fT|dhVF8q{TWzhk-b=Ji(zMxPt*9!UA{)=p_LXn zLJ?VQIiYs_8ZJ7=0G(8^wTI_SXocC>NP*#nHwJyE6d|iXp?`I>H6uPWUh~)jVzO?4+p5Kzw!=Ouq8KW z8YCzT4eG>BB2;P6kSL-m(ubjqFPnRm-UO;rP$cD|2&nKnt$lAsWvBAlV#2D(h;nz^&E>-TJB7P#zXkxEueU!%}>p@ z?h7qz4$UOlR=YGtHUgxq+kAO5DxRfXA3 z828-4m|%yV!eWj*3;p$gPZepa86CcqVK;(mBDiC$Q0K-GSR)SRf#bzAPE}=U7^?}> zm4qJil$xLDCHjzDi}$p7ph;MLj&gPcV+(ricEKfH>G2Rs3EnucM-pHN-JCZ9 zh7bvdfoRaQKvj^;Cn}$r)DCsnsjk~qxL*xzt)Qo`(trt59^P6ih;g|4wB8ZC0c#vR zYs;B0w%=DN>)GIE7^wBJ*VMp!1OVBigjteD$MJ3(794j}MncQFX-j9fCQEct##K)A z?Ezvl-#cy|EH>#pSPCSXHA*AUww9D_6_z9eW~zOE4`S5?T0Ybj<-DNuNTvCkithI? znBX*C?Uf0}wp{Z>%G#9sj({ZP#A08V%Uq906}`lZ>h?qY^m06Ss>frI!Ei0CkaLE7 zpms<4>ykokF3_Kc>K;n-sh_25-<$m>uv6dfCVV z%g?bVhS+;oS;j~!8Ezj!R-9$cXZ!A8aDGar+WEff;%eZLg|=gncflmb2v@As`qeni zzGt1~aM4y<$9mgQY%gt-H_>zxq=`~@y^9=Uu^(8hnc*>u?E}GqQ8ga(I>%gyn;8x&zN+pmtYT?npl# z%ct6%e2ijyw!OW2wO0;A57=Mt6N;gu54T6BS~2~8`1)1U8z{eKSsA?0(RTZ4OA@XT z&a-CgfB-#iz0zd`ZGkVa6)m$2F3~KjN?9H!oZHPcPX`(55Dwc^r$R+~_>G3M+GC`B zIo#e33pmJqd*9ai|NqW{U*3M#mya-BId4Brzo;I7+Cf7V}sT&hDlUX zkt-CrMUj65KccuIzYPDoGuT^^U-+l|O#Z`P_z1xGdw%9Pt0i**Wx!Yn7|32)$<8u}TBM$yU z{^cd%dtoww?Nw!P8{p^jhwZ}8Kbsk!dO#aHEqF=s#V_+87(YXY{zl&mzB7B470@Ymr3@cA<> za#q;=6jS8v;Ah1T$3cZR!eiuj@qzi1EQ>tPx5f^OdYihA1v=q#@}`Qze;!d}U--Z+ z%wHD&{zc)9+!kD?_(cuj`M(h!1%Dq3YL}s`|>SFk$(&GO5WyEp0yJ^QoiGG zyB&JWEUQUb-F$blolt8Rg}bw;#vWU3J?j0sz09xR9YJ>8C?Wt+?x_s35G2bHY|=>` zN#gwB>-v0;rd?pMD=cq_{c?)e*fY{c9nbSj{S*62s^Tz-eq*PeOPfXxH^dYNMb1_B z|AVN`DKdba(`4+1JJsj)jc2*w8r_7QAsgh)xDD2gG`%$V=gBVcWmW47l~*LYNLHZO zNZDnwD`Zy*!K{szU8}1~WMee@I<+6FcT1H?N6E(9DXx{c20hCtS^8`&QDVLt?vyQa z*>%$cbcDr!CJZagDCpEZd^QkCpwRXW`~A$(~o@*WR_g z@o%!<$bKQi&mnNeHvZPfL(s+=18vOysKoDFb8UZ?y&?O9Y@gHJKlrN>e+l>%jrKdT z_mtS9pKsNPAISbD`=#vfvVX|_UA%+DKV@IazEk2`4>k6#XtM2d8Kq>ztf?77iRQ-k zFKc0ToLg_*)W*R9>tNQ=Vc4Q}W+#O0=QNgGZDp3(iH3$Nc9P}hS)#WkPBzQ6tvzf$ zRx16_@0j)ViA=^BP6SE~IJ_JE9Q%EN^~kqRhI+m}?E))iv_uXaWnTg(UTeFH>{)U& zxOa&&pJ8!N9dEY|w^p*^Hxm)8j+goV`)i!>z%Nv2p37eY(2sVP9 zHK2}I%B-`7dmWXUwBDkRIH}(4YeriWQe?5+I>R;B-wypB_pWXZrhG(|m%{ZV5nNE4Qr6!Qf~y17SkvZuVOfDqSv;l%SSA~6w9m|~|fmH<)mtw%Al2K1mN zX{(W;8T@UgsyeE7LMuW`xUI8>2L1q?oIE%=^lQD;zK>e;*2Of}1GKfjW)`Y#UoWe+ z(ZJGTk5|dm(6Fa_Kv?&5h@rKqq7>O7JbxaheV_-Y!J&x&qX_M4GEib@1hQx=(#;E< z3;het3w?2zFHnZ{7;C*pS}tuV6XCGXnK#&exc!!TGHk@4n%zw5K{`RvTVq!b_gZBI zz*LQk;%S{gkm%+Agr|LteUVOHWHeq1NtyhW3WhTjGXy9?E-{>|L1#M6WqM8MaMMS$ zxm#Bq2XDofX(yuQ_OJ3z=9eGo{Bi==&Z|fuP%qlx zeu@2Lh!v0bii;OoHI-7$+Rw6*l-Fhh0|)P2n&NO}CgvNHUx0V0Q!HajifGUa|Fl4fhfUC|ZJIF(Vsol|0EnSE~*W zd~}#5L^~*NrUp(8%&Qv3?ovxc9B4P7T0O2Nj3I)H%P~;hUQuL+X29IrtzNI|ru{A^ zTK1XVY1CU8R=Yv73M_|-Ii3%PGwi{mGHkONdt$LIBEvptiyACDH<>p(8FU75S#jjo=J7Uz5j zs(YQk_0+grPbYQ-w2Hw>=R(_jvp^g?)p(GB{tmBrFJ zh^wsGNPlrY_Z)7Q2IQ@7s2*6VQ|jHs;D+#-OW+zciuQ`uWAIpSpqBFbcz_75x9Ses zUcN;y-PcF&_SRPbXp`Kh`jMp`jlbp{)u|924KLy?ef_>SGL32NOrwTuP*p2G4~YxB zqzAlml5koJL*$_!B;Jw;a4F>If`m};Y*IgRB{6(`sH`@rBPA0Am52Pxy5SNIQP4Rk z^BUE#LCyJiy|kr|^6FKzN|V+oxmLOBlntZiZP`}!36JH)58b||Jq*|@oN4g#NJoZK zAb!16!HTHf`uJqMhpRB(Zj<=d2=-Y$!{IL-ZFBh7Sij!e`^5jaq(^S(|5x?`9G)p# zPepnNTJra2%21(_VW5m{4jr`9y5=i>^x*jDsqr&mWDIC?)TB5{FoDWKJmDp#L&_H} zx`%a>9us4f6iLsBLjbo6yf=RwwmI!N#{-K4TFyx>%=r+qF-8YOxk|f>*&I=Bv`aJ6 zOyf&AKTDi6&IGv#8-ybo$(5E7_{PN{(_M$d*i@Z*spSPB30`D7F}tIN8Dk{`)$x8o zXr(LA+>t&IYE|2dqwU|z?ZSnQuH&NcRH+qVI2qPKzQQRLi^#1FI=;}7w-y)Hjjc8x zgT;r=X{N@u?#+^-sqd(0LdlRf$3XppcG%q|#w!`Qi=0|4H0>v=znq|sw(r=28X?UH!EX~cSF3jt428nP9>Zmug&vB7Q0i4Wo|cT zcPp`4i4{uRAnG$o{<}pL71G*zXkklW1%cZyaSk1cl(Qiv2~2cU%eB@WPnL)^ z{TDN$_QzR*Rbqfq8?+*Bi4K-b&suENE36R4 z5s>3Lt4>doGrduYS3uvg)Jm5LoW4eb*Qy)&ah!G%)04fLx7%BlWp4&n`5v|0s=3@yU@k^EJO?z?L7CP5 z0^bn>1LyCM++ZLV*=%a^61(|2e-uT)K@<$(>%WT>i!XkQ8?dD3DL_?lKd^6#u@izt+WeP2lDLSl3x<^=Gh2izDa~?AOlivnFKEi`qYK3<>v~^!l zMig?hYruexar`>_!(k7)L!)_$DCWgn@XRceB797C-MO_!Cg zSXI!oZ7$ws^*HFzVm63_kGT~r; zHMU%XuJ^SU1Ey#hiD{H`^$(JsmMBVwI(lAzPZ-&!bJo3H3_$WpGPqyo&W%3155X-- zB70Je&pPdv^6%^CoZ;3$Mq{SG#ifxune0EMT@3f1_j)6C^oajg9_t!^>%AD`4?qBD zqG-pGe^m5$ivB4~|97itNQJA8&;b6bXqpK?a(vI1o4k|GkKZQ-98@&T4fxLEUh?Ze z4fq!xVynuA*%M zR*%&!YlAMe4nXUdxRtl7FN>^{#-A%c(%v0wA58F0;nd;w`x~8ccTJFhop96)E+^1$ zxcI4X@ej@5W?Dz?{#>(a%U}}6Dk3gEJu)|CfvuiwKVu%Z&^8Ai4(_aOgv&iWGLIty z+~vI+7A`os<*&4>F%tRSJno_O&c@kH*5>H;QERZKE4A@*Z5*mQ%60H&eSW(hT&L(m zs(oBlk81T(%GjptM+E;Z0;wAf&Rc4IK!s+Rje2Z@R;Rhp+1A*{-aN&kr&`UK_GZ$C z!HXVj*8>j@v&D?RSt5La@6JoJU-n&Yd6(G_cxXkIyv`1cwCeFb8o>WB`)X^v!7Mac z$uhesP+l``wT9cQ`BbZ!Zgbd^HO=mxW!bC`uC&^)A!|9igR8AOi-SYJoO3u}HlJ^` zwKiy>^=5JKBFkOk!3|=-9Cl-cn3;Q*HODHg&c}SO(*Lfq?4wo&vmB@Th#X_R`>{}y z`%=izg*DcB)`l?P7Uh$?4~2x)jruHcfo2pL0 zyo)pkr1yS(c(@lp7~)1xfw%}XckK@CL8AUbZ+BSbUIDo?db&a@i` z+V#O^jda#DZBseKJ}9ydU|D1B;7CVk$>S-)ct91B%xh9kG2(oF&1%AhJ}jQdvt8kP zpuSygAJ*HKd^?6IKrT!eCtCqSv`sqqaOd(sx^tmZJF0o<@=};q{6&!;g#pAr16KS_ z7&<%_P;q#kM-w}%m6fJ+!sp~)U<3@ua=10wrwDZ^_<0A5Yzbq6^h7C0`EDxnvE~Qm zc2>$P?CSkp$Vc9JvD~M|`UQ#z(;ti!;^#WT?3^F)lR~vd^`G_{qR-v#n5R2Gz}>2_ zmJfJe|N3mF%8)(^>unGxe2N`=)Gzu~g*BAA4Di&IHaPuThFAdr1%1{yMaJmqGSPIn z{-V?uVn)&ujQL{q5}n|vbDW|-;~L*qzdo(yDYxD@Xq9?L#&no$XvZs&sp@Qf+fkO~ zJn95BVmDt6oC%2<3^yz?veA`=*u)~Fxd>5!lp)5dEDO?^mC;4bbCoqg{cct4X4w?QW~gPl?}Iil)#cmm@s(X9Tj?y0#41JB1PbwT zMIQ1@dj8Xj|5S-5+^{-@0=gs@W)Z^9zNNmlDC1D9A?|jv*ggghP}uwM%g6Gz7Hb^53!*%n`3SJc<=tcy4rGX zu=Y3GDP{I^#@4skirbwLmlbxngJ8FvZrM|;-!w}HN)C^kYu}f^(otCxSH%Q`nMG@QeF3VnQ`&QVgbxsJ` zwbE)=S>YP1zT2wrvFf!}cAsND7p${p_gb{UA|b$j$JrR-0_lfj4dQ`pULD;ha(mlYa!cpS`IP%A`H|Rj83pIwEIoR3sz3 z@ivxdZ|yr7#Nb52{h+L;<@K;wuEPtg(6XejvW*wGPs@uVY;%!Cue1i3fyAgV*+<=+ z?pDs3WFt@tOtFTre57xs<;=16Gp%j4(;(Y3p{qLVt_cKDYkd~k-Z1v1_PDUdrmwIs zF^>&M?}1?3;#k&3y}wHj2Y!AN*!7I<01ts0!Y?hQQld;^f*fe8

-pkc%MyM@=6$ zQNuB+&d@JgYD+6;JaV=FaDq;6r@yt=&yLrRJLnIYn%PFvvUL*%M_EGO_v3{A-c28M z)|Dq|e2!k}sULRNl&<=`i~ew;Zpzh7J@h1UzkY6LHYmvb`sQis0DYXV{)3b?SQq!# z*TY?({=@T?f1#S3>$}_7eh!jfFh-^0Tv4*QOeMrgOjA(;-l+I^-8feJa4g~N2UCc& zB=GmMl}Lw?sme$N_n~=*wUdfYsAw8j+*pWZKf zNbMff*TE!k@YBkFLU%l=3D4?-pXr}<`f#J>JfoE_91_KUxlIQj(Ndz#&$Z%LYQ8I! z=&$%JhC}rUhib3R+pU9d>RntN_WQo_op0-}dt9fS8_Z1Z}=07E$Y1kL4 z{6?RCr5R?wYGVBkdw$~M`dKUc=CI`OADyhliEiln&xAdEk~QgR(|g##TzfFv6^Qqr z>JjOa;C8YZkD457Jl`%w0}H@7%Ho&1J$_`OQyM@CQkA}6n92&a%7v2-EB{{W@Sv?jtyXW>7h5s6l}j3KsQV0XLvN7p7FnRb{CC%oJ4md4 z%9p8e2h-HG9-FoH}d_fci2PV$h}K&(b6M>bdEkUGAOqf!mwcUkzv6DK46-5 zqgTA7!W2X}cq|kWWOF9hjIBu@q-;9$1zx6RZSr#Q9v!ui^mIxlZDIK@Ye~=XX>!y5 zw3!s<)sf|-1^W0u?I*onjW>G>oO|@5(xv+L=v}4t`h<0*tF&Rc-o+iF!FjyPf)z>A z^!Cz+6k~zuz!DR3A$iJ>V&9MG#KHZ=J zZLGupwf(0Tm;rx{b*G4y^mjAe zYo@3!$`@EZ?lVtPA}G931T~AN1W%^$ku9Ez@5m#C^`?Jf&mgt?LQO*sJKAyvAno*gdM~r z1Q|~7yGTv&Hqa*9f^y5R@Jfc3oY7md&Zks)+#S{dTx6#b*=p?=-V_t4;r7}rKM%1? zP3)yqAEg+XgG8ckImTtcy?bC5c5{ z)wGMg?E#re*{AC!3i|=79H{JkRSj~^CyPrGh1yAlKf>(--WlUvM)m}C9>&feT-Ra>X8 zo^d_w7Wjv+r~q7OhxVosA$o_`H9d$TA0g48i%fSAUnl|6*2JnPWiwz=`m>D$;S43s zah<%gcqw5eJ*}dL-H~fm6f@Agb9{Rp;_Hly?DisS8#V=l#_Sv7CM4{pe|w}44LKDb zgFi#SV1v&sNRJOGJ0er8W~$x6ixS+2berngY z^X;Z`JGR#F;fXG@RIsMB<>)J%sQKAaYjc-bKwoKrJ0ZoYvwy6#t&Bw1Sn6&|-Qz}f z6s`~5Z_U@+ws3SmOz*k4L03%GPj)C{r!#(YDanc)Ku+^52M_Uf>8)V%em>0Yum*zh zWnTuzpuy!<5adGtTx@GfZEcP9T;a~Kl*i5pEw*P6gHRbB;f-+Msk>+Zrz>}wswb*> zoftE94y$ihTxjRau%|0+-)O5xV+a8QQ^yLs2s+Bc{?pnF2%CJi&%8>-FxV`Ur#p-(YIFZMZ;~jq+EmkggKnm^q(sL#Dopt&0qJvS5qc9FD}2WyggRt;P3r8j)pk-C`j^(*J;hd9 zAtOXTrIOHio<*!apx>m!b$W8mc$(s5u|=x1VxHKeM@~u1@bFINdNSp6iWe67eq`9Q zRi)O@)4`vDl;5Du!@Wc2OcDn3hd8$cK#ATeT5q>N9Vt|=0v!vVu!sHV688~$l}9?# zTHknxtMg{5Jw3$vv~amOz{BXvf^}8XYDLGiRZ;GDVjS%PcWO21X4>W>{aZJ8Fi75QaS6CO$trg{1w;f@cUlX) zi6Du=hhb;IX!~=@Ga$mEMXV~QurEt(D5eu6&3gYj@xV&D;Haeo%NSGsk4pz$PA?rO zgy-YdqYgvm+Z@cX^DT)6>T$(BQT$WEz5`MyFS0v_8!D#+PUBdMrya%j2i^#89G-9! zWto-@@wFh01^SNqlkPh_@Y=6r`JPGlPP68#94LzpmR0GSN^PZzK%@W#1@e<%T?pm8R(h7&z^}}s%nT`IQ zk;0P0E(-4k7lq8DTohu#MS(<6OCo?dw!kH*!-I=L-=ka1^M`W>m}Mb)04i+di1UQQCJt^i&xGQoSEGKKVV`bL zm-GcW(c(w1-oP@n*miS~Vf>;UOOt--+3C^9m~ehx)0Ju34+5xjYz}sm6P=9!j6*$> zM!fIl3d1qD#9EB-q8)nLYdSi`W(Tk7WwUJ8jNmal z+dWLM*F&TRlVLEJZIvZbcGm(&qFR^R?`!RAUgfeNQdr`KP9$_bTe8Bvrh6~8O?UaG zkGEFXdv#X6(tf$hveuX#PUyc2&a`}AiurF(@d+T#lkqd1a2`L~M}Exv;uk1hr1(YT zS;a3?{0hadQoL9!&5W1$0bXMIJWwHUV2+dlyl86slwCO5r@cI-mD{|?>HUhv5k{ui z#F74=6JsgxFsUyK9s-uX~L=6_OOw%&+S;Z8;Wfg;Zz{_YynRpniDcQ17cq}lgQRs&>sQbS)|FhW}jw0VqT*XiM*`nFts0$35jK4`Y` zs~lF{I8D!{lt0nUj+#wXQLVmPtRK(U$AOkV*bK7bh#->U?W2>r$=5*=L#o1R*CnHE5O(E2 z)(=|q2FGyDn9mji7g^Ub_#18eDy)b)0a0qHTi+Atu7V#`Va@qNq=Gm(6glRTU4Q_Oec*?Xn8la>a63TZRBWqckSz{sxEr!M77UVEffxvuz9}8rO5z&IZ(eG zq_YR>y8hZ+=!S=7m$*t|(WPp6rR;JSN2IP+a*X2Rlqhrm!_-hcf0Oe)GSe1_H)v^v zUcO%SH!C?s)w5hQ(I(v%Q6g3&=OYT999YTkX04?MY6Cok9YFjUtm{*Z<~u3?XA z?oUTK;$G4!w}b8UYBS{r&<%cQk9$9502(m@u_w|%eNjJi1grOk~w{j}prIyVY z?k=zYQ3nIXU>0;d8_C0YxcCvT|35Ca*@WMr-u>lGu~Lo@H)6H@9;kn|=A`8+^EGX* zFFkRoQNC;3?wI1OZnOC=Mkac{2gAIdqA+dpe9s`%zQ{b62^+-t*+DE%cXqDsyk7*d ze#~t{>F63{jwn9|6lj1@$i`|tc=lL&XrEVdt%s~;G;yt!NgtP~*9Rz{g(f3p=t)jNQC05GeY3$?ux*XNC4JV+A*`Ofy!#8{V)_) zQH}@2)dK4<-&O-S)LP*}YoM~CDO-f5!`VMXs>t>g&)_1jCR&V<_FzBhnP@SzJ;Rgw~c|bE5;0Y||!pSTJz?@=xC%Yu1Kb07dbhw?w<6UA9 zTIQ8H!|?OfHmBZ@DiGDTx6@-~<}oTZ$EZttXPx@l==ebZfk>!N$QYI$$HSm+-w z`m%ZgX{N>IY;n5DogAt`L2GSpg{>&H_3Lc~sBBx!X{Vy&HLQcIqoY0TJ84d5)pmE+ zzM@`Ex5E`73wRSLL0?(=hu8V*d-_df&}`;g;(Wi_pH8vsM=ix%E`?oUzq5 zx!xe~!+>H$8=a{Bi^XC%qz7Bp>LJE$Y5LPoyqIhW@8S`c;ls;CiO@35dV>8$`iAE@ z(zadgj}BJM%Wyl9T5|zYjsTxjZdVSsTf*Kt<5#b?!Ry=uwtFb0c9P40o$K94w+#-u zbZQ%w5ndBdX)vQwWKG*OaEFHO)S}&Lc-^<`A!@E-b8ea4FvWg8%PxgWIoi7MY8D+b zMCwsvB`fR#I;jB8)WV89$;s`|5hLtr8YGaGi~{8!&3k0CJV5TF&VHPqWXyvKatg~hJdS;nZY|A>JQ0OW^jPDCA5YUd*QUThs{Y*%;}50ak((r2Okddsi3Opa?i z=d|;CQGP{0?+b&1{(5&gNL0JTI~DZZ*s2e!(|y4$kdJZePW9RA9v!E=sagAdwskvW zmjhbxnX=L*245-B+F6LJbL^iZ!rmXeRwjFdpIB~HA#)MylBHJ3M=It?=<_C|Bxk=A z;wIh3Cju-k$-K_(!HEeB--lMH86T`xxeMH4y~R>}vRnm^yNV=Ir*Q~!w>cim&;c&W zv5XquQuKf>_*l^|6#XVxRyOL|W@gA(T3e)*Z|zKh$mLpB+)$za^|B~Dlc2Tf6>x0a zm}ydajr9r94L7>ON#j&kig7`%#K05k4ka|m3GfIbk{UC_r>;;pdFZS zyox%iHlb7}9n(#Bc6LXXINz?T+GFF1d|-gKv$GEy&;Hsw%wNH0ebsD)vMzDV>Q9#+ zvh>Uj&w)vO!+0fb537);YRfvOJHq~bq)y*n<6~cnb0BNC``hV0Dm)4h>Db$fGl+ak z$V}s%5Fy%`3E%a+4O%!Z=#UDPIh@Rvxc$rotE}z0waEFwYE19W6oP_C(=Q$@C?F5XkKTV zL()vJ_iC-JTWtr{A9f4uujN!ectMj{Ad|cnocwv4p&5^c4le6>53SLJAKjd8T0kq; zRXs^JFE~Jy9P67I#|3mHGRy9$w5pkwPlvw1vgg}ze6WR1;~7ksM@Cp`Ig1^=Ib(%2 ztn^v@a4yIy|5W6xt@U;t_yC(Ii+qlcdu?8+{TB0zGVhX%`ed87god4xnDLO;A@rmb zYB5obp|0C9*Cmi&QUnrb$}KyXay0V!vy|wneZBQko-zkHTccB3d><@=W4rioyFE$M!o%=e7cFVYB7L|k=Aoa_{r0(DgI-DHt=n^ z&8>Czd&d=yO5IQzl)~%XF$w6bD=!qP!}&@vq+6~$-u|0zkCP;TTgET9wt#2&UPuTlepby3(Z6ZaLmvN?<;x*d@xC zGDyA1tx+V>x4Nat8&m8%#I4ip2cR^w>|xY`P)q}=8JlYthr|kEN!8I<<;iRI0vkHt z%MTi~v~43}g89(J0XFH;(oC(Tw&E_UT5M}q*lk3WI(u`aJq)&ak53O9*V-lP?f!sj zLULwJCx}zt7lLYt%9w#m36LFvK^jK9tcxv&yHIHxI5{ED9RN zauGCGr`zb>(HUI)TA!iZUS>^z7pB<)u!Wg+8;}CcAP7>aEev?Vud#&;llmN5uwnM) z6~1hRX3A)$ZnVr$uNI{dj{ut_KsIQjaKWMoAL%pS6a{BkvPS<%vE+ijx!XkL(-S4})ZUl>ib283TEw%3N9`IxoMfG{ElhY_mQdH?Rj`O5u`VZvpBrmrJ zrEEa6v-uVEj#v^3663shwlRKT=}r9ig5>bmF~08@c%L~DRZZ49|G-x)^nbZ|V7_q^ zqx=f~$}a`tqk-a=@~gpuKwL3}1_Htl6aT$(`0V@yvep1Rdv9- zrh`*8bD#V;#WS-cL_iCJ#($+Y?eIOA*-X}urDL9Ord^d|Nf_4wVZizJ6n^q>JL780 zfFgoV4hv7o7wnd;w;$nuwbB{~ZPI@QdTU5^Krqwx$cF{(F z$KGn5=hpYsNLWT+8=43jsOT6HrJ@s*xKYuY6dkHRkM*rI(Q?hfFocsc@n3e3Ir6YD zU=E88?ZxngHEWy?>?ZbgDtSh!7gYUYm(Nsh*8{J3-@P1*us6N@BMrr7(+E8&r5jP=?(uhPkxWX9#A?Tg{orqsTn(Rk2L z<^#nxC2+!1$19nwc$Oo#M?_N5Zfc20Do4w@tE8*!M2B-zx&BO8)|Tk6Hhtv)TDcO4 zC>Qt&fPbKoOmF0Q$eSY)YwBm-UD6_@XP{UyKxuBaQ_J=`LPFn^0?OX6=-d7UAuT5% zdwiozyl65k!M96Ti_Q)^BJjDB=@`ym{a^fa8}910LLmG%~+Afy`X zY(=C4Ae3zTs+Zlyn;K~yM>`YjUDN^0Ug;G8l>LfC1NyhnUahsJi|ma64xoK_f&G9$fAF0c{nz*gcH;In>Y0sd`iy&MM~7Gu zKV-DWpBU9XVX&nVy%oz>q`!l-@iJFEK--RuReYAidNk%R%9xKw=P9~S(YgMzsuwA` zN^w+dG_B#4<-g#HjL3FfzrzhcJ`5E4rHoqkXl&5toRe$adRlf5r+KtK*OvnDULc-* zLx{f6G41^r z^(`TeKcowr2Q`i5FGPB5LS0j!3)6N7tDFVO050c#b$Q$Yg!FNm&2mF(<`AGby~rdJ zCn?oa@g6Rk$Xq2`qXf=W>9s+qB*GW;4xM}Vx_?3f1&hV0T2n*Zz3oy0eyOwdZtSJZ zKC0$k7pkE^xkGg?WP2vmb&7&#J{8Ei+nqWRpw;2{Pu z9!Cd}<280;8pHs>0PCLPO-lR@i&t4Z=$pPy*DA|ge244~##ic2pIL7Qoe0dX8 z_Lk~wFGF<;t#m5K3NG>_$T7oEXz|s)R}LoIr)91k9#(0W&9t(Voif>O$EgFlDf81b zVKOAgPik!IYFi$f3u=-%#r9lx6@tZ`?mJ)ZL<}3SAlfBD;!{l4W~j*m#pi3>N-bk# z7T!xkSd#VV4woSyPN{xfZ;`e_Bg}(+^?el`P}>hx^sy5=BcFJXgv$~CMlDgJu*+|Q zNgQb9*z>^=UCObE6BYIZz8^J~$H1MHxGQz#D*bw`H#`49Gs|@z5jll0i`84k-n}6_h@Sqg~?4HZfeR4RpW8NLg&|t#Dhs)Ua-^~=NX@;LGU^5Djz-fL+r+X z&c9!w@HbpAKpYx;e6ymS%D1x6}$6)=$Pv+}mH}sOLk0W;nqbk10 z*^2x~{!95!ejCJn4X)dD&p`f=zxh1)1Y%Y6`{0jv0YIEx7RvG+B%S-MKd=&?uy63Z z;@2sd5Uy7QkE5u6Jg5V(Q_y8CA{-Zh5yg$w0KRl?&AA*VB6~T;!KWU)| zzlaaOZ|A$G?OAw(S1FQZ{*T&)U&mYK2TpXgNbGd))1!qBiG#}xMiIHx9SqtNAJ!bE zAJa79>w-oyr0f>RIpKhjMzMK0;E|Rhq=6y|zZZ%Jx`s{8%mmD7Hq0@Q#87>-#>0M# zZ7LaJO|Q1j@OFZ@2Eqm%4d<;j@r`i7|D|!Dj2Yxs;VG!a+ua6%k&q+a{ba=3{*ECe znFTW`>xLpyIb$@ZRBceElT!P8wG4$g3MNAVImJI`{0Fj3H@S*D<4pkz>zM{}Ryp>` zU0MbPMInlnE>K>fPx(t02Rdl@r3sL<9IJ(VPV9X~t$?O8+$h!c5$$|~kH_;&B|Cbh zm+b9$0!3yjgq>7|<#7F}!P@DaOf^vPcGANE1E**C4`-V}im}WKbYiF;xmmZ|t{zL( zZ@H2@^EzehQvQCGkS{tp_qZ@&h1q6(?AcST-I=y~u$@P`yu!APuum?xn=!#C@_Yxm z2xkV~#b6-W8Ux;s^z&)8?b4Q(I;E8!XsgB(G`PJMv=jK%-VS;>Q@_a8ypGzNrN6e( ztWIi7sIi+%H4o;fExM1cYCKW%x~MT%^LnTxm<}!N=i?6+Xig@Q573~28h4ITCkqAK zh5a>h7`xsyEHEf$T%ycCqF`k}n=6%hxiYU+v#Y(wIpI2AxY;;CEypWolFl#JceiR^ zg$hUnH>>e>eLO??v$b`mN~(Mo*;uV1)6_UovtZb!w3Q{cwQ8KNM(7rpX|Ti=63!ZR zUarQU_@=O9p4OHpbP8{P4h zOT%WjvVF&Mn60L>eVeeKWc${5JS9Fl)3=Qm3^ulJe0+&(g?nBG`jAsKM0}n~58s0g&nmT!;H35a#xwiJ&cV?}+Z+L>%gK z*|Es5i8C`!6=j+*);R;iLQa3FPFFx~4+SAm10@HyhLzljo|elwq`w|$(JQQAgni28 zDzarG-AII7hE~_wiM}k+(bthD0JpojN11V?yDCNhf~hPsM8*~wHtZ6gku`0rPVJO& zydLYQOFQY&gih|J%h(OtU6%&%_MP7PkP%OYpT;=@3N z&s*kohj+XlmP0um}IfJ(?MPSPA2&u3s z)5*YU&RFWhW!SdQGYO&|XmF^9lHf_xg-z5nXf&P;l=WVLvi?IT>p`sXSs<>D?xckY z_3EaI&YE_T_uZM@HL9!n1n&A=xa&O>>7~|v)H1k;{4Gz_12lW!ew!kwF^mx7vu9lM!9&C$40zee7LJ|!*eqPKcT%^vise)3P% zEUoOI)8{TzX&=^iT*#~h7F^o>;}!iC^UocJ$o93bJGmu~0${%$MeDKEQH+>EdaU1mZ8KMWsxgw4jPcOBS(qN8RJS2P*$?Z)_}5ZJuC+K$1S$^c3XF=J#m{| zHq~|djX?}@_cVKKhOL}syDROH*|s|Xt#{9L>FeFqHZh>AcZYhLNexr-#`$(2couD5 zX0I-?2bWmy<@Vz{ZAlO={f@A6m;DuWMws2qTxnm|S>r1Ea*aKEx4n0dy|>l|thRT9 zD#YD*9`GrDBlQvm4j_>zsHd{fA%`Jf#573}r4h4vXn zC8$nff9NjXQsDtb-&gcQ*~f|zH-e@fH-ktMxKtL|AUHgra16mCUA>%$gw7=ns(G5v z!I4q79%eO2Kd9%=cgMDT!U+48Yl9K7UhfD%_uzGqyxDEsQphxd6-)wB z4fD9EuJvPXo|xt=!Q>1d2(ohoLP%;(AT6iNs=N?7nQDK56J3%E&6fFO&?>B9xg{ah z5SQ+9!WE1fUPlYWuz_u!SYwHMd<+*|?W?RJ>)hOx+OKuJ_aR@W{ee5ePc;v-BPK;x2>B9g=k# z>0-*sL~H_3cD?V!S>NBWyXHe354Q`f3MM4FlJTK?Vr~+A^*6BG>O%V#7lLYQQf|)@ zx=Wo^vS792;Vn3gC;7U-&7>-lRDYLsgMq{RiC_QU=b$h``oAj#9_>~zDd?cZ*2MJg zF+$D9zHe)*A8}LK>Fo9{>wAt*$YtrMA7!dV8?SPIl+aJR=|`QlF-Je>t_fW=k4w}= zr*V(+9HgxYn!bY}2-J>uoc1?x;T9_~S6NG4poa=3^^EJm0UVla*F3W44xO=6pYL`a z?8rA=|3ZXmO%4TI`b>#0^n-8oY5->Ea1A=!KHLL>DhHIwH^SstHG%gkdjti_So_UL z>pIc<0;0q}Q(kC&2Zc3^I2rdhKxt!Ok*T$((;xYa-Ug~YRY701r12S}rU7|C7zIvM zxlMz&D|4qB_G;Lh%6VN&!w1`Xu5CKsD=3C6GoinZb$asENZ zC5(QUaTL=f93nz&Io6@J!q!TJ<=T-GL{nhxeS=1_gPLUfVi(xR$%MP3fE!03734Ut zAO#rSMG5fmT(=I3P{Xrddyrlp;uc;@3iTnRBcv;1{$sgz%kMAOCJW!<_)p_)&N6~x z8pXrs4&`9oL+My~c%e4SO^&dDLfZY5J=%wtXnzxULAiB${smQq_qYvm0^~zDLcj8j z$>~+vi2A={Q~6P=v_}Ng>xJ|x?Jsn~H~J&nw7t*+=i(3i^J?2VyQ{(MLFZp> zN{=;*jJY8{Ft5~?4ME8;u*wSC0(yhM8F&GhqKifT9{wg75R8Ay5e(B~VfaN0){Jo; zkPEc%$=>(56k@$c8)O;|Cd_inbpCujv6pK91m%X~*Wq~OcTlfPO~_Uz^tMjQPbh=R zAEIN926xw-uF5!3MP1a8tIP>%a;u*onza*77{MkJc7zOGV|| z=jQ+jgMD%Fkv81wPl@jsK}IoC7w*!lulgRGS!IWPm5*4qPSwl*$+eZQh7AJAbekft zc=TwsLwA65wen51$#d<6E1d}jOX1_O4w(PF%%ZnDBb}FSflPJgbRX=dX4%#mP6M+! zzFHkE706gS=G1H&UFL?O(7i}u3eJ*Nywk;2vBJ(_#!+Jx!NH6dnoeZAzC^u! zMS;}OACz^~DU?G4ydq*YH)o=@)@dcx&Jb&W9)Fut@%j3#N-cYn;$#zr_sA;)AmUXv z_0dD3(vjyM?l`nL%LM|&!;39WzlQ(G=s*vKazl9o7*(m~cvkh!L&#aH!GStORs2Yh zzUE?v|B4<99D}{wM`~bTnLXOO)xCCsYjQH|XB%+xw=JZ+Y8zK>D=MrnK@#%P`O2+Pw~5hp@N4A33B&_2gPw$drwB`Gf_h}bwi(Aj#M>80vU7HqLU7c-Uy5&n?AwQpu6P6XG7G7&8EqrjDFeH}*+|kFjJ9nE!})dqWx=mt$O=0U zhSUIV1(zD5kV9_6w8<CL6!~GktU8*y{03X#wKh>O#%3uc$S+6r_1>K z$-euqHP$`hX`ivsmM^jFrB=ZisIYa5Eu+S6PMZeb=fShF!3x(q*YV825o(;QD0z*f z*2*${#g8*6TEJD1;-+X5MUPPw^e;ovmP#*r?sI}N+bgr3esH`7hegk~hegj3qFjEeN9GZj0- zCy6+G4m(@1!HOjvv}|*pVm#yv6g$`92$tMgkzzdXixk7g?GhzMDt4J-mom#cy!-nq z#fnk6DpsP{wTh2XpX+>9dq=76Wo>kN^=G+HkO|9ny*JwFwb74H*St}RP17+`)s~CA zKyTLS(It*@MCR+7JHxWwrTY4A#a1h}La}??3F^E1T=JX%e_7fa)>SvYq1Yc3+o#xH5AW@L+s6=;_w^sRA!>_Fj|-VV;SE&k-(3X^JdV9u`G`> zXC~ZYs0E`XBn){L?;UmlXWKFT!aCqS_HJK`v1a{L`}zz9wPph>c9x-UYCPM^+DOt0 z&anf9K9<@v*iIT|`-cY0%Fx`MPG5Yn&7uklo7u0v!VS~Tx!k${{9bA0*IFAwE+E4g zx3WAhBt)*>iV)(WH~P#jdb3?T$ycS32j0AJ!+c5sH> z9mrjO44A`$YU?!Dn%rRv2rM*5+}0}h6`?c&bJ!Iy2b6kmEV8qf*d}7;a=VKi?%ZP5 zxG(nVXj{M>J_c}DY2U80*Vot^hu88x&%F*UVe5OHEAnlF-EqHdS$}v}Z>AEbDA`Mm zr#aca5kK2A4?Ec=|2HxSvf?YSjPs_SlVzZT_zo$Zq$1o&3}P+dE_-tWNf( z`#UztvX*z7T5nQ5&F}wm?M%O2tqA(&kc zr`NNxm=&U3Rj{2WF&)WD9N_deLw0~7z`sd_tTki}DDI$BW!MFf)OPzYy?T@SCqw3C zm{R5??*4N72QUs+A<)T&`)H5JH7@Qa3{ZA|4eP7?&`!R1cpo1)66}!{0h@)+6bT75 zx-IxPy`s|XdgV1O+o6+p>c_ja3~c{xFQ3K-apkdJxMCuo``)P6GHhf|o7}_tLdNK2 zB}w=R?njrp#0;mb;MoFll0c+C$vT($wnSfxFxq~{?vnZLABfnnp~Bu^t7(m0g1-vO z_^_bIIJ({^xxb-$uQ%JKwZr09P6A+xM=ku$M~hEzpB{+XM7H&axo@(|)ps4{+wlCO!s>EaPkG zY7Mvec&hPBEtLIn_}r7N+V^^td!`r0B z&TFvlbO-6hLo6pcdhrnUwrmb!z!Bgh&VWxdVQKx6M^yxGA`s;g~xIMsL=%?bT=RduNDc=D6&*R_^~ zYLbIZYQUbCcDUX?;whyaai`dO&=N==kn8vt0Bw%g+hVzfPi%k9$Cj3`P_AO!P=j?| z{64ifnyr);+C1S)T4{;_oUg~i^ey#8&qCf0EF&jT_p(IN(&JsYrXcepAjQ!+raUx_ z4$azM0)UAM@*vYs4rki+jv*RWW>f54?2lm6rJN+34328ogofR)BP&zJjecz0l_9n2$|99+7_#zjj%}M?@oJp#nv;EJ`B$$mbtpHWN)SDf0B`vKR#I3UI zQ~v+wzcIqL;fn&?G2Bisv)Y+<3zjBWm(-X&;6T<}q*2T_r~`}rnj?};;cGF%&_r}# zLJAq<1$U@8cc?BTq|=A~F%WfNvk>~6v19z9521!y@)FBsClrZ>0WqWD5oQ#SU>5*o z;3@=6Hp^6KAVo-}x-Zgq|LIaNe_`YVW0o6nu_t{dO)-L4xED?S5BAxzV*)q?5V(T@0t6X?3?dQ&I3NnzsI4eO z5nDu@Xc46moY2-599mHs^6hgKp=rCH_j#Wm&-%U}U$0)hmTTFNR9)A(&e>-V3TYKO zF`hNtjYyTHkE>vl#+hDwSus2Hw2tM^+4lN>raPjie;M}=;uTvgh@tUCCWZ|zGkRgQ z<%WIr(CD-d9Un#UHoUV74WvidjGM%FRX?CdJeU0i7c0A=Ii_D~B#=UxuuU;|XR@rr zw0GWSNKUdIafiShid%>2bC7$Oeubv&mu_#moYD<)QT&alU&AE#>27MxJ~pAITcN95XHTbX<-eJF(ogYjcNLWi3;!&SdM#ylh0`)*ow;8t*7X zC%DCmi8`eOZI?zF@}Rd{hLaJ|PBa?i@q=s&mF`hyiO;`?gef_{Hb<_)tNFZeGp=^L z1!eGQo#gdoHBo?ySVK2xCacOMYK8Hu1+wX1R*RyxK|fnkPfHZ?|Kf;GH@c`ku?55; z(_#3+zSc+t>F3~@^H6XuGE&f^E{f_PQ-t$+DEBa`J`&HzkOsIp9UATXHbQzsob5(? zfv7S0hjc`w4>G$UIu@NKgQJn3kCXF|v;==!j_3j;{1Js4@S(n!rwsJ)#TeItOgGJf z&g3W3FN|YyHm{8zNT}`n{}YJ*=Ltk#{V&81Rj2pAkUeywGI&Uhu|}t;Qir;7^Q~q# zS6|0<7~gl(_o>t&&D~@8=6FumOW{DUacZ+gepBn1%acXiI)|^iydmMwTGQX4g@U}f zR@r3nl-eZi0?skMnYMCT&-tmgCyF*go_5(y(Vzvq=IGEGUK`_j$^FTbMM?WJf~(qL z{*~~0!RvtySx%?l+eE2V`og;o-VN|>lqN`N;P3`p=%E(+2XD8~ZC{Q0aD>Mq*w0w~ z+UvBy>IFaa*LikyBN z8-w(IgBPF|qL)lBkzO@=2`tdz(IVc_mQv0!XDY7_|CwEt!qSG7@l_3MM<2bIo~UB2 z>9wWTl3okr#vi2La|pKBL0|cNBG=?#TJEUi)*ZyFYNKW@7OIUGk-HD4YS0tI z$^~NyjUP9J3x~0_X4~Or=J~T)P$%@OmBY)&^N8!%^>&YNAkVixYs@lcW_l5Sb|w8u z2kD528&nLIP-T}K(S3!Db$)!A6~P-da7{g90|xFkaktR3NKH~qv(8M`;4pxbV`9F-7OG$6O0V z4QoMPLT~XY+iks8YBu^oG%_#*VZqw9uo_q$Oa{YX3$P8?3cL(#Zzk2e9E^fjg1rot zwT$Dw;C25Ra6A|s2i^hR1^wx~4_xRXj2{4({@3}%FMwOYa_|-KHSi_y4U1+w6~++pZ69M@@aJPWtaL%n}*XiLyXJ?(ZJ-+>QyVuQonUfhc-_ha%Q zEYi`_tykTXd@{;K={(SlJ;ah#$Easn?QMdNH-)te|HjjWu09)sKSkT4IU7vPKa zMmv|K=c{osMFoDY#TIf_7oX}1dL3Ax+Nk$>7`G3%ids5`FT~&Cai$%&OpUN`19dU z$Mp}uUkd+0_>15#!;!@}AkNi8X703AKYuBFB^a(j|1$XEfviHCN8mpO|6v3khriy$ zq`Nj?@1LB`y#yC;h5rit*X&oWcmuxF0b*yp3I8qlFPa$B(nCJ5=euG%j{Ft=$5!S1 z58)q#zZ;!Ch5rTo&vEP%T>Q0Z-nCNvU@uCgllnXSS1oQPdKmt9@TKed0scQMbY|MG z@PESQ6Y!70|I#S;{Xzd{2){XT9Aks@CAj+yLj&|f^poi)(yvB8fhViee*!;*>DQrO zPc(k|=h1JdBSb%y{>3KPDQzumoPJA-5URM8{$=zpr{Bf;eC=QEQHEeQMAb}2tnKgD zhhHw!^Nym4xOf77kkR5J1_;!UeW;F&`v0>KN)tC~sol&U5qpIZc+D$7iU57Sw2FBNJw-!V?7snZz8 zZ*sX%&#~Yv*AkdF{#;XBUL)t*I00s<8EyzP)=oL9zq)~SM5>MbR7+(D)&y@hM$2pL ztrunGK(4ub40fe5Dmw^)2Fg1BpE4XoZ>Ttf+mK`Kg_*UH`hOV7Ri>P^jw-xZaD&f9 za$STxRI887^G*9uegTpif=zKtbL?-10c~+46Duz^C2zplN{I6*#)TI5F&8|ow#^@C ze)|C#e+fC1m)BGj_-4GLdsonj1$ti`z8BD&Ui!%+AqBihXnZDSYOY`1O5Uw2~j9wa$2W5>Oy{W1#0 zJeM9#Q^|PV=lZ>+lR4Grd$X86hii*?_dF)(=a0K{uP{581M$|bsY?VHW;Jc>PE;2~ zp(h{HQMsFeI~kC9LOws5XepvnF9xPEFwF$5!F%P=&A@#5_nPBDV1XGc3Csy7A#}+Z zk)Xmr%9yr{uPY0_r+EwtmO12%YcB7}j*g)rEHNOUQgf5fcO@XwITS*uzO;yq^r8tj zkm-FM`_E+VB3`Gnw1VDJ4qRnat1Zh6AbLp>V27f}gMDiPN6A&Pk4a|w4zUX>cLFge zzSP&@&i?{gSWlvSE&BS*as9CVI*B#pWg+!t6*&#M<0__WgPFW59&)T=~-8flYN zX6`h2nX#t?_5ZrVHcGMzQIi~w;khpOIT!o3;eLh2Dl2xM#WRVS^Squ;ZANZ1sOn^n zA+90!MZYWg;kZ1b|v_uG@dI`WKY%p%ViD_+v$+IYMPHaA8^oJ}ecsTic)kRcMO3<}i06{F#r ze@6QDaGb7pcH%47#l5E9Pv-xJur`U;#8)b6`P8w|}y$+;s zejW9y19@Z|yXEndY(BM;g<_eO@gdcjRIG1{<{ePc85!52ZGXHt0Bx^F+gngi%HMok zb2I8ag=2c4w_};hZ@9CIUC*pC&QMlS1oh9u%{5RX8|{Zd6utzN zl#K|A=eZqQcj5B*CEAUwJ-B!;g1zYVXQA7f?i$Lg6dco&#bY=@_vjAx9?vx295(d9 zCTLdGr<%vlXL7ugD!(y^muK@>3#P)8Y`1Yu2l;%JUbZd?C+nO-#z@Lw(_*l)Mw&(ltw&Lw-v7vK*=qg_e6$E|k1Nl}@rslF}8PjA8;+nu( zF|%dP9D^FUNY6u!vFLm^YD_`!9wbdg(rBbkMp6N)PehLiNXMUz3O~8WXpqY%F?BM}78z1Z z$O4y^UFG`aSdmZ1S&{nI#EKL*(y=1%7Aw+?|IrdYxP(7Crt2wUIOdnPaxi6o=q>EVzit4VckH#6>1J^>-&d%Ibe^WY3|TH0;z{Fng>` ze@DjfZgDurbL9k{KgAw}qm!BLm@xl*gXXY%5qlSNuj+;>s(Tuqkg8hyjuN(TA_(2q zsShz&YVVP}VpK^q`rX@=zYeo;EZoP?4`DuHipCsB?rE;kQ>YEEJdHJksuOe9Kf2T& zN}cx3o8ha@O9s`zOn!P4vDqB;>;g`$jZhi_^-w+4XmtS(q4N=HfNGVrx`3nA1uAKEDXk^eMkv$Tg(^14L4$5a*B8yQ{YX?Fh3bw7*I*2)=Hd?{P(2S-92c&`cvPEW z-W?%1a!)o!L|`K7PeAp29QP5LgwPCx<{&g1b;Nt0g@D*`#R$oOMI88*7BMCwT=nG$ ztg^CvCHV3=RNsQ?s)}(6%JWtmE8aG`Y;_$xmzFriB~6R{qAxmm zFRH(6lF|;&RHt@Lp5+*2)lyhZ6tV`qz%zkE{l=`8!76H%o4d5cR<`l4(uSe-45?M< zz#8ccsbT0sS$qfdWc0Qj);)cgEXA4QgH<2EHKKNO<*lWk4)DP@FY9qeSX8rj+egha)_KH#->eyI6y zz$rU!-UJQ-Zv$@ybDa7n8ypFaf@EJDYGND?H?F%dOwrwK*w>^#8k`Kx`(nRq|IU0H z{5b=hV<~>2>EJBG##NdmCJo+ir%3d8Wq5HFxYlH1{3G}@s77c5_^cC)>0!Ouh*IJU zNiP<79f9XfVXE@Qca1kibwS5PWF^lc6BsyKo>$}_WdCZ4Fp=%0Ee+HsFEot|J@c9f z$X>>Y#0`FFWzM<+VHkB(;VVoyBTSE-?CoH8hj;aME7UB~X)Ck@)K?~c0tcI~tlCKS zb%cT2ZLvr-Q9YSH+G(annnsl)$g##{(gr-B7QJ#DkZZTK>sOnm%!Yy~ZY~f$rqN)s zn+^&so;BbztanFQ7@8e4RVAsqx;IF8nmA)}EekAW z;LK5Ch4ID%TEMMh;2{Q9+hh@N{eR~sT6&^oTljLMxxxg(0q4maIPJ-Nv(aqy`Rnbl zPJ6$Z@5x1k$E_Dt^B+|qqUV7V-1X&^ZGtxj_D+Lp}BLG3of;0Z+EHb z2lWVw$dt0hpwTZT^WJ5mu^}}Hv*Vnoc$eN$oB`Y}3g}d`z!ikj@P4e8IlyWoL?x_4 z!Ups0Iia?23#vSYeM-ODhU7zNrms>PUb1clrm9y@;5&*ntYw>^@uJc-Hf6o67%Bv4 zYX#ihQZkF2_;+J}%i)rFia?M7%tC78KnOp;o)7} zl+TYf+DzoS2^?|{H%(!dM&_y9G>z*fbHjAbznAL@*}Q=3B$S)YxwE)sj$1y?XMef8 z3Qm`a$3m`Kz;*L@?fqOgmj#Qs-*qyg?_RNlJ(qJ`C4G0@QVxqZGwpDq9on9Q@6Sb( zy11kU?yrYFskW>f@8Qk*XmLIcH^6sl04~7gjnJwg`U?#cvsbjZ$|k$!gO#Vu@qD>F3mYeJX)R9i638a?^aO`Pe#hdO6eQGqJUR7FqYDw9mGX3&ao z30FL`R5mN$Yr{iaLfd zx6Amg`(}^TMW*x-7va;!=+_jZnxo!C6i>kGlkiGDe%geL&G_~j#%_nTgs zKJf07c4egh6Sf0zYVopy``-LcQC3b}}Xtm?M~dZa{S%Tec?WA2yJ$62tZ2H0p%{ym#VN|;b;HNU=k;C7hP zmANV=j)0^+P7hapx6fgYCjC4f*N1bzZ8O!VXDsE}tJ$)QLj*%LF=4psp+4S3tphZS zi-HnE=Pt+^jcTI9PK4tG53er%0`5o3@tZZVB!bkZ8f7UYPqO5 zGZ|fNwo%<)dJK<@nu5L}H>RPZFNA{xJ@mf1+#FJRb{UPP!`I&nwg_o*_f2)WS z9Z@!*j(sNkm)L^%q=s3|^6>~Z6)&gx{l17p)WW$4wvepVW->O2!&S0`=D9lNbunm5 zaH2TInmD5QT61u)^QBiu6m-T-R`xez(#y79*WBcfwfEf{$Tgxa)KaqwWVTfw?C|9f7A80$Gl_(-(p35V*lv6%CS55rM%7L}0!%@Oc1%rOqg65dse(P>Mhq0*@f@m@Os(FCZ#eT)FY~1Fsn=DEfx6r>ee* zz+29R={-b6Oa2Ja_l?6J_!xn|I1i05<%bnX`vGJqy zMhHkzdt)ykk#Nrc8?=xy_8lcxl0$@qNLGBb0N?hrta-J^XZbj$tM7Z$zV?s3W~NO(MQ) zO%wggEnIUZjbtpd#&D~vcm?jv?3A3j$hM8bGs}gx$*)^vk~OxtKUM{Eh!a&2Jqra1 z=%k)gj#%emS_ z0<3oYNkw1?-nr^&gr9+@R_#etTW8Jch-Xcs`nM8{cn;S{Ap8{G7QDF)6-s>5%l-=ll*w42BE#CxA3@e>60nkP)J{dh^6$G_ROF>u7}8H3;3o>AH{ z_5Vr))_*1(M{)&fyB1d|^Xdbq)utypkSxV6Vn$;|Rk2&xoUUG1yTXzl+}4c)u4Gh8 zpWeoc7C`Ow<0r}@%;K>DtnOs&gKlG)gM7QH4IawvmFQFY2&Rl>iyS^Ly!sAqa%f)a zUF@81VAK^?^PGuHo509D>^z0@r!pqTiD^um%)%KA6!N`$nL3?~g;VJa6fn(!+k0kn zzQR}?#Qp7jMv6J~KF-&{Sjf}`tl|0uL3~P!KDdaj+?#mSViql7Y&i=bVBv!-T*04K z@&Om@o22?v$|I`{(b~0)C)e0JsB%E2JB1M?);)z0NwyG3 zGmI#ZdI}>7oNwnUcqT?9fT&@m^s=>`u3%dfXW}!NN_9kC=keaKJCb6!!ofsGh8Rrr z@~zmFV{x|?*=8)Jq^+RbO>?24zQVa5R7^wqLlrMW_tFUMIL8RYc77E{;5e+F~bAzk?GlX&k>m|ucpn{c_z-rejF-Hu1(had6RQHnuV3&KBIHg|$?K>8wy^(&rQ+6ugD$ za^CA}jf7YSRfd`B`Pv*F)lR`}bzd6C$CZLLulOS%DdK+Iz?@ zLcRFHZ?$OfV(_xDEf=-&P<#&pli^LYB9Qmc+*wJOgN^3(~lRb)O0m(AMM!-^|2@~ zFOOfV30%o9)UTE*(UM!8C$O$&* zQZD3V6Ba&)hi}H>Er>cWq2f_Iwhc!dkRtNZF|BysvAySscg=VAp#!$-IpS8g8aXF? zj^nNmd2zqJN?YBNl=Y1vEs<~WigUGnMOyn`jNEdReC0TfRbi^D6-R_oJOMpSYija& z9h-Cba|%z^=d=ba^URLpNMo+a;1Cg0g<7=WG zH~Q@y!;Y>kk^gqZ1eQ+XtCLx)kZ(K39=otQpTa;?f}FpuZD8ke$4ndOnyuukOIf~( zi4QToly%AsH&bkxtRX7&(A2Q_m1{Jwbu}n#ntV8Q2ByJVYi6^D{%o_AKK8U)3|v63 z4gFq>_BYt`*v<3?uvB)43iZCtM)FG>R3PjGL~onlwx8K4_}Jfn-I`35FdCTH~vSr6FEO?3RVu_-6($8x%3Of zt-xnaa^5P9!6>U-!ET+|NJ?i6z=U0f!u)(j5MLHAnw8Wcu6N;Ru9EEs*I`yIIjBaR%w9}Ja@C9YV*%w zl?I%a#&5(q>|l}^$^|-$pK7KSv~?>>Z)8<{*L{t)A^OA*?u#yP8}|KoaK39=s0kBN*&TMa4m{fkbW`m&Ev`ih5-BX*gzk+ zgMVdNEME)F>`y3xXbHD1w-D;m2kEcif~EX?B@=a2bV%aZ)NLr0(o-cuF$zP`cm#&m zV!wf0sw9`ikj6Ppo>#5^7yP(>GP{*Pg7u05>Xp_M6c5T{@FD~1y{7h3%OE9j45M5k?MlcGmUW*TrYga zwkk(%M|cb#%|(Sv*y(;ZhD^ko30SxcPcFeTg6tOHo)R+{X{9B|AsOVJ`g{VaQLVVW zDT~^3dS~9y#Q>$4d~W;E>%+IMXR3;ip!J^o!kx6F@jNE}hASZ2$-Y;_bJVm52ogLZ z@P81m9%tZE_$)99pLR8;-*2R3)B~a2=tczoY{a=2wi`!r>}K?KV#e9OX?f(3RR>s= z`v&z?8OR-?YUZSTBiU%=c9uDiJ*obNJrjRRzn()q+pJ7M%Es=T;R)~96fTw+YF#`vuW7T$a*@<@qYafze#Fzt*%4t8x?7N2#F`{}Oy!O=QkWY(Jk%2z@=47&}pb8v%H%)=D^ zg>@q^bu2!UoO!bSEFz>($Xv;c3eMe2I2 z`JS)FCWak?hOc zhH~{V3ak@cuaD~&mC6x3GKvKP_uMfSM7h9yfO;0Uss^eUsw6rI#_!%lJvUPqu|X)2f#$RIE^b~c!1YnXl^<% z56ADv)7m%bL0OG0>#hvUgyrA6l$zMsQiMcu!Xyo;W53`?9y@rz^-H_O>z zj+$yVm_JXWcdzAc+sd-Q<{&v%RgbU8$FW5bznjBGS`QR6c%S84>A_Ng5>fEvJX_^_ zGnZxe+ncp(5qp#{B*n@Sayj_`efMlBa8UisUHTIB#nncQrj9G9f%jItJ=u&^QzjrK zAB{(&{#*-IlO}Pd1c_23ZbRQz%xlk2-MA!dTt@m@xL@PqGsG=9IF2iG&A(22)k0}< zvw625AgxWEzS7reQ7s)~CSz}(xrNlpse#nCwwJl21K#XuOsa3Mf_Jrv!3FSE^f3zh z$y-sNl%i~WG!j+RR}4i>wH9t=({Cc)k)lD@(?zG%(~($aMq$TS;ECm^D?a&J99xfR z&)BAB%+sjyq@9yjL})3&x0_sh^rm9MdPuSGGZ;)`pbfu{vQ`HsIhNhnZY)aYG%X)*VZKg+qy4lW$`q{V)(j!biFYpq>$Jq57O=IgoqbsVpA9ZN^Id8t-ObA3mB znp?Zfal6Z@CA@wyyPUapS;_|Di#qd=lltmwBi0oCnp-*s+o4=iniyhT5V;je*;rZG zxkblYY|xz(Fi0)jXdIjcPs3v|W-LS266D8gxchkDT!-Qk{Pdg+Bh#FV*GPSyyHK{n z5}-8F?%9po+{E#@=57%Tbeo#kMzTx;+Hlg_ZV4S5WR*(NuGx_CW#>&{<#lxM{(4^r)syZ3JD-zmm zRs3u=(=DrE%$9}jo2?N;)h_ttHoH5e*%%?)oT*@efuj12awp(Lkp}ZIRS(=;yeSlA zx~WUvUTKj-@m*)~DoY2hyVjhsJ4lrAG!mb50O=+iDZx0WK$-U_@|5}hHmdBx#d_~{ zV5(~uACXP&UL2Dkg{&`4N(Bx%S<1t1p?QO_&5Jm+J+JC;ie#A4o!@AQd6jivdf+&K zGqixqVvf5$^R(j|>c}BIZCo0B2cOL0J$GA0edI2#&o`h+`{=R>%)5sVPvISt_*SLD z>zLa|mld*_Q+U~{H`_!#$7Z>Jr#U>V^W$`0&9#`;2fl!pEOa_AHwa9e%bklj)t#uL ziUY{tZk8Eeg0 zTgF;4b_o+NW$ZG>E@w>iGpRzfQgkPIjjL2$n<2ZMJqN)qrx=@R5~5R)SYUfY-!~^Z zv82=(Buc};E8>;16Q65Dwe)P>znGhxjv)CVo3+nUjNKI`b@Z3-1MMt%Vpw%Z)YUy@a5HcJ)0z z`5uBhu>D;dtiJgO!S~JCa@}rp+Xw$M1V1s^mnTEiuZ&Ps68Azsir`6m+%-J}rNurD z`SRVIz)mVkHJSK?qDeTr0izyEGZ}1VPrPt%NmheR>33kV=0w?$_Gh>s{To=`hd*4; zT0(ekVQLmPb~OdG??9gH+xhx1UN+o{`~eXo$8y9NGmpJ$yfs3aVg&fKEaacYaeo~4 z$>k)cK|Zc3REhl5QRP|0Ot%e@RIs9yQ>7cP&P@D8n`qoZF8d_7PN_c*iEe*?ivcnxryPM%V znRXY`oesCyZIlMz!*s_Q>OGa|Zll!5Rp~TWrPF+~LMocYX>(YlC=j?&j-XgMSBK1rLMYfj@vp&250cf+yjfa2o9|L6AS= zKWnr#ZJsI6Zs;`HsbnU-X7nyTL!jM)!At1HHQLHHz1%3Bepja6#5M!@UA9>SmujDz zgk$Gm`nf2m3sr1$jYzXvQ6T8PK0FTv=bPJe71a&JB3yvZjqu%t=IfrB;qnpwD^H0_ zk=NeYN{FI=IlQPrj^-?(s@Th!OT=rVk`z=Pv*4-P#EYcJmc7k!VqRb8IMLrIA6}e$ zd1IyZ#4QL6Hus4(F)IbP%LvagZ*PsP3(eva3)G8nWO1xCkpYwn%|Gj5B%Pb zLZrv&nSK-taH0&JD`gdr{L_`<>BpTb#d@5jg67zO3vNcBl4elx+JE+@ICq!Tw+~!> z`|aOo29NB+>JQ-^v~%Kpf=|D&jkAu*XD=ftc>im&rw}tdtmo|SXP8uci^LzCPldM6 zzuL+1j=}rVEb;Y_dOyQE)2c#OJ3ue=AKWUm2pC+Ga;sSQZ*CPE>of5T!-{eNl1)x| zROSTlxJa`=oOp0M2MYpjd>*CFqWR!1Wb8nK zAfug7OuRZ15&KK`TA9#>-KItcK_U(Xn) z;Dv^BM%&TT$J>#M(;4W*;I&2{m7!D7b+%Q>yxm%BwJU8#(aYf-GZ>aDLLsw#o*2lp zonYkRJocK$x-&T=nOFSA&Ut=(*z5XK@HUz?8K^dO3g@8&Ws`s*y?40SRwZ0&+0 z|8X~=CrO`GWdn1zcD0%lyK+r7J3EqFl!#S9tSVw>pIY>HPD1P){QIImq4xi9(ci+* zc+tjW$`ov6JLml z@G*-N6qb8ZCMZ7}uzB5aoD4EtfyaNtkO0F~jm8#E7D#SPHmOsKt1)~w14%|{3;%(E zh$TVSeF96v4A)_}9>eD{e4Z^e0u43WGMvh=qa{ejl9*wRB4I7CTDxsyTZUV(X-hlp z746InM+PI|Hs*&TIh(AHrD&_r;qT0mJ&d|QXKfMg&5AxeEFyhBcJ9v=0&TK*v(h)N zH=yqy<3y1Dw|_X-!+$mW^&{rTT#h@WbzW`F6V|y)^w_d)0He(#g`sp z6*Y~ghf}T8FEudjS%oHSQ-C<%6ExSCUk>F6C0yk2W~sIXL?~>1Ab-l^W7&K}bXliv zsF;aI7vqF5`~~P2hk#b&sM>YM@ShS6_6eN#A5GW+K-y<0ZRNEYJY=%N3h{r ztp6U>e#H7;5I7FaC58w+f%Ei^bYNO1o^zXNLw*)iC^?U|W<4$cdIK!+Jfe}Xg}f{* zs8N{VudPl+!*sd~;r7lH-Pxh{iCQtg<4PpUc3UF-_P=k3n#&!4gWst4HD-g z@c|?*t@JrxiRuqo#M^?>Q}*WmBhKD@E#}MKT=($>t9X-cuJkj11&MJd^Nk3JCHfmUu9#i=z)(Ae&6nC;>SolU>xAv|6&8|3m+o!phfZ}e)dm4 z^T#&B`^s)^WIq~yZE*LMe?#!^&eHs_`I#qv=K`UAFh6tu=qW#Q?^h(AJj2W!&dIzA zy`UMG2LntDRT`LAGY|74GBAHaN-K6ghl%0eyO&4f*5zUrr7}^E(M5dB35b*)?q&Yd zy}Y2cb1!dcR8?6H){2{!%duR@YC2DJau>EccV9(o3>>}fqXCTGV#Mzo2Ad46LJwJA zqqj{R#xCx9wvy0eEEAkbue_)H35@#8ieE92oWt=3>Tf$C(C+^_vs;1P_am|l#f!0O3I4PK!xx}@jj3RIl;E*VxOa-$#d#Ij6Q<(L^G3q;W=!6 z6yI({bpe(&@q!l8Ung3Yi5=1)M7!{E@ zZ4{9!5$T19tBR4{i1f99D%Hct4T#)`$RI=pA~F~e)j;iBWEQHI;&yl=5p=``5ubwN zoK4wSMD7CbLBdpP0+S~rP=G)`MDp>9kH8E|XAVq4_&(!1N&5QbLPX{xQfwK=k)?<{ zh{z(lDO_nx`^XaPT!FUBkyeVx0(2-tME&z4h&+afs8Ek1@(hCOQ2v5R8nsd{+KNcI zsT##q*zpP?8!_WGL|!tHW2ZL|c@#x&BJvg@FCrplojU6G?7CgI6KNkH^3f?jw8+PZ z>_hwA*!&knK1AdoBA=NhT11<{FA(|4j=^&;n>SkI?})sL$YDgjL*xfUjzZpOkzWx} zuX6&CW02T1@+BfaBN8;-WHi8tjABBJBr}r8NHsKP;nqWrtFoK~3uumSxhFbd1 z;yX?=E}Bh`V*cp1mRSp#JdagWc%9fkGS_y6+BI)2;r_*DZhUMxdpy952br;g1!`j) zhO@@${l&=A+@V0>Q<&sM$Y}yLhUk>1Fv+&307-VjXPwPfI>TX-woGhknBw5203Kb>90?PNZ;T%epF-vQt7;+#ayLBlE*4>uE;!gR4nY= zQ;}p-v>aK?*O#2Z9+AO|zPK`DsmX%iTQTC|61EHIrE`Nqc=e>JBI#9);lnPt>o(NS zL48+bs*OUmp-35lYA$QWpJElpaO2TPiC36>l>3#+ddcb~s8?K3=6qpO*vyo^RdKaS&}-;j{N#_@Zq z``C%+>hYDfPD&Yl)Vei#g4I0qWbHggC1;b6Et@@7F;dDSWh@xPKjz}MNyg|FDl3t1 zOs-9W$);k+Oa!Wn#1IQEETnKnMt%}M-XyU5DmXqO13i*&uNuB8lU9D@56%w z_($bQb>*W3f=Q(S>`ZbW$&ZywgF&L#_<C%N^_$We%*=*?TxYQcV~+}^lme_Lx7UmDryOm z!yI8plE=!nVj$O!V52Yv2Mw)PR=pG z<9PQ;YRlQl71+{6OweypYCVH~<-j1ht>VB0=zm|DgOUlzoP%+5aOoUeC{q0#eBJ_H z8+fh$)z??ht8iBVtpZo$$f{t~(}1ebR6(W-onh~p=%_%^QfJTmh(keze{OZ6DnXrZ zoS~&UjcWb{-f1xN3wS~=&jc-haERrZaAh2;4AT1@J}E2R-vN@Rp~#ErorWJzo8@*r zHSJ2Ac=B{%0Qbqc2%hBR9Dw61bm4!$>{{n4Nb|6!0M^}92tJBzvpj44om`nd;$$?F{P%NJZM0RXh73+ zrdBqcSL?$W%{2X)j+)qAfAT6Wb(WR6I@lUX1d$2;>V_pkx9+wgGkq0;52Hw>SV)xQ zRO_(R5lY|QX6?6D(si_fbsHtMWYL`#uyR1)(#wb)LQES8;YCm2!TPM?@ej?pPn(EV zoY|iHI&-*in;x9ojS=bVP{pt^D*xrVTYzQ=;IRH?cxp z_bAqJl!=PFn2~SBTt_Fc^F5|!5>?oDfTt%AMsJ@`iCmtTZ<67&9qN*$t0V#MA|5EA zSS4+ia<3RQYwcPMD`P*$5;wD*K`htoQ^(?Whc!Xf#`r^P^9(6;V~)r++KtLoA=<_4 z0vZm5HwM8G$djAsa8NLy3YyC7VpLh;GU6A&U*%%r^^UBowDoWkjVRw5XEaELx1su@ zpgf3#o$i45u6>@-J!X2Tp)$G|$5anrM*1OC`J3&sJq>ZcI3tA$1QKjv7v~IDJCie< zZe%S{mF_3{cVkE;t`DQ*>`_P+)ntK@!^h|)8e}%eN5&vgf3=EpcUuwa3k_G6Vs$=I z{p~`JWi>F9^JSwUg31MExc!=QpsKYSOZK9R9La>Rskk|1dd>eMO-`m#-ZU2&T}hMc zS76@$LA@Q?oaWl?P@0Koa#iO4o+c-PoNzP7IdV>ORNc|!WW4t8G`X|g9DSI|$VQ+l z0%s#|7M@8!;19Mn2-KA6G=fRSdz80KI0fNzL9rj}*p@t+X5DGD9s;T28zbt$Ki}+S zcoBR>?lv*CPPCCZ%!FO)u4FrM?Njtvv^Ap5Onny3MD$V%`%An6!Hc0**6)a5XOkZ2 z6a{-C&;wz&0u#XH#o%9K{$o+Mvk z)B`4W#TRPD-c}{e*uoIvDSL3 zW<6;W*4l^{U5~f_h~P6uHwr$9#0~iVPp38}i5mT$vyDk`iwj3^VoW7gEAZWW9*R%W zRIJlgv?lTsY43!80Ev4L-e=%g;1gRhXh)Xhs;<8u&$$_2;AGb$xcyr^_C3me z#A81hj{WE3_@WB+7BBh@+Nx9tz7}wOHg$1+5o8_5tDPK1?T|Qu{yB`+HKu5wJ~JAT z=aUy$MHL}G;8|VO3d~ng&0u00qskjqzQ)0<_{8=S-Fd?pq%s!1@9gT-GJ zk1?CC>SBty>I#KyNxTx$O@ix|Gw}f?K4?)L6uz{Q;Z@{AjIK3OU*c-hU-*w${tK6J z#G}^aeA|t~1)+~)fdZ6uS<#x=6v|WQops4_>m+`aC^Ip98H}wAoF)=j0#eLr+ z_#^K7319qzTaM$`D%>cCkKZuGAy=X|SBPq^W0}TerA9VoMvVQtFkL-oFGjAhIQ!21 zST6M7HfG*vT9REZ@bTyp50rY28819k(*1H%?86#-+QNa3@ReVsbtc#`A!(%qH-GDNIu)*CZBAWwJ9yu3gBg zGDdd0p=q<3Jj=ZM?ik4ZMeI0-&D7czGvhv+^2F#~vXIjju+}_gxOOFZE+aFoV~H*1 zJ4=|hoV6Zc@`FrXVG}{&YDS&&$y9y*=VNvwtZR!GGfjGv(+)*KOWe{nQ5c{ei=l?f z-a8!CrrP13IvRhNfg@UiOgE3CZBDJMSuANId}qbqd?!BLjW&DH^%_P8@Y|mJaxC8* z!-I|j^qoq_WK&?(lneSS8yin#bD9kEouymRATH@_9fj^@`t?Y^1vPFqJ54n?p4c)w z5%>wyTn}S@S=!p?BASOpky`T+QNeG|Bxe&kb23u~^03CAY_`>Ow$zHl-6b|rjvGV) z)agSI%*Uin@M_Ul0k2OA;J$__L+J}_*GQOaJ&$aPqY5+XYTUViteYERaAzYT>WLJS z&6loiEehAc*OMf)!L_wRG$igsME1qn-S5MCy*TP`T>}>Q5qcf;7gg(K1-z9u<^wqN zMt-XDtJ13GQ`St`_CpTI$7{t{y%s&=9AiCvucO=BCb1DcAhZ+JT$?AdVl=^ics((J zG``=>5}IarWz(MAJJ1ZY^+)N?R6D1h11}gVSS~tp(M4c!EAOA}LW$W|hUbwWk?a^$;i|^|AhiVsq{)*o>rN zl#9(Mj-qIXA`^;6C=TJ<2#Y-!Ck=`#D2ia585n2%iSMV`$~_sv*M`$}%RXRY5BH}xW zh)}E+`;h!OiuNL5zp09RCn?gw$gahNnyjUnE{%mUglT1hTrI={QI}BAg+IFGT5@+L z^5XEeF%0C`yC0olTK+4Y+FhNtzWpojV{x8&hX%5loMO(L zV;kbTVerOUDyS}O)G=%W!%hDsQh~;?`L$4^25L34WNMCdya?@jCfiMvM@Q5p8XVnW z@KmimxNSEM?1K^?E{?;bXJVx7>Gfd#HI6Q>X(itCxQ6FD*Xs0+pWdMix<1Elw0s3+ zk0vB@G^gFf6C;^4icQBb!)@)==L9M}#4Wj}*V59Z^?`%u0Rq4@|sfY4He9zcPyAXsKe+@Z%1 zdK{s3IQjz0w<1)I@>dXg4WXA%{suyCBJ>tQFB)ScSz?*@P_C)-11m@VM<{-y!q^LPt^l4}^Y2=p@Qd zAao3&FA@3~+HQq{3}s?JcDp*jrJW9VFl&SR({Lp2ymWhj&7%~*ah zL#-KV%TP;(E@Anl3|+>MlysNdFqi#l5X zK?LXS#Hu~`W;dSu1mia2*S+Ykhe^iNu2&3vkCY!#r2_2}7<>Y%9(oz0P5ERxf9k_O zU+Xx}3Sk^z3-<(Vk#4eIYJ=Ds8Vx2%GG`n1_mxkV>pajTtSDxI3^eAkUbb0ywRL3X znM)bdPG>D2Ep>6dGRF{-AfNe3n7z$j`D)vdyc4CnF<ec(T4VUad zo1I8kKe-QW)QYPKmol#w@2JW0i_8^aM`O-SV?_@$rIe&a9_)Hjrw_J6D7wOJVz?7Xflfmxv`QZe)Vi7%(5tFWn6BU!@m~uV?|o% z6Q0Yf+$a3J6ze72D*W74l|WpgUKRI747Dgf2mX2HDB`6cp)P`TbZ)_V@aiMzA$&f( z2Jq71U4XO44fvJEgN}qB=){U%tS0WgO1)DCsqfXnFq{1eJTQq}d^3wvWnN#z#)9$H3A>?E zmXd)-?buW_f?xzsQ?4hkN2)>cpj4k_?K~+Qk!do&5ZgRU4{)y@SOYJqx#bTQ`~hfw01Et%Pi>I%wbxQ0k#A5w`)T**UW81hU~kP)!ar*pjpvb zNJ+wBr)cnA$9IkmqNiL>q%YEi%19dqWA+Q`**c8n@u(3h^SzL@Xz zcr?c4W13S|mM=GOvM?TkTw=e4-g@=D zy0%Ykw`iF0dr;(l5$_3ncn-TXU^L29=|;sq?ZmM3%e~o8pMMrhhMLfC)EI-8|2o-B z8uMmzzw^WIpU0QWEW4y41%vA1>xQ^fjI3pdtTc0b-Nf(RO=Kl-B#=4FDb$jlG;+1{ zK00F|v1+&Dvt77)H!j?n9b>+S4P0I42J1j`ro+|A)9YfvdVszsJwH zUKC92N@$p-7evD~GA%8$3xP^$5^63HBH>mksFhpF2VB4{QA{OMajDF-oU&!25;H5a zrWzZoaZGKonKql6Ru_Kfd0%yGn&$Ui{>$sttCtzv`&r)a=lwkAIp;ii*4MjVSV}(s z>Xh#tJ4iup>^^f>%fPh)U&JQ5e?L@aJfyTkgWNJ&Oww7;EsIlCCE_gq%@% zq(~aeY&_E`dA^$6qVuW4xD``{uw-4dP@gn=2%kt4{*%ZVg4enilx(B7ByJkJ?~vdn9x=B9?-K#*2KKg!j9l zMRyeTFvqRIU6J1#TY90D<4Zi*-}Kit15r8z-XM6x5W2~v6P3d?It?!i9LPmsPt+** zkH(-;*gOL9UrgpxJ=vxgi?8EF{aI@ONB3jR zU|utXyN7X21{*lY$S+#sEgbLigo{S8W{hQ1N)puYedjdaxcwyZPA1&N;>lb(k*lV% zYzo`V;H7u7Y?={u=E+v5*gTobRKAI#hDLJ!=`76IARmo5@<&B0xIuI;5+^J-4LdZV1mwZ`PV%eCGxu0B&7-w$0`uz z#2xRh!i1HGU5vVGv3k8ZocDXc`kVDOqy6cg#Y>N($781Q81xiUwqc7ybZZ=(dvqgy zdKEJy^icBiighb$cHy}sI`@7yZ<*IE?6zO>kFp09PKt@BfCb zTA7ZJ8SAK_v93>{LoK=%+oOWq7uk~n-ie0%J@5_s9F-ES!s?(_TGs3Gk;it#YQ(T3u zh}np=@9?EopF@&kwwN=RPb43y-4pnTblgLD{xF{Bm>xAb#=B6QZ>0sSgiU(w84P;- zQmfI$cG)rgFrTXzFe$w7?lo{pQSqXs?7WP-%DF;Ju(jp`>1|+T1wT}T9E;ro8I(9J zL;VspU*NSsl$0Q^ie-l<&$l3XQ#2Yk!Y56!#Kp#Kt+1pyZf%F}+u9-=-U8d&pvH~z z(b%hBkq_lEBir(vrIRe$%QEPWm5dG}vCGhIJ&N>=H)E)C zqNppHbbESNvrz(DEn<6};2M)8n>!ufDzsg1H}cnKt4`7|${~p3^y#T0B2g!!sx~#m zh1U(YQ4|5)(Je-#Nf9Qt1NuvOK2Y4JDx|}bLp3o2IzWROJC0Bb_%DIK3;dUwWFY2B z8yV@p9R91|55a#e{C(ihFu|Qa6aE|F9}NFc__N{9fpEiHWhm};+Oe>!xzo3FK3CPlodco#MSEiV6zi_)Kn!ieAGccb;_Kb``yOci%hA2~ z(_w2~B)^C55jGhiMpWeX2JuPFy(rZT_pDy1vmkEFw|Yx6uGuF%7ElmT;9y))~rgMMB8p6(Tb2M9Qm36b!CHDUUZ!G5Xf_36>&u)?5Q^ zx-Pu87oQx;T8c2)%#sDA!)MgPij}U%v1n4H7Ob?aKBOCL%P4to%1KX~x-BDmA~Xp; zHN{d4ITW|bm(3Y7_@{+zr)VkeeHBJu3|`8NE0`#P#5k0WMWgj{)Wl`&u(J&&E4NYR zzaHy$;jfPKuzoN6Lf41#6`fg<+hlP-0e`>3c!P4V6hDW#N?8rDpQXY!n-4U?3+<5H z28kD&OOh1d$!BxV^4UUzk_-4%Hv6=9Gp)o2+l5DVqmPb~y(aw-sP%R`jBbPa?eJ0amtI>Dj~o7W%4=(LPHVCMkouR9E1j#p?#=If4}D^;^`S2iddWuRhQ3DV8?&qr z{bYXip<@VriVzt39wEQ6-$S(-s>@I$L-maJ9ttqjgrTMkozKvPlqM(?%}|^vfs{wPca; zl-}rd%YHMRxeKg!Hd9G;i8ZI*%|}3CWGJVJj3Ic_v&eIf6E6$QiOuGp2{oQ-xw#m= zHkP49i&wML`eg!JRDi4RV;fwanb&YuKb{!C9t!WnE!k)_+Cuu`bRNv({jS|yeJ4xr z;*!ZWtaFWHag_1lMhgIeQ5=F5*hv)V(ZP$jy$)AGeIjKa%257@ZRP@EB;iY{@QzK$qzf<85%`72?-YEJ?@7CNMzxn? z0Pl`GtQ`mc2y@}Sz5qU%UCgk)u(+vmveE&1P#rftz<;aSTaCy{r`HRM^`z8$63ZWl zoL##;YkIv)wj;9IRJ5nWdOPvWYc_%Ulu}O`y|?l7F2u`dS~9&qpQX{0I&U9}POJ0! zd~{l!_g6czMcCN>86v+h7HHrlM1JKId6MJ(;Iw%ER*2^}v|;tXsPG!txi9^Z?_czH zEkxmFq?C7(+9h&I2L>)?WE(DM%lCdMxa)mJaF@Wvf@Pe;bJX=bD3fP7JgYd(uu}Ak zOzSUescVs|>#B)wDYqJ>LAuxYJSN`B|Etl*r?a_a7W>R(`~+4BlPqGqqN2yYpLYCs zrj*~G<@oW#8OIN|#?F|2Nc1Ylk7v$y{E*#r*!06WPV2-M22v(GGuNbKK4nni2B;=d z4@jFXi#a;N3V4sq0kT=r*l?9;7hqLW?AEeuhUDkH@J4$q>WG;g z&?5=a7o(sP1oM_jrRB(wrHxMycW#Q5;Hmk}d2YUQo0j;lg+a=d-B8&TAGl=6%SCSu zoh-+)uts1XL{1YSO_VJ`(~|03Dc-)S+Iei4#hv*q)(DtfPA_Mi!>Hrj*R{Iu`ia;k5eChPmx5TBfRysH6 zD@u9HX$?dgf7X44=$#@r9y}jMFTk;;sEI>jGt>l8h`l)OCqMrw5e^qy(*f)#dtW?r1uKi4JGCp%(|{k=9_17PJg+z(hAmD zvifCLkvso6E&&KV`GEQp%<_`|rA;{3Mf~jc_iS zd7PKacip@A**z#N+I4zFm3E!&h=byJwt_DKmAX^qNS-wmWZm32*BB#x^0-urhQ{WK zsdvOy$Y~CLOVsUv;0Q+RX_T57U1!~+01EZ2$FrWJohZ68n-?XszbZ8)r8*syo9W?* zZ#fm7m=CKA#ce46!^tKl6{}p8kvA5pB4_FW3gB&opi*V2HM9AmERVVV)8@|TV45Xr z!9)|3rFwigpM?{+P<@juURS`W4j1j=+Bbo6&Q*W5!dSkbd1L zyikR{E-dR7>Mg_QD)dU{)@7LY+Z&dru75jS>3=q;s2s`#M$t{*8LGZ5HUj#JqXdm zY-oabvr)e@*V&Mu_)L3}IjVrPFT#0p%^cWzmpD&?qCXs{&J z#?l+fVyucj#bMcN>lfYoo%?`kvU-UStE5P@s7drzn9#dc8hdB5tF!o)l$&=OZ(seI zL@A*49G2PzN2x)dizE>?w0$)BdYDzU0-f}%Zd+_!5|vbq(`*`GVqX>&T9K<$tezuW zu^W=o5&WgMx!#v=vT0;g$5l(mU5@oth-pqQ-e|hw$>+E}xN84q>dQcROeb_1z(K>SV@S;DpDb}u;d4b+eKBuH}jVsMGStGC1#CkrhbB*6BXHkU>;X1D8 zDbjB`pSZ(Xmhv1cRWUN3S*2X4_^{LrW4}@}MXkd%_W9an4`*}01E|jD;&m3CL>-UR z8LDKp3WWl+mG`ExWhR&1#254IGm||g6j_!VJD;hg99iZ()w8&Ai8X7MI#2ZzB}^!H zip~mtufs)+z`T&tAmK%f^;rL_K{mhTL&IY@$ zIhlMek5Mbn@^}|+Hk3Lt;?kLXlgVo6nUp5N8TSR(ng@<{fmYh`b?l>0=#IbiN0RH6 zBn?8+FvJRAzKNVyYOCweG9yk0#U@I#_pZ? zRWxly?*o!_8Dl&sU{;JNQN-0l7e9RXS25drw|J`mLW>Ig2U?Wp1`X(_ zEizJ#0*J^7;(MPN6ey;*e~B$ldF=lSCrT2Gf8j(a&gcn;*10&Zr}R5h2|cUqNVhK- z>N{bKJg&57E6zE9m$w>iKtpW#vnpj?C!|YBlo){87r$n(|B}8QEd2NM^-z%ojm7_# zxbCcXBY%Uk9{F38^-3cEcurSRH_qP3T?Y_(=Cb8_q=PKQDmzoqDAkdjvR_aS`$fUm&7PoE~f{Sm%wQ#}N( zbd%=vGfmtiIQ@)I^#XjL&+mS#h1u-*9(Duo6npjUfbV+v*4cbI`;ZB4Zrz1$y4*YP zT?OAy@O=;8`JzL(4_^WMb$#+T!p-2*1>6r`rEo$S{@5kSEXY?Ib^*G`%jtX0UBk8Z zzk);IyU`8BTLND_`kvSSa$liB<8t>!`ok6O=k7vbPwsDYv--vp z?h`aQPC2d0Ks^ejLn>;-TGTD*QtQ(0Mbq(KceD0%J^G5(;u0HYLpZSS6Z^BOgMgmT zUC!j{5!jPFgsdn|e;`ddM1DkQ+?vV{a?3l|yFMxIou-LbL<8umkyK*;e(o(_&RIPs)2<^J1BgyhTp z1ZK&adz;h3d}m3TSi1sGG?yo_9}f%86%k8gCDkI=68ftimwP+kxTmVyX-ctMgS8N> zgP`sx;(u<5wnjYsF&JBjWyOdqLd{IGM~m}NC99k{*i`CF(q`jc`J~-vGy~uN(ke~; zo!_5wOZ)f@s5>9wy7T`tx3us7qgz@{|Ff*pMxXLY)2Xf4GC&q6v&|88z+17C?D;o=okKV_v*>Q>CuK#jc^?nY^3)F5pOiW1mRXQ&pNa+nABRyNyb zv8XZ1E`a9eZ4v_mMtoE2+Y;)9FKS+QXv zLTwP)9&I~=9Wk#1dR_+4^;lc?Kzdg^&>Kv3gpg~H;`;ctdg7{Fw9}-{TTT2$$-buI zohi6NC%*V^6;P=RLe~1U^S)G5MiFx6>ZB+5(?L)%>w6b5l7IgG^|5YHEq9kFo?FzlPQ7ZS}X# zg=&ZDVT{e-4Qae@xZ!N?D}8cpFRJa8&cfRmeG}_C`dn5XpT5(X?Q2}uR0gM*(|+0A zRJ0FH2I@KWhpkpWcF>+ytT@8tea2 zg|v8*Y-6x$)-_gHtD^kA3j24UzBET8EP`zS#BQpoh3$3lLj

;=yWj@D9FgF2~wgLgqyg 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ⅇ~Yj?Ezay}4wdC0!pH{!?Rh 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

  • ^O$p6QcB?8duWOK_V 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 I*Y9!w04*6aYybcN literal 0 HcmV?d00001 diff --git a/.vs/FantasyNetTest/v17/.suo b/.vs/FantasyNetTest/v17/.suo new file mode 100644 index 0000000000000000000000000000000000000000..a6cc766c53642a3316e6407bc3813642ec8d33b5 GIT binary patch literal 52224 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 literal 0 HcmV?d00001 diff --git a/.vs/FantasyNetTest/v17/DocumentLayout.json b/.vs/FantasyNetTest/v17/DocumentLayout.json new file mode 100644 index 0000000..571a75a --- /dev/null +++ b/.vs/FantasyNetTest/v17/DocumentLayout.json @@ -0,0 +1,101 @@ +{ + "Version": 1, + "WorkspaceRootPath": "D:\\myself\\Games\\FantasyNetTest\\", + "Documents": [ + { + "AbsoluteMoniker": "D:0:0:{812F24C9-1386-4A5F-AC1D-1840E28FA05D}|FantasyNetTest\\FantasyNetTest.csproj|d:\\myself\\games\\fantasynettest\\fantasynettest\\form1.cs||{A6C744A8-0E4A-4FC6-886A-064283054674}", + "RelativeMoniker": "D:0:0:{812F24C9-1386-4A5F-AC1D-1840E28FA05D}|FantasyNetTest\\FantasyNetTest.csproj|solutionrelative:fantasynettest\\form1.cs||{A6C744A8-0E4A-4FC6-886A-064283054674}" + }, + { + "AbsoluteMoniker": "D:0:0:{812F24C9-1386-4A5F-AC1D-1840E28FA05D}|FantasyNetTest\\FantasyNetTest.csproj|D:\\myself\\Games\\FantasyNetTest\\fantasynettest\\form1.cs||{A6C744A8-0E4A-4FC6-886A-064283054674}|Form", + "RelativeMoniker": "D:0:0:{812F24C9-1386-4A5F-AC1D-1840E28FA05D}|FantasyNetTest\\FantasyNetTest.csproj|solutionrelative:fantasynettest\\form1.cs||{A6C744A8-0E4A-4FC6-886A-064283054674}|Form" + }, + { + "AbsoluteMoniker": "D:0:0:{812F24C9-1386-4A5F-AC1D-1840E28FA05D}|FantasyNetTest\\FantasyNetTest.csproj|d:\\myself\\games\\fantasynettest\\fantasynettest\\testprotocol.cs||{A6C744A8-0E4A-4FC6-886A-064283054674}", + "RelativeMoniker": "D:0:0:{812F24C9-1386-4A5F-AC1D-1840E28FA05D}|FantasyNetTest\\FantasyNetTest.csproj|solutionrelative:fantasynettest\\testprotocol.cs||{A6C744A8-0E4A-4FC6-886A-064283054674}" + }, + { + "AbsoluteMoniker": "D:0:0:{812F24C9-1386-4A5F-AC1D-1840E28FA05D}|FantasyNetTest\\FantasyNetTest.csproj|d:\\myself\\games\\fantasynettest\\fantasynettest\\config.json||{90A6B3A7-C1A3-4009-A288-E2FF89E96FA0}", + "RelativeMoniker": "D:0:0:{812F24C9-1386-4A5F-AC1D-1840E28FA05D}|FantasyNetTest\\FantasyNetTest.csproj|solutionrelative:fantasynettest\\config.json||{90A6B3A7-C1A3-4009-A288-E2FF89E96FA0}" + }, + { + "AbsoluteMoniker": "D:0:0:{812F24C9-1386-4A5F-AC1D-1840E28FA05D}|FantasyNetTest\\FantasyNetTest.csproj|d:\\myself\\games\\fantasynettest\\fantasynettest\\log.cs||{A6C744A8-0E4A-4FC6-886A-064283054674}", + "RelativeMoniker": "D:0:0:{812F24C9-1386-4A5F-AC1D-1840E28FA05D}|FantasyNetTest\\FantasyNetTest.csproj|solutionrelative:fantasynettest\\log.cs||{A6C744A8-0E4A-4FC6-886A-064283054674}" + } + ], + "DocumentGroupContainers": [ + { + "Orientation": 0, + "VerticalTabListWidth": 256, + "DocumentGroups": [ + { + "DockedWidth": 200, + "SelectedChildIndex": 0, + "Children": [ + { + "$type": "Document", + "DocumentIndex": 0, + "Title": "Form1.cs", + "DocumentMoniker": "D:\\myself\\Games\\FantasyNetTest\\FantasyNetTest\\Form1.cs", + "RelativeDocumentMoniker": "FantasyNetTest\\Form1.cs", + "ToolTip": "D:\\myself\\Games\\FantasyNetTest\\FantasyNetTest\\Form1.cs", + "RelativeToolTip": "FantasyNetTest\\Form1.cs", + "ViewState": "AQIAAGcCAAAAAAAAAAAiwHUCAAAAAAAA", + "Icon": "ae27a6b0-e345-4288-96df-5eaf394ee369.000738|", + "WhenOpened": "2025-08-10T14:06:30.336Z", + "EditorCaption": "" + }, + { + "$type": "Document", + "DocumentIndex": 1, + "Title": "Form1.cs [\u8BBE\u8BA1]", + "DocumentMoniker": "D:\\myself\\Games\\FantasyNetTest\\FantasyNetTest\\Form1.cs", + "RelativeDocumentMoniker": "FantasyNetTest\\Form1.cs", + "ToolTip": "D:\\myself\\Games\\FantasyNetTest\\FantasyNetTest\\Form1.cs [\u8BBE\u8BA1]", + "RelativeToolTip": "FantasyNetTest\\Form1.cs [\u8BBE\u8BA1]", + "Icon": "ae27a6b0-e345-4288-96df-5eaf394ee369.000738|", + "WhenOpened": "2025-08-10T11:09:51.154Z", + "EditorCaption": " [\u8BBE\u8BA1]" + }, + { + "$type": "Document", + "DocumentIndex": 2, + "Title": "TestProtocol.cs", + "DocumentMoniker": "D:\\myself\\Games\\FantasyNetTest\\FantasyNetTest\\TestProtocol.cs", + "RelativeDocumentMoniker": "FantasyNetTest\\TestProtocol.cs", + "ToolTip": "D:\\myself\\Games\\FantasyNetTest\\FantasyNetTest\\TestProtocol.cs", + "RelativeToolTip": "FantasyNetTest\\TestProtocol.cs", + "ViewState": "AQIAAAYAAAAAAAAAAADwvxcAAAAlAAAA", + "Icon": "ae27a6b0-e345-4288-96df-5eaf394ee369.000738|", + "WhenOpened": "2025-08-10T09:28:41.991Z" + }, + { + "$type": "Document", + "DocumentIndex": 3, + "Title": "Config.json", + "DocumentMoniker": "D:\\myself\\Games\\FantasyNetTest\\FantasyNetTest\\Config.json", + "RelativeDocumentMoniker": "FantasyNetTest\\Config.json", + "ToolTip": "D:\\myself\\Games\\FantasyNetTest\\FantasyNetTest\\Config.json", + "RelativeToolTip": "FantasyNetTest\\Config.json", + "ViewState": "AQIAAAAAAAAAAAAAAAAAAAMAAAABAAAA", + "Icon": "ae27a6b0-e345-4288-96df-5eaf394ee369.001642|", + "WhenOpened": "2025-08-10T07:28:50.344Z" + }, + { + "$type": "Document", + "DocumentIndex": 4, + "Title": "Log.cs", + "DocumentMoniker": "D:\\myself\\Games\\FantasyNetTest\\FantasyNetTest\\Log.cs", + "RelativeDocumentMoniker": "FantasyNetTest\\Log.cs", + "ToolTip": "D:\\myself\\Games\\FantasyNetTest\\FantasyNetTest\\Log.cs", + "RelativeToolTip": "FantasyNetTest\\Log.cs", + "ViewState": "AQIAAEsAAAAAAAAAAAAYwB8AAAApAAAA", + "Icon": "ae27a6b0-e345-4288-96df-5eaf394ee369.000738|", + "WhenOpened": "2025-08-10T06:36:37.693Z" + } + ] + } + ] + } + ] +} \ No newline at end of file diff --git a/.vs/ProjectEvaluation/fantasynettest.metadata.v7.bin b/.vs/ProjectEvaluation/fantasynettest.metadata.v7.bin new file mode 100644 index 0000000000000000000000000000000000000000..320df57a251b09b76786a22076105512c924a602 GIT binary patch literal 202235 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 HNBjN(-8jiq literal 0 HcmV?d00001 diff --git a/.vs/ProjectEvaluation/fantasynettest.projects.v7.bin b/.vs/ProjectEvaluation/fantasynettest.projects.v7.bin new file mode 100644 index 0000000000000000000000000000000000000000..a5ded59287538225a987a24eeedf6d3a76511e48 GIT binary patch literal 736814 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

    Xu_j}#|V!T#t@z$JV_W!7)N-D@HF8W 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%0AJDs)2(0z1pwf5O)%34 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 + ForceIncluded + ForceIncluded + ForceIncluded + ForceIncluded + ForceIncluded + ForceIncluded + True + True \ No newline at end of file diff --git a/FantasyNetTest/Config.cs b/FantasyNetTest/Config.cs new file mode 100644 index 0000000..ff025b3 --- /dev/null +++ b/FantasyNetTest/Config.cs @@ -0,0 +1,25 @@ +namespace FantasyNetTest; + +[Serializable] +public class Config +{ + ///

    + /// 登录服地址 + /// + public string Server { get; set; } = "127.0.0.1:20001"; + + /// + /// 心跳间隔 + /// + public int Heartbeat { get; set; } = 5; + + /// + /// 默认账号 + /// + public string Account { get; set; } = ""; + + /// + /// 协议目录 + /// + public string ProtocolScriptPath { get; set; } = ""; +} \ No newline at end of file diff --git a/FantasyNetTest/Config.json b/FantasyNetTest/Config.json new file mode 100644 index 0000000..c47c2dd --- /dev/null +++ b/FantasyNetTest/Config.json @@ -0,0 +1,6 @@ +{ + "Server": "127.0.0.1:20001", + "Heartbeat": 5, + "ProtocolScriptPath": "D:\\myself\\Games\\Fishing2\\Assets\\Scripts\\Generate", + "Account": "test003" +} \ No newline at end of file diff --git a/FantasyNetTest/FantasyNetTest.csproj b/FantasyNetTest/FantasyNetTest.csproj new file mode 100644 index 0000000..341df3e --- /dev/null +++ b/FantasyNetTest/FantasyNetTest.csproj @@ -0,0 +1,31 @@ + + + + WinExe + net8.0-windows + enable + true + enable + true + + + + + Never + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/FantasyNetTest/FantasyNetTest.csproj.user b/FantasyNetTest/FantasyNetTest.csproj.user new file mode 100644 index 0000000..3a34caa --- /dev/null +++ b/FantasyNetTest/FantasyNetTest.csproj.user @@ -0,0 +1,8 @@ + + + + + Form + + + \ No newline at end of file diff --git a/FantasyNetTest/Form1.Designer.cs b/FantasyNetTest/Form1.Designer.cs new file mode 100644 index 0000000..b99b35d --- /dev/null +++ b/FantasyNetTest/Form1.Designer.cs @@ -0,0 +1,210 @@ +namespace FantasyNetTest; + +partial class Form1 +{ + /// + /// Required designer variable. + /// + private System.ComponentModel.IContainer components = null; + + /// + /// Clean up any resources being used. + /// + /// true if managed resources should be disposed; otherwise, false. + protected override void Dispose(bool disposing) + { + if (disposing && (components != null)) + { + components.Dispose(); + } + + base.Dispose(disposing); + } + + #region Windows Form Designer generated code + + /// + /// Required method for Designer support - do not modify + /// the contents of this method with the code editor. + /// + private void InitializeComponent() + { + components = new System.ComponentModel.Container(); + groupBox4 = new GroupBox(); + linkLabel1 = new LinkLabel(); + logTextBox = new RichTextBox(); + groupBox1 = new GroupBox(); + buttonConnect = new Button(); + textBoxAccount = new TextBox(); + groupBox2 = new GroupBox(); + panel1 = new Panel(); + buttonSend = new Button(); + timer1 = new System.Windows.Forms.Timer(components); + groupBox3 = new GroupBox(); + comboBoxProtocol = new ComboBox(); + timer2 = new System.Windows.Forms.Timer(components); + groupBox4.SuspendLayout(); + groupBox1.SuspendLayout(); + groupBox2.SuspendLayout(); + groupBox3.SuspendLayout(); + SuspendLayout(); + // + // groupBox4 + // + groupBox4.Controls.Add(linkLabel1); + groupBox4.Controls.Add(logTextBox); + groupBox4.Location = new Point(329, 7); + groupBox4.Name = "groupBox4"; + groupBox4.Size = new Size(375, 406); + groupBox4.TabIndex = 0; + groupBox4.TabStop = false; + groupBox4.Text = "输出"; + // + // linkLabel1 + // + linkLabel1.AutoSize = true; + linkLabel1.LinkBehavior = LinkBehavior.NeverUnderline; + linkLabel1.LinkColor = Color.Black; + linkLabel1.Location = new Point(354, 13); + linkLabel1.Name = "linkLabel1"; + linkLabel1.Size = new Size(16, 17); + linkLabel1.TabIndex = 2; + linkLabel1.TabStop = true; + linkLabel1.Text = "X"; + linkLabel1.LinkClicked += linkLabel1_LinkClicked; + // + // logTextBox + // + logTextBox.BackColor = SystemColors.Control; + logTextBox.BorderStyle = BorderStyle.None; + logTextBox.Location = new Point(6, 22); + logTextBox.Name = "logTextBox"; + logTextBox.ReadOnly = true; + logTextBox.Size = new Size(363, 372); + logTextBox.TabIndex = 0; + logTextBox.Text = ""; + // + // groupBox1 + // + groupBox1.Controls.Add(buttonConnect); + groupBox1.Controls.Add(textBoxAccount); + groupBox1.Location = new Point(7, 7); + groupBox1.Name = "groupBox1"; + groupBox1.Size = new Size(316, 62); + groupBox1.TabIndex = 1; + groupBox1.TabStop = false; + groupBox1.Text = "账号"; + // + // buttonConnect + // + buttonConnect.Location = new Point(235, 23); + buttonConnect.Name = "buttonConnect"; + buttonConnect.Size = new Size(75, 23); + buttonConnect.TabIndex = 2; + buttonConnect.Text = "登录"; + buttonConnect.UseVisualStyleBackColor = true; + buttonConnect.Click += buttonConnect_Click; + // + // textBoxAccount + // + textBoxAccount.Location = new Point(10, 23); + textBoxAccount.Name = "textBoxAccount"; + textBoxAccount.Size = new Size(219, 23); + textBoxAccount.TabIndex = 0; + // + // groupBox2 + // + groupBox2.Controls.Add(panel1); + groupBox2.Location = new Point(5, 145); + groupBox2.Name = "groupBox2"; + groupBox2.Size = new Size(318, 225); + groupBox2.TabIndex = 2; + groupBox2.TabStop = false; + groupBox2.Text = "协议内容"; + // + // panel1 + // + panel1.Location = new Point(4, 20); + panel1.Name = "panel1"; + panel1.Size = new Size(308, 199); + panel1.TabIndex = 0; + // + // buttonSend + // + buttonSend.BackColor = SystemColors.ActiveCaption; + buttonSend.Font = new Font("Microsoft YaHei UI", 11F, FontStyle.Bold); + buttonSend.Location = new Point(7, 376); + buttonSend.Name = "buttonSend"; + buttonSend.Size = new Size(318, 37); + buttonSend.TabIndex = 0; + buttonSend.Text = "发送"; + buttonSend.UseVisualStyleBackColor = false; + buttonSend.Click += buttonSend_Click; + // + // timer1 + // + timer1.Enabled = true; + timer1.Interval = 1; + timer1.Tick += timer1_Tick; + // + // groupBox3 + // + groupBox3.Controls.Add(comboBoxProtocol); + groupBox3.Location = new Point(7, 75); + groupBox3.Name = "groupBox3"; + groupBox3.Size = new Size(316, 64); + groupBox3.TabIndex = 3; + groupBox3.TabStop = false; + groupBox3.Text = "协议选择"; + // + // comboBoxProtocol + // + comboBoxProtocol.FormattingEnabled = true; + comboBoxProtocol.Location = new Point(7, 28); + comboBoxProtocol.Name = "comboBoxProtocol"; + comboBoxProtocol.Size = new Size(303, 25); + comboBoxProtocol.TabIndex = 0; + // + // timer2 + // + timer2.Enabled = true; + timer2.Interval = 16; + timer2.Tick += timer2_Tick; + // + // Form1 + // + AutoScaleDimensions = new SizeF(7F, 17F); + AutoScaleMode = AutoScaleMode.Font; + ClientSize = new Size(707, 418); + Controls.Add(buttonSend); + Controls.Add(groupBox3); + Controls.Add(groupBox2); + Controls.Add(groupBox1); + Controls.Add(groupBox4); + Name = "Form1"; + Text = "协议调试器"; + groupBox4.ResumeLayout(false); + groupBox4.PerformLayout(); + groupBox1.ResumeLayout(false); + groupBox1.PerformLayout(); + groupBox2.ResumeLayout(false); + groupBox3.ResumeLayout(false); + ResumeLayout(false); + } + + #endregion + + private GroupBox groupBox1; + private GroupBox groupBox2; + private GroupBox groupBox4; + private RichTextBox logTextBox; + private TextBox textBoxAccount; + private Button buttonConnect; + private Button buttonSend; + private System.Windows.Forms.Timer timer1; + private LinkLabel linkLabel1; + private GroupBox groupBox3; + private ComboBox comboBoxProtocol; + private Panel panel1; + private System.Windows.Forms.Timer timer2; +} \ No newline at end of file diff --git a/FantasyNetTest/Form1.cs b/FantasyNetTest/Form1.cs new file mode 100644 index 0000000..57d0849 --- /dev/null +++ b/FantasyNetTest/Form1.cs @@ -0,0 +1,757 @@ +using System.Globalization; +using System.Reflection; +using System.Text.Json; +using NBC; +using NBC.InnerMessage; +using NBC.Network; +using NBC.Network.Interface; +using ProtoBuf; +using EventArgs = System.EventArgs; + +#pragma warning disable CS8618 // 在退出构造函数时，不可为 null 的字段必须包含非 null 值。请考虑添加 'required' 修饰符或声明为可以为 null。 + +namespace FantasyNetTest; + +public partial class Form1 : Form +{ + private Config _config; + + private ScriptLoader _scriptLoader; + + private List _allRequest = new List(); + + private object _selectProtocolObject; + private TableLayoutPanel _tableLayoutPanel; + + private Scene _scene; + + private string PathRoot; + + public Form1() + { + InitializeComponent(); + this.FormBorderStyle = FormBorderStyle.FixedSingle; + this.MaximizeBox = false; + this.MinimizeBox = false; + + comboBoxProtocol.SelectedIndexChanged += ComboBox_SelectedIndexChanged; + comboBoxProtocol.DropDownStyle = ComboBoxStyle.DropDownList; + _config ??= new Config(); + LoadConfig(); + textBoxAccount.Text = _config.Account; + + _scriptLoader = new ScriptLoader(); + + + var time = UnityEngine.Time.time; + Log.Init(logTextBox); + LoadProtocol(); + StartAsync().Coroutine(); + } + + private void SwitchLoginButtonState() + { + if (_session == null) + { + buttonConnect.Text = "登录"; + } + else + { + buttonConnect.Text = "退出"; + } + } + + #region 框架 + + private NBC.Platform.Unity.Entry _entry; + + private async FTask StartAsync() + { + Log.Info("开始初始化框架"); + // 初始化框架 + var assemblies = AppDomain.CurrentDomain.GetAssemblies(); + List loadAssemblies = new List(); + foreach (var assembly in assemblies) + { + // 跳过系统程序集以提高性能（可选） + if (IsSystemAssembly(assembly)) + continue; + loadAssemblies.Add(assembly); + } + + _entry = await NBC.Platform.Unity.Entry.Initialize(loadAssemblies.ToArray()); + _scene = await Scene.Create(SceneRuntimeMode.MainThread); + _scene.AddComponent(); + + NetMessageDelegate.OnMessage += OnMessage; + NetMessageDelegate.OnRequest += OnRequest; + NetMessageDelegate.OnResponse += OnResponse; + Log.Succeed("初始化框架成功"); + } + + // 判断是否是系统程序集（可选优化） + private static bool IsSystemAssembly(System.Reflection.Assembly assembly) + { + string assemblyName = assembly.FullName; + return assemblyName.StartsWith("System") || + assemblyName.StartsWith("Microsoft.") || + assemblyName.StartsWith("UnityEngine") || + assemblyName.StartsWith("UnityEditor") || + assemblyName.StartsWith("mscorlib") || + assemblyName.StartsWith("netstandard") || + assemblyName.StartsWith("nunit.") || + assemblyName.StartsWith("Unity."); + } + + private void OnMessage(Session session, Type type, object message, uint rpcId, uint protocolCode) + { + if (session != _session) return; + var json = message.ToJson(); + Log.Succeed($"收到消息, type={type.Name} data={json}"); + } + + private void OnRequest(IRequest request, long routeId = 0) + { + if (request == null) return; + if (request is PingRequest) return; + var json = request.ToJson(); + Log.Info($"发送消息, op={request.OpCode()} data={json}"); + } + + private void OnResponse(IResponse request) + { + if (request == null) return; + if (request is PingResponse) return; + var json = request.ToJson(); + Log.Succeed($"收到响应消息, op={request.OpCode()} data={json}"); + } + + #endregion + + + #region 登录 + + private Session? _session; + + private async FTask OnLoginButtonClick(string account) + { + // 根据用户名来选择目标的鉴权服务器 + // 根据鉴权服务器地址来创建一个新的网络会话 + _session = SessionHelper.CreateSession(_scene, _config.Server, OnConnectComplete, + OnConnectFail, + OnConnectDisconnect); + + var acc = account; + + + // 首先确保已加载包含该类的程序集 + var type = CoderLoader.GetTypeByName("C2A_LoginRequest"); + + + if (type == null) + { + Log.Error("NBC.C2A_LoginRequest 类未加载"); + return; + } + + var instance = Activator.CreateInstance(type); + + if (instance == null) + { + Log.Error("NBC.C2A_LoginRequest 类实例化失败"); + return; + } + + instance.SetPropertyValue("Username", acc); + instance.SetPropertyValue("Password", acc); + instance.SetPropertyValue("LoginType", 1); + + if (instance is not IRequest loginRequest) + { + Log.Error("instance is not IRequest loginRequest"); + return; + } + + var response = await _session.Call(loginRequest); + if (response.ErrorCode != 0) + { + Log.Error($"登录发生错误{response.ErrorCode}"); + return; + } + + string? token = response.GetPropertyValue("ToKen")?.ToString(); + + if (string.IsNullOrEmpty(token)) + { + Log.Error($"登录 Token is null"); + return; + } + + if (!_scene.GetComponent().Parse(token, out var payload)) + { + return; + } + + // 根据ToKen返回的Address登录到Gate服务器 + _session = SessionHelper.CreateSession(_scene, payload.Address, OnConnectComplete, OnConnectFail, + OnConnectDisconnect); + + + // 首先确保已加载包含该类的程序集 + var typeGate = CoderLoader.GetTypeByName("C2G_LoginRequest"); + + + if (typeGate == null) + { + Log.Error("NBC.C2G_LoginRequest 类未加载"); + return; + } + + var instanceGate = Activator.CreateInstance(typeGate); + + if (instanceGate == null) + { + Log.Error("NBC.C2G_LoginRequest 类实例化失败"); + return; + } + + instanceGate.SetPropertyValue("ToKen", token); + if (instanceGate is not IRequest loginGateRequest) + { + Log.Error("instance is not IRequest loginRequest"); + return; + } + + var responseGate = await _session.Call(loginGateRequest); + if (responseGate.ErrorCode != 0) + { + Log.Error($"登录网关发生错误{responseGate.ErrorCode}"); + return; + } + + Log.Succeed($"登录到Gate服务器成功！ErrorCode:{responseGate.ErrorCode}"); + + + // // 发送登录的请求给服务器 + // var response = (A2C_LoginResponse)await _session.Call(new C2A_LoginRequest() + // { + // Username = acc, + // Password = acc, + // LoginType = 1 + // }); + // + // if (response.ErrorCode != 0) + // { + // Log.Error($"登录发生错误{response.ErrorCode}"); + // return; + // } + // + // if (!_scene.GetComponent().Parse(response.ToKen, out var payload)) + // { + // return; + // } + // + // // 根据ToKen返回的Address登录到Gate服务器 + // _session = SessionHelper.CreateSession(_scene, payload.Address, OnConnectComplete, OnConnectFail, + // OnConnectDisconnect); + // // 发送登录请求到Gate服务器 + // var loginResponse = (G2C_LoginResponse)await _session.Call(new C2G_LoginRequest() + // { + // ToKen = response.ToKen + // }); + // if (loginResponse.ErrorCode != 0) + // { + // Log.Error($"登录发生错误{loginResponse.ErrorCode}"); + // return; + // } + // + // Log.Succeed($"登录到Gate服务器成功！ErrorCode:{loginResponse.ErrorCode}"); + SwitchLoginButtonState(); + } + + private void OnConnectComplete() + { + Log.Succeed("连接成功"); + // 添加心跳组件给Session。 + // Start(2000)就是2000毫秒。 + _session?.AddComponent().Start(5000); + } + + private void OnConnectFail() + { + Log.Error("连接失败"); + _session = null; + SwitchLoginButtonState(); + } + + private void OnConnectDisconnect() + { + Log.Error("连接断开"); + _session = null; + SwitchLoginButtonState(); + } + + #endregion + + + #region Config + + private void LoadConfig() + { + var configPath = Path.Combine(Application.StartupPath, "Config.json"); + if (File.Exists(configPath)) + { + string jsonContent = File.ReadAllText(configPath); + var cfg = JsonSerializer.Deserialize(jsonContent); + if (cfg != null) + { + _config.Account = cfg.Account; + _config.Server = cfg.Server; + _config.Heartbeat = cfg.Heartbeat; + _config.ProtocolScriptPath = cfg.ProtocolScriptPath; + } + } + } + + private void SaveConfig() + { + _config.Account = textBoxAccount.Text; + var configPath = Path.Combine(Application.StartupPath, "Config.json"); + var json = JsonSerializer.Serialize(_config); + File.WriteAllText(configPath, json); + } + + #endregion + + #region 协议下拉框 + + private void LoadProtocol() + { + Log.Info("开始加载协议"); + _scriptLoader.LoadAndExecuteScriptsAsync(_config.ProtocolScriptPath); + Log.Succeed("加载协议完成"); + CoderLoader.Load(); + SetProtocolComboBox(); + } + + private void SetProtocolComboBox() + { + comboBoxProtocol.Items.Clear(); + + var types = CoderLoader.RequestTypes; + _allRequest.Clear(); + _allRequest.AddRange(types); + foreach (var type in _allRequest) + { + comboBoxProtocol.Items.Add(type.Name); + } + } + + // 事件处理方法 + private void ComboBox_SelectedIndexChanged(object sender, EventArgs e) + { + ComboBox comboBox = (ComboBox)sender; + + var index = comboBox.SelectedIndex; + var proto = comboBox.SelectedItem?.ToString(); + Log.Info($"选中协议：{proto} Index={index}"); + SelectedProtocol(_allRequest[index]); + } + + private void SelectedProtocol(Type type) + { + var obj = Activator.CreateInstance(type); + if (obj != null) + { + _selectProtocolObject = obj; + LoadCacheProtocol(obj); + // 生成UI + GenerateKeyValueInputs(panel1, _selectProtocolObject); + } + } + + #endregion + + #region 协议内容反射 + + private List _propertyInfos = new List(); + + public void GenerateKeyValueInputs(Panel containerPanel, object configObject) + { + // 清除现有控件 + containerPanel.Controls.Clear(); + + + // 创建TableLayoutPanel + var tablePanel = new TableLayoutPanel + { + ColumnCount = 2, + Dock = DockStyle.Top, // 重要：设置为Top而不是Fill + AutoSize = true, + AutoSizeMode = AutoSizeMode.GrowAndShrink, + GrowStyle = TableLayoutPanelGrowStyle.AddRows + }; + + _tableLayoutPanel = tablePanel; + + // 设置列宽比例 + tablePanel.ColumnStyles.Add(new ColumnStyle(SizeType.Percent, 30)); + tablePanel.ColumnStyles.Add(new ColumnStyle(SizeType.Percent, 70)); + + // 获取对象的所有属性 + var propertySources = configObject.GetType().GetProperties(); + + _propertyInfos.Clear(); + + foreach (var propertySource in propertySources) + { + if (propertySource.GetCustomAttribute() != null) + { + _propertyInfos.Add(propertySource); + } + } + + PropertyInfo[] properties = _propertyInfos.ToArray(); + + //var properties + // 设置表格行数和列数 + tablePanel.ColumnCount = 2; + tablePanel.RowCount = properties.Length; + + // 设置固定的行高 + int rowHeight = 30; // 每行固定高度 + + + // 添加属性和值输入框 + for (int i = 0; i < properties.Length; i++) + { + var property = properties[i]; + + // 设置行样式 + tablePanel.RowStyles.Add(new RowStyle(SizeType.Absolute, rowHeight)); + + // 添加属性名标签 (Key) + var label = new Label + { + Text = $@"[{GetTypeShowName(property.PropertyType)}] {property.Name}", + Dock = DockStyle.Fill, + TextAlign = ContentAlignment.MiddleLeft, + Margin = new Padding(3), + Height = rowHeight, + }; + if (label.Text.Length > 13) + { + label.Text = label.Text.Substring(0, 12); + } + + tablePanel.Controls.Add(label, 0, i); + + tablePanel.Controls.Add(CreateControl(property, configObject), 1, i); + } + + // 将TableLayoutPanel添加到容器Panel中 + containerPanel.Controls.Add(tablePanel); + + // 启用自动滚动 + containerPanel.AutoScroll = true; + containerPanel.VerticalScroll.Enabled = true; + containerPanel.VerticalScroll.Visible = true; + } + + private Control CreateControl(PropertyInfo property, object configObject) + { + // 添加值输入控件 (Value) + Control inputControl; + + // 根据属性类型创建不同的输入控件 + if (property.PropertyType == typeof(bool)) + { + var checkbox = new CheckBox + { + Checked = (bool)property.GetValue(configObject), + Dock = DockStyle.Fill, + TextAlign = ContentAlignment.MiddleLeft + }; + inputControl = checkbox; + } + else if (property.PropertyType == typeof(int) || property.PropertyType == typeof(long) || + property.PropertyType == typeof(double) || + property.PropertyType == typeof(decimal) || property.PropertyType == typeof(float)) + { + var numericBox = new NumericUpDown + { + Value = Convert.ToDecimal(property.GetValue(configObject)), + Dock = DockStyle.Fill, + Minimum = decimal.MinValue, + Maximum = decimal.MaxValue + }; + inputControl = numericBox; + } + else if (property.PropertyType == typeof(uint)) + { + var numericBox = new NumericUpDown + { + Value = Convert.ToDecimal(property.GetValue(configObject)), + Dock = DockStyle.Fill, + Minimum = uint.MinValue, + Maximum = uint.MaxValue + }; + inputControl = numericBox; + } + else if (property.PropertyType == typeof(short)) + { + var numericBox = new NumericUpDown + { + Value = Convert.ToDecimal(property.GetValue(configObject)), + Dock = DockStyle.Fill, + Minimum = short.MinValue, + Maximum = short.MaxValue + }; + inputControl = numericBox; + } + else + { + var textBox = new TextBox + { + Text = property.GetValue(configObject)?.ToString() ?? "", + Dock = DockStyle.Fill, + Margin = new Padding(3) + }; + inputControl = textBox; + } + + return inputControl; + } + + private string GetTypeShowName(Type type) + { + if (type == typeof(bool)) + { + return "B"; + } + + if (type == typeof(byte)) + { + return "B"; + } + + if (type == typeof(short)) + { + return "S"; + } + + if (type == typeof(int)) + { + return "I"; + } + + if (type == typeof(uint)) + { + return "U"; + } + + if (type == typeof(long)) + { + return "L"; + } + + if (type == typeof(double)) + { + return "D"; + } + + if (type == typeof(float)) + { + return "F"; + } + + if (type == typeof(decimal)) + { + return "M"; + } + + if (type == typeof(string)) + { + return "S"; + } + + return type.Name; + } + + public void SaveDataFromUI(object configObject) + { + TableLayoutPanel tablePanel = _tableLayoutPanel; + + // var properties = configObject.GetType().GetProperties(); + + for (int i = 0; i < _propertyInfos.Count; i++) + { + var property = _propertyInfos[i]; + var inputControl = tablePanel.GetControlFromPosition(1, i); + + try + { + if (inputControl is CheckBox checkbox) + { + property.SetValue(configObject, checkbox.Checked); + } + else if (inputControl is NumericUpDown numericBox) + { + if (property.PropertyType == typeof(int)) + property.SetValue(configObject, (int)numericBox.Value); + else if (property.PropertyType == typeof(double)) + property.SetValue(configObject, (double)numericBox.Value); + else if (property.PropertyType == typeof(decimal)) + property.SetValue(configObject, numericBox.Value); + else if (property.PropertyType == typeof(uint)) + property.SetValue(configObject, (uint)numericBox.Value); + else if (property.PropertyType == typeof(float)) + property.SetValue(configObject, (float)numericBox.Value); + else if (property.PropertyType == typeof(short)) + property.SetValue(configObject, (short)numericBox.Value); + } + else if (inputControl is TextBox textBox) + { + property.SetValue(configObject, Convert.ChangeType(textBox.Text, property.PropertyType)); + } + } + catch (Exception ex) + { + MessageBox.Show($"设置属性 {property.Name} 时出错: {ex.Message}"); + } + } + } + + #endregion + + #region 协议内存缓存和加载 + + private string ProtocolPathPath = Path.Combine(Application.StartupPath, "Protocol"); + + private void CacheProtocol(object obj) + { + if (obj == null) return; + if (!Directory.Exists(ProtocolPathPath)) + { + Directory.CreateDirectory(ProtocolPathPath); + } + + var json = JsonSerializer.Serialize(obj); + var type = obj.GetType(); + File.WriteAllText(Path.Combine(ProtocolPathPath, type.Name), json); + } + + private void LoadCacheProtocol(object obj) + { + if (obj == null) return; + if (!Directory.Exists(ProtocolPathPath)) + { + return; + } + + var path = Path.Combine(ProtocolPathPath, obj.GetType().Name); + if (File.Exists(path)) + { + var json = File.ReadAllText(path); + var deserializeObj = JsonSerializer.Deserialize(json, obj.GetType()); + if (deserializeObj != null) + { + // 获取所有可写属性 + var properties = obj.GetType().GetProperties(BindingFlags.Public | BindingFlags.Instance) + .Where(p => p.CanWrite); + + foreach (var property in properties) + { + // 从反序列化对象中获取值 + var value = property.GetValue(deserializeObj); + // 设置到目标对象中 + property.SetValue(obj, value); + } + + // 或者处理字段（如果需要） + var fields = obj.GetType().GetFields(BindingFlags.Public | BindingFlags.Instance) + .Where(f => !f.IsInitOnly); // 排除只读字段 + + foreach (var field in fields) + { + var value = field.GetValue(deserializeObj); + field.SetValue(obj, value); + } + } + } + } + + #endregion + + #region 事件 + + private void buttonSend_Click(object sender, EventArgs e) + { + if (_session == null) + { + Log.Error("未连接服务器！"); + return; + } + + if (_selectProtocolObject == null) + { + Log.Error("未选择协议！"); + return; + } + + SaveDataFromUI(_selectProtocolObject); + CacheProtocol(_selectProtocolObject); + + if (_selectProtocolObject is IRequest request) + { + _session.Call(request).Coroutine(); + } + } + + private void buttonConnect_Click(object sender, EventArgs e) + { + if (_session == null) + { + if (string.IsNullOrEmpty(textBoxAccount.Text)) + { + Log.Error("未输入账号"); + return; + } + + //登录 + OnLoginButtonClick(textBoxAccount.Text).Coroutine(); + SwitchLoginButtonState(); + } + else + { + //退出 + _session.Dispose(); + } + + SaveConfig(); + } + + + private void timer1_Tick(object sender, EventArgs e) + { + Log.Tick(); + } + + private void linkLabel1_LinkClicked(object sender, LinkLabelLinkClickedEventArgs e) + { + Log.Clear(); + } + + private void timer2_Tick(object sender, EventArgs e) + { + _entry?.Update(); + if (_session != null && _session.IsDisposed) + { + _session.Dispose(); + _session = null; + return; + } + } + + #endregion +} \ No newline at end of file diff --git a/FantasyNetTest/Form1.resx b/FantasyNetTest/Form1.resx new file mode 100644 index 0000000..ef1a3ec --- /dev/null +++ b/FantasyNetTest/Form1.resx @@ -0,0 +1,126 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + text/microsoft-resx + + + 2.0 + + + System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 + + + System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 + + + 17, 17 + + + 109, 17 + + \ No newline at end of file diff --git a/FantasyNetTest/Loader/ScriptLoader.cs b/FantasyNetTest/Loader/ScriptLoader.cs new file mode 100644 index 0000000..9b77cc8 --- /dev/null +++ b/FantasyNetTest/Loader/ScriptLoader.cs @@ -0,0 +1,67 @@ +using System; +using System.Collections.Generic; +using System.IO; +using System.Linq; +using System.Reflection; +using System.Runtime.Loader; +using System.Threading.Tasks; +using FantasyNetTest; +using Microsoft.CodeAnalysis; +using Microsoft.CodeAnalysis.CSharp; +using Microsoft.CodeAnalysis.CSharp.Scripting; +using Microsoft.CodeAnalysis.Scripting; +using NBC; + +public class ScriptLoader +{ + public void LoadAndExecuteScriptsAsync(string folderPath) + { + // 1. 读取所有 .cs 文件 + var csFiles = Directory.GetFiles(folderPath, "*.cs", SearchOption.AllDirectories); + + if (!csFiles.Any()) + { + Console.WriteLine("没有找到 .cs 文件"); + return; + } + + // 2. 创建语法树 + var syntaxTrees = csFiles.Select(file => + CSharpSyntaxTree.ParseText(File.ReadAllText(file)) + ); + + // 3. 引用程序集 + var references = AppDomain.CurrentDomain.GetAssemblies() + .Where(a => !a.IsDynamic && !string.IsNullOrWhiteSpace(a.Location)) + .Select(a => MetadataReference.CreateFromFile(a.Location)) + .Cast(); + + // 4. 编译成内存程序集 + var compilation = CSharpCompilation.Create( + assemblyName: "DynamicScripts", + syntaxTrees: syntaxTrees, + references: references, + options: new CSharpCompilationOptions(OutputKind.DynamicallyLinkedLibrary) + ); + + using var ms = new MemoryStream(); + var result = compilation.Emit(ms); + + if (!result.Success) + { + foreach (var diag in result.Diagnostics.Where(d => d.Severity == DiagnosticSeverity.Error)) + Console.WriteLine(diag.ToString()); + return; + } + + // 5. 加载程序集 + ms.Seek(0, SeekOrigin.Begin); + + var assembly = AssemblyLoadContext.Default.LoadFromStream(ms); + + // 6. 调用示例 + var type = assembly.GetType("MyNamespace.MyClass"); // 你的类名 + var method = type?.GetMethod("Run"); // 你的方法名 + method?.Invoke(null, null); // 假设是静态方法无参数 + } +} \ No newline at end of file diff --git a/FantasyNetTest/Log.cs b/FantasyNetTest/Log.cs new file mode 100644 index 0000000..21f1223 --- /dev/null +++ b/FantasyNetTest/Log.cs @@ -0,0 +1,157 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using System.Text; +using System.Text.Json; +using System.Threading.Tasks; + +namespace FantasyNetTest +{ + enum LogType + { + Info = 0, + Warn = 1, + Error = 2, + Success = 3, + } + + struct LogData + { + public LogType type; + public string Content; + + public LogData(LogType type, string content) + { + this.type = type; + this.Content = content; + } + } + + internal static class Log + { + private static readonly Queue _logDatas = new Queue(); + + private static RichTextBox? _logTextBox; + private static bool _init; + + public static void Init(RichTextBox? logTextBox) + { + _logTextBox = logTextBox; + _init = true; + } + + #region Input + + public static void Info(object obj, params object?[] args) + { + AddLog(LogType.Info, obj, args); + } + + public static void Warn(object obj, params object?[] args) + { + AddLog(LogType.Warn, obj, args); + } + + public static void Error(object obj, params object?[] args) + { + AddLog(LogType.Error, obj, args); + } + + public static void Succeed(object obj, params object?[] args) + { + AddLog(LogType.Success, obj, args); + } + + public static void AddLog(LogType type, object obj, params object?[] args) + { + if (!_init) return; + string content; + if (obj is string str) + { + content = str; + } + else + { + content = JsonSerializer.Serialize(obj); + } + + if (!string.IsNullOrEmpty(content)) + { + try + { + content = string.Format(content, args); + } + catch + { + // ignored + } + } + + _logDatas.Enqueue(new LogData { type = type, Content = content }); + } + + #endregion + + #region 显示相关 + + public static void Tick() + { + if (_logDatas.Count < 1) return; + + var count = _logDatas.Count; + + for (int i = 0; i < count; i++) + { + AppendLog(_logDatas.Dequeue()); + } + } + + private static void AppendLog(LogData logData) + { + if (logData.type == LogType.Error) + { + _logTextBox.AppendTextWithColor(logData.Content, Color.Crimson); + } + else if (logData.type == LogType.Warn) + { + _logTextBox.AppendTextWithColor(logData.Content, Color.Coral); + } + else if (logData.type == LogType.Success) + { + _logTextBox.AppendTextWithColor(logData.Content, Color.ForestGreen); + } + else + { + _logTextBox.AppendTextWithColor(logData.Content, Color.Black); + } + } + + + public static void Clear() + { + if (!_init || _logTextBox == null) return; + _logTextBox.Clear(); + _logTextBox.ScrollToCaret(); + _logTextBox.ResumeLayout(); + } + + private static void AppendTextWithColor(this RichTextBox? rtb, string text, Color color, bool addNewLine = true) + { + if (rtb == null) return; + + rtb.SuspendLayout(); + rtb.SelectionStart = rtb.TextLength; + rtb.SelectionLength = 0; + rtb.SelectionColor = color; + rtb.AppendText(addNewLine ? $"{text}{Environment.NewLine}" : text); + rtb.SelectionColor = rtb.ForeColor; + + rtb.ScrollToCaret(); + + rtb.ResumeLayout(); + } + + + #endregion + } +} \ No newline at end of file diff --git a/FantasyNetTest/LoginTask.cs b/FantasyNetTest/LoginTask.cs new file mode 100644 index 0000000..cedeb08 --- /dev/null +++ b/FantasyNetTest/LoginTask.cs @@ -0,0 +1,45 @@ +using NBC; +using NBC.Network; + +namespace FantasyNetTest; + +public class LoginTask +{ + public static async Task Login(Session session, string account, int type) + { + // // 发送登录的请求给服务器 + // var response = (A2C_LoginResponse)await session.Call(new C2A_LoginRequest() + // { + // Username = account, + // Password = account, + // LoginType = type + // }); + // + // if (response.ErrorCode != 0) + // { + // Log.Error($"登录发生错误{response.ErrorCode}"); + // return; + // } + // + // if (!session.Scene.GetComponent().Parse(response.ToKen, out var payload)) + // { + // return; + // } + // + // // 根据ToKen返回的Address登录到Gate服务器 + // session = SessionHelper.CreateSession(session.Scene, payload.Address, OnConnectComplete, OnConnectFail, + // OnConnectDisconnect); + // // 发送登录请求到Gate服务器 + // var loginResponse = (G2C_LoginResponse)await session.Call(new C2G_LoginRequest() + // { + // ToKen = response.ToKen + // }); + // if (loginResponse.ErrorCode != 0) + // { + // Log.Error($"登录发生错误{loginResponse.ErrorCode}"); + // return; + // } + // + // Log.Succeed($"登录到Gate服务器成功！ErrorCode:{loginResponse.ErrorCode}"); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC.zip b/FantasyNetTest/NBC.zip new file mode 100644 index 0000000000000000000000000000000000000000..786802e37364c4b652f60807cf899492a39447d2 GIT binary patch literal 342269 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

    asdn@#o3h1 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

    4kF*Zvpu3UCkd)J-F+Ve3c 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

      )V?;>5z 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

      U%e)~s7EVsA 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 v=4fLq%~W$jN}`#mHghK#~IZ_D!t;O + /// AssemblyInfo提供有关程序集和类型的信息 + /// + public sealed class AssemblyInfo + { + ///

      + /// 唯一标识 + /// + public readonly long AssemblyIdentity; + /// + /// 获取或设置与此程序集相关联的 实例。 + /// + public System.Reflection.Assembly Assembly { get; private set; } + /// + /// 程序集类型集合，获取一个列表，包含从程序集加载的所有类型。 + /// + public readonly List AssemblyTypeList = new List(); + /// + /// 程序集类型分组集合，获取一个分组列表，将接口类型映射到实现这些接口的类型。 + /// + public readonly OneToManyList AssemblyTypeGroupList = new OneToManyList(); + + /// + /// 初始化 类的新实例。 + /// + /// + public AssemblyInfo(long assemblyIdentity) + { + AssemblyIdentity = assemblyIdentity; + } + + /// + /// 从指定的程序集加载类型信息并进行分类。 + /// + /// 要加载信息的程序集。 + public void Load(System.Reflection.Assembly assembly) + { + Assembly = assembly; + var assemblyTypes = assembly.GetTypes().ToList(); + + foreach (var type in assemblyTypes) + { + if (type.IsAbstract || type.IsInterface) + { + continue; + } + + var interfaces = type.GetInterfaces(); + + foreach (var interfaceType in interfaces) + { + AssemblyTypeGroupList.Add(interfaceType, type); + } + } + + AssemblyTypeList.AddRange(assemblyTypes); + } + + /// + /// 重新加载程序集的类型信息。 + /// + /// + public void ReLoad(System.Reflection.Assembly assembly) + { + Unload(); + Load(assembly); + } + + /// + /// 卸载程序集的类型信息。 + /// + public void Unload() + { + AssemblyTypeList.Clear(); + AssemblyTypeGroupList.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Assembly/AssemblySystem.cs b/FantasyNetTest/NBC/Core/Assembly/AssemblySystem.cs new file mode 100644 index 0000000..25de737 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Assembly/AssemblySystem.cs @@ -0,0 +1,286 @@ +using System; +using System.Collections.Concurrent; +using System.Collections.Generic; +using System.Linq; +using System.Reflection; +using System.Security.Cryptography; +using System.Text; +using NBC.Async; +using NBC.Helper; + +#pragma warning disable CS8604 // Possible null reference argument. +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8603 +#pragma warning disable CS8618 +namespace NBC.Assembly +{ + /// + /// 管理程序集加载和卸载的帮助类。 + /// + public static class AssemblySystem + { +#if FANTASY_WEBGL + private static readonly List AssemblySystems = new List(); + private static readonly Dictionary AssemblyList = new Dictionary(); +#else + private static readonly ConcurrentQueue AssemblySystems = new ConcurrentQueue(); + private static readonly ConcurrentDictionary AssemblyList = new ConcurrentDictionary(); +#endif + /// + /// 初始化 AssemblySystem。（仅限内部） + /// + /// + internal static async FTask InnerInitialize(params System.Reflection.Assembly[] assemblies) + { + await LoadAssembly(typeof(AssemblySystem).Assembly); + foreach (var assembly in assemblies) + { + await LoadAssembly(assembly); + } + } + + /// + /// 加载指定的程序集，并触发相应的事件。 + /// + /// 要加载的程序集。 + /// 如果当前Domain中已经存在同名的Assembly,使用Domain中的程序集。 + public static async FTask LoadAssembly(System.Reflection.Assembly assembly, bool isCurrentDomain = true) + { + if (isCurrentDomain) + { + var currentDomainAssemblies = System.AppDomain.CurrentDomain.GetAssemblies(); + var currentAssembly = currentDomainAssemblies.FirstOrDefault(d => d.GetName().Name == assembly.GetName().Name); + if (currentAssembly != null) + { + assembly = currentAssembly; + } + } + + var assemblyIdentity = AssemblyIdentity(assembly); + + if (AssemblyList.TryGetValue(assemblyIdentity, out var assemblyInfo)) + { + assemblyInfo.ReLoad(assembly); + foreach (var assemblySystem in AssemblySystems) + { + await assemblySystem.ReLoad(assemblyIdentity); + } + } + else + { + assemblyInfo = new AssemblyInfo(assemblyIdentity); + assemblyInfo.Load(assembly); + AssemblyList.TryAdd(assemblyIdentity, assemblyInfo); + foreach (var assemblySystem in AssemblySystems) + { + await assemblySystem.Load(assemblyIdentity); + } + } + } + + /// + /// 卸载程序集 + /// + /// + public static async FTask UnLoadAssembly(System.Reflection.Assembly assembly) + { + var assemblyIdentity = AssemblyIdentity(assembly); + + if (!AssemblyList.Remove(assemblyIdentity, out var assemblyInfo)) + { + return; + } + + assemblyInfo.Unload(); + foreach (var assemblySystem in AssemblySystems) + { + await assemblySystem.OnUnLoad(assemblyIdentity); + } + } + + /// + /// 将AssemblySystem接口的object注册到程序集管理中心 + /// + /// + public static async FTask Register(object obj) + { + if (obj is not IAssembly assemblySystem) + { + return; + } +#if FANTASY_WEBGL + AssemblySystems.Add(assemblySystem); +#else + AssemblySystems.Enqueue(assemblySystem); +#endif + foreach (var (assemblyIdentity, _) in AssemblyList) + { + await assemblySystem.Load(assemblyIdentity); + } + } + + /// + /// 程序集管理中心卸载注册的Load、ReLoad、UnLoad的接口 + /// + /// + public static void UnRegister(object obj) + { + if (obj is not IAssembly assemblySystem) + { + return; + } +#if FANTASY_WEBGL + AssemblySystems.Remove(assemblySystem); +#else + var count = AssemblySystems.Count; + + for (var i = 0; i < count; i++) + { + if (!AssemblySystems.TryDequeue(out var removeAssemblySystem)) + { + continue; + } + + if (removeAssemblySystem == assemblySystem) + { + break; + } + + AssemblySystems.Enqueue(removeAssemblySystem); + } +#endif + } + + /// + /// 获取所有已加载程序集中的所有类型。 + /// + /// 所有已加载程序集中的类型。 + public static IEnumerable ForEach() + { + foreach (var (_, assemblyInfo) in AssemblyList) + { + foreach (var type in assemblyInfo.AssemblyTypeList) + { + yield return type; + } + } + } + + /// + /// 获取指定程序集中的所有类型。 + /// + /// 程序集唯一标识。 + /// 指定程序集中的类型。 + public static IEnumerable ForEach(long assemblyIdentity) + { + if (!AssemblyList.TryGetValue(assemblyIdentity, out var assemblyInfo)) + { + yield break; + } + + foreach (var type in assemblyInfo.AssemblyTypeList) + { + yield return type; + } + } + + /// + /// 获取所有已加载程序集中实现指定类型的所有类型。 + /// + /// 要查找的基类或接口类型。 + /// 所有已加载程序集中实现指定类型的类型。 + public static IEnumerable ForEach(Type findType) + { + foreach (var (_, assemblyInfo) in AssemblyList) + { + if (!assemblyInfo.AssemblyTypeGroupList.TryGetValue(findType, out var assemblyLoad)) + { + continue; + } + + foreach (var type in assemblyLoad) + { + yield return type; + } + } + } + + /// + /// 获取指定程序集中实现指定类型的所有类型。 + /// + /// 程序集唯一标识。 + /// 要查找的基类或接口类型。 + /// 指定程序集中实现指定类型的类型。 + public static IEnumerable ForEach(long assemblyIdentity, Type findType) + { + if (!AssemblyList.TryGetValue(assemblyIdentity, out var assemblyInfo)) + { + yield break; + } + + if (!assemblyInfo.AssemblyTypeGroupList.TryGetValue(findType, out var assemblyLoad)) + { + yield break; + } + + foreach (var type in assemblyLoad) + { + yield return type; + } + } + + /// + /// 获取指定程序集的实例。 + /// + /// 程序集名称。 + /// 指定程序集的实例，如果未加载则返回 null。 + public static System.Reflection.Assembly GetAssembly(long assemblyIdentity) + { + return !AssemblyList.TryGetValue(assemblyIdentity, out var assemblyInfo) ? null : assemblyInfo.Assembly; + } + + /// + /// 获取当前框架注册的Assembly + /// + /// + public static IEnumerable ForEachAssembly + { + get + { + foreach (var (_, assemblyInfo) in AssemblyList) + { + yield return assemblyInfo.Assembly; + } + } + } + + /// + /// 根据Assembly的强命名计算唯一标识。 + /// + /// + /// + private static long AssemblyIdentity(System.Reflection.Assembly assembly) + { + return HashCodeHelper.ComputeHash64(assembly.GetName().Name); + } + + /// + /// 释放资源，卸载所有加载的程序集。 + /// + public static void Dispose() + { + DisposeAsync().Coroutine(); + } + + private static async FTask DisposeAsync() + { + foreach (var (_, assemblyInfo) in AssemblyList.ToArray()) + { + await UnLoadAssembly(assemblyInfo.Assembly); + } + + AssemblyList.Clear(); + AssemblySystems.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Assembly/IAssembly.cs b/FantasyNetTest/NBC/Core/Assembly/IAssembly.cs new file mode 100644 index 0000000..f86c9f1 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Assembly/IAssembly.cs @@ -0,0 +1,27 @@ +using System; +using NBC.Async; + +namespace NBC.Assembly +{ + /// + /// 实现这个接口、会再程序集首次加载、卸载、重载的时候调用 + /// + public interface IAssembly : IDisposable + { + /// + /// 程序集加载时调用 + /// + /// 程序集标识 + public FTask Load(long assemblyIdentity); + /// + /// 程序集重新加载的时候调用 + /// + /// 程序集标识 + public FTask ReLoad(long assemblyIdentity); + /// + /// 卸载的时候调用 + /// + /// 程序集标识 + public FTask OnUnLoad(long assemblyIdentity); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Attributes/Attributes.cs b/FantasyNetTest/NBC/Core/Attributes/Attributes.cs new file mode 100644 index 0000000..1c95110 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Attributes/Attributes.cs @@ -0,0 +1,20 @@ +using System; + +namespace NBC +{ + [AttributeUsage(AttributeTargets.Class)] + public class BaseAttribute : Attribute + { + } + + [AttributeUsage(AttributeTargets.Class | AttributeTargets.Field | AttributeTargets.Method)] + public class SortAttribute : Attribute + { + public int Sort; + + public SortAttribute(int sort) + { + Sort = sort; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/CircularBuffer.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/CircularBuffer.cs new file mode 100644 index 0000000..d7a68c0 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/CircularBuffer.cs @@ -0,0 +1,346 @@ +using System; +using System.Collections.Generic; +using System.IO; +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. + +namespace NBC.DataStructure.Collection +{ + /// 环形缓存（自增式缓存，自动扩充、不会收缩缓存、所以不要用这个操作过大的IO流） + /// 1、环大小8192，溢出的会自动增加环的大小。 + /// 2、每个块都是一个环形缓存，当溢出的时候会自动添加到下一个环中。 + /// 3、当读取完成后用过的环会放在缓存中，不会销毁掉。 + /// + /// 自增式缓存类，继承自 Stream 和 IDisposable 接口。 + /// 环形缓存具有自动扩充的特性，但不会收缩，适用于操作不过大的 IO 流。 + /// + public sealed class CircularBuffer : Stream, IDisposable + { + private byte[] _lastBuffer; + /// + /// 环形缓存块的默认大小 + /// + public const int ChunkSize = 8192; + private readonly Queue _bufferCache = new Queue(); + private readonly Queue _bufferQueue = new Queue(); + /// + /// 获取或设置环形缓存的第一个索引位置 + /// + public int FirstIndex { get; set; } + /// + /// 获取或设置环形缓存的最后一个索引位置 + /// + public int LastIndex { get; set; } + /// + /// 获取环形缓存的总长度 + /// + public override long Length + { + get + { + if (_bufferQueue.Count == 0) + { + return 0; + } + + return (_bufferQueue.Count - 1) * ChunkSize + LastIndex - FirstIndex; + } + } + + /// + /// 获取环形缓存的第一个块 + /// + public byte[] First + { + get + { + if (_bufferQueue.Count == 0) + { + AddLast(); + } + + return _bufferQueue.Peek(); + } + } + + /// + /// 获取环形缓存的最后一个块 + /// + public byte[] Last + { + get + { + if (_bufferQueue.Count == 0) + { + AddLast(); + } + + return _lastBuffer; + } + } + /// + /// 向环形缓存中添加一个新的块 + /// + public void AddLast() + { + var buffer = _bufferCache.Count > 0 ? _bufferCache.Dequeue() : new byte[ChunkSize]; + _bufferQueue.Enqueue(buffer); + _lastBuffer = buffer; + } + /// + /// 从环形缓存中移除第一个块 + /// + public void RemoveFirst() + { + _bufferCache.Enqueue(_bufferQueue.Dequeue()); + } + + /// + /// 从流中读取指定数量的数据到缓存。 + /// + /// 源数据流。 + /// 要读取的字节数。 + public void Read(Stream stream, int count) + { + if (count > Length) + { + throw new Exception($"bufferList length < count, {Length} {count}"); + } + + var copyCount = 0; + while (copyCount < count) + { + var n = count - copyCount; + if (ChunkSize - FirstIndex > n) + { + stream.Write(First, FirstIndex, n); + FirstIndex += n; + copyCount += n; + } + else + { + stream.Write(First, FirstIndex, ChunkSize - FirstIndex); + copyCount += ChunkSize - FirstIndex; + FirstIndex = 0; + RemoveFirst(); + } + } + } + + /// + /// 从缓存中读取指定数量的数据到内存。 + /// + /// 目标内存。 + /// 要读取的字节数。 + public void Read(Memory memory, int count) + { + if (count > Length) + { + throw new Exception($"bufferList length < count, {Length} {count}"); + } + + var copyCount = 0; + while (copyCount < count) + { + var n = count - copyCount; + var asMemory = First.AsMemory(); + + if (ChunkSize - FirstIndex > n) + { + var slice = asMemory.Slice(FirstIndex, n); + slice.CopyTo(memory.Slice(copyCount, n)); + FirstIndex += n; + copyCount += n; + } + else + { + var length = ChunkSize - FirstIndex; + var slice = asMemory.Slice(FirstIndex, length); + slice.CopyTo(memory.Slice(copyCount, length)); + copyCount += ChunkSize - FirstIndex; + FirstIndex = 0; + RemoveFirst(); + } + } + } + + /// + /// 从自定义流中读取数据到指定的缓冲区。 + /// + /// 目标缓冲区，用于存储读取的数据。 + /// 目标缓冲区中的起始偏移量。 + /// 要读取的字节数。 + /// 实际读取的字节数。 + public override int Read(byte[] buffer, int offset, int count) + { + if (buffer.Length < offset + count) + { + throw new Exception($"buffer length < count, buffer length: {buffer.Length} {offset} {count}"); + } + + var length = Length; + if (length < count) + { + count = (int) length; + } + + var copyCount = 0; + + // 循环直到成功读取所需的字节数 + while (copyCount < count) + { + var copyLength = count - copyCount; + + if (ChunkSize - FirstIndex > copyLength) + { + // 将数据从当前块的缓冲区复制到目标缓冲区 + Array.Copy(First, FirstIndex, buffer, copyCount + offset, copyLength); + + FirstIndex += copyLength; + copyCount += copyLength; + continue; + } + + // 复制当前块中剩余的数据，并切换到下一个块 + Array.Copy(First, FirstIndex, buffer, copyCount + offset, ChunkSize - FirstIndex); + copyCount += ChunkSize - FirstIndex; + FirstIndex = 0; + + RemoveFirst(); + } + + return count; + } + + /// + /// 将数据从给定的字节数组写入流中。 + /// + /// 包含要写入的数据的字节数组。 + public void Write(byte[] buffer) + { + Write(buffer, 0, buffer.Length); + } + + /// + /// 将数据从给定的流写入流中。 + /// + /// 包含要写入的数据的流。 + public void Write(Stream stream) + { + var copyCount = 0; + var count = (int) (stream.Length - stream.Position); + + while (copyCount < count) + { + if (LastIndex == ChunkSize) + { + AddLast(); + LastIndex = 0; + } + + var n = count - copyCount; + + if (ChunkSize - LastIndex > n) + { + _ = stream.Read(Last, LastIndex, n); + LastIndex += count - copyCount; + copyCount += n; + } + else + { + _ = stream.Read(Last, LastIndex, ChunkSize - LastIndex); + copyCount += ChunkSize - LastIndex; + LastIndex = ChunkSize; + } + } + } + + /// + /// 将数据从给定的字节数组写入流中。 + /// + /// 包含要写入的数据的字节数组。 + /// 开始写入的缓冲区中的索引。 + /// 要写入的字节数。 + public override void Write(byte[] buffer, int offset, int count) + { + var copyCount = 0; + + while (copyCount < count) + { + if (ChunkSize == LastIndex) + { + AddLast(); + LastIndex = 0; + } + + var byteLength = count - copyCount; + + if (ChunkSize - LastIndex > byteLength) + { + Array.Copy(buffer, copyCount + offset, Last, LastIndex, byteLength); + LastIndex += byteLength; + copyCount += byteLength; + } + else + { + Array.Copy(buffer, copyCount + offset, Last, LastIndex, ChunkSize - LastIndex); + copyCount += ChunkSize - LastIndex; + LastIndex = ChunkSize; + } + } + } + + /// + /// 获取一个值，指示流是否支持读取操作。 + /// + public override bool CanRead { get; } = true; + /// + /// 获取一个值，指示流是否支持寻找操作。 + /// + public override bool CanSeek { get; } = false; + /// + /// 获取一个值，指示流是否支持写入操作。 + /// + public override bool CanWrite { get; } = true; + /// + /// 获取或设置流中的位置。 + /// + public override long Position { get; set; } + + /// + /// 刷新流（在此实现中引发未实现异常）。 + /// + public override void Flush() + { + throw new NotImplementedException(); + } + + /// + /// 在流中寻找特定位置（在此实现中引发未实现异常）。 + /// + public override long Seek(long offset, SeekOrigin origin) + { + throw new NotImplementedException(); + } + + /// + /// 设置流的长度（在此实现中引发未实现异常）。 + /// + public override void SetLength(long value) + { + throw new NotImplementedException(); + } + + /// + /// 释放 CustomStream 使用的所有资源。 + /// + public new void Dispose() + { + _bufferQueue.Clear(); + _lastBuffer = null; + FirstIndex = 0; + LastIndex = 0; + base.Dispose(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/ConcurrentOneToManyListPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/ConcurrentOneToManyListPool.cs new file mode 100644 index 0000000..d8a5e94 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/ConcurrentOneToManyListPool.cs @@ -0,0 +1,197 @@ +#if !FANTASY_WEBGL +using System; +using System.Collections.Concurrent; +using System.Collections.Generic; +using System.Linq; +using NBC.Pool; + +#pragma warning disable CS8603 // Possible null reference return. + +namespace NBC.DataStructure.Collection +{ + /// + /// 并发的一对多列表池，用于维护具有相同键的多个值的关联关系，实现了 接口。 + /// + /// 关键字的类型，不能为空。 + /// 值的类型。 + public class ConcurrentOneToManyListPool : ConcurrentOneToManyList, IDisposable, IPool where TKey : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个 的实例。 + /// + /// 创建的实例。 + public static ConcurrentOneToManyListPool Create() + { + var a = MultiThreadPool.Rent>(); + a._isDispose = false; + a._isPool = true; + return a; + } + + /// + /// 释放实例占用的资源。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + // 清空实例的数据 + Clear(); + // 将实例返回到池中以便重用 + MultiThreadPool.Return(this); + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 并发的一对多列表，用于维护具有相同键的多个值的关联关系。 + /// + /// 关键字的类型，不能为空。 + /// 值的类型。 + public class ConcurrentOneToManyList : ConcurrentDictionary> where TKey : notnull + { + private readonly Queue> _queue = new Queue>(); + private readonly int _recyclingLimit = 120; + + /// + /// 初始化 类的新实例。 + /// + public ConcurrentOneToManyList() + { + } + + /// + /// 设置最大缓存数量 + /// + /// + /// 1:防止数据量过大、所以超过recyclingLimit的数据还是走GC. + /// 2:设置成0不控制数量，全部缓存 + /// + public ConcurrentOneToManyList(int recyclingLimit) + { + _recyclingLimit = recyclingLimit; + } + + /// + /// 判断指定键的列表是否包含指定值。 + /// + /// 要搜索的键。 + /// 要搜索的值。 + /// 如果列表包含值，则为 true；否则为 false。 + public bool Contains(TKey key, TValue value) + { + TryGetValue(key, out var list); + + return list != null && list.Contains(value); + } + + /// + /// 向指定键的列表中添加一个值。 + /// + /// 要添加值的键。 + /// 要添加的值。 + public void Add(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) + { + list = Fetch(); + list.Add(value); + base[key] = list; + return; + } + + list.Add(value); + } + + /// + /// 获取指定键的列表中的第一个值。 + /// + /// 要获取第一个值的键。 + /// 指定键的列表中的第一个值，如果不存在则为默认值。 + public TValue First(TKey key) + { + return !TryGetValue(key, out var list) ? default : list.FirstOrDefault(); + } + + /// + /// 从指定键的列表中移除一个值。 + /// + /// 要移除值的键。 + /// 要移除的值。 + public void RemoveValue(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) return; + + list.Remove(value); + + if (list.Count == 0) RemoveKey(key); + } + + /// + /// 从字典中移除指定键以及其关联的列表。 + /// + /// 要移除的键。 + public void RemoveKey(TKey key) + { + if (!TryRemove(key, out var list)) return; + + Recycle(list); + } + + /// + /// 从队列中获取一个列表，如果队列为空则创建一个新的列表。 + /// + /// 获取的列表。 + private List Fetch() + { + return _queue.Count <= 0 ? new List() : _queue.Dequeue(); + } + + /// + /// 将一个列表回收到队列中。 + /// + /// 要回收的列表。 + private void Recycle(List list) + { + list.Clear(); + + if (_recyclingLimit != 0 && _queue.Count > _recyclingLimit) return; + + _queue.Enqueue(list); + } + + /// + /// 清空当前类的数据，包括从基类继承的数据以及自定义的数据队列。 + /// + protected new void Clear() + { + base.Clear(); + _queue.Clear(); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/ConcurrentOneToManyQueuePool.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/ConcurrentOneToManyQueuePool.cs new file mode 100644 index 0000000..e6ee79f --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/ConcurrentOneToManyQueuePool.cs @@ -0,0 +1,194 @@ +#if !FANTASY_WEBGL +using System; +using System.Collections.Concurrent; +using System.Collections.Generic; +using NBC.Pool; + +#pragma warning disable CS8603 + +namespace NBC.DataStructure.Collection +{ + /// + /// 表示一个并发的一对多队列池，用于维护具有相同键的多个值的关联关系，实现了 接口。 + /// + /// 关键字的类型，不能为空。 + /// 值的类型。 + public class ConcurrentOneToManyQueuePool : ConcurrentOneToManyQueue, IDisposable, IPool where TKey : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建并返回一个 的实例。 + /// + /// 创建的实例。 + public static ConcurrentOneToManyQueuePool Create() + { + var a = MultiThreadPool.Rent>(); + a._isDispose = false; + a._isPool = true; + return a; + } + + /// + /// 释放当前实例所占用的资源，并将实例返回到对象池中，以便重用。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); + // 将实例返回到对象池中，以便重用 + MultiThreadPool.Return(this); + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 表示一个并发的一对多队列，用于维护具有相同键的多个值的关联关系。 + /// + /// 关键字的类型，不能为空。 + /// 值的类型。 + public class ConcurrentOneToManyQueue : ConcurrentDictionary> where TKey : notnull + { + private readonly Queue> _queue = new Queue>(); + private readonly int _recyclingLimit; + + /// + /// 设置最大缓存数量 + /// + /// + /// 1:防止数据量过大、所以超过recyclingLimit的数据还是走GC. + /// 2:设置成0不控制数量，全部缓存 + /// + public ConcurrentOneToManyQueue(int recyclingLimit = 0) + { + _recyclingLimit = recyclingLimit; + } + + /// + /// 判断指定键的队列是否包含指定值。 + /// + /// 要搜索的键。 + /// 要搜索的值。 + /// 如果队列包含值，则为 true；否则为 false。 + public bool Contains(TKey key, TValue value) + { + TryGetValue(key, out var list); + + return list != null && list.Contains(value); + } + + /// + /// 向指定键的队列中添加一个值。 + /// + /// 要添加值的键。 + /// 要添加的值。 + public void Enqueue(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) + { + list = Fetch(); + list.Enqueue(value); + TryAdd(key, list); + return; + } + + list.Enqueue(value); + } + + /// + /// 从指定键的队列中出队并返回一个值。 + /// + /// 要出队的键。 + /// 出队的值，如果队列为空则为默认值。 + public TValue Dequeue(TKey key) + { + if (!TryGetValue(key, out var list) || list.Count == 0) return default; + + var value = list.Dequeue(); + + if (list.Count == 0) RemoveKey(key); + + return value; + } + + /// + /// 尝试从指定键的队列中出队一个值。 + /// + /// 要出队的键。 + /// 出队的值，如果队列为空则为默认值。 + /// 如果成功出队，则为 true；否则为 false。 + public bool TryDequeue(TKey key, out TValue value) + { + value = Dequeue(key); + + return value != null; + } + + /// + /// 从字典中移除指定键以及其关联的队列。 + /// + /// 要移除的键。 + public void RemoveKey(TKey key) + { + if (!TryGetValue(key, out var list)) return; + + TryRemove(key, out _); + Recycle(list); + } + + /// + /// 从队列中获取一个新的队列，如果队列为空则创建一个新的队列。 + /// + /// 获取的队列。 + private Queue Fetch() + { + return _queue.Count <= 0 ? new Queue() : _queue.Dequeue(); + } + + /// + /// 将一个队列回收到队列池中。 + /// + /// 要回收的队列。 + private void Recycle(Queue list) + { + list.Clear(); + + if (_recyclingLimit != 0 && _queue.Count > _recyclingLimit) return; + + _queue.Enqueue(list); + } + + /// + /// 清空当前类的数据，包括从基类继承的键值对字典中的数据以及自定义的队列池。 + /// + protected new void Clear() + { + base.Clear(); + _queue.Clear(); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/HashSetPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/HashSetPool.cs new file mode 100644 index 0000000..5e46af0 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/HashSetPool.cs @@ -0,0 +1,134 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +namespace NBC.DataStructure.Collection +{ + /// + /// 可释放的哈希集合对象池。 + /// + /// 哈希集合中元素的类型。 + public sealed class HashSetPool : HashSet, IDisposable, IPool + { + private bool _isPool; + private bool _isDispose; + + /// + /// 释放实例所占用的资源，并将实例返回到对象池中，以便重用。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 创建一个 哈希集合池的实例。 + /// + /// 创建的实例。 + public static HashSetPool Create() + { +#if FANTASY_WEBGL + var list = Pool>.Rent(); + list._isDispose = false; + list._isPool = true; + return list; +#else + var list = MultiThreadPool.Rent>(); + list._isDispose = false; + list._isPool = true; + return list; +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 基本哈希集合对象池，他自持有实际的哈希集合。 + /// + /// 哈希集合中元素的类型。 + public sealed class HashSetBasePool : IDisposable, IPool + { + private bool _isPool; + + /// + /// 存储实际的哈希集合 + /// + public HashSet Set = new HashSet(); + + /// + /// 创建一个 基本哈希集合对象池的实例。 + /// + /// 创建的实例。 + public static HashSetBasePool Create() + { +#if FANTASY_WEBGL + var hashSetBasePool = Pool>.Rent(); + hashSetBasePool._isPool = true; + return hashSetBasePool; +#else + var hashSetBasePool = MultiThreadPool.Rent>(); + hashSetBasePool._isPool = true; + return hashSetBasePool; +#endif + } + + /// + /// 释放实例所占用的资源，并将实例返回到对象池中，以便重用。 + /// + public void Dispose() + { + Set.Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + throw new NotImplementedException(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/ListPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/ListPool.cs new file mode 100644 index 0000000..13c272f --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/ListPool.cs @@ -0,0 +1,101 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract + +namespace NBC.DataStructure.Collection +{ + /// + /// 可释放的列表（List）对象池。 + /// + /// 列表中元素的类型。 + public sealed class ListPool : List, IDisposable, IPool + { + private bool _isPool; + private bool _isDispose; + + /// + /// 释放实例所占用的资源，并将实例返回到对象池中，以便重用。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 使用指定的元素创建一个 列表（List）对象池的实例。 + /// + /// 要添加到列表的元素。 + /// 创建的实例。 + public static ListPool Create(params T[] args) + { +#if FANTASY_WEBGL + var list = Pool>.Rent(); +#else + var list = MultiThreadPool.Rent>(); +#endif + list._isDispose = false; + list._isPool = true; + + if (args != null) + { + list.AddRange(args); + } + + return list; + } + + /// + /// 使用指定的列表创建一个 列表（List）对象池的实例。 + /// + /// 要添加到列表的元素列表。 + /// 创建的实例。 + public static ListPool Create(List args) + { +#if FANTASY_WEBGL + var list = Pool>.Rent(); +#else + var list = MultiThreadPool.Rent>(); +#endif + list._isDispose = false; + list._isPool = true; + + if (args != null) + { + list.AddRange(args); + } + + return list; + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyHashSetPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyHashSetPool.cs new file mode 100644 index 0000000..e0a223d --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyHashSetPool.cs @@ -0,0 +1,208 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. + +namespace NBC.DataStructure.Collection +{ + /// + /// 一对多哈希集合（OneToManyHashSet）对象池。 + /// + /// 键的类型。 + /// 值的类型。 + public class OneToManyHashSetPool : OneToManyHashSet, IDisposable, IPool where TKey : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个 一对多哈希集合（OneToManyHashSet）对象池的实例。 + /// + /// 创建的实例。 + public static OneToManyHashSetPool Create() + { +#if FANTASY_WEBGL + var a = Pool>.Rent(); +#else + var a = MultiThreadPool.Rent>(); +#endif + a._isDispose = false; + a._isPool = true; + return a; + } + + /// + /// 释放实例所占用的资源，并将实例返回到对象池中，以便重用。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 一对多哈希集合（OneToManyHashSet），用于创建和管理键对应多个值的集合。 + /// + /// 键的类型。 + /// 值的类型。 + public class OneToManyHashSet : Dictionary> where TKey : notnull + { + /// 用于回收和重用的空闲值集合队列。 + private readonly Queue> _queue = new Queue>(); + /// 设置最大回收限制，用于控制值集合的最大数量。 + private readonly int _recyclingLimit = 120; + /// 一个空的、不包含任何元素的哈希集合，用于在查找失败时返回。 + private static HashSet _empty = new HashSet(); + + /// + /// 初始化 类的新实例。 + /// + public OneToManyHashSet() { } + + /// + /// 设置最大缓存数量 + /// + /// + /// 1:防止数据量过大、所以超过recyclingLimit的数据还是走GC. + /// 2:设置成0不控制数量，全部缓存 + /// + public OneToManyHashSet(int recyclingLimit) + { + _recyclingLimit = recyclingLimit; + } + + /// + /// 判断指定的键值对是否存在于集合中。 + /// + /// 键。 + /// 值。 + /// 如果存在则为 true，否则为 false。 + public bool Contains(TKey key, TValue value) + { + TryGetValue(key, out var list); + + return list != null && list.Contains(value); + } + + /// + /// 添加指定的键值对到集合中。 + /// + /// 键。 + /// 值。 + public void Add(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) + { + list = Fetch(); + list.Add(value); + Add(key, list); + + return; + } + + list.Add(value); + } + + /// + /// 从集合中移除指定键对应的值。 + /// + /// 键。 + /// 要移除的值。 + public void RemoveValue(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) return; + + list.Remove(value); + + if (list.Count == 0) RemoveKey(key); + } + + /// + /// 从集合中移除指定键及其对应的值集合。 + /// + /// 键。 + public void RemoveKey(TKey key) + { + if (!TryGetValue(key, out var list)) return; + + Remove(key); + Recycle(list); + } + + /// + /// 获取指定键对应的值集合，如果不存在则返回一个空的哈希集合。 + /// + /// 键。 + /// 对应的值集合或空的哈希集合。 + public HashSet GetValue(TKey key) + { + if (TryGetValue(key, out HashSet value)) + { + return value; + } + + return _empty; + } + + /// + /// 从队列中获取一个空闲的值集合，或者创建一个新的。 + /// + /// 值集合。 + private HashSet Fetch() + { + return _queue.Count <= 0 ? new HashSet() : _queue.Dequeue(); + } + + /// + /// 回收值集合到队列中，以便重复利用。 + /// + /// 要回收的值集合。 + private void Recycle(HashSet list) + { + list.Clear(); + + if (_recyclingLimit != 0 && _queue.Count > _recyclingLimit) return; + + _queue.Enqueue(list); + } + + /// + /// 清空集合中的数据并和队列。 + /// + protected new void Clear() + { + base.Clear(); + _queue.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyListPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyListPool.cs new file mode 100644 index 0000000..1f7d469 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyListPool.cs @@ -0,0 +1,253 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using System.Reflection; +using NBC.Pool; + +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8603 // Possible null reference return. + +namespace NBC.DataStructure.Collection +{ + /// + /// 可回收的、一对多关系的列表池。 + /// + /// 键的类型。 + /// 值的类型。 + public class OneToManyListPool : OneToManyList, IDisposable, IPool where TKey : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个 一对多关系的列表池的实例。 + /// + /// 创建的实例。 + public static OneToManyListPool Create() + { +#if FANTASY_WEBGL || FANTASY_EXPORTER + var list = Pool>.Rent(); +#else + var list = MultiThreadPool.Rent>(); +#endif + list._isDispose = false; + list._isPool = true; + return list; + } + + /// + /// 释放当前对象所占用的资源，并将对象回收到对象池中。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL || FANTASY_EXPORTER + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 一对多关系的列表字典。 + /// + /// 键的类型。 + /// 值的类型。 + public class OneToManyList : Dictionary> where TKey : notnull + { + private readonly int _recyclingLimit = 120; + private static readonly List Empty = new List(); + private readonly Queue> _queue = new Queue>(); + + /// + /// 初始化一个新的 实例。 + /// + public OneToManyList() { } + + /// + /// 对整个字典的所有 List 进行排序 + /// + public void SortAll() + { + foreach (var key in Keys.ToList()) // 使用 ToList() 避免修改集合异常 + { + this[key] = this[key].OrderByDescending(GetSortValue).ToList(); + } + } + + // 获取对象的排序值（SortAttribute 的值，默认 0） + private int GetSortValue(TValue obj) + { + if (obj == null) return 0; + + var sortAttr = obj.GetType().GetCustomAttribute(); + return sortAttr?.Sort ?? 0; + } + + /// + /// 设置最大缓存数量 + /// + /// + /// 1:防止数据量过大、所以超过recyclingLimit的数据还是走GC. + /// 2:设置成0不控制数量，全部缓存 + /// + public OneToManyList(int recyclingLimit) + { + _recyclingLimit = recyclingLimit; + } + + /// + /// 判断给定的键和值是否存在于列表中。 + /// + /// 要搜索的键。 + /// 要搜索的值。 + /// 如果存在则为 ，否则为 。 + public bool Contains(TKey key, TValue value) + { + TryGetValue(key, out var list); + + return list != null && list.Contains(value); + } + + /// + /// 向列表中添加指定键和值。 + /// + /// 要添加值的键。 + /// 要添加的值。 + public void Add(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) + { + list = Fetch(); + list.Add(value); + Add(key, list); + + return; + } + + list.Add(value); + } + + /// + /// 获取指定键对应的列表中的第一个值。 + /// + /// 要获取值的键。 + /// 键对应的列表中的第一个值。 + public TValue First(TKey key) + { + return !TryGetValue(key, out var list) ? default : list.FirstOrDefault(); + } + + /// + /// 从列表中移除指定键和值。 + /// + /// 要移除值的键。 + /// 要移除的值。 + /// 如果成功移除则为 ，否则为 。 + public bool RemoveValue(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) + { + return true; + } + + var isRemove = list.Remove(value); + + if (list.Count == 0) + { + isRemove = RemoveByKey(key); + } + + return isRemove; + } + + /// + /// 从列表中移除指定键及其关联的所有值。 + /// + /// 要移除的键。 + /// 如果成功移除则为 ，否则为 。 + public bool RemoveByKey(TKey key) + { + if (!TryGetValue(key, out var list)) + { + return false; + } + + Remove(key); + Recycle(list); + return true; + } + + /// + /// 获取指定键关联的所有值的列表。 + /// + /// 要获取值的键。 + /// 键关联的所有值的列表。 + public List GetValues(TKey key) + { + if (TryGetValue(key, out List list)) + { + return list; + } + + return Empty; + } + + /// + /// 清除字典中的所有键值对，并回收相关的值集合。 + /// + public new void Clear() + { + foreach (var keyValuePair in this) Recycle(keyValuePair.Value); + + base.Clear(); + } + + /// + /// 从空闲值集合队列中获取一个值集合，如果队列为空则创建一个新的值集合。 + /// + /// 从队列中获取的值集合。 + private List Fetch() + { + return _queue.Count <= 0 ? new List() : _queue.Dequeue(); + } + + /// + /// 回收一个不再使用的值集合到空闲值集合队列中。 + /// + /// 要回收的值集合。 + private void Recycle(List list) + { + list.Clear(); + + if (_recyclingLimit != 0 && _queue.Count > _recyclingLimit) return; + + _queue.Enqueue(list); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyQueuePool.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyQueuePool.cs new file mode 100644 index 0000000..e787ba8 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/OneToManyQueuePool.cs @@ -0,0 +1,204 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +#pragma warning disable CS8603 + +namespace NBC.DataStructure.Collection +{ + /// + /// 支持一对多关系的队列池，用于存储具有相同键的值的队列集合。 + /// + /// 键的类型。 + /// 值的类型。 + public class OneToManyQueuePool : OneToManyQueue, IDisposable, IPool where TKey : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个 一对多关系的队列池的实例。 + /// + /// 创建的实例。 + public static OneToManyQueuePool Create() + { +#if FANTASY_WEBGL + var a = Pool>.Rent(); +#else + var a = MultiThreadPool.Rent>(); +#endif + a._isDispose = false; + a._isPool = true; + return a; + } + + /// + /// 释放当前实例所占用的资源，并将实例回收到对象池中。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 支持一对多关系的队列，用于存储具有相同键的值的队列集合。 + /// + /// 键的类型。 + /// 值的类型。 + public class OneToManyQueue : Dictionary> where TKey : notnull + { + private readonly Queue> _queue = new Queue>(); + private readonly int _recyclingLimit; + + /// + /// 创建一个 一对多关系的队列的实例。设置最大缓存数量 + /// + /// + /// 1:防止数据量过大、所以超过recyclingLimit的数据还是走GC. + /// 2:设置成0不控制数量，全部缓存 + /// + public OneToManyQueue(int recyclingLimit = 0) + { + _recyclingLimit = recyclingLimit; + } + + /// + /// 判断指定键的值队列是否包含指定的值。 + /// + /// 要查找的键。 + /// 要查找的值。 + /// 如果存在，则为 true；否则为 false。 + public bool Contains(TKey key, TValue value) + { + TryGetValue(key, out var list); + + return list != null && list.Contains(value); + } + + /// + /// 将指定的值添加到指定键的值队列中。 + /// + /// 要添加值的键。 + /// 要添加的值。 + public void Enqueue(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) + { + list = Fetch(); + list.Enqueue(value); + Add(key, list); + return; + } + + list.Enqueue(value); + } + + /// + /// 从指定键的值队列中出队一个值。 + /// + /// 要出队的键。 + /// 出队的值。 + public TValue Dequeue(TKey key) + { + if (!TryGetValue(key, out var list) || list.Count == 0) + { + return default; + } + + var value = list.Dequeue(); + + if (list.Count == 0) + { + RemoveKey(key); + } + + return value; + } + + /// + /// 尝试从指定键的值队列中出队一个值。 + /// + /// 要出队的键。 + /// 出队的值。 + /// 如果成功出队，则为 true；否则为 false。 + public bool TryDequeue(TKey key, out TValue value) + { + value = Dequeue(key); + + return value != null; + } + + /// + /// 从字典中移除指定键及其对应的值队列。 + /// + /// 要移除的键。 + public void RemoveKey(TKey key) + { + if (!TryGetValue(key, out var list)) return; + + Remove(key); + Recycle(list); + } + + /// + /// 从队列池中获取一个值队列。如果队列池为空，则创建一个新的值队列。 + /// + /// 获取的值队列。 + private Queue Fetch() + { + return _queue.Count <= 0 ? new Queue() : _queue.Dequeue(); + } + + /// + /// 回收一个不再使用的值队列到队列池中，以便重用。 + /// + /// 要回收的值队列。 + private void Recycle(Queue list) + { + list.Clear(); + + if (_recyclingLimit != 0 && _queue.Count > _recyclingLimit) return; + + _queue.Enqueue(list); + } + + /// + /// 清空当前实例的数据，同时回收所有值队列。 + /// + protected new void Clear() + { + base.Clear(); + _queue.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/ReuseList.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/ReuseList.cs new file mode 100644 index 0000000..50be9bc --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/ReuseList.cs @@ -0,0 +1,69 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +namespace NBC.DataStructure.Collection +{ + /// + /// 可重用的列表，继承自 类。该类支持通过对象池重用列表实例，以减少对象分配和释放的开销。 + /// + /// 列表中元素的类型。 + public sealed class ReuseList : List, IDisposable, IPool + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个 可重用的列表的实例。 + /// + /// 创建的实例。 + public static ReuseList Create() + { +#if FANTASY_WEBGL + var list = Pool>.Rent(); +#else + var list = MultiThreadPool.Rent>(); +#endif + list._isDispose = false; + list._isPool = true; + return list; + } + + /// + /// 释放该实例所占用的资源，并将实例返回到对象池中，以便重用。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/SortedConcurrentOneToManyListPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/SortedConcurrentOneToManyListPool.cs new file mode 100644 index 0000000..98198a9 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/SortedConcurrentOneToManyListPool.cs @@ -0,0 +1,226 @@ +#if !FANTASY_WEBGL +using System; +using System.Collections.Generic; +using System.Linq; +using NBC.Pool; + +#pragma warning disable CS8603 + +namespace NBC.DataStructure.Collection +{ + /// + /// 基于排序字典和并发集合实现的一对多映射列表的对象池包装类，继承自 类， + /// 同时实现了 接口，以支持对象的重用和释放。 + /// + /// 键的类型。 + /// 值的类型。 + public class SortedConcurrentOneToManyListPool : SortedConcurrentOneToManyList, IDisposable, IPool where TKey : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个新的 实例，使用默认的参数设置。 + /// + /// 新创建的 实例。 + public static SortedConcurrentOneToManyListPool Create() + { + var a = MultiThreadPool.Rent>(); + a._isDispose = false; + a._isPool = true; + return a; + } + + /// + /// 释放当前对象池实例，将其返回到对象池以供重用。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); + MultiThreadPool.Return(this); + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 基于排序字典和并发集合实现的一多对映射列表类，继承自 类， + /// 用于在多个值与一个键关联的情况下进行管理和存储。该类支持并发操作，适用于多线程环境。 + /// + /// 键的类型。 + /// 值的类型。 + public class SortedConcurrentOneToManyList : SortedDictionary> where TKey : notnull + { + /// 用于同步操作的锁对象，它确保在多线程环境下对数据的安全访问。 + private readonly object _lockObject = new object(); + /// 用于存储缓存的队列。 + private readonly Queue> _queue = new Queue>(); + /// 控制缓存回收的限制。当缓存的数量超过此限制时，旧的缓存将会被回收。 + private readonly int _recyclingLimit; + + /// + /// 初始化一个新的 类的实例，使用默认的参数设置。 + /// + public SortedConcurrentOneToManyList() + { + } + + /// + /// 初始化一个新的 类的实例，指定最大缓存数量。 + /// + /// + /// 1:防止数据量过大、所以超过recyclingLimit的数据还是走GC. + /// 2:设置成0不控制数量，全部缓存 + /// + public SortedConcurrentOneToManyList(int recyclingLimit = 0) + { + _recyclingLimit = recyclingLimit; + } + + /// + /// 检查指定的键和值是否存在于映射列表中。 + /// + /// 要检查的键。 + /// 要检查的值。 + /// 如果存在，则为 true；否则为 false。 + public bool Contains(TKey key, TValue value) + { + lock (_lockObject) + { + TryGetValue(key, out var list); + + return list != null && list.Contains(value); + } + } + + /// + /// 将指定的值添加到与指定键关联的列表中。 + /// + /// 要关联值的键。 + /// 要添加到列表的值。 + public void Add(TKey key, TValue value) + { + lock (_lockObject) + { + if (!TryGetValue(key, out var list)) + { + list = Fetch(); + list.Add(value); + base[key] = list; + return; + } + + list.Add(value); + } + } + + /// + /// 获取与指定键关联的列表中的第一个值。 + /// 如果列表不存在或为空，则返回默认值。 + /// + /// 要获取第一个值的键。 + /// 第一个值，或默认值。 + public TValue First(TKey key) + { + lock (_lockObject) + { + return !TryGetValue(key, out var list) ? default : list.FirstOrDefault(); + } + } + + /// + /// 从与指定键关联的列表中移除指定的值。 + /// 如果列表不存在或值不存在于列表中，则不执行任何操作。 + /// + /// 要移除值的键。 + /// 要移除的值。 + public void RemoveValue(TKey key, TValue value) + { + lock (_lockObject) + { + if (!TryGetValue(key, out var list)) return; + + list.Remove(value); + + if (list.Count == 0) RemoveKey(key); + } + } + + /// + /// 从映射列表中移除指定的键及其关联的列表。 + /// 如果键不存在于映射列表中，则不执行任何操作。 + /// + /// 要移除的键。 + public void RemoveKey(TKey key) + { + lock (_lockObject) + { + if (!TryGetValue(key, out var list)) return; + + Remove(key); + + Recycle(list); + } + } + + /// + /// 从缓存中获取一个可重用的列表。如果缓存中不存在列表，则创建一个新的列表并返回。 + /// + /// 可重用的列表。 + private List Fetch() + { + lock (_lockObject) + { + return _queue.Count <= 0 ? new List() : _queue.Dequeue(); + } + } + + /// + /// 将不再使用的列表回收到缓存中，以便重复利用。如果缓存数量超过限制，则丢弃列表而不进行回收。 + /// + /// 要回收的列表。 + private void Recycle(List list) + { + lock (_lockObject) + { + list.Clear(); + + if (_recyclingLimit != 0 && _queue.Count > _recyclingLimit) return; + + _queue.Enqueue(list); + } + } + + /// + /// 清空映射列表以及队列。 + /// + protected new void Clear() + { + base.Clear(); + _queue.Clear(); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/SortedOneToManyHashSetPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/SortedOneToManyHashSetPool.cs new file mode 100644 index 0000000..0c49ca8 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/SortedOneToManyHashSetPool.cs @@ -0,0 +1,192 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +namespace NBC.DataStructure.Collection +{ + /// + /// 基于排序字典实现的一对多关系的映射哈希集合的对象池包装类，将唯一键映射到多个值的哈希集合。 + /// 同时实现了 接口，以支持对象的重用和释放。 + /// + /// 字典中键的类型。 + /// 哈希集合中值的类型。 + public class SortedOneToManyHashSetPool : SortedOneToManyHashSet, IDisposable, IPool where TKey : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个 实例。 + /// + /// 新创建的实例。 + public static SortedOneToManyHashSetPool Create() + { +#if FANTASY_WEBGL + var a = Pool>.Rent(); +#else + var a = MultiThreadPool.Rent>(); +#endif + a._isDispose = false; + a._isPool = true; + return a; + } + + /// + /// 释放当前对象池实例，将其返回到对象池以供重用。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 基于排序字典实现的一对多关系的映射哈希集合类，将唯一键映射到多个值的哈希集合。 + /// 用于在多个值与一个键关联的情况下进行管理和存储。 + /// + /// 字典中键的类型。 + /// 集合中值的类型。 + public class SortedOneToManyHashSet : SortedDictionary> where TKey : notnull + { + private readonly Queue> _queue = new Queue>(); + private readonly int _recyclingLimit = 120; + + /// + /// 创建一个新的 实例。 + /// + public SortedOneToManyHashSet() { } + + /// + /// 创建一个新的 实例，设置最大缓存数量 + /// + /// + /// 1:防止数据量过大、所以超过recyclingLimit的数据还是走GC. + /// 2:设置成0不控制数量，全部缓存 + /// + public SortedOneToManyHashSet(int recyclingLimit) + { + _recyclingLimit = recyclingLimit; + } + + /// + /// 判断哈希集合中是否包含指定的键值对。 + /// + /// 要查找的键。 + /// 要查找的值。 + /// 如果键值对存在，则为 true；否则为 false。 + public bool Contains(TKey key, TValue value) + { + TryGetValue(key, out var list); + + return list != null && list.Contains(value); + } + + /// + /// 将指定值添加到给定键关联的哈希集合中。 + /// + /// 要添加值的键。 + /// 要添加的值。 + public void Add(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) + { + list = Fetch(); + list.Add(value); + Add(key, list); + + return; + } + + list.Add(value); + } + + /// + /// 从指定键关联的哈希集合中移除特定值。 + /// 如果哈希集合不存在或值不存在于集合中，则不执行任何操作。 + /// + /// 要移除值的键。 + /// 要移除的值。 + public void RemoveValue(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) return; + + list.Remove(value); + + if (list.Count == 0) RemoveKey(key); + } + + /// + /// 从字典中移除指定键以及关联的哈希集合，并将集合进行回收。 + /// 如果键不存在于映射列表中，则不执行任何操作。 + /// + /// 要移除的键。 + public void RemoveKey(TKey key) + { + if (!TryGetValue(key, out var list)) return; + + Remove(key); + + Recycle(list); + } + + /// + /// 获取一个空的或回收的哈希集合。 + /// + /// 获取的哈希集合实例。 + private HashSet Fetch() + { + return _queue.Count <= 0 ? new HashSet() : _queue.Dequeue(); + } + + /// + /// 回收一个哈希集合，将其清空并放入回收队列中。 + /// + /// 要回收的哈希集合。 + private void Recycle(HashSet list) + { + list.Clear(); + + if (_recyclingLimit != 0 && _queue.Count > _recyclingLimit) return; + + _queue.Enqueue(list); + } + + /// + /// 重写 Clear 方法，清空字典并清空回收队列。 + /// + protected new void Clear() + { + base.Clear(); + _queue.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Collection/SortedOneToManyListPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Collection/SortedOneToManyListPool.cs new file mode 100644 index 0000000..dc349c9 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Collection/SortedOneToManyListPool.cs @@ -0,0 +1,217 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using NBC.Pool; + +#pragma warning disable CS8603 + +namespace NBC.DataStructure.Collection +{ + /// + /// 基于排序字典实现的一对多映射列表的对象池包装类，继承自 类， + /// 同时实现了 接口，以支持对象的重用和释放。 + /// + /// 字典中键的类型。 + /// 列表中值的类型。 + public class SortedOneToManyListPool : SortedOneToManyList, IDisposable, IPool where TKey : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个 实例。 + /// + /// 新创建的实例。 + public static SortedOneToManyListPool Create() + { +#if FANTASY_WEBGL + var a = Pool>.Rent(); +#else + var a = MultiThreadPool.Rent>(); +#endif + a._isDispose = false; + a._isPool = true; + return a; + } + + /// + /// 释放当前对象池实例，将其返回到对象池以供重用。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 基于排序字典实现的一对多关系的映射列表类，将唯一键映射到包含多个值的列表。 + /// 用于在多个值与一个键关联的情况下进行管理和存储。 + /// + /// 字典中键的类型。 + /// 列表中值的类型。 + public class SortedOneToManyList : SortedDictionary> where TKey : notnull + { + private readonly Queue> _queue = new Queue>(); + private readonly int _recyclingLimit; + + /// + /// 创建一个新的 实例。 + /// + public SortedOneToManyList() + { + } + + /// + /// 创建一个新的 实例，设置最大缓存数量 + /// + /// + /// 1:防止数据量过大、所以超过recyclingLimit的数据还是走GC. + /// 2:设置成0不控制数量，全部缓存 + /// + public SortedOneToManyList(int recyclingLimit = 0) + { + _recyclingLimit = recyclingLimit; + } + + /// + /// 判断列表中是否包含指定的键值对。 + /// + /// 要查找的键。 + /// 要查找的值。 + /// 如果键值对存在，则为 true；否则为 false。 + public bool Contains(TKey key, TValue value) + { + TryGetValue(key, out var list); + + return list != null && list.Contains(value); + } + + /// + /// 将指定值添加到给定键关联的列表中。 + /// + /// 要添加值的键。 + /// 要添加的值。 + public void Add(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) + { + list = Fetch(); + list.Add(value); + base[key] = list; + return; + } + + list.Add(value); + } + + /// + /// 获取指定键关联的列表中的第一个值。 + /// + /// 要查找值的键。 + /// 指定键关联的列表中的第一个值，如果列表为空则返回默认值。 + public TValue First(TKey key) + { + return !TryGetValue(key, out var list) ? default : list.FirstOrDefault(); + } + + /// + /// 从指定键关联的列表中移除特定值。 + /// + /// 要移除值的键。 + /// 要移除的值。 + + public void RemoveValue(TKey key, TValue value) + { + if (!TryGetValue(key, out var list)) + { + return; + } + + list.Remove(value); + + if (list.Count == 0) + { + RemoveKey(key); + } + } + + /// + /// 从字典中移除指定键以及关联的列表，并将列表进行回收。 + /// + /// 要移除的键。 + + public void RemoveKey(TKey key) + { + if (!TryGetValue(key, out var list)) + { + return; + } + + Remove(key); + Recycle(list); + } + + /// + /// 获取一个空的或回收的列表。 + /// + /// 获取的列表实例。 + private List Fetch() + { + return _queue.Count <= 0 ? new List() : _queue.Dequeue(); + } + + /// + /// 回收一个列表，将其清空并放入回收队列中。如果缓存数量超过限制，则丢弃列表而不进行回收 + /// + /// 要回收的列表。 + private void Recycle(List list) + { + list.Clear(); + + if (_recyclingLimit != 0 && _queue.Count > _recyclingLimit) + { + return; + } + + _queue.Enqueue(list); + } + + /// + /// 重写 Clear 方法，清空字典并清空回收队列。 + /// + protected new void Clear() + { + base.Clear(); + _queue.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Dictionary/DictionaryExtensions.cs b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/DictionaryExtensions.cs new file mode 100644 index 0000000..609c411 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/DictionaryExtensions.cs @@ -0,0 +1,31 @@ +using System.Collections.Generic; +#pragma warning disable CS8601 // Possible null reference assignment. + +namespace NBC.DataStructure.Dictionary +{ + /// + /// 提供对字典的扩展方法。 + /// + public static class DictionaryExtensions + { + /// + /// 尝试从字典中移除指定键，并返回相应的值。 + /// + /// 字典中键的类型。 + /// 字典中值的类型。 + /// 要操作的字典实例。 + /// 要移除的键。 + /// 从字典中移除的值（如果成功移除）。 + /// 如果成功移除键值对，则为 true；否则为 false。 + public static bool TryRemove(this IDictionary self, T key, out TV value) + { + if (!self.TryGetValue(key, out value)) + { + return false; + } + + self.Remove(key); + return true; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Dictionary/DictionaryPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/DictionaryPool.cs new file mode 100644 index 0000000..a65c8f1 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/DictionaryPool.cs @@ -0,0 +1,70 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +namespace NBC.DataStructure.Dictionary +{ + /// + /// 提供一个可以使用对象池管理的字典类。 + /// + /// 字典中键的类型。 + /// 字典中值的类型。 + public sealed class DictionaryPool : Dictionary, IDisposable, IPool where TM : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 释放实例占用的资源。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 创建一个新的 实例。 + /// + /// 新创建的实例。 + public static DictionaryPool Create() + { +#if FANTASY_WEBGL + var dictionary = Pool>.Rent(); +#else + var dictionary = MultiThreadPool.Rent>(); +#endif + dictionary._isDispose = false; + dictionary._isPool = true; + return dictionary; + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Dictionary/DoubleMapDictionaryPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/DoubleMapDictionaryPool.cs new file mode 100644 index 0000000..d786881 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/DoubleMapDictionaryPool.cs @@ -0,0 +1,289 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +#pragma warning disable CS8601 // Possible null reference assignment. +#pragma warning disable CS8604 // Possible null reference argument. +#pragma warning disable CS8603 // Possible null reference return. + +namespace NBC.DataStructure.Dictionary +{ + /// + /// 提供一个双向映射字典对象池类，用于双向键值对映射。 + /// + /// 字典中键的类型。 + /// 字典中值的类型。 + public class DoubleMapDictionaryPool : DoubleMapDictionary, IDisposable, IPool where TKey : notnull where TValue : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个新的 实例。 + /// + /// 新创建的实例。 + public static DoubleMapDictionaryPool Create() + { +#if FANTASY_WEBGL + var a = Pool>.Rent(); +#else + var a = MultiThreadPool.Rent>(); +#endif + a._isDispose = false; + a._isPool = true; + return a; + } + + /// + /// 释放实例占用的资源。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 可以实现双向映射的字典类，用于将键和值进行双向映射。 + /// + /// 键的类型，不能为 null。 + /// 值的类型，不能为 null。 + public class DoubleMapDictionary where TK : notnull where TV : notnull + { + private readonly Dictionary _kv = new Dictionary(); + private readonly Dictionary _vk = new Dictionary(); + + /// + /// 创建一个新的空的 实例。 + /// + public DoubleMapDictionary() { } + + /// + /// 创建一个新的具有指定初始容量的 实例。 + /// + /// 初始容量。 + public DoubleMapDictionary(int capacity) + { + _kv = new Dictionary(capacity); + _vk = new Dictionary(capacity); + } + + /// + /// 获取包含字典中所有键的列表。 + /// + public List Keys => new List(_kv.Keys); + + /// + /// 获取包含字典中所有值的列表。 + /// + public List Values => new List(_vk.Keys); + + /// + /// 对字典中的每个键值对执行指定的操作。 + /// + /// 要执行的操作。 + public void ForEach(Action action) + { + if (action == null) + { + return; + } + + var keys = _kv.Keys; + foreach (var key in keys) + { + action(key, _kv[key]); + } + } + + /// + /// 将指定的键值对添加到字典中。 + /// + /// 要添加的键。 + /// 要添加的值。 + public void Add(TK key, TV value) + { + if (key == null || value == null || _kv.ContainsKey(key) || _vk.ContainsKey(value)) + { + return; + } + + _kv.Add(key, value); + _vk.Add(value, key); + } + + /// + /// 根据指定的键获取相应的值。 + /// + /// 要查找值的键。 + /// 与指定键关联的值，如果找不到键，则返回默认值。 + public TV GetValueByKey(TK key) + { + if (key != null && _kv.ContainsKey(key)) + { + return _kv[key]; + } + + return default; + } + + /// + /// 尝试根据指定的键获取相应的值。 + /// + /// 要查找值的键。 + /// 如果找到，则为与指定键关联的值；否则为值的默认值。 + /// 如果找到键，则为 true；否则为 false。 + public bool TryGetValueByKey(TK key, out TV value) + { + var result = key != null && _kv.ContainsKey(key); + + value = result ? _kv[key] : default; + + return result; + } + + /// + /// 根据指定的值获取相应的键。 + /// + /// 要查找键的值。 + /// 与指定值关联的键，如果找不到值，则返回默认键。 + public TK GetKeyByValue(TV value) + { + if (value != null && _vk.ContainsKey(value)) + { + return _vk[value]; + } + + return default; + } + + /// + /// 尝试根据指定的值获取相应的键。 + /// + /// 要查找键的值。 + /// 如果找到，则为与指定值关联的键；否则为键的默认值。 + /// 如果找到值，则为 true；否则为 false。 + public bool TryGetKeyByValue(TV value, out TK key) + { + var result = value != null && _vk.ContainsKey(value); + + key = result ? _vk[value] : default; + + return result; + } + + /// + /// 根据指定的键移除键值对。 + /// + /// 要移除的键。 + public void RemoveByKey(TK key) + { + if (key == null) + { + return; + } + + if (!_kv.TryGetValue(key, out var value)) + { + return; + } + + _kv.Remove(key); + _vk.Remove(value); + } + + /// + /// 根据指定的值移除键值对。 + /// + /// 要移除的值。 + public void RemoveByValue(TV value) + { + if (value == null) + { + return; + } + + if (!_vk.TryGetValue(value, out var key)) + { + return; + } + + _kv.Remove(key); + _vk.Remove(value); + } + + /// + /// 清空字典中的所有键值对。 + /// + public void Clear() + { + _kv.Clear(); + _vk.Clear(); + } + + /// + /// 判断字典是否包含指定的键。 + /// + /// 要检查的键。 + /// 如果字典包含指定的键，则为 true；否则为 false。 + public bool ContainsKey(TK key) + { + return key != null && _kv.ContainsKey(key); + } + + /// + /// 判断字典是否包含指定的值。 + /// + /// 要检查的值。 + /// 如果字典包含指定的值，则为 true；否则为 false。 + public bool ContainsValue(TV value) + { + return value != null && _vk.ContainsKey(value); + } + + /// + /// 判断字典是否包含指定的键值对。 + /// + /// 要检查的键。 + /// 要检查的值。 + /// 如果字典包含指定的键值对，则为 true；否则为 false。 + public bool Contains(TK key, TV value) + { + if (key == null || value == null) + { + return false; + } + + return _kv.ContainsKey(key) && _vk.ContainsKey(value); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Dictionary/EntityDictionary.cs b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/EntityDictionary.cs new file mode 100644 index 0000000..4c4d25f --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/EntityDictionary.cs @@ -0,0 +1,91 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +namespace NBC.DataStructure.Dictionary +{ + /// + /// 提供一个带资源释放功能的实体字典类，支持使用对象池管理。 + /// + /// 字典中键的类型。 + /// 字典中值的类型，必须实现 IDisposable 接口。 + public sealed class EntityDictionary : Dictionary, IDisposable, IPool where TN : IDisposable where TM : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个新的 实例。 + /// + /// 新创建的实例。 + public static EntityDictionary Create() + { +#if FANTASY_WEBGL + var entityDictionary = Pool>.Rent(); +#else + var entityDictionary = MultiThreadPool.Rent>(); +#endif + entityDictionary._isDispose = false; + entityDictionary._isPool = true; + return entityDictionary; + } + + /// + /// 清空字典中的所有键值对，并释放值的资源。 + /// + public new void Clear() + { + foreach (var keyValuePair in this) + { + keyValuePair.Value.Dispose(); + } + + base.Clear(); + } + + /// + /// 清空字典中的所有键值对，但不释放值的资源。 + /// + public void ClearNotDispose() + { + base.Clear(); + } + + /// + /// 释放实例占用的资源。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Dictionary/OneToManyDictionaryPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/OneToManyDictionaryPool.cs new file mode 100644 index 0000000..3d47561 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/OneToManyDictionaryPool.cs @@ -0,0 +1,247 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using NBC.Pool; + +#pragma warning disable CS8603 +#pragma warning disable CS8601 + +namespace NBC.DataStructure.Dictionary +{ + /// + /// 一对多映射关系的字典对象池。 + /// + /// 外部字典中的键类型。 + /// 内部字典中的键类型。 + /// 内部字典中的值类型。 + public class OneToManyDictionaryPool : OneToManyDictionary, IDisposable, IPool where TKey : notnull where TValueKey : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个 的实例。 + /// + /// 新创建的 OneToManyDictionaryPool 实例。 + public static OneToManyDictionaryPool Create() + { +#if FANTASY_WEBGL + var a = Pool>.Rent(); +#else + var a = MultiThreadPool.Rent>(); +#endif + a._isDispose = false; + a._isPool = true; + return a; + } + + /// + /// 释放当前实例及其资源。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 一对多映射关系的字典。每个键都对应一个内部字典，该内部字典将键值映射到相应的值。 + /// + /// 外部字典中的键类型。 + /// 内部字典中的键类型。 + /// 内部字典中的值类型。 + public class OneToManyDictionary : Dictionary> + where TKey : notnull where TValueKey : notnull + { + private readonly Queue> _queue = new Queue>(); + private readonly int _recyclingLimit = 120; + + /// + /// 创建一个新的 实例。 + /// + public OneToManyDictionary() { } + + /// + /// 创建一个新的 实例，并指定最大缓存数量。 + /// + /// + /// 1:防止数据量过大、所以超过recyclingLimit的数据还是走GC. + /// 2:设置成0不控制数量，全部缓存 + /// + public OneToManyDictionary(int recyclingLimit = 0) + { + _recyclingLimit = recyclingLimit; + } + + /// + /// 检查是否包含指定的键值对。 + /// + /// 外部字典中的键。 + /// 内部字典中的键。 + /// 如果包含指定的键值对，则为 true；否则为 false。 + public bool Contains(TKey key, TValueKey valueKey) + { + TryGetValue(key, out var dic); + + return dic != null && dic.ContainsKey(valueKey); + } + + /// + /// 尝试获取指定键值对的值。 + /// + /// 外部字典中的键。 + /// 内部字典中的键。 + /// 获取的值，如果操作成功，则为值；否则为默认值。 + /// 如果操作成功，则为 true；否则为 false。 + public bool TryGetValue(TKey key, TValueKey valueKey, out TValue value) + { + value = default; + return TryGetValue(key, out var dic) && dic.TryGetValue(valueKey, out value); + } + + /// + /// 获取指定键的第一个值。 + /// + /// 要获取第一个值的键。 + public TValue First(TKey key) + { + return !TryGetValue(key, out var dic) ? default : dic.First().Value; + } + + /// + /// 向字典中添加指定的键值对。 + /// + /// 要添加键值对的键。 + /// 要添加键值对的内部字典键。 + /// 要添加的值。 + public void Add(TKey key, TValueKey valueKey, TValue value) + { + if (!TryGetValue(key, out var dic)) + { + dic = Fetch(); + dic[valueKey] = value; + // dic.Add(valueKey, value); + Add(key, dic); + + return; + } + + dic[valueKey] = value; + // dic.Add(valueKey, value); + } + + /// + /// 从字典中移除指定的键值对。 + /// + /// 要移除键值对的键。 + /// 要移除键值对的内部字典键。 + /// 如果成功移除键值对，则为 true；否则为 false。 + public bool Remove(TKey key, TValueKey valueKey) + { + if (!TryGetValue(key, out var dic)) return false; + + var result = dic.Remove(valueKey); + + if (dic.Count == 0) RemoveKey(key); + + return result; + } + + /// + /// 从字典中移除指定的键值对。 + /// + /// 要移除键值对的键。 + /// 要移除键值对的内部字典键。 + /// 如果成功移除键值对，则为移除的值；否则为默认值。 + /// 如果成功移除键值对，则为 true；否则为 false。 + public bool Remove(TKey key, TValueKey valueKey, out TValue value) + { + if (!TryGetValue(key, out var dic)) + { + value = default; + return false; + } + + var result = dic.TryGetValue(valueKey, out value); + + if (result) dic.Remove(valueKey); + + if (dic.Count == 0) RemoveKey(key); + + return result; + } + + /// + /// 移除字典中的指定键及其相关的所有键值对。 + /// + /// 要移除的键。 + public void RemoveKey(TKey key) + { + if (!TryGetValue(key, out var dic)) return; + + Remove(key); + Recycle(dic); + } + + /// + /// 从对象池中获取一个内部字典实例，如果池中没有，则创建一个新实例。 + /// + /// 获取的内部字典实例。 + private Dictionary Fetch() + { + return _queue.Count <= 0 ? new Dictionary() : _queue.Dequeue(); + } + + /// + /// 将不再使用的内部字典实例放回对象池中，以便后续重用。 + /// + /// 要放回对象池的内部字典实例。 + private void Recycle(Dictionary dic) + { + dic.Clear(); + + if (_recyclingLimit != 0 && _queue.Count > _recyclingLimit) return; + + _queue.Enqueue(dic); + } + + /// + /// 清空字典中的所有键值对，并将不再使用的内部字典实例放回对象池中。 + /// + public new void Clear() + { + foreach (var keyValuePair in this) Recycle(keyValuePair.Value); + + base.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Dictionary/OneToManySortedDictionaryPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/OneToManySortedDictionaryPool.cs new file mode 100644 index 0000000..c6208a7 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/OneToManySortedDictionaryPool.cs @@ -0,0 +1,250 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +#pragma warning disable CS8601 + +namespace NBC.DataStructure.Dictionary +{ + /// + /// 一对多映射关系的排序字典对象池。 + /// + /// 外部字典中的键类型。 + /// 内部字典中的排序键类型。 + /// 内部字典中的值类型。 + public class OneToManySortedDictionaryPool : OneToManySortedDictionary, IDisposable, IPool where TKey : notnull where TSortedKey : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个 的实例。 + /// + /// 新创建的 OneToManySortedDictionaryPool 实例。 + public static OneToManySortedDictionaryPool Create() + { +#if FANTASY_WEBGL + var a = Pool>.Rent(); +#else + var a = MultiThreadPool.Rent>(); +#endif + a._isDispose = false; + a._isPool = true; + return a; + } + + /// + /// 释放当前实例及其资源。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + /// + /// 一对多映射关系的排序字典。每个外部键映射到一个内部排序字典，该内部排序字典将排序键映射到相应的值。 + /// + /// 外部字典中的键类型。 + /// 内部字典中的排序键类型。 + /// 内部字典中的值类型。 + public class + OneToManySortedDictionary : Dictionary> + where TSortedKey : notnull where TKey : notnull + { + /// 缓存队列的回收限制 + private readonly int _recyclingLimit = 120; + /// 缓存队列，用于存储已回收的内部排序字典 + private readonly Queue> _queue = new Queue>(); + + /// + /// 创建一个新的 实例。 + /// + protected OneToManySortedDictionary() { } + + /// + /// 创建一个新的 实例。设置最大缓存数量 + /// + /// + /// 1:防止数据量过大、所以超过recyclingLimit的数据还是走GC. + /// 2:设置成0不控制数量，全部缓存 + /// + public OneToManySortedDictionary(int recyclingLimit) + { + _recyclingLimit = recyclingLimit; + } + + /// + /// 检查字典是否包含指定的外部键。 + /// + /// 要检查的外部键。 + /// 如果字典包含指定的外部键，则为 true；否则为 false。 + public bool Contains(TKey key) + { + return this.ContainsKey(key); + } + + /// + /// 检查字典是否包含指定的外部键和排序键。 + /// + /// 要检查的外部键。 + /// 要检查的排序键。 + /// 如果字典包含指定的外部键和排序键，则为 true；否则为 false。 + public bool Contains(TKey key, TSortedKey sortedKey) + { + return TryGetValue(key, out var dic) && dic.ContainsKey(sortedKey); + } + + /// + /// 尝试从字典中获取指定外部键对应的内部排序字典。 + /// + /// 要获取内部排序字典的外部键。 + /// 获取到的内部排序字典，如果找不到则为 null。 + /// 如果找到内部排序字典，则为 true；否则为 false。 + public new bool TryGetValue(TKey key, out SortedDictionary dic) + { + return base.TryGetValue(key, out dic); + } + + /// + /// 尝试从字典中获取指定外部键和排序键对应的值。 + /// + /// 要获取值的外部键。 + /// 要获取值的排序键。 + /// 获取到的值，如果找不到则为 default。 + /// 如果找到值，则为 true；否则为 false。 + public bool TryGetValueBySortedKey(TKey key, TSortedKey sortedKey, out TValue value) + { + if (base.TryGetValue(key, out var dic)) + { + return dic.TryGetValue(sortedKey, out value); + } + + value = default; + return false; + } + + /// + /// 向字典中添加一个值，关联到指定的外部键和排序键。 + /// + /// 要关联值的外部键。 + /// 要关联值的排序键。 + /// 要添加的值。 + public void Add(TKey key, TSortedKey sortedKey, TValue value) + { + if (!TryGetValue(key, out var dic)) + { + dic = Fetch(); + dic.Add(sortedKey, value); + Add(key, dic); + + return; + } + + dic.Add(sortedKey, value); + } + + /// + /// 从字典中移除指定外部键和排序键关联的值。 + /// + /// 要移除值的外部键。 + /// 要移除值的排序键。 + /// 如果成功移除值，则为 true；否则为 false。 + public bool RemoveSortedKey(TKey key, TSortedKey sortedKey) + { + if (!TryGetValue(key, out var dic)) + { + return false; + } + + var isRemove = dic.Remove(sortedKey); + + if (dic.Count == 0) + { + isRemove = RemoveKey(key); + } + + return isRemove; + } + + /// + /// 从字典中移除指定外部键及其关联的所有值。 + /// + /// 要移除的外部键。 + /// 如果成功移除外部键及其关联的所有值，则为 true；否则为 false。 + public bool RemoveKey(TKey key) + { + if (!TryGetValue(key, out var list)) + { + return false; + } + + Remove(key); + Recycle(list); + return true; + } + + /// + /// 从缓存队列中获取一个内部排序字典。 + /// + /// 一个内部排序字典。 + private SortedDictionary Fetch() + { + return _queue.Count <= 0 ? new SortedDictionary() : _queue.Dequeue(); + } + + /// + /// 回收一个内部排序字典到缓存队列。 + /// + /// 要回收的内部排序字典。 + private void Recycle(SortedDictionary dic) + { + dic.Clear(); + + if (_recyclingLimit != 0 && _queue.Count > _recyclingLimit) + { + return; + } + + _queue.Enqueue(dic); + } + + /// + /// 清空字典以及内部排序字典缓存队列，释放所有资源。 + /// + protected new void Clear() + { + base.Clear(); + _queue.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Dictionary/ReuseDictionary.cs b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/ReuseDictionary.cs new file mode 100644 index 0000000..04fea5b --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/ReuseDictionary.cs @@ -0,0 +1,70 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +namespace NBC.DataStructure.Dictionary +{ + /// + /// 提供一个可以重用的字典类，支持使用对象池管理。 + /// + /// 字典中键的类型。 + /// 字典中值的类型。 + public sealed class ReuseDictionary : Dictionary, IDisposable, IPool where TM : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 创建一个新的 实例。 + /// + /// 新创建的实例。 + public static ReuseDictionary Create() + { +#if FANTASY_WEBGL + var entityDictionary = Pool>.Rent(); +#else + var entityDictionary = MultiThreadPool.Rent>(); +#endif + entityDictionary._isDispose = false; + entityDictionary._isPool = true; + return entityDictionary; + } + + /// + /// 释放实例占用的资源。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/Dictionary/SortedDictionaryPool.cs b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/SortedDictionaryPool.cs new file mode 100644 index 0000000..b774175 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/Dictionary/SortedDictionaryPool.cs @@ -0,0 +1,70 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +namespace NBC.DataStructure.Dictionary +{ + /// + /// 提供一个可以使用对象池管理的排序字典类。 + /// + /// + /// + public sealed class SortedDictionaryPool : SortedDictionary, IDisposable, IPool where TM : notnull + { + private bool _isPool; + private bool _isDispose; + + /// + /// 释放实例占用的资源。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + _isDispose = true; + Clear(); +#if FANTASY_WEBGL + Pool>.Return(this); +#else + MultiThreadPool.Return(this); +#endif + } + + /// + /// 创建一个新的 实例。 + /// + /// 新创建的实例。 + public static SortedDictionaryPool Create() + { +#if FANTASY_WEBGL + var dictionary = Pool>.Rent(); +#else + var dictionary = MultiThreadPool.Rent>(); +#endif + dictionary._isDispose = false; + dictionary._isPool = true; + return dictionary; + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueGenerics.cs b/FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueGenerics.cs new file mode 100644 index 0000000..4c1ae0e --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueGenerics.cs @@ -0,0 +1,121 @@ +// ReSharper disable SwapViaDeconstruction +// ReSharper disable UseIndexFromEndExpression +// ReSharper disable ConvertToPrimaryConstructor +using System; +using System.Collections.Generic; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +#pragma warning disable CS8601 // Possible null reference assignment. +namespace NBC.DataStructure.PriorityQueue +{ + /// + /// 优先队列 + /// + /// 节点数据 + /// 排序的类型、 + public sealed class PriorityQueue where TPriority : IComparable + { + private readonly List> _heap; + + public PriorityQueue(int initialCapacity = 16) + { + _heap = new List>(initialCapacity); + } + + public int Count => _heap.Count; + + public void Enqueue(TElement element, TPriority priority) + { + _heap.Add(new PriorityQueueItem(element, priority)); + HeapifyUp(_heap.Count - 1); + } + + public TElement Dequeue() + { + if (_heap.Count == 0) + { + throw new InvalidOperationException("The queue is empty."); + } + + var item = _heap[0]; + _heap[0] = _heap[_heap.Count - 1]; + _heap.RemoveAt(_heap.Count - 1); + HeapifyDown(0); + return item.Element; + } + + public bool TryDequeue(out TElement element) + { + if (_heap.Count == 0) + { + element = default(TElement); + return false; + } + + element = Dequeue(); + return true; + } + + public TElement Peek() + { + if (_heap.Count == 0) + { + throw new InvalidOperationException("The queue is empty."); + } + return _heap[0].Element; + } + + // ReSharper disable once IdentifierTypo + private void HeapifyUp(int index) + { + while (index > 0) + { + var parentIndex = (index - 1) / 2; + if (_heap[index].Priority.CompareTo(_heap[parentIndex].Priority) >= 0) + { + break; + } + Swap(index, parentIndex); + index = parentIndex; + } + } + + // ReSharper disable once IdentifierTypo + private void HeapifyDown(int index) + { + var lastIndex = _heap.Count - 1; + while (true) + { + var smallestIndex = index; + var leftChildIndex = 2 * index + 1; + var rightChildIndex = 2 * index + 2; + + if (leftChildIndex <= lastIndex && _heap[leftChildIndex].Priority.CompareTo(_heap[smallestIndex].Priority) < 0) + { + smallestIndex = leftChildIndex; + } + + if (rightChildIndex <= lastIndex && _heap[rightChildIndex].Priority.CompareTo(_heap[smallestIndex].Priority) < 0) + { + smallestIndex = rightChildIndex; + } + + if (smallestIndex == index) + { + break; + } + + Swap(index, smallestIndex); + index = smallestIndex; + } + } + + private void Swap(int index1, int index2) + { + var temp = _heap[index1]; + _heap[index1] = _heap[index2]; + _heap[index2] = temp; + } + } +} + diff --git a/FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueItem.cs b/FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueItem.cs new file mode 100644 index 0000000..754b313 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueItem.cs @@ -0,0 +1,30 @@ +// ReSharper disable ConvertToPrimaryConstructor +// ReSharper disable SwapViaDeconstruction +// ReSharper disable InconsistentNaming +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace NBC.DataStructure.PriorityQueue +{ + public struct PriorityQueueItemUint + { + public T Element { get; set; } + public uint Priority { get; set; } + + public PriorityQueueItemUint(T element, uint priority) + { + Element = element; + Priority = priority; + } + } + + public struct PriorityQueueItem + { + public T Element { get; } + public T1 Priority { get; } + + public PriorityQueueItem(T element, T1 priority) + { + Element = element; + Priority = priority; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueSimple.cs b/FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueSimple.cs new file mode 100644 index 0000000..9841c06 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/PriorityQueue/PriorityQueueSimple.cs @@ -0,0 +1,116 @@ +// ReSharper disable SwapViaDeconstruction +// ReSharper disable UseIndexFromEndExpression +// ReSharper disable ConvertToPrimaryConstructor +using System; +using System.Collections.Generic; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8601 // Possible null reference assignment. +namespace NBC.DataStructure.PriorityQueue +{ + public sealed class PriorityQueue where T : IComparable + { + private readonly List _heap; + + public PriorityQueue(int initialCapacity = 16) + { + _heap = new List(initialCapacity); + } + + public int Count => _heap.Count; + + public void Enqueue(T item) + { + _heap.Add(item); + HeapifyUp(_heap.Count - 1); + } + + public T Dequeue() + { + if (_heap.Count == 0) + { + throw new InvalidOperationException("The queue is empty."); + } + + var item = _heap[0]; + var heapCount = _heap.Count - 1; + _heap[0] = _heap[heapCount]; + _heap.RemoveAt(heapCount); + HeapifyDown(0); + return item; + } + + public bool TryDequeue(out T item) + { + if (_heap.Count == 0) + { + item = default(T); + return false; + } + + item = Dequeue(); + return true; + } + + public T Peek() + { + if (_heap.Count == 0) + { + throw new InvalidOperationException("The queue is empty."); + } + return _heap[0]; + } + + // ReSharper disable once IdentifierTypo + private void HeapifyUp(int index) + { + while (index > 0) + { + var parentIndex = (index - 1) / 2; + if (_heap[index].CompareTo(_heap[parentIndex]) >= 0) + { + break; + } + Swap(index, parentIndex); + index = parentIndex; + } + } + + // ReSharper disable once IdentifierTypo + private void HeapifyDown(int index) + { + var lastIndex = _heap.Count - 1; + while (true) + { + var smallestIndex = index; + var leftChildIndex = 2 * index + 1; + var rightChildIndex = 2 * index + 2; + + if (leftChildIndex <= lastIndex && _heap[leftChildIndex].CompareTo(_heap[smallestIndex]) < 0) + { + smallestIndex = leftChildIndex; + } + + if (rightChildIndex <= lastIndex && _heap[rightChildIndex].CompareTo(_heap[smallestIndex]) < 0) + { + smallestIndex = rightChildIndex; + } + + if (smallestIndex == index) + { + break; + } + + Swap(index, smallestIndex); + index = smallestIndex; + } + } + + private void Swap(int index1, int index2) + { + var temp = _heap[index1]; + _heap[index1] = _heap[index2]; + _heap[index2] = temp; + } + } +} + diff --git a/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTable.cs b/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTable.cs new file mode 100644 index 0000000..b4ca0c5 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTable.cs @@ -0,0 +1,190 @@ + +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8601 // Possible null reference assignment. +#pragma warning disable CS8604 // Possible null reference argument. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +namespace NBC.DataStructure.SkipTable +{ + /// + /// 跳表数据结构（升序版） + /// + /// 跳表中存储的值的类型。 + public class SkipTable : SkipTableBase + { + /// + /// 创建一个新的跳表实例。 + /// + /// 跳表的最大层数。 + public SkipTable(int maxLayer = 8) : base(maxLayer) { } + + /// + /// 向跳表中添加一个新节点。 + /// + /// 节点的主排序键。 + /// 节点的副排序键。 + /// 节点的唯一键。 + /// 要添加的值。 + public override void Add(long sortKey, long viceKey, long key, TValue value) + { + var rLevel = 1; + + while (rLevel <= MaxLayer && Random.Next(3) == 0) + { + ++rLevel; + } + + SkipTableNode cur = TopHeader, last = null; + + for (var layer = MaxLayer; layer >= 1; --layer) + { + // 节点有next节点，且 （next主键 < 插入主键） 或 （next主键 == 插入主键 且 next副键 < 插入副键） + while (cur.Right != null && ((cur.Right.SortKey < sortKey) || + (cur.Right.SortKey == sortKey && cur.Right.ViceKey < viceKey))) + { + cur = cur.Right; + } + + if (layer <= rLevel) + { + var currentRight = cur.Right; + + // 在当前层插入新节点 + cur.Right = new SkipTableNode(sortKey, viceKey, key, value, layer == 1 ? cur.Index + 1 : 0, cur, cur.Right, null); + + if (currentRight != null) + { + currentRight.Left = cur.Right; + } + + if (last != null) + { + last.Down = cur.Right; + } + + if (layer == 1) + { + // 更新索引信息 + cur.Right.Index = cur.Index + 1; + Node.Add(key, cur.Right); + + SkipTableNode v = cur.Right.Right; + + while (v != null) + { + v.Index++; + v = v.Right; + } + } + + last = cur.Right; + } + + cur = cur.Down; + } + } + + /// + /// 从跳表中移除一个节点。 + /// + /// 节点的主排序键。 + /// 节点的副排序键。 + /// 节点的唯一键。 + /// 被移除的节点的值。 + /// 如果成功移除节点，则为 true；否则为 false。 + public override bool Remove(long sortKey, long viceKey, long key, out TValue value) + { + value = default; + var seen = false; + var cur = TopHeader; + + for (var layer = MaxLayer; layer >= 1; --layer) + { + // 先按照主键查找 再 按副键查找 + while (cur.Right != null && cur.Right.SortKey < sortKey && cur.Right.Key != key) cur = cur.Right; + while (cur.Right != null && (cur.Right.SortKey == sortKey && cur.Right.ViceKey <= viceKey) && + cur.Right.Key != key) cur = cur.Right; + + var isFind = false; + var currentCur = cur; + SkipTableNode removeCur = null; + // 如果当前不是要删除的节点、但主键和副键都一样、需要特殊处理下。 + if (cur.Right != null && cur.Right.Key == key) + { + isFind = true; + removeCur = cur.Right; + currentCur = cur; + } + else + { + // 先向左查找下 + var currentNode = cur.Left; + while (currentNode != null && currentNode.SortKey == sortKey && currentNode.ViceKey == viceKey) + { + if (currentNode.Key == key) + { + isFind = true; + removeCur = currentNode; + currentCur = currentNode.Left; + break; + } + + currentNode = currentNode.Left; + } + + // 再向右查找下 + if (!isFind) + { + currentNode = cur.Right; + while (currentNode != null && currentNode.SortKey == sortKey && currentNode.ViceKey == viceKey) + { + if (currentNode.Key == key) + { + isFind = true; + removeCur = currentNode; + currentCur = currentNode.Left; + break; + } + + currentNode = currentNode.Right; + } + } + } + + if (isFind && currentCur != null) + { + value = removeCur.Value; + currentCur.Right = removeCur.Right; + + if (removeCur.Right != null) + { + removeCur.Right.Left = currentCur; + removeCur.Right = null; + } + + removeCur.Left = null; + removeCur.Down = null; + removeCur.Value = default; + + if (layer == 1) + { + var tempCur = currentCur.Right; + while (tempCur != null) + { + tempCur.Index--; + tempCur = tempCur.Right; + } + + Node.Remove(removeCur.Key); + } + + seen = true; + } + + cur = cur.Down; + } + + return seen; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableBase.cs b/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableBase.cs new file mode 100644 index 0000000..86798d9 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableBase.cs @@ -0,0 +1,282 @@ +using System; +using System.Collections; +using System.Collections.Generic; +using NBC.DataStructure.Collection; + +#pragma warning disable CS8601 +#pragma warning disable CS8603 +#pragma warning disable CS8625 +#pragma warning disable CS8604 + +namespace NBC.DataStructure.SkipTable +{ + /// + /// 抽象的跳表基类，提供跳表的基本功能和操作。 + /// + /// 跳表中存储的值的类型。 + public abstract class SkipTableBase : IEnumerable> + { + /// + /// 跳表的最大层数 + /// + public readonly int MaxLayer; + /// + /// 跳表的顶部头节点 + /// + public readonly SkipTableNode TopHeader; + /// + /// 跳表的底部头节点 + /// + public SkipTableNode BottomHeader; + /// + /// 跳表中节点的数量，使用了 Node 字典的计数 + /// + public int Count => Node.Count; + /// + /// 用于生成随机数的随机数生成器 + /// + protected readonly Random Random = new Random(); + /// + /// 存储跳表节点的字典 + /// + protected readonly Dictionary> Node = new(); + /// + /// 用于辅助反向查找的栈 + /// + protected readonly Stack> AntiFindStack = new Stack>(); + + /// + /// 初始化一个新的跳表实例。 + /// + /// 跳表的最大层数，默认为 8。 + protected SkipTableBase(int maxLayer = 8) + { + MaxLayer = maxLayer; + var cur = TopHeader = new SkipTableNode(long.MinValue, 0, 0, default, 0, null, null, null); + + for (var layer = MaxLayer - 1; layer >= 1; --layer) + { + cur.Down = new SkipTableNode(long.MinValue, 0, 0, default, 0, null, null, null); + cur = cur.Down; + } + + BottomHeader = cur; + } + + /// + /// 获取指定键的节点的值，若不存在则返回默认值。 + /// + /// 要查找的键。 + public TValue this[long key] => !TryGetValueByKey(key, out TValue value) ? default : value; + + /// + /// 获取指定键的节点在跳表中的排名。 + /// + /// 要查找的键。 + /// 节点的排名。 + public int GetRanking(long key) + { + if (!Node.TryGetValue(key, out var node)) + { + return 0; + } + + return node.Index; + } + + /// + /// 获取指定键的反向排名，即在比该键更大的节点中的排名。 + /// + /// 要查找的键。 + /// 反向排名。 + public int GetAntiRanking(long key) + { + var ranking = GetRanking(key); + + if (ranking == 0) + { + return 0; + } + + return Count + 1 - ranking; + } + + /// + /// 尝试通过键获取节点的值。 + /// + /// 要查找的键。 + /// 获取到的节点的值，如果键不存在则为默认值。 + /// 是否成功获取节点的值。 + public bool TryGetValueByKey(long key, out TValue value) + { + if (!Node.TryGetValue(key, out var node)) + { + value = default; + return false; + } + + value = node.Value; + return true; + } + + /// + /// 尝试通过键获取节点。 + /// + /// 要查找的键。 + /// 获取到的节点，如果键不存在则为 null。 + /// 是否成功获取节点。 + public bool TryGetNodeByKey(long key, out SkipTableNode node) + { + if (Node.TryGetValue(key, out node)) + { + return true; + } + + return false; + } + + /// + /// 在跳表中查找节点，返回从起始位置到结束位置的节点列表。 + /// + /// 起始位置的排名。 + /// 结束位置的排名。 + /// 用于存储节点列表的 实例。 + public void Find(int start, int end, ListPool> list) + { + var cur = BottomHeader; + var count = end - start; + + for (var i = 0; i < start; i++) + { + cur = cur.Right; + } + + for (var i = 0; i <= count; i++) + { + if (cur == null) + { + break; + } + + list.Add(cur); + cur = cur.Right; + } + } + + /// + /// 在跳表中进行反向查找节点，返回从结束位置到起始位置的节点列表。 + /// + /// 结束位置的排名。 + /// 起始位置的排名。 + /// 用于存储节点列表的 实例。 + public void AntiFind(int start, int end, ListPool> list) + { + var cur = BottomHeader; + start = Count + 1 - start; + end = start - end; + + for (var i = 0; i < start; i++) + { + cur = cur.Right; + + if (cur == null) + { + break; + } + + if (i < end) + { + continue; + } + + AntiFindStack.Push(cur); + } + + while (AntiFindStack.TryPop(out var node)) + { + list.Add(node); + } + } + + /// + /// 获取跳表中最后一个节点的值。 + /// + /// 最后一个节点的值。 + public TValue GetLastValue() + { + var cur = TopHeader; + + while (cur.Right != null || cur.Down != null) + { + while (cur.Right != null) + { + cur = cur.Right; + } + + if (cur.Down != null) + { + cur = cur.Down; + } + } + + return cur.Value; + } + + /// + /// 移除跳表中指定键的节点。 + /// + /// 要移除的节点的键。 + /// 移除是否成功。 + public bool Remove(long key) + { + if (!Node.TryGetValue(key, out var node)) + { + return false; + } + + return Remove(node.SortKey, node.ViceKey, key, out _); + } + + /// + /// 向跳表中添加节点。 + /// + /// 节点的排序键。 + /// 节点的副键。 + /// 节点的键。 + /// 节点的值。 + public abstract void Add(long sortKey, long viceKey, long key, TValue value); + + /// + /// 从跳表中移除指定键的节点。 + /// + /// 节点的排序键。 + /// 节点的副键。 + /// 节点的键。 + /// 被移除的节点的值。 + /// 移除是否成功。 + public abstract bool Remove(long sortKey, long viceKey, long key, out TValue value); + + /// + /// 返回一个枚举器，用于遍历跳表中的节点。 + /// + /// 一个可用于遍历跳表节点的枚举器。 + public IEnumerator> GetEnumerator() + { + var cur = BottomHeader.Right; + while (cur != null) + { + yield return cur; + cur = cur.Right; + } + } + + /// + /// 返回一个非泛型枚举器，用于遍历跳表中的节点。 + /// + /// 一个非泛型枚举器，可用于遍历跳表节点。 + IEnumerator IEnumerable.GetEnumerator() + { + return GetEnumerator(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableDesc.cs b/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableDesc.cs new file mode 100644 index 0000000..41c95d7 --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableDesc.cs @@ -0,0 +1,188 @@ + +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8604 // Possible null reference argument. +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8601 // Possible null reference assignment. +namespace NBC.DataStructure.SkipTable +{ + /// + /// 跳表降序版，用于存储降序排列的数据。 + /// + /// 存储的值的类型。 + public class SkipTableDesc : SkipTableBase + { + /// + /// 初始化跳表降序版的新实例。 + /// + /// 跳表的最大层数，默认为 8。 + public SkipTableDesc(int maxLayer = 8) : base(maxLayer) { } + + /// + /// 向跳表中添加一个节点，根据降序规则进行插入。 + /// + /// 排序主键。 + /// 副键。 + /// 键。 + /// 值。 + public override void Add(long sortKey, long viceKey, long key, TValue value) + { + var rLevel = 1; + + while (rLevel <= MaxLayer && Random.Next(3) == 0) + { + ++rLevel; + } + + SkipTableNode cur = TopHeader, last = null; + + for (var layer = MaxLayer; layer >= 1; --layer) + { + // 节点有next节点，且 （next主键 > 插入主键） 或 （next主键 == 插入主键 且 next副键 > 插入副键） + while (cur.Right != null && ((cur.Right.SortKey > sortKey) || + (cur.Right.SortKey == sortKey && cur.Right.ViceKey > viceKey))) + { + cur = cur.Right; + } + + if (layer <= rLevel) + { + var currentRight = cur.Right; + cur.Right = new SkipTableNode(sortKey, viceKey, key, value, + layer == 1 ? cur.Index + 1 : 0, cur, cur.Right, null); + + if (currentRight != null) + { + currentRight.Left = cur.Right; + } + + if (last != null) + { + last.Down = cur.Right; + } + + if (layer == 1) + { + cur.Right.Index = cur.Index + 1; + Node.Add(key, cur.Right); + + SkipTableNode v = cur.Right.Right; + + while (v != null) + { + v.Index++; + v = v.Right; + } + } + + last = cur.Right; + } + + cur = cur.Down; + } + } + + /// + /// 从跳表中移除一个节点，根据降序规则进行移除。 + /// + /// 排序主键。 + /// 副键。 + /// 键。 + /// 移除的节点值。 + /// 如果成功移除节点，则返回 true，否则返回 false。 + public override bool Remove(long sortKey, long viceKey, long key, out TValue value) + { + value = default; + var seen = false; + var cur = TopHeader; + + for (var layer = MaxLayer; layer >= 1; --layer) + { + // 先按照主键查找 再 按副键查找 + while (cur.Right != null && cur.Right.SortKey > sortKey && cur.Right.Key != key) cur = cur.Right; + while (cur.Right != null && (cur.Right.SortKey == sortKey && cur.Right.ViceKey >= viceKey) && + cur.Right.Key != key) cur = cur.Right; + + var isFind = false; + var currentCur = cur; + SkipTableNode removeCur = null; + // 如果当前不是要删除的节点、但主键和副键都一样、需要特殊处理下。 + if (cur.Right != null && cur.Right.Key == key) + { + isFind = true; + removeCur = cur.Right; + currentCur = cur; + } + else + { + // 先向左查找下 + var currentNode = cur.Left; + while (currentNode != null && currentNode.SortKey == sortKey && currentNode.ViceKey == viceKey) + { + if (currentNode.Key == key) + { + isFind = true; + removeCur = currentNode; + currentCur = currentNode.Left; + break; + } + + currentNode = currentNode.Left; + } + + // 再向右查找下 + if (!isFind) + { + currentNode = cur.Right; + while (currentNode != null && currentNode.SortKey == sortKey && currentNode.ViceKey == viceKey) + { + if (currentNode.Key == key) + { + isFind = true; + removeCur = currentNode; + currentCur = currentNode.Left; + break; + } + + currentNode = currentNode.Right; + } + } + } + + if (isFind && currentCur != null) + { + value = removeCur.Value; + currentCur.Right = removeCur.Right; + + if (removeCur.Right != null) + { + removeCur.Right.Left = currentCur; + removeCur.Right = null; + } + + removeCur.Left = null; + removeCur.Down = null; + removeCur.Value = default; + + if (layer == 1) + { + var tempCur = currentCur.Right; + while (tempCur != null) + { + tempCur.Index--; + tempCur = tempCur.Right; + } + + Node.Remove(removeCur.Key); + } + + seen = true; + } + + cur = cur.Down; + } + + return seen; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableNode.cs b/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableNode.cs new file mode 100644 index 0000000..8ef19fe --- /dev/null +++ b/FantasyNetTest/NBC/Core/DataStructure/SkipTable/SkipTableNode.cs @@ -0,0 +1,68 @@ +namespace NBC.DataStructure.SkipTable +{ + /// + /// 跳跃表节点。 + /// + /// 节点的值的类型。 + public class SkipTableNode + { + /// + /// 节点在跳跃表中的索引。 + /// + public int Index; + /// + /// 节点的主键。 + /// + public long Key; + /// + /// 节点的排序键。 + /// + public long SortKey; + /// + /// 节点的副键。 + /// + public long ViceKey; + /// + /// 节点存储的值。 + /// + public TValue Value; + /// + /// 指向左侧节点的引用。 + /// + public SkipTableNode Left; + /// + /// 指向右侧节点的引用。 + /// + public SkipTableNode Right; + /// + /// 指向下一层节点的引用。 + /// + public SkipTableNode Down; + + /// + /// 初始化跳跃表节点的新实例。 + /// + /// 节点的排序键。 + /// 节点的副键。 + /// 节点的主键。 + /// 节点存储的值。 + /// 节点在跳跃表中的索引。 + /// 指向左侧节点的引用。 + /// 指向右侧节点的引用。 + /// 指向下一层节点的引用。 + public SkipTableNode(long sortKey, long viceKey, long key, TValue value, int index, + SkipTableNode l, + SkipTableNode r, + SkipTableNode d) + { + Left = l; + Right = r; + Down = d; + Value = value; + Key = key; + Index = index; + SortKey = sortKey; + ViceKey = viceKey; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLock.cs b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLock.cs new file mode 100644 index 0000000..9d5c819 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLock.cs @@ -0,0 +1,140 @@ +using System; +using System.Collections.Generic; +using NBC.Pool; + +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +namespace NBC.Async +{ + /// + /// 协程锁专用的对象池 + /// + public sealed class CoroutineLockPool : PoolCore + { + /// + /// 协程锁专用的对象池的构造函数 + /// + public CoroutineLockPool() : base(2000) { } + } + + /// + /// 协程锁 + /// + public sealed class CoroutineLock : IPool, IDisposable + { + private Scene _scene; + private CoroutineLockComponent _coroutineLockComponent; + private readonly Dictionary _queue = new Dictionary(); + /// + /// 表示是否是对象池中创建的 + /// + private bool _isPool; + /// + /// 协程锁的类型 + /// + public long CoroutineLockType { get; private set; } + + internal void Initialize(CoroutineLockComponent coroutineLockComponent, ref long coroutineLockType) + { + _scene = coroutineLockComponent.Scene; + CoroutineLockType = coroutineLockType; + _coroutineLockComponent = coroutineLockComponent; + } + /// + /// 销毁协程锁，如果调用了该方法，所有使用当前协程锁等待的逻辑会按照顺序释放锁。 + /// + public void Dispose() + { + foreach (var (_, coroutineLockQueue) in _queue) + { + while (TryCoroutineLockQueueDequeue(coroutineLockQueue)) { } + } + + _queue.Clear(); + _scene = null; + CoroutineLockType = 0; + _coroutineLockComponent = null; + } + /// + /// 等待上一个任务完成 + /// + /// 需要等待的Id + /// 用于查询协程锁的标记，可不传入，只有在超时的时候排查是哪个锁超时时使用 + /// 等待多久会超时，当到达设定的时候会把当前锁给按照超时处理 + /// + public async FTask Wait(long coroutineLockQueueKey, string tag = null, int timeOut = 30000) + { + var waitCoroutineLock = _coroutineLockComponent.WaitCoroutineLockPool.Rent(this, ref coroutineLockQueueKey, tag, timeOut); + + if (!_queue.TryGetValue(coroutineLockQueueKey, out var queue)) + { + queue = _coroutineLockComponent.CoroutineLockQueuePool.Rent(); + _queue.Add(coroutineLockQueueKey, queue); + return waitCoroutineLock; + } + + queue.Enqueue(waitCoroutineLock); + return await waitCoroutineLock.Tcs; + } + /// + /// 按照先入先出的顺序，释放最早的一个协程锁 + /// + /// + public void Release(long coroutineLockQueueKey) + { + if (!_queue.TryGetValue(coroutineLockQueueKey, out var coroutineLockQueue)) + { + return; + } + + if (!TryCoroutineLockQueueDequeue(coroutineLockQueue)) + { + _queue.Remove(coroutineLockQueueKey); + } + } + + private bool TryCoroutineLockQueueDequeue(CoroutineLockQueue coroutineLockQueue) + { + if (!coroutineLockQueue.TryDequeue(out var waitCoroutineLock)) + { + _coroutineLockComponent.CoroutineLockQueuePool.Return(coroutineLockQueue); + return false; + } + + if (waitCoroutineLock.TimerId != 0) + { + _scene.TimerComponent.Net.Remove(waitCoroutineLock.TimerId); + } + + try + { + // 放到下一帧执行,如果不这样会导致逻辑的顺序不正常。 + _scene.ThreadSynchronizationContext.Post(waitCoroutineLock.SetResult); + } + catch (Exception e) + { + Log.Error($"Error in disposing CoroutineLock: {e}"); + } + + return true; + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLock.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLock.cs.meta new file mode 100644 index 0000000..d67163d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLock.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: e2fe8fb8f49ad4565b47c840fb690d1f +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockComponent.cs b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockComponent.cs new file mode 100644 index 0000000..98efb31 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockComponent.cs @@ -0,0 +1,100 @@ +using System.Collections.Generic; +using NBC.Entitas; + +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. + +namespace NBC.Async +{ + /// + /// 协程锁组件 + /// + public class CoroutineLockComponent : Entity + { + private long _lockId; + private CoroutineLockPool _coroutineLockPool; + internal WaitCoroutineLockPool WaitCoroutineLockPool { get; private set; } + internal CoroutineLockQueuePool CoroutineLockQueuePool { get; private set; } + private readonly Dictionary _coroutineLocks = new Dictionary(); + internal CoroutineLockComponent Initialize() + { + _coroutineLockPool = new CoroutineLockPool(); + CoroutineLockQueuePool = new CoroutineLockQueuePool(); + WaitCoroutineLockPool = new WaitCoroutineLockPool(this); + return this; + } + + internal long LockId => ++_lockId; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + public override void Dispose() +#pragma warning restore CS1591 // Missing XML comment for publicly visible type or member + { + if (IsDisposed) + { + return; + } + + _lockId = 0; + base.Dispose(); + } + + /// + /// 创建一个新的协程锁 + /// 使用这个方法创建的协程锁，需要手动释放管理CoroutineLock。 + /// 不会再CoroutineLockComponent理进行管理。 + /// + /// + /// + public CoroutineLock Create(long coroutineLockType) + { + var coroutineLock = _coroutineLockPool.Rent(); + coroutineLock.Initialize(this, ref coroutineLockType); + return coroutineLock; + } + + /// + /// 请求一个协程锁。 + /// 使用这个方法创建的协程锁，会自动释放CoroutineLockQueueType。 + /// + /// 锁类型 + /// 锁队列Id + /// 当某些锁超时，需要一个标记来方便排查问题，正常的情况下这个默认为null就可以。 + /// 设置锁的超时时间，让超过设置的时间会触发超时，保证锁不会因为某一个锁一直不解锁导致卡住的问题。 + /// + /// 返回的WaitCoroutineLock通过Dispose来解除这个锁、建议用using来保住这个锁。 + /// 也可以返回的WaitCoroutineLock通过CoroutineLockComponent.UnLock来解除这个锁。 + /// + public FTask Wait(long coroutineLockType, long coroutineLockQueueKey, string tag = null, int time = 30000) + { + if (!_coroutineLocks.TryGetValue(coroutineLockType, out var coroutineLock)) + { + coroutineLock = _coroutineLockPool.Rent(); + coroutineLock.Initialize(this, ref coroutineLockType); + _coroutineLocks.Add(coroutineLockType, coroutineLock); + } + + return coroutineLock.Wait(coroutineLockQueueKey, tag, time); + } + + /// + /// 解除一个协程锁。 + /// + /// + /// + public void Release(int coroutineLockType, long coroutineLockQueueKey) + { + if (IsDisposed) + { + return; + } + + if (!_coroutineLocks.TryGetValue(coroutineLockType, out var coroutineLock)) + { + return; + } + + coroutineLock.Release(coroutineLockQueueKey); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockComponent.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockComponent.cs.meta new file mode 100644 index 0000000..c4a03b1 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockComponent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 8abfde11ad4d344eda0bf16b249a0dae +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockQueue.cs b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockQueue.cs new file mode 100644 index 0000000..808cfad --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockQueue.cs @@ -0,0 +1,35 @@ +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +using System.Collections.Generic; +using NBC.Pool; + +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +namespace NBC.Async +{ + internal sealed class CoroutineLockQueuePool : PoolCore + { + public CoroutineLockQueuePool() : base(2000) { } + } + + internal sealed class CoroutineLockQueue : Queue, IPool + { + private bool _isPool; + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockQueue.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockQueue.cs.meta new file mode 100644 index 0000000..1e55b8c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/CoroutineLockQueue.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: c1a15c49a7b7b488c8aac3d7720d506e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/WaitCoroutineLock.cs b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/WaitCoroutineLock.cs new file mode 100644 index 0000000..1e179b1 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/WaitCoroutineLock.cs @@ -0,0 +1,146 @@ +using System; +using NBC.Event; +using NBC.Pool; + +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +namespace NBC.Async +{ + internal sealed class WaitCoroutineLockPool : PoolCore + { + private readonly Scene _scene; + private readonly CoroutineLockComponent _coroutineLockComponent; + + public WaitCoroutineLockPool(CoroutineLockComponent coroutineLockComponent) : base(2000) + { + _scene = coroutineLockComponent.Scene; + _coroutineLockComponent = coroutineLockComponent; + } + + public WaitCoroutineLock Rent(CoroutineLock coroutineLock, ref long coroutineLockQueueKey, string tag = null, int timeOut = 30000) + { + var timerId = 0L; + var lockId = _coroutineLockComponent.LockId; + var waitCoroutineLock = _coroutineLockComponent.WaitCoroutineLockPool.Rent(); + + if (timeOut > 0) + { + timerId = _scene.TimerComponent.Net.OnceTimer(timeOut, new CoroutineLockTimeout(ref lockId, waitCoroutineLock)); + } + + waitCoroutineLock.Initialize(coroutineLock, this, ref coroutineLockQueueKey, ref timerId, ref lockId, tag); + return waitCoroutineLock; + } + } + + internal struct CoroutineLockTimeout + { + public readonly long LockId; + public readonly WaitCoroutineLock WaitCoroutineLock; + + public CoroutineLockTimeout(ref long lockId, WaitCoroutineLock waitCoroutineLock) + { + LockId = lockId; + WaitCoroutineLock = waitCoroutineLock; + } + } + + internal sealed class OnCoroutineLockTimeout : EventSystem + { + protected override void Handler(CoroutineLockTimeout self) + { + var selfWaitCoroutineLock = self.WaitCoroutineLock; + + if (self.LockId != selfWaitCoroutineLock.LockId) + { + return; + } + + Log.Error($"coroutine lock timeout CoroutineLockQueueType:{selfWaitCoroutineLock.CoroutineLock.CoroutineLockType} Key:{selfWaitCoroutineLock.CoroutineLockQueueKey} Tag:{selfWaitCoroutineLock.Tag}"); + } + } + + /// + /// 一个协程锁的实例，用户可以用过这个手动释放锁 + /// + public sealed class WaitCoroutineLock : IPool, IDisposable + { + private bool _isPool; + internal string Tag { get; private set; } + internal long LockId { get; private set; } + internal long TimerId { get; private set; } + internal long CoroutineLockQueueKey { get; private set; } + internal CoroutineLock CoroutineLock { get; private set; } + + private bool _isSetResult; + private FTask _tcs; + private WaitCoroutineLockPool _waitCoroutineLockPool; + internal void Initialize(CoroutineLock coroutineLock, WaitCoroutineLockPool waitCoroutineLockPool, ref long coroutineLockQueueKey, ref long timerId, ref long lockId, string tag) + { + Tag = tag; + LockId = lockId; + TimerId = timerId; + CoroutineLock = coroutineLock; + CoroutineLockQueueKey = coroutineLockQueueKey; + _waitCoroutineLockPool = waitCoroutineLockPool; + } + /// + /// 释放协程锁 + /// + public void Dispose() + { + if (LockId == 0) + { + Log.Error("WaitCoroutineLock is already disposed"); + return; + } + + CoroutineLock.Release(CoroutineLockQueueKey); + + _tcs = null; + Tag = null; + LockId = 0; + TimerId = 0; + _isSetResult = false; + CoroutineLockQueueKey = 0; + _waitCoroutineLockPool.Return(this); + CoroutineLock = null; + _waitCoroutineLockPool = null; + } + + internal FTask Tcs + { + get { return _tcs ??= FTask.Create(); } + } + + internal void SetResult() + { + if (_isSetResult) + { + Log.Error("WaitCoroutineLock is already SetResult"); + return; + } + + _isSetResult = true; + Tcs.SetResult(this); + } + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/WaitCoroutineLock.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/WaitCoroutineLock.cs.meta new file mode 100644 index 0000000..9aa7508 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/CoroutineLock/WaitCoroutineLock.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: c6d5307f677ba48f891c12ac183a0128 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/EntityComponent.cs b/FantasyNetTest/NBC/Core/Entitas/Component/EntityComponent.cs new file mode 100644 index 0000000..eb3b4c7 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/EntityComponent.cs @@ -0,0 +1,472 @@ +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +using System; +using System.Collections.Generic; +using System.Diagnostics.CodeAnalysis; +using System.Runtime.InteropServices; +using NBC.Entitas; +using NBC.Assembly; +using NBC.Async; +using NBC.DataStructure.Collection; +using NBC.Entitas.Interface; +using NBC.Helper; + +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8765 // Nullability of type of parameter doesn't match overridden member (possibly because of nullability attributes). + +#pragma warning disable CS8604 // Possible null reference argument. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace NBC.Entitas +{ + internal sealed class UpdateQueueInfo + { + public bool IsStop; + public readonly Type Type; + public readonly long RunTimeId; + + public UpdateQueueInfo(Type type, long runTimeId) + { + Type = type; + IsStop = false; + RunTimeId = runTimeId; + } + } + + internal sealed class FrameUpdateQueueInfo + { + public readonly Type Type; + public readonly long RunTimeId; + + public FrameUpdateQueueInfo(Type type, long runTimeId) + { + Type = type; + RunTimeId = runTimeId; + } + } + + internal struct CustomEntitiesSystemKey : IEquatable + { + public int CustomEventType { get; } + public Type EntitiesType { get; } + public CustomEntitiesSystemKey(int customEventType, Type entitiesType) + { + CustomEventType = customEventType; + EntitiesType = entitiesType; + } + public bool Equals(CustomEntitiesSystemKey other) + { + return CustomEventType == other.CustomEventType && EntitiesType == other.EntitiesType; + } + + public override bool Equals(object obj) + { + return obj is CustomEntitiesSystemKey other && Equals(other); + } + + public override int GetHashCode() + { + return HashCode.Combine(CustomEventType, EntitiesType); + } + } + + /// + /// Entity管理组件 + /// + public sealed class EntityComponent : Entity, ISceneUpdate, IAssembly + { + private readonly OneToManyList _assemblyList = new(); + private readonly OneToManyList _assemblyHashCodes = new(); + + private readonly Dictionary _awakeSystems = new(); + private readonly Dictionary _updateSystems = new(); + private readonly Dictionary _destroySystems = new(); + private readonly Dictionary _deserializeSystems = new(); + private readonly Dictionary _frameUpdateSystem = new(); + + private readonly OneToManyList _assemblyCustomSystemList = new(); + private readonly Dictionary _customEntitiesSystems = new Dictionary(); + + private readonly Dictionary _hashCodes = new Dictionary(); + private readonly Queue _updateQueue = new Queue(); + private readonly Queue _frameUpdateQueue = new Queue(); + private readonly Dictionary _updateQueueDic = new Dictionary(); + + internal async FTask Initialize() + { + await AssemblySystem.Register(this); + return this; + } + + #region Assembly + + public FTask Load(long assemblyIdentity) + { + var task = FTask.Create(false); + Scene?.ThreadSynchronizationContext.Post(() => + { + LoadInner(assemblyIdentity); + task.SetResult(); + }); + return task; + } + + public FTask ReLoad(long assemblyIdentity) + { + var task = FTask.Create(false); + Scene?.ThreadSynchronizationContext.Post(() => + { + OnUnLoadInner(assemblyIdentity); + LoadInner(assemblyIdentity); + task.SetResult(); + }); + + return task; + } + + public FTask OnUnLoad(long assemblyIdentity) + { + var task = FTask.Create(false); + Scene?.ThreadSynchronizationContext.Post(() => + { + OnUnLoadInner(assemblyIdentity); + task.SetResult(); + }); + return task; + } + + private void LoadInner(long assemblyIdentity) + { + foreach (var entityType in AssemblySystem.ForEach(assemblyIdentity, typeof(IEntity))) + { + _hashCodes.Add(entityType, HashCodeHelper.ComputeHash64(entityType.FullName)); + _assemblyHashCodes.Add(assemblyIdentity, entityType); + } + + foreach (var entitiesSystemType in AssemblySystem.ForEach(assemblyIdentity, typeof(IEntitiesSystem))) + { + Type entitiesType = null; + var entity = Activator.CreateInstance(entitiesSystemType); + + switch (entity) + { + case IAwakeSystem iAwakeSystem: + { + entitiesType = iAwakeSystem.EntitiesType(); + _awakeSystems.Add(entitiesType, iAwakeSystem); + break; + } + case IDestroySystem iDestroySystem: + { + entitiesType = iDestroySystem.EntitiesType(); + _destroySystems.Add(entitiesType, iDestroySystem); + break; + } + case IDeserializeSystem iDeserializeSystem: + { + entitiesType = iDeserializeSystem.EntitiesType(); + _deserializeSystems.Add(entitiesType, iDeserializeSystem); + break; + } + case IUpdateSystem iUpdateSystem: + { + entitiesType = iUpdateSystem.EntitiesType(); + _updateSystems.Add(entitiesType, iUpdateSystem); + break; + } + case IFrameUpdateSystem iFrameUpdateSystem: + { + entitiesType = iFrameUpdateSystem.EntitiesType(); + _frameUpdateSystem.Add(entitiesType, iFrameUpdateSystem); + break; + } + default: + { + Log.Error($"IEntitiesSystem not support type {entitiesSystemType}"); + return; + } + } + + _assemblyList.Add(assemblyIdentity, entitiesType); + } + + foreach (var customEntitiesSystemType in AssemblySystem.ForEach(assemblyIdentity, typeof(ICustomEntitiesSystem))) + { + var entity = (ICustomEntitiesSystem)Activator.CreateInstance(customEntitiesSystemType); + var customEntitiesSystemKey = new CustomEntitiesSystemKey(entity.CustomEventType, entity.EntitiesType()); + _customEntitiesSystems.Add(customEntitiesSystemKey, entity); + _assemblyCustomSystemList.Add(assemblyIdentity, customEntitiesSystemKey); + } + } + + private void OnUnLoadInner(long assemblyIdentity) + { + if (_assemblyHashCodes.TryGetValue(assemblyIdentity, out var entityType)) + { + foreach (var type in entityType) + { + _hashCodes.Remove(type); + } + + _assemblyHashCodes.RemoveByKey(assemblyIdentity); + } + + if (_assemblyList.TryGetValue(assemblyIdentity, out var assembly)) + { + foreach (var type in assembly) + { + _awakeSystems.Remove(type); + _updateSystems.Remove(type); + _destroySystems.Remove(type); + _deserializeSystems.Remove(type); + _frameUpdateSystem.Remove(type); + } + + _assemblyList.RemoveByKey(assemblyIdentity); + } + + if (_assemblyCustomSystemList.TryGetValue(assemblyIdentity, out var customSystemAssembly)) + { + foreach (var customEntitiesSystemKey in customSystemAssembly) + { + _customEntitiesSystems.Remove(customEntitiesSystemKey); + } + + _assemblyCustomSystemList.RemoveByKey(assemblyIdentity); + } + } + + #endregion + + #region Event + + /// + /// 触发实体的唤醒方法 + /// + /// 实体对象 + public void Awake(Entity entity) + { + if (!_awakeSystems.TryGetValue(entity.Type, out var awakeSystem)) + { + return; + } + + try + { + awakeSystem.Invoke(entity); + } + catch (Exception e) + { + Log.Error($"{entity.Type.FullName} Error {e}"); + } + } + + /// + /// 触发实体的销毁方法 + /// + /// 实体对象 + public void Destroy(Entity entity) + { + if (!_destroySystems.TryGetValue(entity.Type, out var system)) + { + return; + } + + try + { + system.Invoke(entity); + } + catch (Exception e) + { + Log.Error($"{entity.Type.FullName} Destroy Error {e}"); + } + } + + /// + /// 触发实体的反序列化方法 + /// + /// 实体对象 + public void Deserialize(Entity entity) + { + if (!_deserializeSystems.TryGetValue(entity.Type, out var system)) + { + return; + } + + try + { + system.Invoke(entity); + } + catch (Exception e) + { + Log.Error($"{entity.Type.FullName} Deserialize Error {e}"); + } + } + + #endregion + + #region CustomEvent + + public void CustomSystem(Entity entity, int customEventType) + { + var customEntitiesSystemKey = new CustomEntitiesSystemKey(customEventType, entity.Type); + + if (!_customEntitiesSystems.TryGetValue(customEntitiesSystemKey, out var system)) + { + return; + } + + try + { + system.Invoke(entity); + } + catch (Exception e) + { + Log.Error($"{entity.Type.FullName} CustomSystem Error {e}"); + } + } + + #endregion + + #region Update + + /// + /// 将实体加入更新队列，准备进行更新 + /// + /// 实体对象 + public void StartUpdate(Entity entity) + { + var type = entity.Type; + var entityRuntimeId = entity.RuntimeId; + + if (_updateSystems.ContainsKey(type)) + { + var updateQueueInfo = new UpdateQueueInfo(type, entityRuntimeId); + _updateQueue.Enqueue(updateQueueInfo); + _updateQueueDic.Add(entityRuntimeId, updateQueueInfo); + } + + if (_frameUpdateSystem.ContainsKey(type)) + { + _frameUpdateQueue.Enqueue(new FrameUpdateQueueInfo(type, entityRuntimeId)); + } + } + + /// + /// 停止实体进行更新 + /// + /// 实体对象 + public void StopUpdate(Entity entity) + { + if (!_updateQueueDic.Remove(entity.RuntimeId, out var updateQueueInfo)) + { + return; + } + + updateQueueInfo.IsStop = true; + } + + /// + /// 执行实体系统的更新逻辑 + /// + public void Update() + { + var updateQueueCount = _updateQueue.Count; + + while (updateQueueCount-- > 0) + { + var updateQueueStruct = _updateQueue.Dequeue(); + + if (updateQueueStruct.IsStop) + { + continue; + } + + if (!_updateSystems.TryGetValue(updateQueueStruct.Type, out var updateSystem)) + { + continue; + } + + var entity = Scene.GetEntity(updateQueueStruct.RunTimeId); + + if (entity == null || entity.IsDisposed) + { + _updateQueueDic.Remove(updateQueueStruct.RunTimeId); + continue; + } + + _updateQueue.Enqueue(updateQueueStruct); + + try + { + updateSystem.Invoke(entity); + } + catch (Exception e) + { + Log.Error($"{updateQueueStruct.Type.FullName} Update Error {e}"); + } + } + } + + /// + /// 执行实体系统的帧更新逻辑 + /// + public void FrameUpdate() + { + var count = _frameUpdateQueue.Count; + + while (count-- > 0) + { + var frameUpdateQueueStruct = _frameUpdateQueue.Dequeue(); + + if (!_frameUpdateSystem.TryGetValue(frameUpdateQueueStruct.Type, out var frameUpdateSystem)) + { + continue; + } + + var entity = Scene.GetEntity(frameUpdateQueueStruct.RunTimeId); + + if (entity == null || entity.IsDisposed) + { + continue; + } + + _frameUpdateQueue.Enqueue(frameUpdateQueueStruct); + + try + { + frameUpdateSystem.Invoke(entity); + } + catch (Exception e) + { + Log.Error($"{frameUpdateQueueStruct.Type.FullName} FrameUpdate Error {e}"); + } + } + } + + #endregion + + public long GetHashCode(Type type) + { + return _hashCodes[type]; + } + + /// + /// 释放实体系统管理器资源 + /// + public override void Dispose() + { + _updateQueue.Clear(); + _frameUpdateQueue.Clear(); + + _assemblyList.Clear(); + _awakeSystems.Clear(); + _updateSystems.Clear(); + _destroySystems.Clear(); + _deserializeSystems.Clear(); + _frameUpdateSystem.Clear(); + + AssemblySystem.UnRegister(this); + base.Dispose(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/EventComponent.cs b/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/EventComponent.cs new file mode 100644 index 0000000..9ffed0b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/EventComponent.cs @@ -0,0 +1,255 @@ +using System; +using System.Reflection; +using NBC.Assembly; +using NBC.Async; +using NBC.DataStructure.Collection; +using NBC.Entitas; + +// ReSharper disable PossibleMultipleEnumeration +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +// ReSharper disable MethodOverloadWithOptionalParameter + +namespace NBC.Event +{ + internal sealed class EventCache + { + public readonly Type EnventType; + public readonly object Obj; + public EventCache(Type enventType, object obj) + { + EnventType = enventType; + Obj = obj; + } + } + + public sealed class EventComponent : Entity, IAssembly + { + private readonly OneToManyList _events = new(); + private readonly OneToManyList _asyncEvents = new(); + private readonly OneToManyList _assemblyEvents = new(); + private readonly OneToManyList _assemblyAsyncEvents = new(); + + internal async FTask Initialize() + { + await AssemblySystem.Register(this); + return this; + } + + #region Assembly + + public async FTask Load(long assemblyIdentity) + { + var tcs = FTask.Create(false); + Scene?.ThreadSynchronizationContext.Post(() => + { + LoadInner(assemblyIdentity); + tcs.SetResult(); + }); + await tcs; + } + + public async FTask ReLoad(long assemblyIdentity) + { + var tcs = FTask.Create(false); + Scene?.ThreadSynchronizationContext.Post(() => + { + OnUnLoadInner(assemblyIdentity); + LoadInner(assemblyIdentity); + tcs.SetResult(); + }); + await tcs; + } + + public async FTask OnUnLoad(long assemblyIdentity) + { + var tcs = FTask.Create(false); + Scene?.ThreadSynchronizationContext.Post(() => + { + OnUnLoadInner(assemblyIdentity); + tcs.SetResult(); + }); + await tcs; + } + + private void LoadInner(long assemblyIdentity) + { + + foreach (var type in AssemblySystem.ForEach(assemblyIdentity, typeof(IEvent))) + { + var @event = (IEvent)Activator.CreateInstance(type); + + if (@event == null) + { + continue; + } + + var eventType = @event.EventType(); + _events.Add(eventType, @event); + _assemblyEvents.Add(assemblyIdentity, new EventCache(eventType, @event)); + } + _events.SortAll(); + + foreach (var type in AssemblySystem.ForEach(assemblyIdentity, typeof(IAsyncEvent))) + { + var @event = (IAsyncEvent)Activator.CreateInstance(type); + + if (@event == null) + { + continue; + } + + var eventType = @event.EventType(); + _asyncEvents.Add(eventType, @event); + _assemblyAsyncEvents.Add(assemblyIdentity, new EventCache(eventType, @event)); + } + _asyncEvents.SortAll(); + } + + private void OnUnLoadInner(long assemblyIdentity) + { + if (_assemblyEvents.TryGetValue(assemblyIdentity, out var events)) + { + foreach (var @event in events) + { + _events.RemoveValue(@event.EnventType, (IEvent)@event.Obj); + } + + _assemblyEvents.RemoveByKey(assemblyIdentity); + } + + if (_assemblyAsyncEvents.TryGetValue(assemblyIdentity, out var asyncEvents)) + { + foreach (var @event in asyncEvents) + { + _asyncEvents.RemoveValue(@event.EnventType, (IAsyncEvent)@event.Obj); + } + + _assemblyAsyncEvents.RemoveByKey(assemblyIdentity); + } + } + + #endregion + + #region Publish + + /// + /// 发布一个值类型的事件数据。 + /// + /// 事件数据类型（值类型）。 + /// 事件数据实例。 + public void Publish(TEventData eventData) where TEventData : struct + { + if (!_events.TryGetValue(typeof(TEventData), out var list)) + { + return; + } + + foreach (var @event in list) + { + try + { + @event.Invoke(eventData); + } + catch (Exception e) + { + Log.Error(e); + } + } + } + + /// + /// 发布一个继承自 Entity 的事件数据。 + /// + /// 事件数据类型（继承自 Entity）。 + /// 事件数据实例。 + /// 是否释放事件数据。 + public void Publish(TEventData eventData, bool isDisposed = true) where TEventData : Entity + { + if (!_events.TryGetValue(typeof(TEventData), out var list)) + { + return; + } + + foreach (var @event in list) + { + try + { + @event.Invoke(eventData); + } + catch (Exception e) + { + Log.Error(e); + } + } + + if (isDisposed) + { + eventData.Dispose(); + } + } + + /// + /// 异步发布一个值类型的事件数据。 + /// + /// 事件数据类型（值类型）。 + /// 事件数据实例。 + /// 表示异步操作的任务。 + public async FTask PublishAsync(TEventData eventData) where TEventData : struct + { + if (!_asyncEvents.TryGetValue(typeof(TEventData), out var list)) + { + return; + } + + using var tasks = ListPool.Create(); + + foreach (var @event in list) + { + tasks.Add(@event.InvokeAsync(eventData)); + } + + await FTask.WaitAll(tasks); + } + + /// + /// 异步发布一个继承自 Entity 的事件数据。 + /// + /// 事件数据类型（继承自 Entity）。 + /// 事件数据实例。 + /// 是否释放事件数据。 + /// 表示异步操作的任务。 + public async FTask PublishAsync(TEventData eventData, bool isDisposed = true) where TEventData : Entity + { + if (!_asyncEvents.TryGetValue(eventData.GetType(), out var list)) + { + return; + } + + using var tasks = ListPool.Create(); + + foreach (var @event in list) + { + tasks.Add(@event.InvokeAsync(eventData)); + } + + await FTask.WaitAll(tasks); + + if (isDisposed) + { + eventData.Dispose(); + } + } + + #endregion + + public override void Dispose() + { + _events.Clear(); + _asyncEvents.Clear(); + _assemblyEvents.Clear(); + _assemblyAsyncEvents.Clear(); + base.Dispose(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/EventComponent.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/EventComponent.cs.meta new file mode 100644 index 0000000..ac84806 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/EventComponent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: bc6c3f6b01eb14a35934175e36eeb544 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface.meta b/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface.meta new file mode 100644 index 0000000..af3d4b8 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 10dcbb383d66a4915b44d6f20331a7bf +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface/IEvent.cs b/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface/IEvent.cs new file mode 100644 index 0000000..9fa68a0 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface/IEvent.cs @@ -0,0 +1,112 @@ +using System; +using NBC.Async; + +namespace NBC.Event +{ + /// + /// 事件的接口 + /// + public interface IEvent + { + /// + /// 用于指定事件的Type + /// + /// + Type EventType(); + /// + /// 时间内部使用的入口 + /// + /// + void Invoke(object self); + } + + /// + /// 异步事件的接口 + /// + public interface IAsyncEvent + { + /// + /// + /// + /// + Type EventType(); + /// + /// + /// + /// + FTask InvokeAsync(object self); + } + + /// + /// 事件的抽象类，要使用事件必须要继承这个抽象接口。 + /// + /// 要监听的事件泛型类型 + public abstract class EventSystem : IEvent + { + private readonly Type _selfType = typeof(T); + /// + /// + /// + /// + public Type EventType() + { + return _selfType; + } + /// + /// 事件调用的方法，要在这个方法里编写事件发生的逻辑 + /// + /// + protected abstract void Handler(T self); + /// + /// + /// + /// + public void Invoke(object self) + { + try + { + Handler((T) self); + } + catch (Exception e) + { + Log.Error($"{_selfType.Name} Error {e}"); + } + } + } + /// + /// 异步事件的抽象类，要使用事件必须要继承这个抽象接口。 + /// + /// 要监听的事件泛型类型 + public abstract class AsyncEventSystem : IAsyncEvent + { + private readonly Type _selfType = typeof(T); + /// + /// + /// + /// + public Type EventType() + { + return _selfType; + } + /// + /// 事件调用的方法，要在这个方法里编写事件发生的逻辑 + /// + /// + protected abstract FTask Handler(T self); + /// + /// + /// + /// + public async FTask InvokeAsync(object self) + { + try + { + await Handler((T) self); + } + catch (Exception e) + { + Log.Error($"{_selfType.Name} Error {e}"); + } + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface/IEvent.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface/IEvent.cs.meta new file mode 100644 index 0000000..5811d14 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/EventComponent/Interface/IEvent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 1e46ad748051f4277a8f660fa842b19d +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/MessagePoolComponent.cs b/FantasyNetTest/NBC/Core/Entitas/Component/MessagePoolComponent.cs new file mode 100644 index 0000000..9da08e8 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/MessagePoolComponent.cs @@ -0,0 +1,139 @@ +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract + +using System; +using System.Collections.Generic; +using System.Runtime.CompilerServices; +using NBC.Entitas; +using NBC.DataStructure.Collection; +using NBC.Pool; +using NBC.Serialize; + +namespace NBC.Entitas +{ + /// + /// 消息的对象池组件 + /// + public sealed class MessagePoolComponent : Entity + { + private int _poolCount; + private const int MaxCapacity = ushort.MaxValue; + private readonly OneToManyQueue _poolQueue = new OneToManyQueue(); + private readonly Dictionary> _typeCheckCache = new Dictionary>(); + /// + /// 销毁组件 + /// + public override void Dispose() + { + _poolCount = 0; + _poolQueue.Clear(); + _typeCheckCache.Clear(); + base.Dispose(); + } + /// + /// 从对象池里获取一个消息，如果没有就创建一个新的 + /// + /// 消息的泛型类型 + /// + public T Rent() where T : AMessage, new() + { + if (!_poolQueue.TryDequeue(typeof(T), out var queue)) + { + var instance = new T(); + instance.SetScene(Scene); + instance.SetIsPool(true); + return instance; + } + + queue.SetIsPool(true); + _poolCount--; + return (T)queue; + } + + /// + /// + /// + /// 消息的类型 + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public AMessage Rent(Type type) + { + if (!_poolQueue.TryDequeue(type, out var queue)) + { + if (!_typeCheckCache.TryGetValue(type, out var createInstance)) + { + if (!typeof(AMessage).IsAssignableFrom(type)) + { + throw new NotSupportedException($"{this.GetType().FullName} Type:{type.FullName} must inherit from IPool"); + } + else + { + createInstance = CreateInstance.CreateMessage(type); + _typeCheckCache[type] = createInstance; + } + } + + var instance = createInstance(); + instance.SetScene(Scene); + instance.SetIsPool(true); + return instance; + } + + queue.SetIsPool(true); + _poolCount--; + return queue; + } + /// + /// 返还一个消息到对象池中 + /// + /// + public void Return(AMessage obj) + { + if (obj == null) + { + return; + } + + if (!obj.IsPool()) + { + return; + } + + if (_poolCount >= MaxCapacity) + { + return; + } + + _poolCount++; + obj.SetIsPool(false); + _poolQueue.Enqueue(obj.GetType(), obj); + } + + /// + /// + /// + /// 返还的消息 + /// 返还的消息泛型类型 + public void Return(T obj) where T : AMessage + { + if (obj == null) + { + return; + } + + if (!obj.IsPool()) + { + return; + } + + if (_poolCount >= MaxCapacity) + { + return; + } + + _poolCount++; + obj.SetIsPool(false); + _poolQueue.Enqueue(typeof(T), obj); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/Interface/TimerHandler.cs b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/Interface/TimerHandler.cs new file mode 100644 index 0000000..589dd6c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/Interface/TimerHandler.cs @@ -0,0 +1,10 @@ +using NBC.Event; + +namespace NBC +{ + /// + /// 计时器抽象类，提供了一个基础框架，用于创建处理计时器事件的具体类。 + /// + /// 事件的类型参数 + public abstract class TimerHandler : EventSystem { } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/Interface/TimerHandler.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/Interface/TimerHandler.cs.meta new file mode 100644 index 0000000..cab3f9c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/Interface/TimerHandler.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 0bb411c4d246b43aba54eb60b7654492 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerAction.cs b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerAction.cs new file mode 100644 index 0000000..00afa8b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerAction.cs @@ -0,0 +1,27 @@ +using System; +using System.Runtime.InteropServices; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8625 +#pragma warning disable CS8618 + +namespace NBC +{ + [StructLayout(LayoutKind.Sequential, Pack = 1)] + public struct TimerAction + { + public long TimerId; + public long StartTime; + public long TriggerTime; + public readonly object Callback; + public readonly TimerType TimerType; + public TimerAction(long timerId, TimerType timerType, long startTime, long triggerTime, object callback) + { + TimerId = timerId; + Callback = callback; + TimerType = timerType; + StartTime = startTime; + TriggerTime = triggerTime; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerComponent.cs b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerComponent.cs new file mode 100644 index 0000000..b41333e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerComponent.cs @@ -0,0 +1,45 @@ +// ReSharper disable ForCanBeConvertedToForeach + +using NBC.Entitas; +using NBC.Entitas.Interface; +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +using UnityEngine; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace NBC +{ + public sealed class TimerComponentUpdateSystem : UpdateSystem + { + protected override void Update(TimerComponent self) + { + self.Update(); + } + } + + /// + /// 时间调度组件 + /// + public sealed class TimerComponent : Entity + { + /// + /// 使用系统时间创建的计时器核心。 + /// + public TimerSchedulerNet Net { get; private set; } + + /// + /// 使用 Unity 时间创建的计时器核心。 + /// + public TimerSchedulerNetUnity Unity { get; private set; } + + internal TimerComponent Initialize() + { + Net = new TimerSchedulerNet(Scene); + Unity = new TimerSchedulerNetUnity(Scene); + return this; + } + public void Update() + { + Net.Update(); + Unity.Update(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerScheduler/TimerSchedulerNet.cs b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerScheduler/TimerSchedulerNet.cs new file mode 100644 index 0000000..32fe00d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerScheduler/TimerSchedulerNet.cs @@ -0,0 +1,383 @@ +using System; +using System.Collections.Generic; +using NBC.Async; +using NBC.DataStructure.Collection; +using NBC.Helper; + +// ReSharper disable UnusedParameter.Global + +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. + +namespace NBC +{ + /// + /// 基于系统事件的任务调度系统 + /// + public sealed class TimerSchedulerNet + { + private readonly Scene _scene; + private long _idGenerator; + private long _minTime; // 最小时间 + private readonly Queue _timeOutTime = new Queue(); + private readonly Queue _timeOutTimerIds = new Queue(); + private readonly Dictionary _timerActions = new Dictionary(); + private readonly SortedOneToManyList _timeId = new(); // 时间与计时器ID的有序一对多列表 + private long GetId => ++_idGenerator; + /// + /// 构造函数 + /// + /// 当前的Scene + public TimerSchedulerNet(Scene scene) + { + _scene = scene; + } + + private long Now() + { + return TimeHelper.Now; + } + + /// + /// 驱动方法，只有调用这个方法任务系统才会正常运转。 + /// + public void Update() + { + if (_timeId.Count == 0) + { + return; + } + + var currentTime = Now(); + + if (currentTime < _minTime) + { + return; + } + + // 遍历时间ID列表，查找超时的计时器任务 + foreach (var (key, _) in _timeId) + { + if (key > currentTime) + { + _minTime = key; + break; + } + + _timeOutTime.Enqueue(key); + } + + // 处理超时的计时器任务 + while (_timeOutTime.TryDequeue(out var time)) + { + var timerIds = _timeId[time]; + for (var i = 0; i < timerIds.Count; ++i) + { + _timeOutTimerIds.Enqueue(timerIds[i]); + } + + _timeId.Remove(time); + // _timeId.RemoveKey(time); + } + + if (_timeId.Count == 0) + { + _minTime = long.MaxValue; + } + + // 执行超时的计时器任务的回调操作 + while (_timeOutTimerIds.TryDequeue(out var timerId)) + { + if (!_timerActions.Remove(timerId, out var timerAction)) + { + continue; + } + + // 根据计时器类型执行不同的操作 + switch (timerAction.TimerType) + { + case TimerType.OnceWaitTimer: + { + var tcs = (FTask)timerAction.Callback; + tcs.SetResult(true); + break; + } + case TimerType.OnceTimer: + { + if (timerAction.Callback is not Action action) + { + Log.Error($"timerAction {timerAction.ToJson()}"); + break; + } + + action(); + break; + } + case TimerType.RepeatedTimer: + { + if (timerAction.Callback is not Action action) + { + Log.Error($"timerAction {timerAction.ToJson()}"); + break; + } + + timerAction.StartTime = Now(); + AddTimer(ref timerAction); + action(); + break; + } + } + } + } + + private void AddTimer(ref TimerAction timer) + { + var tillTime = timer.StartTime + timer.TriggerTime; + _timeId.Add(tillTime, timer.TimerId); + _timerActions.Add(timer.TimerId, timer); + + if (tillTime < _minTime) + { + _minTime = tillTime; + } + } + + /// + /// 异步等待指定时间。 + /// + /// 等待的时间长度。 + /// 取消令牌。 + /// 等待是否成功。 + public async FTask WaitAsync(long time, FCancellationToken cancellationToken = null) + { + if (time <= 0) + { + return true; + } + + var now = Now(); + var timerId = GetId; + var tcs = FTask.Create(); + var timerAction = new TimerAction(timerId, TimerType.OnceWaitTimer, now, time, tcs); + + void CancelActionVoid() + { + if (Remove(timerId)) + { + tcs.SetResult(false); + } + } + + bool result; + + try + { + cancellationToken?.Add(CancelActionVoid); + AddTimer(ref timerAction); + result = await tcs; + } + finally + { + cancellationToken?.Remove(CancelActionVoid); + } + + return result; + } + + /// + /// 异步等待直到指定时间。 + /// + /// 等待的目标时间。 + /// 取消令牌。 + /// 等待是否成功。 + public async FTask WaitTillAsync(long tillTime, FCancellationToken cancellationToken = null) + { + var now = Now(); + + if (now >= tillTime) + { + return true; + } + + var timerId = GetId; + var tcs = FTask.Create(); + var timerAction = new TimerAction(timerId, TimerType.OnceWaitTimer, now, tillTime - now, tcs); + + void CancelActionVoid() + { + if (Remove(timerId)) + { + tcs.SetResult(false); + } + } + + bool result; + + try + { + cancellationToken?.Add(CancelActionVoid); + AddTimer(ref timerAction); + result = await tcs; + } + finally + { + cancellationToken?.Remove(CancelActionVoid); + } + + return result; + } + + /// + /// 异步等待一帧时间。 + /// + /// 等待是否成功。 + public async FTask WaitFrameAsync() + { + await WaitAsync(1); + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间 + /// + /// 计时器执行的目标时间。 + /// 计时器回调方法。 + /// + public long OnceTimer(long time, Action action) + { + var now = Now(); + var timerId = GetId; + var timerAction = new TimerAction(timerId, TimerType.OnceTimer, now, time, action); + AddTimer(ref timerAction); + return timerId; + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间。 + /// + /// 计时器执行的目标时间。 + /// 计时器回调方法。 + /// 计时器的 ID。 + public long OnceTillTimer(long tillTime, Action action) + { + var now = Now(); + + if (tillTime < now) + { + Log.Error($"new once time too small tillTime:{tillTime} Now:{now}"); + } + + var timerId = GetId; + var timerAction = new TimerAction(timerId, TimerType.OnceTimer, now, tillTime - now, action); + AddTimer(ref timerAction); + return timerId; + } + + /// + /// 创建一个只执行一次的计时器，用于发布指定类型的事件。 + /// + /// 事件类型。 + /// 计时器执行的延迟时间。 + /// 事件处理器类型。 + /// 计时器的 ID。 + public long OnceTimer(long time, T timerHandlerType) where T : struct + { + void OnceTimerVoid() + { + _scene.EventComponent.Publish(timerHandlerType); + } + + return OnceTimer(time, OnceTimerVoid); + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间，用于发布指定类型的事件。 + /// + /// 事件类型。 + /// 计时器执行的目标时间。 + /// 事件处理器类型。 + /// 计时器的 ID。 + public long OnceTillTimer(long tillTime, T timerHandlerType) where T : struct + { + void OnceTillTimerVoid() + { + _scene.EventComponent.Publish(timerHandlerType); + } + + return OnceTillTimer(tillTime, OnceTillTimerVoid); + } + + /// + /// 创建一个帧任务 + /// + /// + /// + public long FrameTimer(Action action) + { + return RepeatedTimerInner(0, action); + } + + /// + /// 创建一个重复执行的计时器。 + /// + /// 计时器重复间隔的时间。 + /// 计时器回调方法。 + /// 计时器的 ID。 + public long RepeatedTimer(long time, Action action) + { + if (time < 0) + { + Log.Error($"time too small: {time}"); + return 0; + } + + return RepeatedTimerInner(time, action); + } + + /// + /// 创建一个重复执行的计时器，用于发布指定类型的事件。 + /// + /// 事件类型。 + /// 计时器重复间隔的时间。 + /// 事件处理器类型。 + /// 计时器的 ID。 + public long RepeatedTimer(long time, T timerHandlerType) where T : struct + { + void RepeatedTimerVoid() + { + _scene.EventComponent.Publish(timerHandlerType); + } + + return RepeatedTimer(time, RepeatedTimerVoid); + } + + private long RepeatedTimerInner(long time, Action action) + { + var now = Now(); + var timerId = GetId; + var timerAction = new TimerAction(timerId, TimerType.RepeatedTimer, now, time, action); + AddTimer(ref timerAction); + return timerId; + } + + /// + /// 移除指定 ID 的计时器。 + /// + /// + /// + public bool Remove(ref long timerId) + { + var id = timerId; + timerId = 0; + return Remove(id); + } + + /// + /// 移除指定 ID 的计时器。 + /// + /// 计时器的 ID。 + public bool Remove(long timerId) + { + return timerId != 0 && _timerActions.Remove(timerId, out _); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerScheduler/TimerSchedulerNetUnity.cs b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerScheduler/TimerSchedulerNetUnity.cs new file mode 100644 index 0000000..ad8281a --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerScheduler/TimerSchedulerNetUnity.cs @@ -0,0 +1,371 @@ +using System; +using System.Collections.Generic; +using NBC.Helper; +using NBC.Async; +using NBC.DataStructure.Collection; +using UnityEngine; + +namespace NBC +{ + public sealed class TimerSchedulerNetUnity + { + private readonly Scene _scene; + private long _idGenerator; + private long _minTime; // 最小时间 + private readonly Queue _timeOutTime = new Queue(); + private readonly Queue _timeOutTimerIds = new Queue(); + private readonly Dictionary _timerActions = new Dictionary(); + private readonly SortedOneToManyList _timeId = new(); // 时间与计时器ID的有序一对多列表 + private long GetId => ++_idGenerator; + public TimerSchedulerNetUnity(Scene scene) + { + _scene = scene; + } + + private long Now() + { + return (long)(Time.time * 1000); + } + + public void Update() + { + if (_timeId.Count == 0) + { + return; + } + + var currentTime = Now(); + + if (currentTime < _minTime) + { + return; + } + + // 遍历时间ID列表，查找超时的计时器任务 + foreach (var (key, _) in _timeId) + { + if (key > currentTime) + { + _minTime = key; + break; + } + + _timeOutTime.Enqueue(key); + } + + // 处理超时的计时器任务 + while (_timeOutTime.TryDequeue(out var time)) + { + var timerIds = _timeId[time]; + for (var i = 0; i < timerIds.Count; ++i) + { + _timeOutTimerIds.Enqueue(timerIds[i]); + } + + _timeId.Remove(time); + // _timeId.RemoveKey(time); + } + + if (_timeId.Count == 0) + { + _minTime = long.MaxValue; + } + + // 执行超时的计时器任务的回调操作 + while (_timeOutTimerIds.TryDequeue(out var timerId)) + { + if (!_timerActions.Remove(timerId, out var timerAction)) + { + continue; + } + + // 根据计时器类型执行不同的操作 + switch (timerAction.TimerType) + { + case TimerType.OnceWaitTimer: + { + var tcs = (FTask)timerAction.Callback; + tcs.SetResult(true); + break; + } + case TimerType.OnceTimer: + { + if (timerAction.Callback is not Action action) + { + Log.Error($"timerAction {timerAction.ToJson()}"); + break; + } + + action(); + break; + } + case TimerType.RepeatedTimer: + { + if (timerAction.Callback is not Action action) + { + Log.Error($"timerAction {timerAction.ToJson()}"); + break; + } + + timerAction.StartTime = Now(); + AddTimer(ref timerAction); + action(); + break; + } + } + } + } + + private void AddTimer(ref TimerAction timer) + { + var tillTime = timer.StartTime + timer.TriggerTime; + _timeId.Add(tillTime, timer.TimerId); + _timerActions.Add(timer.TimerId, timer); + + if (tillTime < _minTime) + { + _minTime = tillTime; + } + } + + /// + /// 异步等待指定时间。 + /// + /// 等待的时间长度。 + /// 可选的取消令牌。 + /// 等待是否成功。 + public async FTask WaitAsync(long time, FCancellationToken cancellationToken = null) + { + if (time <= 0) + { + return true; + } + + var now = Now(); + var timerId = GetId; + var tcs = FTask.Create(); + var timerAction = new TimerAction(timerId, TimerType.OnceWaitTimer, now, time, tcs); + + + void CancelActionVoid() + { + if (Remove(timerId)) + { + tcs.SetResult(false); + } + } + + bool result; + + try + { + cancellationToken?.Add(CancelActionVoid); + AddTimer(ref timerAction); + result =await tcs; + } + finally + { + cancellationToken?.Remove(CancelActionVoid); + } + + return result; + } + + /// + /// 异步等待直到指定时间。 + /// + /// 等待的目标时间。 + /// 可选的取消令牌。 + /// 等待是否成功。 + public async FTask WaitTillAsync(long tillTime, FCancellationToken cancellationToken = null) + { + var now = Now(); + + if (now >= tillTime) + { + return true; + } + + var timerId = GetId; + var tcs = FTask.Create(); + var timerAction = new TimerAction(timerId, TimerType.OnceWaitTimer, now, tillTime - now, tcs); + + void CancelActionVoid() + { + if (Remove(timerId)) + { + tcs.SetResult(false); + } + } + + bool result; + + try + { + cancellationToken?.Add(CancelActionVoid); + AddTimer(ref timerAction); + result = await tcs; + } + finally + { + cancellationToken?.Remove(CancelActionVoid); + } + + return result; + } + + /// + /// 异步等待一帧时间。 + /// + /// 等待是否成功。 + public async FTask WaitFrameAsync(FCancellationToken cancellationToken = null) + { + await WaitAsync(1, cancellationToken); + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间 + /// + /// 计时器执行的目标时间。 + /// 计时器回调方法。 + /// + public long OnceTimer(long time, Action action) + { + var now = Now(); + var timerId = GetId; + var timerAction = new TimerAction(timerId, TimerType.OnceTimer, now, time, action); + AddTimer(ref timerAction); + return timerId; + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间。 + /// + /// 计时器执行的目标时间。 + /// 计时器回调方法。 + /// 计时器的 ID。 + public long OnceTillTimer(long tillTime, Action action) + { + var now = Now(); + + if (tillTime < now) + { + Log.Error($"new once time too small tillTime:{tillTime} Now:{now}"); + } + + var timerId = GetId; + var timerAction = new TimerAction(timerId, TimerType.OnceTimer, now, tillTime - now, action); + AddTimer(ref timerAction); + return timerId; + } + + /// + /// 创建一个只执行一次的计时器，用于发布指定类型的事件。 + /// + /// 事件类型。 + /// 计时器执行的延迟时间。 + /// 事件处理器类型。 + /// 计时器的 ID。 + public long OnceTimer(long time, T timerHandlerType) where T : struct + { + void OnceTimerVoid() + { + _scene.EventComponent.Publish(timerHandlerType); + } + + return OnceTimer(time, OnceTimerVoid); + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间，用于发布指定类型的事件。 + /// + /// 事件类型。 + /// 计时器执行的目标时间。 + /// 事件处理器类型。 + /// 计时器的 ID。 + public long OnceTillTimer(long tillTime, T timerHandlerType) where T : struct + { + void OnceTillTimerVoid() + { + _scene.EventComponent.Publish(timerHandlerType); + } + + return OnceTillTimer(tillTime, OnceTillTimerVoid); + } + + /// + /// 创建一个帧任务 + /// + /// + /// + public long FrameTimer(Action action) + { + return RepeatedTimerInner(1, action); + } + + /// + /// 创建一个重复执行的计时器。 + /// + /// 计时器重复间隔的时间。 + /// 计时器回调方法。 + /// 计时器的 ID。 + public long RepeatedTimer(long time, Action action) + { + if (time < 0) + { + Log.Error($"time too small: {time}"); + return 0; + } + + return RepeatedTimerInner(time, action); + } + + /// + /// 创建一个重复执行的计时器，用于发布指定类型的事件。 + /// + /// 事件类型。 + /// 计时器重复间隔的时间。 + /// 事件处理器类型。 + /// 计时器的 ID。 + public long RepeatedTimer(long time, T timerHandlerType) where T : struct + { + void RepeatedTimerVoid() + { + _scene.EventComponent.Publish(timerHandlerType); + } + + return RepeatedTimer(time, RepeatedTimerVoid); + } + + private long RepeatedTimerInner(long time, Action action) + { + var now = Now(); + var timerId = GetId; + var timerAction = new TimerAction(timerId, TimerType.RepeatedTimer, now, time, action); + AddTimer(ref timerAction); + return timerId; + } + + /// + /// 移除指定 ID 的计时器。 + /// + /// + /// + public bool Remove(ref long timerId) + { + var id = timerId; + timerId = 0; + return Remove(id); + } + + /// + /// 移除指定 ID 的计时器。 + /// + /// 计时器的 ID。 + public bool Remove(long timerId) + { + return timerId != 0 && _timerActions.Remove(timerId, out _); + } + } +} + diff --git a/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerType.cs b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerType.cs new file mode 100644 index 0000000..f369b86 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Component/TimerComponent/TimerType.cs @@ -0,0 +1,25 @@ +namespace NBC +{ + /// + /// 枚举对象TimerType + /// + public enum TimerType + { + /// + /// None + /// + None, + /// + /// 一次等待定时器 + /// + OnceWaitTimer, + /// + /// 一次性定时器 + /// + OnceTimer, + /// + /// 重复定时器 + /// + RepeatedTimer + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Entity.cs b/FantasyNetTest/NBC/Core/Entitas/Entity.cs new file mode 100644 index 0000000..c7f0886 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Entity.cs @@ -0,0 +1,837 @@ +using System; +using System.Collections.Generic; +using System.Runtime.Serialization; +using MongoDB.Bson.Serialization.Attributes; +using NBC.Entitas.Interface; +using NBC.Pool; +using Newtonsoft.Json; +using ProtoBuf; +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +// ReSharper disable MergeIntoPattern +// ReSharper disable SuspiciousTypeConversion.Global +// ReSharper disable NullCoalescingConditionIsAlwaysNotNullAccordingToAPIContract +// ReSharper disable CheckNamespace +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8603 // Possible null reference return. +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. + +namespace NBC.Entitas +{ + /// + /// 用来表示一个Entity + /// + public interface IEntity : IDisposable, IPool { } + + /// + /// Entity的抽象类，任何Entity必须继承这个接口才可以使用 + /// + public abstract partial class Entity : IEntity + { + #region Members + + /// + /// 获取一个值，表示实体是否支持对象池。 + /// + [BsonIgnore] + [JsonIgnore] + [ProtoIgnore] + [IgnoreDataMember] + private bool _isPool; + /// + /// 实体的Id + /// + [BsonId] + [BsonElement] + [BsonIgnoreIfDefault] + [BsonDefaultValue(0L)] + public long Id { get; protected set; } + /// + /// 实体的RunTimeId，其他系统可以通过这个Id发送Route消息，这个Id也可以理解为RouteId + /// + [BsonIgnore] + [IgnoreDataMember] + [ProtoIgnore] + public long RuntimeId { get; protected set; } + /// + /// 当前实体是否已经被销毁 + /// + [BsonIgnore] + [JsonIgnore] + [IgnoreDataMember] + [ProtoIgnore] + public bool IsDisposed => RuntimeId == 0; + /// + /// 当前实体所归属的Scene + /// + [BsonIgnore] + [JsonIgnore] + [IgnoreDataMember] + [ProtoIgnore] + public Scene Scene { get; protected set; } + /// + /// 实体的父实体 + /// + [BsonIgnore] + [JsonIgnore] + [IgnoreDataMember] + [ProtoIgnore] + public Entity Parent { get; protected set; } + /// + /// 实体的真实Type + /// + [BsonIgnore] + [JsonIgnore] + [IgnoreDataMember] + [ProtoIgnore] + public Type Type { get; protected set; } + + [BsonIgnore] [IgnoreDataMember] [ProtoIgnore] private EntitySortedDictionary _tree; + [BsonIgnore] [IgnoreDataMember] [ProtoIgnore] private EntitySortedDictionary _multi; + + /// + /// 获得父Entity + /// + /// 父实体的泛型类型 + /// + public T GetParent() where T : Entity, new() + { + return Parent as T; + } + + /// + /// 获取当前实体的RouteId。 + /// + public long RouteId => RuntimeId; + + #endregion + + #region Create + + /// + /// 创建一个实体 + /// + /// 所属的Scene + /// 实体的Type + /// 是否从对象池创建，如果选择的是，销毁的时候同样会进入对象池 + /// 是否执行实体事件 + /// + public static Entity Create(Scene scene, Type type, bool isPool, bool isRunEvent) + { + return Create(scene, type, scene.EntityIdFactory.Create, isPool, isRunEvent); + } + + /// + /// 创建一个实体 + /// + /// 所属的Scene + /// 实体的Type + /// 指定实体的Id + /// 是否从对象池创建，如果选择的是，销毁的时候同样会进入对象池 + /// 是否执行实体事件 + /// + public static Entity Create(Scene scene, Type type, long id, bool isPool, bool isRunEvent) + { + if (!typeof(Entity).IsAssignableFrom(type)) + { + throw new NotSupportedException($"{type.FullName} Type:{type.FullName} must inherit from Entity"); + } + + Entity entity = null; + + if (isPool) + { + entity = (Entity)scene.EntityPool.Rent(type); + } + else + { + if (!scene.TypeInstance.TryGetValue(type, out var createInstance)) + { + createInstance = CreateInstance.CreateIPool(type); + scene.TypeInstance[type] = createInstance; + } + + entity = (Entity)createInstance(); + } + + entity.Scene = scene; + entity.Type = type; + entity.SetIsPool(isPool); + entity.Id = id; + entity.RuntimeId = scene.RuntimeIdFactory.Create; + scene.AddEntity(entity); + + if (isRunEvent) + { + scene.EntityComponent.Awake(entity); + scene.EntityComponent.StartUpdate(entity); + } + + return entity; + } + + /// + /// 创建一个实体 + /// + /// 所属的Scene + /// 是否从对象池创建，如果选择的是，销毁的时候同样会进入对象池 + /// 是否执行实体事件 + /// 要创建的实体泛型类型 + /// + public static T Create(Scene scene, bool isPool, bool isRunEvent) where T : Entity, new() + { + return Create(scene, scene.EntityIdFactory.Create, isPool, isRunEvent); + } + + /// + /// 创建一个实体 + /// + /// 所属的Scene + /// 指定实体的Id + /// 是否从对象池创建，如果选择的是，销毁的时候同样会进入对象池 + /// 是否执行实体事件 + /// 要创建的实体泛型类型 + /// + public static T Create(Scene scene, long id, bool isPool, bool isRunEvent) where T : Entity, new() + { + var entity = isPool ? scene.EntityPool.Rent() : new T(); + entity.Scene = scene; + entity.Type = typeof(T); + entity.SetIsPool(isPool); + entity.Id = id; + entity.RuntimeId = scene.RuntimeIdFactory.Create; + scene.AddEntity(entity); + + if (isRunEvent) + { + scene.EntityComponent.Awake(entity); + scene.EntityComponent.StartUpdate(entity); + } + + return entity; + } + + #endregion + + #region AddComponent + + /// + /// 添加一个组件到当前实体上 + /// + /// 是否从对象池里创建 + /// 要添加组件的泛型类型 + /// 返回添加到实体上组件的实例 + public T AddComponent(bool isPool = true) where T : Entity, new() + { + var id = SupportedMultiEntityChecker.IsSupported ? Scene.EntityIdFactory.Create : Id; + var entity = Create(Scene, id, isPool, false); + AddComponent(entity); + Scene.EntityComponent.Awake(entity); + Scene.EntityComponent.StartUpdate(entity); + return entity; + } + + /// + /// 添加一个组件到当前实体上 + /// + /// 要添加组件的Id + /// 是否从对象池里创建 + /// 要添加组件的泛型类型 + /// 返回添加到实体上组件的实例 + public T AddComponent(long id, bool isPool = true) where T : Entity, new() + { + var entity = Create(Scene, id, isPool, false); + AddComponent(entity); + Scene.EntityComponent.Awake(entity); + Scene.EntityComponent.StartUpdate(entity); + return entity; + } + + /// + /// 添加一个组件到当前实体上 + /// + /// 要添加的实体实例 + public void AddComponent(Entity component) + { + if (this == component) + { + Log.Error("Cannot add oneself to one's own components"); + return; + } + + if (component.IsDisposed) + { + Log.Error($"component is Disposed {component.Type.FullName}"); + return; + } + + var type = component.Type; + component.Parent?.RemoveComponent(component, false); + + if (component is ISupportedMultiEntity) + { + _multi ??= Scene.EntitySortedDictionaryPool.Rent(); + _multi.Add(component.Id, component); + } + else + { + var typeHashCode = Scene.EntityComponent.GetHashCode(type);; + + if (_tree == null) + { + _tree = Scene.EntitySortedDictionaryPool.Rent(); + } + else if (_tree.ContainsKey(typeHashCode)) + { + Log.Error($"type:{type.FullName} If you want to add multiple components of the same type, please implement IMultiEntity"); + return; + } + + _tree.Add(typeHashCode, component); + } + + component.Parent = this; + component.Scene = Scene; + } + + /// + /// 添加一个组件到当前实体上 + /// + /// 要添加的实体实例 + /// 要添加组件的泛型类型 + public void AddComponent(T component) where T : Entity + { + var type = typeof(T); + + if (type == typeof(Entity)) + { + Log.Error("Cannot add a generic Entity type as a component. Specify a more specific type."); + return; + } + + if (this == component) + { + Log.Error("Cannot add oneself to one's own components"); + return; + } + + if (component.IsDisposed) + { + Log.Error($"component is Disposed {type.FullName}"); + return; + } + + component.Parent?.RemoveComponent(component, false); + + if (SupportedMultiEntityChecker.IsSupported) + { + _multi ??= Scene.EntitySortedDictionaryPool.Rent(); + _multi.Add(component.Id, component); + } + else + { + + var typeHashCode = Scene.EntityComponent.GetHashCode(type); + + if (_tree == null) + { + _tree = Scene.EntitySortedDictionaryPool.Rent(); + } + else if (_tree.ContainsKey(typeHashCode)) + { + Log.Error($"type:{type.FullName} If you want to add multiple components of the same type, please implement IMultiEntity"); + return; + } + + _tree.Add(typeHashCode, component); + } + + component.Parent = this; + component.Scene = Scene; + } + + /// + /// 添加一个组件到当前实体上 + /// + /// 组件的类型 + /// 是否在对象池创建 + /// + public Entity AddComponent(Type type, bool isPool = true) + { + var id = typeof(ISupportedMultiEntity).IsAssignableFrom(type) ? Scene.EntityIdFactory.Create : Id; + var entity = Entity.Create(Scene, type, id, isPool, false); + AddComponent(entity); + Scene.EntityComponent.Awake(entity); + Scene.EntityComponent.StartUpdate(entity); + return entity; + } + + #endregion + + #region HasComponent + + /// + /// 当前实体上是否有指定类型的组件 + /// + /// + /// + public bool HasComponent() where T : Entity, new() + { + return HasComponent(typeof(T)); + } + + /// + /// 当前实体上是否有指定类型的组件 + /// + /// + /// + public bool HasComponent(Type type) + { + if (_tree == null) + { + return false; + } + + return _tree.ContainsKey(Scene.EntityComponent.GetHashCode(type)); + } + + /// + /// 当前实体上是否有指定类型的组件 + /// + /// + /// + /// + public bool HasComponent(long id) where T : Entity, ISupportedMultiEntity, new() + { + if (_multi == null) + { + return false; + } + + return _multi.ContainsKey(id); + } + + #endregion + + #region GetComponent + + /// + /// 当前实体上查找一个字实体 + /// + /// 要查找实体泛型类型 + /// 查找的实体实例 + public T GetComponent() where T : Entity, new() + { + if (_tree == null) + { + return null; + } + + var typeHashCode = Scene.EntityComponent.GetHashCode(typeof(T)); + return _tree.TryGetValue(typeHashCode, out var component) ? (T)component : null; + } + + /// + /// 当前实体上查找一个字实体 + /// + /// 要查找实体类型 + /// 查找的实体实例 + public Entity GetComponent(Type type) + { + if (_tree == null) + { + return null; + } + + var typeHashCode = Scene.EntityComponent.GetHashCode(type); + return _tree.TryGetValue(typeHashCode, out var component) ? component : null; + } + + /// + /// 当前实体上查找一个字实体 + /// + /// 要查找实体的Id + /// 要查找实体泛型类型 + /// 查找的实体实例 + public T GetComponent(long id) where T : Entity, ISupportedMultiEntity, new() + { + if (_multi == null) + { + return default; + } + + return _multi.TryGetValue(id, out var entity) ? (T)entity : default; + } + + /// + /// 当前实体上查找一个字实体，如果没有就创建一个新的并添加到当前实体上 + /// + /// 是否从对象池创建 + /// 要查找或添加实体泛型类型 + /// 查找的实体实例 + public T GetOrAddComponent(bool isPool = true) where T : Entity, new() + { + return GetComponent() ?? AddComponent(isPool); + } + + #endregion + + #region RemoveComponent + + /// + /// 当前实体下删除一个实体 + /// + /// 是否执行删除实体的Dispose方法 + /// 实体的泛型类型 + /// + public void RemoveComponent(bool isDispose = true) where T : Entity, new() + { + if (SupportedMultiEntityChecker.IsSupported) + { + throw new NotSupportedException($"{typeof(T).FullName} message:Cannot delete components that implement the ISupportedMultiEntity interface"); + } + + if (_tree == null) + { + return; + } + + var type = typeof(T); + var typeHashCode = Scene.EntityComponent.GetHashCode(type); + if (!_tree.TryGetValue(typeHashCode, out var component)) + { + return; + } + + _tree.Remove(typeHashCode); + + if (_tree.Count == 0) + { + Scene.EntitySortedDictionaryPool.Return(_tree); + _tree = null; + } + + if (isDispose) + { + component.Dispose(); + } + } + + /// + /// 当前实体下删除一个实体 + /// + /// 要删除的实体Id + /// 是否执行删除实体的Dispose方法 + /// 实体的泛型类型 + public void RemoveComponent(long id, bool isDispose = true) where T : Entity, ISupportedMultiEntity, new() + { + if (_multi == null) + { + return; + } + + if (!_multi.TryGetValue(id, out var component)) + { + return; + } + + _multi.Remove(component.Id); + if (_multi.Count == 0) + { + Scene.EntitySortedDictionaryPool.Return(_multi); + _multi = null; + } + + if (isDispose) + { + component.Dispose(); + } + } + + /// + /// 当前实体下删除一个实体 + /// + /// 要删除的实体实例 + /// 是否执行删除实体的Dispose方法 + public void RemoveComponent(Entity component, bool isDispose = true) + { + if (this == component) + { + return; + } + + if (component is ISupportedMultiEntity) + { + if (_multi != null) + { + if (!_multi.ContainsKey(component.Id)) + { + return; + } + + _multi.Remove(component.Id); + if (_multi.Count == 0) + { + Scene.EntitySortedDictionaryPool.Return(_multi); + _multi = null; + } + } + } + else if (_tree != null) + { + var typeHashCode = Scene.EntityComponent.GetHashCode(component.Type); + if (!_tree.ContainsKey(typeHashCode)) + { + return; + } + + _tree.Remove(typeHashCode); + + if (_tree.Count == 0) + { + Scene.EntitySortedDictionaryPool.Return(_tree); + _tree = null; + } + } + + if (isDispose) + { + component.Dispose(); + } + } + + /// + /// 当前实体下删除一个实体 + /// + /// 要删除的实体实例 + /// 是否执行删除实体的Dispose方法 + /// 实体的泛型类型 + public void RemoveComponent(T component, bool isDispose = true) where T : Entity + { + if (this == component) + { + return; + } + + if (typeof(T) == typeof(Entity)) + { + Log.Error("Cannot remove a generic Entity type as a component. Specify a more specific type."); + return; + } + + if (SupportedMultiEntityChecker.IsSupported) + { + if (_multi != null) + { + if (!_multi.ContainsKey(component.Id)) + { + return; + } + + _multi.Remove(component.Id); + if (_multi.Count == 0) + { + Scene.EntitySortedDictionaryPool.Return(_multi); + _multi = null; + } + } + } + else if (_tree != null) + { + var typeHashCode = Scene.EntityComponent.GetHashCode(typeof(T)); + if (!_tree.ContainsKey(typeHashCode)) + { + return; + } + + _tree.Remove(typeHashCode); + + if (_tree.Count == 0) + { + Scene.EntitySortedDictionaryPool.Return(_tree); + _tree = null; + } + } + + if (isDispose) + { + component.Dispose(); + } + } + + #endregion + + #region Deserialize + + /// + /// 反序列化当前实体，因为在数据库加载过来的或通过协议传送过来的实体并没有跟当前Scene做关联。 + /// 所以必须要执行一下这个反序列化的方法才可以使用。 + /// + /// Scene + /// 是否是重新生成实体的Id,如果是数据库加载过来的一般是不需要的 + public void Deserialize(Scene scene, bool resetId = false) + { + if (RuntimeId != 0) + { + return; + } + + try + { + Scene = scene; + Type ??= GetType(); + RuntimeId = Scene.RuntimeIdFactory.Create; + if (resetId) + { + Id = RuntimeId; + } + scene.AddEntity(this); + scene.EntityComponent.Deserialize(this); + } + catch (Exception e) + { + if (RuntimeId != 0) + { + scene.RemoveEntity(RuntimeId); + } + + Log.Error(e); + } + } + + #endregion + + #region ForEach + + /// + /// 查询当前实体下的实现了ISupportedMultiEntity接口的实体 + /// + [BsonIgnore] + [JsonIgnore] + [IgnoreDataMember] + [ProtoIgnore] + public IEnumerable ForEachMultiEntity + { + get + { + if (_multi == null) + { + yield break; + } + + foreach (var (_, supportedMultiEntity) in _multi) + { + yield return supportedMultiEntity; + } + } + } + /// + /// 查找当前实体下的所有实体，不包括实现ISupportedMultiEntity接口的实体 + /// + [BsonIgnore] + [JsonIgnore] + [IgnoreDataMember] + [ProtoIgnore] + public IEnumerable ForEachEntity + { + get + { + if (_tree == null) + { + yield break; + } + + foreach (var (_, entity) in _tree) + { + yield return entity; + } + } + } + #endregion + + #region Dispose + + /// + /// 销毁当前实体，销毁后会自动销毁当前实体下的所有实体。 + /// + public virtual void Dispose() + { + if (IsDisposed) + { + return; + } + + var scene = Scene; + var runTimeId = RuntimeId; + RuntimeId = 0; + + if (_tree != null) + { + foreach (var (_, entity) in _tree) + { + entity.Dispose(); + } + + _tree.Clear(); + scene.EntitySortedDictionaryPool.Return(_tree); + _tree = null; + } + + if (_multi != null) + { + foreach (var (_, entity) in _multi) + { + entity.Dispose(); + } + + _multi.Clear(); + scene.EntitySortedDictionaryPool.Return(_multi); + _multi = null; + } + scene.EntityComponent.Destroy(this); + + if (Parent != null && Parent != this && !Parent.IsDisposed) + { + Parent.RemoveComponent(this, false); + Parent = null; + } + + Id = 0; + Scene = null; + Parent = null; + scene.RemoveEntity(runTimeId); + + if (IsPool()) + { + scene.EntityPool.Return(Type, this); + } + + Type = null; + } + + #endregion + + #region Pool + + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + + #endregion + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/EntityPool.cs b/FantasyNetTest/NBC/Core/Entitas/EntityPool.cs new file mode 100644 index 0000000..7751cbd --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/EntityPool.cs @@ -0,0 +1,66 @@ +using System.Collections.Generic; +using NBC.Pool; + +#pragma warning disable CS8714 // The type cannot be used as type parameter in the generic type or method. Nullability of type argument doesn't match 'notnull' constraint. + +namespace NBC.Entitas +{ + internal sealed class EntityPool : PoolCore + { + public EntityPool() : base(4096) { } + } + + internal sealed class EntityList : List, IPool where T : Entity + { + private bool _isPool; + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + internal sealed class EntityListPool : PoolCore> where T : Entity + { + public EntityListPool() : base(4096) { } + } + + internal sealed class EntitySortedDictionary : SortedDictionary, IPool where TN : Entity + { + private bool _isPool; + /// + /// 获取一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public bool IsPool() + { + return _isPool; + } + + /// + /// 设置一个值，该值指示当前实例是否为对象池中的实例。 + /// + /// + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } + + internal sealed class EntitySortedDictionaryPool : PoolCore> where TN : Entity + { + public EntitySortedDictionaryPool() : base(4096) { } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/EntityReference.cs b/FantasyNetTest/NBC/Core/Entitas/EntityReference.cs new file mode 100644 index 0000000..929bb68 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/EntityReference.cs @@ -0,0 +1,59 @@ +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8603 // Possible null reference return. +namespace NBC.Entitas +{ + /// + /// 实体引用检查组件 + /// + /// + public struct EntityReference where T : Entity + { + private T _entity; + private readonly long _runTimeId; + + private EntityReference(T t) + { + if (t == null) + { + _entity = null; + _runTimeId = 0; + return; + } + + _entity = t; + _runTimeId = t.RuntimeId; + } + + /// + /// 将一个实体转换为EntityReference + /// + /// 实体泛型类型 + /// 返回一个EntityReference + public static implicit operator EntityReference(T t) + { + return new EntityReference(t); + } + + /// + /// 将一个EntityReference转换为实体 + /// + /// 实体泛型类型 + /// 当实体已经被销毁过会返回null + public static implicit operator T(EntityReference v) + { + if (v._entity == null) + { + return null; + } + + if (v._entity.RuntimeId != v._runTimeId) + { + v._entity = null; + } + + return v._entity; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISingleCollectionRoot.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISingleCollectionRoot.cs new file mode 100644 index 0000000..0561a7a --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISingleCollectionRoot.cs @@ -0,0 +1,17 @@ +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace NBC.Entitas.Interface +{ + /// + /// Entity保存到数据库的时候会根据子组件设置分离存储特性分表存储在不同的集合表中 + /// + public interface ISingleCollectionRoot { } + public static class SingleCollectionRootChecker where T : Entity + { + public static bool IsSupported { get; } + + static SingleCollectionRootChecker() + { + IsSupported = typeof(ISingleCollectionRoot).IsAssignableFrom(typeof(T)); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISingleCollectionRoot.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISingleCollectionRoot.cs.meta new file mode 100644 index 0000000..94cbb13 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISingleCollectionRoot.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 57298dd8265554d6087d79ef5a6e89cc +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedDataBase.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedDataBase.cs new file mode 100644 index 0000000..89eebcb --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedDataBase.cs @@ -0,0 +1,19 @@ +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace NBC.Entitas.Interface +{ + /// + /// Entity支持数据库 + /// + // ReSharper disable once InconsistentNaming + public interface ISupportedDataBase { } + + public static class SupportedDataBaseChecker where T : Entity + { + public static bool IsSupported { get; } + + static SupportedDataBaseChecker() + { + IsSupported = typeof(ISupportedDataBase).IsAssignableFrom(typeof(T)); + } + } +} diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedDataBase.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedDataBase.cs.meta new file mode 100644 index 0000000..4b72ec6 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedDataBase.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ae64989e8b146443e99c66290b20a3c8 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedMultiEntity.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedMultiEntity.cs new file mode 100644 index 0000000..f298126 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedMultiEntity.cs @@ -0,0 +1,20 @@ +using System; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.Entitas.Interface +{ + /// + /// 支持再一个组件里添加多个同类型组件 + /// + public interface ISupportedMultiEntity : IDisposable { } + + public static class SupportedMultiEntityChecker where T : Entity + { + public static bool IsSupported { get; } + + static SupportedMultiEntityChecker() + { + IsSupported = typeof(ISupportedMultiEntity).IsAssignableFrom(typeof(T)); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedMultiEntity.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedMultiEntity.cs.meta new file mode 100644 index 0000000..4096fe8 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedMultiEntity.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 36105e7ed5c974fdabf37eead97ef95c +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedSingleCollection.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedSingleCollection.cs new file mode 100644 index 0000000..ec972dc --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedSingleCollection.cs @@ -0,0 +1,47 @@ +using System; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace NBC.Entitas.Interface +{ + // Entity是单一集合、保存到数据库的时候不会跟随父组件保存在一个集合里、会单独保存在一个集合里 + // 需要配合SingleCollectionAttribute一起使用、如在Entity类头部定义SingleCollectionAttribute(typeOf(Unit)) + // SingleCollectionAttribute用来定义这个Entity是属于哪个Entity的子集 + /// + /// 定义实体支持单一集合存储的接口。当实体需要单独存储在一个集合中，并且在保存到数据库时不会与父组件一起保存在同一个集合中时，应实现此接口。 + /// + public interface ISupportedSingleCollection { } + public static class SupportedSingleCollectionChecker where T : Entity + { + public static bool IsSupported { get; } + + static SupportedSingleCollectionChecker() + { + IsSupported = typeof(ISupportedSingleCollection).IsAssignableFrom(typeof(T)); + } + } + /// + /// 表示用于指定实体的单一集合存储属性。此属性用于配合 接口使用， + /// 用于定义实体属于哪个父实体的子集合，以及在数据库中使用的集合名称。 + /// + [AttributeUsage(AttributeTargets.Class, Inherited = true, AllowMultiple = false)] + public class SingleCollectionAttribute : Attribute + { + /// + /// 获取父实体的类型，指示此实体是属于哪个父实体的子集合。 + /// + public readonly Type RootType; + /// + /// 获取在数据库中使用的集合名称。 + /// + public readonly string CollectionName; + /// + /// 初始化 类的新实例，指定父实体类型和集合名称。 + /// + /// 父实体的类型。 + /// 在数据库中使用的集合名称。 + public SingleCollectionAttribute(Type rootType, string collectionName) + { + RootType = rootType; + CollectionName = collectionName; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedSingleCollection.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedSingleCollection.cs.meta new file mode 100644 index 0000000..dc89d3b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedSingleCollection.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: afd453d04ac254206a9bb83664a888a0 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedTransfer.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedTransfer.cs new file mode 100644 index 0000000..1518d52 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedTransfer.cs @@ -0,0 +1,16 @@ +namespace NBC.Entitas.Interface +{ + /// + /// Entity支持传送 + /// + public interface ISupportedTransfer { } + public static class SupportedTransferChecker where T : Entity + { + public static bool IsSupported { get; } + + static SupportedTransferChecker() + { + IsSupported = typeof(ISupportedTransfer).IsAssignableFrom(typeof(T)); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedTransfer.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedTransfer.cs.meta new file mode 100644 index 0000000..8f1493c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/Supported/ISupportedTransfer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a127a7c6e345a42e3860b804457f0fe5 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IAwakeSystem.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IAwakeSystem.cs new file mode 100644 index 0000000..15b4bb6 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IAwakeSystem.cs @@ -0,0 +1,32 @@ +using System; +using NBC.Async; + +namespace NBC.Entitas.Interface +{ + internal interface IAwakeSystem : IEntitiesSystem { } + /// + /// 实体的Awake事件的抽象接口 + /// + /// 实体的泛型类型 + public abstract class AwakeSystem : IAwakeSystem where T : Entity + { + /// + /// 实体的类型 + /// + /// + public Type EntitiesType() => typeof(T); + /// + /// 事件的抽象方法，需要自己实现这个方法 + /// + /// 触发事件的实体实例 + protected abstract void Awake(T self); + /// + /// 框架内部调用的触发Awake的方法。 + /// + /// 触发事件的实体实例 + public void Invoke(Entity self) + { + Awake((T) self); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IAwakeSystem.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IAwakeSystem.cs.meta new file mode 100644 index 0000000..782be94 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IAwakeSystem.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: fe2caf80007df454bb76729547780d28 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/ICustomEntitiesSystem.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/System/ICustomEntitiesSystem.cs new file mode 100644 index 0000000..7c0894d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/ICustomEntitiesSystem.cs @@ -0,0 +1,59 @@ +using System; + +namespace NBC.Entitas.Interface +{ + /// + /// 自定义组件事件系统接口 + /// 如果需要自定义组件事件系统，请继承此接口。 + /// 这个接口内部使用。不对外开放。 + /// + internal interface ICustomEntitiesSystem + { + /// + /// 事件类型 + /// 用于触发这个组件事件关键因素。 + /// + int CustomEventType { get; } + /// + /// 实体的类型 + /// + /// + Type EntitiesType(); + /// + /// 框架内部调用的触发事件方法 + /// + /// + void Invoke(Entity entity); + } + + /// + /// 自定义组件事件系统抽象类 + /// 如果需要自定义组件事件系统，请继承此抽象类。 + /// + /// + public abstract class CustomSystem : ICustomEntitiesSystem where T : Entity + { + /// + /// 这个1表示是一个自定义事件类型，执行这个事件是时候需要用到这个1. + /// + public abstract int CustomEventType { get; } + /// + /// 事件的抽象方法，需要自己实现这个方法 + /// + /// 触发事件的实体实例 + protected abstract void Custom(T self); + /// + /// 实体的类型 + /// + /// + public abstract Type EntitiesType(); + /// + /// 框架内部调用的触发Awake的方法。 + /// + /// 触发事件的实体实例 + public void Invoke(Entity self) + { + Custom((T) self); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/ICustomEntitiesSystem.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/System/ICustomEntitiesSystem.cs.meta new file mode 100644 index 0000000..2a4604f --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/ICustomEntitiesSystem.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 8babd948f5d51430db4d8ac333b25d54 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDeserializeSystem.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDeserializeSystem.cs new file mode 100644 index 0000000..fc255cb --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDeserializeSystem.cs @@ -0,0 +1,32 @@ +using System; +using NBC.Async; + +namespace NBC.Entitas.Interface +{ + internal interface IDeserializeSystem : IEntitiesSystem { } + /// + /// 实体的反序列化事件的抽象接口 + /// + /// 实体的泛型数据 + public abstract class DeserializeSystem : IDeserializeSystem where T : Entity + { + /// + /// 实体的类型 + /// + /// + public Type EntitiesType() => typeof(T); + /// + /// 事件的抽象方法，需要自己实现这个方法 + /// + /// 触发事件的实体实例 + protected abstract void Deserialize(T self); + /// + /// 框架内部调用的触发Deserialize的方法 + /// + /// 触发事件的实体实例 + public void Invoke(Entity self) + { + Deserialize((T) self); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDeserializeSystem.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDeserializeSystem.cs.meta new file mode 100644 index 0000000..b2b90be --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDeserializeSystem.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: f9d2fff74aed249e8aa0acbb122614c2 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDestroySystem.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDestroySystem.cs new file mode 100644 index 0000000..6a2ac0f --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDestroySystem.cs @@ -0,0 +1,32 @@ +using System; +using NBC.Async; + +namespace NBC.Entitas.Interface +{ + internal interface IDestroySystem : IEntitiesSystem { } + /// + /// 实体销毁事件的抽象接口 + /// + /// + public abstract class DestroySystem : IDestroySystem where T : Entity + { + /// + /// 实体的类型 + /// + /// + public Type EntitiesType() => typeof(T); + /// + /// 事件的抽象方法，需要自己实现这个方法 + /// + /// 触发事件的实体实例 + protected abstract void Destroy(T self); + /// + /// 框架内部调用的触发Destroy的方法 + /// + /// + public void Invoke(Entity self) + { + Destroy((T) self); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDestroySystem.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDestroySystem.cs.meta new file mode 100644 index 0000000..f46b2c4 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IDestroySystem.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 899a57e15b99948c7bcaef5b76cae97c +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IEntitiesSystem.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IEntitiesSystem.cs new file mode 100644 index 0000000..58beb6f --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IEntitiesSystem.cs @@ -0,0 +1,22 @@ +using System; +using NBC.Async; + +namespace NBC.Entitas.Interface +{ + /// + /// ECS事件系统的核心接口，任何事件都是要继承这个接口 + /// + public interface IEntitiesSystem + { + /// + /// 实体的类型 + /// + /// + Type EntitiesType(); + /// + /// 框架内部调用的触发事件方法 + /// + /// + void Invoke(Entity entity); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IEntitiesSystem.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IEntitiesSystem.cs.meta new file mode 100644 index 0000000..d5370f1 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IEntitiesSystem.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 287ae5e33ccda4c28946371bcad4755b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IFrameUpdateSystem.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IFrameUpdateSystem.cs new file mode 100644 index 0000000..cdfd0e3 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IFrameUpdateSystem.cs @@ -0,0 +1,31 @@ +using System; + +namespace NBC.Entitas.Interface +{ + internal interface IFrameUpdateSystem : IEntitiesSystem { } + /// + /// 帧更新时间的抽象接口 + /// + /// + public abstract class FrameUpdateSystem : IFrameUpdateSystem where T : Entity + { + /// + /// 实体的类型 + /// + /// + public Type EntitiesType() => typeof(T); + /// + /// 事件的抽象方法，需要自己实现这个方法 + /// + /// 触发事件的实体实例 + protected abstract void FrameUpdate(T self); + /// + /// 框架内部调用的触发FrameUpdate的方法 + /// + /// + public void Invoke(Entity self) + { + FrameUpdate((T) self); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IFrameUpdateSystem.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IFrameUpdateSystem.cs.meta new file mode 100644 index 0000000..866ab9a --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IFrameUpdateSystem.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: b785fffadcd8c4461b1f1fcf397728b9 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IUpdateSystem.cs b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IUpdateSystem.cs new file mode 100644 index 0000000..3cab81e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IUpdateSystem.cs @@ -0,0 +1,31 @@ +using System; + +namespace NBC.Entitas.Interface +{ + internal interface IUpdateSystem : IEntitiesSystem { } + /// + /// Update事件的抽象接口 + /// + /// + public abstract class UpdateSystem : IUpdateSystem where T : Entity + { + /// + /// 实体的类型 + /// + /// + public Type EntitiesType() => typeof(T); + /// + /// 事件的抽象方法，需要自己实现这个方法 + /// + /// 触发事件的实体实例 + protected abstract void Update(T self); + /// + /// 框架内部调用的触发Update的方法 + /// + /// 触发事件的实体实例 + public void Invoke(Entity self) + { + Update((T) self); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Entitas/Interface/System/IUpdateSystem.cs.meta b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IUpdateSystem.cs.meta new file mode 100644 index 0000000..a78de3d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Entitas/Interface/System/IUpdateSystem.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a40db65b7285747ffad3a0346966406c +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Event/EventArgs.cs b/FantasyNetTest/NBC/Core/Event/EventArgs.cs new file mode 100644 index 0000000..e622105 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Event/EventArgs.cs @@ -0,0 +1,128 @@ +using System; +using System.Collections.Generic; + +namespace NBC +{ + /// + /// 事件对象 用于派发事件传参数使用 + /// + public class EventArgs + { + public EventArgs() + { + } + + public EventArgs(string type) + { + Type = type; + } + + public EventArgs(string type, object data) + { + Type = type; + Data = data; + } + + // private static readonly Queue _poolQueue = new Queue(); + + /// + /// 派发事件的对象 + /// + public IEventDispatcher Sender; + + /// + /// 派发事件夹带的普通参数 + /// + public object Data; + + /// + /// 事件类型 + /// + public string Type; + + /// + /// 是否停止事件派发 + /// + public bool IsPropagationImmediateStopped; + + /// + /// 流转传递参数（用于高优先级往低优先级传递） + /// + public object TransmitData; + + /// + /// 停止一个事件的派发 + /// + public void StopImmediatePropagation() + { + IsPropagationImmediateStopped = true; + } + + + /// + /// 设置流转数据 + /// + /// 需要流转的数据 + public void SetTransmitData(object data) + { + TransmitData = data; + } + + /// + /// 清理对象 + /// + protected void Clean() + { + Data = null; + IsPropagationImmediateStopped = false; + } + + public static T Create(string type) where T : EventArgs, new() + { + EventArgs eventArgs; + // if (_poolQueue.Count > 0) + // { + // eventArgs = _poolQueue.Dequeue(); + // } + // else + // { + // var t = typeof(T); + // eventArgs = Activator.CreateInstance(t) as EventArgs; + // _poolQueue.Enqueue(eventArgs); + // } + var t = typeof(T); + eventArgs = Activator.CreateInstance(t) as EventArgs; + + if (eventArgs != null) + { + eventArgs.Type = type; + } + + return eventArgs as T; + } + + /// + /// 派发一个特定事件 + /// + /// 派发一个事件 + /// 事件类型 + /// 事件附带参数 + public static void DispatchEvent(IEventDispatcher target, string type, object data) + { + var ev = Create(type); + ev.Data = data; + target.DispatchEvent(ev); + Release(ev); + } + + /// + /// 释放事件对象 + /// + /// + public static void Release(EventArgs ev) + { + ev.Clean(); + // _poolQueue.Enqueue(ev); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Event/EventDispatcher.cs b/FantasyNetTest/NBC/Core/Event/EventDispatcher.cs new file mode 100644 index 0000000..4cc4bab --- /dev/null +++ b/FantasyNetTest/NBC/Core/Event/EventDispatcher.cs @@ -0,0 +1,217 @@ +using System; +using System.Collections.Generic; + +namespace NBC +{ + struct EventBin + { + public string type; + public Action listener; + public object thisObject; + public int priority; + public EventDispatcher target; + public bool dispatchOnce; + } + + public class EventDispatcher : IEventDispatcher + { + private readonly Dictionary> + _dicEventListener = new Dictionary>(); + + // private Queue _curNeedDispatcherListeners; + private readonly Stack _onceList = new Stack(); + + public IEventDispatcher On(string type, Action listener, object caller, int priority = 0, + bool once = false) + { + List list; + if (HasEventListener(type)) + { + list = _dicEventListener[type]; + } + else + { + list = new List(); + _dicEventListener[type] = list; + } + + InsertEventBin(list, type, listener, caller, priority, once); + return this; + } + + public IEventDispatcher Once(string type, Action listener, object caller, int priority = 0) + { + On(type, listener, caller, priority, true); + return this; + } + + public IEventDispatcher Off(string type, Action listener, object caller) + { + RemoveListener(type, listener, caller); + return this; + } + + public IEventDispatcher OffAll(string type = "") + { + if (type != "" && HasEventListener(type)) + { + _dicEventListener.Remove(type); + } + else + { + _dicEventListener.Clear(); + } + + return this; + } + + public IEventDispatcher OffAllCaller(object caller) + { + List arr = new List(); + foreach (var v in _dicEventListener.Values) + { + foreach (var eventBin in v) + { + if (eventBin.thisObject == caller) + { + arr.Add(eventBin); + } + } + } + + foreach (var e in arr) + { + RemoveListener(e.type, e.listener, e.thisObject); + } + + return this; + } + + public bool HasEventListener(string type) + { + return _dicEventListener.ContainsKey(type); + } + + public void DispatchEvent(EventArgs ev) + { + ev.Sender = this; + notifyListener(ev); + } + + public bool DispatchEventWith(string type, object data = null) + { + if (HasEventListener(type)) + { + EventArgs eventArgs = EventArgs.Create(type); + eventArgs.Data = data; + DispatchEvent(eventArgs); + EventArgs.Release(eventArgs); + } + + return true; + } + + + private bool InsertEventBin(List list, string type, Action listener, object thisObject, + int priority = 0, bool dispatchOnce = false) + + { + var insertIndex = -1; + var length = list.Count; + for (var i = 0; i < length; i++) + { + var bin = list[i]; + if (bin.listener == listener && bin.thisObject == thisObject && bin.target == this) + { + return false; + } + + if (insertIndex == -1 && bin.priority < priority) + { + insertIndex = i; + } + } + + var eventBin = new EventBin + { + type = type, + listener = listener, + thisObject = thisObject, + priority = priority, + target = this, + dispatchOnce = dispatchOnce + }; + + if (insertIndex != -1) + { + list.Insert(insertIndex, eventBin); + } + else + { + list.Add(eventBin); + } + + return true; + } + + private void RemoveListener(string type, Action listener, object caller) + { + if (HasEventListener(type)) + { + RemoveEventBin(_dicEventListener[type], listener, caller); + } + } + + private bool RemoveEventBin(List list, Action listener, object caller) + { + var length = list.Count; + for (var i = 0; i < length; i++) + { + var bin = list[i]; + if (bin.listener == listener && bin.thisObject == caller && bin.target == this) + { + list.RemoveAt(i); + return true; + } + } + + return false; + } + + private void notifyListener(EventArgs eventArgs) + { + if (!_dicEventListener.ContainsKey(eventArgs.Type)) return; + var list = _dicEventListener[eventArgs.Type]; + var length = list.Count; + if (length <= 0) return; + var curNeedDispatcherListeners = new Queue(); + + var curIndex = 0; + while (curIndex < list.Count) + { + var eventBin = list[curIndex]; + + curNeedDispatcherListeners.Enqueue(eventBin); + curIndex++; + } + + while (curNeedDispatcherListeners.Count > 0) + { + var eventBin = curNeedDispatcherListeners.Dequeue(); + eventBin.listener?.Invoke(eventArgs); + if (eventBin.dispatchOnce) + { + _onceList.Push(eventBin); + } + if(eventArgs.IsPropagationImmediateStopped) break; + } + + + while (_onceList.Count > 0) + { + var eventBin = _onceList.Pop(); + eventBin.target.Off(eventBin.type, eventBin.listener, eventBin.thisObject); + } + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Event/IEventDispatcher.cs b/FantasyNetTest/NBC/Core/Event/IEventDispatcher.cs new file mode 100644 index 0000000..72db416 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Event/IEventDispatcher.cs @@ -0,0 +1,71 @@ +using System; + +namespace NBC +{ + public interface IEventDispatcher + { + /// + /// 注册一个消息 + /// + /// 消息类型 + /// 监听函数 + /// 监听对象 + /// 优先级 + /// 是否只执行一次监听 + /// + IEventDispatcher On(string type, Action listener, object caller, int priority = 0, + bool once = false); + + /// + /// 注册一个监听一次的消息 + /// + /// 消息类型 + /// 监听函数 + /// 监听对象 + /// 优先级 + /// + IEventDispatcher Once(string type, Action listener, object caller, int priority = 0); + + /// + /// 取消监听 + /// + /// + /// + /// + /// + IEventDispatcher Off(string type, Action listener, object caller); + + /// + /// 取消这个消息的所有监听 + /// + /// + IEventDispatcher OffAll(string type = ""); + + /// + /// 取消接受对象上的所有消息 + /// + /// + /// + IEventDispatcher OffAllCaller(object caller); + + /// + /// 是否存在监听 + /// + /// + /// + bool HasEventListener(string type); + + /// + /// 派发消息 + /// + /// + void DispatchEvent(EventArgs ev); + + /// + /// 根据消息类型派发消息 + /// + /// + /// + bool DispatchEventWith(string type, object data = null); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/FTask/Builder/AsyncFTaskCompletedMethodBuilder.cs b/FantasyNetTest/NBC/Core/FTask/Builder/AsyncFTaskCompletedMethodBuilder.cs new file mode 100644 index 0000000..3915e6c --- /dev/null +++ b/FantasyNetTest/NBC/Core/FTask/Builder/AsyncFTaskCompletedMethodBuilder.cs @@ -0,0 +1,52 @@ +using System; +using System.Diagnostics; +using System.Runtime.CompilerServices; +using System.Runtime.ExceptionServices; +using System.Runtime.InteropServices; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC +{ + [StructLayout(LayoutKind.Auto)] + public struct AsyncFTaskCompletedMethodBuilder + { + public FTaskCompleted Task => default; + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static AsyncFTaskCompletedMethodBuilder Create() + { + return new AsyncFTaskCompletedMethodBuilder(); + } + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void Start(ref TStateMachine stateMachine) where TStateMachine : IAsyncStateMachine + { + stateMachine.MoveNext(); + } + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetException(Exception exception) + { + ExceptionDispatchInfo.Capture(exception).Throw(); + } + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetResult() { } + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void AwaitOnCompleted(ref TAwaiter awaiter, ref TStateMachine stateMachine) where TAwaiter : INotifyCompletion where TStateMachine : IAsyncStateMachine + { + awaiter.OnCompleted(stateMachine.MoveNext); + } + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void AwaitUnsafeOnCompleted(ref TAwaiter awaiter, ref TStateMachine stateMachine) where TAwaiter : ICriticalNotifyCompletion where TStateMachine : IAsyncStateMachine + { + awaiter.UnsafeOnCompleted(stateMachine.MoveNext); + } + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetStateMachine(IAsyncStateMachine stateMachine) { } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/FTask/Builder/AsyncFTaskMethodBuilder.cs b/FantasyNetTest/NBC/Core/FTask/Builder/AsyncFTaskMethodBuilder.cs new file mode 100644 index 0000000..e63882e --- /dev/null +++ b/FantasyNetTest/NBC/Core/FTask/Builder/AsyncFTaskMethodBuilder.cs @@ -0,0 +1,140 @@ +using System; +using System.Collections.Concurrent; +using System.Diagnostics; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +// ReSharper disable MemberCanBePrivate.Global +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8604 // Possible null reference argument. + +namespace NBC +{ + [StructLayout(LayoutKind.Auto)] + public readonly struct AsyncFTaskMethodBuilder + { + public FTask Task + { + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + get; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static AsyncFTaskMethodBuilder Create() + { + return new AsyncFTaskMethodBuilder(FTask.Create()); + } + + public AsyncFTaskMethodBuilder(FTask fTask) + { + Task = fTask; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void Start(ref TStateMachine stateMachine) where TStateMachine : IAsyncStateMachine + { + stateMachine.MoveNext(); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetResult() + { + Task.SetResult(); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetException(Exception exception) + { + Task.SetException(exception); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void AwaitOnCompleted(ref TAwaiter awaiter, ref TStateMachine stateMachine) where TAwaiter : INotifyCompletion where TStateMachine : IAsyncStateMachine + { + // 通常在异步方法中遇到 await 关键字时调用，并且需要将执行恢复到调用 await 之前的同步上下文。 + awaiter.OnCompleted(stateMachine.MoveNext); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void AwaitUnsafeOnCompleted(ref TAwaiter awaiter, ref TStateMachine stateMachine) where TAwaiter : ICriticalNotifyCompletion where TStateMachine : IAsyncStateMachine + { + // 通常在你不需要恢复到原始同步上下文时调用，这意味着你不关心在什么线程上恢复执行。 + awaiter.UnsafeOnCompleted(stateMachine.MoveNext); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetStateMachine(IAsyncStateMachine stateMachine) + { + // 用于设置和保存异步方法的状态机实例。 + // 编译器在生成异步方法时要求其存在。 + // 编译器生成的代码已经足够处理状态机的管理,所以这里没有什么特殊要求所以保持空实现。 + } + } + + [StructLayout(LayoutKind.Auto)] + public readonly struct AsyncFTaskMethodBuilder + { + public FTask Task + { + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + get; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static AsyncFTaskMethodBuilder Create() + { + return new AsyncFTaskMethodBuilder(FTask.Create()); + } + + public AsyncFTaskMethodBuilder(FTask fTask) + { + Task = fTask; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void Start(ref TStateMachine stateMachine) where TStateMachine : IAsyncStateMachine + { + stateMachine.MoveNext(); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetResult(T value) + { + Task.SetResult(value); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetException(Exception exception) + { + Task.SetException(exception); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void AwaitOnCompleted(ref TAwaiter awaiter, ref TStateMachine stateMachine) where TAwaiter : INotifyCompletion where TStateMachine : IAsyncStateMachine + { + awaiter.OnCompleted(stateMachine.MoveNext); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void AwaitUnsafeOnCompleted(ref TAwaiter awaiter, ref TStateMachine stateMachine) where TAwaiter : ICriticalNotifyCompletion where TStateMachine : IAsyncStateMachine + { + awaiter.UnsafeOnCompleted(stateMachine.MoveNext); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetStateMachine(IAsyncStateMachine stateMachine) { } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/FTask/Builder/AsyncFVoidMethodBuilder.cs b/FantasyNetTest/NBC/Core/FTask/Builder/AsyncFVoidMethodBuilder.cs new file mode 100644 index 0000000..e62bd86 --- /dev/null +++ b/FantasyNetTest/NBC/Core/FTask/Builder/AsyncFVoidMethodBuilder.cs @@ -0,0 +1,62 @@ +using System; +using System.Diagnostics; +using System.Runtime.CompilerServices; +using System.Runtime.ExceptionServices; +using System.Runtime.InteropServices; +#pragma warning disable CS8603 // Possible null reference return. + +namespace NBC +{ + [StructLayout(LayoutKind.Auto)] + internal struct AsyncFVoidMethodBuilder + { + public FVoid Task + { + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + get => default; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static AsyncFVoidMethodBuilder Create() + { + return default; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void Start(ref TStateMachine stateMachine) where TStateMachine : IAsyncStateMachine + { + stateMachine.MoveNext(); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetResult() { } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetException(Exception exception) + { + ExceptionDispatchInfo.Capture(exception).Throw(); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void AwaitOnCompleted(ref TAwaiter awaiter, ref TStateMachine stateMachine) where TAwaiter : INotifyCompletion where TStateMachine : IAsyncStateMachine + { + awaiter.OnCompleted(stateMachine.MoveNext); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void AwaitUnsafeOnCompleted(ref TAwaiter awaiter, ref TStateMachine stateMachine) where TAwaiter : ICriticalNotifyCompletion where TStateMachine : IAsyncStateMachine + { + awaiter.UnsafeOnCompleted(stateMachine.MoveNext); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetStateMachine(IAsyncStateMachine stateMachine) { } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/FTask/FCancellationToken/FCancellationToken.cs b/FantasyNetTest/NBC/Core/FTask/FCancellationToken/FCancellationToken.cs new file mode 100644 index 0000000..68e55d5 --- /dev/null +++ b/FantasyNetTest/NBC/Core/FTask/FCancellationToken/FCancellationToken.cs @@ -0,0 +1,121 @@ +using System; +using System.Collections.Concurrent; +using System.Collections.Generic; + +namespace NBC +{ + /// + /// 用于FTask取消的CancellationToken + /// + public sealed class FCancellationToken : IDisposable + { + private bool _isDispose; + private bool _isCancel; + private readonly HashSet _actions = new HashSet(); + /// + /// 当前CancellationToken是否已经取消过了 + /// + public bool IsCancel => _isDispose || _isCancel; + /// + /// 添加一个取消要执行的Action + /// + /// + public void Add(Action action) + { + if (_isDispose) + { + return; + } + + _actions.Add(action); + } + /// + /// 移除一个取消要执行的Action + /// + /// + public void Remove(Action action) + { + if (_isDispose) + { + return; + } + + _actions.Remove(action); + } + /// + /// 取消CancellationToken + /// + public void Cancel() + { + if (IsCancel) + { + return; + } + + _isCancel = true; + + foreach (var action in _actions) + { + try + { + action.Invoke(); + } + catch (Exception e) + { + Console.WriteLine(e); + } + } + + _actions.Clear(); + } + /// + /// 销毁掉CancellationToken，会执行Cancel方法。 + /// + public void Dispose() + { + if (_isDispose) + { + return; + } + + if (!IsCancel) + { + Cancel(); + _isCancel = true; + } + + _isDispose = true; + + if (Caches.Count > 2000) + { + return; + } + + Caches.Enqueue(this); + } + + #region Static + + private static readonly ConcurrentQueue Caches = new ConcurrentQueue(); + + /// + /// 获取一个新的CancellationToken + /// + public static FCancellationToken ToKen + { + get + { + if (!Caches.TryDequeue(out var fCancellationToken)) + { + fCancellationToken = new FCancellationToken(); + } + + fCancellationToken._isCancel = false; + fCancellationToken._isDispose = false; + return fCancellationToken; + } + } + + #endregion + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/FTask/FTask.Extension/FTask.Factory.cs b/FantasyNetTest/NBC/Core/FTask/FTask.Extension/FTask.Factory.cs new file mode 100644 index 0000000..6b97855 --- /dev/null +++ b/FantasyNetTest/NBC/Core/FTask/FTask.Extension/FTask.Factory.cs @@ -0,0 +1,115 @@ +#if !FANTASY_WEBGL +using System.Collections.Concurrent; +#endif +using System.Collections.Generic; +using System.Diagnostics; +using System.Runtime.CompilerServices; +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. + +namespace NBC +{ + /// + /// 一个异步任务 + /// + public partial class FTask + { + private bool _isPool; +#if FANTASY_WEBGL + private static readonly Queue Caches = new Queue(); +#else + private static readonly ConcurrentQueue Caches = new ConcurrentQueue(); +#endif + /// + /// 创建一个空的任务 + /// + public static FTaskCompleted CompletedTask => new FTaskCompleted(); + + private FTask() { } + + /// + /// 创建一个任务 + /// + /// 是否从对象池中创建 + /// + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static FTask Create(bool isPool = true) + { + if (!isPool) + { + return new FTask(); + } + + if (!Caches.TryDequeue(out var fTask)) + { + fTask = new FTask(); + } + + fTask._isPool = true; + return fTask; + } + + private void Return() + { + if (!_isPool || Caches.Count > 2000) + { + return; + } + + _callBack = null; + _status = STaskStatus.Pending; + Caches.Enqueue(this); + } + } + + /// + /// 一个异步任务 + /// + /// 任务的泛型类型 + public partial class FTask + { + private bool _isPool; +#if FANTASY_WEBGL + private static readonly Queue> Caches = new Queue>(); +#else + private static readonly ConcurrentQueue> Caches = new ConcurrentQueue>(); +#endif + /// + /// 创建一个任务 + /// + /// 是否从对象池中创建 + /// + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static FTask Create(bool isPool = true) + { + if (!isPool) + { + return new FTask(); + } + + if (!Caches.TryDequeue(out var fTask)) + { + fTask = new FTask(); + } + + fTask._isPool = true; + return fTask; + } + + private FTask() { } + + private void Return() + { + if (!_isPool || Caches.Count > 2000) + { + return; + } + + _callBack = null; + _status = STaskStatus.Pending; + Caches.Enqueue(this); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/FTask/FTask.Extension/FTask.Tools.cs b/FantasyNetTest/NBC/Core/FTask/FTask.Extension/FTask.Tools.cs new file mode 100644 index 0000000..33afec2 --- /dev/null +++ b/FantasyNetTest/NBC/Core/FTask/FTask.Extension/FTask.Tools.cs @@ -0,0 +1,344 @@ +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract + +using System; +using System.Collections.Generic; +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +namespace NBC +{ + public partial class FTask + { + #region NetTimer + + /// + /// 异步等待指定时间 + /// + /// + /// + /// + /// + public static FTask Wait(Scene scene, long time, FCancellationToken cancellationToken = null) + { + return scene.TimerComponent.Net.WaitAsync(time, cancellationToken); + } + + /// + /// 异步等待直到指定时间 + /// + /// + /// + /// + /// + public static FTask WaitTill(Scene scene, long time, FCancellationToken cancellationToken = null) + { + return scene.TimerComponent.Net.WaitTillAsync(time, cancellationToken); + } + + /// + /// 异步等待一帧时间 + /// + /// + /// + public static FTask WaitFrame(Scene scene) + { + return scene.TimerComponent.Net.WaitFrameAsync(); + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间 + /// + /// + /// + /// + /// + public static long OnceTimer(Scene scene, long time, Action action) + { + return scene.TimerComponent.Net.OnceTimer(time, action); + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间。 + /// + /// + /// + /// + /// + public static long OnceTillTimer(Scene scene, long time, Action action) + { + return scene.TimerComponent.Net.OnceTillTimer(time, action); + } + + /// + /// 创建一个只执行一次的计时器，用于发布指定类型的事件。 + /// + /// + /// + /// + /// + /// + public static long OnceTimer(Scene scene, long time, T timerHandlerType) where T : struct + { + return scene.TimerComponent.Net.OnceTimer(time, timerHandlerType); + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间，用于发布指定类型的事件。 + /// + /// + /// + /// + /// + /// + public static long OnceTillTimer(Scene scene, long tillTime, T timerHandlerType) where T : struct + { + return scene.TimerComponent.Net.OnceTillTimer(tillTime, timerHandlerType); + } + + /// + /// 创建一个重复执行的计时器。 + /// + /// + /// + /// + /// + public static long RepeatedTimer(Scene scene, long time, Action action) + { + return scene.TimerComponent.Net.RepeatedTimer(time, action); + } + + /// + /// 创建一个重复执行的计时器，用于发布指定类型的事件。 + /// + /// + /// + /// + /// + /// + public static long RepeatedTimer(Scene scene, long time, T timerHandlerType) where T : struct + { + return scene.TimerComponent.Net.RepeatedTimer(time, timerHandlerType); + } + + /// + /// 移除指定 ID 的计时器。 + /// + /// + /// + /// + public static bool RemoveTimer(Scene scene, ref long timerId) + { + return scene.TimerComponent.Net.Remove(ref timerId); + } + + #endregion + + #region Unity + + /// + /// 异步等待指定时间。（使用Unity的Time时间） + /// + /// + /// + /// + /// + public static FTask UnityWait(Scene scene, long time, FCancellationToken cancellationToken = null) + { + return scene.TimerComponent.Unity.WaitAsync(time, cancellationToken); + } + + /// + /// 异步等待直到指定时间。（使用Unity的Time时间） + /// + /// + /// + /// + /// + public static FTask UnityWaitTill(Scene scene, long time, FCancellationToken cancellationToken = null) + { + return scene.TimerComponent.Unity.WaitTillAsync(time, cancellationToken); + } + + /// + /// 异步等待一帧时间。（使用Unity的Time时间） + /// + /// + /// + public static FTask UnityWaitFrame(Scene scene) + { + return scene.TimerComponent.Unity.WaitFrameAsync(); + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间。（使用Unity的Time时间） + /// + /// + /// + /// + /// + public static long UnityOnceTimer(Scene scene, long time, Action action) + { + return scene.TimerComponent.Unity.OnceTimer(time, action); + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间。（使用Unity的Time时间） + /// + /// + /// + /// + /// + public static long UnityOnceTillTimer(Scene scene, long time, Action action) + { + return scene.TimerComponent.Unity.OnceTillTimer(time, action); + } + + /// + /// 创建一个只执行一次的计时器，用于发布指定类型的事件。（使用Unity的Time时间） + /// + /// + /// + /// + /// + /// + public static long UnityOnceTimer(Scene scene, long time, T timerHandlerType) where T : struct + { + return scene.TimerComponent.Unity.OnceTimer(time, timerHandlerType); + } + + /// + /// 创建一个只执行一次的计时器，直到指定时间，用于发布指定类型的事件。（使用Unity的Time时间） + /// + /// + /// + /// + /// + /// + public static long UnityOnceTillTimer(Scene scene, long tillTime, T timerHandlerType) where T : struct + { + return scene.TimerComponent.Unity.OnceTillTimer(tillTime, timerHandlerType); + } + + /// + /// 创建一个重复执行的计时器。（使用Unity的Time时间） + /// + /// + /// + /// + /// + public static long UnityRepeatedTimer(Scene scene, long time, Action action) + { + return scene.TimerComponent.Unity.RepeatedTimer(time, action); + } + + /// + /// 创建一个重复执行的计时器，用于发布指定类型的事件。（使用Unity的Time时间） + /// + /// + /// + /// + /// + /// + public static long UnityRepeatedTimer(Scene scene, long time, T timerHandlerType) where T : struct + { + return scene.TimerComponent.Unity.RepeatedTimer(time, timerHandlerType); + } + + /// + /// 移除指定 ID 的计时器。（使用Unity的Time时间） + /// + /// + /// + /// + public static bool UnityRemoveTimer(Scene scene, ref long timerId) + { + return scene.TimerComponent.Unity.Remove(ref timerId); + } + + + #endregion + + /// + /// 创建并运行一个异步任务 + /// + /// + /// + public static FTask Run(Func factory) + { + return factory(); + } + + /// + /// 创建并运行一个带有结果的异步任务 + /// + /// + /// + /// + public static FTask Run(Func> factory) + { + return factory(); + } + + /// + /// 等待所有任务完成 + /// + /// + public static async FTask WaitAll(List tasks) + { + if (tasks.Count <= 0) + { + return; + } + + var count = tasks.Count; + var sTaskCompletionSource = Create(); + + foreach (var task in tasks) + { + RunSTask(task).Coroutine(); + } + + await sTaskCompletionSource; + + async FVoid RunSTask(FTask task) + { + await task; + count--; + if (count <= 0) + { + sTaskCompletionSource.SetResult(); + } + } + } + /// + /// 等待其中一个任务完成 + /// + /// + public static async FTask WaitAny(List tasks) + { + if (tasks.Count <= 0) + { + return; + } + + var count = 1; + var sTaskCompletionSource = Create(); + + foreach (var task in tasks) + { + RunSTask(task).Coroutine(); + } + + await sTaskCompletionSource; + + async FVoid RunSTask(FTask task) + { + await task; + count--; + if (count == 0) + { + sTaskCompletionSource.SetResult(); + } + } + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/FTask/Task/FTask.cs b/FantasyNetTest/NBC/Core/FTask/Task/FTask.cs new file mode 100644 index 0000000..a823e75 --- /dev/null +++ b/FantasyNetTest/NBC/Core/FTask/Task/FTask.cs @@ -0,0 +1,263 @@ +using System; +using System.Diagnostics; +using System.Runtime.CompilerServices; +using System.Runtime.ExceptionServices; +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +// ReSharper disable ConditionalAccessQualifierIsNonNullableAccordingToAPIContract +// ReSharper disable CheckNamespace +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8603 // Possible null reference return. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. + +namespace NBC +{ + public enum STaskStatus : byte + { + Pending = 0, // The operation has not yet completed. + Succeeded = 1, // The operation completed successfully. + Faulted = 2 // The operation completed with an error. + } + + [AsyncMethodBuilder(typeof(AsyncFTaskMethodBuilder))] + public sealed partial class FTask : ICriticalNotifyCompletion + { + private Action _callBack; + private ExceptionDispatchInfo _exception; + private STaskStatus _status = STaskStatus.Pending; + public bool IsCompleted + { + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + get => _status != STaskStatus.Pending; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public FTask GetAwaiter() => this; + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private async FVoid InnerCoroutine() + { + await this; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void Coroutine() + { + InnerCoroutine().Coroutine(); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void GetResult() + { + switch (_status) + { + case STaskStatus.Succeeded: + { + Return(); + return; + } + case STaskStatus.Faulted: + { + Return(); + + if (_exception == null) + { + return; + } + + var exception = _exception; + _exception = null; + exception.Throw(); + return; + } + default: + { + throw new NotSupportedException("Direct call to getResult is not allowed"); + } + } + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetResult() + { + if (_status != STaskStatus.Pending) + { + throw new InvalidOperationException("The task has been completed"); + } + + _status = STaskStatus.Succeeded; + + if (_callBack == null) + { + return; + } + + var callBack = _callBack; + _callBack = null; + callBack.Invoke(); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void OnCompleted(Action action) + { + UnsafeOnCompleted(action); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void UnsafeOnCompleted(Action action) + { + if (_status != STaskStatus.Pending) + { + action?.Invoke(); + return; + } + + _callBack = action; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetException(Exception exception) + { + if (_status != STaskStatus.Pending) + { + throw new InvalidOperationException("The task has been completed"); + } + + _status = STaskStatus.Faulted; + _exception = ExceptionDispatchInfo.Capture(exception); + _callBack?.Invoke(); + } + } + + [AsyncMethodBuilder(typeof(AsyncFTaskMethodBuilder<>))] + public sealed partial class FTask : ICriticalNotifyCompletion + { + private T _value; + private Action _callBack; + private ExceptionDispatchInfo _exception; + private STaskStatus _status = STaskStatus.Pending; + public bool IsCompleted + { + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + get => _status != STaskStatus.Pending; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public FTask GetAwaiter() => this; + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + [DebuggerHidden] + private async FVoid InnerCoroutine() + { + await this; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void Coroutine() + { + InnerCoroutine().Coroutine(); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public T GetResult() + { + switch (_status) + { + case STaskStatus.Succeeded: + { + var value = _value; + Return(); + return value; + } + case STaskStatus.Faulted: + { + Return(); + + if (_exception == null) + { + return default; + } + + var exception = _exception; + _exception = null; + exception.Throw(); + return default; + } + default: + { + throw new NotSupportedException("Direct call to getResult is not allowed"); + } + } + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetResult(T value) + { + if (_status != STaskStatus.Pending) + { + throw new InvalidOperationException("The task has been completed"); + } + + _value = value; + _status = STaskStatus.Succeeded; + + if (_callBack == null) + { + return; + } + + var callBack = _callBack; + _callBack = null; + callBack.Invoke(); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void OnCompleted(Action action) + { + UnsafeOnCompleted(action); + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void UnsafeOnCompleted(Action action) + { + if (_status != STaskStatus.Pending) + { + action?.Invoke(); + return; + } + + _callBack = action; + } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetException(Exception exception) + { + if (_status != STaskStatus.Pending) + { + throw new InvalidOperationException("The task has been completed"); + } + + _status = STaskStatus.Faulted; + _exception = ExceptionDispatchInfo.Capture(exception); + _callBack?.Invoke(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/FTask/Task/FTaskCompleted.cs b/FantasyNetTest/NBC/Core/FTask/Task/FTaskCompleted.cs new file mode 100644 index 0000000..cedb73f --- /dev/null +++ b/FantasyNetTest/NBC/Core/FTask/Task/FTaskCompleted.cs @@ -0,0 +1,31 @@ +using System; +using System.Diagnostics; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC +{ + [StructLayout(LayoutKind.Auto)] + [AsyncMethodBuilder(typeof(AsyncFTaskCompletedMethodBuilder))] + public struct FTaskCompleted : ICriticalNotifyCompletion + { + [DebuggerHidden] + public bool IsCompleted => true; + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public FTaskCompleted GetAwaiter() + { + return this; + } + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void GetResult() { } + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void OnCompleted(Action continuation) { } + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void UnsafeOnCompleted(Action continuation) { } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/FTask/Task/FVoid.cs b/FantasyNetTest/NBC/Core/FTask/Task/FVoid.cs new file mode 100644 index 0000000..032785e --- /dev/null +++ b/FantasyNetTest/NBC/Core/FTask/Task/FVoid.cs @@ -0,0 +1,29 @@ +using System; +using System.Diagnostics; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; + +namespace NBC +{ + [StructLayout(LayoutKind.Auto)] + [AsyncMethodBuilder(typeof(AsyncFVoidMethodBuilder))] + internal struct FVoid : ICriticalNotifyCompletion + { + public bool IsCompleted + { + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + get => true; + } + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void Coroutine() { } + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void OnCompleted(Action continuation) { } + + [DebuggerHidden] + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void UnsafeOnCompleted(Action continuation) { } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/ByteHelper.cs b/FantasyNetTest/NBC/Core/Helper/ByteHelper.cs new file mode 100644 index 0000000..24a8597 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/ByteHelper.cs @@ -0,0 +1,344 @@ +using System; +using System.Buffers; +using System.IO; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +using System.Text; +using NBC.Async; + +namespace NBC.Helper +{ + /// + /// 提供字节操作辅助方法的静态类。 + /// + public static class ByteHelper + { + private static readonly string[] Suffix = { "Byte", "KB", "MB", "GB", "TB" }; + + /// + /// 从指定的文件流中读取一个 64 位整数。 + /// + public static long ReadInt64(FileStream stream) + { + var buffer = new byte[8]; + stream.Read(buffer, 0, 8); + return BitConverter.ToInt64(buffer, 0); + } + + /// + /// 从指定的文件流中读取一个 32 位整数。 + /// + public static int ReadInt32(FileStream stream) + { + var buffer = new byte[4]; + stream.Read(buffer, 0, 4); + return BitConverter.ToInt32(buffer, 0); + } + + /// + /// 从指定的内存流中读取一个 64 位整数。 + /// + public static long ReadInt64(MemoryStream stream) + { + var buffer = new byte[8]; + stream.Read(buffer, 0, 8); + return BitConverter.ToInt64(buffer, 0); + } + + /// + /// 从指定的内存流中读取一个 32 位整数。 + /// + public static int ReadInt32(MemoryStream stream) + { + var buffer = new byte[4]; + stream.Read(buffer, 0, 4); + return BitConverter.ToInt32(buffer, 0); + } + + /// + /// 将字节转换为十六进制字符串表示。 + /// + public static string ToHex(this byte b) + { + return b.ToString("X2"); + } + + /// + /// 将字节数组转换为十六进制字符串表示。 + /// + public static string ToHex(this byte[] bytes) + { + var stringBuilder = new StringBuilder(); + foreach (var b in bytes) + { + stringBuilder.Append(b.ToString("X2")); + } + + return stringBuilder.ToString(); + } + + /// + /// 将字节数组按指定格式转换为十六进制字符串表示。 + /// + public static string ToHex(this byte[] bytes, string format) + { + var stringBuilder = new StringBuilder(); + foreach (var b in bytes) + { + stringBuilder.Append(b.ToString(format)); + } + + return stringBuilder.ToString(); + } + + /// + /// 将字节数组的指定范围按十六进制格式转换为字符串表示。 + /// + public static string ToHex(this byte[] bytes, int offset, int count) + { + var stringBuilder = new StringBuilder(); + for (var i = offset; i < offset + count; ++i) + { + stringBuilder.Append(bytes[i].ToString("X2")); + } + + return stringBuilder.ToString(); + } + + /// + /// 将字节数组转换为默认编码的字符串表示。 + /// + public static string ToStr(this byte[] bytes) + { + return Encoding.Default.GetString(bytes); + } + + /// + /// 将字节数组的指定范围按默认编码转换为字符串表示。 + /// + public static string ToStr(this byte[] bytes, int index, int count) + { + return Encoding.Default.GetString(bytes, index, count); + } + + /// + /// 将字节数组转换为 UTF-8 编码的字符串表示。 + /// + public static string Utf8ToStr(this byte[] bytes) + { + return Encoding.UTF8.GetString(bytes); + } + + /// + /// 将字节数组的指定范围按 UTF-8 编码转换为字符串表示。 + /// + public static string Utf8ToStr(this byte[] bytes, int index, int count) + { + return Encoding.UTF8.GetString(bytes, index, count); + } + + /// + /// 将无符号整数写入字节数组的指定偏移位置。 + /// + public static void WriteTo(this byte[] bytes, int offset, uint num) + { + bytes[offset] = (byte)(num & 0xff); + bytes[offset + 1] = (byte)((num & 0xff00) >> 8); + bytes[offset + 2] = (byte)((num & 0xff0000) >> 16); + bytes[offset + 3] = (byte)((num & 0xff000000) >> 24); + } + + /// + /// 将有符号整数写入字节数组的指定偏移位置。 + /// + public static void WriteTo(this byte[] bytes, int offset, int num) + { + bytes[offset] = (byte)(num & 0xff); + bytes[offset + 1] = (byte)((num & 0xff00) >> 8); + bytes[offset + 2] = (byte)((num & 0xff0000) >> 16); + bytes[offset + 3] = (byte)((num & 0xff000000) >> 24); + } + + /// + /// 将字节写入字节数组的指定偏移位置。 + /// + public static void WriteTo(this byte[] bytes, int offset, byte num) + { + bytes[offset] = num; + } + + /// + /// 将有符号短整数写入字节数组的指定偏移位置。 + /// + public static void WriteTo(this byte[] bytes, int offset, short num) + { + bytes[offset] = (byte)(num & 0xff); + bytes[offset + 1] = (byte)((num & 0xff00) >> 8); + } + + /// + /// 将无符号短整数写入字节数组的指定偏移位置。 + /// + public static void WriteTo(this byte[] bytes, int offset, ushort num) + { + bytes[offset] = (byte)(num & 0xff); + bytes[offset + 1] = (byte)((num & 0xff00) >> 8); + } + + /// + /// 将字节数转换为可读的速度表示。 + /// + /// 字节数 + /// 可读的速度表示 + public static string ToReadableSpeed(this long byteCount) + { + var i = 0; + double dblSByte = byteCount; + if (byteCount <= 1024) + { + return $"{dblSByte:0.##}{Suffix[i]}"; + } + + for (i = 0; byteCount / 1024 > 0; i++, byteCount /= 1024) + { + dblSByte = byteCount / 1024.0; + } + + return $"{dblSByte:0.##}{Suffix[i]}"; + } + + /// + /// 将字节数转换为可读的速度表示。 + /// + /// 字节数 + /// 可读的速度表示 + public static string ToReadableSpeed(this ulong byteCount) + { + var i = 0; + double dblSByte = byteCount; + + if (byteCount <= 1024) + { + return $"{dblSByte:0.##}{Suffix[i]}"; + } + + for (i = 0; byteCount / 1024 > 0; i++, byteCount /= 1024) + { + dblSByte = byteCount / 1024.0; + } + + return $"{dblSByte:0.##}{Suffix[i]}"; + } + + /// + /// 合并两个字节数组。 + /// + /// 第一个字节数组 + /// 第二个字节数组 + /// 合并后的字节数组 + public static byte[] MergeBytes(byte[] bytes, byte[] otherBytes) + { + var result = new byte[bytes.Length + otherBytes.Length]; + bytes.CopyTo(result, 0); + otherBytes.CopyTo(result, bytes.Length); + return result; + } + + /// + /// 根据int值获取字节数组。 + /// + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void GetBytes(this int value, byte[] buffer) + { + if (buffer.Length < 4) + { + throw new ArgumentException("Buffer too small."); + } + + MemoryMarshal.Write(buffer.AsSpan(), ref value); + } + + /// + /// 根据int值获取字节数组。 + /// + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void WriteBytes(this MemoryStream memoryStream, int value) + { + using var memoryOwner = MemoryPool.Shared.Rent(4); + var memorySpan = memoryOwner.Memory.Span; + + MemoryMarshal.Write(memorySpan, ref value); + memoryStream.Write(memorySpan); + } + + /// + /// 根据uint值获取字节数组。 + /// + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void GetBytes(ref this uint value, byte[] buffer) + { + if (buffer.Length < 4) + { + throw new ArgumentException("Buffer too small."); + } + + MemoryMarshal.Write(buffer.AsSpan(), ref value); + + } + + /// + /// 根据uint值获取字节数组。 + /// + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void WriteBytes(this MemoryStream memoryStream, uint value) + { + using var memoryOwner = MemoryPool.Shared.Rent(4); + var memorySpan = memoryOwner.Memory.Span; + MemoryMarshal.Write(memorySpan, ref value); + memoryStream.Write(memorySpan); + } + + /// + /// 根据int值获取字节数组。 + /// + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void GetBytes(this long value, byte[] buffer) + { + if (buffer.Length < 8) + { + throw new ArgumentException("Buffer too small."); + } + MemoryMarshal.Write(buffer.AsSpan(), ref value); + } + + /// + /// 根据uint值获取字节数组。 + /// + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void WriteBytes(this MemoryStream memoryStream, long value) + { + using var memoryOwner = MemoryPool.Shared.Rent(8); + var memorySpan = memoryOwner.Memory.Span; + MemoryMarshal.Write(memorySpan, ref value); + memoryStream.Write(memorySpan); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/EncryptHelper.cs b/FantasyNetTest/NBC/Core/Helper/EncryptHelper.cs new file mode 100644 index 0000000..e5aff2c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/EncryptHelper.cs @@ -0,0 +1,59 @@ +using System.IO; +using System.Security.Cryptography; +using System.Text; + +namespace NBC.Helper +{ + /// + /// 提供计算 MD5 散列值的辅助方法。 + /// + public static partial class EncryptHelper + { + private static readonly SHA256 Sha256Hash = SHA256.Create(); + + /// + /// 计算指定字节数组的Sha256。 + /// + /// + /// + public static byte[] ComputeSha256Hash(byte[] bytes) + { + using var sha256Hash = SHA256.Create(); + return sha256Hash.ComputeHash(bytes); + } + + /// + /// 计算指定文件的 MD5 散列值。 + /// + /// 要计算散列值的文件路径。 + /// 表示文件的 MD5 散列值的字符串。 + public static string FileMD5(string filePath) + { + using var file = new FileStream(filePath, FileMode.Open); + return FileMD5(file); + } + + /// + /// 计算给定文件流的 MD5 散列值。 + /// + /// 要计算散列值的文件流。 + /// 表示文件流的 MD5 散列值的字符串。 + public static string FileMD5(FileStream fileStream) + { + var md5 = MD5.Create(); + return md5.ComputeHash(fileStream).ToHex("x2"); + } + + /// + /// 计算给定字节数组的 MD5 散列值。 + /// + /// 要计算散列值的字节数组。 + /// 表示字节数组的 MD5 散列值的字符串。 + public static string BytesMD5(byte[] bytes) + { + var md5 = MD5.Create(); + bytes = md5.ComputeHash(bytes); + return bytes.ToHex("x2"); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/FileHelper.cs b/FantasyNetTest/NBC/Core/Helper/FileHelper.cs new file mode 100644 index 0000000..259534f --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/FileHelper.cs @@ -0,0 +1,186 @@ +using System.Collections.Generic; +using System.IO; +using System.Text; +using System.Threading.Tasks; + +namespace NBC.Helper +{ + /// + /// 文件操作助手类，提供了各种文件操作方法。 + /// + public static partial class FileHelper + { + /// + /// 获取相对路径的完整路径。 + /// + /// 相对路径。 + /// 完整路径。 + public static string GetFullPath(string relativePath) + { + return Path.GetFullPath(Path.Combine(Directory.GetCurrentDirectory(), relativePath)); + } + + /// + /// 获取相对路径的完整路径。 + /// + /// 相对于指定的目录的相对路径。 + /// 指定的目录 + /// 完整路径。 + public static string GetFullPath(string relativePath, string srcDir) + { + return Path.GetFullPath(Path.Combine(srcDir, relativePath)); + } + + /// + /// 获取相对路径的的文本信息。 + /// + /// + /// + public static async Task GetTextByRelativePath(string relativePath) + { + var fullPath = GetFullPath(relativePath); + return await File.ReadAllTextAsync(fullPath, Encoding.UTF8); + } + + /// + /// 获取绝对路径的的文本信息。 + /// + /// + /// + public static async Task GetText(string fullPath) + { + return await File.ReadAllTextAsync(fullPath, Encoding.UTF8); + } + + /// + /// 根据文件夹路径创建文件夹，如果文件夹不存在会自动创建文件夹。 + /// + /// + public static void CreateDirectory(string directoryPath) + { + if (directoryPath.LastIndexOf('/') != directoryPath.Length - 1) + { + directoryPath += "/"; + } + + var directoriesByFilePath = GetDirectoriesByFilePath(directoryPath); + + foreach (var dir in directoriesByFilePath) + { + if (Directory.Exists(dir)) + { + continue; + } + + Directory.CreateDirectory(dir); + } + } + + /// + /// 将文件复制到目标路径，如果目标目录不存在会自动创建目录。 + /// + /// 源文件路径。 + /// 目标文件路径。 + /// 是否覆盖已存在的目标文件。 + public static void Copy(string sourceFile, string destinationFile, bool overwrite) + { + CreateDirectory(destinationFile); + File.Copy(sourceFile, destinationFile, overwrite); + } + + /// + /// 获取文件路径内的所有文件夹路径。 + /// + /// 文件路径。 + /// 文件夹路径列表。 + public static IEnumerable GetDirectoriesByFilePath(string filePath) + { + var dir = ""; + var fileDirectories = filePath.Split('/'); + + for (var i = 0; i < fileDirectories.Length - 1; i++) + { + dir = $"{dir}{fileDirectories[i]}/"; + yield return dir; + } + + if (fileDirectories.Length == 1) + { + yield return filePath; + } + } + + /// + /// 将文件夹内的所有内容复制到目标位置。 + /// + /// 源文件夹路径。 + /// 目标文件夹路径。 + /// 是否覆盖已存在的文件。 + public static void CopyDirectory(string sourceDirectory, string destinationDirectory, bool overwrite) + { + // 创建目标文件夹 + + if (!Directory.Exists(destinationDirectory)) + { + Directory.CreateDirectory(destinationDirectory); + } + + // 获取当前文件夹中的所有文件 + + var files = Directory.GetFiles(sourceDirectory); + + // 拷贝文件到目标文件夹 + + foreach (var file in files) + { + var fileName = Path.GetFileName(file); + var destinationPath = Path.Combine(destinationDirectory, fileName); + File.Copy(file, destinationPath, overwrite); + } + + // 获取源文件夹中的所有子文件夹 + + var directories = Directory.GetDirectories(sourceDirectory); + + // 递归方式拷贝文件夹 + + foreach (var directory in directories) + { + var directoryName = Path.GetFileName(directory); + var destinationPath = Path.Combine(destinationDirectory, directoryName); + CopyDirectory(directory, destinationPath, overwrite); + } + } + + /// + /// 获取目录下的所有文件 + /// + /// 文件夹路径。 + /// 需要查找的文件通配符 + /// 查找的类型 + /// + public static string[] GetDirectoryFile(string folderPath, string searchPattern, SearchOption searchOption) + { + return Directory.GetFiles(folderPath, searchPattern, searchOption); + } + + /// + /// 清空文件夹内的所有文件。 + /// + /// 文件夹路径。 + public static void ClearDirectoryFile(string folderPath) + { + if (!Directory.Exists(folderPath)) + { + return; + } + + var files = Directory.GetFiles(folderPath); + + foreach (var file in files) + { + File.Delete(file); + } + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/HashCodeHelper.cs b/FantasyNetTest/NBC/Core/Helper/HashCodeHelper.cs new file mode 100644 index 0000000..0babf0c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/HashCodeHelper.cs @@ -0,0 +1,143 @@ +using System.Security.Cryptography; +using System.Text; +// ReSharper disable InconsistentNaming + +namespace NBC.Helper +{ + /// + /// HashCode算法帮助类 + /// + public static partial class HashCodeHelper + { + private static readonly SHA256 Sha256Hash = SHA256.Create(); + + /// + /// 计算两个字符串的HashCode + /// + /// + /// + /// + public static int GetHashCode(string a, string b) + { + var hash = 17; + hash = hash * 31 + a.GetHashCode(); + hash = hash * 31 + b.GetHashCode(); + return hash; + } + + /// + /// 使用bkdr算法生成一个long的值 + /// + /// + /// + public static unsafe long GetBKDRHashCode(string str) + { + ulong hash = 0; + // 如果要修改这个种子、建议选择一个质数来做种子 + const uint seed = 13131; // 31 131 1313 13131 131313 etc.. + fixed (char* p = str) + { + for (var i = 0; i < str.Length; i++) + { + var c = p[i]; + var high = (byte)(c >> 8); + var low = (byte)(c & byte.MaxValue); + hash = hash * seed + high; + hash = hash * seed + low; + } + } + return (long)hash; + } + + /// + /// 使用MurmurHash3算法生成一个uint的值 + /// + /// + /// + public static unsafe uint MurmurHash3(string str) + { + const uint seed = 0xc58f1a7b; + uint hash = seed; + uint c1 = 0xcc9e2d51; + uint c2 = 0x1b873593; + + fixed (char* p = str) + { + var current = p; + + for (var i = 0; i < str.Length; i++) + { + var k1 = (uint)(*current); + k1 *= c1; + k1 = (k1 << 15) | (k1 >> (32 - 15)); + k1 *= c2; + + hash ^= k1; + hash = (hash << 13) | (hash >> (32 - 13)); + hash = hash * 5 + 0xe6546b64; + + current++; + } + } + + hash ^= (uint)str.Length; + hash ^= hash >> 16; + hash *= 0x85ebca6b; + hash ^= hash >> 13; + hash *= 0xc2b2ae35; + hash ^= hash >> 16; + return hash; + } + + /// + /// 使用MurmurHash3算法生成一个long的值 + /// + /// + /// + public static unsafe long ComputeHash64(string str) + { + const ulong seed = 0xc58f1a7bc58f1a7bUL; // 64-bit seed + var hash = seed; + var c1 = 0x87c37b91114253d5UL; + var c2 = 0x4cf5ad432745937fUL; + + fixed (char* p = str) + { + var current = p; + + for (var i = 0; i < str.Length; i++) + { + var k1 = (ulong)(*current); + k1 *= c1; + k1 = (k1 << 31) | (k1 >> (64 - 31)); + k1 *= c2; + + hash ^= k1; + hash = (hash << 27) | (hash >> (64 - 27)); + hash = hash * 5 + 0x52dce729; + + current++; + } + } + + hash ^= (ulong)str.Length; + hash ^= hash >> 33; + hash *= 0xff51afd7ed558ccdUL; + hash ^= hash >> 33; + hash *= 0xc4ceb9fe1a85ec53UL; + hash ^= hash >> 33; + return (long)hash; + } + + /// + /// 根据字符串计算一个Hash值 + /// + /// + /// + public static int ComputeSha256HashAsInt(string rawData) + { + var bytes = Sha256Hash.ComputeHash(Encoding.UTF8.GetBytes(rawData)); + return (bytes[0] << 24) | (bytes[1] << 16) | (bytes[2] << 8) | bytes[3]; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientHelper.cs b/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientHelper.cs new file mode 100644 index 0000000..33739cc --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientHelper.cs @@ -0,0 +1,145 @@ +#if !FANTASY_WEBGL +using System; +using System.Net; +using System.Net.Http; +using System.Net.Http.Headers; +using System.Text; +using NBC.Helper; +using NBC.Async; +using NBC.Pool; + +#pragma warning disable CS8603 // Possible null reference return. + +namespace NBC.Http +{ + /// + /// HTTP帮助类 + /// + public static partial class HttpClientHelper + { + private static readonly HttpClient Client = new HttpClient(new HttpClientHandler + { + ServerCertificateCustomValidationCallback = (sender, cert, chain, sslPolicyErrors) => true + }); + + /// + /// 用Post方式请求string数据 + /// + /// + /// + /// + /// + public static async FTask CallNotDeserializeByPost(string url, HttpContent content) + { + var response = await Client.PostAsync(url, content); + + if (response.StatusCode != HttpStatusCode.OK) + { + throw new Exception($"Unable to connect to server url {(object)url} HttpStatusCode:{(object)response.StatusCode}"); + } + + return await response.Content.ReadAsStringAsync(); + } + + /// + /// 用Get方式请求string数据 + /// + /// + /// + /// + public static async FTask CallNotDeserializeByGet(string url) + { + var response = await Client.GetAsync(url); + + if (response.StatusCode != HttpStatusCode.OK) + { + throw new Exception($"Unable to connect to server url {(object)url} HttpStatusCode:{(object)response.StatusCode}"); + } + + return await response.Content.ReadAsStringAsync(); + } + + /// + /// 用Post方式请求JSON数据，并自动把JSON转换为对象。 + /// + /// + /// + /// + /// + public static async FTask CallByPost(string url, HttpContent content) + { + return await Deserialize(url, await Client.PostAsync(url, content)); + } + + /// + /// 用Post方式请求JSON数据，并自动把JSON转换为对象。 + /// + /// + /// + /// + /// + public static async FTask CallByPost(string url, HttpMethod method) + { + return await Deserialize(url, await Client.SendAsync(new HttpRequestMessage(method, url))); + } + + /// + /// 用Get方式请求JSON数据，并自动把JSON转换为对象。 + /// + /// + /// + /// + public static async FTask CallByGet(string url) + { + return await Deserialize(url, await Client.GetAsync(url)); + } + + /// + /// 用Post方式请求JSON数据，并自动把JSON转换为对象。 + /// + /// + /// + /// + /// + /// + /// + /// + /// + public static async FTask Call(string url, int id, AuthenticationHeaderValue authentication, string method, params object[] @params) where TRequest : class, IJsonRpcRequest, new() + { + var request = Pool.Rent(); + using var httpClientPool = HttpClientPool.Create(); + var client = httpClientPool.Client; + client.DefaultRequestHeaders.Authorization = authentication; + + try + { + request.Init(method, id, @params); + var content = new StringContent(request.ToJson(), Encoding.UTF8, "application/json"); + var response = await Deserialize(url, await client.PostAsync(url, content)); + return response; + } + catch (Exception e) + { + Log.Error(e); + } + finally + { + Pool.Return(request); + } + + return default; + } + + private static async FTask Deserialize(string url, HttpResponseMessage response) + { + if (response.StatusCode != HttpStatusCode.OK) + { + throw new Exception($"Unable to connect to server url {(object)url} HttpStatusCode:{(object)response.StatusCode}"); + } + + return (await response.Content.ReadAsStringAsync()).Deserialize(); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientHelper.cs.meta b/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientHelper.cs.meta new file mode 100644 index 0000000..70e3bd5 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientHelper.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: f8005f3a1a1945a2929442f82832e765 +timeCreated: 1726023741 \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientPool.cs b/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientPool.cs new file mode 100644 index 0000000..e9c7d6b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientPool.cs @@ -0,0 +1,44 @@ +#if !FANTASY_WEBGL +using System; +using System.Collections.Generic; +using System.Net.Http; +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. + +namespace NBC.Http +{ + internal class HttpClientPool : IDisposable + { + private bool IsDispose { get; set; } + public HttpClient Client { get; private set; } + private static readonly Queue Pools = new Queue(); + private static readonly HttpClientHandler ClientHandler = new HttpClientHandler + { + ServerCertificateCustomValidationCallback = (sender, cert, chain, sslPolicyErrors) => true + }; + + public static HttpClientPool Create() + { + if (Pools.TryDequeue(out var httpClientPool)) + { + httpClientPool.IsDispose = false; + return httpClientPool; + } + + httpClientPool = new HttpClientPool(); + httpClientPool.Client = new HttpClient(ClientHandler); + return httpClientPool; + } + + public void Dispose() + { + if (IsDispose) + { + return; + } + + IsDispose = true; + Pools.Enqueue(this); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientPool.cs.meta b/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientPool.cs.meta new file mode 100644 index 0000000..a1ac3bf --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/HttpClient/HttpClientPool.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: a78c441357d244d5ba490a13c89e1c50 +timeCreated: 1726023895 \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/HttpClient/IJsonRpcRequest.cs b/FantasyNetTest/NBC/Core/Helper/HttpClient/IJsonRpcRequest.cs new file mode 100644 index 0000000..558d5e6 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/HttpClient/IJsonRpcRequest.cs @@ -0,0 +1,20 @@ +using NBC.Pool; + +#if !FANTASY_WEBGL +namespace NBC.Http +{ + /// + /// 一个JsonRPC的接口 + /// + public interface IJsonRpcRequest : IPool + { + /// + /// 用于初始化这个Json对象 + /// + /// + /// + /// + void Init(string method, int id, params object[] @params); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/HttpClient/IJsonRpcRequest.cs.meta b/FantasyNetTest/NBC/Core/Helper/HttpClient/IJsonRpcRequest.cs.meta new file mode 100644 index 0000000..9e01783 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/HttpClient/IJsonRpcRequest.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 72a03580c619417b9f8f92d99938e371 +timeCreated: 1726023900 \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/JsonHelper.cs b/FantasyNetTest/NBC/Core/Helper/JsonHelper.cs new file mode 100644 index 0000000..4f38711 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/JsonHelper.cs @@ -0,0 +1,57 @@ +using System; +using Newtonsoft.Json; +#pragma warning disable CS8603 + +namespace NBC.Helper +{ + /// + /// 提供操作 JSON 数据的辅助方法。 + /// + public static partial class JsonHelper + { + /// + /// 将对象序列化为 JSON 字符串。 + /// + /// 要序列化的对象类型。 + /// 要序列化的对象。 + /// 表示序列化对象的 JSON 字符串。 + public static string ToJson(this T t) + { + return JsonConvert.SerializeObject(t); + } + + /// + /// 反序列化 JSON 字符串为指定类型的对象。 + /// + /// 要反序列化的 JSON 字符串。 + /// 目标对象的类型。 + /// 是否使用反射进行反序列化（默认为 true）。 + /// 反序列化后的对象。 + public static object Deserialize(this string json, Type type, bool reflection = true) + { + return JsonConvert.DeserializeObject(json, type); + } + + /// + /// 反序列化 JSON 字符串为指定类型的对象。 + /// + /// 目标对象的类型。 + /// 要反序列化的 JSON 字符串。 + /// 反序列化后的对象。 + public static T Deserialize(this string json) + { + return JsonConvert.DeserializeObject(json); + } + + /// + /// 克隆对象，通过将对象序列化为 JSON，然后再进行反序列化。 + /// + /// 要克隆的对象类型。 + /// 要克隆的对象。 + /// 克隆后的对象。 + public static T Clone(T t) + { + return t.ToJson().Deserialize(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/NetworkHelper.cs b/FantasyNetTest/NBC/Core/Helper/NetworkHelper.cs new file mode 100644 index 0000000..f84998d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/NetworkHelper.cs @@ -0,0 +1,443 @@ +#if !FANTASY_WEBGL +using System; +using System.Collections.Generic; +using System.Net; +using System.Net.NetworkInformation; +using System.Net.Sockets; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +#pragma warning disable CS8603 // Possible null reference return. + +// ReSharper disable InconsistentNaming + +namespace NBC.Helper +{ + /// + /// 提供网络操作相关的帮助方法。 + /// + public static partial class NetworkHelper + { + /// + /// 根据字符串获取一个IPEndPoint + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static IPEndPoint GetIPEndPoint(string address) + { + try + { + var addressSplit = address.Split(':'); + if (addressSplit.Length != 2) + { + throw new FormatException("Invalid format"); + } + + var ipString = addressSplit[0]; + var portString = addressSplit[1]; + + if (!IPAddress.TryParse(ipString, out var ipAddress)) + { + throw new FormatException("Invalid IP address"); + } + + if (!int.TryParse(portString, out var port) || port < 0 || port > 65535) + { + throw new FormatException("Invalid port number"); + } + + return new IPEndPoint(ipAddress, port); + } + catch (Exception e) + { + Log.Error($"Error parsing IP and Port:{e.Message}"); + return null; + } + } + + /// + /// 克隆一个IPEndPoint + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static IPEndPoint Clone(this EndPoint endPoint) + { + var ip = (IPEndPoint)endPoint; + return new IPEndPoint(ip.Address, ip.Port); + } + + /// + /// 比较两个IPEndPoint是否相等 + /// + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static bool IPEndPointEquals(this EndPoint endPoint, IPEndPoint ipEndPoint) + { + var ip = (IPEndPoint)endPoint; + return ip.Address.Equals(ipEndPoint.Address) && ip.Port == ipEndPoint.Port; + } + + /// + /// 比较两个IPEndPoint是否相等 + /// + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static bool IPEndPointEquals(this IPEndPoint endPoint, IPEndPoint ipEndPoint) + { + return endPoint.Address.Equals(ipEndPoint.Address) && endPoint.Port == ipEndPoint.Port; + } + +#if !FANTASY_WEBGL + /// + /// 将SocketAddress写入到Byte[]中 + /// + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static unsafe void SocketAddressToByte(this SocketAddress socketAddress, byte[] buffer, int offset) + { + if (socketAddress == null) + { + throw new ArgumentNullException(nameof(socketAddress), "The SocketAddress cannot be null."); + } + + if (buffer == null) + { + throw new ArgumentNullException(nameof(buffer), "The buffer cannot be null."); + } + + if (buffer.Length < socketAddress.Size + offset + 8) + { + throw new ArgumentException("The buffer length is insufficient. It must be at least the size of the SocketAddress plus 8 bytes.", nameof(buffer)); + } + + fixed (byte* pBuffer = buffer) + { + var pOffsetBuffer = pBuffer + offset; + var addressFamilyValue = (int)socketAddress.Family; + var socketAddressSizeValue = socketAddress.Size; + Buffer.MemoryCopy(&addressFamilyValue, pOffsetBuffer, buffer.Length - offset, sizeof(int)); + Buffer.MemoryCopy(&socketAddressSizeValue, pOffsetBuffer + 4, buffer.Length - offset -4, sizeof(int)); + for (var i = 0; i < socketAddress.Size - 2; i++) + { + pOffsetBuffer[8 + i] = socketAddress[i + 2]; + } + } + } + + /// + /// 将byre[]转换为SocketAddress + /// + /// + /// + /// + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static unsafe int ByteToSocketAddress(byte[] buffer, int offset, out SocketAddress socketAddress) + { + if (buffer == null) + { + throw new ArgumentNullException(nameof(buffer), "The buffer cannot be null."); + } + + if (buffer.Length < 8) + { + throw new ArgumentException("Buffer length is insufficient. It must be at least 8 bytes.", nameof(buffer)); + } + + try + { + fixed (byte* pBuffer = buffer) + { + var pOffsetBuffer = pBuffer + offset; + var addressFamily = (AddressFamily)Marshal.ReadInt32((IntPtr)pOffsetBuffer); + var socketAddressSize = Marshal.ReadInt32((IntPtr)(pOffsetBuffer + 4)); + + if (buffer.Length < offset + 8 + socketAddressSize) + { + throw new ArgumentException("Buffer length is insufficient for the given SocketAddress size.", nameof(buffer)); + } + + socketAddress = new SocketAddress(addressFamily, socketAddressSize); + + for (var i = 0; i < socketAddressSize - 2; i++) + { + socketAddress[i + 2] = *(pOffsetBuffer + 8 + i); + } + + return 8 + offset + socketAddressSize; + } + } + catch (ArgumentNullException ex) + { + throw new InvalidOperationException("An argument provided to the method is null.", ex); + } + catch (ArgumentException ex) + { + throw new InvalidOperationException("An argument provided to the method is invalid.", ex); + } + catch (Exception ex) + { + throw new InvalidOperationException("An unexpected error occurred while processing the buffer.", ex); + } + } + + /// + /// 将ReadOnlyMemory转换为SocketAddress + /// + /// + /// + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static unsafe int ByteToSocketAddress(ReadOnlyMemory buffer, int offset, out SocketAddress socketAddress) + { + if (buffer.Length < 8) + { + throw new ArgumentException("Buffer length is insufficient. It must be at least 8 bytes.", nameof(buffer)); + } + + try + { + fixed (byte* pBuffer = buffer.Span) + { + var pOffsetBuffer = pBuffer + offset; + var addressFamily = (AddressFamily)Marshal.ReadInt32((IntPtr)pOffsetBuffer); + var socketAddressSize = Marshal.ReadInt32((IntPtr)(pOffsetBuffer + 4)); + + if (buffer.Length < offset + 8 + socketAddressSize) + { + throw new ArgumentException("Buffer length is insufficient for the given SocketAddress size.", nameof(buffer)); + } + + socketAddress = new SocketAddress(addressFamily, socketAddressSize); + + for (var i = 0; i < socketAddressSize - 2; i++) + { + socketAddress[i + 2] = *(pOffsetBuffer + 8 + i); + } + + return 8 + offset + socketAddressSize; + } + } + catch (ArgumentNullException ex) + { + throw new InvalidOperationException("An argument provided to the method is null.", ex); + } + catch (ArgumentException ex) + { + throw new InvalidOperationException("An argument provided to the method is invalid.", ex); + } + catch (Exception ex) + { + throw new InvalidOperationException("An unexpected error occurred while processing the buffer.", ex); + } + } + + /// + /// 根据SocketAddress获得IPEndPoint + /// + /// + /// + /// + public static unsafe IPEndPoint GetIPEndPoint(this SocketAddress socketAddress) + { + switch (socketAddress.Family) + { + case AddressFamily.InterNetwork: + { + var ipBytes = new byte[4]; + for (var i = 0; i < 4; i++) + { + ipBytes[i] = socketAddress[4 + i]; + } + var port = (socketAddress[2] << 8) + socketAddress[3]; + var ip = new IPAddress(ipBytes); + return new IPEndPoint(ip, port); + } + case AddressFamily.InterNetworkV6: + { + var ipBytes = new byte[16]; + Span socketAddressSpan = stackalloc byte[28]; + + for (var i = 0; i < 28; i++) + { + socketAddressSpan[i] = socketAddress[i]; + } + + fixed (byte* pSocketAddress = socketAddressSpan) + { + for (var i = 0; i < 16; i++) + { + ipBytes[i] = *(pSocketAddress + 8 + i); + } + + var port = (*(pSocketAddress + 2) << 8) + *(pSocketAddress + 3); + var scopeId = Marshal.ReadInt64((IntPtr)(pSocketAddress + 24)); + var ip = new IPAddress(ipBytes, scopeId); + return new IPEndPoint(ip, port); + } + } + default: + { + throw new NotSupportedException("Address family not supported."); + } + } + } +#endif + /// + /// 获取本机所有网络适配器的IP地址。 + /// + /// IP地址数组。 + public static string[] GetAddressIPs() + { + var list = new List(); + foreach (var networkInterface in NetworkInterface.GetAllNetworkInterfaces()) + { + // 仅考虑以太网类型的网络适配器 + if (networkInterface.NetworkInterfaceType != NetworkInterfaceType.Ethernet) + { + continue; + } + + foreach (var add in networkInterface.GetIPProperties().UnicastAddresses) + { + list.Add(add.Address.ToString()); + } + } + + return list.ToArray(); + } + + /// + /// 将主机名和端口号转换为 实例。 + /// + /// 主机名。 + /// 端口号。 + /// 实例。 + public static IPEndPoint ToIPEndPoint(string host, int port) + { + return new IPEndPoint(IPAddress.Parse(host), port); + } + + /// + /// 将地址字符串转换为 实例。 + /// + /// 地址字符串，格式为 "主机名:端口号"。 + /// 实例。 + public static IPEndPoint ToIPEndPoint(string address) + { + var index = address.LastIndexOf(':'); + var host = address.Substring(0, index); + var p = address.Substring(index + 1); + var port = int.Parse(p); + return ToIPEndPoint(host, port); + } + + /// + /// 将 实例转换为字符串表示形式。 + /// + /// 实例。 + /// 表示 的字符串。 + public static string IPEndPointToStr(this IPEndPoint self) + { + return $"{self.Address}:{self.Port}"; + } + + /// + /// 针对 Windows 平台设置UDP连接重置选项。 + /// + /// 要设置选项的 实例。 + public static void SetSioUdpConnReset(this Socket socket) + { + if (!RuntimeInformation.IsOSPlatform(OSPlatform.Windows)) + { + return; + } + + /* + 目前这个问题只有Windows下才会出现。 + 服务器端在发送数据时捕获到了一个异常， + 这个异常导致原因应该是远程客户端的UDP监听已停止导致数据发送出错。 + 按理说UDP是无连接的，报这个异常是不合理的 + 这个异常让整UDP的服务监听也停止了。 + 这样就因为一个客户端的数据发送无法到达而导致了服务挂了，所有客户端都无法与服务器通信了 + 想详细了解看下https://blog.csdn.net/sunzhen6251/article/details/124168805*/ + const uint IOC_IN = 0x80000000; + const uint IOC_VENDOR = 0x18000000; + const int SIO_UDP_CONNRESET = unchecked((int) (IOC_IN | IOC_VENDOR | 12)); + + socket.IOControl(SIO_UDP_CONNRESET, new[] {Convert.ToByte(false)}, null); + } + + /// + /// 将 Socket 缓冲区大小设置为操作系统限制。 + /// + /// 要设置缓冲区大小的 Socket。 + public static void SetSocketBufferToOsLimit(this Socket socket) + { + socket.SetReceiveBufferToOSLimit(); + socket.SetSendBufferToOSLimit(); + } + + /// + /// 将 Socket 接收缓冲区大小设置为操作系统限制。 + /// 尝试增加接收缓冲区大小的次数 = 默认 + 最大增加 100 MB。 + /// + /// 要设置接收缓冲区大小的 Socket。 + /// 每次增加的步长大小。 + /// 尝试增加缓冲区大小的次数。 + public static void SetReceiveBufferToOSLimit(this Socket socket, int stepSize = 1024, int attempts = 100_000) + { + // setting a too large size throws a socket exception. + // so let's keep increasing until we encounter it. + for (int i = 0; i < attempts; ++i) + { + // increase in 1 KB steps + try + { + socket.ReceiveBufferSize += stepSize; + } + catch (SocketException) + { + break; + } + } + } + + /// + /// 将 Socket 发送缓冲区大小设置为操作系统限制。 + /// 尝试增加发送缓冲区大小的次数 = 默认 + 最大增加 100 MB。 + /// + /// 要设置发送缓冲区大小的 Socket。 + /// 每次增加的步长大小。 + /// 尝试增加缓冲区大小的次数。 + public static void SetSendBufferToOSLimit(this Socket socket, int stepSize = 1024, int attempts = 100_000) + { + // setting a too large size throws a socket exception. + // so let's keep increasing until we encounter it. + for (var i = 0; i < attempts; ++i) + { + // increase in 1 KB steps + try + { + socket.SendBufferSize += stepSize; + } + catch (SocketException) + { + break; + } + } + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/RandomHelper.cs b/FantasyNetTest/NBC/Core/Helper/RandomHelper.cs new file mode 100644 index 0000000..e048b64 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/RandomHelper.cs @@ -0,0 +1,310 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using System.Numerics; +using NBC.LowLevel; + +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider adding the 'required' modifier or declaring as nullable. + +namespace NBC.Helper +{ + /// + /// 随机数操作助手类，提供各种随机数生成和操作方法。 + /// + public static partial class RandomHelper + { + [ThreadStatic] + private static Random _random; + + /// + /// 生成一个随机的无符号 64 位整数。 + /// + /// 无符号 64 位整数。 + public static ulong RandUInt64() + { + var byte8 = new FixedBytes8().AsSpan(); + var random = _random ??= new Random(); + random.NextBytes(byte8); + return BitConverter.ToUInt64(byte8); + } + + /// + /// 生成一个随机的 64 位整数。 + /// + /// 64 位整数。 + public static long RandInt64() + { + var byte8 = new FixedBytes8().AsSpan(); + var random = _random ??= new Random(); + random.NextBytes(byte8); + return BitConverter.ToInt64(byte8); + } + + /// + /// 生成一个随机的无符号 32 位整数。 + /// + /// 无符号 32 位整数。 + public static uint RandUInt32() + { + var random = _random ??= new Random(); + return (uint) random.Next(); + } + + /// + /// 生成一个随机的无符号 16 位整数。 + /// + /// 无符号 16 位整数。 + public static ushort RandUInt16() + { + var byte2 = new FixedBytes2().AsSpan(); + var random = _random ??= new Random(); + random.NextBytes(byte2); + return BitConverter.ToUInt16(byte2); + } + + /// + /// 在指定范围内生成一个随机整数（包含下限，不包含上限）。 + /// + /// 下限。 + /// 上限。 + /// 生成的随机整数。 + public static int RandomNumber(int lower, int upper) + { + var random = _random ??= new Random(); + return random.Next(lower, upper); + } + + /// + /// 生成一个随机的布尔值。 + /// + /// 随机的布尔值。 + public static bool RandomBool() + { + var random = _random ??= new Random(); + return (random.Next() & 1) == 0; + } + + /// + /// 从数组中随机选择一个元素。 + /// + /// 数组元素的类型。 + /// 要选择的数组。 + /// 随机选择的数组元素。 + public static T RandomArray(this T[] array) + { + return array[RandomNumber(0, array.Count())]; + } + + /// + /// 从列表中随机选择一个元素。 + /// + /// 列表元素的类型。 + /// 要选择的列表。 + /// 随机选择的列表元素。 + public static T RandomArray(this List array) + { + return array[RandomNumber(0, array.Count())]; + } + + /// + /// 打乱列表中元素的顺序。 + /// + /// 列表元素的类型。 + /// 要打乱顺序的列表。 + public static void BreakRank(List arr) + { + if (arr == null || arr.Count < 2) + { + return; + } + + var random = _random ??= new Random(); + for (var i = 0; i < arr.Count / 2; i++) + { + var index = random.Next(0, arr.Count); + (arr[index], arr[arr.Count - index - 1]) = (arr[arr.Count - index - 1], arr[index]); + } + } + + /// + /// 生成一个介于 0 和 1 之间的随机单精度浮点数。 + /// + /// 随机单精度浮点数。 + public static float RandFloat01() + { + var random = _random ??= new Random(); + var value = random.NextDouble(); + return (float) value; + } + + private static int Rand(int n) + { + var rd = new Random(); + // 注意，返回值是左闭右开，所以maxValue要加1 + return rd.Next(1, n + 1); + } + + /// + /// 根据权重随机选择一个索引。 + /// + /// 权重数组，每个元素表示相应索引的权重。 + /// 随机选择的索引值。 + public static int RandomByWeight(int[] weights) + { + var sum = weights.Sum(); + var numberRand = Rand(sum); + var sumTemp = 0; + for (var i = 0; i < weights.Length; i++) + { + sumTemp += weights[i]; + if (numberRand <= sumTemp) + { + return i; + } + } + + return -1; + } + + /// + /// 根据固定概率随机选择一个索引，即某个数值上限内随机多少次。 + /// + /// 概率数组，每个元素表示相应索引的概率。 + /// 随机选择的索引值。 + public static int RandomByFixedProbability(int[] args) + { + var random = _random ??= new Random(); + var argCount = args.Length; + var sum = args.Sum(); + var value = random.NextDouble() * sum; + while (sum > value) + { + sum -= args[argCount - 1]; + argCount--; + } + + return argCount; + } + + /// + /// 返回随机数。 + /// + /// 是否包含负数。 + /// 返回一个随机的单精度浮点数。 + public static float NextFloat(bool containNegative = false) + { + var random = _random ??= new Random(); + float f; + var buffer = new FixedBytes4().AsSpan(); + if (containNegative) + { + do + { + random.NextBytes(buffer); + f = BitConverter.ToSingle(buffer); + } while ((f >= float.MinValue && f < float.MaxValue) == false); + + return f; + } + + do + { + random.NextBytes(buffer); + f = BitConverter.ToSingle(buffer); + } while ((f >= 0 && f < float.MaxValue) == false); + + return f; + } + + /// + /// 返回一个小于所指定最大值的非负随机数。 + /// + /// 要生成的随机数的上限（随机数不能取该上限值）。 maxValue 必须大于或等于零。 + /// 大于等于零且小于 maxValue 的单精度浮点数，即：返回值的范围通常包括零但不包括 maxValue。 不过，如果 maxValue 等于零，则返回 maxValue。 + public static float NextFloat(float maxValue) + { + if (maxValue.Equals(0)) + { + return maxValue; + } + + if (maxValue < 0) + { + throw new ArgumentOutOfRangeException("“maxValue”必须大于 0。", "maxValue"); + } + + var random = _random ??= new Random(); + float f; + var buffer = new FixedBytes4().AsSpan(); + + do + { + random.NextBytes(buffer); + f = BitConverter.ToSingle(buffer); + } while ((f >= 0 && f < maxValue) == false); + + return f; + } + + /// + /// 返回一个指定范围内的随机数。 + /// + /// 返回的随机数的下界（随机数可取该下界值）。 + /// 返回的随机数的上界（随机数不能取该上界值）。 maxValue 必须大于或等于 minValue。 + /// 一个大于等于 minValue 且小于 maxValue 的单精度浮点数，即：返回的值范围包括 minValue 但不包括 maxValue。 如果 minValue 等于 maxValue，则返回 minValue。 + public static float NextFloat(float minValue, float maxValue) + { + if (minValue.Equals(maxValue)) + { + return minValue; + } + + if (minValue > maxValue) + { + throw new ArgumentOutOfRangeException("“minValue”不能大于 maxValue。", "minValue"); + } + + var random = _random ??= new Random(); + var buffer = new FixedBytes4().AsSpan(); + float f; + + do + { + random.NextBytes(buffer); + f = BitConverter.ToSingle(buffer); + } while ((f >= minValue && f < maxValue) == false); + + return f; + } + + /// + /// 在指定的矩形区域内随机生成一个二维向量位置。 + /// + /// X轴最小值。 + /// X轴最大值。 + /// Y轴最小值。 + /// Y轴最大值。 + /// 随机生成的二维向量位置。 + public static Vector2 NextVector2(float minX, float maxX, float minY, float maxY) + { + return new Vector2(NextFloat(minX, maxX), NextFloat(minY, maxY)); + } + + /// + /// 生成指定长度的随机数字代码。 + /// + /// 数字代码的长度。 + /// 生成的随机数字代码。 + public static string RandomNumberCode(int len = 6) + { + int num = 0; + for (int i = 0; i < len; i++) + { + int number = RandomNumber(0, 10); + num = num * 10 + number; + } + + return num.ToString(); + } + } +} diff --git a/FantasyNetTest/NBC/Core/Helper/RandomHelperWebgl.cs b/FantasyNetTest/NBC/Core/Helper/RandomHelperWebgl.cs new file mode 100644 index 0000000..0820acf --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/RandomHelperWebgl.cs @@ -0,0 +1,295 @@ +#if FANTASY_WEBGL +using System; +using System.Collections.Generic; +using System.Linq; +using System.Numerics; + +namespace Fantasy.Helper +{ + /// + /// 随机数操作助手类，提供各种随机数生成和操作方法。 + /// + public static partial class RandomHelper + { + private static readonly Random Random = new Random(); + private static readonly byte[] Byte8 = new byte[8]; + private static readonly byte[] Byte2 = new byte[2]; + + /// + /// 生成一个随机的无符号 64 位整数。 + /// + /// 无符号 64 位整数。 + public static ulong RandUInt64() + { + Random.NextBytes(Byte8); + return BitConverter.ToUInt64(Byte8, 0); + } + + /// + /// 生成一个随机的 64 位整数。 + /// + /// 64 位整数。 + public static long RandInt64() + { + Random.NextBytes(Byte8); + return BitConverter.ToInt64(Byte8, 0); + } + + /// + /// 生成一个随机的无符号 32 位整数。 + /// + /// 无符号 32 位整数。 + public static uint RandUInt32() + { + return (uint) Random.Next(); + } + + /// + /// 生成一个随机的无符号 16 位整数。 + /// + /// 无符号 16 位整数。 + public static ushort RandUInt16() + { + Random.NextBytes(Byte2); + return BitConverter.ToUInt16(Byte2, 0); + } + + /// + /// 在指定范围内生成一个随机整数（包含下限，不包含上限）。 + /// + /// 下限。 + /// 上限。 + /// 生成的随机整数。 + public static int RandomNumber(int lower, int upper) + { + return Random.Next(lower, upper); + } + + /// + /// 生成一个随机的布尔值。 + /// + /// 随机的布尔值。 + public static bool RandomBool() + { + return Random.Next(2) == 0; + } + + /// + /// 从数组中随机选择一个元素。 + /// + /// 数组元素的类型。 + /// 要选择的数组。 + /// 随机选择的数组元素。 + public static T RandomArray(this T[] array) + { + return array[RandomNumber(0, array.Count())]; + } + + /// + /// 从列表中随机选择一个元素。 + /// + /// 列表元素的类型。 + /// 要选择的列表。 + /// 随机选择的列表元素。 + public static T RandomArray(this List array) + { + return array[RandomNumber(0, array.Count())]; + } + + /// + /// 打乱列表中元素的顺序。 + /// + /// 列表元素的类型。 + /// 要打乱顺序的列表。 + public static void BreakRank(List arr) + { + if (arr == null || arr.Count < 2) + { + return; + } + + for (var i = 0; i < arr.Count / 2; i++) + { + var index = Random.Next(0, arr.Count); + (arr[index], arr[arr.Count - index - 1]) = (arr[arr.Count - index - 1], arr[index]); + } + } + + /// + /// 生成一个介于 0 和 1 之间的随机单精度浮点数。 + /// + /// 随机单精度浮点数。 + public static float RandFloat01() + { + var value = Random.NextDouble(); + return (float) value; + } + + private static int Rand(int n) + { + var rd = new Random(); + // 注意，返回值是左闭右开，所以maxValue要加1 + return rd.Next(1, n + 1); + } + + /// + /// 根据权重随机选择一个索引。 + /// + /// 权重数组，每个元素表示相应索引的权重。 + /// 随机选择的索引值。 + public static int RandomByWeight(int[] weights) + { + var sum = weights.Sum(); + var numberRand = Rand(sum); + var sumTemp = 0; + for (var i = 0; i < weights.Length; i++) + { + sumTemp += weights[i]; + if (numberRand <= sumTemp) + { + return i; + } + } + + return -1; + } + + /// + /// 根据固定概率随机选择一个索引，即某个数值上限内随机多少次。 + /// + /// 概率数组，每个元素表示相应索引的概率。 + /// 随机选择的索引值。 + public static int RandomByFixedProbability(int[] args) + { + var argCount = args.Length; + var sum = args.Sum(); + var random = Random.NextDouble() * sum; + while (sum > random) + { + sum -= args[argCount - 1]; + argCount--; + } + + return argCount; + } + + /// + /// 返回随机数。 + /// + /// 是否包含负数。 + /// 返回一个随机的单精度浮点数。 + public static float NextFloat(bool containNegative = false) + { + float f; + var buffer = new byte[4]; + if (containNegative) + { + do + { + Random.NextBytes(buffer); + f = BitConverter.ToSingle(buffer, 0); + } while ((f >= float.MinValue && f < float.MaxValue) == false); + + return f; + } + + do + { + Random.NextBytes(buffer); + f = BitConverter.ToSingle(buffer, 0); + } while ((f >= 0 && f < float.MaxValue) == false); + + return f; + } + + /// + /// 返回一个小于所指定最大值的非负随机数。 + /// + /// 要生成的随机数的上限（随机数不能取该上限值）。 maxValue 必须大于或等于零。 + /// 大于等于零且小于 maxValue 的单精度浮点数，即：返回值的范围通常包括零但不包括 maxValue。 不过，如果 maxValue 等于零，则返回 maxValue。 + public static float NextFloat(float maxValue) + { + if (maxValue.Equals(0)) + { + return maxValue; + } + + if (maxValue < 0) + { + throw new ArgumentOutOfRangeException("“maxValue”必须大于 0。", "maxValue"); + } + + float f; + var buffer = new byte[4]; + + do + { + Random.NextBytes(buffer); + f = BitConverter.ToSingle(buffer, 0); + } while ((f >= 0 && f < maxValue) == false); + + return f; + } + + /// + /// 返回一个指定范围内的随机数。 + /// + /// 返回的随机数的下界（随机数可取该下界值）。 + /// 返回的随机数的上界（随机数不能取该上界值）。 maxValue 必须大于或等于 minValue。 + /// 一个大于等于 minValue 且小于 maxValue 的单精度浮点数，即：返回的值范围包括 minValue 但不包括 maxValue。 如果 minValue 等于 maxValue，则返回 minValue。 + public static float NextFloat(float minValue, float maxValue) + { + if (minValue.Equals(maxValue)) + { + return minValue; + } + + if (minValue > maxValue) + { + throw new ArgumentOutOfRangeException("“minValue”不能大于 maxValue。", "minValue"); + } + + float f; + var buffer = new byte[4]; + + do + { + Random.NextBytes(buffer); + f = BitConverter.ToSingle(buffer, 0); + } while ((f >= minValue && f < maxValue) == false); + + return f; + } + + /// + /// 在指定的矩形区域内随机生成一个二维向量位置。 + /// + /// X轴最小值。 + /// X轴最大值。 + /// Y轴最小值。 + /// Y轴最大值。 + /// 随机生成的二维向量位置。 + public static Vector2 NextVector2(float minX, float maxX, float minY, float maxY) + { + return new Vector2(NextFloat(minX, maxX), NextFloat(minY, maxY)); + } + + /// + /// 生成指定长度的随机数字代码。 + /// + /// 数字代码的长度。 + /// 生成的随机数字代码。 + public static string RandomNumberCode(int len = 6) + { + int num = 0; + for (int i = 0; i < len; i++) + { + int number = RandomNumber(0, 10); + num = num * 10 + number; + } + + return num.ToString(); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/SocketHelper.cs b/FantasyNetTest/NBC/Core/Helper/SocketHelper.cs new file mode 100644 index 0000000..92bb06c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/SocketHelper.cs @@ -0,0 +1,70 @@ +#if !FANTASY_WEBGL +using System.Net; +using System.Net.Sockets; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace NBC.Helper +{ + /// + /// Socket帮助类 + /// + public static partial class SocketHelper + { + // always pass the same IPEndPointNonAlloc instead of allocating a new + // one each time. + // + // use IPEndPointNonAlloc.temp to get the latest SocketAdddress written + // by ReceiveFrom_Internal! + // + // IMPORTANT: .temp will be overwritten in next call! + // hash or manually copy it if you need to store it, e.g. + // when adding a new connection. + public static int ReceiveFrom_NonAlloc( + this Socket socket, + byte[] buffer, + int offset, + int size, + SocketFlags socketFlags, + EndPoint remoteEndPoint) + { + // call ReceiveFrom with IPEndPointNonAlloc. + // need to wrap this in ReceiveFrom_NonAlloc because it's not + // obvious that IPEndPointNonAlloc.Create does NOT create a new + // IPEndPoint. it saves the result in IPEndPointNonAlloc.temp! + EndPoint casted = remoteEndPoint; + return socket.ReceiveFrom(buffer, offset, size, socketFlags, ref casted); + } + + // same as above, different parameters + public static int ReceiveFrom_NonAlloc(this Socket socket, byte[] buffer, ref EndPoint remoteEndPoint) + { +#if UNITY + EndPoint casted = remoteEndPoint; + return socket.ReceiveFrom(buffer, ref casted); +#else + return socket.ReceiveFrom(buffer, ref remoteEndPoint); +#endif + + } + + // SendTo allocates too: + // https://github.com/mono/mono/blob/f74eed4b09790a0929889ad7fc2cf96c9b6e3757/mcs/class/System/System.Net.Sockets/Socket.cs#L2240 + // -> the allocation is in EndPoint.Serialize() + // NOTE: technically this function isn't necessary. + // could just pass IPEndPointNonAlloc. + // still good for strong typing. + //public static int SendTo_NonAlloc( + // this Socket socket, + // byte[] buffer, + // int offset, + // int size, + // SocketFlags socketFlags, + // IPEndPointNonAlloc remoteEndPoint) + //{ + // EndPoint casted = remoteEndPoint; + // return socket.SendTo(buffer, offset, size, socketFlags, casted); + //} + } +} +#endif + + diff --git a/FantasyNetTest/NBC/Core/Helper/TimeHelper.cs b/FantasyNetTest/NBC/Core/Helper/TimeHelper.cs new file mode 100644 index 0000000..7c79bd5 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/TimeHelper.cs @@ -0,0 +1,80 @@ +using System; +using UnityEngine; + +namespace NBC.Helper +{ + /// + /// 提供与时间相关的帮助方法。 + /// + public static partial class TimeHelper + { + /// + /// 一小时的毫秒值。 + /// + public const long Hour = 3600000; + /// + /// 一分钟的毫秒值。 + /// + public const long Minute = 60000; + /// + /// 一天的毫秒值。 + /// + public const long OneDay = 86400000; + // 1970年1月1日的Ticks + private const long Epoch = 621355968000000000L; + /// + /// 获取当前时间的毫秒数，从1970年1月1日开始计算。 + /// + public static long Now => (DateTime.UtcNow.Ticks - Epoch) / 10000; + + /// + /// 与服务器时间的偏差。 + /// + public static long TimeDiff; + /// + /// 获取当前服务器时间的毫秒数，加上与服务器时间的偏差。 + /// + public static long ServerNow => Now + TimeDiff; + + /// + /// 获取当前Unity运行的总时间的毫秒数。 + /// + public static long UnityNow => (long) (Time.time * 1000); + + /// + /// 根据时间获取时间戳 + /// + public static long Transition(DateTime dateTime) + { + return (dateTime.ToUniversalTime().Ticks - Epoch) / 10000; + } + + /// + /// 根据时间获取 时间戳 + /// + public static long TransitionToSeconds(DateTime dateTime) + { + return (dateTime.ToUniversalTime().Ticks - Epoch) / 10000000; + } + + /// + /// 将毫秒数转换为日期时间。 + /// + /// 要转换的毫秒数。 + /// 转换后的日期时间。 + public static DateTime Transition(this long timeStamp) + { + return new DateTime(Epoch + timeStamp * 10000, DateTimeKind.Utc).ToUniversalTime(); + } + + /// + /// 将毫秒数转换为本地时间的日期时间。 + /// + /// 要转换的毫秒数。 + /// 转换后的本地时间的日期时间。 + public static DateTime TransitionLocal(this long timeStamp) + { + return new DateTime(Epoch + timeStamp * 10000, DateTimeKind.Utc).ToLocalTime(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/WebSocketHelper.cs b/FantasyNetTest/NBC/Core/Helper/WebSocketHelper.cs new file mode 100644 index 0000000..1dd934e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/WebSocketHelper.cs @@ -0,0 +1,38 @@ +using System; +using System.Runtime.CompilerServices; + +namespace NBC.Helper +{ + /// + /// WebSocket帮助类 + /// + public static partial class WebSocketHelper + { + /// + /// 根据字符串获取WebSocket的连接地址 + /// + /// 目标服务器地址格式为:127.0.0.1:2000 + /// 目标服务器是否为加密连接也就是https + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static string GetWebSocketAddress(string address, bool isHttps) + { + var addressSplit = address.Split(':'); + if (addressSplit.Length != 2) + { + throw new FormatException("Invalid format"); + } + + var ipString = addressSplit[0]; + var portString = addressSplit[1]; + + if (!int.TryParse(portString, out var port) || port < 0 || port > 65535) + { + throw new FormatException("Invalid port number"); + } + + return isHttps ? $"wss://{ipString}:{portString}" : $"ws://{ipString}:{portString}"; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Helper/WinPeriod.cs b/FantasyNetTest/NBC/Core/Helper/WinPeriod.cs new file mode 100644 index 0000000..39f4a86 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Helper/WinPeriod.cs @@ -0,0 +1,24 @@ +using System.Runtime.InteropServices; + +namespace NBC.Helper +{ + /// + /// 精度设置 + /// + public static partial class WinPeriod + { + // 一般默认的精度不止1毫秒（不同操作系统有所不同），需要调用timeBeginPeriod与timeEndPeriod来设置精度 + [DllImport("winmm")] + private static extern void timeBeginPeriod(int t); + /// + /// 针对Windows平台设置精度 + /// + public static void Initialize() + { + if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows)) + { + timeBeginPeriod(1); + } + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/IdFactory/Default/EntityIdStruct.cs b/FantasyNetTest/NBC/Core/IdFactory/Default/EntityIdStruct.cs new file mode 100644 index 0000000..7c8c142 --- /dev/null +++ b/FantasyNetTest/NBC/Core/IdFactory/Default/EntityIdStruct.cs @@ -0,0 +1,136 @@ +using System; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +using NBC.Helper; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.IdFactory +{ + /// + /// 表示一个唯一实体的ID。 + /// + [StructLayout(LayoutKind.Sequential, Pack = 1)] + internal struct EntityIdStruct + { + // EntityId:39 + 16 + 18 = 64 + // +-------------------+-----------------------------+------------------------------------+ + // | time(30) 最大34年 | SceneId(16) 最多65535个Scene | sequence(18) 每秒每个进程能生产262143个 + // +-------------------+-----------------------------+------------------------------------+ + public uint Time { get; set; } + public uint SceneId { get; set; } + public uint Sequence { get; set; } + + public const uint MaskSequence = 0x3FFFF; + public const uint MaskSceneId = 0xFFFF; + public const uint MaskTime = 0x3FFFFFFF; + + /// + /// WorldEntityIdStruct（如果超过下面参数的设定该ID会失效）。 + /// + /// time不能超过1073741823 + /// sceneId不能超过65535 + /// sequence不能超过262143 + public EntityIdStruct(uint time, uint sceneId, uint sequence) + { + // 因为都是在配置表里拿到参数、所以这个不做边界判定、能节省一点点性能。 + Time = time; + SceneId = sceneId; + Sequence = sequence; + } + + public static implicit operator long(EntityIdStruct entityIdStruct) + { + ulong result = 0; + result |= entityIdStruct.Sequence; + result |= (ulong)entityIdStruct.SceneId << 18; + result |= (ulong)entityIdStruct.Time << 34; + return (long)result; + } + + public static implicit operator EntityIdStruct(long entityId) + { + var result = (ulong) entityId; + var entityIdStruct = new EntityIdStruct + { + Sequence = (uint)(result & MaskSequence) + }; + result >>= 18; + entityIdStruct.SceneId = (uint)(result & MaskSceneId); + result >>= 16; + entityIdStruct.Time = (uint)(result & MaskTime); + return entityIdStruct; + } + } + + public sealed class EntityIdFactory : IEntityIdFactory + { + private readonly ushort _sceneId; + + private uint _lastTime; + private uint _lastSequence; + private static readonly long Epoch1970 = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc).Ticks / 10000; + private static readonly long EpochThisYear = new DateTime(2025, 1, 1, 0, 0, 0, DateTimeKind.Utc).Ticks / 10000 - Epoch1970; + + private EntityIdFactory() { } + + public EntityIdFactory(uint sceneId) + { + switch (sceneId) + { + case > 65535: + { + throw new NotSupportedException($"sceneId:{sceneId} cannot be greater than 255255"); + } + default: + { + _sceneId = (ushort)sceneId; + break; + } + } + } + + public long Create + { + get + { + var time = (uint)((TimeHelper.Now - EpochThisYear) / 1000); + + if (time > _lastTime) + { + _lastTime = time; + _lastSequence = 0; + } + else if (++_lastSequence > EntityIdStruct.MaskSequence - 1) + { + _lastTime++; + _lastSequence = 0; + } + + return new EntityIdStruct(time, _sceneId, _lastSequence); + } + } + } + + public sealed class EntityIdFactoryTool : IIdFactoryTool + { + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public uint GetTime(ref long entityId) + { + var result = (ulong)entityId >> 34; + return (uint)(result & EntityIdStruct.MaskTime); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public uint GetSceneId(ref long entityId) + { + var result = (ulong)entityId >> 18; + return (uint)(result & EntityIdStruct.MaskSceneId); + } + + public byte GetWorldId(ref long entityId) + { + throw new NotImplementedException(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/IdFactory/Default/RuntimeIdStruct.cs b/FantasyNetTest/NBC/Core/IdFactory/Default/RuntimeIdStruct.cs new file mode 100644 index 0000000..fda56b1 --- /dev/null +++ b/FantasyNetTest/NBC/Core/IdFactory/Default/RuntimeIdStruct.cs @@ -0,0 +1,138 @@ +using System; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +using NBC.Helper; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.IdFactory +{ + /// + /// 表示一个运行时的ID。 + /// + [StructLayout(LayoutKind.Sequential, Pack = 1)] + public struct RuntimeIdStruct + { + // RuntimeId:23 + 8 + 8 + 25 = 64 + // +-------------------+-----------------------------+--------------------------------------+ + // | time(23) 最大60天 | SceneId(16) 最多65535个Scene | sequence(25) 每秒每个进程能生产33554431个 + // +-------------------+-----------------------------+--------------------------------------+ + public uint Time { get; private set; } + public uint SceneId { get; private set; } + public uint Sequence { get; private set; } + + public const uint MaskSequence = 0x1FFFFFF; + public const uint MaskSceneId = 0xFFFF; + public const uint MaskTime = 0x7FFFFF; + + /// + /// RuntimeIdStruct（如果超过下面参数的设定该ID会失效）。 + /// + /// time不能超过8388607 + /// sceneId不能超过65535 + /// sequence不能超过33554431 + public RuntimeIdStruct(uint time, uint sceneId, uint sequence) + { + // 因为都是在配置表里拿到参数、所以这个不做边界判定、能节省一点点性能。 + Time = time; + SceneId = sceneId; + Sequence = sequence; + } + + public static implicit operator long(RuntimeIdStruct runtimeIdStruct) + { + ulong result = runtimeIdStruct.Sequence; + result |= (ulong)runtimeIdStruct.SceneId << 25; + result |= (ulong)runtimeIdStruct.Time << 41; + return (long)result; + } + + public static implicit operator RuntimeIdStruct(long runtimeId) + { + var result = (ulong)runtimeId; + var runtimeIdStruct = new RuntimeIdStruct + { + Sequence = (uint)(result & MaskSequence) + }; + result >>= 25; + runtimeIdStruct.SceneId = (byte)(result & MaskSceneId); + result >>= 16; + runtimeIdStruct.Time = (uint)(result & MaskTime); + return runtimeIdStruct; + } + } + + public sealed class RuntimeIdFactory : IRuntimeIdFactory + { + private readonly uint _sceneId; + + private uint _lastTime; + private uint _lastSequence; + private readonly long _epochNow; + private readonly long _epoch1970 = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc).Ticks / 10000; + + private RuntimeIdFactory() { } + + public RuntimeIdFactory(uint sceneId) : this(TimeHelper.Now, sceneId) { } + + public RuntimeIdFactory(long epochNow, uint sceneId) + { + switch (sceneId) + { + case > 65535: + { + throw new NotSupportedException($"sceneId:{sceneId} cannot be greater than 255255"); + } + default: + { + _sceneId = (ushort)sceneId; + _epochNow = epochNow - _epoch1970; + break; + } + } + } + + public long Create + { + get + { + var time = (uint)((TimeHelper.Now - _epochNow) / 1000); + + if (time > _lastTime) + { + _lastTime = time; + _lastSequence = 0; + } + else if (++_lastSequence > RuntimeIdStruct.MaskSequence - 1) + { + _lastTime++; + _lastSequence = 0; + } + + return new RuntimeIdStruct(time, _sceneId, _lastSequence); + } + } + } + + public sealed class RuntimeIdFactoryTool : IIdFactoryTool + { + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public uint GetTime(ref long runtimeId) + { + var result = (ulong)runtimeId >> 41; + return (uint)(result & RuntimeIdStruct.MaskTime); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public uint GetSceneId(ref long runtimeId) + { + var result = (ulong)runtimeId >> 25; + return (uint)(result & RuntimeIdStruct.MaskSceneId); + } + + public byte GetWorldId(ref long entityId) + { + throw new NotImplementedException(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/IdFactory/IdFactoryHelper.cs b/FantasyNetTest/NBC/Core/IdFactory/IdFactoryHelper.cs new file mode 100644 index 0000000..bb51fea --- /dev/null +++ b/FantasyNetTest/NBC/Core/IdFactory/IdFactoryHelper.cs @@ -0,0 +1,133 @@ +using System; +using System.Runtime.CompilerServices; +using NBC.Helper; + +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider adding the 'required' modifier or declaring as nullable. + +namespace NBC.IdFactory +{ + /// + /// Id生成器帮助类 + /// + public static class IdFactoryHelper + { + private static IdFactoryType _idFactoryType = IdFactoryType.World; + + /// + /// EntityId工具 + /// + public static IIdFactoryTool EntityIdTool { get; private set; } = new WorldEntityIdFactoryTool(); + + /// + /// RuntimeId工具 + /// + public static IIdFactoryTool RuntimeIdTool { get; private set; } = new WorldRuntimeIdFactoryTool(); + + /// + /// 初始化 + /// + /// + public static void Initialize(IdFactoryType idFactoryType) + { + _idFactoryType = idFactoryType; + + switch (_idFactoryType) + { + case IdFactoryType.Default: + { + EntityIdTool = new EntityIdFactoryTool(); + RuntimeIdTool = new RuntimeIdFactoryTool(); + return; + } + case IdFactoryType.World: + { + EntityIdTool = new WorldEntityIdFactoryTool(); + RuntimeIdTool = new WorldRuntimeIdFactoryTool(); + return; + } + } + } + + internal static IEntityIdFactory EntityIdFactory(uint sceneId, byte worldId) + { + switch (_idFactoryType) + { + case IdFactoryType.Default: + { + return new EntityIdFactory(sceneId); + } + case IdFactoryType.World: + { + return new WorldEntityIdFactory(sceneId, worldId); + } + default: + { + throw new NotSupportedException($"IdFactoryType {_idFactoryType} is not supported."); + } + } + } + + internal static IRuntimeIdFactory RuntimeIdFactory(long epochNow, uint sceneId, byte worldId) + { + switch (_idFactoryType) + { + case IdFactoryType.Default: + { + return new RuntimeIdFactory(sceneId); + } + case IdFactoryType.World: + { + if (epochNow == 0) + { + epochNow = TimeHelper.Now; + } + + return new WorldRuntimeIdFactory(epochNow, sceneId, worldId); + } + default: + { + throw new NotSupportedException($"IdFactoryType {_idFactoryType} is not supported."); + } + } + } + + internal static long EntityId(uint time, uint sceneId, byte wordId, uint sequence) + { + switch (_idFactoryType) + { + case IdFactoryType.Default: + { + return new EntityIdStruct(time, sceneId, sequence); + } + case IdFactoryType.World: + { + return new WorldEntityIdStruct(time, sceneId, wordId, sequence); + } + default: + { + throw new NotSupportedException($"IdFactoryType {_idFactoryType} is not supported."); + } + } + } + + internal static long RuntimeId(uint time, uint sceneId, byte wordId, uint sequence) + { + switch (_idFactoryType) + { + case IdFactoryType.Default: + { + return new RuntimeIdStruct(time, sceneId, sequence); + } + case IdFactoryType.World: + { + return new WorldRuntimeIdStruct(time, sceneId, wordId, sequence); + } + default: + { + throw new NotSupportedException($"IdFactoryType {_idFactoryType} is not supported."); + } + } + } + } +} + diff --git a/FantasyNetTest/NBC/Core/IdFactory/IdFactoryType.cs b/FantasyNetTest/NBC/Core/IdFactory/IdFactoryType.cs new file mode 100644 index 0000000..6409d60 --- /dev/null +++ b/FantasyNetTest/NBC/Core/IdFactory/IdFactoryType.cs @@ -0,0 +1,23 @@ +namespace NBC.IdFactory +{ + /// + /// ID生成器规则 + /// + public enum IdFactoryType + { + /// + /// 空。 + /// + None = 0, + /// + /// 默认生成器 + /// Scene最大为65535个。 + /// + Default = 1, + /// + /// ID中包含World,使用这种方式可以不用管理合区的ID重复的问题。 + /// 但Scene的数量也会限制到255个。 + /// + World = 2 + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/IdFactory/Interface/IIdFactory.cs b/FantasyNetTest/NBC/Core/IdFactory/Interface/IIdFactory.cs new file mode 100644 index 0000000..f064b0c --- /dev/null +++ b/FantasyNetTest/NBC/Core/IdFactory/Interface/IIdFactory.cs @@ -0,0 +1,24 @@ +namespace NBC.IdFactory +{ + /// + /// EntityId生成器接口类 + /// + public interface IEntityIdFactory + { + /// + /// 创建一个新的Id + /// + public long Create { get; } + } + + /// + /// RuntimeId生成器接口类 + /// + public interface IRuntimeIdFactory + { + /// + /// 创建一个新的Id + /// + public long Create { get; } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/IdFactory/Interface/IIdFactoryTool.cs b/FantasyNetTest/NBC/Core/IdFactory/Interface/IIdFactoryTool.cs new file mode 100644 index 0000000..e9d97a3 --- /dev/null +++ b/FantasyNetTest/NBC/Core/IdFactory/Interface/IIdFactoryTool.cs @@ -0,0 +1,27 @@ +namespace NBC.IdFactory +{ + /// + /// Id扩展工具接口 + /// + public interface IIdFactoryTool + { + /// + /// 获得创建时间 + /// + /// + /// + public uint GetTime(ref long entityId); + /// + /// 获得SceneId + /// + /// + /// + public uint GetSceneId(ref long entityId); + /// + /// 获得WorldId + /// + /// + /// + public byte GetWorldId(ref long entityId); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/IdFactory/World/WorldEntityIdFactory.cs b/FantasyNetTest/NBC/Core/IdFactory/World/WorldEntityIdFactory.cs new file mode 100644 index 0000000..d694493 --- /dev/null +++ b/FantasyNetTest/NBC/Core/IdFactory/World/WorldEntityIdFactory.cs @@ -0,0 +1,153 @@ +using System; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +using NBC.Helper; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.IdFactory +{ + /// + /// 表示一个唯一实体的ID。 + /// + [StructLayout(LayoutKind.Sequential, Pack = 1)] + public struct WorldEntityIdStruct + { + // EntityId:39 + 8 + 8 + 18 = 64 + // +-------------------+--------------------------+-----------------------+------------------------------------+ + // | time(30) 最大34年 | SceneId(8) 最多255个Scene | WordId(8) 最多255个世界 | sequence(18) 每秒每个进程能生产262143个 + // +-------------------+--------------------------+-----------------------+------------------------------------+ + public uint Time { get; private set; } + public uint SceneId { get; private set; } + public byte WordId { get; private set; } + public uint Sequence { get; private set; } + + public const uint MaskSequence = 0x3FFFF; + public const uint MaskSceneId = 0xFF; + public const uint MaskWordId = 0xFF; + public const uint MaskTime = 0x3FFFFFFF; + + /// + /// WorldEntityIdStruct（如果超过下面参数的设定该ID会失效）。 + /// + /// time不能超过1073741823 + /// sceneId不能超过255 + /// wordId不能超过255 + /// sequence不能超过262143 + public WorldEntityIdStruct(uint time, uint sceneId, byte wordId, uint sequence) + { + // 因为都是在配置表里拿到参数、所以这个不做边界判定、能节省一点点性能。 + Time = time; + SceneId = sceneId; + WordId = wordId; + Sequence = sequence; + } + + public static implicit operator long(WorldEntityIdStruct entityIdStruct) + { + ulong result = 0; + result |= entityIdStruct.Sequence; + result |= (ulong)entityIdStruct.WordId << 18; + result |= (ulong)(entityIdStruct.SceneId % (entityIdStruct.WordId * 1000)) << 26; + result |= (ulong)entityIdStruct.Time << 34; + return (long)result; + } + + public static implicit operator WorldEntityIdStruct(long entityId) + { + var result = (ulong) entityId; + var entityIdStruct = new WorldEntityIdStruct + { + Sequence = (uint)(result & MaskSequence) + }; + result >>= 18; + entityIdStruct.WordId = (byte)(result & MaskWordId); + result >>= 8; + entityIdStruct.SceneId = (uint)(result & MaskSceneId) + (uint)entityIdStruct.WordId * 1000; + result >>= 8; + entityIdStruct.Time = (uint)(result & MaskTime); + return entityIdStruct; + } + } + + public sealed class WorldEntityIdFactory : IEntityIdFactory + { + private readonly uint _sceneId; + private readonly byte _worldId; + + private uint _lastTime; + private uint _lastSequence; + private static readonly long Epoch1970 = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc).Ticks / 10000; + private static readonly long EpochThisYear = new DateTime(2025, 1, 1, 0, 0, 0, DateTimeKind.Utc).Ticks / 10000 - Epoch1970; + + private WorldEntityIdFactory() { } + + public WorldEntityIdFactory(uint sceneId, byte worldId) + { + switch (sceneId) + { + case > 255255: + { + throw new NotSupportedException($"sceneId:{sceneId} cannot be greater than 255255"); + } + case < 1001: + { + throw new NotSupportedException($"sceneId:{sceneId} cannot be less than 1001"); + } + default: + { + _sceneId = sceneId; + _worldId = worldId; + break; + } + } + } + + public long Create + { + get + { + var time = (uint)((TimeHelper.Now - EpochThisYear) / 1000); + + if (time > _lastTime) + { + _lastTime = time; + _lastSequence = 0; + } + else if (++_lastSequence > WorldEntityIdStruct.MaskSequence - 1) + { + _lastTime++; + _lastSequence = 0; + } + + return new WorldEntityIdStruct(time, _sceneId, _worldId, _lastSequence); + } + } + } + + public sealed class WorldEntityIdFactoryTool : IIdFactoryTool + { + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public uint GetTime(ref long entityId) + { + var result = (ulong)entityId >> 34; + return (uint)(result & WorldEntityIdStruct.MaskTime); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public uint GetSceneId(ref long entityId) + { + var result = (ulong)entityId >> 18; + var worldId = (uint)(result & WorldEntityIdStruct.MaskWordId) * 1000; + result >>= 8; + return (uint)(result & WorldEntityIdStruct.MaskSceneId) + worldId; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public byte GetWorldId(ref long entityId) + { + var result = (ulong)entityId >> 18; + return (byte)(result & WorldEntityIdStruct.MaskWordId); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/IdFactory/World/WorldRuntimeIdFactory.cs b/FantasyNetTest/NBC/Core/IdFactory/World/WorldRuntimeIdFactory.cs new file mode 100644 index 0000000..7c3a14f --- /dev/null +++ b/FantasyNetTest/NBC/Core/IdFactory/World/WorldRuntimeIdFactory.cs @@ -0,0 +1,155 @@ +using System; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +using NBC.Helper; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.IdFactory +{ + /// + /// 表示一个运行时的ID。 + /// + [StructLayout(LayoutKind.Sequential, Pack = 1)] + public struct WorldRuntimeIdStruct + { + // RuntimeId:23 + 8 + 8 + 25 = 64 + // +-------------------+--------------------------+-----------------------+--------------------------------------+ + // | time(23) 最大60天 | SceneId(8) 最多255个Scene | WordId(8) 最多255个世界 | sequence(25) 每秒每个进程能生产33554431个 + // +-------------------+--------------------------+-----------------------+--------------------------------------+ + public uint Time { get; private set; } + public uint SceneId { get; private set; } + public byte WordId { get; private set; } + public uint Sequence { get; private set; } + + public const uint MaskSequence = 0x1FFFFFF; + public const uint MaskSceneId = 0xFF; + public const uint MaskWordId = 0xFF; + public const uint MaskTime = 0x7FFFFF; + + /// + /// WorldRuntimeIdStruct（如果超过下面参数的设定该ID会失效）。 + /// + /// time不能超过8388607 + /// sceneId不能超过255 + /// wordId不能超过255 + /// sequence不能超过33554431 + public WorldRuntimeIdStruct(uint time, uint sceneId, byte wordId, uint sequence) + { + // 因为都是在配置表里拿到参数、所以这个不做边界判定、能节省一点点性能。 + Time = time; + SceneId = sceneId; + WordId = wordId; + Sequence = sequence; + } + + public static implicit operator long(WorldRuntimeIdStruct runtimeIdStruct) + { + ulong result = runtimeIdStruct.Sequence; + result |= (ulong)runtimeIdStruct.WordId << 25; + result |= (ulong)(runtimeIdStruct.SceneId % (runtimeIdStruct.WordId * 1000)) << 33; + result |= (ulong)runtimeIdStruct.Time << 41; + return (long)result; + } + + public static implicit operator WorldRuntimeIdStruct(long runtimeId) + { + var result = (ulong)runtimeId; + var runtimeIdStruct = new WorldRuntimeIdStruct + { + Sequence = (uint)(result & MaskSequence) + }; + result >>= 25; + runtimeIdStruct.WordId = (byte)(result & MaskWordId); + result >>= 8; + runtimeIdStruct.SceneId = (uint)(result & MaskSceneId) + (uint)runtimeIdStruct.WordId * 1000; + result >>= 8; + runtimeIdStruct.Time = (uint)(result & MaskTime); + return runtimeIdStruct; + } + } + + public sealed class WorldRuntimeIdFactory : IRuntimeIdFactory + { + private readonly uint _sceneId; + private readonly byte _worldId; + + private uint _lastTime; + private uint _lastSequence; + private readonly long _epochNow; + private readonly long _epoch1970 = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc).Ticks / 10000; + + private WorldRuntimeIdFactory() { } + + public WorldRuntimeIdFactory(uint sceneId, byte worldId) : this(TimeHelper.Now, sceneId, worldId) { } + + public WorldRuntimeIdFactory(long epochNow, uint sceneId, byte worldId) + { + switch (sceneId) + { + case > 255255: + { + throw new NotSupportedException($"sceneId:{sceneId} cannot be greater than 255255"); + } + case < 1001: + { + throw new NotSupportedException($"sceneId:{sceneId} cannot be less than 1001"); + } + default: + { + _sceneId = sceneId; + _worldId = worldId; + _epochNow = epochNow - _epoch1970; + break; + } + } + } + + public long Create + { + get + { + var time = (uint)((TimeHelper.Now - _epochNow) / 1000); + + if (time > _lastTime) + { + _lastTime = time; + _lastSequence = 0; + } + else if (++_lastSequence > WorldRuntimeIdStruct.MaskSequence - 1) + { + _lastTime++; + _lastSequence = 0; + } + + return new WorldRuntimeIdStruct(time, _sceneId, _worldId, _lastSequence); + } + } + } + + public sealed class WorldRuntimeIdFactoryTool : IIdFactoryTool + { + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public uint GetTime(ref long runtimeId) + { + var result = (ulong)runtimeId >> 41; + return (uint)(result & WorldRuntimeIdStruct.MaskTime); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public uint GetSceneId(ref long runtimeId) + { + var result = (ulong)runtimeId >> 25; + var worldId = (uint)(result & WorldRuntimeIdStruct.MaskWordId) * 1000; + result >>= 8; + return (uint)(result & WorldRuntimeIdStruct.MaskSceneId) + worldId; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public byte GetWorldId(ref long runtimeId) + { + var result = (ulong)runtimeId >> 25; + return (byte)(result & WorldRuntimeIdStruct.MaskWordId); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/InnerErrorCode.cs b/FantasyNetTest/NBC/Core/InnerErrorCode.cs new file mode 100644 index 0000000..c7bf361 --- /dev/null +++ b/FantasyNetTest/NBC/Core/InnerErrorCode.cs @@ -0,0 +1,66 @@ +namespace NBC.Network +{ + /// + /// 定义 Fantasy 框架中的内部错误代码。 + /// + public class InnerErrorCode + { + private InnerErrorCode() { } + /// + /// 表示 Rpc 消息发送失败的错误代码。 + /// + public const uint ErrRpcFail = 100000002; + /// + /// 表示未找到 Route 消息的错误代码。 + /// + public const uint ErrNotFoundRoute = 100000003; + /// + /// 表示发送 Route 消息超时的错误代码。 + /// + public const uint ErrRouteTimeout = 100000004; + /// + /// 表示未找到实体的错误代码。 + /// + public const uint ErrEntityNotFound = 100000008; + /// + /// 表示传送过程中发生错误的错误代码。 + /// + public const uint ErrTransfer = 100000009; + /// + /// 表示连接Roaming时候已经存在同RoamingType的Roaming了。 + /// + public const uint ErrLinkRoamingAlreadyExists = 100000009; + /// + /// 表示连接Roaming时候在漫游终端已经存在同Id的终端。 + /// + public const uint ErrAddRoamingTerminalAlreadyExists = 100000010; + /// + /// 表示未找到 Roaming 消息的错误代码。 + /// + public const uint ErrNotFoundRoaming = 100000011; + /// + /// 表示发送 Roaming 消息超时的错误代码。 + /// + public const uint ErrRoamingTimeout = 100000012; + /// + /// 表示再锁定 Roaming 消息的时候没有找到对应的Session错误代码。 + /// + public const uint ErrLockTerminusIdNotFoundSession = 100000013; + /// + /// 表示再锁定 Roaming 消息的时候没有找到对应的RoamingType错误代码。 + /// + public const uint ErrLockTerminusIdNotFoundRoamingType = 100000014; + /// + /// 表示再解除锁定 Roaming 消息的时候没有找到对应的Session错误代码。 + /// + public const uint ErrUnLockTerminusIdNotFoundSession = 100000015; + /// + /// 表示再解除锁定 Roaming 消息的时候没有找到对应的RoamingType错误代码。 + /// + public const uint ErrUnLockTerminusIdNotFoundRoamingType = 100000016; + /// + /// 表示再传送 Terminus 时对应的错误代码。 + /// + public const uint ErrTerminusStartTransfer = 100000017; + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Log/ILog.cs b/FantasyNetTest/NBC/Core/Log/ILog.cs new file mode 100644 index 0000000..9a06bab --- /dev/null +++ b/FantasyNetTest/NBC/Core/Log/ILog.cs @@ -0,0 +1,64 @@ +namespace NBC +{ + /// + /// 定义日志记录功能的接口。 + /// + public interface ILog + { + /// + /// 记录跟踪级别的日志消息。 + /// + /// 日志消息。 + void Trace(string message); + /// + /// 记录警告级别的日志消息。 + /// + /// 日志消息。 + void Warning(string message); + /// + /// 记录信息级别的日志消息。 + /// + /// 日志消息。 + void Info(string message); + /// + /// 记录调试级别的日志消息。 + /// + /// 日志消息。 + void Debug(string message); + /// + /// 记录错误级别的日志消息。 + /// + /// 日志消息。 + void Error(string message); + /// + /// 记录跟踪级别的格式化日志消息。 + /// + /// 日志消息模板。 + /// 格式化参数。 + void Trace(string message, params object[] args); + /// + /// 记录警告级别的格式化日志消息。 + /// + /// 日志消息模板。 + /// 格式化参数。 + void Warning(string message, params object[] args); + /// + /// 记录信息级别的格式化日志消息。 + /// + /// 日志消息模板。 + /// 格式化参数。 + void Info(string message, params object[] args); + /// + /// 记录调试级别的格式化日志消息。 + /// + /// 日志消息模板。 + /// 格式化参数。 + void Debug(string message, params object[] args); + /// + /// 记录错误级别的格式化日志消息。 + /// + /// 日志消息模板。 + /// 格式化参数。 + void Error(string message, params object[] args); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Log/Log.cs b/FantasyNetTest/NBC/Core/Log/Log.cs new file mode 100644 index 0000000..3371156 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Log/Log.cs @@ -0,0 +1,156 @@ +using System; +using System.Diagnostics; + + +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. + +namespace NBC +{ + /// + /// 提供日志记录功能的静态类。 + /// + public static class Log + { + private static ILog _logCore; + private static bool _isRegister; + /// + /// 注册一个日志系统 + /// + /// + public static void Register(ILog log) + { + if (_isRegister) + { + return; + } + + _logCore = log; + _isRegister = true; + } + + /// + /// 记录跟踪级别的日志消息。 + /// + /// 日志消息。 + public static void Trace(string msg) + { + var st = new StackTrace(1, true); + _logCore.Trace($"{msg}\n{st}"); + } + + /// + /// 记录调试级别的日志消息。 + /// + /// 日志消息。 + public static void Debug(string msg) + { + _logCore.Debug(msg); + } + + /// + /// 记录信息级别的日志消息。 + /// + /// 日志消息。 + public static void Info(string msg) + { + _logCore.Info(msg); + } + + /// + /// 记录跟踪级别的日志消息，并附带调用栈信息。 + /// + /// 日志消息。 + public static void TraceInfo(string msg) + { + var st = new StackTrace(1, true); + _logCore.Trace($"{msg}\n{st}"); + } + + /// + /// 记录警告级别的日志消息。 + /// + /// 日志消息。 + public static void Warning(string msg) + { + _logCore.Warning(msg); + } + + /// + /// 记录错误级别的日志消息，并附带调用栈信息。 + /// + /// 日志消息。 + public static void Error(string msg) + { + var st = new StackTrace(1, true); + _logCore.Error($"{msg}\n{st}"); + } + + /// + /// 记录异常的错误级别的日志消息，并附带调用栈信息。 + /// + /// 异常对象。 + public static void Error(Exception e) + { + if (e.Data.Contains("StackTrace")) + { + _logCore.Error($"{e.Data["StackTrace"]}\n{e}"); + return; + } + var str = e.ToString(); + _logCore.Error(str); + } + + /// + /// 记录跟踪级别的格式化日志消息，并附带调用栈信息。 + /// + /// 日志消息模板。 + /// 格式化参数。 + public static void Trace(string message, params object[] args) + { + var st = new StackTrace(1, true); + _logCore.Trace($"{string.Format(message, args)}\n{st}"); + } + + /// + /// 记录警告级别的格式化日志消息。 + /// + /// 日志消息模板。 + /// 格式化参数。 + public static void Warning(string message, params object[] args) + { + _logCore.Warning(string.Format(message, args)); + } + + /// + /// 记录信息级别的格式化日志消息。 + /// + /// 日志消息模板。 + /// 格式化参数。 + public static void Info(string message, params object[] args) + { + _logCore.Info(string.Format(message, args)); + } + + /// + /// 记录调试级别的格式化日志消息。 + /// + /// 日志消息模板。 + /// 格式化参数。 + public static void Debug(string message, params object[] args) + { + _logCore.Debug(string.Format(message, args)); + } + + /// + /// 记录错误级别的格式化日志消息，并附带调用栈信息。 + /// + /// 日志消息模板。 + /// 格式化参数。 + public static void Error(string message, params object[] args) + { + var st = new StackTrace(1, true); + var s = string.Format(message, args) + '\n' + st; + _logCore.Error(s); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Log/UnityLog.cs b/FantasyNetTest/NBC/Core/Log/UnityLog.cs new file mode 100644 index 0000000..a8c04a6 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Log/UnityLog.cs @@ -0,0 +1,73 @@ +using System.Collections.Generic; +#if UNITY_EDITOR +using System; +using System.Reflection; +using System.Text.RegularExpressions; +using UnityEditor; +using UnityEditor.Callbacks; +using UnityEditorInternal; +#else +using System; +#endif + +namespace NBC +{ + public class UnityLog : ILog + { + public void Trace(string msg) + { + FantasyNetTest.Log.Info(msg); + // UnityEngine.Debug.Log(msg); + } + + public void Debug(string msg) + { + FantasyNetTest.Log.Info(msg); + } + + public void Info(string msg) + { + FantasyNetTest.Log.Info(msg); + } + + public void Warning(string msg) + { + FantasyNetTest.Log.Warn(msg); + } + + public void Error(string msg) + { + FantasyNetTest.Log.Error(msg); + } + + public void Error(Exception e) + { + FantasyNetTest.Log.Error(e.ToString()); + } + + public void Trace(string message, params object[] args) + { + FantasyNetTest.Log.Info(message,args); + } + + public void Warning(string message, params object[] args) + { + FantasyNetTest.Log.Warn(message,args); + } + + public void Info(string message, params object[] args) + { + FantasyNetTest.Log.Info(message,args); + } + + public void Debug(string message, params object[] args) + { + FantasyNetTest.Log.Info(message,args); + } + + public void Error(string message, params object[] args) + { + FantasyNetTest.Log.Error(message,args); + } + } +} diff --git a/FantasyNetTest/NBC/Core/LowLevel/FixedBytes.cs b/FantasyNetTest/NBC/Core/LowLevel/FixedBytes.cs new file mode 100644 index 0000000..72d4fe2 --- /dev/null +++ b/FantasyNetTest/NBC/Core/LowLevel/FixedBytes.cs @@ -0,0 +1,105 @@ +using System; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.LowLevel +{ + [StructLayout(LayoutKind.Sequential)] + public struct FixedBytes1 + { + private byte _e0; + + public Span AsSpan() => MemoryMarshal.CreateSpan(ref Unsafe.As(ref Unsafe.AsRef(in this)), Unsafe.SizeOf()); + } + + [StructLayout(LayoutKind.Sequential)] + public struct FixedBytes2 + { + private FixedBytes1 _e0; + private FixedBytes1 _e1; + + public Span AsSpan() => MemoryMarshal.CreateSpan(ref Unsafe.As(ref Unsafe.AsRef(in this)), Unsafe.SizeOf()); + } + + [StructLayout(LayoutKind.Sequential)] + public struct FixedBytes4 + { + private FixedBytes2 _e0; + private FixedBytes2 _e1; + + public Span AsSpan() => MemoryMarshal.CreateSpan(ref Unsafe.As(ref Unsafe.AsRef(in this)), Unsafe.SizeOf()); + } + + [StructLayout(LayoutKind.Sequential)] + public struct FixedBytes8 + { + private FixedBytes4 _e0; + private FixedBytes4 _e1; + + public Span AsSpan() => MemoryMarshal.CreateSpan(ref Unsafe.As(ref Unsafe.AsRef(in this)), Unsafe.SizeOf()); + } + + [StructLayout(LayoutKind.Sequential)] + public struct FixedBytes16 + { + private FixedBytes8 _e0; + private FixedBytes8 _e1; + + public Span AsSpan() => MemoryMarshal.CreateSpan(ref Unsafe.As(ref Unsafe.AsRef(in this)), Unsafe.SizeOf()); + } + + [StructLayout(LayoutKind.Sequential)] + public struct FixedBytes32 + { + private FixedBytes16 _e0; + private FixedBytes16 _e1; + + public Span AsSpan() => MemoryMarshal.CreateSpan(ref Unsafe.As(ref Unsafe.AsRef(in this)), Unsafe.SizeOf()); + } + + [StructLayout(LayoutKind.Sequential)] + public struct FixedBytes64 + { + private FixedBytes32 _e0; + private FixedBytes32 _e1; + + public Span AsSpan() => MemoryMarshal.CreateSpan(ref Unsafe.As(ref Unsafe.AsRef(in this)), Unsafe.SizeOf()); + } + + [StructLayout(LayoutKind.Sequential)] + public struct FixedBytes128 + { + private FixedBytes64 _e0; + private FixedBytes64 _e1; + + public Span AsSpan() => MemoryMarshal.CreateSpan(ref Unsafe.As(ref Unsafe.AsRef(in this)), Unsafe.SizeOf()); + } + + [StructLayout(LayoutKind.Sequential)] + public struct FixedBytes256 + { + private FixedBytes128 _e0; + private FixedBytes128 _e1; + + public Span AsSpan() => MemoryMarshal.CreateSpan(ref Unsafe.As(ref Unsafe.AsRef(in this)), Unsafe.SizeOf()); + } + + [StructLayout(LayoutKind.Sequential)] + public struct FixedBytes512 + { + private FixedBytes256 _e0; + private FixedBytes256 _e1; + + public Span AsSpan() => MemoryMarshal.CreateSpan(ref Unsafe.As(ref Unsafe.AsRef(in this)), Unsafe.SizeOf()); + } + + [StructLayout(LayoutKind.Sequential)] + public struct FixedBytes1024 + { + private FixedBytes512 _e0; + private FixedBytes512 _e1; + + public Span AsSpan() => MemoryMarshal.CreateSpan(ref Unsafe.As(ref Unsafe.AsRef(in this)), Unsafe.SizeOf()); + } +} diff --git a/FantasyNetTest/NBC/Core/LowLevel/XxHash.cs b/FantasyNetTest/NBC/Core/LowLevel/XxHash.cs new file mode 100644 index 0000000..cef02bc --- /dev/null +++ b/FantasyNetTest/NBC/Core/LowLevel/XxHash.cs @@ -0,0 +1,171 @@ +using System; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; + +#pragma warning disable CS1591 + +namespace NBC.LowLevel +{ + public static class XxHash + { + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static int Hash32(string obj, uint seed = 0) => Hash32(obj.AsSpan(), seed); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static int Hash32(in T obj, uint seed = 0) where T : unmanaged => Hash32(MemoryMarshal.CreateReadOnlySpan(ref Unsafe.As(ref Unsafe.AsRef(in obj)), Unsafe.SizeOf()), seed); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static int Hash32(ReadOnlySpan buffer, uint seed = 0) where T : unmanaged => Hash32(MemoryMarshal.Cast(buffer), seed); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static int Hash32(ReadOnlySpan buffer, uint seed = 0) + { + int length = buffer.Length; + ref byte local1 = ref MemoryMarshal.GetReference(buffer); + uint num1; + if (buffer.Length >= 16) + { + uint num2 = seed + 606290984U; + uint num3 = seed + 2246822519U; + uint num4 = seed; + uint num5 = seed - 2654435761U; + for (; length >= 16; length -= 16) + { + const nint elementOffset1 = 4; + const nint elementOffset2 = 8; + const nint elementOffset3 = 12; + nint byteOffset = buffer.Length - length; + ref byte local2 = ref Unsafe.AddByteOffset(ref local1, byteOffset); + uint num6 = num2 + Unsafe.ReadUnaligned(ref local2) * 2246822519U; + num2 = (uint)((((int)num6 << 13) | (int)(num6 >> 19)) * -1640531535); + uint num7 = num3 + Unsafe.ReadUnaligned(ref Unsafe.AddByteOffset(ref local2, elementOffset1)) * 2246822519U; + num3 = (uint)((((int)num7 << 13) | (int)(num7 >> 19)) * -1640531535); + uint num8 = num4 + Unsafe.ReadUnaligned(ref Unsafe.AddByteOffset(ref local2, elementOffset2)) * 2246822519U; + num4 = (uint)((((int)num8 << 13) | (int)(num8 >> 19)) * -1640531535); + uint num9 = num5 + Unsafe.ReadUnaligned(ref Unsafe.AddByteOffset(ref local2, elementOffset3)) * 2246822519U; + num5 = (uint)((((int)num9 << 13) | (int)(num9 >> 19)) * -1640531535); + } + + num1 = (uint)((((int)num2 << 1) | (int)(num2 >> 31)) + (((int)num3 << 7) | (int)(num3 >> 25)) + (((int)num4 << 12) | (int)(num4 >> 20)) + (((int)num5 << 18) | (int)(num5 >> 14)) + buffer.Length); + } + else + num1 = (uint)((int)seed + 374761393 + buffer.Length); + + for (; length >= 4; length -= 4) + { + nint byteOffset = buffer.Length - length; + uint num10 = Unsafe.ReadUnaligned(ref Unsafe.AddByteOffset(ref local1, byteOffset)); + uint num11 = num1 + num10 * 3266489917U; + num1 = (uint)((((int)num11 << 17) | (int)(num11 >> 15)) * 668265263); + } + + nint byteOffset1 = buffer.Length - length; + ref byte local3 = ref Unsafe.AddByteOffset(ref local1, byteOffset1); + for (int index = 0; index < length; ++index) + { + nint byteOffset2 = index; + uint num12 = Unsafe.AddByteOffset(ref local3, byteOffset2); + uint num13 = num1 + num12 * 374761393U; + num1 = (uint)((((int)num13 << 11) | (int)(num13 >> 21)) * -1640531535); + } + +#if NET7_0_OR_GREATER + int num14 = ((int)num1 ^ (int)(num1 >> 15)) * -2048144777; + int num15 = (num14 ^ (num14 >>> 13)) * -1028477379; + return num15 ^ (num15 >>> 16); +#else + int num14 = ((int)num1 ^ (int)(num1 >> 15)) * -2048144777; + int num15 = (num14 ^ (int)((uint)num14 >> 13)) * -1028477379; + return num15 ^ (int)((uint)num15 >> 16); +#endif + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static long Hash64(string obj, ulong seed = 0) => Hash64(obj.AsSpan(), seed); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static long Hash64(in T obj, ulong seed = 0) where T : unmanaged => Hash64(MemoryMarshal.CreateReadOnlySpan(ref Unsafe.As(ref Unsafe.AsRef(in obj)), Unsafe.SizeOf()), seed); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static long Hash64(ReadOnlySpan buffer, ulong seed = 0) where T : unmanaged => Hash64(MemoryMarshal.Cast(buffer), seed); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static long Hash64(ReadOnlySpan buffer, ulong seed = 0) + { + ref var local1 = ref MemoryMarshal.GetReference(buffer); + var length = buffer.Length; + ulong num1; + if (buffer.Length >= 32) + { + var num2 = seed + 6983438078262162902UL; + var num3 = seed + 14029467366897019727UL; + var num4 = seed; + var num5 = seed - 11400714785074694791UL; + for (; length >= 32; length -= 32) + { + ref var local2 = ref Unsafe.AddByteOffset(ref local1, (IntPtr)(buffer.Length - length)); + var num6 = num2 + Unsafe.ReadUnaligned(ref local2) * 14029467366897019727UL; + num2 = (ulong)((((long)num6 << 31) | (long)(num6 >> 33)) * -7046029288634856825L); + var num7 = num3 + Unsafe.ReadUnaligned(ref Unsafe.AddByteOffset(ref local2, new UIntPtr(8U))) * 14029467366897019727UL; + num3 = (ulong)((((long)num7 << 31) | (long)(num7 >> 33)) * -7046029288634856825L); + var num8 = num4 + Unsafe.ReadUnaligned(ref Unsafe.AddByteOffset(ref local2, new UIntPtr(16U))) * 14029467366897019727UL; + num4 = (ulong)((((long)num8 << 31) | (long)(num8 >> 33)) * -7046029288634856825L); + var num9 = num5 + Unsafe.ReadUnaligned(ref Unsafe.AddByteOffset(ref local2, new UIntPtr(24U))) * 14029467366897019727UL; + num5 = (ulong)((((long)num9 << 31) | (long)(num9 >> 33)) * -7046029288634856825L); + } + + var num10 = (((long)num2 << 1) | (long)(num2 >> 63)) + (((long)num3 << 7) | (long)(num3 >> 57)) + (((long)num4 << 12) | (long)(num4 >> 52)) + (((long)num5 << 18) | (long)(num5 >> 46)); + var num11 = num2 * 14029467366897019727UL; + var num12 = (((long)num11 << 31) | (long)(num11 >> 33)) * -7046029288634856825L; + var num13 = (num10 ^ num12) * -7046029288634856825L + -8796714831421723037L; + var num14 = num3 * 14029467366897019727UL; + var num15 = (((long)num14 << 31) | (long)(num14 >> 33)) * -7046029288634856825L; + var num16 = (num13 ^ num15) * -7046029288634856825L + -8796714831421723037L; + var num17 = num4 * 14029467366897019727UL; + var num18 = (((long)num17 << 31) | (long)(num17 >> 33)) * -7046029288634856825L; + var num19 = (num16 ^ num18) * -7046029288634856825L + -8796714831421723037L; + var num20 = num5 * 14029467366897019727UL; + var num21 = (((long)num20 << 31) | (long)(num20 >> 33)) * -7046029288634856825L; + num1 = (ulong)((num19 ^ num21) * -7046029288634856825L + -8796714831421723037L); + } + else + num1 = seed + 2870177450012600261UL; + + var num22 = num1 + (ulong)buffer.Length; + for (; length >= 8; length -= 8) + { + var num23 = Unsafe.ReadUnaligned(ref Unsafe.AddByteOffset(ref local1, (IntPtr)(buffer.Length - length))) * 14029467366897019727UL; + var num24 = (ulong)((((long)num23 << 31) | (long)(num23 >> 33)) * -7046029288634856825L); + var num25 = num22 ^ num24; + num22 = (ulong)((((long)num25 << 27) | (long)(num25 >> 37)) * -7046029288634856825L + -8796714831421723037L); + } + + if (length >= 4) + { + ulong num26 = Unsafe.ReadUnaligned(ref Unsafe.AddByteOffset(ref local1, (IntPtr)(buffer.Length - length))); + var num27 = num22 ^ (num26 * 11400714785074694791UL); + num22 = (ulong)((((long)num27 << 23) | (long)(num27 >> 41)) * -4417276706812531889L + 1609587929392839161L); + length -= 4; + } + + for (var byteOffset = 0; byteOffset < length; ++byteOffset) + { + ulong num28 = Unsafe.AddByteOffset(ref Unsafe.AddByteOffset(ref local1, (IntPtr)(buffer.Length - length)), (IntPtr)byteOffset); + var num29 = num22 ^ (num28 * 2870177450012600261UL); + num22 = (ulong)((((long)num29 << 11) | (long)(num29 >> 53)) * -7046029288634856825L); + } + +#if NET7_0_OR_GREATER + var num30 = (long)num22; + var num31 = (num30 ^ (num30 >>> 33)) * -4417276706812531889L; + var num32 = (num31 ^ (num31 >>> 29)) * 1609587929392839161L; + return num32 ^ (num32 >>> 32); +#else + var num30 = (long)num22; + var num31 = (num30 ^ (long)((ulong)num30 >> 33)) * -4417276706812531889L; + var num32 = (num31 ^ (long)((ulong)num31 >> 29)) * 1609587929392839161L; + return num32 ^ (long)((ulong)num32 >> 32); +#endif + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/MemoryStreamBufferPool.cs b/FantasyNetTest/NBC/Core/Network/MemoryStreamBufferPool.cs new file mode 100644 index 0000000..53da81b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/MemoryStreamBufferPool.cs @@ -0,0 +1,97 @@ +using System; +using System.Collections.Generic; +using NBC.Serialize; + +#pragma warning disable CS8603 // Possible null reference return. + +namespace NBC.Network +{ + /// + /// MemoryStreamBuffer对象池类 + /// + public sealed class MemoryStreamBufferPool : IDisposable + { + private readonly int _poolSize; + private readonly int _maxMemoryStreamSize; + private readonly Queue _memoryStreamPool = new Queue(); + + /// + /// 构造方法 + /// + /// + /// + public MemoryStreamBufferPool(int maxMemoryStreamSize = 2048, int poolSize = 512) + { + _poolSize = poolSize; + _maxMemoryStreamSize = maxMemoryStreamSize; + } + + /// + /// 租借MemoryStream + /// + /// + /// + /// + public MemoryStreamBuffer RentMemoryStream(MemoryStreamBufferSource memoryStreamBufferSource, int size = 0) + { + if (size > _maxMemoryStreamSize) + { + return new MemoryStreamBuffer(memoryStreamBufferSource, size); + } + + if (size < _maxMemoryStreamSize) + { + size = _maxMemoryStreamSize; + } + + if (_memoryStreamPool.Count == 0) + { + return new MemoryStreamBuffer(memoryStreamBufferSource, size); + } + + if (_memoryStreamPool.TryDequeue(out var memoryStream)) + { + memoryStream.MemoryStreamBufferSource = memoryStreamBufferSource; + return memoryStream; + } + + return new MemoryStreamBuffer(memoryStreamBufferSource, size); + } + + /// + /// 归还ReturnMemoryStream + /// + /// + public void ReturnMemoryStream(MemoryStreamBuffer memoryStreamBuffer) + { + if (memoryStreamBuffer.Capacity > _maxMemoryStreamSize) + { + return; + } + + if (_memoryStreamPool.Count > _poolSize) + { + // 设置该值只能是内网或服务器转发的时候可能在连接之前发送的数据过多的情况下可以修改。 + // 设置过大会导致内存占用过大，所以要谨慎设置。 + return; + } + + memoryStreamBuffer.SetLength(0); + memoryStreamBuffer.MemoryStreamBufferSource = MemoryStreamBufferSource.None; + _memoryStreamPool.Enqueue(memoryStreamBuffer); + } + + /// + /// 销毁方法 + /// + public void Dispose() + { + foreach (var memoryStreamBuffer in _memoryStreamPool) + { + memoryStreamBuffer.MemoryStreamBufferSource = MemoryStreamBufferSource.None; + memoryStreamBuffer.Dispose(); + } + _memoryStreamPool.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface.meta b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface.meta new file mode 100644 index 0000000..ab43ba4 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: d4d6dc6851edd49279319bb39e3ee406 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IMessageHandler.cs b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IMessageHandler.cs new file mode 100644 index 0000000..2ff697f --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IMessageHandler.cs @@ -0,0 +1,219 @@ +// ReSharper disable InconsistentNaming + +using System; +using System.Collections.Generic; +using NBC.Network; +using NBC.Async; +using NBC.Serialize; + +namespace NBC.Network.Interface +{ + /// + /// 表示消息处理器的接口，处理特定类型的消息。 + /// + public interface IMessageHandler + { + /// + /// 获取处理的消息类型。 + /// + /// 消息类型。 + public Type Type(); + /// + /// 处理消息的方法。 + /// + /// 会话对象。 + /// RPC标识。 + /// 消息类型代码。 + /// 要处理的消息。 + /// 异步任务。 + FTask Handle(Session session, uint rpcId, uint messageTypeCode, object message); + } + + /// + /// 泛型消息基类，实现了 接口。 + /// + public abstract class Message : IMessageHandler + { + /// + /// 获取处理的消息类型。 + /// + /// 消息类型。 + public Type Type() + { + return typeof(T); + } + + /// + /// 处理消息的方法。 + /// + /// 会话对象。 + /// RPC标识。 + /// 消息类型代码。 + /// 要处理的消息。 + /// 异步任务。 + public async FTask Handle(Session session, uint rpcId, uint messageTypeCode, object message) + { + try + { + await Run(session, (T) message); + } + catch (Exception e) + { + Log.Error(e); + } + } + + /// + /// 运行消息处理逻辑。 + /// + /// 会话对象。 + /// 要处理的消息。 + /// 异步任务。 + protected abstract FTask Run(Session session, T message); + } + + /// + /// 泛型消息RPC基类，实现了 接口，用于处理请求和响应类型的消息。 + /// + public abstract class MessageRPC : IMessageHandler where TRequest : IRequest where TResponse : AMessage, IResponse, new() + { + /// + /// 获取处理的消息类型。 + /// + /// 消息类型。 + public Type Type() + { + return typeof(TRequest); + } + + /// + /// 处理消息的方法。 + /// + /// 会话对象。 + /// RPC标识。 + /// 消息类型代码。 + /// 要处理的消息。 + /// 异步任务。 + public async FTask Handle(Session session, uint rpcId, uint messageTypeCode, object message) + { + if (message is not TRequest request) + { + Log.Error($"消息类型转换错误: {message.GetType().Name} to {typeof(TRequest).Name}"); + return; + } + + var response = new TResponse(); + var isReply = false; + + void Reply() + { + if (isReply) + { + return; + } + + isReply = true; + + if (session.IsDisposed) + { + return; + } + + session.Send(response, rpcId); + } + + try + { + await Run(session, request, response, Reply); + } + catch (Exception e) + { + Log.Error(e); + response.ErrorCode = InnerErrorCode.ErrRpcFail; + } + finally + { + Reply(); + } + } + + /// + /// 运行消息处理逻辑。 + /// + /// 会话对象。 + /// 请求消息。 + /// 响应消息。 + /// 发送响应的方法。 + /// 异步任务。 + protected abstract FTask Run(Session session, TRequest request, TResponse response, Action reply); + } + + public interface IMessageDelegateHandler + { + /// + /// 注册消息处理器。 + /// + /// + public void Register(object @delegate); + /// + /// 取消注册消息处理器。 + /// + /// + public int UnRegister(object @delegate); + /// + /// 处理消息的方法。 + /// + /// + /// + public void Handle(Session session, object message); + } + public delegate FTask MessageDelegate(Session session, T msg) where T : IMessage; + public sealed class MessageDelegateHandler : IMessageDelegateHandler, IDisposable where T : IMessage + { + private readonly List> _delegates = new List>(); + + public Type Type() + { + return typeof(T); + } + + public void Register(object @delegate) + { + var a = (MessageDelegate)@delegate; + + if (_delegates.Contains(a)) + { + Log.Error($"{typeof(T).Name} already register action delegateName:{a.Method.Name}"); + return; + } + + _delegates.Add(a); + } + + public int UnRegister(object @delegate) + { + _delegates.Remove((MessageDelegate)@delegate); + return _delegates.Count; + } + + public void Handle(Session session, object message) + { + foreach (var registerDelegate in _delegates) + { + try + { + registerDelegate(session, (T)message).Coroutine(); + } + catch (Exception e) + { + Log.Error(e); + } + } + } + + public void Dispose() + { + _delegates.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IMessageHandler.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IMessageHandler.cs.meta new file mode 100644 index 0000000..df81f04 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IMessageHandler.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: c8d500d1bea9d477dac23323bd387d47 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IRouteMessageHandler.cs b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IRouteMessageHandler.cs new file mode 100644 index 0000000..3bef465 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IRouteMessageHandler.cs @@ -0,0 +1,490 @@ +using NBC.Async; +using NBC.Entitas; +using NBC.InnerMessage; +using NBC.Network; +using NBC.Serialize; + +#if FANTASY_NET +// ReSharper disable InconsistentNaming + +namespace Fantasy.Network.Interface +{ + /// + /// 表示路由消息处理器的接口，处理特定类型的路由消息。 + /// + public interface IRouteMessageHandler + { + /// + /// 获取处理的消息类型。 + /// + /// 消息类型。 + public Type Type(); + + /// + /// 处理路由消息的方法。 + /// + /// 会话对象。 + /// 实体对象。 + /// RPC标识。 + /// 要处理的路由消息。 + /// 异步任务。 + FTask Handle(Session session, Entity entity, uint rpcId, object routeMessage); + } + + /// + /// 泛型路由基类，实现了 接口，用于处理特定实体和路由消息类型的路由。 + /// + /// 实体类型。 + /// 路由消息类型。 + public abstract class Route : IRouteMessageHandler where TEntity : Entity where TMessage : IRouteMessage + { + /// + /// 获取处理的消息类型。 + /// + /// 消息类型。 + public Type Type() + { + return typeof(TMessage); + } + + /// + /// 处理路由消息的方法。 + /// + /// 会话对象。 + /// 实体对象。 + /// RPC标识。 + /// 要处理的路由消息。 + /// 异步任务。 + public async FTask Handle(Session session, Entity entity, uint rpcId, object routeMessage) + { + if (routeMessage is not TMessage ruteMessage) + { + Log.Error($"Message type conversion error: {routeMessage.GetType().FullName} to {typeof(TMessage).Name}"); + return; + } + + if (entity is not TEntity tEntity) + { + Log.Error($"Route type conversion error: {entity.GetType().Name} to {nameof(TEntity)}"); + return; + } + + try + { + await Run(tEntity, ruteMessage); + } + catch (Exception e) + { + if (entity is not Scene scene) + { + scene = entity.Scene; + } + + Log.Error($"SceneConfigId:{session.Scene.SceneConfigId} ProcessConfigId:{scene.Process.Id} SceneType:{scene.SceneType} EntityId {tEntity.Id} : Error {e}"); + } + } + + /// + /// 运行路由消息处理逻辑。 + /// + /// 实体对象。 + /// 要处理的路由消息。 + /// 异步任务。 + protected abstract FTask Run(TEntity entity, TMessage message); + } + + /// + /// 泛型路由RPC基类，实现了 接口，用于处理请求和响应类型的路由。 + /// + /// 实体类型。 + /// 路由请求类型。 + /// 路由响应类型。 + public abstract class RouteRPC : IRouteMessageHandler where TEntity : Entity where TRouteRequest : IRouteRequest where TRouteResponse : AMessage, IRouteResponse, new() + { + /// + /// 获取处理的消息类型。 + /// + /// 消息类型。 + public Type Type() + { + return typeof(TRouteRequest); + } + + /// + /// 处理路由消息的方法。 + /// + /// 会话对象。 + /// 实体对象。 + /// RPC标识。 + /// 要处理的路由消息。 + /// 异步任务。 + public async FTask Handle(Session session, Entity entity, uint rpcId, object routeMessage) + { + if (routeMessage is not TRouteRequest tRouteRequest) + { + Log.Error($"Message type conversion error: {routeMessage.GetType().FullName} to {typeof(TRouteRequest).Name}"); + return; + } + + if (entity is not TEntity tEntity) + { + Log.Error($"Route type conversion error: {entity.GetType().Name} to {nameof(TEntity)}"); + return; + } + + var isReply = false; + var response = new TRouteResponse(); + + void Reply() + { + if (isReply) + { + return; + } + + isReply = true; + + if (session.IsDisposed) + { + return; + } + + session.Send(response, rpcId); + } + + try + { + await Run(tEntity, tRouteRequest, response, Reply); + } + catch (Exception e) + { + if (entity is not Scene scene) + { + scene = entity.Scene; + } + + Log.Error($"SceneConfigId:{session.Scene.SceneConfigId} ProcessConfigId:{scene.Process.Id} SceneType:{scene.SceneType} EntityId {tEntity.Id} : Error {e}"); + response.ErrorCode = InnerErrorCode.ErrRpcFail; + } + finally + { + Reply(); + } + } + + /// + /// 运行路由消息处理逻辑。 + /// + /// 实体对象。 + /// 请求路由消息。 + /// 响应路由消息。 + /// 发送响应的方法。 + /// 异步任务。 + protected abstract FTask Run(TEntity entity, TRouteRequest request, TRouteResponse response, Action reply); + } + + /// + /// 泛型可寻址路由基类，实现了 接口，用于处理特定实体和可寻址路由消息类型的路由。 + /// + /// 实体类型。 + /// 可寻址路由消息类型。 + public abstract class Addressable : IRouteMessageHandler where TEntity : Entity where TMessage : IAddressableRouteMessage + { + /// + /// 获取消息类型。 + /// + /// 消息类型。 + public Type Type() + { + return typeof(TMessage); + } + + /// + /// 处理可寻址路由消息。 + /// + /// 会话。 + /// 实体。 + /// RPC标识。 + /// 可寻址路由消息。 + public async FTask Handle(Session session, Entity entity, uint rpcId, object routeMessage) + { + if (routeMessage is not TMessage ruteMessage) + { + Log.Error($"Message type conversion error: {routeMessage.GetType().FullName} to {typeof(TMessage).Name}"); + return; + } + + if (entity is not TEntity tEntity) + { + Log.Error($"Route type conversion error: {entity.GetType().Name} to {nameof(TEntity)}"); + return; + } + + try + { + await Run(tEntity, ruteMessage); + } + catch (Exception e) + { + if (entity is not Scene scene) + { + scene = entity.Scene; + } + + Log.Error($"SceneConfigId:{session.Scene.SceneConfigId} ProcessConfigId:{scene.Process.Id} SceneType:{scene.SceneType} EntityId {tEntity.Id} : Error {e}"); + } + finally + { + session.Send(new RouteResponse(), rpcId); + } + } + + /// + /// 运行处理可寻址路由消息。 + /// + /// 实体。 + /// 可寻址路由消息。 + protected abstract FTask Run(TEntity entity, TMessage message); + } + + /// + /// 泛型可寻址RPC路由基类，实现了 接口，用于处理特定实体和可寻址RPC路由请求类型的路由。 + /// + /// 实体类型。 + /// 可寻址RPC路由请求类型。 + /// 可寻址RPC路由响应类型。 + public abstract class AddressableRPC : IRouteMessageHandler where TEntity : Entity where TRouteRequest : IAddressableRouteRequest where TRouteResponse : IAddressableRouteResponse, new() + { + /// + /// 获取消息类型。 + /// + /// 消息类型。 + public Type Type() + { + return typeof(TRouteRequest); + } + + /// + /// 处理可寻址RPC路由请求。 + /// + /// 会话。 + /// 实体。 + /// RPC标识。 + /// 可寻址RPC路由请求。 + public async FTask Handle(Session session, Entity entity, uint rpcId, object routeMessage) + { + if (routeMessage is not TRouteRequest tRouteRequest) + { + Log.Error($"Message type conversion error: {routeMessage.GetType().FullName} to {typeof(TRouteRequest).Name}"); + return; + } + + if (entity is not TEntity tEntity) + { + Log.Error($"Route type conversion error: {entity.GetType().Name} to {nameof(TEntity)}"); + return; + } + + var isReply = false; + var response = new TRouteResponse(); + + void Reply() + { + if (isReply) + { + return; + } + + isReply = true; + + if (session.IsDisposed) + { + return; + } + + session.Send(response, rpcId); + } + + try + { + await Run(tEntity, tRouteRequest, response, Reply); + } + catch (Exception e) + { + if (entity is not Scene scene) + { + scene = entity.Scene; + } + + Log.Error($"SceneConfigId:{session.Scene.SceneConfigId} ProcessConfigId:{scene.Process.Id} SceneType:{scene.SceneType} EntityId {tEntity.Id} : Error {e}"); + response.ErrorCode = InnerErrorCode.ErrRpcFail; + } + finally + { + Reply(); + } + } + + /// + /// 运行处理可寻址RPC路由请求。 + /// + /// 实体。 + /// 可寻址RPC路由请求。 + /// 可寻址RPC路由响应。 + /// 回复操作。 + protected abstract FTask Run(TEntity entity, TRouteRequest request, TRouteResponse response, Action reply); + } + + /// + /// 泛型漫游路由基类，实现了 接口，用于处理特定实体和漫游路由消息类型的路由。 + /// + /// 实体类型。 + /// 漫游消息类型。 + public abstract class Roaming : IRouteMessageHandler where TEntity : Entity where TMessage : IRoamingMessage + { + /// + /// 获取消息类型。 + /// + /// 消息类型。 + public Type Type() + { + return typeof(TMessage); + } + + /// + /// 处理漫游消息。 + /// + /// 会话。 + /// 实体。 + /// RPC标识。 + /// 漫游消息。 + public async FTask Handle(Session session, Entity entity, uint rpcId, object routeMessage) + { + if (routeMessage is not TMessage ruteMessage) + { + Log.Error($"Message type conversion error: {routeMessage.GetType().FullName} to {typeof(TMessage).Name}"); + return; + } + + if (entity is not TEntity tEntity) + { + Log.Error($"Route type conversion error: {entity.GetType().Name} to {nameof(TEntity)}"); + return; + } + + try + { + await Run(tEntity, ruteMessage); + } + catch (Exception e) + { + if (entity is not Scene scene) + { + scene = entity.Scene; + } + + Log.Error($"SceneConfigId:{session.Scene.SceneConfigId} ProcessConfigId:{scene.Process.Id} SceneType:{scene.SceneType} EntityId {tEntity.Id} : Error {e}"); + } + finally + { + session.Send(new RouteResponse(), rpcId); + } + } + + /// + /// 运行处理漫游消息。 + /// + /// 终点实体。 + /// 漫游消息。 + protected abstract FTask Run(TEntity terminus, TMessage message); + } + + /// + /// 漫游RPC路由基类，实现了 接口，用于处理特定实体和漫游RPC路由请求类型的路由。 + /// + /// 实体类型。 + /// 漫游RPC路由请求类型。 + /// 漫游RPC路由响应类型。 + public abstract class RoamingRPC : IRouteMessageHandler where TEntity : Entity where TRouteRequest : IRoamingRequest where TRouteResponse : IRoamingResponse, new() + { + /// + /// 获取消息类型。 + /// + /// 消息类型。 + public Type Type() + { + return typeof(TRouteRequest); + } + + /// + /// 处理漫游RPC路由请求。 + /// + /// 会话。 + /// 实体。 + /// RPC标识。 + /// 漫游RPC路由请求。 + public async FTask Handle(Session session, Entity entity, uint rpcId, object routeMessage) + { + if (routeMessage is not TRouteRequest tRouteRequest) + { + Log.Error($"Message type conversion error: {routeMessage.GetType().FullName} to {typeof(TRouteRequest).Name}"); + return; + } + + if (entity is not TEntity tEntity) + { + Log.Error($"Route type conversion error: {entity.GetType().Name} to {nameof(TEntity)}"); + return; + } + + var isReply = false; + var response = new TRouteResponse(); + + void Reply() + { + if (isReply) + { + return; + } + + isReply = true; + + if (session.IsDisposed) + { + return; + } + + session.Send(response, rpcId); + } + + try + { + await Run(tEntity, tRouteRequest, response, Reply); + } + catch (Exception e) + { + if (entity is not Scene scene) + { + scene = entity.Scene; + } + + Log.Error($"SceneConfigId:{session.Scene.SceneConfigId} ProcessConfigId:{scene.Process.Id} SceneType:{scene.SceneType} EntityId {tEntity.Id} : Error {e}"); + response.ErrorCode = InnerErrorCode.ErrRpcFail; + } + finally + { + Reply(); + } + } + + /// + /// 运行处理漫游RPC路由请求。 + /// + /// 终点实体。 + /// 漫游RPC路由请求。 + /// 漫游RPC路由响应。 + /// 回复操作。 + protected abstract FTask Run(TEntity terminus, TRouteRequest request, TRouteResponse response, Action reply); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IRouteMessageHandler.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IRouteMessageHandler.cs.meta new file mode 100644 index 0000000..c019cad --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/Interface/IRouteMessageHandler.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 1d2e3f63e08dc406c858a416337569f7 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/MessageDispatcherComponent.cs b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/MessageDispatcherComponent.cs new file mode 100644 index 0000000..732242e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/MessageDispatcherComponent.cs @@ -0,0 +1,402 @@ +using System; +using System.Collections.Generic; +using System.Threading.Tasks; +using NBC.Network; +using NBC.Assembly; +using NBC.Async; +using NBC.DataStructure.Collection; +using NBC.DataStructure.Dictionary; +using NBC.Entitas; +using NBC.InnerMessage; + +#pragma warning disable CS8604 // Possible null reference argument. + +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace NBC.Network.Interface +{ + /// + /// 用于存储消息处理器的信息，包括类型和对象实例。 + /// + /// 消息处理器的类型 + internal sealed class HandlerInfo + { + /// + /// 获取或设置消息处理器对象。 + /// + public T Obj; + + /// + /// 获取或设置消息处理器的类型。 + /// + public Type Type; + } + + /// + /// 网络消息分发组件。 + /// + public sealed class MessageDispatcherComponent : Entity, IAssembly + { + public long AssemblyIdentity { get; set; } + private readonly Dictionary _responseTypes = new Dictionary(); + private readonly DoubleMapDictionary _networkProtocols = new DoubleMapDictionary(); + private readonly Dictionary _messageHandlers = new Dictionary(); + private readonly OneToManyList _assemblyResponseTypes = new OneToManyList(); + private readonly OneToManyList _assemblyNetworkProtocols = new OneToManyList(); + + private readonly OneToManyList> _assemblyMessageHandlers = + new OneToManyList>(); + + private readonly Dictionary _messageDelegateHandlers = + new Dictionary(); + + private CoroutineLock _receiveRouteMessageLock; + + #region Initialize + + internal async FTask Initialize() + { + _receiveRouteMessageLock = Scene.CoroutineLockComponent.Create(GetType().TypeHandle.Value.ToInt64()); + await AssemblySystem.Register(this); + return this; + } + + public async FTask Load(long assemblyIdentity) + { + var tcs = FTask.Create(false); + Scene?.ThreadSynchronizationContext.Post(() => + { + LoadInner(assemblyIdentity); + tcs.SetResult(); + }); + await tcs; + } + + private void LoadInner(long assemblyIdentity) + { + var nmsl = AssemblySystem.ForEach(assemblyIdentity, typeof(IMessage)); + // 遍历所有实现了IMessage接口的类型，获取OpCode并添加到_networkProtocols字典中 + foreach (var type in nmsl) + { + var obj = (IMessage)Activator.CreateInstance(type); + var opCode = obj.OpCode(); + + _networkProtocols.Add(opCode, type); + + var responseType = type.GetProperty("ResponseType"); + + // 如果类型具有ResponseType属性，将其添加到_responseTypes字典中 + if (responseType != null) + { + _responseTypes.Add(type, responseType.PropertyType); + _assemblyResponseTypes.Add(assemblyIdentity, type); + } + + _assemblyNetworkProtocols.Add(assemblyIdentity, opCode); + } + + // 遍历所有实现了IMessageHandler接口的类型，创建实例并添加到_messageHandlers字典中 + foreach (var type in AssemblySystem.ForEach(assemblyIdentity, typeof(IMessageHandler))) + { + var obj = (IMessageHandler)Activator.CreateInstance(type); + + if (obj == null) + { + throw new Exception($"message handle {type.Name} is null"); + } + + var key = obj.Type(); + _messageHandlers.Add(key, obj); + _assemblyMessageHandlers.Add(assemblyIdentity, new HandlerInfo() + { + Obj = obj, Type = key + }); + } + + // 如果编译符号FANTASY_NET存在，遍历所有实现了IRouteMessageHandler接口的类型，创建实例并添加到_routeMessageHandlers字典中 +#if FANTASY_NET + foreach (var type in AssemblySystem.ForEach(assemblyIdentity, typeof(IRouteMessageHandler))) + { + var obj = (IRouteMessageHandler) Activator.CreateInstance(type); + + if (obj == null) + { + throw new Exception($"message handle {type.Name} is null"); + } + + var key = obj.Type(); + _routeMessageHandlers.Add(key, obj); + _assemblyRouteMessageHandlers.Add(assemblyIdentity, new HandlerInfo() + { + Obj = obj, Type = key + }); + } + + foreach (var type in AssemblySystem.ForEach(assemblyIdentity, typeof(ICustomRoute))) + { + var obj = (ICustomRoute) Activator.CreateInstance(type); + + if (obj == null) + { + throw new Exception($"message handle {type.Name} is null"); + } + + var opCode = obj.OpCode(); + _customRouteMap[opCode] = obj.RouteType; + _assemblyCustomRouteMap.Add(assemblyIdentity, opCode); + } +#endif + } + + public async FTask ReLoad(long assemblyIdentity) + { + var tcs = FTask.Create(false); + Scene?.ThreadSynchronizationContext.Post(() => + { + OnUnLoadInner(assemblyIdentity); + LoadInner(assemblyIdentity); + tcs.SetResult(); + }); + await tcs; + } + + public async FTask OnUnLoad(long assemblyIdentity) + { + var tcs = FTask.Create(false); + Scene?.ThreadSynchronizationContext.Post(() => + { + OnUnLoadInner(assemblyIdentity); + tcs.SetResult(); + }); + await tcs; + } + + private void OnUnLoadInner(long assemblyIdentity) + { + // 移除程序集对应的ResponseType类型和OpCode信息 + if (_assemblyResponseTypes.TryGetValue(assemblyIdentity, out var removeResponseTypes)) + { + foreach (var removeResponseType in removeResponseTypes) + { + _responseTypes.Remove(removeResponseType); + } + + _assemblyResponseTypes.RemoveByKey(assemblyIdentity); + } + + if (_assemblyNetworkProtocols.TryGetValue(assemblyIdentity, out var removeNetworkProtocols)) + { + foreach (var removeNetworkProtocol in removeNetworkProtocols) + { + _networkProtocols.RemoveByKey(removeNetworkProtocol); + } + + _assemblyNetworkProtocols.RemoveByKey(assemblyIdentity); + } + + // 移除程序集对应的消息处理器信息 + if (_assemblyMessageHandlers.TryGetValue(assemblyIdentity, out var removeMessageHandlers)) + { + foreach (var removeMessageHandler in removeMessageHandlers) + { + _messageHandlers.Remove(removeMessageHandler.Type); + } + + _assemblyMessageHandlers.RemoveByKey(assemblyIdentity); + } + } + + /// + /// 手动注册一个消息处理器。 + /// + /// + /// + public void RegisterHandler(MessageDelegate @delegate) where T : IMessage + { + var type = typeof(T); + + if (!_messageDelegateHandlers.TryGetValue(type, out var messageDelegate)) + { + messageDelegate = new MessageDelegateHandler(); + _messageDelegateHandlers.Add(type, messageDelegate); + } + + messageDelegate.Register(@delegate); + } + + /// + /// 手动卸载一个消息处理器，必须是通过RegisterHandler方法注册的消息处理器。 + /// + /// + /// + public void UnRegisterHandler(MessageDelegate @delegate) where T : IMessage + { + var type = typeof(T); + + if (!_messageDelegateHandlers.TryGetValue(type, out var messageDelegate)) + { + return; + } + + if (messageDelegate.UnRegister(@delegate) != 0) + { + return; + } + + _messageDelegateHandlers.Remove(type); + } + + #endregion + + /// + /// 处理普通消息，将消息分发给相应的消息处理器。 + /// + /// 会话对象 + /// 消息类型 + /// 消息对象 + /// RPC标识 + /// 协议码 + public void MessageHandler(Session session, Type type, object message, uint rpcId, uint protocolCode) + { + if (_messageDelegateHandlers.TryGetValue(type, out var messageDelegateHandler)) + { + messageDelegateHandler.Handle(session, message); + return; + } + + NetMessageDelegate.Message(session, type, message, rpcId, protocolCode); + if (!_messageHandlers.TryGetValue(type, out var messageHandler)) + { + // Log.Warning($"Scene:{session.Scene.Id} Found Unhandled Message: {message.GetType()}"); + return; + } + + // 调用消息处理器的Handle方法并启动协程执行处理逻辑 + messageHandler.Handle(session, rpcId, protocolCode, message).Coroutine(); + } + + // 如果编译符号FANTASY_NET存在，定义处理路由消息的方法 +#if FANTASY_NET + /// + /// 处理路由消息，将消息分发给相应的路由消息处理器。 + /// + /// 会话对象 + /// 消息类型 + /// 实体对象 + /// 消息对象 + /// RPC标识 + public async FTask RouteMessageHandler(Session session, Type type, Entity entity, object message, uint rpcId) + { + if (!_routeMessageHandlers.TryGetValue(type, out var routeMessageHandler)) + { + Log.Warning($"Scene:{session.Scene.Id} Found Unhandled RouteMessage: {message.GetType()}"); + + if (message is IRouteRequest request) + { + FailRouteResponse(session, request.GetType(), InnerErrorCode.ErrEntityNotFound, rpcId); + } + + return; + } + + var runtimeId = entity.RuntimeId; + var sessionRuntimeId = session.RuntimeId; + + if (entity is Scene) + { + // 如果是Scene的话、就不要加锁了、如果加锁很一不小心就可能会造成死锁 + await routeMessageHandler.Handle(session, entity, rpcId, message); + return; + } + + // 使用协程锁来确保多线程安全 + using (await _receiveRouteMessageLock.Wait(runtimeId)) + { + if (sessionRuntimeId != session.RuntimeId) + { + return; + } + + if (runtimeId != entity.RuntimeId) + { + if (message is IRouteRequest request) + { + FailRouteResponse(session, request.GetType(), InnerErrorCode.ErrEntityNotFound, rpcId); + } + + return; + } + + await routeMessageHandler.Handle(session, entity, rpcId, message); + } + } + + internal bool GetCustomRouteType(long protocolCode, out int routeType) + { + return _customRouteMap.TryGetValue(protocolCode, out routeType); + } +#endif + internal void FailRouteResponse(Session session, Type requestType, uint error, uint rpcId) + { + var response = CreateRouteResponse(requestType, error); + session.Send(response, rpcId); + } + + internal IResponse CreateResponse(Type requestType, uint error) + { + IResponse response; + + if (_responseTypes.TryGetValue(requestType, out var responseType)) + { + response = (IResponse)Activator.CreateInstance(responseType); + } + else + { + response = new Response(); + } + + response.ErrorCode = error; + return response; + } + + internal IRouteResponse CreateRouteResponse(Type requestType, uint error) + { + IRouteResponse response; + + if (_responseTypes.TryGetValue(requestType, out var responseType)) + { + response = (IRouteResponse)Activator.CreateInstance(responseType); + } + else + { + response = new RouteResponse(); + } + + response.ErrorCode = error; + return response; + } + + /// + /// 根据消息类型获取对应的OpCode。 + /// + /// 消息类型 + /// 消息对应的OpCode + public uint GetOpCode(Type type) + { + return _networkProtocols.GetKeyByValue(type); + } + + /// + /// 根据OpCode获取对应的消息类型。 + /// + /// OpCode + /// OpCode对应的消息类型 + public Type GetOpCodeType(uint code) + { + return _networkProtocols.GetValueByKey(code); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/MessageDispatcherComponent.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/MessageDispatcherComponent.cs.meta new file mode 100644 index 0000000..2979d9d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Dispatcher/MessageDispatcherComponent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 56299d59c80c145b4b680252e4fd4202 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/IMessage.cs b/FantasyNetTest/NBC/Core/Network/Message/IMessage.cs new file mode 100644 index 0000000..07f9ec6 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/IMessage.cs @@ -0,0 +1,95 @@ +using System; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.Network.Interface +{ + /// + /// 表示通用消息接口。 + /// + public interface IMessage + { + /// + /// 获取消息的操作代码。 + /// + /// 操作代码。 + uint OpCode(); + } + + /// + /// 表示请求消息接口。 + /// + public interface IRequest : IMessage + { + + } + + /// + /// 表示响应消息接口。 + /// + public interface IResponse : IMessage + { + /// + /// 获取或设置错误代码。 + /// + uint ErrorCode { get; set; } + } + // 普通路由消息 + /// + /// 表示普通路由消息的接口，继承自请求接口。 + /// + public interface IRouteMessage : IRequest + { + + } + + /// + /// 普通路由请求接口，继承自普通路由消息接口。 + /// + public interface IRouteRequest : IRouteMessage { } + /// + /// 普通路由响应接口，继承自响应接口。 + /// + public interface IRouteResponse : IResponse { } + // 可寻址协议 + /// + /// 表示可寻址协议的普通路由消息接口，继承自普通路由消息接口。 + /// + public interface IAddressableRouteMessage : IRouteMessage { } + /// + /// 可寻址协议的普通路由请求接口，继承自可寻址协议的普通路由消息接口。 + /// + public interface IAddressableRouteRequest : IRouteRequest { } + /// + /// 可寻址协议的普通路由响应接口，继承自普通路由响应接口。 + /// + public interface IAddressableRouteResponse : IRouteResponse { } + // 自定义Route协议 + public interface ICustomRoute : IMessage + { + int RouteType { get; } + } + /// + /// 表示自定义Route协议的普通路由消息接口，继承自普通路由消息接口。 + /// + public interface ICustomRouteMessage : IRouteMessage, ICustomRoute { } + /// + /// 自定义Route协议的普通路由请求接口，继承自自定义Route协议的普通路由消息接口。 + /// + public interface ICustomRouteRequest : IRouteRequest, ICustomRoute { } + /// + /// 自定义Route协议的普通路由响应接口，继承自普通路由响应接口。 + /// + public interface ICustomRouteResponse : IRouteResponse { } + /// + /// 表示漫游协议的普通路由消息接口，继承自普通路由消息接口。 + /// + public interface IRoamingMessage : IRouteMessage, ICustomRoute { } + /// + /// 漫游协议的普通路由请求接口，继承自自定义Route协议的普通路由消息接口。 + /// + public interface IRoamingRequest : IRoamingMessage { } + /// + /// 漫游协议的普通路由响应接口，继承自普通路由响应接口。 + /// + public interface IRoamingResponse : IRouteResponse { } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/InnerMessage.cs b/FantasyNetTest/NBC/Core/Network/Message/InnerMessage.cs new file mode 100644 index 0000000..ea6460e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/InnerMessage.cs @@ -0,0 +1,319 @@ +using MongoDB.Bson.Serialization.Attributes; +using NBC.Network.Interface; +using NBC.Serialize; +using ProtoBuf; +#if FANTASY_NET +using Fantasy.Network.Roaming; +#endif +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +// ReSharper disable InconsistentNaming +// ReSharper disable PropertyCanBeMadeInitOnly.Global +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.InnerMessage +{ + [ProtoContract] + public sealed partial class BenchmarkMessage : AMessage, IMessage + { + public uint OpCode() + { + return Network.OpCode.BenchmarkMessage; + } + } + [ProtoContract] + public partial class BenchmarkRequest : AMessage, IRequest + { + public uint OpCode() + { + return Network.OpCode.BenchmarkRequest; + } + [ProtoIgnore] + public BenchmarkResponse ResponseType { get; set; } + [ProtoMember(1)] + public long RpcId { get; set; } + } + + [ProtoContract] + public partial class BenchmarkResponse : AMessage, IResponse + { + public uint OpCode() + { + return Network.OpCode.BenchmarkResponse; + } + [ProtoMember(1)] + public long RpcId { get; set; } + [ProtoMember(2)] + public uint ErrorCode { get; set; } + } + public sealed partial class Response : AMessage, IResponse + { + public uint OpCode() + { + return Network.OpCode.DefaultResponse; + } + [ProtoMember(1)] + public long RpcId { get; set; } + [ProtoMember(2)] + public uint ErrorCode { get; set; } + } + [ProtoContract] + public sealed partial class RouteResponse : AMessage, IRouteResponse + { + public uint OpCode() + { + return Network.OpCode.DefaultRouteResponse; + } + [ProtoMember(1)] + public long RpcId { get; set; } + [ProtoMember(2)] + public uint ErrorCode { get; set; } + } + [ProtoContract] + public partial class PingRequest : AMessage, IRequest + { + public uint OpCode() + { + return Network.OpCode.PingRequest; + } + [ProtoIgnore] + public PingResponse ResponseType { get; set; } + [ProtoMember(1)] + public long RpcId { get; set; } + } + + [ProtoContract] + public partial class PingResponse : AMessage, IResponse + { + public uint OpCode() + { + return Network.OpCode.PingResponse; + } + [ProtoMember(1)] + public long RpcId { get; set; } + [ProtoMember(2)] + public uint ErrorCode { get; set; } + [ProtoMember(3)] + public long Now; + } + [ProtoContract] + public partial class I_AddressableAdd_Request : AMessage, IRouteRequest + { + [ProtoIgnore] + public I_AddressableAdd_Response ResponseType { get; set; } + public uint OpCode() { return Network.OpCode.AddressableAddRequest; } + public long RouteTypeOpCode() { return 1; } + [ProtoMember(1)] + public long AddressableId { get; set; } + [ProtoMember(2)] + public long RouteId { get; set; } + [ProtoMember(3)] + public bool IsLock { get; set; } + } + [ProtoContract] + public partial class I_AddressableAdd_Response : AMessage, IRouteResponse + { + public uint OpCode() { return Network.OpCode.AddressableAddResponse; } + [ProtoMember(1)] + public uint ErrorCode { get; set; } + } + [ProtoContract] + public partial class I_AddressableGet_Request : AMessage, IRouteRequest + { + [ProtoIgnore] + public I_AddressableGet_Response ResponseType { get; set; } + public uint OpCode() { return Network.OpCode.AddressableGetRequest; } + public long RouteTypeOpCode() { return 1; } + [ProtoMember(1)] + public long AddressableId { get; set; } + } + [ProtoContract] + public partial class I_AddressableGet_Response : AMessage, IRouteResponse + { + public uint OpCode() { return Network.OpCode.AddressableGetResponse; } + [ProtoMember(2)] + public uint ErrorCode { get; set; } + [ProtoMember(1)] + public long RouteId { get; set; } + } + [ProtoContract] + public partial class I_AddressableRemove_Request : AMessage, IRouteRequest + { + [ProtoIgnore] + public I_AddressableRemove_Response ResponseType { get; set; } + public uint OpCode() { return Network.OpCode.AddressableRemoveRequest; } + public long RouteTypeOpCode() { return 1; } + [ProtoMember(1)] + public long AddressableId { get; set; } + } + [ProtoContract] + public partial class I_AddressableRemove_Response : AMessage, IRouteResponse + { + public uint OpCode() { return Network.OpCode.AddressableRemoveResponse; } + [ProtoMember(1)] + public uint ErrorCode { get; set; } + } + [ProtoContract] + public partial class I_AddressableLock_Request : AMessage, IRouteRequest + { + [ProtoIgnore] + public I_AddressableLock_Response ResponseType { get; set; } + public uint OpCode() { return Network.OpCode.AddressableLockRequest; } + public long RouteTypeOpCode() { return 1; } + [ProtoMember(1)] + public long AddressableId { get; set; } + } + [ProtoContract] + public partial class I_AddressableLock_Response : AMessage, IRouteResponse + { + public uint OpCode() { return Network.OpCode.AddressableLockResponse; } + [ProtoMember(1)] + public uint ErrorCode { get; set; } + } + [ProtoContract] + public partial class I_AddressableUnLock_Request : AMessage, IRouteRequest + { + [ProtoIgnore] + public I_AddressableUnLock_Response ResponseType { get; set; } + public uint OpCode() { return Network.OpCode.AddressableUnLockRequest; } + public long RouteTypeOpCode() { return 1; } + [ProtoMember(1)] + public long AddressableId { get; set; } + [ProtoMember(2)] + public long RouteId { get; set; } + [ProtoMember(3)] + public string Source { get; set; } + } + [ProtoContract] + public partial class I_AddressableUnLock_Response : AMessage, IRouteResponse + { + public uint OpCode() { return Network.OpCode.AddressableUnLockResponse; } + [ProtoMember(1)] + public uint ErrorCode { get; set; } + } +#if FANTASY_NET + [ProtoContract] + public sealed class I_LinkRoamingRequest : AMessage, IRouteRequest + { + [ProtoIgnore] + public I_LinkRoamingResponse ResponseType { get; set; } + public uint OpCode() { return Fantasy.Network.OpCode.LinkRoamingRequest; } + public long RouteTypeOpCode() { return 1; } + [ProtoMember(1)] + public long RoamingId { get; set; } + [ProtoMember(2)] + public int RoamingType { get; set; } + [ProtoMember(3)] + public long ForwardSessionRouteId { get; set; } + [ProtoMember(4)] + public long SceneRouteId { get; set; } + } + [ProtoContract] + public sealed class I_LinkRoamingResponse : AMessage, IRouteResponse + { + public uint OpCode() { return Fantasy.Network.OpCode.LinkRoamingResponse; } + [ProtoMember(1)] + public long TerminusId { get; set; } + [ProtoMember(2)] + public uint ErrorCode { get; set; } + } + [ProtoContract] + public sealed class I_UnLinkRoamingRequest : AMessage, IRouteRequest + { + [ProtoIgnore] + public I_UnLinkRoamingResponse ResponseType { get; set; } + public uint OpCode() { return Fantasy.Network.OpCode.UnLinkRoamingRequest; } + public long RouteTypeOpCode() { return 1; } + [ProtoMember(1)] + public long RoamingId { get; set; } + [ProtoMember(2)] + public bool DisposeRoaming { get; set; } + } + [ProtoContract] + public sealed class I_UnLinkRoamingResponse : AMessage, IRouteResponse + { + public uint OpCode() { return Fantasy.Network.OpCode.UnLinkRoamingResponse; } + [ProtoMember(1)] + public uint ErrorCode { get; set; } + } + [ProtoContract] + public partial class I_LockTerminusIdRequest : AMessage, IRouteRequest + { + [ProtoIgnore] + public I_LockTerminusIdResponse ResponseType { get; set; } + public uint OpCode() { return Fantasy.Network.OpCode.LockTerminusIdRequest; } + [ProtoMember(1)] + public long SessionRuntimeId { get; set; } + [ProtoMember(2)] + public int RoamingType { get; set; } + } + [ProtoContract] + public partial class I_LockTerminusIdResponse : AMessage, IRouteResponse + { + public uint OpCode() { return Fantasy.Network.OpCode.LockTerminusIdResponse; } + [ProtoMember(1)] + public uint ErrorCode { get; set; } + } + [ProtoContract] + public sealed class I_UnLockTerminusIdRequest : AMessage, IRouteRequest + { + [ProtoIgnore] + public I_UnLockTerminusIdResponse ResponseType { get; set; } + public uint OpCode() { return Fantasy.Network.OpCode.UnLockTerminusIdRequest; } + public long RouteTypeOpCode() { return 1; } + [ProtoMember(1)] + public long SessionRuntimeId { get; set; } + [ProtoMember(2)] + public int RoamingType { get; set; } + [ProtoMember(3)] + public long TerminusId { get; set; } + [ProtoMember(4)] + public long TargetSceneRouteId { get; set; } + } + [ProtoContract] + public sealed class I_UnLockTerminusIdResponse : AMessage, IRouteResponse + { + public uint OpCode() { return Fantasy.Network.OpCode.UnLockTerminusIdResponse; } + [ProtoMember(1)] + public uint ErrorCode { get; set; } + } + /// + /// 漫游传送终端的请求 + /// + public partial class I_TransferTerminusRequest : AMessage, IRouteRequest + { + [BsonIgnore] + public I_TransferTerminusResponse ResponseType { get; set; } + public uint OpCode() { return Fantasy.Network.OpCode.TransferTerminusRequest; } + public Terminus Terminus { get; set; } + } + public partial class I_TransferTerminusResponse : AMessage, IRouteResponse + { + public uint OpCode() { return Fantasy.Network.OpCode.TransferTerminusResponse; } + public uint ErrorCode { get; set; } + } + /// + /// 用于服务器之间获取漫游的TerminusId。 + /// + [ProtoContract] + public partial class I_GetTerminusIdRequest : AMessage, IRouteRequest + { + [ProtoIgnore] + public I_GetTerminusIdResponse ResponseType { get; set; } + public uint OpCode() { return Fantasy.Network.OpCode.GetTerminusIdRequest; } + [ProtoMember(1)] + public int RoamingType { get; set; } + [ProtoMember(2)] + public long SessionRuntimeId { get; set; } + } + [ProtoContract] + public partial class I_GetTerminusIdResponse : AMessage, IRouteResponse + { + public uint OpCode() { return Fantasy.Network.OpCode.GetTerminusIdResponse; } + [ProtoMember(1)] + public long TerminusId { get; set; } + [ProtoMember(2)] + public uint ErrorCode { get; set; } + } +#endif +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/BufferPacketParser.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/BufferPacketParser.cs new file mode 100644 index 0000000..7ff8e8b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/BufferPacketParser.cs @@ -0,0 +1,376 @@ +using System; +using System.Buffers; +using System.IO; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +using NBC.Helper; +using NBC.Network; +using NBC.Network.Interface; +using NBC.PacketParser.Interface; +using NBC.Serialize; + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +namespace NBC.PacketParser +{ + /// + /// BufferPacketParser消息格式化器抽象类 + /// 这个不会用在TCP协议中、因此不用考虑分包和粘包的问题。 + /// 目前这个只会用在KCP协议中、因为KCP出来的就是一个完整的包、所以可以一次性全部解析出来。 + /// 如果是用在其他协议上可能会出现问题。 + /// + public abstract class BufferPacketParser : APacketParser + { + protected uint RpcId; + protected long RouteId; + protected uint ProtocolCode; + protected int MessagePacketLength; + public override void Dispose() + { + RpcId = 0; + RouteId = 0; + ProtocolCode = 0; + MessagePacketLength = 0; + base.Dispose(); + } + /// + /// 解包方法 + /// + /// buffer + /// count + /// packInfo + /// + public abstract bool UnPack(byte[] buffer, ref int count, out APackInfo packInfo); + } +#if FANTASY_NET + /// + /// 服务器之间专用的BufferPacketParser消息格式化器 + /// + public sealed class InnerBufferPacketParser : BufferPacketParser + { + /// + /// + /// + /// + /// + /// + /// + /// + public override unsafe bool UnPack(byte[] buffer, ref int count, out APackInfo packInfo) + { + packInfo = null; + + if (buffer.Length < count) + { + throw new ScanException($"The buffer length is less than the specified count. buffer.Length={buffer.Length} count={count}"); + } + + if (count < Packet.InnerPacketHeadLength) + { + // 如果内存资源中的数据长度小于内部消息头的长度，无法解析 + return false; + } + + fixed (byte* bufferPtr = buffer) + { + MessagePacketLength = *(int*)bufferPtr; + + if (MessagePacketLength > Packet.PacketBodyMaxLength || count < MessagePacketLength) + { + // 检查消息体长度是否超出限制 + throw new ScanException($"The received information exceeds the maximum limit = {MessagePacketLength}"); + } + + ProtocolCode = *(uint*)(bufferPtr + Packet.PacketLength); + RpcId = *(uint*)(bufferPtr + Packet.InnerPacketRpcIdLocation); + RouteId = *(long*)(bufferPtr + Packet.InnerPacketRouteRouteIdLocation); + } + + packInfo = InnerPackInfo.Create(Network); + packInfo.RpcId = RpcId; + packInfo.RouteId = RouteId; + packInfo.ProtocolCode = ProtocolCode; + packInfo.RentMemoryStream(MemoryStreamBufferSource.UnPack, count).Write(buffer, 0, count); + return true; + } + + public override MemoryStreamBuffer Pack(ref uint rpcId, ref long routeId, MemoryStreamBuffer memoryStream, IMessage message) + { + return memoryStream == null ? Pack(ref rpcId, ref routeId, message) : Pack(ref rpcId, ref routeId, memoryStream); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private unsafe MemoryStreamBuffer Pack(ref uint rpcId, ref long routeId, MemoryStreamBuffer memoryStream) + { + fixed (byte* bufferPtr = memoryStream.GetBuffer()) + { + *(uint*)(bufferPtr + Packet.InnerPacketRpcIdLocation) = rpcId; + *(long*)(bufferPtr + Packet.InnerPacketRouteRouteIdLocation) = routeId; + } + + return memoryStream; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private unsafe MemoryStreamBuffer Pack(ref uint rpcId, ref long routeId, IMessage message) + { + var memoryStreamLength = 0; + var messageType = message.GetType(); + var memoryStream = Network.MemoryStreamBufferPool.RentMemoryStream(MemoryStreamBufferSource.Pack); + OpCodeIdStruct opCodeIdStruct = message.OpCode(); + memoryStream.Seek(Packet.InnerPacketHeadLength, SeekOrigin.Begin); + + if (SerializerManager.TryGetSerializer(opCodeIdStruct.OpCodeProtocolType, out var serializer)) + { + serializer.Serialize(messageType, message, memoryStream); + memoryStreamLength = (int)memoryStream.Position; + } + else + { + Log.Error($"type:{messageType} Does not support processing protocol"); + } + + var opCode = Scene.MessageDispatcherComponent.GetOpCode(messageType); + var packetBodyCount = memoryStreamLength - Packet.InnerPacketHeadLength; + + if (packetBodyCount == 0) + { + // protoBuf做了一个优化、就是当序列化的对象里的属性和字段都为默认值的时候就不会序列化任何东西。 + // 为了TCP的分包和粘包、需要判定下是当前包数据不完整还是本应该如此、所以用-1代表。 + packetBodyCount = -1; + } + + if (packetBodyCount > Packet.PacketBodyMaxLength) + { + // 检查消息体长度是否超出限制 + throw new Exception($"Message content exceeds {Packet.PacketBodyMaxLength} bytes"); + } + + fixed (byte* bufferPtr = memoryStream.GetBuffer()) + { + *(int*)bufferPtr = packetBodyCount; + *(uint*)(bufferPtr + Packet.PacketLength) = opCode; + *(uint*)(bufferPtr + Packet.InnerPacketRpcIdLocation) = rpcId; + *(long*)(bufferPtr + Packet.InnerPacketRouteRouteIdLocation) = routeId; + } + + return memoryStream; + } + } +#endif + /// + /// 客户端和服务器之间专用的BufferPacketParser消息格式化器 + /// + public sealed class OuterBufferPacketParser : BufferPacketParser + { + /// + /// + /// + /// + /// + /// + /// + /// + public override unsafe bool UnPack(byte[] buffer, ref int count, out APackInfo packInfo) + { + packInfo = null; + + if (buffer.Length < count) + { + throw new ScanException($"The buffer length is less than the specified count. buffer.Length={buffer.Length} count={count}"); + } + + if (count < Packet.OuterPacketHeadLength) + { + // 如果内存资源中的数据长度小于内部消息头的长度，无法解析 + return false; + } + + fixed (byte* bufferPtr = buffer) + { + MessagePacketLength = *(int*)bufferPtr; + + if (MessagePacketLength > Packet.PacketBodyMaxLength || count < MessagePacketLength) + { + // 检查消息体长度是否超出限制 + throw new ScanException($"The received information exceeds the maximum limit = {MessagePacketLength}"); + } + + ProtocolCode = *(uint*)(bufferPtr + Packet.PacketLength); + RpcId = *(uint*)(bufferPtr + Packet.OuterPacketRpcIdLocation); + } + + packInfo = OuterPackInfo.Create(Network); + packInfo.RpcId = RpcId; + packInfo.ProtocolCode = ProtocolCode; + packInfo.RentMemoryStream(MemoryStreamBufferSource.UnPack, count).Write(buffer, 0, count); + return true; + } + + public override MemoryStreamBuffer Pack(ref uint rpcId, ref long routeId, MemoryStreamBuffer memoryStream, IMessage message) + { + return memoryStream == null ? Pack(ref rpcId, message) : Pack(ref rpcId, memoryStream); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private unsafe MemoryStreamBuffer Pack(ref uint rpcId, MemoryStreamBuffer memoryStream) + { + fixed (byte* bufferPtr = memoryStream.GetBuffer()) + { + *(uint*)(bufferPtr + Packet.InnerPacketRpcIdLocation) = rpcId; + } + + return memoryStream; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private unsafe MemoryStreamBuffer Pack(ref uint rpcId, IMessage message) + { + var memoryStreamLength = 0; + var messageType = message.GetType(); + var memoryStream = Network.MemoryStreamBufferPool.RentMemoryStream(MemoryStreamBufferSource.Pack); + var nmsl = message.OpCode(); + OpCodeIdStruct opCodeIdStruct = message.OpCode(); + memoryStream.Seek(Packet.OuterPacketHeadLength, SeekOrigin.Begin); + + if (SerializerManager.TryGetSerializer(opCodeIdStruct.OpCodeProtocolType, out var serializer)) + { + serializer.Serialize(messageType, message, memoryStream); + memoryStreamLength = (int)memoryStream.Position; + } + else + { + Log.Error($"type:{messageType} Does not support processing protocol"); + } + + var opCode = Scene.MessageDispatcherComponent.GetOpCode(messageType); + var packetBodyCount = memoryStreamLength - Packet.OuterPacketHeadLength; + + if (packetBodyCount == 0) + { + // protoBuf做了一个优化、就是当序列化的对象里的属性和字段都为默认值的时候就不会序列化任何东西。 + // 为了TCP的分包和粘包、需要判定下是当前包数据不完整还是本应该如此、所以用-1代表。 + packetBodyCount = -1; + } + + if (packetBodyCount > Packet.PacketBodyMaxLength) + { + // 检查消息体长度是否超出限制 + throw new Exception($"Message content exceeds {Packet.PacketBodyMaxLength} bytes"); + } + + fixed (byte* bufferPtr = memoryStream.GetBuffer()) + { + *(int*)bufferPtr = packetBodyCount; + *(uint*)(bufferPtr + Packet.PacketLength) = opCode; + *(uint*)(bufferPtr + Packet.OuterPacketRpcIdLocation) = rpcId; + } + + return memoryStream; + } + } + /// + /// Webgl专用的客户端和服务器之间专用的BufferPacketParser消息格式化器 + /// + public sealed class OuterWebglBufferPacketParser : BufferPacketParser + { + /// + /// + /// + /// + /// + /// + /// + /// + public override bool UnPack(byte[] buffer, ref int count, out APackInfo packInfo) + { + packInfo = null; + + if (buffer.Length < count) + { + throw new ScanException($"The buffer length is less than the specified count. buffer.Length={buffer.Length} count={count}"); + } + + if (count < Packet.OuterPacketHeadLength) + { + // 如果内存资源中的数据长度小于内部消息头的长度，无法解析 + return false; + } + + MessagePacketLength = BitConverter.ToInt32(buffer, 0); + + if (MessagePacketLength > Packet.PacketBodyMaxLength || count < MessagePacketLength) + { + // 检查消息体长度是否超出限制 + throw new ScanException($"The received information exceeds the maximum limit = {MessagePacketLength}"); + } + + ProtocolCode = BitConverter.ToUInt32(buffer, Packet.PacketLength); + RpcId = BitConverter.ToUInt32(buffer, Packet.OuterPacketRpcIdLocation); + + packInfo = OuterPackInfo.Create(Network); + packInfo.RpcId = RpcId; + packInfo.ProtocolCode = ProtocolCode; + packInfo.RentMemoryStream(MemoryStreamBufferSource.UnPack, count).Write(buffer, 0, count); + return true; + } + + public override MemoryStreamBuffer Pack(ref uint rpcId, ref long routeId, MemoryStreamBuffer memoryStream, IMessage message) + { + return memoryStream == null ? Pack(ref rpcId, message) : Pack(ref rpcId, memoryStream); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private MemoryStreamBuffer Pack(ref uint rpcId, MemoryStreamBuffer memoryStream) + { + var buffer = memoryStream.GetBuffer().AsSpan(); + MemoryMarshal.Write(buffer.Slice(Packet.OuterPacketRpcIdLocation, sizeof(uint)), ref rpcId); + return memoryStream; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private MemoryStreamBuffer Pack(ref uint rpcId, IMessage message) + { + var memoryStreamLength = 0; + var messageType = message.GetType(); + var memoryStream = Network.MemoryStreamBufferPool.RentMemoryStream(MemoryStreamBufferSource.UnPack); + OpCodeIdStruct opCodeIdStruct = message.OpCode(); + memoryStream.Seek(Packet.OuterPacketHeadLength, SeekOrigin.Begin); + + if (SerializerManager.TryGetSerializer(opCodeIdStruct.OpCodeProtocolType, out var serializer)) + { + serializer.Serialize(messageType, message, memoryStream); + memoryStreamLength = (int)memoryStream.Position; + } + else + { + Log.Error($"type:{messageType} Does not support processing protocol"); + } + + var opCode = Scene.MessageDispatcherComponent.GetOpCode(messageType); + var packetBodyCount = memoryStreamLength - Packet.OuterPacketHeadLength; + + if (packetBodyCount == 0) + { + // protoBuf做了一个优化、就是当序列化的对象里的属性和字段都为默认值的时候就不会序列化任何东西。 + // 为了TCP的分包和粘包、需要判定下是当前包数据不完整还是本应该如此、所以用-1代表。 + packetBodyCount = -1; + } + + if (packetBodyCount > Packet.PacketBodyMaxLength) + { + // 检查消息体长度是否超出限制 + throw new Exception($"Message content exceeds {Packet.PacketBodyMaxLength} bytes"); + } + + var buffer = memoryStream.GetBuffer().AsSpan(); + MemoryMarshal.Write(buffer, ref packetBodyCount); + MemoryMarshal.Write(buffer.Slice(Packet.PacketLength, sizeof(uint)), ref opCode); + MemoryMarshal.Write(buffer.Slice(Packet.OuterPacketRpcIdLocation, sizeof(uint)), ref rpcId); + + return memoryStream; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/BufferPacketParser.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/BufferPacketParser.cs.meta new file mode 100644 index 0000000..32698e5 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/BufferPacketParser.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 0967856d30d1f464b82d88330920914a +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/CircularBufferPacketParser.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/CircularBufferPacketParser.cs new file mode 100644 index 0000000..24c368b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/CircularBufferPacketParser.cs @@ -0,0 +1,170 @@ +// using System.Runtime.CompilerServices; +// // ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +// #pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +// +// namespace Fantasy +// { +// // 这个对处理分包和粘包逻辑不完整、考虑现在没有任何地方使用了、就先不修改了。 +// // 后面用到了再修改、现在这个只是留做备份、万一以后用到了呢。 +// public abstract class CircularBufferPacketParser : APacketParser +// { +// protected uint RpcId; +// protected long RouteId; +// protected uint ProtocolCode; +// protected int MessagePacketLength; +// protected bool IsUnPackHead = true; +// protected readonly byte[] MessageHead = new byte[Packet.InnerPacketHeadLength]; +// public abstract bool UnPack(CircularBuffer buffer, out APackInfo packInfo); +// } +// +// #if FANTASY_NET +// public sealed class InnerCircularBufferPacketParser : CircularBufferPacketParser, IInnerPacketParser +// { +// public override bool UnPack(CircularBuffer buffer, out APackInfo packInfo) +// { +// packInfo = null; +// +// // 在对象没有被释放的情况下循环解析数据 +// while (!IsDisposed) +// { +// if (IsUnPackHead) +// { +// // 如果缓冲区中的数据长度小于内部消息头的长度，无法解析 +// if (buffer.Length < Packet.InnerPacketHeadLength) +// { +// return false; +// } +// +// // 从缓冲区中读取内部消息头的数据 +// _ = buffer.Read(MessageHead, 0, Packet.InnerPacketHeadLength); +// MessagePacketLength = BitConverter.ToInt32(MessageHead, 0); +// +// // 检查消息体长度是否超出限制 +// if (MessagePacketLength > Packet.PacketBodyMaxLength) +// { +// throw new ScanException( +// $"The received information exceeds the maximum limit = {MessagePacketLength}"); +// } +// +// // 解析协议编号、RPC ID 和 Route ID +// ProtocolCode = BitConverter.ToUInt32(MessageHead, Packet.PacketLength); +// RpcId = BitConverter.ToUInt32(MessageHead, Packet.InnerPacketRpcIdLocation); +// RouteId = BitConverter.ToInt64(MessageHead, Packet.InnerPacketRouteRouteIdLocation); +// IsUnPackHead = false; +// } +// +// try +// { +// // 如果缓冲区中的数据长度小于消息体的长度，无法解析 +// if (MessagePacketLength < 0 || buffer.Length < MessagePacketLength) +// { +// return false; +// } +// +// IsUnPackHead = true; +// packInfo = InnerPackInfo.Create(Network); +// var memoryStream = packInfo.RentMemoryStream(MessagePacketLength); +// memoryStream.SetLength(MessagePacketLength); +// buffer.Read(memoryStream, MessagePacketLength); +// packInfo.RpcId = RpcId; +// packInfo.RouteId = RouteId; +// packInfo.ProtocolCode = ProtocolCode; +// packInfo.MessagePacketLength = MessagePacketLength; +// return true; +// } +// catch (Exception e) +// { +// // 在发生异常时，释放 packInfo 并记录日志 +// packInfo?.Dispose(); +// Log.Error(e); +// return false; +// } +// } +// +// return false; +// } +// +// public override MemoryStream Pack(ref uint rpcId, ref long routeTypeOpCode, ref long routeId, +// MemoryStream memoryStream, object message) +// { +// return memoryStream == null +// ? Pack(ref rpcId, ref routeId, message) +// : Pack(ref rpcId, ref routeId, memoryStream); +// } +// +// [MethodImpl(MethodImplOptions.AggressiveInlining)] +// private unsafe MemoryStream Pack(ref uint rpcId, ref long routeId, MemoryStream memoryStream) +// { +// var buffer = memoryStream.GetBuffer(); +// +// fixed (byte* bufferPtr = buffer) +// { +// var rpcIdPtr = bufferPtr + Packet.InnerPacketRpcIdLocation; +// var routeIdPtr = bufferPtr + Packet.InnerPacketRouteRouteIdLocation; +// *(uint*)rpcIdPtr = rpcId; +// *(long*)routeIdPtr = routeId; +// } +// +// memoryStream.Seek(0, SeekOrigin.Begin); +// return memoryStream; +// } +// +// [MethodImpl(MethodImplOptions.AggressiveInlining)] +// private unsafe MemoryStream Pack(ref uint rpcId, ref long routeId, object message) +// { +// var memoryStream = Network.RentMemoryStream(); +// memoryStream.Seek(Packet.InnerPacketHeadLength, SeekOrigin.Begin); +// +// switch (message) +// { +// case IBsonMessage: +// { +// MongoHelper.SerializeTo(message, memoryStream); +// break; +// } +// default: +// { +// ProtoBuffHelper.ToStream(message, memoryStream); +// break; +// } +// } +// +// var opCode = Scene.MessageDispatcherComponent.GetOpCode(message.GetType()); +// var packetBodyCount = (int)(memoryStream.Position - Packet.InnerPacketHeadLength); +// +// if (packetBodyCount == 0) +// { +// // protoBuf做了一个优化、就是当序列化的对象里的属性和字段都为默认值的时候就不会序列化任何东西。 +// // 为了TCP的分包和粘包、需要判定下是当前包数据不完整还是本应该如此、所以用-1代表。 +// packetBodyCount = -1; +// } +// +// // 检查消息体长度是否超出限制 +// if (packetBodyCount > Packet.PacketBodyMaxLength) +// { +// throw new Exception($"Message content exceeds {Packet.PacketBodyMaxLength} bytes"); +// } +// +// var buffer = memoryStream.GetBuffer(); +// +// fixed (byte* bufferPtr = buffer) +// { +// var opCodePtr = bufferPtr + Packet.PacketLength; +// var rpcIdPtr = bufferPtr + Packet.InnerPacketRpcIdLocation; +// var routeIdPtr = bufferPtr + Packet.InnerPacketRouteRouteIdLocation; +// *(int*)bufferPtr = packetBodyCount; +// *(uint*)opCodePtr = opCode; +// *(uint*)rpcIdPtr = rpcId; +// *(long*)routeIdPtr = routeId; +// } +// +// memoryStream.Seek(0, SeekOrigin.Begin); +// return memoryStream; +// } +// } +// #endif +// } +// +// +// +// diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/CircularBufferPacketParser.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/CircularBufferPacketParser.cs.meta new file mode 100644 index 0000000..375b2d6 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/CircularBufferPacketParser.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: be4359634faca4ed99469ac0078203f3 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/OuterBufferPacketParserHelper.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/OuterBufferPacketParserHelper.cs new file mode 100644 index 0000000..a6e66ca --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/OuterBufferPacketParserHelper.cs @@ -0,0 +1,72 @@ +#if FANTASY_NET +using System.Runtime.CompilerServices; +using Fantasy.Helper; +using Fantasy.Network; +using Fantasy.Network.Interface; +using Fantasy.Serialize; + +namespace Fantasy.PacketParser +{ + /// + /// 打包Outer消息的帮助类 + /// + public static class OuterBufferPacketParserHelper + { + /// + /// 打包一个网络消息 + /// + /// scene + /// 如果是RPC消息需要传递一个rpcId + /// 打包的网络消息 + /// 序列化后流的长度 + /// 打包完成会返回一个MemoryStreamBuffer + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static unsafe MemoryStreamBuffer Pack(Scene scene, uint rpcId, IMessage message, out int memoryStreamLength) + { + memoryStreamLength = 0; + var messageType = message.GetType(); + var memoryStream = new MemoryStreamBuffer(); + memoryStream.MemoryStreamBufferSource = MemoryStreamBufferSource.Pack; + OpCodeIdStruct opCodeIdStruct = message.OpCode(); + memoryStream.Seek(Packet.OuterPacketHeadLength, SeekOrigin.Begin); + + if (SerializerManager.TryGetSerializer(opCodeIdStruct.OpCodeProtocolType, out var serializer)) + { + serializer.Serialize(messageType, message, memoryStream); + memoryStreamLength = (int)memoryStream.Position; + } + else + { + Log.Error($"type:{messageType} Does not support processing protocol"); + } + + var opCode = scene.MessageDispatcherComponent.GetOpCode(messageType); + var packetBodyCount = memoryStreamLength - Packet.OuterPacketHeadLength; + + if (packetBodyCount == 0) + { + // protoBuf做了一个优化、就是当序列化的对象里的属性和字段都为默认值的时候就不会序列化任何东西。 + // 为了TCP的分包和粘包、需要判定下是当前包数据不完整还是本应该如此、所以用-1代表。 + packetBodyCount = -1; + } + + if (packetBodyCount > Packet.PacketBodyMaxLength) + { + // 检查消息体长度是否超出限制 + throw new Exception($"Message content exceeds {Packet.PacketBodyMaxLength} bytes"); + } + + fixed (byte* bufferPtr = memoryStream.GetBuffer()) + { + *(int*)bufferPtr = packetBodyCount; + *(uint*)(bufferPtr + Packet.PacketLength) = opCode; + *(uint*)(bufferPtr + Packet.OuterPacketRpcIdLocation) = rpcId; + } + + return memoryStream; + } + } +} + +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/OuterBufferPacketParserHelper.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/OuterBufferPacketParserHelper.cs.meta new file mode 100644 index 0000000..0a0785e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/OuterBufferPacketParserHelper.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: d0d3a0cf7619f4a1db394e6dc0d8a089 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/ReadOnlyMemoryPacketParser.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/ReadOnlyMemoryPacketParser.cs new file mode 100644 index 0000000..e722e74 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/ReadOnlyMemoryPacketParser.cs @@ -0,0 +1,357 @@ +using System; +using System.IO; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +using NBC.Helper; +using NBC.Network; +using NBC.Network.Interface; +using NBC.PacketParser.Interface; +using NBC.Serialize; + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. + +namespace NBC.PacketParser +{ + internal abstract class ReadOnlyMemoryPacketParser : APacketParser + { + /// + /// 一个网络消息包 + /// + protected APackInfo PackInfo; + + protected int Offset; + protected int MessageHeadOffset; + protected int MessageBodyOffset; + protected int MessagePacketLength; + protected bool IsUnPackHead = true; + protected readonly byte[] MessageHead = new byte[20]; + public ReadOnlyMemoryPacketParser() { } + + public abstract bool UnPack(ref ReadOnlyMemory buffer, out APackInfo packInfo); + + public override void Dispose() + { + Offset = 0; + MessageHeadOffset = 0; + MessageBodyOffset = 0; + MessagePacketLength = 0; + IsUnPackHead = true; + PackInfo = null; + Array.Clear(MessageHead, 0, 20); + base.Dispose(); + } + } + +#if FANTASY_NET + internal sealed class InnerReadOnlyMemoryPacketParser : ReadOnlyMemoryPacketParser + { + public override unsafe bool UnPack(ref ReadOnlyMemory buffer, out APackInfo packInfo) + { + packInfo = null; + var readOnlySpan = buffer.Span; + var bufferLength = buffer.Length - Offset; + + if (bufferLength == 0) + { + // 没有剩余的数据需要处理、等待下一个包再处理。 + Offset = 0; + return false; + } + + if (IsUnPackHead) + { + fixed (byte* bufferPtr = readOnlySpan) + fixed (byte* messagePtr = MessageHead) + { + // 在当前buffer中拿到包头的数据 + var innerPacketHeadLength = Packet.InnerPacketHeadLength - MessageHeadOffset; + var copyLength = Math.Min(bufferLength, innerPacketHeadLength); + Buffer.MemoryCopy(bufferPtr + Offset, messagePtr + MessageHeadOffset, innerPacketHeadLength, copyLength); + Offset += copyLength; + MessageHeadOffset += copyLength; + // 检查是否有完整包头 + if (MessageHeadOffset == Packet.InnerPacketHeadLength) + { + // 通过指针直接读取协议编号、messagePacketLength protocolCode rpcId routeId + MessagePacketLength = *(int*)messagePtr; + // 检查消息体长度是否超出限制 + if (MessagePacketLength > Packet.PacketBodyMaxLength) + { + throw new ScanException($"The received information exceeds the maximum limit = {MessagePacketLength}"); + } + + PackInfo = InnerPackInfo.Create(Network); + var memoryStream = PackInfo.RentMemoryStream(MemoryStreamBufferSource.UnPack, Packet.InnerPacketHeadLength + MessagePacketLength); + PackInfo.RpcId = *(uint*)(messagePtr + Packet.InnerPacketRpcIdLocation); + PackInfo.ProtocolCode = *(uint*)(messagePtr + Packet.PacketLength); + PackInfo.RouteId = *(long*)(messagePtr + Packet.InnerPacketRouteRouteIdLocation); + memoryStream.Write(MessageHead); + IsUnPackHead = false; + bufferLength -= copyLength; + MessageHeadOffset = 0; + } + else + { + Offset = 0; + return false; + } + } + } + + if (MessagePacketLength == -1) + { + // protoBuf做了一个优化、就是当序列化的对象里的属性和字段都为默认值的时候就不会序列化任何东西。 + // 为了TCP的分包和粘包、需要判定下是当前包数据不完整还是本应该如此、所以用-1代表。 + packInfo = PackInfo; + PackInfo = null; + IsUnPackHead = true; + return true; + } + + if (bufferLength == 0) + { + // 没有剩余的数据需要处理、等待下一个包再处理。 + Offset = 0; + return false; + } + + // 处理包消息体 + var innerPacketBodyLength = MessagePacketLength - MessageBodyOffset; + var copyBodyLength = Math.Min(bufferLength, innerPacketBodyLength); + // 写入数据到消息体中 + PackInfo.MemoryStream.Write(readOnlySpan.Slice(Offset, copyBodyLength)); + Offset += copyBodyLength; + MessageBodyOffset += copyBodyLength; + // 检查是否是完整的消息体 + if (MessageBodyOffset == MessagePacketLength) + { + packInfo = PackInfo; + PackInfo = null; + IsUnPackHead = true; + MessageBodyOffset = 0; + return true; + } + Offset = 0; + return false; + } + + public override MemoryStreamBuffer Pack(ref uint rpcId, ref long routeId, MemoryStreamBuffer memoryStream, IMessage message) + { + return memoryStream == null ? Pack(ref rpcId, ref routeId, message) : Pack(ref rpcId, ref routeId, memoryStream); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private unsafe MemoryStreamBuffer Pack(ref uint rpcId, ref long routeId, MemoryStreamBuffer memoryStream) + { + fixed (byte* bufferPtr = memoryStream.GetBuffer()) + { + *(uint*)(bufferPtr + Packet.InnerPacketRpcIdLocation) = rpcId; + *(long*)(bufferPtr + Packet.InnerPacketRouteRouteIdLocation) = routeId; + } + + return memoryStream; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private unsafe MemoryStreamBuffer Pack(ref uint rpcId, ref long routeId, IMessage message) + { + var memoryStreamLength = 0; + var messageType = message.GetType(); + var memoryStream = Network.MemoryStreamBufferPool.RentMemoryStream(MemoryStreamBufferSource.Pack); + OpCodeIdStruct opCodeIdStruct = message.OpCode(); + memoryStream.Seek(Packet.InnerPacketHeadLength, SeekOrigin.Begin); + + if (SerializerManager.TryGetSerializer(opCodeIdStruct.OpCodeProtocolType, out var serializer)) + { + serializer.Serialize(messageType, message, memoryStream); + memoryStreamLength = (int)memoryStream.Position; + } + else + { + Log.Error($"type:{messageType} Does not support processing protocol"); + } + + var opCode = Scene.MessageDispatcherComponent.GetOpCode(messageType); + var packetBodyCount = memoryStreamLength - Packet.InnerPacketHeadLength; + + if (packetBodyCount == 0) + { + // protoBuf做了一个优化、就是当序列化的对象里的属性和字段都为默认值的时候就不会序列化任何东西。 + // 为了TCP的分包和粘包、需要判定下是当前包数据不完整还是本应该如此、所以用-1代表。 + // 其实可以不用设置-1、解包的时候判断如果是0也可以、但我仔细想了下，还是用-1代表更加清晰。 + packetBodyCount = -1; + } + + if (packetBodyCount > Packet.PacketBodyMaxLength) + { + // 检查消息体长度是否超出限制 + throw new Exception($"Message content exceeds {Packet.PacketBodyMaxLength} bytes"); + } + + fixed (byte* bufferPtr = memoryStream.GetBuffer()) + { + *(int*)bufferPtr = packetBodyCount; + *(uint*)(bufferPtr + Packet.PacketLength) = opCode; + *(uint*)(bufferPtr + Packet.InnerPacketRpcIdLocation) = rpcId; + *(long*)(bufferPtr + Packet.InnerPacketRouteRouteIdLocation) = routeId; + } + + return memoryStream; + } + } +#endif + internal sealed class OuterReadOnlyMemoryPacketParser : ReadOnlyMemoryPacketParser + { + public override unsafe bool UnPack(ref ReadOnlyMemory buffer, out APackInfo packInfo) + { + packInfo = null; + var readOnlySpan = buffer.Span; + var bufferLength = buffer.Length - Offset; + + if (bufferLength == 0) + { + // 没有剩余的数据需要处理、等待下一个包再处理。 + Offset = 0; + return false; + } + + if (IsUnPackHead) + { + fixed (byte* bufferPtr = readOnlySpan) + fixed (byte* messagePtr = MessageHead) + { + // 在当前buffer中拿到包头的数据 + var outerPacketHeadLength = Packet.OuterPacketHeadLength - MessageHeadOffset; + var copyLength = Math.Min(bufferLength, outerPacketHeadLength); + Buffer.MemoryCopy(bufferPtr + Offset, messagePtr + MessageHeadOffset, outerPacketHeadLength, copyLength); + Offset += copyLength; + MessageHeadOffset += copyLength; + // 检查是否有完整包头 + if (MessageHeadOffset == Packet.OuterPacketHeadLength) + { + // 通过指针直接读取协议编号、messagePacketLength protocolCode rpcId routeId + MessagePacketLength = *(int*)messagePtr; + // 检查消息体长度是否超出限制 + if (MessagePacketLength > Packet.PacketBodyMaxLength) + { + throw new ScanException($"The received information exceeds the maximum limit = {MessagePacketLength}"); + } + + PackInfo = OuterPackInfo.Create(Network); + PackInfo.ProtocolCode = *(uint*)(messagePtr + Packet.PacketLength); + PackInfo.RpcId = *(uint*)(messagePtr + Packet.OuterPacketRpcIdLocation); + var memoryStream = PackInfo.RentMemoryStream(MemoryStreamBufferSource.UnPack, Packet.OuterPacketHeadLength + MessagePacketLength); + memoryStream.Write(MessageHead); + IsUnPackHead = false; + bufferLength -= copyLength; + MessageHeadOffset = 0; + } + else + { + Offset = 0; + return false; + } + } + } + + if (MessagePacketLength == -1) + { + // protoBuf做了一个优化、就是当序列化的对象里的属性和字段都为默认值的时候就不会序列化任何东西。 + // 为了TCP的分包和粘包、需要判定下是当前包数据不完整还是本应该如此、所以用-1代表。 + packInfo = PackInfo; + PackInfo = null; + IsUnPackHead = true; + return true; + } + + if (bufferLength == 0) + { + // 没有剩余的数据需要处理、等待下一个包再处理。 + Offset = 0; + return false; + } + // 处理包消息体 + var outerPacketBodyLength = MessagePacketLength - MessageBodyOffset; + var copyBodyLength = Math.Min(bufferLength, outerPacketBodyLength); + // 写入数据到消息体中 + PackInfo.MemoryStream.Write(readOnlySpan.Slice(Offset, copyBodyLength)); + Offset += copyBodyLength; + MessageBodyOffset += copyBodyLength; + // 检查是否是完整的消息体 + if (MessageBodyOffset == MessagePacketLength) + { + packInfo = PackInfo; + PackInfo = null; + IsUnPackHead = true; + MessageBodyOffset = 0; + return true; + } + + Offset = 0; + return false; + } + + public override MemoryStreamBuffer Pack(ref uint rpcId, ref long routeId, MemoryStreamBuffer memoryStream, IMessage message) + { + return memoryStream == null ? Pack(ref rpcId, message) : Pack(ref rpcId, memoryStream); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private unsafe MemoryStreamBuffer Pack(ref uint rpcId, MemoryStreamBuffer memoryStream) + { + fixed (byte* bufferPtr = memoryStream.GetBuffer()) + { + *(uint*)(bufferPtr + Packet.OuterPacketRpcIdLocation) = rpcId; + } + + return memoryStream; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private unsafe MemoryStreamBuffer Pack(ref uint rpcId, IMessage message) + { + var memoryStreamLength = 0; + var messageType = message.GetType(); + var memoryStream = Network.MemoryStreamBufferPool.RentMemoryStream(MemoryStreamBufferSource.Pack); + OpCodeIdStruct opCodeIdStruct = message.OpCode(); + memoryStream.Seek(Packet.OuterPacketHeadLength, SeekOrigin.Begin); + + if (SerializerManager.TryGetSerializer(opCodeIdStruct.OpCodeProtocolType, out var serializer)) + { + serializer.Serialize(messageType, message, memoryStream); + memoryStreamLength = (int)memoryStream.Position; + } + else + { + Log.Error($"type:{messageType} Does not support processing protocol"); + } + + var opCode = Scene.MessageDispatcherComponent.GetOpCode(messageType); + var packetBodyCount = memoryStreamLength - Packet.OuterPacketHeadLength; + + if (packetBodyCount == 0) + { + // protoBuf做了一个优化、就是当序列化的对象里的属性和字段都为默认值的时候就不会序列化任何东西。 + // 为了TCP的分包和粘包、需要判定下是当前包数据不完整还是本应该如此、所以用-1代表。 + packetBodyCount = -1; + } + + if (packetBodyCount > Packet.PacketBodyMaxLength) + { + // 检查消息体长度是否超出限制 + throw new Exception($"Message content exceeds {Packet.PacketBodyMaxLength} bytes"); + } + + fixed (byte* bufferPtr = memoryStream.GetBuffer()) + { + *(int*)bufferPtr = packetBodyCount; + *(uint*)(bufferPtr + Packet.PacketLength) = opCode; + *(uint*)(bufferPtr + Packet.OuterPacketRpcIdLocation) = rpcId; + } + + return memoryStream; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/ReadOnlyMemoryPacketParser.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/ReadOnlyMemoryPacketParser.cs.meta new file mode 100644 index 0000000..cfa37d9 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Handler/ReadOnlyMemoryPacketParser.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ba02e3545888e431f896b40c391db7a8 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APackInfo.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APackInfo.cs new file mode 100644 index 0000000..c4163b6 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APackInfo.cs @@ -0,0 +1,61 @@ +using System; +using System.IO; +using NBC.Network; +using NBC.Network.Interface; +using NBC.Serialize; + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.PacketParser.Interface +{ + public abstract class APackInfo : IDisposable + { + internal ANetwork Network; + + public uint RpcId; + public long RouteId; + public long PackInfoId; + public bool IsDisposed; + private uint _protocolCode; + + public uint ProtocolCode + { + get => _protocolCode; + set + { + _protocolCode = value; + OpCodeIdStruct = value; + } + } + public OpCodeIdStruct OpCodeIdStruct { get; private set; } + public MemoryStreamBuffer MemoryStream { get; protected set; } + public abstract object Deserialize(Type messageType); + public abstract MemoryStreamBuffer RentMemoryStream(MemoryStreamBufferSource memoryStreamBufferSource, int size = 0); + public virtual void Dispose() + { + if (IsDisposed) + { + return; + } + + RpcId = 0; + RouteId = 0; + PackInfoId = 0; + ProtocolCode = 0; + _protocolCode = 0; + OpCodeIdStruct = default; + + if (MemoryStream != null) + { + Network.MemoryStreamBufferPool.ReturnMemoryStream(MemoryStream); + MemoryStream = null; + } + + IsDisposed = true; + Network = null; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APackInfo.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APackInfo.cs.meta new file mode 100644 index 0000000..41d0927 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APackInfo.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 0cb78fb80aac6490cb0fde6f38195b3b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APacketParser.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APacketParser.cs new file mode 100644 index 0000000..29aba31 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APacketParser.cs @@ -0,0 +1,30 @@ +using System; +using System.Buffers; +using System.IO; +using NBC.Network.Interface; +using NBC.Serialize; + +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.PacketParser.Interface +{ + /// + /// 抽象的包解析器基类，用于解析网络通信数据包。 + /// + public abstract class APacketParser : IDisposable + { + internal Scene Scene; + internal ANetwork Network; + internal MessageDispatcherComponent MessageDispatcherComponent; + protected bool IsDisposed { get; private set; } + public abstract MemoryStreamBuffer Pack(ref uint rpcId, ref long routeId, MemoryStreamBuffer memoryStream, IMessage message); + public virtual void Dispose() + { + IsDisposed = true; + Scene = null; + MessageDispatcherComponent = null; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APacketParser.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APacketParser.cs.meta new file mode 100644 index 0000000..e1bbd00 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Interface/APacketParser.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: b61358c7f6d9f4b58a26d9a57b79ba45 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/OpCode.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/OpCode.cs new file mode 100644 index 0000000..b845891 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/OpCode.cs @@ -0,0 +1,125 @@ +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace NBC.Network +{ + public struct OpCodeIdStruct + { + // OpCodeIdStruct:5 + 4 + 23 = 32 + // +-------------------------+-------------------------------------------+-----------------------------+ + // | protocol(5) 最多31种类型 | OpCodeProtocolType(4) 最多15种不同的网络协议 | Index(23) 最多8388607个协议 | + // +-------------------------+-------------------------------------------+-----------------------------+ + public uint OpCodeProtocolType { get; private set; } + public uint Protocol { get; private set; } + public uint Index { get; private set; } + + public OpCodeIdStruct(uint opCodeProtocolType, uint protocol, uint index) + { + OpCodeProtocolType = opCodeProtocolType; + Protocol = protocol; + Index = index; + } + + public static implicit operator uint(OpCodeIdStruct opCodeIdStruct) + { + var result = opCodeIdStruct.Index; + result |= opCodeIdStruct.OpCodeProtocolType << 23; + result |= opCodeIdStruct.Protocol << 27; + return result; + } + + public static implicit operator OpCodeIdStruct(uint opCodeId) + { + var opCodeIdStruct = new OpCodeIdStruct() + { + Index = opCodeId & 0x7FFFFF + }; + opCodeId >>= 23; + opCodeIdStruct.OpCodeProtocolType = opCodeId & 0xF; + opCodeId >>= 4; + opCodeIdStruct.Protocol = opCodeId & 0x1F; + return opCodeIdStruct; + } + } + + public static class OpCodeProtocolType + { + public const uint Bson = 1; + public const uint ProtoBuf = 0; + } + + public static class OpCodeType + { + public const uint OuterMessage = 1; + public const uint OuterRequest = 2; + public const uint OuterResponse = 3; + + public const uint InnerMessage = 4; + public const uint InnerRequest = 5; + public const uint InnerResponse = 6; + + public const uint InnerRouteMessage = 7; + public const uint InnerRouteRequest = 8; + public const uint InnerRouteResponse = 9; + + public const uint OuterAddressableMessage = 10; + public const uint OuterAddressableRequest = 11; + public const uint OuterAddressableResponse = 12; + + public const uint InnerAddressableMessage = 13; + public const uint InnerAddressableRequest = 14; + public const uint InnerAddressableResponse = 15; + + public const uint OuterCustomRouteMessage = 16; + public const uint OuterCustomRouteRequest = 17; + public const uint OuterCustomRouteResponse = 18; + + public const uint OuterRoamingMessage = 19; + public const uint OuterRoamingRequest = 20; + public const uint OuterRoamingResponse = 21; + + public const uint InnerRoamingMessage = 22; + public const uint InnerRoamingRequest = 23; + public const uint InnerRoamingResponse = 24; + + public const uint OuterPingRequest = 30; + public const uint OuterPingResponse = 31; + } + + public static class OpCode + { + public static readonly uint BenchmarkMessage = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.OuterMessage, 8388607); + public static readonly uint BenchmarkRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.OuterRequest, 8388607); + public static readonly uint BenchmarkResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.OuterResponse, 8388607); + public static readonly uint PingRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.OuterPingRequest, 1); + public static readonly uint PingResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.OuterPingResponse, 1); + public static readonly uint DefaultResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerResponse, 1); + public static readonly uint DefaultRouteResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteResponse, 7); + public static readonly uint AddressableAddRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteRequest, 1); + public static readonly uint AddressableAddResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteResponse, 1); + public static readonly uint AddressableGetRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteRequest, 2); + public static readonly uint AddressableGetResponse = Create(OpCodeProtocolType.ProtoBuf,OpCodeType.InnerRouteResponse,2); + public static readonly uint AddressableRemoveRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteRequest, 3); + public static readonly uint AddressableRemoveResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteResponse, 3); + public static readonly uint AddressableLockRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteRequest, 4); + public static readonly uint AddressableLockResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteResponse, 4); + public static readonly uint AddressableUnLockRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteRequest, 5); + public static readonly uint AddressableUnLockResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteResponse, 5); + public static readonly uint LinkRoamingRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteRequest, 6); + public static readonly uint LinkRoamingResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteResponse, 6); + public static readonly uint UnLinkRoamingRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteRequest, 8); + public static readonly uint UnLinkRoamingResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteResponse, 8); + public static readonly uint LockTerminusIdRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteRequest, 9); + public static readonly uint LockTerminusIdResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteResponse, 9); + public static readonly uint UnLockTerminusIdRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteRequest, 10); + public static readonly uint UnLockTerminusIdResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteResponse, 10); + public static readonly uint GetTerminusIdRequest = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteRequest, 11); + public static readonly uint GetTerminusIdResponse = Create(OpCodeProtocolType.ProtoBuf, OpCodeType.InnerRouteResponse, 11); + + public static readonly uint TransferTerminusRequest = Create(OpCodeProtocolType.Bson, OpCodeType.InnerRouteRequest, 1); + public static readonly uint TransferTerminusResponse = Create(OpCodeProtocolType.Bson, OpCodeType.InnerRouteResponse, 1); + + public static uint Create(uint opCodeProtocolType, uint protocol, uint index) + { + return new OpCodeIdStruct(opCodeProtocolType, protocol, index); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/InnerPackInfo.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/InnerPackInfo.cs new file mode 100644 index 0000000..eae9033 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/InnerPackInfo.cs @@ -0,0 +1,79 @@ +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract + +using NBC.Network; +using NBC.Network.Interface; +using NBC.PacketParser.Interface; +using NBC.Pool; +using NBC.Serialize; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8603 // Possible null reference return. +#if FANTASY_NET +namespace Fantasy.PacketParser +{ + public sealed class InnerPackInfo : APackInfo + { + private readonly Dictionary> _createInstances = new Dictionary>(); + + public override void Dispose() + { + if (IsDisposed) + { + return; + } + + var network = Network; + base.Dispose(); + network.ReturnInnerPackInfo(this); + } + + public static InnerPackInfo Create(ANetwork network) + { + var innerPackInfo = network.RentInnerPackInfo(); + innerPackInfo.Network = network; + innerPackInfo.IsDisposed = false; + return innerPackInfo; + } + + public override MemoryStreamBuffer RentMemoryStream(MemoryStreamBufferSource memoryStreamBufferSource, int size = 0) + { + return MemoryStream ??= Network.MemoryStreamBufferPool.RentMemoryStream(memoryStreamBufferSource, size); + } + + public override object Deserialize(Type messageType) + { + if (MemoryStream == null) + { + Log.Debug("Deserialize MemoryStream is null"); + return null; + } + + MemoryStream.Seek(Packet.InnerPacketHeadLength, SeekOrigin.Begin); + + if (MemoryStream.Length == 0) + { + if (_createInstances.TryGetValue(messageType, out var createInstance)) + { + return createInstance(); + } + + createInstance = CreateInstance.CreateObject(messageType); + _createInstances.Add(messageType, createInstance); + return createInstance(); + } + + if (SerializerManager.TryGetSerializer(OpCodeIdStruct.OpCodeProtocolType, out var serializer)) + { + var obj = serializer.Deserialize(messageType, MemoryStream); + MemoryStream.Seek(0, SeekOrigin.Begin); + return obj; + } + + MemoryStream.Seek(0, SeekOrigin.Begin); + Log.Error($"protocolCode:{ProtocolCode} Does not support processing protocol"); + return null; + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/InnerPackInfo.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/InnerPackInfo.cs.meta new file mode 100644 index 0000000..b5e37e1 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/InnerPackInfo.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: c7324100bcab9421b9534820f3274b7a +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/OuterPackInfo.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/OuterPackInfo.cs new file mode 100644 index 0000000..636704a --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/OuterPackInfo.cs @@ -0,0 +1,73 @@ +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +using System; +using System.IO; +using NBC.Network; +using NBC.Network.Interface; +using NBC.PacketParser.Interface; +using NBC.Serialize; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8603 // Possible null reference return. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8602 // Dereference of a possibly null reference. +namespace NBC.PacketParser +{ + public sealed class OuterPackInfo : APackInfo + { + public override void Dispose() + { + if (IsDisposed) + { + return; + } + var network = Network; + base.Dispose(); + network.ReturnOuterPackInfo(this); + } + + public static OuterPackInfo Create(ANetwork network) + { + var outerPackInfo = network.RentOuterPackInfo(); + outerPackInfo.Network = network; + outerPackInfo.IsDisposed = false; + return outerPackInfo; + } + + public override MemoryStreamBuffer RentMemoryStream(MemoryStreamBufferSource memoryStreamBufferSource, int size = 0) + { + if (MemoryStream == null) + { + MemoryStream = Network.MemoryStreamBufferPool.RentMemoryStream(memoryStreamBufferSource, size); + } + + return MemoryStream; + } + + /// + /// 将消息数据从内存反序列化为指定的消息类型实例。 + /// + /// 目标消息类型。 + /// 反序列化后的消息类型实例。 + public override object Deserialize(Type messageType) + { + if (MemoryStream == null) + { + Log.Debug("Deserialize MemoryStream is null"); + return null; + } + + MemoryStream.Seek(Packet.OuterPacketHeadLength, SeekOrigin.Begin); + + if (SerializerManager.TryGetSerializer(OpCodeIdStruct.OpCodeProtocolType, out var serializer)) + { + var obj = serializer.Deserialize(messageType, MemoryStream); + MemoryStream.Seek(0, SeekOrigin.Begin); + return obj; + } + + MemoryStream.Seek(0, SeekOrigin.Begin); + Log.Error($"protocolCode:{ProtocolCode} Does not support processing protocol"); + return null; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/OuterPackInfo.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/OuterPackInfo.cs.meta new file mode 100644 index 0000000..66f848f --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/OuterPackInfo.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 089b5fa434fce46a3898f46df31c53d1 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/ProcessPackInfo.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/ProcessPackInfo.cs new file mode 100644 index 0000000..f010858 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/ProcessPackInfo.cs @@ -0,0 +1,160 @@ +#if FANTASY_NET +using System.Collections.Concurrent; +using Fantasy.Network; +using Fantasy.Network.Interface; +using Fantasy.PacketParser.Interface; +using Fantasy.Pool; +using Fantasy.Serialize; + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8603 // Possible null reference return. +namespace Fantasy.PacketParser +{ + public sealed class ProcessPackInfo : APackInfo + { + private int _disposeCount; + public Type MessageType { get; private set; } + private static readonly ConcurrentQueue Caches = new ConcurrentQueue(); + private readonly ConcurrentDictionary> _createInstances = new ConcurrentDictionary>(); + + public override void Dispose() + { + if (--_disposeCount > 0 || IsDisposed) + { + return; + } + + _disposeCount = 0; + MessageType = null; + base.Dispose(); + + if (Caches.Count > 2000) + { + return; + } + + Caches.Enqueue(this); + } + + public static unsafe ProcessPackInfo Create(Scene scene, T message, int disposeCount, uint rpcId = 0, long routeId = 0) where T : IRouteMessage + { + if (!Caches.TryDequeue(out var packInfo)) + { + packInfo = new ProcessPackInfo(); + } + + var type = typeof(T); + var memoryStreamLength = 0; + packInfo._disposeCount = disposeCount; + packInfo.MessageType = type; + packInfo.IsDisposed = false; + var memoryStream = new MemoryStreamBuffer(); + memoryStream.MemoryStreamBufferSource = MemoryStreamBufferSource.Pack; + OpCodeIdStruct opCodeIdStruct = message.OpCode(); + memoryStream.Seek(Packet.InnerPacketHeadLength, SeekOrigin.Begin); + + if (SerializerManager.TryGetSerializer(opCodeIdStruct.OpCodeProtocolType, out var serializer)) + { + serializer.Serialize(type, message, memoryStream); + memoryStreamLength = (int)memoryStream.Position; + } + else + { + Log.Error($"type:{type} Does not support processing protocol"); + } + + var opCode = scene.MessageDispatcherComponent.GetOpCode(packInfo.MessageType); + var packetBodyCount = memoryStreamLength - Packet.InnerPacketHeadLength; + + if (packetBodyCount == 0) + { + // protoBuf做了一个优化、就是当序列化的对象里的属性和字段都为默认值的时候就不会序列化任何东西。 + // 为了TCP的分包和粘包、需要判定下是当前包数据不完整还是本应该如此、所以用-1代表。 + packetBodyCount = -1; + } + + if (packetBodyCount > Packet.PacketBodyMaxLength) + { + // 检查消息体长度是否超出限制 + throw new Exception($"Message content exceeds {Packet.PacketBodyMaxLength} bytes"); + } + + var buffer = memoryStream.GetBuffer(); + + fixed (byte* bufferPtr = buffer) + { + var opCodePtr = bufferPtr + Packet.PacketLength; + var rpcIdPtr = bufferPtr + Packet.InnerPacketRpcIdLocation; + var routeIdPtr = bufferPtr + Packet.InnerPacketRouteRouteIdLocation; + *(int*)bufferPtr = packetBodyCount; + *(uint*)opCodePtr = opCode; + *(uint*)rpcIdPtr = rpcId; + *(long*)routeIdPtr = routeId; + } + + memoryStream.Seek(0, SeekOrigin.Begin); + packInfo.MemoryStream = memoryStream; + return packInfo; + } + + public unsafe void Set(uint rpcId, long routeId) + { + var buffer = MemoryStream.GetBuffer(); + + fixed (byte* bufferPtr = buffer) + { + var rpcIdPtr = bufferPtr + Packet.InnerPacketRpcIdLocation; + var routeIdPtr = bufferPtr + Packet.InnerPacketRouteRouteIdLocation; + *(uint*)rpcIdPtr = rpcId; + *(long*)routeIdPtr = routeId; + } + + MemoryStream.Seek(0, SeekOrigin.Begin); + } + + public override MemoryStreamBuffer RentMemoryStream(MemoryStreamBufferSource memoryStreamBufferSource, int size = 0) + { + throw new NotImplementedException(); + } + + public override object Deserialize(Type messageType) + { + if (MemoryStream == null) + { + Log.Debug("Deserialize MemoryStream is null"); + return null; + } + + object obj = null; + MemoryStream.Seek(Packet.InnerPacketHeadLength, SeekOrigin.Begin); + + if (MemoryStream.Length == 0) + { + if (_createInstances.TryGetValue(messageType, out var createInstance)) + { + return createInstance(); + } + + createInstance = CreateInstance.CreateObject(messageType); + _createInstances.TryAdd(messageType, createInstance); + return createInstance(); + } + + if (SerializerManager.TryGetSerializer(OpCodeIdStruct.OpCodeProtocolType, out var serializer)) + { + obj = serializer.Deserialize(messageType, MemoryStream); + MemoryStream.Seek(0, SeekOrigin.Begin); + return obj; + } + + MemoryStream.Seek(0, SeekOrigin.Begin); + Log.Error($"protocolCode:{ProtocolCode} Does not support processing protocol"); + return null; + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/ProcessPackInfo.cs.meta b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/ProcessPackInfo.cs.meta new file mode 100644 index 0000000..dc55c46 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Pack/ProcessPackInfo.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 703b20fc55fb240df9156adfa9919907 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Packet.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Packet.cs new file mode 100644 index 0000000..2a507b2 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/Packet.cs @@ -0,0 +1,49 @@ +namespace NBC.PacketParser +{ + /// + /// 提供关于消息包的常量定义。 + /// + public struct Packet + { + /// + /// 消息体最大长度 + /// + public const int PacketBodyMaxLength = ushort.MaxValue * 16; + /// + /// 消息体长度在消息头占用的长度 + /// + public const int PacketLength = sizeof(int); + /// + /// 协议编号在消息头占用的长度 + /// + public const int ProtocolCodeLength = sizeof(uint); + /// + /// RouteId长度 + /// + public const int PacketRouteIdLength = sizeof(long); + /// + /// RpcId在消息头占用的长度 + /// + public const int RpcIdLength = sizeof(uint); + /// + /// OuterRPCId所在的位置 + /// + public const int OuterPacketRpcIdLocation = PacketLength + ProtocolCodeLength; + /// + /// InnerRPCId所在的位置 + /// + public const int InnerPacketRpcIdLocation = PacketLength + ProtocolCodeLength; + /// + /// RouteId所在的位置 + /// + public const int InnerPacketRouteRouteIdLocation = PacketLength + ProtocolCodeLength + RpcIdLength; + /// + /// 外网消息头长度（消息体长度在消息头占用的长度 + 协议编号在消息头占用的长度 + RPCId长度 + RouteId长度） + /// + public const int OuterPacketHeadLength = PacketLength + ProtocolCodeLength + RpcIdLength + PacketRouteIdLength; + /// + /// 内网消息头长度（消息体长度在消息头占用的长度 + 协议编号在消息头占用的长度 + RPCId长度 + RouteId长度） + /// + public const int InnerPacketHeadLength = PacketLength + ProtocolCodeLength + RpcIdLength + PacketRouteIdLength; + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/PacketParser/PacketParserFactory.cs b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/PacketParserFactory.cs new file mode 100644 index 0000000..fed007b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/PacketParser/PacketParserFactory.cs @@ -0,0 +1,173 @@ +using System; +using NBC.Network; +using NBC.Network.Interface; +using NBC.PacketParser.Interface; + +// ReSharper disable PossibleNullReferenceException +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8603 // Possible null reference return. +namespace NBC.PacketParser +{ + internal static class PacketParserFactory + { +#if FANTASY_NET + internal static ReadOnlyMemoryPacketParser CreateServerReadOnlyMemoryPacket(ANetwork network) + { + ReadOnlyMemoryPacketParser readOnlyMemoryPacketParser = null; + + switch (network.NetworkTarget) + { + case NetworkTarget.Inner: + { + readOnlyMemoryPacketParser = new InnerReadOnlyMemoryPacketParser(); + break; + } + case NetworkTarget.Outer: + { + readOnlyMemoryPacketParser = new OuterReadOnlyMemoryPacketParser(); + break; + } + } + + readOnlyMemoryPacketParser.Scene = network.Scene; + readOnlyMemoryPacketParser.Network = network; + readOnlyMemoryPacketParser.MessageDispatcherComponent = network.Scene.MessageDispatcherComponent; + return readOnlyMemoryPacketParser; + } + + public static BufferPacketParser CreateServerBufferPacket(ANetwork network) + { + BufferPacketParser bufferPacketParser = null; + + switch (network.NetworkTarget) + { + case NetworkTarget.Inner: + { + bufferPacketParser = new InnerBufferPacketParser(); + break; + } + case NetworkTarget.Outer: + { + bufferPacketParser = new OuterBufferPacketParser(); + break; + } + } + + bufferPacketParser.Scene = network.Scene; + bufferPacketParser.Network = network; + bufferPacketParser.MessageDispatcherComponent = network.Scene.MessageDispatcherComponent; + return bufferPacketParser; + } +#endif + internal static ReadOnlyMemoryPacketParser CreateClientReadOnlyMemoryPacket(ANetwork network) + { + ReadOnlyMemoryPacketParser readOnlyMemoryPacketParser = null; + + switch (network.NetworkTarget) + { +#if FANTASY_NET + case NetworkTarget.Inner: + { + readOnlyMemoryPacketParser = new InnerReadOnlyMemoryPacketParser(); + break; + } +#endif + case NetworkTarget.Outer: + { + readOnlyMemoryPacketParser = new OuterReadOnlyMemoryPacketParser(); + break; + } + } + + readOnlyMemoryPacketParser.Scene = network.Scene; + readOnlyMemoryPacketParser.Network = network; + readOnlyMemoryPacketParser.MessageDispatcherComponent = network.Scene.MessageDispatcherComponent; + return readOnlyMemoryPacketParser; + } + +#if !FANTASY_WEBGL + public static BufferPacketParser CreateClientBufferPacket(ANetwork network) + { + BufferPacketParser bufferPacketParser = null; + + switch (network.NetworkTarget) + { +#if FANTASY_NET + case NetworkTarget.Inner: + { + bufferPacketParser = new InnerBufferPacketParser(); + break; + } +#endif + case NetworkTarget.Outer: + { + bufferPacketParser = new OuterBufferPacketParser(); + break; + } + } + + bufferPacketParser.Scene = network.Scene; + bufferPacketParser.Network = network; + bufferPacketParser.MessageDispatcherComponent = network.Scene.MessageDispatcherComponent; + return bufferPacketParser; + } +#endif + public static T CreateClient(ANetwork network) where T : APacketParser + { + var packetParserType = typeof(T); + + switch (network.NetworkTarget) + { +#if FANTASY_NET + case NetworkTarget.Inner: + { + APacketParser innerPacketParser = null; + + if (packetParserType == typeof(ReadOnlyMemoryPacketParser)) + { + innerPacketParser = new InnerReadOnlyMemoryPacketParser(); + } + else if (packetParserType == typeof(BufferPacketParser)) + { + innerPacketParser = new InnerBufferPacketParser(); + } + // else if(packetParserType == typeof(CircularBufferPacketParser)) + // { + // innerPacketParser = new InnerCircularBufferPacketParser(); + // } + + innerPacketParser.Scene = network.Scene; + innerPacketParser.Network = network; + innerPacketParser.MessageDispatcherComponent = network.Scene.MessageDispatcherComponent; + return (T)innerPacketParser; + } +#endif + case NetworkTarget.Outer: + { + APacketParser outerPacketParser = null; + + if (packetParserType == typeof(ReadOnlyMemoryPacketParser)) + { + outerPacketParser = new OuterReadOnlyMemoryPacketParser(); + } + else if (packetParserType == typeof(BufferPacketParser)) + { +#if FANTASY_WEBGL + outerPacketParser = new OuterWebglBufferPacketParser(); +#else + outerPacketParser = new OuterBufferPacketParser(); +#endif + } + outerPacketParser.Scene = network.Scene; + outerPacketParser.Network = network; + outerPacketParser.MessageDispatcherComponent = network.Scene.MessageDispatcherComponent; + return (T)outerPacketParser; + } + default: + throw new ArgumentOutOfRangeException(); + } + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/Scheduler/ClientMessageScheduler.cs b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/ClientMessageScheduler.cs new file mode 100644 index 0000000..dacae03 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/ClientMessageScheduler.cs @@ -0,0 +1,85 @@ +using System; +using NBC.Async; +using NBC.Network; +using NBC.Network.Interface; +using NBC.PacketParser.Interface; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.Scheduler +{ + /// + /// 提供了一个用于客户端网络消息调度和处理的抽象基类。 + /// + public sealed class ClientMessageScheduler : ANetworkMessageScheduler + { + public ClientMessageScheduler(Scene scene) : base(scene) { } + + public override async FTask Scheduler(Session session, APackInfo packInfo) + { + await FTask.CompletedTask; + switch (packInfo.OpCodeIdStruct.Protocol) + { + case OpCodeType.OuterMessage: + case OpCodeType.OuterRequest: + case OpCodeType.OuterAddressableMessage: + case OpCodeType.OuterAddressableRequest: + case OpCodeType.OuterCustomRouteMessage: + case OpCodeType.OuterCustomRouteRequest: + case OpCodeType.OuterRoamingMessage: + case OpCodeType.OuterRoamingRequest: + { + using (packInfo) + { + var messageType = MessageDispatcherComponent.GetOpCodeType(packInfo.ProtocolCode); + + if (messageType == null) + { + throw new Exception($"可能遭受到恶意发包或没有协议定义ProtocolCode ProtocolCode：{packInfo.ProtocolCode}"); + } + + var message = packInfo.Deserialize(messageType); + MessageDispatcherComponent.MessageHandler(session, messageType, message, packInfo.RpcId, packInfo.ProtocolCode); + } + + return; + } + case OpCodeType.OuterResponse: + case OpCodeType.OuterPingResponse: + case OpCodeType.OuterAddressableResponse: + case OpCodeType.OuterCustomRouteResponse: + case OpCodeType.OuterRoamingResponse: + { + using (packInfo) + { + var messageType = MessageDispatcherComponent.GetOpCodeType(packInfo.ProtocolCode); + + if (messageType == null) + { + throw new Exception($"可能遭受到恶意发包或没有协议定义ProtocolCode ProtocolCode：{packInfo.ProtocolCode}"); + } + + // 这个一般是客户端Session.Call发送时使用的、目前这个逻辑只有Unity客户端时使用 + + var aResponse = (IResponse)packInfo.Deserialize(messageType); + + if (!session.RequestCallback.Remove(packInfo.RpcId, out var action)) + { + Log.Error($"not found rpc {packInfo.RpcId}, response message: {aResponse.GetType().Name}"); + return; + } + NetMessageDelegate.Response(aResponse); + action.SetResult(aResponse); + } + + return; + } + default: + { + packInfo.Dispose(); + throw new NotSupportedException($"Received unsupported message protocolCode:{packInfo.ProtocolCode}"); + } + } + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/Scheduler/InnerMessageScheduler.cs b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/InnerMessageScheduler.cs new file mode 100644 index 0000000..b1b55f6 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/InnerMessageScheduler.cs @@ -0,0 +1,211 @@ +#if FANTASY_NET +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +using System.Runtime.CompilerServices; +using Fantasy.Async; +using Fantasy.Network; +using Fantasy.Network.Interface; +using Fantasy.PacketParser; +using Fantasy.PacketParser.Interface; +#pragma warning disable CS8604 // Possible null reference argument. + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace Fantasy.Scheduler +{ + /// + /// 提供了一个机制来调度和处理内部网络消息。 + /// + internal sealed class InnerMessageScheduler(Scene scene) : ANetworkMessageScheduler(scene) + { + public override async FTask Scheduler(Session session, APackInfo packInfo) + { + var protocol = packInfo.OpCodeIdStruct.Protocol; + + switch (protocol) + { + case OpCodeType.InnerMessage: + case OpCodeType.InnerRequest: + { + var messageType = MessageDispatcherComponent.GetOpCodeType(packInfo.ProtocolCode); + + try + { + if (messageType == null) + { + throw new Exception($"可能遭受到恶意发包或没有协议定义ProtocolCode ProtocolCode：{packInfo.ProtocolCode}"); + } + + var message = packInfo.Deserialize(messageType); + MessageDispatcherComponent.MessageHandler(session, messageType, message, packInfo.RpcId, packInfo.ProtocolCode); + } + catch (Exception e) + { + Log.Error($"ANetworkMessageScheduler OuterResponse error messageProtocolCode:{packInfo.ProtocolCode} messageType:{messageType} SessionId {session.Id} IsDispose {session.IsDisposed} {e}"); + } + finally + { + packInfo.Dispose(); + } + + return; + } + case OpCodeType.InnerResponse: + case OpCodeType.InnerRouteResponse: + case OpCodeType.InnerAddressableResponse: + case OpCodeType.InnerRoamingResponse: + case OpCodeType.OuterAddressableResponse: + case OpCodeType.OuterCustomRouteResponse: + case OpCodeType.OuterRoamingResponse: + { + using (packInfo) + { + var messageType = MessageDispatcherComponent.GetOpCodeType(packInfo.ProtocolCode); + + if (messageType == null) + { + throw new Exception($"可能遭受到恶意发包或没有协议定义ProtocolCode ProtocolCode：{packInfo.ProtocolCode}"); + } + + NetworkMessagingComponent.ResponseHandler(packInfo.RpcId, (IResponse)packInfo.Deserialize(messageType)); + } + + return; + } + case OpCodeType.InnerRouteMessage: + case OpCodeType.InnerAddressableMessage: + case OpCodeType.InnerRoamingMessage: + { + using (packInfo) + { + var messageType = MessageDispatcherComponent.GetOpCodeType(packInfo.ProtocolCode); + + if (messageType == null) + { + throw new Exception($"InnerMessageScheduler error 可能遭受到恶意发包或没有协议定义ProtocolCode ProtocolCode：{packInfo.ProtocolCode}"); + } + + if (!Scene.TryGetEntity(packInfo.RouteId, out var entity)) + { + Scene.MessageDispatcherComponent.FailRouteResponse(session, messageType, InnerErrorCode.ErrNotFoundRoute, packInfo.RpcId); + return; + } + + var obj = packInfo.Deserialize(messageType); + await Scene.MessageDispatcherComponent.RouteMessageHandler(session, messageType, entity, (IMessage)obj, packInfo.RpcId); + } + + return; + } + case OpCodeType.InnerRouteRequest: + case OpCodeType.InnerAddressableRequest: + case OpCodeType.InnerRoamingRequest: + { + using (packInfo) + { + var messageType = MessageDispatcherComponent.GetOpCodeType(packInfo.ProtocolCode); + + if (messageType == null) + { + throw new Exception($"InnerMessageScheduler error 可能遭受到恶意发包或没有协议定义ProtocolCode ProtocolCode：{packInfo.ProtocolCode}"); + } + + if (!Scene.TryGetEntity(packInfo.RouteId, out var entity)) + { + Scene.MessageDispatcherComponent.FailRouteResponse(session, messageType, InnerErrorCode.ErrNotFoundRoute, packInfo.RpcId); + return; + } + + var obj = packInfo.Deserialize(messageType); + await Scene.MessageDispatcherComponent.RouteMessageHandler(session, messageType, entity, (IMessage)obj, packInfo.RpcId); + } + + return; + } + case OpCodeType.OuterCustomRouteRequest: + case OpCodeType.OuterAddressableRequest: + case OpCodeType.OuterAddressableMessage: + case OpCodeType.OuterCustomRouteMessage: + case OpCodeType.OuterRoamingMessage: + case OpCodeType.OuterRoamingRequest: + { + var entity = Scene.GetEntity(packInfo.RouteId); + + switch (entity) + { + case null: + { + // 执行到这里有两种情况: + using (packInfo) + { + switch (Scene.SceneConfig.SceneTypeString) + { + case "Gate": + { + // 1、当前是Gate进行，需要转发消息给客户端，但当前这个Session已经断开了。 + // 这种情况不需要做任何处理。 + return; + } + default: + { + // 2、当前是其他Scene、消息通过Gate发送到这个Scene上面，但这个Scene上面没有这个Entity。 + // 因为这个是Gate转发消息到这个Scene的，如果没有找到Entity要返回错误给Gate。 + // 出现这个情况一定要打印日志，因为出现这个问题肯定是上层逻辑导致的，不应该出现这样的问题。 + var packInfoRouteId = packInfo.RouteId; + var messageType = MessageDispatcherComponent.GetOpCodeType(packInfo.ProtocolCode); + + switch (protocol) + { + case OpCodeType.OuterCustomRouteRequest: + case OpCodeType.OuterAddressableRequest: + case OpCodeType.OuterAddressableMessage: + { + Scene.MessageDispatcherComponent.FailRouteResponse(session, messageType, InnerErrorCode.ErrNotFoundRoute, packInfo.RpcId); + return; + } + } + + throw new Exception($"The Entity associated with RouteId = {packInfoRouteId} was not found! messageType = {messageType.FullName} protocol = {protocol}"); + } + } + } + } + case Session gateSession: + { + using (packInfo) + { + // 这里如果是Session只可能是Gate的Session、如果是的话、肯定是转发消息 + gateSession.Send(packInfo.MemoryStream, packInfo.RpcId); + } + + return; + } + default: + { + using (packInfo) + { + var messageType = MessageDispatcherComponent.GetOpCodeType(packInfo.ProtocolCode); + + if (messageType == null) + { + throw new Exception($"InnerMessageScheduler error 可能遭受到恶意发包或没有协议定义ProtocolCode ProtocolCode：{packInfo.ProtocolCode}"); + } + + var obj = packInfo.Deserialize(messageType); + await Scene.MessageDispatcherComponent.RouteMessageHandler(session, messageType, entity, (IMessage)obj, packInfo.RpcId); + } + + return; + } + } + } + default: + { + var infoProtocolCode = packInfo.ProtocolCode; + packInfo.Dispose(); + throw new NotSupportedException($"InnerMessageScheduler Received unsupported message protocolCode:{infoProtocolCode}"); + } + } + } + } +} +#endif + diff --git a/FantasyNetTest/NBC/Core/Network/Message/Scheduler/Interface/ANetworkMessageScheduler.cs b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/Interface/ANetworkMessageScheduler.cs new file mode 100644 index 0000000..db2c342 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/Interface/ANetworkMessageScheduler.cs @@ -0,0 +1,31 @@ +using System; +using System.IO; +using NBC.Async; +using NBC.Network; +using NBC.Network.Interface; +using NBC.PacketParser.Interface; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +// ReSharper disable UnassignedField.Global +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. + +namespace NBC.Scheduler +{ + public abstract class ANetworkMessageScheduler + { + protected readonly Scene Scene; + protected readonly MessageDispatcherComponent MessageDispatcherComponent; +#if FANTASY_NET + protected readonly NetworkMessagingComponent NetworkMessagingComponent; +#endif + protected ANetworkMessageScheduler(Scene scene) + { + Scene = scene; + MessageDispatcherComponent = scene.MessageDispatcherComponent; +#if FANTASY_NET + NetworkMessagingComponent = scene.NetworkMessagingComponent; +#endif + } + public abstract FTask Scheduler(Session session, APackInfo packInfo); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/MessageSender.cs b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/MessageSender.cs new file mode 100644 index 0000000..843fba1 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/MessageSender.cs @@ -0,0 +1,107 @@ +using System; +using NBC.Async; +using NBC.Helper; +using NBC.Network.Interface; + +#pragma warning disable CS8625 +#pragma warning disable CS8618 + +namespace NBC.Scheduler +{ + /// + /// 网络消息发送者的类。 + /// + public struct MessageSender : IDisposable + { + /// + /// 获取或设置 RPC ID。 + /// + public uint RpcId { get; private set; } + /// + /// 获取或设置路由 ID。 + /// + public long RouteId { get; private set; } + /// + /// 获取或设置创建时间。 + /// + public long CreateTime { get; private set; } + /// + /// 获取或设置消息类型。 + /// + public Type MessageType { get; private set; } + /// + /// 获取或设置请求消息。 + /// + public IMessage Request { get; private set; } + /// + /// 获取或设置任务。 + /// + public FTask Tcs { get; private set; } + + /// + /// 释放资源。 + /// + public void Dispose() + { + RpcId = 0; + RouteId = 0; + CreateTime = 0; + Tcs = null; + Request = null; + MessageType = null; + } + + /// + /// 创建一个 实例。 + /// + /// RPC ID。 + /// 请求消息类型。 + /// 任务。 + /// 创建的 实例。 + public static MessageSender Create(uint rpcId, Type requestType, FTask tcs) + { + var routeMessageSender = new MessageSender(); + routeMessageSender.Tcs = tcs; + routeMessageSender.RpcId = rpcId; + routeMessageSender.MessageType = requestType; + routeMessageSender.CreateTime = TimeHelper.Now; + return routeMessageSender; + } + + /// + /// 创建一个 实例。 + /// + /// RPC ID。 + /// 请求消息。 + /// 任务。 + /// 创建的 实例。 + public static MessageSender Create(uint rpcId, IRequest request, FTask tcs) + { + var routeMessageSender = new MessageSender(); + routeMessageSender.Tcs = tcs; + routeMessageSender.RpcId = rpcId; + routeMessageSender.Request = request; + routeMessageSender.CreateTime = TimeHelper.Now; + return routeMessageSender; + } + + /// + /// 创建一个 实例。 + /// + /// RPC ID。 + /// 路由 ID。 + /// 路由消息请求。 + /// 任务。 + /// 创建的 实例。 + public static MessageSender Create(uint rpcId, long routeId, IRouteMessage request, FTask tcs) + { + var routeMessageSender = new MessageSender(); + routeMessageSender.Tcs = tcs; + routeMessageSender.RpcId = rpcId; + routeMessageSender.RouteId = routeId; + routeMessageSender.Request = request; + routeMessageSender.CreateTime = TimeHelper.Now; + return routeMessageSender; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/NetworkMessagingComponent.cs b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/NetworkMessagingComponent.cs new file mode 100644 index 0000000..7580dd9 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/NetworkMessagingComponent.cs @@ -0,0 +1,273 @@ +#if FANTASY_NET +using Fantasy.Entitas; +using System.Runtime.CompilerServices; +using Fantasy.Async; +using Fantasy.Entitas.Interface; +using Fantasy.Helper; +using Fantasy.Network; +using Fantasy.Network.Interface; +using Fantasy.Network.Route; +using Fantasy.PacketParser; +using Fantasy.PacketParser.Interface; +using Fantasy.Timer; +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8603 // Possible null reference return. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace Fantasy.Scheduler +{ + public struct NetworkMessageUpdate + { + public NetworkMessagingComponent NetworkMessagingComponent; + } + + public class NetworkMessagingComponentAwakeSystem : AwakeSystem + { + protected override void Awake(NetworkMessagingComponent self) + { + var selfScene = self.Scene; + self.TimerComponent = selfScene.TimerComponent; + self.MessageDispatcherComponent = selfScene.MessageDispatcherComponent; + self.AddressableRouteMessageLock = selfScene.CoroutineLockComponent.Create(self.GetType().TypeHandle.Value.ToInt64()); + + self.TimerId = self.TimerComponent.Net.RepeatedTimer(10000, new NetworkMessageUpdate() + { + NetworkMessagingComponent = self + }); + } + } + + public class NetworkMessagingComponentDestroySystem : DestroySystem + { + protected override void Destroy(NetworkMessagingComponent self) + { + if (self.TimerId != 0) + { + self.TimerComponent.Net.Remove(ref self.TimerId); + } + + foreach (var (rpcId, messageSender) in self.RequestCallback.ToDictionary()) + { + self.ReturnMessageSender(rpcId, messageSender); + } + + self.AddressableRouteMessageLock.Dispose(); + + self.RequestCallback.Clear(); + self.TimeoutRouteMessageSenders.Clear(); + self.TimerComponent = null; + self.MessageDispatcherComponent = null; + self.AddressableRouteMessageLock = null; + } + } + public sealed class NetworkMessagingComponent : Entity + { + public long TimerId; + private uint _rpcId; + public CoroutineLock AddressableRouteMessageLock; + public TimerComponent TimerComponent; + public MessageDispatcherComponent MessageDispatcherComponent; + public readonly SortedDictionary RequestCallback = new(); + public readonly Dictionary TimeoutRouteMessageSenders = new(); + + public void SendInnerRoute(long routeId, IRouteMessage message) + { + if (routeId == 0) + { + Log.Error($"SendInnerRoute appId == 0"); + return; + } + + Scene.GetSession(routeId).Send(message, 0, routeId); + } + + internal void SendInnerRoute(long routeId, Type messageType, APackInfo packInfo) + { + if (routeId == 0) + { + Log.Error($"SendInnerRoute routeId == 0"); + return; + } + + Scene.GetSession(routeId).Send(0, routeId, messageType, packInfo); + } + + public void SendInnerRoute(ICollection routeIdCollection, IRouteMessage message) + { + if (routeIdCollection.Count <= 0) + { + Log.Error("SendInnerRoute routeIdCollection.Count <= 0"); + return; + } + + using var processPackInfo = ProcessPackInfo.Create(Scene, message, routeIdCollection.Count); + foreach (var routeId in routeIdCollection) + { + processPackInfo.Set(0, routeId); + Scene.GetSession(routeId).Send(processPackInfo, 0, routeId); + } + } + + public async FTask SendAddressable(long addressableId, IRouteMessage message) + { + await CallAddressable(addressableId, message); + } + + internal async FTask CallInnerRoute(long routeId, Type requestType, APackInfo packInfo) + { + if (routeId == 0) + { + Log.Error($"CallInnerRoute routeId == 0"); + return null; + } + + var rpcId = ++_rpcId; + var session = Scene.GetSession(routeId); + var requestCallback = FTask.Create(false); + RequestCallback.Add(rpcId, MessageSender.Create(rpcId, requestType, requestCallback)); + session.Send(rpcId, routeId, requestType, packInfo); + return await requestCallback; + } + + public async FTask CallInnerRouteBySession(Session session, long routeId, IRouteMessage request) + { + var rpcId = ++_rpcId; + var requestCallback = FTask.Create(false); + RequestCallback.Add(rpcId, MessageSender.Create(rpcId, request, requestCallback)); + session.Send(request, rpcId, routeId); + return await requestCallback; + } + + public async FTask CallInnerRoute(long routeId, IRouteMessage request) + { + if (routeId == 0) + { + Log.Error($"CallInnerRoute routeId == 0"); + return null; + } + + var rpcId = ++_rpcId; + var session = Scene.GetSession(routeId); + var requestCallback = FTask.Create(false); + RequestCallback.Add(rpcId, MessageSender.Create(rpcId, request, requestCallback)); + session.Send(request, rpcId, routeId); + return await requestCallback; + } + + public async FTask CallAddressable(long addressableId, IRouteMessage request) + { + var failCount = 0; + + using (await AddressableRouteMessageLock.Wait(addressableId, "CallAddressable")) + { + var addressableRouteId = await AddressableHelper.GetAddressableRouteId(Scene, addressableId); + + while (true) + { + if (addressableRouteId == 0) + { + addressableRouteId = await AddressableHelper.GetAddressableRouteId(Scene, addressableId); + } + + if (addressableRouteId == 0) + { + return MessageDispatcherComponent.CreateResponse(request.GetType(), InnerErrorCode.ErrNotFoundRoute); + } + + var iRouteResponse = await CallInnerRoute(addressableRouteId, request); + + switch (iRouteResponse.ErrorCode) + { + case InnerErrorCode.ErrNotFoundRoute: + { + if (++failCount > 20) + { + Log.Error($"AddressableComponent.Call failCount > 20 route send message fail, routeId: {addressableRouteId} AddressableMessageComponent:{addressableId}"); + return iRouteResponse; + } + + await TimerComponent.Net.WaitAsync(500); + addressableRouteId = 0; + continue; + } + case InnerErrorCode.ErrRouteTimeout: + { + Log.Error($"CallAddressableRoute ErrorCode.ErrRouteTimeout Error:{iRouteResponse.ErrorCode} Message:{request}"); + return iRouteResponse; + } + default: + { + return iRouteResponse; + } + } + } + } + } + + public void ResponseHandler(uint rpcId, IResponse response) + { + if (!RequestCallback.Remove(rpcId, out var routeMessageSender)) + { + throw new Exception($"not found rpc, response.RpcId:{rpcId} response message: {response.GetType().Name} Process:{Scene.Process.Id} Scene:{Scene.SceneConfigId}"); + } + + ResponseHandler(routeMessageSender, response); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private static void ResponseHandler(MessageSender messageSender, IResponse response) + { + if (response.ErrorCode == InnerErrorCode.ErrRouteTimeout) + { +#if FANTASY_DEVELOP + messageSender.Tcs.SetException(new Exception($"Rpc error: request, 注意RouteId消息超时，请注意查看是否死锁或者没有reply: RouteId: {messageSender.RouteId} {messageSender.Request.ToJson()}, response: {response}")); +#else + messageSender.Tcs.SetException(new Exception($"Rpc error: request, 注意RouteId消息超时，请注意查看是否死锁或者没有reply: RouteId: {messageSender.RouteId} {messageSender.Request}, response: {response}")); +#endif + messageSender.Dispose(); + return; + } + + messageSender.Tcs.SetResult(response); + messageSender.Dispose(); + } + + public void ReturnMessageSender(uint rpcId, MessageSender messageSender) + { + try + { + switch (messageSender.Request) + { + case IRouteMessage iRouteMessage: + { + // IRouteMessage是个特殊的RPC协议、这里不处理就可以了。 + break; + } + case IRequest iRequest: + { + var response = MessageDispatcherComponent.CreateResponse(iRequest.GetType(), InnerErrorCode.ErrRpcFail); + var responseRpcId = messageSender.RpcId; + ResponseHandler(responseRpcId, response); + Log.Warning($"timeout rpcId:{rpcId} responseRpcId:{responseRpcId} {iRequest.ToJson()}"); + break; + } + default: + { + Log.Error(messageSender.Request != null + ? $"Unsupported protocol type {messageSender.Request.GetType()} rpcId:{rpcId} messageSender.Request != null" + : $"Unsupported protocol type:{messageSender.MessageType.FullName} rpcId:{rpcId}"); + RequestCallback.Remove(rpcId); + break; + } + } + } + catch (Exception e) + { + Console.WriteLine(e); + throw; + } + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/OnNetworkMessageUpdateCheckTimeout.cs b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/OnNetworkMessageUpdateCheckTimeout.cs new file mode 100644 index 0000000..223ca05 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/MessageHelper/OnNetworkMessageUpdateCheckTimeout.cs @@ -0,0 +1,59 @@ +using NBC.Helper; + +#if FANTASY_NET +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +namespace Fantasy.Scheduler +{ + /// + /// 网络消息更新检查超时。 + /// + public sealed class OnNetworkMessageUpdateCheckTimeout : TimerHandler + { + /// + /// 超时时间（毫秒）。 + /// + private const long Timeout = 40000; + + /// + /// 处理网络消息更新检查超时。 + /// + /// + /// + protected override void Handler(NetworkMessageUpdate self) + { + var timeNow = TimeHelper.Now; + var selfNetworkMessagingComponent = self.NetworkMessagingComponent; + + // 遍历请求回调字典，检查是否有超时的请求，将超时请求添加到超时消息发送列表中。 + + foreach (var (rpcId, value) in selfNetworkMessagingComponent.RequestCallback) + { + if (timeNow < value.CreateTime + Timeout) + { + break; + } + + selfNetworkMessagingComponent.TimeoutRouteMessageSenders.Add(rpcId, value); + } + + // 如果没有超时的请求，直接返回。 + + if (selfNetworkMessagingComponent.TimeoutRouteMessageSenders.Count == 0) + { + return; + } + + // 处理超时的请求，根据请求类型生成相应的响应消息，并进行处理。 + + foreach (var (rpcId, routeMessageSender) in selfNetworkMessagingComponent.TimeoutRouteMessageSenders) + { + selfNetworkMessagingComponent.ReturnMessageSender(rpcId, routeMessageSender); + } + + // 清空超时消息发送列表。 + + selfNetworkMessagingComponent.TimeoutRouteMessageSenders.Clear(); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Message/Scheduler/OuterMessageScheduler.cs b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/OuterMessageScheduler.cs new file mode 100644 index 0000000..5b966f9 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Message/Scheduler/OuterMessageScheduler.cs @@ -0,0 +1,38 @@ +using System; +using NBC.Async; +using NBC.Network; +using NBC.PacketParser.Interface; +#if FANTASY_NET +using System.Text; +using Fantasy.Network.Interface; +using Fantasy.Network.Route; +using Fantasy.PacketParser; +using Fantasy.Helper; +using Fantasy.InnerMessage; +using Fantasy.Roaming; +#endif + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract + +namespace NBC.Scheduler +{ + /// + /// 提供了一个机制来调度和处理外部网络消息。 + /// + public sealed class OuterMessageScheduler : ANetworkMessageScheduler + { + public OuterMessageScheduler(Scene scene) : base(scene) { } + + /// + /// 在Unity环境下，处理外部消息的方法。 + /// + /// 网络会话。 + /// 消息封包信息。 + public override FTask Scheduler(Session session, APackInfo packInfo) + { + throw new NotSupportedException($"Received unsupported message protocolCode:{packInfo.ProtocolCode}"); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/Exception/ScanException.cs b/FantasyNetTest/NBC/Core/Network/Protocol/Exception/ScanException.cs new file mode 100644 index 0000000..77ba2f2 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/Exception/ScanException.cs @@ -0,0 +1,21 @@ +using System; + +namespace NBC.Network +{ + /// + /// 在扫描过程中发生的异常。 + /// + public class ScanException : Exception + { + /// + /// 初始化 类的新实例。 + /// + public ScanException() { } + + /// + /// 使用指定的错误消息初始化 类的新实例。 + /// + /// 错误消息。 + public ScanException(string msg) : base(msg) { } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/HTTP/HTTPServerNetwork.cs b/FantasyNetTest/NBC/Core/Network/Protocol/HTTP/HTTPServerNetwork.cs new file mode 100644 index 0000000..9ca4eba --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/HTTP/HTTPServerNetwork.cs @@ -0,0 +1,128 @@ +#if FANTASY_NET +using System.IO; +using System.Net; +using System.Security.Cryptography.X509Certificates; +using System.Text; +using Fantasy.Assembly; +using Fantasy.Async; +using Fantasy.Network.Interface; +using Microsoft.AspNetCore.Builder; +using Microsoft.AspNetCore.Hosting; +using Microsoft.AspNetCore.Server.Kestrel.Core; +using Microsoft.Extensions.DependencyInjection; +using Microsoft.Extensions.Hosting; +using Microsoft.Extensions.Logging; + +#pragma warning disable CS8604 // Possible null reference argument. + +// ReSharper disable PossibleMultipleEnumeration + +namespace Fantasy.Network.HTTP +{ + /// + /// HTTP服务器 + /// + public sealed class HTTPServerNetwork : ANetwork + { + /// + /// 初始化入口 + /// + /// + /// + /// + public void Initialize(NetworkTarget networkTarget, string bindIp, int port) + { + base.Initialize(NetworkType.Server, NetworkProtocolType.HTTP, networkTarget); + + try + { + StartAsync(bindIp, port); + } + catch (HttpListenerException e) + { + if (e.ErrorCode == 5) + { + var sb = new StringBuilder(); + sb.AppendLine("CMD管理员中输入下面其中一个命令，具体根据您是HTTPS或HTTP决定:"); + sb.AppendLine($"HTTP请输入如下:netsh http add urlacl url=http://{bindIp}:{port}/ user=Everyone"); + sb.AppendLine($"HTTPS请输入如下:netsh http add urlacl url=https://{bindIp}:{port}/ user=Everyone"); + throw new Exception(sb.ToString(), e); + } + + Log.Error(e); + } + catch (Exception e) + { + Log.Error(e); + } + } + + private void StartAsync(string bindIp, int port) + { + var builder = WebApplication.CreateBuilder(); + // 配置日志级别为 Warning 或更高 + builder.Logging.ClearProviders(); + builder.Logging.AddConsole(); + builder.Logging.SetMinimumLevel(LogLevel.Warning); + // 将Scene注册到 DI 容器中，传递给控制器 + builder.Services.AddSingleton(Scene); + // 注册Scene同步过滤器 + builder.Services.AddScoped(); + // 注册控制器服务 + var addControllers = builder.Services.AddControllers() + .AddJsonOptions(options => { options.JsonSerializerOptions.PropertyNamingPolicy = null; }); + foreach (var assembly in AssemblySystem.ForEachAssembly) + { + addControllers.AddApplicationPart(assembly); + } + var listenUrl = ""; + var app = builder.Build(); + // 检测当前路径下是否有证书文件 + var certificatePath = Path.Combine(AppContext.BaseDirectory, $"certificate{bindIp}{port}"); + if (Directory.Exists(certificatePath)) + { + // 加载包含证书链的 PEM 文件 + var pemCertChain = File.ReadAllText(Path.Combine(certificatePath, "chain.pem")); + var pemPrivateKey = File.ReadAllText(Path.Combine(certificatePath, "private-key.pem")); + // 配置 HTTPS 监听并使用证书 + builder.WebHost.ConfigureKestrel(kestrelServerOptions => + { + kestrelServerOptions.ConfigureHttpsDefaults(https => + { + https.ServerCertificate = X509Certificate2.CreateFromPem(pemCertChain, pemPrivateKey); + }); + }); + listenUrl = $"https://{bindIp}:{port}/"; + app.Urls.Add(listenUrl); + app.UseHttpsRedirection(); + } + else + { + // 不安全的HTTP地址 + listenUrl = $"http://{bindIp}:{port}/"; + app.Urls.Add(listenUrl); + } + // 启用开发者工具 + if (app.Environment.IsDevelopment()) + { + app.UseDeveloperExceptionPage(); + } + // 路由注册 + app.MapControllers(); + // 开启监听 + app.RunAsync(); + Log.Info($"SceneConfigId = {Scene.SceneConfigId} HTTPServer Listen {listenUrl}"); + } + + /// + /// 移除Channel + /// + /// + /// + public override void RemoveChannel(uint channelId) + { + throw new NotImplementedException(); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/HTTP/SceneContextFilter.cs b/FantasyNetTest/NBC/Core/Network/Protocol/HTTP/SceneContextFilter.cs new file mode 100644 index 0000000..2688bdc --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/HTTP/SceneContextFilter.cs @@ -0,0 +1,54 @@ +#if FANTASY_NET +using Fantasy.Async; +using Microsoft.AspNetCore.Mvc.Filters; + +namespace Fantasy.Network.HTTP; + +/// +/// 让所有实现SceneContextFilter的控制器，都在执行的Scene下执行 +/// +public sealed class SceneContextFilter : IAsyncActionFilter +{ + private readonly Scene _scene; + + /// + /// 构造函数 + /// + /// + public SceneContextFilter(Scene scene) + { + _scene = scene; + } + + /// + /// OnActionExecutionAsync + /// + /// + /// + /// + public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next) + { + var tcs = FTask.Create(); + + _scene.ThreadSynchronizationContext.Post(() => + { + Action().Coroutine(); + }); + + await tcs; + return; + + async FTask Action() + { + try + { + await next(); + } + finally + { + tcs.SetResult(); + } + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/Interface/AClientNetwork.cs b/FantasyNetTest/NBC/Core/Network/Protocol/Interface/AClientNetwork.cs new file mode 100644 index 0000000..23c9817 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/Interface/AClientNetwork.cs @@ -0,0 +1,38 @@ +using System; +using System.IO; +using NBC.Serialize; + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.Network.Interface +{ + /// + /// 抽象客户端网络基类。 + /// + public abstract class AClientNetwork : ANetwork, INetworkChannel + { + protected bool IsInit; + public Session Session { get; protected set; } + public abstract Session Connect(string remoteAddress, Action onConnectComplete, Action onConnectFail, Action onConnectDisconnect, bool isHttps, int connectTimeout = 5000); + public abstract void Send(uint rpcId, long routeId, MemoryStreamBuffer memoryStream, IMessage message); + public override void Dispose() + { + IsInit = false; + + if (Session != null) + { + if (!Session.IsDisposed) + { + Session.Dispose(); + } + + Session = null; + } + + base.Dispose(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/Interface/ANetwork.cs b/FantasyNetTest/NBC/Core/Network/Protocol/Interface/ANetwork.cs new file mode 100644 index 0000000..2043bab --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/Interface/ANetwork.cs @@ -0,0 +1,149 @@ +using System; +using System.Collections.Concurrent; +using System.Collections.Generic; +using System.IO; +using NBC.Serialize; +using NBC.Entitas; +using NBC.PacketParser; +using NBC.Scheduler; + +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.Network.Interface +{ + /// + /// 抽象网络基类。 + /// + public abstract class ANetwork : Entity + { + private long _outerPackInfoId; + private Queue _outerPackInfoPool; + public readonly MemoryStreamBufferPool MemoryStreamBufferPool = new MemoryStreamBufferPool(); + + public NetworkType NetworkType { get; private set; } + public NetworkTarget NetworkTarget { get; private set; } + public NetworkProtocolType NetworkProtocolType { get; private set; } + public ANetworkMessageScheduler NetworkMessageScheduler { get; private set; } + + protected void Initialize(NetworkType networkType, NetworkProtocolType networkProtocolType, NetworkTarget networkTarget) + { + NetworkType = networkType; + NetworkTarget = networkTarget; + NetworkProtocolType = networkProtocolType; +#if FANTASY_NET + if (networkProtocolType == NetworkProtocolType.HTTP) + { + return; + } + if (networkTarget == NetworkTarget.Inner) + { + _innerPackInfoPool = new Queue(); + NetworkMessageScheduler = new InnerMessageScheduler(Scene); + return; + } +#endif + switch (networkType) + { + case NetworkType.Client: + { + _outerPackInfoPool = new Queue(); + NetworkMessageScheduler = new ClientMessageScheduler(Scene); + break; + } +#if FANTASY_NET + case NetworkType.Server: + { + _outerPackInfoPool = new Queue(); + NetworkMessageScheduler = new OuterMessageScheduler(Scene); + break; + } +#endif + } + } + + public abstract void RemoveChannel(uint channelId); + public OuterPackInfo RentOuterPackInfo() + { + if (_outerPackInfoPool.Count == 0) + { + return new OuterPackInfo() + { + PackInfoId = ++_outerPackInfoId + }; + } + + if (!_outerPackInfoPool.TryDequeue(out var outerPackInfo)) + { + return new OuterPackInfo() + { + PackInfoId = ++_outerPackInfoId + }; + } + + outerPackInfo.PackInfoId = ++_outerPackInfoId; + return outerPackInfo; + } + + public void ReturnOuterPackInfo(OuterPackInfo outerPackInfo) + { + if (_outerPackInfoPool.Count > 512) + { + // 池子里最多缓存256个、其实这样设置有点多了、其实用不了512个。 + // 反而设置越大内存会占用越多。 + return; + } + + _outerPackInfoPool.Enqueue(outerPackInfo); + } +#if FANTASY_NET + private long _innerPackInfoId; + private Queue _innerPackInfoPool; + public InnerPackInfo RentInnerPackInfo() + { + if (_innerPackInfoPool.Count == 0) + { + return new InnerPackInfo() + { + PackInfoId = ++_innerPackInfoId + }; + } + + if (!_innerPackInfoPool.TryDequeue(out var innerPackInfo)) + { + return new InnerPackInfo() + { + PackInfoId = ++_innerPackInfoId + }; + } + + innerPackInfo.PackInfoId = ++_innerPackInfoId; + return innerPackInfo; + } + + public void ReturnInnerPackInfo(InnerPackInfo innerPackInfo) + { + if (_innerPackInfoPool.Count > 256) + { + // 池子里最多缓存256个、其实这样设置有点多了、其实用不了256个。 + // 反而设置越大内存会占用越多。 + return; + } + + _innerPackInfoPool.Enqueue(innerPackInfo); + } +#endif + public override void Dispose() + { + NetworkType = NetworkType.None; + NetworkTarget = NetworkTarget.None; + NetworkProtocolType = NetworkProtocolType.None; + MemoryStreamBufferPool.Dispose(); + _outerPackInfoPool?.Clear(); +#if FANTASY_NET + _innerPackInfoPool?.Clear(); +#endif + base.Dispose(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/Interface/ANetworkServerChannel.cs b/FantasyNetTest/NBC/Core/Network/Protocol/Interface/ANetworkServerChannel.cs new file mode 100644 index 0000000..788a235 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/Interface/ANetworkServerChannel.cs @@ -0,0 +1,55 @@ +#if FANTASY_NET +using System.IO; +using System.Net; +using Fantasy.Serialize; + +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace Fantasy.Network.Interface +{ + public abstract class ANetworkServerChannel : INetworkChannel + { + /// + /// 获取通道的唯一标识 ID。 + /// + public readonly uint Id; + /// + /// 获取通道的远程终端点。 + /// + public readonly EndPoint RemoteEndPoint; + /// + /// 获取或设置通道所属的场景。 + /// + public Scene Scene { get; protected set; } + /// + /// 获取或设置通道所属的会话。 + /// + public Session Session { get; protected set; } + /// + /// 获取通道是否已经被释放。 + /// + public bool IsDisposed { get; protected set; } + + protected ANetworkServerChannel(ANetwork network, uint id, EndPoint remoteEndPoint) + { + Id = id; + Scene = network.Scene; + RemoteEndPoint = remoteEndPoint; + Session = Session.Create(network.NetworkMessageScheduler, this, network.NetworkTarget); + } + + public virtual void Dispose() + { + IsDisposed = true; + + if (!Session.IsDisposed) + { + Session.Dispose(); + } + } + + public abstract void Send(uint rpcId, long routeId, MemoryStreamBuffer memoryStream, IMessage message); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/Interface/INetworkChannel.cs b/FantasyNetTest/NBC/Core/Network/Protocol/Interface/INetworkChannel.cs new file mode 100644 index 0000000..b0f9a2e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/Interface/INetworkChannel.cs @@ -0,0 +1,14 @@ +using System; +using System.IO; +using NBC.Serialize; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace NBC.Network.Interface +{ + public interface INetworkChannel : IDisposable + { + public Session Session { get;} + public bool IsDisposed { get;} + public void Send(uint rpcId, long routeId, MemoryStreamBuffer memoryStream, IMessage message); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/Kcp.cs b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/Kcp.cs new file mode 100644 index 0000000..aa1947d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/Kcp.cs @@ -0,0 +1,451 @@ +using System; +using System.Runtime.InteropServices; +using System.Threading; +using kcp; +using static kcp.KCP; + +#pragma warning disable CS8601 +#pragma warning disable CS8602 +#pragma warning disable CS8625 + +// ReSharper disable ALL + +namespace KCP +{ + /// + /// Kcp callback + /// + /// KCP output destination + /// KCP output size (excluding reserved) + public delegate void KcpCallback(byte[] buffer, int length); + + /// + /// Kcp + /// + public sealed unsafe class Kcp : IDisposable + { + /// + /// Kcp + /// + private IKCPCB* _kcp; + + /// + /// Output function + /// + private KcpCallback _output; + + /// + /// Buffer + /// + private byte[] _buffer; + + /// + /// Reserved overhead + /// + private int _reserved; + + /// + /// Disposed + /// + private int _disposed; + + /// + /// Structure + /// + /// ConversationId + /// Output + /// Reserved overhead + public Kcp(uint conv, KcpCallback output, int reserved) + { + _kcp = ikcp_create(conv, reserved, ref _buffer); + _output = output; + _reserved = reserved; + } + + /// + /// Set + /// + public bool IsSet => _kcp != null; + + /// + /// Conversation id + /// + public uint ConversationId => _kcp->conv; + + /// + /// Maximum transmission unit + /// + public uint MaximumTransmissionUnit => _kcp->mtu; + + /// + /// Maximum segment size + /// + public uint MaximumSegmentSize => _kcp->mss; + + /// + /// Connection state + /// + public uint State => _kcp->state; + + /// + /// The sequence number of the first unacknowledged packet + /// + public uint SendUna => _kcp->snd_una; + + /// + /// The sequence number for the next packet to be sent + /// + public uint SendNext => _kcp->snd_nxt; + + /// + /// The sequence number for the next packet expected to be received + /// + public uint ReceiveNext => _kcp->rcv_nxt; + + /// + /// Slow start threshold for congestion control + /// + public uint SlowStartThreshold => _kcp->ssthresh; + + /// + /// Round-trip time variance + /// + public int RxRttval => _kcp->rx_rttval; + + /// + /// Smoothed round-trip time + /// + public int RxSrtt => _kcp->rx_srtt; + + /// + /// Retransmission timeout + /// + public int RxRto => _kcp->rx_rto; + + /// + /// Minimum retransmission timeout + /// + public int RxMinrto => _kcp->rx_minrto; + + /// + /// Send window size + /// + public uint SendWindowSize => _kcp->snd_wnd; + + /// + /// Receive window size + /// + public uint ReceiveWindowSize => _kcp->rcv_wnd; + + /// + /// Remote window size + /// + public uint RemoteWindowSize => _kcp->rmt_wnd; + + /// + /// Congestion window size + /// + public uint CongestionWindowSize => _kcp->cwnd; + + /// + /// Probe variable for fast recovery + /// + public uint Probe => _kcp->probe; + + /// + /// Current timestamp + /// + public uint Current => _kcp->current; + + /// + /// Flush interval + /// + public uint Interval => _kcp->interval; + + /// + /// Timestamp for the next flush + /// + public uint TimestampFlush => _kcp->ts_flush; + + /// + /// Number of retransmissions + /// + public uint Transmissions => _kcp->xmit; + + /// + /// Number of packets in the receive buffer + /// + public uint ReceiveBufferCount => _kcp->nrcv_buf; + + /// + /// Number of packets in the receive queue + /// + public uint ReceiveQueueCount => _kcp->nrcv_que; + + /// + /// Number of packets wait to receive + /// + public uint WaitReceiveCount => _kcp->nrcv_buf + _kcp->nrcv_que; + + /// + /// Number of packets in the send buffer + /// + public uint SendBufferCount => _kcp->nsnd_buf; + + /// + /// Number of packets in the send queue + /// + public uint SendQueueCount => _kcp->nsnd_que; + + /// + /// Number of packets wait to send + /// + public uint WaitSendCount => _kcp->nsnd_buf + _kcp->nsnd_que; + + /// + /// Whether Nagle's algorithm is disabled + /// + public uint NoDelay => _kcp->nodelay; + + /// + /// Whether the KCP connection has been updated + /// + public uint Updated => _kcp->updated; + + /// + /// Timestamp for the next probe + /// + public uint TimestampProbe => _kcp->ts_probe; + + /// + /// Probe wait time + /// + public uint ProbeWait => _kcp->probe_wait; + + /// + /// Incremental increase + /// + public uint Increment => _kcp->incr; + + /// + /// Pointer to the acknowledge list + /// + public uint* AckList => _kcp->acklist; + + /// + /// Count of acknowledges + /// + public uint AckCount => _kcp->ackcount; + + /// + /// Number of acknowledge blocks + /// + public uint AckBlock => _kcp->ackblock; + + /// + /// Buffer + /// + public byte[] Buffer => _buffer; + + /// + /// Fast resend trigger count + /// + public int FastResend => _kcp->fastresend; + + /// + /// Fast resend limit + /// + public int FastResendLimit => _kcp->fastlimit; + + /// + /// Whether congestion control is disabled + /// + public int NoCongestionWindow => _kcp->nocwnd; + + /// + /// Whether stream mode is enabled + /// + public int StreamMode => _kcp->stream; + + /// + /// Output function pointer + /// + public KcpCallback Output => _output; + + /// + /// Reserved overhead + /// + public int Reserved => _reserved; + + /// + /// Dispose + /// + public void Dispose() + { + if (Interlocked.CompareExchange(ref _disposed, 1, 0) != 0) + return; + ikcp_release(_kcp); + _kcp = null; + _output = null; + _buffer = null; + GC.SuppressFinalize(this); + } + + /// + /// Set output + /// + /// Output + public void SetOutput(KcpCallback output) => _output = output; + + /// + /// Destructure + /// + ~Kcp() => Dispose(); + + /// + /// Send + /// + /// Buffer + /// Sent bytes + public int Send(ReadOnlySpan buffer) + { + fixed (byte* pinnedBuffer = &MemoryMarshal.GetReference(buffer)) + { + return ikcp_send(_kcp, pinnedBuffer, buffer.Length); + } + } + + /// + /// Send + /// + /// Buffer + /// Length + /// Sent bytes + public int Send(byte* buffer, int length) => ikcp_send(_kcp, buffer, length); + + /// + /// Input + /// + /// Buffer + /// Input bytes + public int Input(ReadOnlySpan buffer) + { + fixed (byte* pinnedBuffer = &MemoryMarshal.GetReference(buffer)) + { + return ikcp_input(_kcp, pinnedBuffer, buffer.Length); + } + } + + /// + /// Input + /// + /// Buffer + /// Length + /// Input bytes + public int Input(byte* buffer, int length) => ikcp_input(_kcp, buffer, length); + + /// + /// Peek size + /// + /// Peeked size + public int PeekSize() => ikcp_peeksize(_kcp); + + /// + /// Receive + /// + /// Buffer + /// Received bytes + public int Receive(Span buffer) + { + fixed (byte* pinnedBuffer = &MemoryMarshal.GetReference(buffer)) + { + return ikcp_recv(_kcp, pinnedBuffer, buffer.Length); + } + } + + /// + /// Receive + /// + /// Buffer + /// Length + /// Received bytes + public int Receive(byte* buffer, int length) => ikcp_recv(_kcp, buffer, length); + + /// + /// Update + /// + /// Timestamp + public void Update(uint current) + { + fixed (byte* ptr = &_buffer[_reserved]) + { + ikcp_update(_kcp, current, ptr, _buffer, _output); + } + } + + /// + /// Check + /// + /// Timestamp + /// Next flush timestamp + public uint Check(uint current) => ikcp_check(_kcp, current); + + /// + /// Flush + /// + public void Flush() + { + fixed (byte* ptr = &_buffer[_reserved]) + { + ikcp_flush(_kcp, ptr, _buffer, _output); + } + } + + /// + /// Set maximum transmission unit + /// + /// Maximum transmission unit + /// Set + public int SetMtu(int mtu) => ikcp_setmtu(_kcp, mtu, _reserved, ref _buffer); + + /// + /// Set flush interval + /// + /// Flush interval + public void SetInterval(int interval) => ikcp_interval(_kcp, interval); + + /// + /// Set no delay + /// + /// Whether Nagle's algorithm is disabled + /// Flush interval + /// Fast resend trigger count + /// No congestion window + public void SetNoDelay(int nodelay, int interval, int resend, int nc) => ikcp_nodelay(_kcp, nodelay, interval, resend, nc); + + /// + /// Set window size + /// + /// Send window size + /// Receive window size + public void SetWindowSize(int sndwnd, int rcvwnd) => ikcp_wndsize(_kcp, sndwnd, rcvwnd); + + /// + /// Set fast resend limit + /// + /// Fast resend limit + public void SetFastResendLimit(int fastlimit) => _kcp->fastlimit = Math.Clamp(fastlimit, 0, 5); + + /// + /// Set whether stream mode is enabled + /// + /// Whether stream mode is enabled + public void SetStreamMode(int stream) => _kcp->stream = stream == 1 ? 1 : 0; + + /// + /// Set minimum retransmission timeout + /// + /// Minimum retransmission timeout + public void SetMinrto(int minrto) => _kcp->rx_minrto = (int)Math.Clamp(minrto, 1, IKCP_RTO_MAX); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/Kcp.cs.meta b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/Kcp.cs.meta new file mode 100644 index 0000000..f114766 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/Kcp.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 1f5d7dd29b23440a1bcddb58b7bd2a14 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c.meta b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c.meta new file mode 100644 index 0000000..67fe514 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 15e32528c3ddb4a78a46565fb0718c20 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c/kcp.cs b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c/kcp.cs new file mode 100644 index 0000000..a202cfd --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c/kcp.cs @@ -0,0 +1,1367 @@ +#if NET6_0_OR_GREATER +using System.Numerics; +#endif +using System.Runtime.CompilerServices; +using KCP; + +#pragma warning disable CA2211 +#pragma warning disable CS1591 +#pragma warning disable CS8602 +#pragma warning disable CS8632 + +// ReSharper disable ALL + +namespace kcp +{ + /// + /// https://github.com/skywind3000/kcp + /// + public static unsafe partial class KCP + { + //===================================================================== + // KCP BASIC + //===================================================================== + public const uint IKCP_RTO_NDL = 30; // no delay min rto + public const uint IKCP_RTO_MIN = 100; // normal min rto + public const uint IKCP_RTO_DEF = 200; + public const uint IKCP_RTO_MAX = 60000; + public const uint IKCP_CMD_PUSH = 81; // cmd: push data + public const uint IKCP_CMD_ACK = 82; // cmd: ack + public const uint IKCP_CMD_WASK = 83; // cmd: window probe (ask) + public const uint IKCP_CMD_WINS = 84; // cmd: window size (tell) + public const uint IKCP_ASK_SEND = 1; // need to send IKCP_CMD_WASK + public const uint IKCP_ASK_TELL = 2; // need to send IKCP_CMD_WINS + public const uint IKCP_WND_SND = 32; + public const uint IKCP_WND_RCV = 128; // must >= max fragment size + public const uint IKCP_MTU_DEF = 1400; + public const uint IKCP_ACK_FAST = 3; + public const uint IKCP_INTERVAL = 100; + public const uint IKCP_OVERHEAD = 24; + public const uint IKCP_DEADLINK = 20; + public const uint IKCP_THRESH_INIT = 2; + public const uint IKCP_THRESH_MIN = 2; + public const uint IKCP_PROBE_INIT = 7000; // 7 secs to probe window size + public const uint IKCP_PROBE_LIMIT = 120000; // up to 120 secs to probe window + public const uint IKCP_FASTACK_LIMIT = 5; // max times to trigger fastack + + //--------------------------------------------------------------------- + // encode / decode + //--------------------------------------------------------------------- + + /* encode 8 bits unsigned int */ + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static byte* ikcp_encode8u(byte* p, byte c) + { + *(byte*)p++ = c; + return p; + } + + /* decode 8 bits unsigned int */ + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static byte* ikcp_decode8u(byte* p, byte* c) + { + *c = *(byte*)p++; + return p; + } + + /* encode 16 bits unsigned int (lsb) */ + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static byte* ikcp_encode16u(byte* p, ushort w) + { +#if IWORDS_BIG_ENDIAN || IWORDS_MUST_ALIGN + *(byte*)(p + 0) = (byte)(w & 255); + *(byte*)(p + 1) = (byte)(w >> 8); +#else + memcpy(p, &w, (nuint)2); +#endif + p += 2; + return p; + } + + /* decode 16 bits unsigned int (lsb) */ + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static byte* ikcp_decode16u(byte* p, ushort* w) + { +#if IWORDS_BIG_ENDIAN || IWORDS_MUST_ALIGN + *w = *(byte*)(p + 1); + *w = (ushort)(*(byte*)(p + 0) + (*w << 8)); +#else + memcpy(w, p, (nuint)2); +#endif + p += 2; + return p; + } + + /* encode 32 bits unsigned int (lsb) */ + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static byte* ikcp_encode32u(byte* p, uint l) + { +#if IWORDS_BIG_ENDIAN || IWORDS_MUST_ALIGN + *(byte*)(p + 0) = (byte)((l >> 0) & 0xff); + *(byte*)(p + 1) = (byte)((l >> 8) & 0xff); + *(byte*)(p + 2) = (byte)((l >> 16) & 0xff); + *(byte*)(p + 3) = (byte)((l >> 24) & 0xff); +#else + memcpy(p, &l, (nuint)4); +#endif + p += 4; + return p; + } + + /* decode 32 bits unsigned int (lsb) */ + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static byte* ikcp_decode32u(byte* p, uint* l) + { +#if IWORDS_BIG_ENDIAN || IWORDS_MUST_ALIGN + *l = *(byte*)(p + 3); + *l = *(byte*)(p + 2) + (*l << 8); + *l = *(byte*)(p + 1) + (*l << 8); + *l = *(byte*)(p + 0) + (*l << 8); +#else + memcpy(l, p, (nuint)4); +#endif + p += 4; + return p; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static uint _imin_(uint a, uint b) + { + return a <= b ? a : b; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static uint _imax_(uint a, uint b) + { + return a >= b ? a : b; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static uint _ibound_(uint lower, uint middle, uint upper) + { + return _imin_(_imax_(lower, middle), upper); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static uint _iceilpow2_(uint x) + { +#if NET6_0_OR_GREATER + return BitOperations.RoundUpToPowerOf2(x); +#else + --x; + x |= x >> 1; + x |= x >> 2; + x |= x >> 4; + x |= x >> 8; + x |= x >> 16; + ++x; + return x; +#endif + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static long _itimediff(uint later, uint earlier) + { + return ((int)(later - earlier)); + } + + //--------------------------------------------------------------------- + // manage segment + //--------------------------------------------------------------------- + public static delegate* managed ikcp_malloc_hook = null; + public static delegate* managed ikcp_free_hook = null; + + // internal malloc + public static void* ikcp_malloc(nuint size) + { + if (ikcp_malloc_hook != null) + return ikcp_malloc_hook(size); + return malloc(size); + } + + // internal free + public static void ikcp_free(void* ptr) + { + if (ikcp_free_hook != null) + { + ikcp_free_hook(ptr); + } + else + { + free(ptr); + } + } + + // redefine allocator + public static void ikcp_allocator(delegate* managed new_malloc, delegate* managed new_free) + { + ikcp_malloc_hook = new_malloc; + ikcp_free_hook = new_free; + } + + // allocate a new kcp segment + public static IKCPSEG* ikcp_segment_new(IKCPCB* kcp, int size) + { + return (IKCPSEG*)ikcp_malloc((nuint)(sizeof(IKCPSEG) + size)); + } + + // delete a segment + public static void ikcp_segment_delete(IKCPCB* kcp, IKCPSEG* seg) + { + ikcp_free(seg); + } + + // output segment + public static void ikcp_output(IKCPCB* kcp, int size, byte[] destination, KcpCallback output) + { + assert(kcp != null); + assert(output != null); + + if (size == 0) return; + output(destination, size); + } + + //--------------------------------------------------------------------- + // create a new kcpcb + //--------------------------------------------------------------------- + public static IKCPCB* ikcp_create(uint conv, int reserved, ref byte[] buffer) + { + IKCPCB* kcp = (IKCPCB*)ikcp_malloc((nuint)sizeof(IKCPCB)); + if (kcp == null) return null; + kcp->conv = conv; + kcp->snd_una = 0; + kcp->snd_nxt = 0; + kcp->rcv_nxt = 0; + kcp->ts_recent = 0; + kcp->ts_lastack = 0; + kcp->ts_probe = 0; + kcp->probe_wait = 0; + kcp->snd_wnd = IKCP_WND_SND; + kcp->rcv_wnd = IKCP_WND_RCV; + kcp->rmt_wnd = IKCP_WND_RCV; + kcp->cwnd = 0; + kcp->incr = 0; + kcp->probe = 0; + kcp->mtu = IKCP_MTU_DEF; + kcp->mss = kcp->mtu - IKCP_OVERHEAD; + kcp->stream = 0; + + buffer = new byte[(reserved + kcp->mtu + IKCP_OVERHEAD) * 3]; + + iqueue_init(&kcp->snd_queue); + iqueue_init(&kcp->rcv_queue); + iqueue_init(&kcp->snd_buf); + iqueue_init(&kcp->rcv_buf); + kcp->nrcv_buf = 0; + kcp->nsnd_buf = 0; + kcp->nrcv_que = 0; + kcp->nsnd_que = 0; + kcp->state = 0; + kcp->acklist = null; + kcp->ackblock = 0; + kcp->ackcount = 0; + kcp->rx_srtt = 0; + kcp->rx_rttval = 0; + kcp->rx_rto = (int)IKCP_RTO_DEF; + kcp->rx_minrto = (int)IKCP_RTO_MIN; + kcp->current = 0; + kcp->interval = IKCP_INTERVAL; + kcp->ts_flush = IKCP_INTERVAL; + kcp->nodelay = 0; + kcp->updated = 0; + kcp->ssthresh = IKCP_THRESH_INIT; + kcp->fastresend = 0; + kcp->fastlimit = (int)IKCP_FASTACK_LIMIT; + kcp->nocwnd = 0; + kcp->xmit = 0; + kcp->dead_link = IKCP_DEADLINK; + + return kcp; + } + + //--------------------------------------------------------------------- + // release a new kcpcb + //--------------------------------------------------------------------- + public static void ikcp_release(IKCPCB* kcp) + { + assert(kcp != null); + if (kcp != null) + { + IKCPSEG* seg; + while (!iqueue_is_empty(&kcp->snd_buf)) + { + seg = iqueue_entry(kcp->snd_buf.next); + iqueue_del(&seg->node); + ikcp_segment_delete(kcp, seg); + } + + while (!iqueue_is_empty(&kcp->rcv_buf)) + { + seg = iqueue_entry(kcp->rcv_buf.next); + iqueue_del(&seg->node); + ikcp_segment_delete(kcp, seg); + } + + while (!iqueue_is_empty(&kcp->snd_queue)) + { + seg = iqueue_entry(kcp->snd_queue.next); + iqueue_del(&seg->node); + ikcp_segment_delete(kcp, seg); + } + + while (!iqueue_is_empty(&kcp->rcv_queue)) + { + seg = iqueue_entry(kcp->rcv_queue.next); + iqueue_del(&seg->node); + ikcp_segment_delete(kcp, seg); + } + + if (kcp->acklist != null) + { + ikcp_free(kcp->acklist); + } + + kcp->nrcv_buf = 0; + kcp->nsnd_buf = 0; + kcp->nrcv_que = 0; + kcp->nsnd_que = 0; + kcp->ackcount = 0; + kcp->acklist = null; + ikcp_free(kcp); + } + } + + //--------------------------------------------------------------------- + // user/upper level recv: returns size, returns below zero for EAGAIN + //--------------------------------------------------------------------- + public static int ikcp_recv(IKCPCB* kcp, byte* buffer, int len) + { + IQUEUEHEAD* p; + int ispeek = (len < 0) ? 1 : 0; + int peeksize; + int recover = 0; + IKCPSEG* seg; + assert(kcp != null); + + if (iqueue_is_empty(&kcp->rcv_queue)) + return -1; + + if (len < 0) len = -len; + + peeksize = ikcp_peeksize(kcp); + + if (peeksize < 0) + return -2; + + if (peeksize > len) + return -3; + + if (kcp->nrcv_que >= kcp->rcv_wnd) + recover = 1; + + // merge fragment + for (len = 0, p = kcp->rcv_queue.next; p != &kcp->rcv_queue;) + { + int fragment; + seg = iqueue_entry(p); + p = p->next; + + if (buffer != null) + { + memcpy(buffer, seg->data, (nuint)seg->len); + buffer += seg->len; + } + + len += (int)seg->len; + fragment = (int)seg->frg; + + if (ispeek == 0) + { + iqueue_del(&seg->node); + ikcp_segment_delete(kcp, seg); + kcp->nrcv_que--; + } + + if (fragment == 0) + break; + } + + assert(len == peeksize); + + // move available data from rcv_buf -> rcv_queue + while (!iqueue_is_empty(&kcp->rcv_buf)) + { + seg = iqueue_entry(kcp->rcv_buf.next); + if (seg->sn == kcp->rcv_nxt && kcp->nrcv_que < kcp->rcv_wnd) + { + iqueue_del(&seg->node); + kcp->nrcv_buf--; + iqueue_add_tail(&seg->node, &kcp->rcv_queue); + kcp->nrcv_que++; + kcp->rcv_nxt++; + } + else + { + break; + } + } + + // fast recover + if (kcp->nrcv_que < kcp->rcv_wnd && (recover != 0)) + { + // ready to send back IKCP_CMD_WINS in ikcp_flush + // tell remote my window size + kcp->probe |= IKCP_ASK_TELL; + } + + return len; + } + + //--------------------------------------------------------------------- + // peek data size + //--------------------------------------------------------------------- + public static int ikcp_peeksize(IKCPCB* kcp) + { + IQUEUEHEAD* p; + IKCPSEG* seg; + int length = 0; + + assert(kcp != null); + + if (iqueue_is_empty(&kcp->rcv_queue)) return -1; + + seg = iqueue_entry(kcp->rcv_queue.next); + if (seg->frg == 0) return (int)seg->len; + + if (kcp->nrcv_que < seg->frg + 1) return -1; + + for (p = kcp->rcv_queue.next; p != &kcp->rcv_queue; p = p->next) + { + seg = iqueue_entry(p); + length += (int)seg->len; + if (seg->frg == 0) break; + } + + return length; + } + + //--------------------------------------------------------------------- + // user/upper level send, returns below zero for error + //--------------------------------------------------------------------- + public static int ikcp_send(IKCPCB* kcp, byte* buffer, int len) + { + IKCPSEG* seg; + int count, i; + int sent = 0; + + assert(kcp->mss > 0); + if (len < 0) return -1; + + // append to previous segment in streaming mode (if possible) + if (kcp->stream != 0) + { + if (!iqueue_is_empty(&kcp->snd_queue)) + { + IKCPSEG* old = iqueue_entry(kcp->snd_queue.prev); + if (old->len < kcp->mss) + { + int capacity = (int)(kcp->mss - old->len); + int extend = (len < capacity) ? len : capacity; + seg = ikcp_segment_new(kcp, (int)(old->len + extend)); + assert(seg != null); + if (seg == null) + { + return -2; + } + + iqueue_add_tail(&seg->node, &kcp->snd_queue); + memcpy(seg->data, old->data, (nuint)old->len); + if (buffer != null) + { + memcpy(seg->data + old->len, buffer, (nuint)extend); + buffer += extend; + } + + seg->len = (uint)(old->len + extend); + seg->frg = 0; + len -= extend; + iqueue_del_init(&old->node); + ikcp_segment_delete(kcp, old); + sent = extend; + } + } + + if (len <= 0) + { + return sent; + } + } + + if (len <= (int)kcp->mss) count = 1; + else count = (int)((len + kcp->mss - 1) / kcp->mss); + + if (kcp->stream == 0 && count > 255) return -2; + + if (count >= (int)kcp->rcv_wnd) + { + if (kcp->stream != 0 && sent > 0) + return sent; + return -2; + } + + if (count == 0) count = 1; + + // fragment + for (i = 0; i < count; i++) + { + int size = len > (int)kcp->mss ? (int)kcp->mss : len; + seg = ikcp_segment_new(kcp, size); + assert(seg != null); + if (seg == null) + { + return -2; + } + + if ((buffer != null) && len > 0) + { + memcpy(seg->data, buffer, (nuint)size); + } + + seg->len = (uint)size; + seg->frg = (uint)((kcp->stream == 0) ? (count - i - 1) : 0); + iqueue_init(&seg->node); + iqueue_add_tail(&seg->node, &kcp->snd_queue); + kcp->nsnd_que++; + if (buffer != null) + { + buffer += size; + } + + len -= size; + sent += size; + } + + return sent; + } + + //--------------------------------------------------------------------- + // parse ack + //--------------------------------------------------------------------- + public static void ikcp_update_ack(IKCPCB* kcp, int rtt) + { + int rto = 0; + if (kcp->rx_srtt == 0) + { + kcp->rx_srtt = rtt; + kcp->rx_rttval = rtt / 2; + } + else + { + long delta = rtt - kcp->rx_srtt; + if (delta < 0) delta = -delta; + kcp->rx_rttval = (int)((3 * kcp->rx_rttval + delta) / 4); + kcp->rx_srtt = (7 * kcp->rx_srtt + rtt) / 8; + if (kcp->rx_srtt < 1) kcp->rx_srtt = 1; + } + + rto = (int)(kcp->rx_srtt + _imax_(kcp->interval, (uint)(4 * kcp->rx_rttval))); + kcp->rx_rto = (int)_ibound_((uint)kcp->rx_minrto, (uint)rto, IKCP_RTO_MAX); + } + + public static void ikcp_shrink_buf(IKCPCB* kcp) + { + IQUEUEHEAD* p = kcp->snd_buf.next; + if (p != &kcp->snd_buf) + { + IKCPSEG* seg = iqueue_entry(p); + kcp->snd_una = seg->sn; + } + else + { + kcp->snd_una = kcp->snd_nxt; + } + } + + public static void ikcp_parse_ack(IKCPCB* kcp, uint sn) + { + IQUEUEHEAD* p, next; + + if (_itimediff(sn, kcp->snd_una) < 0 || _itimediff(sn, kcp->snd_nxt) >= 0) + return; + + for (p = kcp->snd_buf.next; p != &kcp->snd_buf; p = next) + { + IKCPSEG* seg = iqueue_entry(p); + next = p->next; + if (sn == seg->sn) + { + iqueue_del(p); + ikcp_segment_delete(kcp, seg); + kcp->nsnd_buf--; + break; + } + + if (_itimediff(sn, seg->sn) < 0) + { + break; + } + } + } + + public static void ikcp_parse_una(IKCPCB* kcp, uint una) + { + IQUEUEHEAD* p, next; + for (p = kcp->snd_buf.next; p != &kcp->snd_buf; p = next) + { + IKCPSEG* seg = iqueue_entry(p); + next = p->next; + if (_itimediff(una, seg->sn) > 0) + { + iqueue_del(p); + ikcp_segment_delete(kcp, seg); + kcp->nsnd_buf--; + } + else + { + break; + } + } + } + + public static void ikcp_parse_fastack(IKCPCB* kcp, uint sn, uint ts) + { + IQUEUEHEAD* p, next; + + if (_itimediff(sn, kcp->snd_una) < 0 || _itimediff(sn, kcp->snd_nxt) >= 0) + return; + + for (p = kcp->snd_buf.next; p != &kcp->snd_buf; p = next) + { + IKCPSEG* seg = iqueue_entry(p); + next = p->next; + if (_itimediff(sn, seg->sn) < 0) + { + break; + } + else if (sn != seg->sn) + { +#if !IKCP_FASTACK_CONSERVE + seg->fastack++; +#else + if (_itimediff(ts, seg->ts) >= 0) + seg->fastack++; +#endif + } + } + } + + //--------------------------------------------------------------------- + // ack append + //--------------------------------------------------------------------- + public static void ikcp_ack_push(IKCPCB* kcp, uint sn, uint ts) + { + uint newsize = kcp->ackcount + 1; + uint* ptr; + + if (newsize > kcp->ackblock) + { + uint* acklist; + uint newblock; + + newblock = newsize <= 8 ? 8 : _iceilpow2_(newsize); + acklist = (uint*)ikcp_malloc((nuint)(newblock * sizeof(uint) * 2)); + + if (acklist == null) + { + assert(acklist != null); + abort(); + } + + if (kcp->acklist != null) + { + uint x; + for (x = 0; x < kcp->ackcount; x++) + { + acklist[x * 2 + 0] = kcp->acklist[x * 2 + 0]; + acklist[x * 2 + 1] = kcp->acklist[x * 2 + 1]; + } + + ikcp_free(kcp->acklist); + } + + kcp->acklist = acklist; + kcp->ackblock = newblock; + } + + ptr = &kcp->acklist[kcp->ackcount * 2]; + ptr[0] = sn; + ptr[1] = ts; + kcp->ackcount++; + } + + public static void ikcp_ack_get(IKCPCB* kcp, int p, uint* sn, uint* ts) + { + if (sn != null) sn[0] = kcp->acklist[p * 2 + 0]; + if (ts != null) ts[0] = kcp->acklist[p * 2 + 1]; + } + + //--------------------------------------------------------------------- + // parse data + //--------------------------------------------------------------------- + public static void ikcp_parse_data(IKCPCB* kcp, IKCPSEG* newseg) + { + IQUEUEHEAD* p, prev; + uint sn = newseg->sn; + int repeat = 0; + + if (_itimediff(sn, kcp->rcv_nxt + kcp->rcv_wnd) >= 0 || + _itimediff(sn, kcp->rcv_nxt) < 0) + { + ikcp_segment_delete(kcp, newseg); + return; + } + + for (p = kcp->rcv_buf.prev; p != &kcp->rcv_buf; p = prev) + { + IKCPSEG* seg = iqueue_entry(p); + prev = p->prev; + if (seg->sn == sn) + { + repeat = 1; + break; + } + + if (_itimediff(sn, seg->sn) > 0) + { + break; + } + } + + if (repeat == 0) + { + iqueue_init(&newseg->node); + iqueue_add(&newseg->node, p); + kcp->nrcv_buf++; + } + else + { + ikcp_segment_delete(kcp, newseg); + } + + // move available data from rcv_buf -> rcv_queue + while (!iqueue_is_empty(&kcp->rcv_buf)) + { + IKCPSEG* seg = iqueue_entry(kcp->rcv_buf.next); + if (seg->sn == kcp->rcv_nxt && kcp->nrcv_que < kcp->rcv_wnd) + { + iqueue_del(&seg->node); + kcp->nrcv_buf--; + iqueue_add_tail(&seg->node, &kcp->rcv_queue); + kcp->nrcv_que++; + kcp->rcv_nxt++; + } + else + { + break; + } + } + } + + //--------------------------------------------------------------------- + // input data + //--------------------------------------------------------------------- + public static int ikcp_input(IKCPCB* kcp, byte* data, long size) + { + uint prev_una = kcp->snd_una; + uint maxack = 0, latest_ts = 0; + int flag = 0; + + if (data == null || (int)size < (int)IKCP_OVERHEAD) return -1; + + while (true) + { + uint ts, sn, len, una, conv; + ushort wnd; + byte cmd, frg; + IKCPSEG* seg; + + if (size < (int)IKCP_OVERHEAD) break; + + data = ikcp_decode32u(data, &conv); + if (conv != kcp->conv) return -1; + + data = ikcp_decode8u(data, &cmd); + data = ikcp_decode8u(data, &frg); + data = ikcp_decode16u(data, &wnd); + data = ikcp_decode32u(data, &ts); + data = ikcp_decode32u(data, &sn); + data = ikcp_decode32u(data, &una); + data = ikcp_decode32u(data, &len); + + size -= IKCP_OVERHEAD; + + if ((long)size < (long)len || (int)len < 0) return -2; + + if (cmd != IKCP_CMD_PUSH && cmd != IKCP_CMD_ACK && + cmd != IKCP_CMD_WASK && cmd != IKCP_CMD_WINS) + return -3; + + kcp->rmt_wnd = wnd; + ikcp_parse_una(kcp, una); + ikcp_shrink_buf(kcp); + + if (cmd == IKCP_CMD_ACK) + { + if (_itimediff(kcp->current, ts) >= 0) + { + ikcp_update_ack(kcp, (int)_itimediff(kcp->current, ts)); + } + + ikcp_parse_ack(kcp, sn); + ikcp_shrink_buf(kcp); + if (flag == 0) + { + flag = 1; + maxack = sn; + latest_ts = ts; + } + else + { + if (_itimediff(sn, maxack) > 0) + { +#if !IKCP_FASTACK_CONSERVE + maxack = sn; + latest_ts = ts; +#else + if (_itimediff(ts, latest_ts) > 0) + { + maxack = sn; + latest_ts = ts; + } +#endif + } + } + } + else if (cmd == IKCP_CMD_PUSH) + { + if (_itimediff(sn, kcp->rcv_nxt + kcp->rcv_wnd) < 0) + { + ikcp_ack_push(kcp, sn, ts); + if (_itimediff(sn, kcp->rcv_nxt) >= 0) + { + seg = ikcp_segment_new(kcp, (int)len); + seg->conv = conv; + seg->cmd = cmd; + seg->frg = frg; + seg->wnd = wnd; + seg->ts = ts; + seg->sn = sn; + seg->una = una; + seg->len = len; + + if (len > 0) + { + memcpy(seg->data, data, (nuint)len); + } + + ikcp_parse_data(kcp, seg); + } + } + } + else if (cmd == IKCP_CMD_WASK) + { + // ready to send back IKCP_CMD_WINS in ikcp_flush + // tell remote my window size + kcp->probe |= IKCP_ASK_TELL; + } + else if (cmd == IKCP_CMD_WINS) + { + // do nothing + } + else + { + return -3; + } + + data += len; + size -= len; + } + + if (flag != 0) + { + ikcp_parse_fastack(kcp, maxack, latest_ts); + } + + if (_itimediff(kcp->snd_una, prev_una) > 0) + { + if (kcp->cwnd < kcp->rmt_wnd) + { + uint mss = kcp->mss; + if (kcp->cwnd < kcp->ssthresh) + { + kcp->cwnd++; + kcp->incr += mss; + } + else + { + if (kcp->incr < mss) kcp->incr = mss; + kcp->incr += (mss * mss) / kcp->incr + (mss / 16); + if ((kcp->cwnd + 1) * mss <= kcp->incr) + { + kcp->cwnd = (kcp->incr + mss - 1) / ((mss > 0) ? mss : 1); + } + } + + if (kcp->cwnd > kcp->rmt_wnd) + { + kcp->cwnd = kcp->rmt_wnd; + kcp->incr = kcp->rmt_wnd * mss; + } + } + } + + return 0; + } + + //--------------------------------------------------------------------- + // ikcp_encode_seg + //--------------------------------------------------------------------- + public static byte* ikcp_encode_seg(byte* ptr, IKCPSEG* seg) + { + ptr = ikcp_encode32u(ptr, seg->conv); + ptr = ikcp_encode8u(ptr, (byte)seg->cmd); + ptr = ikcp_encode8u(ptr, (byte)seg->frg); + ptr = ikcp_encode16u(ptr, (ushort)seg->wnd); + ptr = ikcp_encode32u(ptr, seg->ts); + ptr = ikcp_encode32u(ptr, seg->sn); + ptr = ikcp_encode32u(ptr, seg->una); + ptr = ikcp_encode32u(ptr, seg->len); + return ptr; + } + + public static int ikcp_wnd_unused(IKCPCB* kcp) + { + if (kcp->nrcv_que < kcp->rcv_wnd) + { + return (int)(kcp->rcv_wnd - kcp->nrcv_que); + } + + return 0; + } + + //--------------------------------------------------------------------- + // ikcp_flush + //--------------------------------------------------------------------- + public static void ikcp_flush(IKCPCB* kcp, byte* buffer, byte[] destination, KcpCallback output) + { + uint current = kcp->current; + byte* ptr = buffer; + int count, size, i; + uint resent, cwnd; + uint rtomin; + IQUEUEHEAD* p; + int change = 0; + int lost = 0; + IKCPSEG seg; + + // 'ikcp_update' haven't been called. + if (kcp->updated == 0) return; + + seg.conv = kcp->conv; + seg.cmd = IKCP_CMD_ACK; + seg.frg = 0; + seg.wnd = (uint)ikcp_wnd_unused(kcp); + seg.una = kcp->rcv_nxt; + seg.len = 0; + seg.sn = 0; + seg.ts = 0; + + // flush acknowledges + count = (int)kcp->ackcount; + for (i = 0; i < count; i++) + { + size = (int)(ptr - buffer); + if (size + (int)IKCP_OVERHEAD > (int)kcp->mtu) + { + ikcp_output(kcp, size, destination, output); + ptr = buffer; + } + + ikcp_ack_get(kcp, i, &seg.sn, &seg.ts); + ptr = ikcp_encode_seg(ptr, &seg); + } + + kcp->ackcount = 0; + + // probe window size (if remote window size equals zero) + if (kcp->rmt_wnd == 0) + { + if (kcp->probe_wait == 0) + { + kcp->probe_wait = IKCP_PROBE_INIT; + kcp->ts_probe = kcp->current + kcp->probe_wait; + } + else + { + if (_itimediff(kcp->current, kcp->ts_probe) >= 0) + { + if (kcp->probe_wait < IKCP_PROBE_INIT) + kcp->probe_wait = IKCP_PROBE_INIT; + kcp->probe_wait += kcp->probe_wait / 2; + if (kcp->probe_wait > IKCP_PROBE_LIMIT) + kcp->probe_wait = IKCP_PROBE_LIMIT; + kcp->ts_probe = kcp->current + kcp->probe_wait; + kcp->probe |= IKCP_ASK_SEND; + } + } + } + else + { + kcp->ts_probe = 0; + kcp->probe_wait = 0; + } + + // flush window probing commands + if ((kcp->probe & IKCP_ASK_SEND) != 0) + { + seg.cmd = IKCP_CMD_WASK; + size = (int)(ptr - buffer); + if (size + (int)IKCP_OVERHEAD > (int)kcp->mtu) + { + ikcp_output(kcp, size, destination, output); + ptr = buffer; + } + + ptr = ikcp_encode_seg(ptr, &seg); + } + + // flush window probing commands + if ((kcp->probe & IKCP_ASK_TELL) != 0) + { + seg.cmd = IKCP_CMD_WINS; + size = (int)(ptr - buffer); + if (size + (int)IKCP_OVERHEAD > (int)kcp->mtu) + { + ikcp_output(kcp, size, destination, output); + ptr = buffer; + } + + ptr = ikcp_encode_seg(ptr, &seg); + } + + kcp->probe = 0; + + // calculate window size + cwnd = _imin_(kcp->snd_wnd, kcp->rmt_wnd); + if (kcp->nocwnd == 0) cwnd = _imin_(kcp->cwnd, cwnd); + + // move data from snd_queue to snd_buf + while (_itimediff(kcp->snd_nxt, kcp->snd_una + cwnd) < 0) + { + IKCPSEG* newseg; + if (iqueue_is_empty(&kcp->snd_queue)) break; + + newseg = iqueue_entry(kcp->snd_queue.next); + + iqueue_del(&newseg->node); + iqueue_add_tail(&newseg->node, &kcp->snd_buf); + kcp->nsnd_que--; + kcp->nsnd_buf++; + + newseg->conv = kcp->conv; + newseg->cmd = IKCP_CMD_PUSH; + newseg->wnd = seg.wnd; + newseg->ts = current; + newseg->sn = kcp->snd_nxt++; + newseg->una = kcp->rcv_nxt; + newseg->resendts = current; + newseg->rto = (uint)kcp->rx_rto; + newseg->fastack = 0; + newseg->xmit = 0; + } + + // calculate resent + resent = (kcp->fastresend > 0) ? (uint)kcp->fastresend : 0xffffffff; + rtomin = (uint)((kcp->nodelay == 0) ? (kcp->rx_rto >> 3) : 0); + + // flush data segments + for (p = kcp->snd_buf.next; p != &kcp->snd_buf; p = p->next) + { + IKCPSEG* segment = iqueue_entry(p); + int needsend = 0; + if (segment->xmit == 0) + { + needsend = 1; + segment->xmit++; + segment->rto = (uint)kcp->rx_rto; + segment->resendts = current + segment->rto + rtomin; + } + else if (_itimediff(current, segment->resendts) >= 0) + { + needsend = 1; + segment->xmit++; + kcp->xmit++; + if (kcp->nodelay == 0) + { + segment->rto += _imax_(segment->rto, (uint)kcp->rx_rto); + } + else + { + int step = (kcp->nodelay < 2) ? ((int)(segment->rto)) : kcp->rx_rto; + segment->rto += (uint)(step / 2); + } + + segment->resendts = current + segment->rto; + lost = 1; + } + else if (segment->fastack >= resent) + { + if ((int)segment->xmit <= kcp->fastlimit || + kcp->fastlimit <= 0) + { + needsend = 1; + segment->xmit++; + segment->fastack = 0; + segment->resendts = current + segment->rto; + change++; + } + } + + if (needsend != 0) + { + int need; + segment->ts = current; + segment->wnd = seg.wnd; + segment->una = kcp->rcv_nxt; + + size = (int)(ptr - buffer); + need = (int)(IKCP_OVERHEAD + segment->len); + + if (size + need > (int)kcp->mtu) + { + ikcp_output(kcp, size, destination, output); + ptr = buffer; + } + + ptr = ikcp_encode_seg(ptr, segment); + + if (segment->len > 0) + { + memcpy(ptr, segment->data, (nuint)segment->len); + ptr += segment->len; + } + + if (segment->xmit >= kcp->dead_link) + { + kcp->state = unchecked((uint)(-1)); + } + } + } + + // flash remain segments + size = (int)(ptr - buffer); + if (size > 0) + { + ikcp_output(kcp, size, destination, output); + } + + // update ssthresh + if (change != 0) + { + uint inflight = kcp->snd_nxt - kcp->snd_una; + kcp->ssthresh = inflight / 2; + if (kcp->ssthresh < IKCP_THRESH_MIN) + kcp->ssthresh = IKCP_THRESH_MIN; + kcp->cwnd = kcp->ssthresh + resent; + kcp->incr = kcp->cwnd * kcp->mss; + } + + if (lost != 0) + { + kcp->ssthresh = cwnd / 2; + if (kcp->ssthresh < IKCP_THRESH_MIN) + kcp->ssthresh = IKCP_THRESH_MIN; + kcp->cwnd = 1; + kcp->incr = kcp->mss; + } + + if (kcp->cwnd < 1) + { + kcp->cwnd = 1; + kcp->incr = kcp->mss; + } + } + + public static void ikcp_update(IKCPCB* kcp, uint current, byte* buffer, byte[] destination, KcpCallback output) + { + int slap; + + kcp->current = current; + + if (kcp->updated == 0) + { + kcp->updated = 1; + kcp->ts_flush = kcp->current; + } + + slap = (int)_itimediff(kcp->current, kcp->ts_flush); + + if (slap >= 10000 || slap < -10000) + { + kcp->ts_flush = kcp->current; + slap = 0; + } + + if (slap >= 0) + { + kcp->ts_flush += kcp->interval; + if (_itimediff(kcp->current, kcp->ts_flush) >= 0) + { + kcp->ts_flush = kcp->current + kcp->interval; + } + + ikcp_flush(kcp, buffer, destination, output); + } + } + + //--------------------------------------------------------------------- + // Determine when should you invoke ikcp_update: + // returns when you should invoke ikcp_update in millisec, if there + // is no ikcp_input/_send calling. you can call ikcp_update in that + // time, instead of call update repeatly. + // Important to reduce unnacessary ikcp_update invoking. use it to + // schedule ikcp_update (eg. implementing an epoll-like mechanism, + // or optimize ikcp_update when handling massive kcp connections) + //--------------------------------------------------------------------- + public static uint ikcp_check(IKCPCB* kcp, uint current) + { + uint ts_flush = kcp->ts_flush; + int tm_flush = 0x7fffffff; + int tm_packet = 0x7fffffff; + uint minimal = 0; + IQUEUEHEAD* p; + + if (kcp->updated == 0) + { + return current; + } + + if (_itimediff(current, ts_flush) >= 10000 || + _itimediff(current, ts_flush) < -10000) + { + ts_flush = current; + } + + if (_itimediff(current, ts_flush) >= 0) + { + return current; + } + + tm_flush = (int)_itimediff(ts_flush, current); + + for (p = kcp->snd_buf.next; p != &kcp->snd_buf; p = p->next) + { + IKCPSEG* seg = iqueue_entry(p); + int diff = (int)_itimediff(seg->resendts, current); + if (diff <= 0) + { + return current; + } + + if (diff < tm_packet) tm_packet = diff; + } + + minimal = (uint)(tm_packet < tm_flush ? tm_packet : tm_flush); + if (minimal >= kcp->interval) minimal = kcp->interval; + + return current + minimal; + } + + public static int ikcp_setmtu(IKCPCB* kcp, int mtu, int reserved, ref byte[] buffer) + { + if (mtu < 50 || mtu < (int)IKCP_OVERHEAD) + return -1; + buffer = new byte[(reserved + mtu + IKCP_OVERHEAD) * 3]; + if (buffer == null) + return -2; + kcp->mtu = (uint)mtu; + kcp->mss = kcp->mtu - IKCP_OVERHEAD; + return 0; + } + + public static int ikcp_interval(IKCPCB* kcp, int interval) + { + if (interval > 5000) interval = 5000; + else if (interval < 10) interval = 10; + kcp->interval = (uint)interval; + return 0; + } + + public static int ikcp_nodelay(IKCPCB* kcp, int nodelay, int interval, int resend, int nc) + { + if (nodelay >= 0) + { + kcp->nodelay = (uint)nodelay; + if (nodelay != 0) + { + kcp->rx_minrto = (int)IKCP_RTO_NDL; + } + else + { + kcp->rx_minrto = (int)IKCP_RTO_MIN; + } + } + + if (interval >= 0) + { + if (interval > 5000) interval = 5000; + else if (interval < 10) interval = 10; + kcp->interval = (uint)interval; + } + + if (resend >= 0) + { + kcp->fastresend = resend; + } + + if (nc >= 0) + { + kcp->nocwnd = nc; + } + + return 0; + } + + public static int ikcp_wndsize(IKCPCB* kcp, int sndwnd, int rcvwnd) + { + if (kcp != null) + { + if (sndwnd > 0) + { + kcp->snd_wnd = (uint)sndwnd; + } + + if (rcvwnd > 0) + { + // must >= max fragment size + kcp->rcv_wnd = _imax_((uint)rcvwnd, IKCP_WND_RCV); + } + } + + return 0; + } + + public static int ikcp_waitsnd(IKCPCB* kcp) + { + return (int)(kcp->nsnd_buf + kcp->nsnd_que); + } + + // read conv + public static uint ikcp_getconv(void* ptr) + { + uint conv; + ikcp_decode32u((byte*)ptr, &conv); + return conv; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c/kcp.cs.meta b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c/kcp.cs.meta new file mode 100644 index 0000000..8c76c83 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/c/kcp.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 9661d9c8e632d402bbd307355f57c0ed +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define.meta b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define.meta new file mode 100644 index 0000000..7952d7a --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: e2418baa01ef64a679aa2a9500d86809 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define/system.cs b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define/system.cs new file mode 100644 index 0000000..053b8c5 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define/system.cs @@ -0,0 +1,41 @@ +using System; +using System.Diagnostics; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; + +#pragma warning disable CS1591 + +// ReSharper disable ALL + +namespace kcp +{ + public static unsafe partial class KCP + { + public static void* malloc(nuint size) + { +#if NET6_0_OR_GREATER + return NativeMemory.Alloc((nuint)size); +#else + return (void*)Marshal.AllocHGlobal((nint)size); +#endif + } + + public static void free(void* memory) + { +#if NET6_0_OR_GREATER + NativeMemory.Free(memory); +#else + Marshal.FreeHGlobal((nint)memory); +#endif + } + + public static void memcpy(void* dst, void* src, nuint size) => Unsafe.CopyBlockUnaligned(dst, src, (uint)size); + + public static void memset(void* dst, byte val, nuint size) => Unsafe.InitBlockUnaligned(dst, val, (uint)size); + + [Conditional("DEBUG")] + public static void assert(bool condition) => Debug.Assert(condition); + + public static void abort() => Environment.Exit(-1); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define/system.cs.meta b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define/system.cs.meta new file mode 100644 index 0000000..b5cc856 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/define/system.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a53e42c960ecc4481a476db0a8dc8f15 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include.meta b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include.meta new file mode 100644 index 0000000..d9d01f7 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 1bcdc18a2eae34dfeb6ba908353cec18 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include/kcp.cs b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include/kcp.cs new file mode 100644 index 0000000..98a83d9 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include/kcp.cs @@ -0,0 +1,127 @@ +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; + +#pragma warning disable CS1591 + +// ReSharper disable ALL + +namespace kcp +{ + [StructLayout(LayoutKind.Sequential)] + public unsafe struct IQUEUEHEAD + { + public IQUEUEHEAD* next; + public IQUEUEHEAD* prev; + } + + public static unsafe partial class KCP + { + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void iqueue_init(IQUEUEHEAD* head) + { + head->next = head; + head->prev = head; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static T* iqueue_entry(IQUEUEHEAD* ptr) where T : unmanaged => ((T*)(((byte*)((T*)ptr)))); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void iqueue_add(IQUEUEHEAD* node, IQUEUEHEAD* head) + { + node->prev = head; + node->next = head->next; + head->next->prev = node; + head->next = node; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void iqueue_add_tail(IQUEUEHEAD* node, IQUEUEHEAD* head) + { + node->prev = head->prev; + node->next = head; + head->prev->next = node; + head->prev = node; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void iqueue_del(IQUEUEHEAD* entry) + { + entry->next->prev = entry->prev; + entry->prev->next = entry->next; + entry->next = (IQUEUEHEAD*)0; + entry->prev = (IQUEUEHEAD*)0; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void iqueue_del_init(IQUEUEHEAD* entry) + { + iqueue_del(entry); + iqueue_init(entry); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static bool iqueue_is_empty(IQUEUEHEAD* entry) => entry == entry->next; + } + + [StructLayout(LayoutKind.Sequential)] + public unsafe struct IKCPSEG + { + public IQUEUEHEAD node; + public uint conv; + public uint cmd; + public uint frg; + public uint wnd; + public uint ts; + public uint sn; + public uint una; + public uint len; + public uint resendts; + public uint rto; + public uint fastack; + public uint xmit; + public fixed byte data[1]; + } + + [StructLayout(LayoutKind.Sequential)] + public unsafe struct IKCPCB + { + public uint conv, mtu, mss, state; + public uint snd_una, snd_nxt, rcv_nxt; + public uint ts_recent, ts_lastack, ssthresh; + public int rx_rttval, rx_srtt, rx_rto, rx_minrto; + public uint snd_wnd, rcv_wnd, rmt_wnd, cwnd, probe; + public uint current, interval, ts_flush, xmit; + public uint nrcv_buf, nsnd_buf; + public uint nrcv_que, nsnd_que; + public uint nodelay, updated; + public uint ts_probe, probe_wait; + public uint dead_link, incr; + public IQUEUEHEAD snd_queue; + public IQUEUEHEAD rcv_queue; + public IQUEUEHEAD snd_buf; + public IQUEUEHEAD rcv_buf; + public uint* acklist; + public uint ackcount; + public uint ackblock; + public int fastresend; + public int fastlimit; + public int nocwnd, stream; + } + + public static partial class KCP + { + public const uint IKCP_LOG_OUTPUT = 1; + public const uint IKCP_LOG_INPUT = 2; + public const uint IKCP_LOG_SEND = 4; + public const uint IKCP_LOG_RECV = 8; + public const uint IKCP_LOG_IN_DATA = 16; + public const uint IKCP_LOG_IN_ACK = 32; + public const uint IKCP_LOG_IN_PROBE = 64; + public const uint IKCP_LOG_IN_WINS = 128; + public const uint IKCP_LOG_OUT_DATA = 256; + public const uint IKCP_LOG_OUT_ACK = 512; + public const uint IKCP_LOG_OUT_PROBE = 1024; + public const uint IKCP_LOG_OUT_WINS = 2048; + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include/kcp.cs.meta b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include/kcp.cs.meta new file mode 100644 index 0000000..1e2d471 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Base/include/kcp.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ba77cae2816504402a7e387e3ab7bc87 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Client/KCPClientNetwork.cs b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Client/KCPClientNetwork.cs new file mode 100644 index 0000000..ac2d487 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Client/KCPClientNetwork.cs @@ -0,0 +1,690 @@ +using System; +using System.Buffers; +using System.Collections.Generic; +using System.IO; +using System.IO.Pipelines; +using System.Net; +using System.Net.Sockets; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +using System.Security.Cryptography; +using System.Threading; +using KCP; +using NBC.Async; +using NBC.Entitas.Interface; +using NBC.Helper; +using NBC.Network.Interface; +using NBC.PacketParser; +using NBC.Serialize; + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +// ReSharper disable PossibleNullReferenceException +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. + +#pragma warning disable CS8622 // Nullability of reference types in type of parameter doesn't match the target delegate (possibly because of nullability attributes). + +#pragma warning disable CS8602 // Dereference of a possibly null reference. +namespace NBC.Network.KCP +{ + public sealed class KCPClientNetworkUpdateSystem : UpdateSystem + { + protected override void Update(KCPClientNetwork self) + { + self.CheckUpdate(); + } + } + public sealed class KCPClientNetwork : AClientNetwork + { + private Kcp _kcp; + private Socket _socket; + private int _maxSndWnd; + private long _startTime; + private bool _isConnected; + private bool _isDisconnect; + private uint _updateMinTime; + private bool _isInnerDispose; + private long _connectTimeoutId; + private bool _allowWraparound = true; + private IPEndPoint _remoteAddress; + private BufferPacketParser _packetParser; + private readonly Pipe _pipe = new Pipe(); + private readonly byte[] _sendBuff = new byte[5]; + private readonly byte[] _receiveBuffer = new byte[Packet.PacketBodyMaxLength + 20]; + private readonly List _updateTimeOutTime = new List(); + private readonly SortedSet _updateTimer = new SortedSet(); + private readonly SocketAsyncEventArgs _connectEventArgs = new SocketAsyncEventArgs(); + private readonly Queue _messageCache = new Queue(); + private readonly CancellationTokenSource _cancellationTokenSource = new CancellationTokenSource(); + + private readonly EndPoint _ipEndPoint = new IPEndPoint(IPAddress.Any, 0); + + private event Action OnConnectFail; + private event Action OnConnectComplete; + private event Action OnConnectDisconnect; + public uint ChannelId { get; private set; } + private uint TimeNow => (uint) (TimeHelper.Now - _startTime); + + public void Initialize(NetworkTarget networkTarget) + { + base.Initialize(NetworkType.Client, NetworkProtocolType.KCP, networkTarget); + _packetParser = PacketParserFactory.CreateClientBufferPacket(this); + } + + public override void Dispose() + { + if (IsDisposed || _isInnerDispose) + { + return; + } + + try + { + _isInnerDispose = true; + + if (!_isDisconnect) + { + SendDisconnect(); + } + + ClearConnectTimeout(); + + if (!_cancellationTokenSource.IsCancellationRequested) + { + try + { + _cancellationTokenSource.Cancel(); + } + catch (OperationCanceledException) + { + // 通常情况下，此处的异常可以忽略 + } + } + + OnConnectDisconnect?.Invoke(); + _kcp.Dispose(); + + if (_socket.Connected) + { + _socket.Close(); + } + + _packetParser.Dispose(); + ChannelId = 0; + _isConnected = false; + _messageCache.Clear(); + } + catch (Exception e) + { + Log.Error(e); + } + finally + { + base.Dispose(); + } + } + + #region Connect + + public override Session Connect(string remoteAddress, Action onConnectComplete, Action onConnectFail, Action onConnectDisconnect, bool isHttps, int connectTimeout = 5000) + { + if (IsInit) + { + throw new NotSupportedException($"KCPClientNetwork Has already been initialized. If you want to call Connect again, please re instantiate it."); + } + + IsInit = true; + _startTime = TimeHelper.Now; + ChannelId = CreateChannelId(); + _remoteAddress = NetworkHelper.GetIPEndPoint(remoteAddress); + OnConnectFail = onConnectFail; + OnConnectComplete = onConnectComplete; + OnConnectDisconnect = onConnectDisconnect; + _connectEventArgs.Completed += OnConnectSocketCompleted; + _connectTimeoutId = Scene.TimerComponent.Net.OnceTimer(connectTimeout, () => + { + OnConnectFail?.Invoke(); + Dispose(); + }); + _connectEventArgs.RemoteEndPoint = _remoteAddress; + _socket = new Socket(_remoteAddress.AddressFamily, SocketType.Dgram, ProtocolType.Udp); + _socket.Blocking = false; + _socket.SetSocketBufferToOsLimit(); + _socket.SetSioUdpConnReset(); + _socket.Bind(new IPEndPoint(IPAddress.Any, 0)); + _kcp = KCPFactory.Create(NetworkTarget, ChannelId, KcpSpanCallback, out var kcpSettings); + _maxSndWnd = kcpSettings.MaxSendWindowSize; + + if (!_socket.ConnectAsync(_connectEventArgs)) + { + try + { + OnReceiveSocketComplete(); + } + catch (Exception e) + { + Log.Error(e); + OnConnectFail?.Invoke(); + } + } + + Session = Session.Create(this, _remoteAddress); + return Session; + } + + private void OnConnectSocketCompleted(object sender, SocketAsyncEventArgs asyncEventArgs) + { + if (_cancellationTokenSource.IsCancellationRequested) + { + return; + } + + if (asyncEventArgs.LastOperation == SocketAsyncOperation.Connect) + { + if (asyncEventArgs.SocketError == SocketError.Success) + { + Scene.ThreadSynchronizationContext.Post(OnReceiveSocketComplete); + } + else + { + Scene.ThreadSynchronizationContext.Post(() => + { + OnConnectFail?.Invoke(); + Dispose(); + }); + } + } + } + + private void OnReceiveSocketComplete() + { + SendRequestConnection(); + ReadPipeDataAsync().Coroutine(); + ReceiveSocketAsync().Coroutine(); + } + + #endregion + + #region ReceiveSocket + + private async FTask ReceiveSocketAsync() + { + while (!_cancellationTokenSource.IsCancellationRequested) + { + try + { + var memory = _pipe.Writer.GetMemory(8192); + MemoryMarshal.TryGetArray(memory, out ArraySegment arraySegment); + var result = await _socket.ReceiveFromAsync(arraySegment, SocketFlags.None, _ipEndPoint); + _pipe.Writer.Advance(result.ReceivedBytes); + await _pipe.Writer.FlushAsync(); + } + catch (SocketException) + { + Dispose(); + break; + } + catch (OperationCanceledException) + { + break; + } + catch (ObjectDisposedException) + { + Dispose(); + break; + } + catch (Exception ex) + { + Log.Error($"Unexpected exception: {ex.Message}"); + } + } + + await _pipe.Writer.CompleteAsync(); + } + + #endregion + + #region ReceivePipeData + + private async FTask ReadPipeDataAsync() + { + var pipeReader = _pipe.Reader; + while (!_cancellationTokenSource.IsCancellationRequested) + { + ReadResult result = default; + + try + { + result = await pipeReader.ReadAsync(_cancellationTokenSource.Token); + } + catch (OperationCanceledException) + { + // 出现这个异常表示取消了_cancellationTokenSource。一般Channel断开会取消。 + break; + } + + var buffer = result.Buffer; + var consumed = buffer.Start; + var examined = buffer.End; + + while (TryReadMessage(ref buffer, out var header, out var channelId, out var message)) + { + ReceiveData(ref header, ref channelId, ref message); + consumed = buffer.Start; + } + + if (result.IsCompleted) + { + break; + } + + pipeReader.AdvanceTo(consumed, examined); + } + } + + private unsafe bool TryReadMessage(ref ReadOnlySequence buffer, out KcpHeader header, out uint channelId, out ReadOnlyMemory message) + { + if (buffer.Length < 5) + { + channelId = 0; + message = default; + header = KcpHeader.None; + if (buffer.Length > 0) + { + buffer = buffer.Slice(buffer.Length); + } + return false; + } + + var readOnlyMemory = buffer.First; + + if (MemoryMarshal.TryGetArray(readOnlyMemory, out var arraySegment)) + { + fixed (byte* bytePointer = &arraySegment.Array[arraySegment.Offset]) + { + header = (KcpHeader)bytePointer[0]; + channelId = Unsafe.ReadUnaligned(ref bytePointer[1]); + } + } + else + { + // 如果无法获取数组段，回退到安全代码来执行。这种情况几乎不会发生、为了保险还是写一下了。 + var firstSpan = readOnlyMemory.Span; + header = (KcpHeader)firstSpan[0]; + channelId = MemoryMarshal.Read(firstSpan.Slice(1, 4)); + + } + + message = readOnlyMemory.Slice(5); + buffer = buffer.Slice(readOnlyMemory.Length); + return true; + } + + private void ReceiveData(ref KcpHeader header, ref uint channelId, ref ReadOnlyMemory buffer) + { + switch (header) + { + // 发送握手给服务器 + case KcpHeader.RepeatChannelId: + { + // 到这里是客户端的channelId再服务器上已经存在、需要重新生成一个再次尝试连接 + ChannelId = CreateChannelId(); + SendRequestConnection(); + break; + } + // 收到服务器发送会来的确认握手 + case KcpHeader.WaitConfirmConnection: + { + if (channelId != ChannelId) + { + break; + } + + ClearConnectTimeout(); + SendConfirmConnection(); + OnConnectComplete?.Invoke(); + _isConnected = true; + while (_messageCache.TryDequeue(out var memoryStream)) + { + SendMemoryStream(memoryStream); + } + break; + } + // 收到服务器发送的消息 + case KcpHeader.ReceiveData: + { + if (buffer.Length == 5) + { + Log.Warning($"KCP Server KcpHeader.Data buffer.Length == 5"); + break; + } + + if (channelId != ChannelId) + { + break; + } + + Input(buffer); + break; + } + // 接收到服务器的断开连接消息 + case KcpHeader.Disconnect: + { + if (channelId != ChannelId) + { + break; + } + + _isDisconnect = true; + Dispose(); + break; + } + } + } + + private void Input(ReadOnlyMemory buffer) + { + _kcp.Input(buffer.Span); + AddToUpdate(0); + + while (!_cancellationTokenSource.IsCancellationRequested) + { + try + { + var peekSize = _kcp.PeekSize(); + + if (peekSize < 0) + { + return; + } + + var receiveCount = _kcp.Receive(_receiveBuffer.AsSpan(0, peekSize)); + + if (receiveCount != peekSize) + { + return; + } + + if (!_packetParser.UnPack(_receiveBuffer, ref receiveCount, out var packInfo)) + { + continue; + } + + Session.Receive(packInfo); + } + catch (ScanException e) + { + Log.Debug($"RemoteAddress:{_remoteAddress} \n{e}"); + Dispose(); + } + catch (Exception e) + { + Log.Error(e); + } + } + } + + #endregion + + #region Update + + public void CheckUpdate() + { + var nowTime = TimeNow; + _allowWraparound = nowTime < _updateMinTime; + + if (IsTimeGreaterThan(nowTime, _updateMinTime) && _updateTimer.Count > 0) + { + foreach (var timeId in _updateTimer) + { + if (IsTimeGreaterThan(timeId, nowTime)) + { + _updateMinTime = timeId; + break; + } + + _updateTimeOutTime.Add(timeId); + } + + foreach (var timeId in _updateTimeOutTime) + { + _updateTimer.Remove(timeId); + KcpUpdate(); + } + + _updateTimeOutTime.Clear(); + } + + _allowWraparound = true; + } + + private void AddToUpdate(uint tillTime) + { + if (tillTime == 0) + { + KcpUpdate(); + return; + } + + if (IsTimeGreaterThan(_updateMinTime, tillTime) || _updateMinTime == 0) + { + _updateMinTime = tillTime; + } + + _updateTimer.Add(tillTime); + } + + private void KcpUpdate() + { + var nowTime = TimeNow; + + try + { + _kcp.Update(nowTime); + } + catch (Exception e) + { + Log.Error(e); + } + + AddToUpdate(_kcp.Check(nowTime)); + } + + private const uint HalfMaxUint = uint.MaxValue / 2; + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private bool IsTimeGreaterThan(uint timeId, uint nowTime) + { + if (!_allowWraparound) + { + return timeId > nowTime; + } + var diff = timeId - nowTime; + // 如果 diff 的值在 [0, HalfMaxUint] 范围内，说明 timeId 是在 nowTime 之后或相等。 + // 如果 diff 的值在 (HalfMaxUint, uint.MaxValue] 范围内，说明 timeId 是在 nowTime 之前（时间回绕的情况）。 + return diff < HalfMaxUint || diff == HalfMaxUint; + } + + #endregion + + #region Send + + private const byte KcpHeaderDisconnect = (byte)KcpHeader.Disconnect; + private const byte KcpHeaderReceiveData = (byte)KcpHeader.ReceiveData; + private const byte KcpHeaderRequestConnection = (byte)KcpHeader.RequestConnection; + private const byte KcpHeaderConfirmConnection = (byte)KcpHeader.ConfirmConnection; + + public override void Send(uint rpcId, long routeId, MemoryStreamBuffer memoryStream, IMessage message) + { + if (_cancellationTokenSource.IsCancellationRequested) + { + return; + } + + var buffer = _packetParser.Pack(ref rpcId, ref routeId, memoryStream, message); + + if (!_isConnected) + { + _messageCache.Enqueue(buffer); + return; + } + + SendMemoryStream(buffer); + } + + private void SendMemoryStream(MemoryStreamBuffer memoryStream) + { + if (_kcp.WaitSendCount > _maxSndWnd) + { + // 检查等待发送的消息，如果超出两倍窗口大小，KCP作者给的建议是要断开连接 + Log.Warning($"ERR_KcpWaitSendSizeTooLarge {_kcp.WaitSendCount} > {_maxSndWnd}"); + Dispose(); + return; + } + + try + { + _kcp.Send(memoryStream.GetBuffer().AsSpan(0, (int)memoryStream.Position)); + AddToUpdate(0); + } + finally + { + if (memoryStream.MemoryStreamBufferSource == MemoryStreamBufferSource.Pack) + { + MemoryStreamBufferPool.ReturnMemoryStream(memoryStream); + } + } + } + + private unsafe void SendRequestConnection() + { + try + { + fixed (byte* p = _sendBuff) + { + p[0] = KcpHeaderRequestConnection; + *(uint*)(p + 1) = ChannelId; + } + + SendAsync(_sendBuff, 0, 5); + } + catch (Exception e) + { + Log.Error(e); + } + } + + private unsafe void SendConfirmConnection() + { + try + { + fixed (byte* p = _sendBuff) + { + p[0] = KcpHeaderConfirmConnection; + *(uint*)(p + 1) = ChannelId; + } + + SendAsync(_sendBuff, 0, 5); + } + catch (Exception e) + { + Log.Error(e); + } + } + + private unsafe void SendDisconnect() + { + try + { + fixed (byte* p = _sendBuff) + { + p[0] = KcpHeaderDisconnect; + *(uint*)(p + 1) = ChannelId; + } + + SendAsync(_sendBuff, 0, 5); + } + catch (Exception e) + { + Log.Error(e); + } + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private void SendAsync(byte[] buffer, int offset, int count) + { + try + { + _socket.Send(new ArraySegment(buffer, offset, count), SocketFlags.None); + } + catch (ArgumentException ex) + { + Log.Error($"ArgumentException: {ex.Message}"); // 处理参数错误 + } + catch (SocketException) + { + //Log.Error($"SocketException: {ex.Message}"); // 处理网络错误 + Dispose(); + } + catch (ObjectDisposedException ex) + { + Log.Error($"ObjectDisposedException: {ex.Message}"); // 处理套接字已关闭的情况 + Dispose(); + } + catch (InvalidOperationException ex) + { + Log.Error($"InvalidOperationException: {ex.Message}"); // 处理无效操作 + } + catch (Exception ex) + { + Log.Error($"Exception: {ex.Message}"); // 捕获其他异常 + } + } + + private unsafe void KcpSpanCallback(byte[] buffer, int count) + { + if (IsDisposed) + { + return; + } + + if (count == 0) + { + throw new Exception("KcpOutput count 0"); + } + + fixed (byte* p = buffer) + { + p[0] = KcpHeaderReceiveData; + *(uint*)(p + 1) = ChannelId; + } + + SendAsync(buffer, 0, count + 5); + } + + #endregion + + public override void RemoveChannel(uint channelId) + { + Dispose(); + } + + private void ClearConnectTimeout() + { + if (_connectTimeoutId == 0) + { + return; + } + + Scene?.TimerComponent?.Net.Remove(ref _connectTimeoutId); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private static unsafe uint CreateChannelId() + { + uint value; + RandomNumberGenerator.Fill(MemoryMarshal.CreateSpan(ref *(byte*)&value, 4)); + return 0xC0000000 | (value & int.MaxValue); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Client/KCPClientNetwork.cs.meta b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Client/KCPClientNetwork.cs.meta new file mode 100644 index 0000000..0374b0b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Client/KCPClientNetwork.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 955df13b771de413ebebbdb3ac07be7d +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/KCPSettings.cs b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/KCPSettings.cs new file mode 100644 index 0000000..8debbfc --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/KCPSettings.cs @@ -0,0 +1,69 @@ +#if !FANTASY_WEBGL +using System; +using KCP; + +#pragma warning disable CS1591 +namespace NBC.Network.KCP +{ + public class KCPSettings + { + public int Mtu { get; private set; } + public int SendWindowSize { get; private set; } + public int ReceiveWindowSize { get; private set; } + public int MaxSendWindowSize { get; private set; } + + public static KCPSettings Create(NetworkTarget networkTarget) + { + var settings = new KCPSettings(); + + switch (networkTarget) + { + case NetworkTarget.Outer: + { + // 外网设置470的原因: + // 1、mtu设置过大有可能路由器过滤掉 + // 2、降低 mtu 到 470，同样数据虽然会发更多的包，但是小包在路由层优先级更高 + settings.Mtu = 470; + settings.SendWindowSize = 512; + settings.ReceiveWindowSize = 512; + settings.MaxSendWindowSize = 512 * 512 * 7; + + break; + } + default: + { + throw new NotSupportedException($"KCPServerNetwork NotSupported NetworkType:{networkTarget}"); + } + } + + return settings; + } + } + + public static class KCPFactory + { + public const int FANTASY_KCP_RESERVED_HEAD = 5; + + public static Kcp Create(NetworkTarget networkTarget, uint conv, KcpCallback output, out KCPSettings kcpSettings) + { + var kcp = new Kcp(conv, output, FANTASY_KCP_RESERVED_HEAD); + kcpSettings = KCPSettings.Create(networkTarget); + kcp.SetNoDelay(1, 5, 2, 1); + kcp.SetWindowSize(kcpSettings.SendWindowSize, kcpSettings.ReceiveWindowSize); + kcp.SetMtu(kcpSettings.Mtu); + kcp.SetMinrto(30); + return kcp; + } + + public static Kcp Create(KCPSettings kcpSettings, uint conv, KcpCallback output) + { + var kcp = new Kcp(conv, output, FANTASY_KCP_RESERVED_HEAD); + kcp.SetNoDelay(1, 5, 2, 1); + kcp.SetWindowSize(kcpSettings.SendWindowSize, kcpSettings.ReceiveWindowSize); + kcp.SetMtu(kcpSettings.Mtu); + kcp.SetMinrto(30); + return kcp; + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/KcpHeader.cs b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/KcpHeader.cs new file mode 100644 index 0000000..43338ab --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/KcpHeader.cs @@ -0,0 +1,14 @@ +namespace NBC.Network.KCP +#pragma warning disable CS1591 +{ + public enum KcpHeader : byte + { + None = 0x00, + RequestConnection = 0x01, + WaitConfirmConnection = 0x02, + ConfirmConnection = 0x03, + RepeatChannelId = 0x04, + ReceiveData = 0x06, + Disconnect = 0x07 + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByArrayPool.cs b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByArrayPool.cs new file mode 100644 index 0000000..0fb4e29 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByArrayPool.cs @@ -0,0 +1,575 @@ +// #if FANTASY_NET +// using System.Buffers; +// using System.Net; +// using System.Net.Sockets; +// using System.Runtime.CompilerServices; +// using System.Runtime.InteropServices; +// using Fantasy.Async; +// using Fantasy.DataStructure.Collection; +// using Fantasy.Entitas.Interface; +// using Fantasy.Helper; +// using Fantasy.Network.Interface; +// #pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +// +// // ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +// #pragma warning disable CS8604 // Possible null reference argument. +// #pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +// #pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +// #pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +// #pragma warning disable CS8602 // Dereference of a possibly null reference. +// +// #pragma warning disable CS8622 // Nullability of reference types in type of parameter doesn't match the target delegate (possibly because of nullability attributes). +// +// namespace Fantasy.Network.KCP +// { +// public sealed class KCPServerNetworkUpdateSystem : UpdateSystem +// { +// protected override void Update(KCPServerNetwork self) +// { +// self.Update(); +// } +// } +// +// public struct PendingConnection +// { +// public readonly uint ChannelId; +// public readonly uint TimeOutId; +// public readonly IPEndPoint RemoteEndPoint; +// +// public PendingConnection(uint channelId, IPEndPoint remoteEndPoint, uint time) +// { +// ChannelId = channelId; +// RemoteEndPoint = remoteEndPoint; +// TimeOutId = time + 10 * 1000; // 设置10秒超时，如果10秒内没有确认连接则删除。 +// } +// } +// +// public sealed class KCPServerNetwork : ANetwork +// { +// private Socket _socket; +// private Thread _thread; +// private long _startTime; +// private uint _updateMinTime; +// private uint _pendingMinTime; +// private bool _allowWraparound = true; +// +// private readonly byte[] _sendBuff = new byte[5]; +// private readonly List _pendingTimeOutTime = new List(); +// private readonly HashSet _updateChannels = new HashSet(); +// private readonly List _updateTimeOutTime = new List(); +// private readonly CancellationTokenSource _cancellationTokenSource = new CancellationTokenSource(); +// private readonly SortedOneToManyList _updateTimer = new SortedOneToManyList(); +// +// private readonly Dictionary _pendingConnection = new Dictionary(); +// private readonly SortedOneToManyList _pendingConnectionTimeOut = new SortedOneToManyList(); +// private readonly Dictionary _connectionChannel = new Dictionary(); +// +// public KCPSettings Settings { get; private set; } +// +// private uint TimeNow => (uint)(TimeHelper.Now - _startTime); +// +// public void Initialize(NetworkTarget networkTarget, IPEndPoint address) +// { +// _startTime = TimeHelper.Now; +// Settings = KCPSettings.Create(networkTarget); +// base.Initialize(NetworkType.Server, NetworkProtocolType.KCP, networkTarget); +// _socket = new Socket(address.AddressFamily, SocketType.Dgram, ProtocolType.Udp); +// _socket.Blocking = false; +// _socket.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.ReuseAddress, false); +// if (address.AddressFamily == AddressFamily.InterNetworkV6) +// { +// _socket.SetSocketOption(SocketOptionLevel.IPv6, SocketOptionName.IPv6Only, false); +// } +// +// _socket.Blocking = false; +// _socket.Bind(address); +// _socket.SetSocketBufferToOsLimit(); +// _socket.SetSioUdpConnReset(); +// _thread = new Thread(() => +// { +// ReceiveSocketAsync().Coroutine(); +// }); +// _thread.Start(); +// Log.Info($"SceneConfigId = {Scene.SceneConfigId} networkTarget = {networkTarget.ToString()} KCPServer Listen {address}"); +// } +// +// public override void Dispose() +// { +// if (IsDisposed) +// { +// return; +// } +// +// try +// { +// if (!_cancellationTokenSource.IsCancellationRequested) +// { +// try +// { +// _cancellationTokenSource.Cancel(); +// } +// catch (OperationCanceledException) +// { +// // 通常情况下，此处的异常可以忽略 +// } +// } +// +// foreach (var (_, channel) in _connectionChannel.ToArray()) +// { +// channel.Dispose(); +// } +// +// _connectionChannel.Clear(); +// _pendingConnection.Clear(); +// +// if (_socket != null) +// { +// _socket.Dispose(); +// _socket = null; +// } +// } +// catch (Exception e) +// { +// Log.Error(e); +// } +// finally +// { +// base.Dispose(); +// } +// } +// +// #region ReceiveSocket +// +// private const int BufferSize = 8192; +// private static readonly ArrayPool BufferPool = ArrayPool.Shared; +// private async FTask ReceiveSocketAsync() +// { +// var sceneThreadSynchronizationContext = Scene.ThreadSynchronizationContext; +// var remoteEndPoint = new IPEndPoint(IPAddress.Any, 0); +// +// while (!_cancellationTokenSource.IsCancellationRequested) +// { +// try +// { +// IPEndPoint receiveRemoteEndPoint = null; +// var buffer = BufferPool.Rent(BufferSize); +// var socketReceiveFromResult = await _socket.ReceiveFromAsync(buffer, SocketFlags.None, remoteEndPoint, _cancellationTokenSource.Token); +// var receivedBytes = socketReceiveFromResult.ReceivedBytes; +// +// switch (receivedBytes) +// { +// case 5: +// { +// switch ((KcpHeader)buffer[0]) +// { +// case KcpHeader.RequestConnection: +// case KcpHeader.ConfirmConnection: +// { +// receiveRemoteEndPoint = socketReceiveFromResult.RemoteEndPoint.Clone(); +// break; +// } +// } +// +// break; +// } +// case < 5: +// { +// continue; +// } +// } +// +// sceneThreadSynchronizationContext.Post(() => +// { +// ReceiveDataAsync(buffer, receivedBytes, receiveRemoteEndPoint); +// }); +// } +// catch (SocketException ex) +// { +// Log.Error($"Socket exception: {ex.Message}"); +// Dispose(); +// break; +// } +// catch (OperationCanceledException) +// { +// break; +// } +// catch (ObjectDisposedException) +// { +// Dispose(); +// break; +// } +// catch (Exception ex) +// { +// Log.Error($"Unexpected exception: {ex.Message}"); +// } +// } +// } +// +// #endregion +// +// #region ReceivePipeData +// +// private void ReceiveDataAsync(byte[] buffer, int receivedBytes, IPEndPoint remoteEndPoint) +// { +// try +// { +// var header = (KcpHeader)buffer[0]; +// var channelId = BitConverter.ToUInt32(buffer, 1); +// +// switch (header) +// { +// // 客户端请求建立KCP连接 +// case KcpHeader.RequestConnection: +// { +// if (_pendingConnection.TryGetValue(channelId, out var pendingConnection)) +// { +// if (!remoteEndPoint.IPEndPointEquals(pendingConnection.RemoteEndPoint)) +// { +// // 重复通道ID，向客户端发送重复通道ID消息 +// SendRepeatChannelId(ref channelId, remoteEndPoint); +// } +// +// break; +// } +// +// if (_connectionChannel.ContainsKey(channelId)) +// { +// // 已存在的通道ID，向客户端发送重复通道ID消息 +// SendRepeatChannelId(ref channelId, remoteEndPoint); +// break; +// } +// +// AddPendingConnection(ref channelId, remoteEndPoint); +// break; +// } +// // 客户端确认建立KCP连接 +// case KcpHeader.ConfirmConnection: +// { +// if (!ConfirmPendingConnection(ref channelId, remoteEndPoint)) +// { +// break; +// } +// +// AddConnection(ref channelId, remoteEndPoint); +// break; +// } +// // 接收KCP的数据 +// case KcpHeader.ReceiveData: +// { +// if (buffer.Length == 5) +// { +// Log.Warning($"KCP Server KcpHeader.Data buffer.Length == 5"); +// break; +// } +// +// if (_connectionChannel.TryGetValue(channelId, out var channel)) +// { +// channel.Input(buffer.AsMemory().Slice(5, receivedBytes - 5)); +// } +// +// break; +// } +// // 断开KCP连接 +// case KcpHeader.Disconnect: +// { +// // 断开不需要清楚PendingConnection让ClearPendingConnection自动清楚就可以了，并且不一定有Pending。 +// RemoveChannel(channelId); +// break; +// } +// } +// } +// finally +// { +// BufferPool.Return(buffer); +// } +// } +// +// #endregion +// +// #region Update +// +// public void Update() +// { +// var timeNow = TimeNow; +// _allowWraparound = timeNow < _updateMinTime; +// CheckUpdateTimerOut(ref timeNow); +// UpdateChannel(ref timeNow); +// PendingTimerOut(ref timeNow); +// _allowWraparound = true; +// } +// +// private void CheckUpdateTimerOut(ref uint nowTime) +// { +// if (_updateTimer.Count == 0) +// { +// return; +// } +// +// if (IsTimeGreaterThan(_updateMinTime, nowTime)) +// { +// return; +// } +// +// _updateTimeOutTime.Clear(); +// +// foreach (var kv in _updateTimer) +// { +// var timeId = kv.Key; +// +// if (IsTimeGreaterThan(timeId, nowTime)) +// { +// _updateMinTime = timeId; +// break; +// } +// +// _updateTimeOutTime.Add(timeId); +// } +// +// foreach (var timeId in _updateTimeOutTime) +// { +// foreach (var channelId in _updateTimer[timeId]) +// { +// _updateChannels.Add(channelId); +// } +// +// _updateTimer.RemoveKey(timeId); +// } +// } +// +// private void UpdateChannel(ref uint timeNow) +// { +// foreach (var channelId in _updateChannels) +// { +// if (!_connectionChannel.TryGetValue(channelId, out var channel)) +// { +// continue; +// } +// +// if (channel.IsDisposed) +// { +// _connectionChannel.Remove(channelId); +// continue; +// } +// +// channel.Kcp.Update(timeNow); +// AddUpdateChannel(channelId, channel.Kcp.Check(timeNow)); +// } +// +// _updateChannels.Clear(); +// } +// +// private void PendingTimerOut(ref uint timeNow) +// { +// if (_pendingConnectionTimeOut.Count == 0) +// { +// return; +// } +// +// if (IsTimeGreaterThan(_pendingMinTime, timeNow)) +// { +// return; +// } +// +// _pendingTimeOutTime.Clear(); +// +// foreach (var kv in _pendingConnectionTimeOut) +// { +// var timeId = kv.Key; +// +// if (IsTimeGreaterThan(timeId, timeNow)) +// { +// _pendingMinTime = timeId; +// break; +// } +// +// _pendingTimeOutTime.Add(timeId); +// } +// +// foreach (var timeId in _pendingTimeOutTime) +// { +// foreach (var channelId in _pendingConnectionTimeOut[timeId]) +// { +// _pendingConnection.Remove(channelId); +// } +// +// _pendingConnectionTimeOut.RemoveKey(timeId); +// } +// } +// +// public void AddUpdateChannel(uint channelId, uint tillTime) +// { +// if (tillTime == 0) +// { +// _updateChannels.Add(channelId); +// return; +// } +// +// if (IsTimeGreaterThan(_updateMinTime, tillTime)) +// { +// _updateMinTime = tillTime; +// } +// +// _updateTimer.Add(tillTime, channelId); +// } +// +// private const uint HalfMaxUint = uint.MaxValue / 2; +// +// [MethodImpl(MethodImplOptions.AggressiveInlining)] +// private bool IsTimeGreaterThan(uint timeId, uint nowTime) +// { +// if (!_allowWraparound) +// { +// return timeId > nowTime; +// } +// +// var diff = timeId - nowTime; +// // 如果 diff 的值在 [0, HalfMaxUint] 范围内，说明 timeId 是在 nowTime 之后或相等。 +// // 如果 diff 的值在 (HalfMaxUint, uint.MaxValue] 范围内，说明 timeId 是在 nowTime 之前（时间回绕的情况）。 +// return diff < HalfMaxUint || diff == HalfMaxUint; +// } +// +// #endregion +// +// #region Pending +// +// private void AddPendingConnection(ref uint channelId, IPEndPoint ipEndPoint) +// { +// var now = TimeNow; +// var pendingConnection = new PendingConnection(channelId, ipEndPoint, now); +// +// if (IsTimeGreaterThan(_pendingMinTime, pendingConnection.TimeOutId) || _pendingMinTime == 0) +// { +// _pendingMinTime = pendingConnection.TimeOutId; +// } +// +// _pendingConnection.Add(channelId, pendingConnection); +// _pendingConnectionTimeOut.Add(pendingConnection.TimeOutId, channelId); +// SendWaitConfirmConnection(ref channelId, ipEndPoint); +// } +// +// private bool ConfirmPendingConnection(ref uint channelId, EndPoint ipEndPoint) +// { +// if (!_pendingConnection.TryGetValue(channelId, out var pendingConnection)) +// { +// return false; +// } +// +// if (!ipEndPoint.IPEndPointEquals(pendingConnection.RemoteEndPoint)) +// { +// Log.Error($"KCPSocket syn address diff: {channelId} {pendingConnection.RemoteEndPoint} {ipEndPoint}"); +// return false; +// } +// +// _pendingConnection.Remove(channelId); +// _pendingConnectionTimeOut.RemoveValue(pendingConnection.TimeOutId, pendingConnection.ChannelId); +// #if FANTASY_DEVELOP +// Log.Debug($"KCPSocket _pendingConnection:{_pendingConnection.Count} _pendingConnectionTimer:{_pendingConnectionTimeOut.Count}"); +// #endif +// return true; +// } +// +// #endregion +// +// #region Connection +// +// private void AddConnection(ref uint channelId, IPEndPoint ipEndPoint) +// { +// var eventArgs = new KCPServerNetworkChannel(this, channelId, ipEndPoint); +// _connectionChannel.Add(channelId, eventArgs); +// #if FANTASY_DEVELOP +// Log.Debug($"AddConnection _connectionChannel:{_connectionChannel.Count()}"); +// #endif +// } +// +// public override void RemoveChannel(uint channelId) +// { +// if (!_connectionChannel.Remove(channelId, out var channel)) +// { +// return; +// } +// +// if (!channel.IsDisposed) +// { +// SendDisconnect(ref channelId, channel.RemoteEndPoint); +// channel.Dispose(); +// } +// #if FANTASY_DEVELOP +// Log.Debug($"RemoveChannel _connectionChannel:{_connectionChannel.Count()}"); +// #endif +// } +// +// #endregion +// +// #region Send +// +// private const byte KcpHeaderDisconnect = (byte)KcpHeader.Disconnect; +// private const byte KcpHeaderRepeatChannelId = (byte)KcpHeader.RepeatChannelId; +// private const byte KcpHeaderWaitConfirmConnection = (byte)KcpHeader.WaitConfirmConnection; +// +// private unsafe void SendDisconnect(ref uint channelId, EndPoint clientEndPoint) +// { +// fixed (byte* p = _sendBuff) +// { +// p[0] = KcpHeaderDisconnect; +// *(uint*)(p + 1) = channelId; +// } +// +// SendAsync(_sendBuff, 0, 5, clientEndPoint); +// } +// +// private unsafe void SendRepeatChannelId(ref uint channelId, EndPoint clientEndPoint) +// { +// fixed (byte* p = _sendBuff) +// { +// p[0] = KcpHeaderRepeatChannelId; +// *(uint*)(p + 1) = channelId; +// } +// +// SendAsync(_sendBuff, 0, 5, clientEndPoint); +// } +// +// private unsafe void SendWaitConfirmConnection(ref uint channelId, EndPoint clientEndPoint) +// { +// fixed (byte* p = _sendBuff) +// { +// p[0] = KcpHeaderWaitConfirmConnection; +// *(uint*)(p + 1) = channelId; +// } +// +// SendAsync(_sendBuff, 0, 5, clientEndPoint); +// } +// +// [MethodImpl(MethodImplOptions.AggressiveInlining)] +// public void SendAsync(byte[] buffer, int offset, int count, EndPoint endPoint) +// { +// try +// { +// _socket.SendTo(new ArraySegment(buffer, offset, count), SocketFlags.None, endPoint); +// } +// catch (ArgumentException ex) +// { +// Log.Error($"ArgumentException: {ex.Message}"); // 处理参数错误 +// } +// catch (SocketException) +// { +// //Log.Error($"SocketException: {ex.Message}"); // 处理网络错误 +// } +// catch (ObjectDisposedException) +// { +// // 处理套接字已关闭的情况 +// } +// catch (InvalidOperationException ex) +// { +// Log.Error($"InvalidOperationException: {ex.Message}"); // 处理无效操作 +// } +// catch (Exception ex) +// { +// Log.Error($"Exception: {ex.Message}"); // 捕获其他异常 +// } +// } +// +// #endregion +// } +// } +// +// #endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByArrayPool.cs.meta b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByArrayPool.cs.meta new file mode 100644 index 0000000..e5389dc --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByArrayPool.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 039dc040fe04142f99a246629d6c2e0d +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByPipe.cs b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByPipe.cs new file mode 100644 index 0000000..54b550d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByPipe.cs @@ -0,0 +1,619 @@ +#if FANTASY_NET +using System.Buffers; +using System.IO.Pipelines; +using System.Net; +using System.Net.Sockets; +using System.Runtime.CompilerServices; +using System.Runtime.InteropServices; +using Fantasy.Async; +using Fantasy.DataStructure.Collection; +using Fantasy.Entitas.Interface; +using Fantasy.Helper; +using Fantasy.Network.Interface; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8604 // Possible null reference argument. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8602 // Dereference of a possibly null reference. + +#pragma warning disable CS8622 // Nullability of reference types in type of parameter doesn't match the target delegate (possibly because of nullability attributes). + +namespace Fantasy.Network.KCP +{ + public sealed class KCPServerNetworkUpdateSystem : UpdateSystem + { + protected override void Update(KCPServerNetwork self) + { + self.Update(); + } + } + + public struct PendingConnection + { + public readonly uint ChannelId; + public readonly uint TimeOutId; + public readonly IPEndPoint RemoteEndPoint; + + public PendingConnection(uint channelId, IPEndPoint remoteEndPoint, uint time) + { + ChannelId = channelId; + RemoteEndPoint = remoteEndPoint; + TimeOutId = time + 10 * 1000; // 设置10秒超时，如果10秒内没有确认连接则删除。 + } + } + + public sealed class KCPServerNetwork : ANetwork + { + private Socket _socket; + private long _startTime; + private uint _updateMinTime; + private uint _pendingMinTime; + private bool _allowWraparound = true; + private readonly Pipe _pipe = new Pipe(); + private readonly byte[] _sendBuff = new byte[5]; + private readonly List _pendingTimeOutTime = new List(); + private readonly HashSet _updateChannels = new HashSet(); + private readonly List _updateTimeOutTime = new List(); + private readonly Queue _endPoint = new Queue(); + private readonly CancellationTokenSource _cancellationTokenSource = new CancellationTokenSource(); + private readonly SortedOneToManyList _updateTimer = new SortedOneToManyList(); + + private readonly Dictionary _pendingConnection = new Dictionary(); + private readonly SortedOneToManyList _pendingConnectionTimeOut = new SortedOneToManyList(); + private readonly Dictionary _connectionChannel = new Dictionary(); + + public KCPSettings Settings { get; private set; } + + private uint TimeNow => (uint)(TimeHelper.Now - _startTime); + + public void Initialize(NetworkTarget networkTarget, IPEndPoint address) + { + _startTime = TimeHelper.Now; + Settings = KCPSettings.Create(networkTarget); + base.Initialize(NetworkType.Server, NetworkProtocolType.KCP, networkTarget); + _socket = new Socket(address.AddressFamily, SocketType.Dgram, ProtocolType.Udp); + _socket.Blocking = false; + _socket.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.ReuseAddress, false); + if (address.AddressFamily == AddressFamily.InterNetworkV6) + { + _socket.SetSocketOption(SocketOptionLevel.IPv6, SocketOptionName.IPv6Only, false); + } + + _socket.Blocking = false; + _socket.Bind(address); + _socket.SetSocketBufferToOsLimit(); + _socket.SetSioUdpConnReset(); + ReadPipeDataAsync().Coroutine(); + ReceiveSocketAsync().Coroutine(); + Log.Info($"SceneConfigId = {Scene.SceneConfigId} networkTarget = {networkTarget.ToString()} KCPServer Listen {address}"); + } + + public override void Dispose() + { + if (IsDisposed) + { + return; + } + + if (!_cancellationTokenSource.IsCancellationRequested) + { + try + { + _cancellationTokenSource.Cancel(); + } + catch (OperationCanceledException) + { + // 通常情况下，此处的异常可以忽略 + } + } + + foreach (var (_, channel) in _connectionChannel.ToArray()) + { + channel.Dispose(); + } + + _connectionChannel.Clear(); + _pendingConnection.Clear(); + + if (_socket != null) + { + _socket.Dispose(); + _socket = null; + } + + base.Dispose(); + } + + #region ReceiveSocket + + private async FTask ReceiveSocketAsync() + { + EndPoint remoteEndPoint = new IPEndPoint(IPAddress.Any, 0); + + while (!_cancellationTokenSource.IsCancellationRequested) + { + try + { + var memory = _pipe.Writer.GetMemory(8192); + var socketReceiveFromResult = await _socket.ReceiveFromAsync(memory, SocketFlags.None, remoteEndPoint, _cancellationTokenSource.Token); + var receivedBytes = socketReceiveFromResult.ReceivedBytes; + + if (receivedBytes == 5) + { + switch ((KcpHeader)memory.Span[0]) + { + case KcpHeader.RequestConnection: + case KcpHeader.ConfirmConnection: + { + _endPoint.Enqueue(socketReceiveFromResult.RemoteEndPoint.Clone()); + break; + } + } + } + + _pipe.Writer.Advance(receivedBytes); + await _pipe.Writer.FlushAsync(); + } + catch (SocketException ex) + { + Log.Error($"Socket exception: {ex.Message}"); + Dispose(); + break; + } + catch (OperationCanceledException) + { + break; + } + catch (ObjectDisposedException) + { + Dispose(); + break; + } + catch (Exception ex) + { + Log.Error($"Unexpected exception: {ex.Message}"); + } + } + + await _pipe.Writer.CompleteAsync(); + } + + #endregion + + #region ReceivePipeData + + private async FTask ReadPipeDataAsync() + { + var pipeReader = _pipe.Reader; + while (!_cancellationTokenSource.IsCancellationRequested) + { + ReadResult result = default; + + try + { + result = await pipeReader.ReadAsync(_cancellationTokenSource.Token); + } + catch (OperationCanceledException) + { + // 出现这个异常表示取消了_cancellationTokenSource。一般Channel断开会取消。 + break; + } + + var buffer = result.Buffer; + var consumed = buffer.Start; + var examined = buffer.End; + + while (TryReadMessage(ref buffer, out var header, out var channelId, out var message)) + { + ReceiveData(ref header, ref channelId, ref message); + consumed = buffer.Start; + } + + if (result.IsCompleted) + { + break; + } + + pipeReader.AdvanceTo(consumed, examined); + } + + await pipeReader.CompleteAsync(); + } + + private unsafe bool TryReadMessage(ref ReadOnlySequence buffer, out KcpHeader header, out uint channelId, out ReadOnlyMemory message) + { + if (buffer.Length < 5) + { + channelId = 0; + message = default; + header = KcpHeader.None; + if (buffer.Length > 0) + { + buffer = buffer.Slice(buffer.Length); + } + return false; + } + + var readOnlyMemory = buffer.First; + + if (MemoryMarshal.TryGetArray(readOnlyMemory, out var arraySegment)) + { + fixed (byte* bytePointer = &arraySegment.Array[arraySegment.Offset]) + { + header = (KcpHeader)bytePointer[0]; + channelId = Unsafe.ReadUnaligned(ref bytePointer[1]); + } + } + else + { + // 如果无法获取数组段，回退到安全代码来执行。这种情况几乎不会发生、为了保险还是写一下了。 + var firstSpan = readOnlyMemory.Span; + header = (KcpHeader)firstSpan[0]; + channelId = MemoryMarshal.Read(firstSpan.Slice(1, 4)); + } + + message = readOnlyMemory.Slice(5); + buffer = buffer.Slice(readOnlyMemory.Length); + return true; + } + + private void ReceiveData(ref KcpHeader header, ref uint channelId, ref ReadOnlyMemory buffer) + { + switch (header) + { + // 客户端请求建立KCP连接 + case KcpHeader.RequestConnection: + { + _endPoint.TryDequeue(out var ipEndPoint); + + if (_pendingConnection.TryGetValue(channelId, out var pendingConnection)) + { + if (!ipEndPoint.IPEndPointEquals(pendingConnection.RemoteEndPoint)) + { + // 重复通道ID，向客户端发送重复通道ID消息 + SendRepeatChannelId(ref channelId, ipEndPoint); + } + + break; + } + + if (_connectionChannel.ContainsKey(channelId)) + { + // 已存在的通道ID，向客户端发送重复通道ID消息 + SendRepeatChannelId(ref channelId, ipEndPoint); + break; + } + + AddPendingConnection(ref channelId, ipEndPoint); + break; + } + // 客户端确认建立KCP连接 + case KcpHeader.ConfirmConnection: + { + _endPoint.TryDequeue(out var ipEndPoint); + if (!ConfirmPendingConnection(ref channelId, ipEndPoint)) + { + break; + } + + AddConnection(ref channelId, ipEndPoint.Clone()); + break; + } + // 接收KCP的数据 + case KcpHeader.ReceiveData: + { + if (buffer.Length == 5) + { + Log.Warning($"KCP Server KcpHeader.Data buffer.Length == 5"); + break; + } + + if (_connectionChannel.TryGetValue(channelId, out var channel)) + { + channel.Input(buffer); + } + + break; + } + // 断开KCP连接 + case KcpHeader.Disconnect: + { + // 断开不需要清楚PendingConnection让ClearPendingConnection自动清楚就可以了，并且不一定有Pending。 + RemoveChannel(channelId); + break; + } + } + } + + #endregion + + #region Update + + public void Update() + { + var timeNow = TimeNow; + _allowWraparound = timeNow < _updateMinTime; + CheckUpdateTimerOut(ref timeNow); + UpdateChannel(ref timeNow); + PendingTimerOut(ref timeNow); + _allowWraparound = true; + } + + private void CheckUpdateTimerOut(ref uint nowTime) + { + if (_updateTimer.Count == 0) + { + return; + } + + if (IsTimeGreaterThan(_updateMinTime, nowTime)) + { + return; + } + + _updateTimeOutTime.Clear(); + + foreach (var kv in _updateTimer) + { + var timeId = kv.Key; + + if (IsTimeGreaterThan(timeId, nowTime)) + { + _updateMinTime = timeId; + break; + } + + _updateTimeOutTime.Add(timeId); + } + + foreach (var timeId in _updateTimeOutTime) + { + foreach (var channelId in _updateTimer[timeId]) + { + _updateChannels.Add(channelId); + } + + _updateTimer.RemoveKey(timeId); + } + } + + private void UpdateChannel(ref uint timeNow) + { + foreach (var channelId in _updateChannels) + { + if (!_connectionChannel.TryGetValue(channelId, out var channel)) + { + continue; + } + + if (channel.IsDisposed) + { + _connectionChannel.Remove(channelId); + continue; + } + + channel.Kcp.Update(timeNow); + AddUpdateChannel(channelId, channel.Kcp.Check(timeNow)); + } + + _updateChannels.Clear(); + } + + private void PendingTimerOut(ref uint timeNow) + { + if (_pendingConnectionTimeOut.Count == 0) + { + return; + } + + if (IsTimeGreaterThan(_pendingMinTime, timeNow)) + { + return; + } + + _pendingTimeOutTime.Clear(); + + foreach (var kv in _pendingConnectionTimeOut) + { + var timeId = kv.Key; + + if (IsTimeGreaterThan(timeId, timeNow)) + { + _pendingMinTime = timeId; + break; + } + + _pendingTimeOutTime.Add(timeId); + } + + foreach (var timeId in _pendingTimeOutTime) + { + foreach (var channelId in _pendingConnectionTimeOut[timeId]) + { + _pendingConnection.Remove(channelId); + } + + _pendingConnectionTimeOut.RemoveKey(timeId); + } + } + + public void AddUpdateChannel(uint channelId, uint tillTime) + { + if (tillTime == 0) + { + _updateChannels.Add(channelId); + return; + } + + if (IsTimeGreaterThan(_updateMinTime, tillTime)) + { + _updateMinTime = tillTime; + } + + _updateTimer.Add(tillTime, channelId); + } + + private const uint HalfMaxUint = uint.MaxValue / 2; + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private bool IsTimeGreaterThan(uint timeId, uint nowTime) + { + if (!_allowWraparound) + { + return timeId > nowTime; + } + + var diff = timeId - nowTime; + // 如果 diff 的值在 [0, HalfMaxUint] 范围内，说明 timeId 是在 nowTime 之后或相等。 + // 如果 diff 的值在 (HalfMaxUint, uint.MaxValue] 范围内，说明 timeId 是在 nowTime 之前（时间回绕的情况）。 + return diff < HalfMaxUint || diff == HalfMaxUint; + } + + #endregion + + #region Pending + + private void AddPendingConnection(ref uint channelId, IPEndPoint ipEndPoint) + { + var now = TimeNow; + var pendingConnection = new PendingConnection(channelId, ipEndPoint, now); + + if (IsTimeGreaterThan(_pendingMinTime, pendingConnection.TimeOutId) || _pendingMinTime == 0) + { + _pendingMinTime = pendingConnection.TimeOutId; + } + + _pendingConnection.Add(channelId, pendingConnection); + _pendingConnectionTimeOut.Add(pendingConnection.TimeOutId, channelId); + SendWaitConfirmConnection(ref channelId, ipEndPoint); + } + + private bool ConfirmPendingConnection(ref uint channelId, EndPoint ipEndPoint) + { + if (!_pendingConnection.TryGetValue(channelId, out var pendingConnection)) + { + return false; + } + + if (!ipEndPoint.IPEndPointEquals(pendingConnection.RemoteEndPoint)) + { + Log.Error($"KCPSocket syn address diff: {channelId} {pendingConnection.RemoteEndPoint} {ipEndPoint}"); + return false; + } + + _pendingConnection.Remove(channelId); + _pendingConnectionTimeOut.RemoveValue(pendingConnection.TimeOutId, pendingConnection.ChannelId); +#if FANTASY_DEVELOP + Log.Debug($"KCPSocket _pendingConnection:{_pendingConnection.Count} _pendingConnectionTimer:{_pendingConnectionTimeOut.Count}"); +#endif + return true; + } + + #endregion + + #region Connection + + private void AddConnection(ref uint channelId, IPEndPoint ipEndPoint) + { + var eventArgs = new KCPServerNetworkChannel(this, channelId, ipEndPoint); + _connectionChannel.Add(channelId, eventArgs); +#if FANTASY_DEVELOP + Log.Debug($"AddConnection _connectionChannel:{_connectionChannel.Count()}"); +#endif + } + + public override void RemoveChannel(uint channelId) + { + if (!_connectionChannel.Remove(channelId, out var channel)) + { + return; + } + + if (!channel.IsDisposed) + { + SendDisconnect(ref channelId, channel.RemoteEndPoint); + channel.Dispose(); + } +#if FANTASY_DEVELOP + Log.Debug($"RemoveChannel _connectionChannel:{_connectionChannel.Count()}"); +#endif + } + + #endregion + + #region Send + + private const byte KcpHeaderDisconnect = (byte)KcpHeader.Disconnect; + private const byte KcpHeaderRepeatChannelId = (byte)KcpHeader.RepeatChannelId; + private const byte KcpHeaderWaitConfirmConnection = (byte)KcpHeader.WaitConfirmConnection; + + private unsafe void SendDisconnect(ref uint channelId, EndPoint clientEndPoint) + { + fixed (byte* p = _sendBuff) + { + p[0] = KcpHeaderDisconnect; + *(uint*)(p + 1) = channelId; + } + + SendAsync(_sendBuff, 0, 5, clientEndPoint); + } + + private unsafe void SendRepeatChannelId(ref uint channelId, EndPoint clientEndPoint) + { + fixed (byte* p = _sendBuff) + { + p[0] = KcpHeaderRepeatChannelId; + *(uint*)(p + 1) = channelId; + } + + SendAsync(_sendBuff, 0, 5, clientEndPoint); + } + + private unsafe void SendWaitConfirmConnection(ref uint channelId, EndPoint clientEndPoint) + { + fixed (byte* p = _sendBuff) + { + p[0] = KcpHeaderWaitConfirmConnection; + *(uint*)(p + 1) = channelId; + } + + SendAsync(_sendBuff, 0, 5, clientEndPoint); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SendAsync(byte[] buffer, int offset, int count, EndPoint endPoint) + { + try + { + _socket.SendTo(new ArraySegment(buffer, offset, count), SocketFlags.None, endPoint); + } + catch (ArgumentException ex) + { + Log.Error($"ArgumentException: {ex.Message}"); // 处理参数错误 + } + catch (SocketException) + { + //Log.Error($"SocketException: {ex.Message}"); // 处理网络错误 + } + catch (ObjectDisposedException) + { + // 处理套接字已关闭的情况 + } + catch (InvalidOperationException ex) + { + Log.Error($"InvalidOperationException: {ex.Message}"); // 处理无效操作 + } + catch (Exception ex) + { + Log.Error($"Exception: {ex.Message}"); // 捕获其他异常 + } + } + + #endregion + } +} + +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByPipe.cs.meta b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByPipe.cs.meta new file mode 100644 index 0000000..e8d5283 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkByPipe.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 6649471da39384f85b3ade8aca364fb1 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkChannel.cs b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkChannel.cs new file mode 100644 index 0000000..19db7a7 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkChannel.cs @@ -0,0 +1,165 @@ +#if FANTASY_NET +using System.Net; +using System.Net.Sockets; +using System.Runtime.CompilerServices; +using Fantasy.Helper; +using Fantasy.Network.Interface; +using Fantasy.PacketParser; +using Fantasy.Serialize; +using KCP; +// ReSharper disable ParameterHidesMember +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace Fantasy.Network.KCP +{ + /// + /// KCP 服务器网络通道，用于处理服务器与客户端之间的数据通信。 + /// + public class KCPServerNetworkChannel : ANetworkServerChannel + { + private bool _isInnerDispose; + private readonly int _maxSndWnd; + private KCPServerNetwork _kcpServerNetwork; + private readonly BufferPacketParser _packetParser; + private readonly byte[] _receiveBuffer = new byte[Packet.PacketBodyMaxLength + 20]; + public Kcp Kcp { get; private set; } + public uint ChannelId { get; private set; } + + public KCPServerNetworkChannel(KCPServerNetwork network, uint channelId, IPEndPoint ipEndPoint) : base(network, channelId, ipEndPoint) + { + _kcpServerNetwork = network; + ChannelId = channelId; + _maxSndWnd = network.Settings.MaxSendWindowSize; + Kcp = KCPFactory.Create(network.Settings, ChannelId, KcpSpanCallback); + _packetParser = PacketParserFactory.CreateServerBufferPacket(network); + } + + public override void Dispose() + { + if (IsDisposed || _isInnerDispose) + { + return; + } + + try + { + _isInnerDispose = true; + _kcpServerNetwork.RemoveChannel(Id); + IsDisposed = true; + Kcp.Dispose(); + Kcp = null; + ChannelId = 0; + _kcpServerNetwork = null; + } + catch (Exception e) + { + Log.Error(e); + } + finally + { + base.Dispose(); + } + } + + public void Input(ReadOnlyMemory buffer) + { + Kcp.Input(buffer.Span); + _kcpServerNetwork.AddUpdateChannel(ChannelId, 0); + + while (!IsDisposed) + { + try + { + var peekSize = Kcp.PeekSize(); + + if (peekSize < 0) + { + return; + } + + var receiveCount = Kcp.Receive(_receiveBuffer.AsSpan(0, peekSize)); + + if (receiveCount != peekSize) + { + return; + } + + if (!_packetParser.UnPack(_receiveBuffer, ref receiveCount, out var packInfo)) + { + continue; + } + + Session.Receive(packInfo); + } + catch (ScanException e) + { + Log.Debug($"RemoteAddress:{RemoteEndPoint} \n{e}"); + Dispose(); + } + catch (Exception e) + { + Log.Error(e); + } + } + } + + public override void Send(uint rpcId, long routeId, MemoryStreamBuffer memoryStream, IMessage message) + { + if (IsDisposed) + { + return; + } + + if (Kcp.WaitSendCount > _maxSndWnd) + { + // 检查等待发送的消息，如果超出两倍窗口大小，KCP作者给的建议是要断开连接 + Log.Warning($"ERR_KcpWaitSendSizeTooLarge {Kcp.WaitSendCount} > {_maxSndWnd}"); + Dispose(); + return; + } + + var buffer = _packetParser.Pack(ref rpcId, ref routeId, memoryStream, message); + Kcp.Send(buffer.GetBuffer().AsSpan(0, (int)buffer.Position)); + + if (buffer.MemoryStreamBufferSource == MemoryStreamBufferSource.Pack) + { + _kcpServerNetwork.MemoryStreamBufferPool.ReturnMemoryStream(buffer); + } + + _kcpServerNetwork.AddUpdateChannel(ChannelId, 0); + } + + private const byte KcpHeaderReceiveData = (byte)KcpHeader.ReceiveData; + + private unsafe void KcpSpanCallback(byte[] buffer, int count) + { + if (IsDisposed) + { + return; + } + + try + { + if (count == 0) + { + throw new Exception("KcpOutput count 0"); + } + + fixed (byte* p = buffer) + { + p[0] = KcpHeaderReceiveData; + *(uint*)(p + 1) = ChannelId; + } + + _kcpServerNetwork.SendAsync(buffer, 0, count + 5, RemoteEndPoint); + } + catch (Exception e) + { + Log.Error(e); + } + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkChannel.cs.meta b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkChannel.cs.meta new file mode 100644 index 0000000..7f81dae --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/KCP/Server/KCPServerNetworkChannel.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a8056a8265742483686fb10fb351d108 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/NetworkProtocolFactory.cs b/FantasyNetTest/NBC/Core/Network/Protocol/NetworkProtocolFactory.cs new file mode 100644 index 0000000..eb5ed52 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/NetworkProtocolFactory.cs @@ -0,0 +1,86 @@ +using System; +using System.Net; +using NBC.Helper; +#if !FANTASY_WEBGL +#endif + +using NBC.Entitas; +using NBC.Network.Interface; +using NBC.Network.KCP; +using NBC.Network.TCP; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.Network +{ + internal static class NetworkProtocolFactory + { +#if FANTASY_NET + public static ANetwork CreateServer(Scene scene, NetworkProtocolType protocolType, NetworkTarget networkTarget, string bindIp, int port) + { + switch (protocolType) + { + case NetworkProtocolType.TCP: + { + var network = Entity.Create(scene, false, false); + var address = NetworkHelper.ToIPEndPoint(bindIp, port); + network.Initialize(networkTarget, address); + return network; + } + case NetworkProtocolType.KCP: + { + var network = Entity.Create(scene, false, true); + var address = NetworkHelper.ToIPEndPoint(bindIp, port); + network.Initialize(networkTarget, address); + return network; + } + case NetworkProtocolType.WebSocket: + { + var network = Entity.Create(scene, false, true); + network.Initialize(networkTarget, bindIp, port); + return network; + } + case NetworkProtocolType.HTTP: + { + var network = Entity.Create(scene, false, true); + network.Initialize(networkTarget, bindIp, port); + return network; + } + default: + { + throw new NotSupportedException($"Unsupported NetworkProtocolType:{protocolType}"); + } + } + } +#endif + public static AClientNetwork CreateClient(Scene scene, NetworkProtocolType protocolType, NetworkTarget networkTarget) + { +#if !FANTASY_WEBGL + switch (protocolType) + { + case NetworkProtocolType.TCP: + { + var network = Entity.Create(scene, false, false); + network.Initialize(networkTarget); + return network; + } + case NetworkProtocolType.KCP: + { + var network = Entity.Create(scene, false, true); + network.Initialize(networkTarget); + return network; + } + default: + { + throw new NotSupportedException($"Unsupported NetworkProtocolType:{protocolType}"); + } + } +#else + // Webgl平台只能用这个协议。 + var network = Entity.Create(scene, false, true); + network.Initialize(networkTarget); + return network; +#endif + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/NetworkProtocolType.cs b/FantasyNetTest/NBC/Core/Network/Protocol/NetworkProtocolType.cs new file mode 100644 index 0000000..23ceec0 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/NetworkProtocolType.cs @@ -0,0 +1,69 @@ +namespace NBC.Network +{ + /// + /// 网络服务器类型 + /// + public enum NetworkType + { + /// + /// 默认 + /// + None = 0, + /// + /// 客户端网络 + /// + Client = 1, +#if FANTASY_NET + /// + /// 服务器网络 + /// + Server = 2 +#endif + } + /// + /// 网络服务的目标 + /// + public enum NetworkTarget + { + /// + /// 默认 + /// + None = 0, + /// + /// 对外 + /// + Outer = 1, +#if FANTASY_NET + /// + /// 对内 + /// + Inner = 2 +#endif + } + /// + /// 支持的网络协议 + /// + public enum NetworkProtocolType + { + /// + /// 默认 + /// + None = 0, + /// + /// KCP + /// + KCP = 1, + /// + /// TCP + /// + TCP = 2, + /// + /// WebSocket + /// + WebSocket = 3, + /// + /// HTTP + /// + HTTP = 4, + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/NetworkThreadComponent.cs b/FantasyNetTest/NBC/Core/Network/Protocol/NetworkThreadComponent.cs new file mode 100644 index 0000000..bbfb7dc --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/NetworkThreadComponent.cs @@ -0,0 +1,101 @@ +#if !FANTASY_WEBGL +using System; +using System.Collections.Generic; +using System.Threading; +using NBC.Entitas; + +// ReSharper disable ForCanBeConvertedToForeach +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. + +namespace NBC.Network +{ + internal interface INetworkThreadUpdate + { + void Update(); + } + + /// + /// 网络线程组件 + /// + internal sealed class NetworkThreadComponent : Entity + { + private Thread _netWorkThread; + internal ThreadSynchronizationContext SynchronizationContext { get; private set; } + private readonly List _updates = new List(); + + internal NetworkThreadComponent Initialize() + { + SynchronizationContext = new ThreadSynchronizationContext(); + _netWorkThread = new Thread(Update) + { + IsBackground = true + }; + _netWorkThread.Start(); + return this; + } + + public override void Dispose() + { + if (IsDisposed) + { + return; + } + + SynchronizationContext.Post(() => + { + _updates.Clear(); + _netWorkThread.Join(); + _netWorkThread = null; + SynchronizationContext = null; + }); + + base.Dispose(); + } + + private void Update() + { + // 将同步上下文设置为网络线程的上下文，以确保操作在正确的线程上下文中执行。 + System.Threading.SynchronizationContext.SetSynchronizationContext(SynchronizationContext); + // 循环执行 + while (!IsDisposed) + { + for (var i = 0; i < _updates.Count; i++) + { + try + { + _updates[i].Update(); + } + catch (Exception e) + { + Log.Error(e); + } + } + SynchronizationContext.Update(); + Thread.Sleep(1); + } + } + + internal void AddNetworkThreadUpdate(INetworkThreadUpdate update) + { + SynchronizationContext.Post(() => + { + if (_updates.Contains(update)) + { + Log.Warning($"{update.GetType().FullName} Network thread update is already running"); + return; + } + _updates.Add(update); + }); + } + + internal void RemoveNetworkThreadUpdate(INetworkThreadUpdate update) + { + SynchronizationContext.Post(() => + { + _updates.Remove(update); + }); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client.meta b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client.meta new file mode 100644 index 0000000..9b97822 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 637e4cf1e0eb049efb57f91f75d645e7 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client/TCPClientNetwork.cs b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client/TCPClientNetwork.cs new file mode 100644 index 0000000..1d69e56 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client/TCPClientNetwork.cs @@ -0,0 +1,412 @@ +using System; +using System.Buffers; +using System.Collections.Generic; +using System.IO; +using System.IO.Pipelines; +using System.Net; +using System.Net.Sockets; +using System.Runtime.InteropServices; +using System.Threading; +using NBC.Async; +using NBC.Helper; +using NBC.Network.Interface; +using NBC.PacketParser; +using NBC.Serialize; + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8604 // Possible null reference argument. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8622 // Nullability of reference types in type of parameter doesn't match the target delegate (possibly because of nullability attributes). + +namespace NBC.Network.TCP +{ + public sealed class TCPClientNetwork : AClientNetwork + { + private bool _isSending; + private bool _isInnerDispose; + private long _connectTimeoutId; + private Socket _socket; + private IPEndPoint _remoteEndPoint; + private SocketAsyncEventArgs _sendArgs; + private ReadOnlyMemoryPacketParser _packetParser; + private readonly Pipe _pipe = new Pipe(); + private readonly Queue _sendBuffers = new Queue(); + private readonly CancellationTokenSource _cancellationTokenSource = new CancellationTokenSource(); + + private Action _onConnectFail; + private Action _onConnectComplete; + private Action _onConnectDisconnect; + + public uint ChannelId { get; private set; } + + public void Initialize(NetworkTarget networkTarget) + { + base.Initialize(NetworkType.Client, NetworkProtocolType.TCP, networkTarget); + } + + public override void Dispose() + { + if (IsDisposed || _isInnerDispose) + { + return; + } + + try + { + _isSending = false; + _isInnerDispose = true; + ClearConnectTimeout(); + + if (!_cancellationTokenSource.IsCancellationRequested) + { + try + { + _cancellationTokenSource.Cancel(); + } + catch (OperationCanceledException) + { + // 通常情况下，此处的异常可以忽略 + } + } + + _onConnectDisconnect?.Invoke(); + + if (_socket.Connected) + { + _socket.Close(); + _socket = null; + } + + _sendBuffers.Clear(); + _packetParser?.Dispose(); + ChannelId = 0; + _sendArgs = null; + } + catch (Exception e) + { + Log.Error(e); + } + finally + { + base.Dispose(); + } + } + + /// + /// 连接到远程服务器。 + /// + /// 远程服务器的终端点。 + /// 连接成功时的回调。 + /// 连接失败时的回调。 + /// 连接断开时的回调。 + /// + /// 连接超时时间，单位：毫秒。 + /// 连接的会话。 + public override Session Connect(string remoteAddress, Action onConnectComplete, Action onConnectFail, Action onConnectDisconnect, bool isHttps, int connectTimeout = 5000) + { + // 如果已经初始化过一次，抛出异常，要求重新实例化 + + if (IsInit) + { + throw new NotSupportedException("TCPClientNetwork Has already been initialized. If you want to call Connect again, please re instantiate it."); + } + + IsInit = true; + _isSending = false; + _onConnectFail = onConnectFail; + _onConnectComplete = onConnectComplete; + _onConnectDisconnect = onConnectDisconnect; + // 设置连接超时定时器 + _connectTimeoutId = Scene.TimerComponent.Net.OnceTimer(connectTimeout, () => + { + _onConnectFail?.Invoke(); + Dispose(); + }); + _packetParser = PacketParserFactory.CreateClientReadOnlyMemoryPacket(this); + _remoteEndPoint = NetworkHelper.GetIPEndPoint(remoteAddress); + _socket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp); + _socket.NoDelay = true; + _socket.SetSocketBufferToOsLimit(); + _sendArgs = new SocketAsyncEventArgs(); + _sendArgs.Completed += OnSendCompleted; + var outArgs = new SocketAsyncEventArgs + { + RemoteEndPoint = _remoteEndPoint + }; + outArgs.Completed += OnConnectSocketCompleted; + + if (!_socket.ConnectAsync(outArgs)) + { + OnReceiveSocketComplete(); + } + + Session = Session.Create(this, _remoteEndPoint); + return Session; + } + + private void OnConnectSocketCompleted(object sender, SocketAsyncEventArgs asyncEventArgs) + { + if (_cancellationTokenSource.IsCancellationRequested) + { + return; + } + + if (asyncEventArgs.LastOperation == SocketAsyncOperation.Connect) + { + if (asyncEventArgs.SocketError == SocketError.Success) + { + Scene.ThreadSynchronizationContext.Post(OnReceiveSocketComplete); + } + else + { + Scene.ThreadSynchronizationContext.Post(() => + { + _onConnectFail?.Invoke(); + Dispose(); + }); + } + } + } + + private void OnReceiveSocketComplete() + { + ClearConnectTimeout(); + _onConnectComplete?.Invoke(); + ReadPipeDataAsync().Coroutine(); + ReceiveSocketAsync().Coroutine(); + } + + #region ReceiveSocket + + private async FTask ReceiveSocketAsync() + { + while (!_cancellationTokenSource.IsCancellationRequested) + { + try + { + var memory = _pipe.Writer.GetMemory(8192); +#if UNITY_2021 + // Unity2021.3.14f有个恶心的问题，使用ReceiveAsync会导致memory不能正确写入 + // 所有只能使用ReceiveFromAsync来接收消息，但ReceiveFromAsync只有一个接受ArraySegment的接口。 + MemoryMarshal.TryGetArray(memory, out ArraySegment arraySegment); + var result = await _socket.ReceiveFromAsync(arraySegment, SocketFlags.None, _remoteEndPoint); + _pipe.Writer.Advance(result.ReceivedBytes); +#else + var count = await _socket.ReceiveAsync(memory, SocketFlags.None, _cancellationTokenSource.Token); + _pipe.Writer.Advance(count); +#endif + await _pipe.Writer.FlushAsync(); + } + catch (SocketException) + { + Dispose(); + break; + } + catch (OperationCanceledException) + { + break; + } + catch (ObjectDisposedException) + { + Dispose(); + break; + } + catch (Exception ex) + { + Log.Error($"Unexpected exception: {ex.Message}"); + } + } + + await _pipe.Writer.CompleteAsync(); + } + + #endregion + + #region ReceivePipeData + + private async FTask ReadPipeDataAsync() + { + var pipeReader = _pipe.Reader; + while (!_cancellationTokenSource.IsCancellationRequested) + { + ReadResult result = default; + + try + { + result = await pipeReader.ReadAsync(_cancellationTokenSource.Token); + } + catch (OperationCanceledException) + { + // 出现这个异常表示取消了_cancellationTokenSource。一般Channel断开会取消。 + break; + } + + var buffer = result.Buffer; + var consumed = buffer.Start; + var examined = buffer.End; + + while (TryReadMessage(ref buffer, out var message)) + { + ReceiveData(ref message); + consumed = buffer.Start; + } + + if (result.IsCompleted) + { + break; + } + + pipeReader.AdvanceTo(consumed, examined); + } + + await pipeReader.CompleteAsync(); + } + + private bool TryReadMessage(ref ReadOnlySequence buffer, out ReadOnlyMemory message) + { + if (buffer.Length == 0) + { + message = default; + return false; + } + + message = buffer.First; + + if (message.Length == 0) + { + message = default; + return false; + } + + buffer = buffer.Slice(message.Length); + return true; + } + + private void ReceiveData(ref ReadOnlyMemory buffer) + { + try + { + while (_packetParser.UnPack(ref buffer, out var packInfo)) + { + if (_cancellationTokenSource.IsCancellationRequested) + { + return; + } + Session.Receive(packInfo); + } + } + catch (ScanException e) + { + Log.Warning(e.Message); + Dispose(); + } + catch (Exception e) + { + Log.Error(e); + Dispose(); + } + } + + #endregion + + #region Send + + public override void Send(uint rpcId, long routeId, MemoryStreamBuffer memoryStream, IMessage message) + { + _sendBuffers.Enqueue(_packetParser.Pack(ref rpcId, ref routeId, memoryStream, message)); + + if (!_isSending) + { + Send(); + } + } + + private void Send() + { + if (_isSending || IsDisposed) + { + return; + } + + _isSending = true; + + while (_sendBuffers.Count > 0) + { + var memoryStreamBuffer = _sendBuffers.Dequeue(); + _sendArgs.UserToken = memoryStreamBuffer; + _sendArgs.SetBuffer(new ArraySegment(memoryStreamBuffer.GetBuffer(), 0, (int)memoryStreamBuffer.Position)); + + try + { + if (_socket.SendAsync(_sendArgs)) + { + break; + } + + ReturnMemoryStream(memoryStreamBuffer); + } + catch + { + _isSending = false; + return; + } + } + + _isSending = false; + } + + private void ReturnMemoryStream(MemoryStreamBuffer memoryStream) + { + if (memoryStream.MemoryStreamBufferSource == MemoryStreamBufferSource.Pack) + { + MemoryStreamBufferPool.ReturnMemoryStream(memoryStream); + } + } + + private void OnSendCompleted(object sender, SocketAsyncEventArgs asyncEventArgs) + { + if (asyncEventArgs.SocketError != SocketError.Success || asyncEventArgs.BytesTransferred == 0) + { + _isSending = false; + return; + } + + var memoryStreamBuffer = (MemoryStreamBuffer)asyncEventArgs.UserToken; + Scene.ThreadSynchronizationContext.Post(() => + { + ReturnMemoryStream(memoryStreamBuffer); + + if (_sendBuffers.Count > 0) + { + Send(); + } + else + { + _isSending = false; + } + }); + } + + #endregion + + public override void RemoveChannel(uint channelId) + { + Dispose(); + } + + private void ClearConnectTimeout() + { + if (_connectTimeoutId == 0) + { + return; + } + + Scene?.TimerComponent?.Net?.Remove(ref _connectTimeoutId); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client/TCPClientNetwork.cs.meta b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client/TCPClientNetwork.cs.meta new file mode 100644 index 0000000..e8ac2c0 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Client/TCPClientNetwork.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 5b29ef40368e94d9c90e051b8361a7f4 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server.meta b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server.meta new file mode 100644 index 0000000..41039fb --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: b700d7ce7028041c1a83dd03f7402b10 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetwork.cs b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetwork.cs new file mode 100644 index 0000000..3e8efb4 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetwork.cs @@ -0,0 +1,161 @@ +#if FANTASY_NET +using System.Net; +using System.Net.Sockets; +using Fantasy.Helper; +using Fantasy.Network.Interface; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +// ReSharper disable GCSuppressFinalizeForTypeWithoutDestructor +#pragma warning disable CS8622 // Nullability of reference types in type of parameter doesn't match the target delegate (possibly because of nullability attributes). +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. + +namespace Fantasy.Network.TCP +{ + public sealed class TCPServerNetwork : ANetwork + { + private Random _random; + private Socket _socket; + private SocketAsyncEventArgs _acceptAsync; + private readonly Dictionary _connectionChannel = new Dictionary(); + + public void Initialize(NetworkTarget networkTarget, IPEndPoint address) + { + base.Initialize(NetworkType.Server, NetworkProtocolType.TCP, networkTarget); + _random = new Random(); + _acceptAsync = new SocketAsyncEventArgs(); + _socket = new Socket(address.AddressFamily, SocketType.Stream, ProtocolType.Tcp); + _socket.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.ReuseAddress, false); + + if (address.AddressFamily == AddressFamily.InterNetworkV6) + { + _socket.SetSocketOption(SocketOptionLevel.IPv6, SocketOptionName.IPv6Only, false); + } + + _socket.Bind(address); + _socket.Listen(int.MaxValue); + _socket.SetSocketBufferToOsLimit(); + Log.Info($"SceneConfigId = {Scene.SceneConfigId} networkTarget = {networkTarget.ToString()} TCPServer Listen {address}"); + _acceptAsync.Completed += OnCompleted; + AcceptAsync(); + } + + public override void Dispose() + { + if (IsDisposed) + { + return; + } + + try + { + foreach (var networkChannel in _connectionChannel.Values.ToArray()) + { + networkChannel.Dispose(); + } + + _connectionChannel.Clear(); + _random = null; + _socket.Dispose(); + _socket = null; + _acceptAsync.Dispose(); + _acceptAsync = null; + GC.SuppressFinalize(this); + } + catch (Exception e) + { + Log.Error(e); + } + finally + { + base.Dispose(); + } + } + + private void AcceptAsync() + { + _acceptAsync.AcceptSocket = null; + + if (_socket.AcceptAsync(_acceptAsync)) + { + return; + } + + OnAcceptComplete(_acceptAsync); + } + + private void OnAcceptComplete(SocketAsyncEventArgs asyncEventArgs) + { + if (asyncEventArgs.AcceptSocket == null) + { + return; + } + + if (asyncEventArgs.SocketError != SocketError.Success) + { + Log.Error($"Socket Accept Error: {_acceptAsync.SocketError}"); + return; + } + + try + { + uint channelId; + do + { + channelId = 0xC0000000 | (uint)_random.Next(); + } while (_connectionChannel.ContainsKey(channelId)); + + _connectionChannel.Add(channelId, new TCPServerNetworkChannel(this, asyncEventArgs.AcceptSocket, channelId)); + } + catch (Exception e) + { + Log.Error(e); + } + finally + { + AcceptAsync(); + } + } + + public override void RemoveChannel(uint channelId) + { + if (IsDisposed || !_connectionChannel.Remove(channelId, out var channel)) + { + return; + } + + if (channel.IsDisposed) + { + return; + } + + channel.Dispose(); + } + + #region 网络线程（由Socket底层产生的线程） + + private void OnCompleted(object sender, SocketAsyncEventArgs asyncEventArgs) + { + switch (asyncEventArgs.LastOperation) + { + case SocketAsyncOperation.Accept: + { + Scene.ThreadSynchronizationContext.Post(() => + { + OnAcceptComplete(asyncEventArgs); + }); + break; + } + default: + { + throw new Exception($"Socket Accept Error: {asyncEventArgs.LastOperation}"); + } + } + } + + #endregion + } +} +#endif + + diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetwork.cs.meta b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetwork.cs.meta new file mode 100644 index 0000000..14db622 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetwork.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: e618ab398f9d443a4b5b85ec4ed611c3 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetworkChannel.cs b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetworkChannel.cs new file mode 100644 index 0000000..15f3f66 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetworkChannel.cs @@ -0,0 +1,294 @@ +#if FANTASY_NET +using System.Buffers; +using System.IO.Pipelines; +using System.Net.Sockets; +using Fantasy.Async; +using Fantasy.Network.Interface; +using Fantasy.PacketParser; +using Fantasy.Serialize; +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8602 // Dereference of a possibly null reference. + +#pragma warning disable CS8604 // Possible null reference argument. +#pragma warning disable CS8622 // Nullability of reference types in type of parameter doesn't match the target delegate (possibly because of nullability attributes). + +namespace Fantasy.Network.TCP +{ + public sealed class TCPServerNetworkChannel : ANetworkServerChannel + { + private bool _isSending; + private bool _isInnerDispose; + private readonly Socket _socket; + private readonly ANetwork _network; + private readonly Pipe _pipe = new Pipe(); + private readonly SocketAsyncEventArgs _sendArgs; + private readonly ReadOnlyMemoryPacketParser _packetParser; + private readonly Queue _sendBuffers = new Queue(); + private readonly CancellationTokenSource _cancellationTokenSource = new CancellationTokenSource(); + + public TCPServerNetworkChannel(ANetwork network, Socket socket, uint id) : base(network, id, socket.RemoteEndPoint) + { + _socket = socket; + _network = network; + _socket.NoDelay = true; + _sendArgs = new SocketAsyncEventArgs(); + _sendArgs.Completed += OnSendCompletedHandler; + _packetParser = PacketParserFactory.CreateServerReadOnlyMemoryPacket(network); + ReadPipeDataAsync().Coroutine(); + ReceiveSocketAsync().Coroutine(); + } + + public override void Dispose() + { + if (IsDisposed || _isInnerDispose) + { + return; + } + + _isInnerDispose = true; + _network.RemoveChannel(Id); + + if (!_cancellationTokenSource.IsCancellationRequested) + { + try + { + _cancellationTokenSource.Cancel(); + } + catch (OperationCanceledException) + { + // 通常情况下，此处的异常可以忽略 + } + } + + if (_socket != null) + { + _socket.Shutdown(SocketShutdown.Both); + _socket.Close(); + } + + _sendBuffers.Clear(); + _packetParser.Dispose(); + _isSending = false; + base.Dispose(); + } + + #region ReceiveSocket + + private async FTask ReceiveSocketAsync() + { + while (!_cancellationTokenSource.IsCancellationRequested) + { + try + { + var memory = _pipe.Writer.GetMemory(8192); + var count = await _socket.ReceiveAsync(memory, SocketFlags.None, _cancellationTokenSource.Token); + + if (count == 0) + { + Dispose(); + return; + } + + _pipe.Writer.Advance(count); + await _pipe.Writer.FlushAsync(); + } + catch (SocketException) + { + Dispose(); + break; + } + catch (OperationCanceledException) + { + break; + } + catch (ObjectDisposedException) + { + Dispose(); + break; + } + catch (Exception ex) + { + Log.Error($"Unexpected exception: {ex.Message}"); + } + } + + await _pipe.Writer.CompleteAsync(); + } + + #endregion + + #region ReceivePipeData + + private async FTask ReadPipeDataAsync() + { + var pipeReader = _pipe.Reader; + while (!_cancellationTokenSource.IsCancellationRequested) + { + ReadResult result = default; + + try + { + result = await pipeReader.ReadAsync(_cancellationTokenSource.Token); + } + catch (OperationCanceledException) + { + // 出现这个异常表示取消了_cancellationTokenSource。一般Channel断开会取消。 + break; + } + + var buffer = result.Buffer; + var consumed = buffer.Start; + var examined = buffer.End; + + while (TryReadMessage(ref buffer, out var message)) + { + ReceiveData(ref message); + consumed = buffer.Start; + } + + if (result.IsCompleted) + { + break; + } + + pipeReader.AdvanceTo(consumed, examined); + } + + await pipeReader.CompleteAsync(); + } + + private bool TryReadMessage(ref ReadOnlySequence buffer, out ReadOnlyMemory message) + { + if (buffer.Length == 0) + { + message = default; + return false; + } + + message = buffer.First; + + if (message.Length == 0) + { + message = default; + return false; + } + + buffer = buffer.Slice(message.Length); + return true; + } + + private void ReceiveData(ref ReadOnlyMemory buffer) + { + try + { + while (_packetParser.UnPack(ref buffer, out var packInfo)) + { + if (_cancellationTokenSource.IsCancellationRequested) + { + return; + } + + Session.Receive(packInfo); + } + } + catch (ScanException e) + { + Log.Warning($"RemoteAddress:{RemoteEndPoint} \n{e}"); + Dispose(); + } + catch (Exception e) + { + Log.Error($"RemoteAddress:{RemoteEndPoint} \n{e}"); + Dispose(); + } + } + + #endregion + + #region Send + + public override void Send(uint rpcId, long routeId, MemoryStreamBuffer memoryStream, IMessage message) + { + _sendBuffers.Enqueue(_packetParser.Pack(ref rpcId, ref routeId, memoryStream, message)); + + if (!_isSending) + { + Send(); + } + } + + private void Send() + { + if (_isSending || IsDisposed) + { + return; + } + + _isSending = true; + + while (_sendBuffers.Count > 0) + { + var memoryStreamBuffer = _sendBuffers.Dequeue(); + _sendArgs.UserToken = memoryStreamBuffer; + _sendArgs.SetBuffer(new ArraySegment(memoryStreamBuffer.GetBuffer(), 0, (int)memoryStreamBuffer.Position)); + + try + { + if (_socket.SendAsync(_sendArgs)) + { + break; + } + + ReturnMemoryStream(memoryStreamBuffer); + } + catch + { + _isSending = false; + return; + } + } + + _isSending = false; + } + + private void ReturnMemoryStream(MemoryStreamBuffer memoryStream) + { + if (memoryStream.MemoryStreamBufferSource == MemoryStreamBufferSource.Pack) + { + _network.MemoryStreamBufferPool.ReturnMemoryStream(memoryStream); + } + } + + private void OnSendCompletedHandler(object sender, SocketAsyncEventArgs asyncEventArgs) + { + if (asyncEventArgs.SocketError != SocketError.Success || asyncEventArgs.BytesTransferred == 0) + { + _isSending = false; + return; + } + + var memoryStreamBuffer = (MemoryStreamBuffer)asyncEventArgs.UserToken; + + Scene.ThreadSynchronizationContext.Post(() => + { + ReturnMemoryStream(memoryStreamBuffer); + + if (_sendBuffers.Count > 0) + { + Send(); + } + else + { + _isSending = false; + } + }); + } + + #endregion + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetworkChannel.cs.meta b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetworkChannel.cs.meta new file mode 100644 index 0000000..ef3711c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Protocol/TCP/Server/TCPServerNetworkChannel.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: b2a73037f999c4c049abbfe87bc204e8 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Component.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Component.meta new file mode 100644 index 0000000..cdd6035 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Component.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 4740ddbe2242649b58a81aaee0cbf094 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Component/RoamingComponent.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Component/RoamingComponent.cs new file mode 100644 index 0000000..a42d582 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Component/RoamingComponent.cs @@ -0,0 +1,254 @@ +#if FANTASY_NET +using System.Runtime.CompilerServices; +using Fantasy.Async; +using Fantasy.Entitas; +using Fantasy.Timer; +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider adding the 'required' modifier or declaring as nullable. +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8601 // Possible null reference assignment. +#pragma warning disable CS8603 // Possible null reference return. + +namespace Fantasy.Network.Roaming; + +/// +/// 漫游组件，用来管理当然Scene下的所有漫游消息。 +/// 大多数是在Gate这样的转发服务器上创建的。 +/// +public sealed class RoamingComponent : Entity +{ + private TimerSchedulerNet _timerSchedulerNet; + private readonly Dictionary _sessionRoamingComponents = new(); + private readonly Dictionary _delayRemoveTaskId = new(); + + internal RoamingComponent Initialize() + { + _timerSchedulerNet = Scene.TimerComponent.Net; + return this; + } + + /// + /// 销毁方法。 + /// + public override void Dispose() + { + DisposeAsync().Coroutine(); + } + + private async FTask DisposeAsync() + { + foreach (var (_,taskId) in _delayRemoveTaskId) + { + _timerSchedulerNet.Remove(taskId); + } + + _delayRemoveTaskId.Clear(); + + foreach (var (_, sessionRoamingComponent) in _sessionRoamingComponents) + { + await sessionRoamingComponent.UnLink(); + } + + _sessionRoamingComponents.Clear(); + _timerSchedulerNet = null; + base.Dispose(); + } + + /// + /// 给Session会话增加漫游功能 + /// 如果指定的roamingId已经存在漫游，会把这个漫游功能和当前Session会话关联起来。 + /// + /// + /// 自定义roamingId，这个Id在漫游中并没有实际作用，但用户可以用这个id来进行标记。。 + /// 是否在Session断开的时候自动断开漫游功能。 + /// 如果开启了自定断开漫游功能需要设置一个延迟多久执行断开。 + /// 创建成功会返回SessionRoamingComponent组件，这个组件提供漫游的所有功能。 + public SessionRoamingComponent Create(Session session, long roamingId, bool isAutoDispose, int delayRemove) + { + if (session.SessionRoamingComponent != null) + { + if (session.SessionRoamingComponent.Id != roamingId) + { + Log.Error("The current session has created a SessionRoamingComponent."); + return null; + } + } + else + { + if (!_sessionRoamingComponents.TryGetValue(roamingId, out var sessionRoamingComponent)) + { + sessionRoamingComponent = Entity.Create(Scene, roamingId, true, true); + sessionRoamingComponent.Initialize(session); + _sessionRoamingComponents.Add(roamingId, sessionRoamingComponent); + } + } + + if (isAutoDispose) + { + session.AddComponent(roamingId).DelayRemove = delayRemove; + } + + return session.SessionRoamingComponent; + } + + /// + /// 获取当前Session会话的漫游组件 + /// + /// + /// + public SessionRoamingComponent Get(Session session) + { + var sessionRoamingFlgComponent = session.GetComponent(); + + if (sessionRoamingFlgComponent != null) + { + if (_sessionRoamingComponents.TryGetValue(sessionRoamingFlgComponent.Id, out var sessionRoamingComponent)) + { + return sessionRoamingComponent; + } + + Log.Error($"There is no SessionRoamingComponent with roamingId: {sessionRoamingFlgComponent.Id}."); + } + else + { + Log.Error("The current session has not created a roaming session yet, so you need to create one first."); + } + + return null; + } + + /// + /// 获取当前Session会话的漫游组件 + /// + /// + /// + /// + public bool TryGet(Session session, out SessionRoamingComponent sessionRoamingComponent) + { + var sessionRoamingFlgComponent = session.GetComponent(); + + if (sessionRoamingFlgComponent != null) + { + return _sessionRoamingComponents.TryGetValue(sessionRoamingFlgComponent.Id, out sessionRoamingComponent); + } + + sessionRoamingComponent = null; + return false; + } + + /// + /// 移除一个漫游 + /// + /// + /// 要移除的RoamingType，默认不设置是移除所有漫游。 + /// 当设置了延迟移除时间后，会在设置的时间后再进行移除。 + public async FTask Remove(long roamingId, int roamingType, int delayRemove = 0) + { + if (_delayRemoveTaskId.Remove(roamingId, out var taskId)) + { + _timerSchedulerNet.Remove(taskId); + } + + if (delayRemove <= 0) + { + await InnerRemove(roamingId, roamingType); + return; + } + + taskId = _timerSchedulerNet.OnceTimer(delayRemove, () => + { InnerRemove(roamingId, roamingType).Coroutine(); }); + _delayRemoveTaskId.Add(roamingId, taskId); + } + + private async FTask InnerRemove(long roamingId, int roamingType) + { + if (!_sessionRoamingComponents.Remove(roamingId, out var sessionRoamingComponent)) + { + return; + } + + await sessionRoamingComponent.UnLink(roamingType); + sessionRoamingComponent.Dispose(); + _delayRemoveTaskId.Remove(roamingId); + } +} + +/// +/// 漫游Roaming帮助类 +/// +public static class RoamingHelper +{ + /// + /// 给Session会话增加漫游功能 + /// 如果指定的roamingId已经存在漫游，会把这个漫游功能和当前Session会话关联起来。 + /// + /// + /// 自定义roamingId，这个Id在漫游中并没有实际作用，但用户可以用这个id来进行标记。 + /// 是否在Session断开的时候自动断开漫游功能。 + /// 如果开启了自定断开漫游功能需要设置一个延迟多久执行断开。 + /// 创建成功会返回SessionRoamingComponent组件，这个组件提供漫游的所有功能。 + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static SessionRoamingComponent CreateRoaming(this Session session, long roamingId, bool isAutoDispose = true, int delayRemove = 1000 * 60 * 3) + { + return session.Scene.RoamingComponent.Create(session, roamingId, isAutoDispose, delayRemove); + } + + /// + /// 获取当前Session会话的漫游组件 + /// + /// + /// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static SessionRoamingComponent GetRoaming(this Session session) + { + return session.Scene.RoamingComponent.Get(session); + } + + /// + /// 获取当前Session会话的漫游组件 + /// + /// + /// + /// 如果返回为false表示没有获取到漫游组件。 + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static bool TryGetRoaming(this Session session, out SessionRoamingComponent sessionRoamingComponent) + { + return session.Scene.RoamingComponent.TryGet(session, out sessionRoamingComponent); + } + + /// + /// 移除一个漫游 + /// + /// + /// 要移除的RoamingType，默认不设置是移除所有漫游。 + /// 当设置了延迟移除时间后，会在设置的时间后再进行移除。 + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static async FTask RemoveRoaming(this Session session, int roamingType = 0, int delayRemove = 0) + { + if (session.SessionRoamingComponent == null || session.SessionRoamingComponent.Id == 0) + { + return; + } + + await session.Scene.RoamingComponent.Remove(session.SessionRoamingComponent.Id, roamingType, delayRemove); + } + + /// + /// 移除一个漫游 + /// + /// + /// + /// 要移除的RoamingType，默认不设置是移除所有漫游。 + /// 当设置了延迟移除时间后，会在设置的时间后再进行移除。 + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static async FTask RemoveRoaming(Scene scene, long roamingId, int roamingType = 0, int delayRemove = 0) + { + if (roamingId == 0) + { + return; + } + + await scene.RoamingComponent.Remove(roamingId, roamingType, delayRemove); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Component/RoamingComponent.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Component/RoamingComponent.cs.meta new file mode 100644 index 0000000..dbddd4e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Component/RoamingComponent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 5fc4298a4a5144ba0b031a8cd3694521 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingComponent.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingComponent.cs new file mode 100644 index 0000000..c5ce55a --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingComponent.cs @@ -0,0 +1,279 @@ +#if FANTASY_NET +using Fantasy.Async; +using Fantasy.Entitas; +using Fantasy.Entitas.Interface; +using Fantasy.InnerMessage; +using Fantasy.Network.Interface; +using Fantasy.PacketParser.Interface; +using Fantasy.Platform.Net; +using Fantasy.Scheduler; +using Fantasy.Timer; +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8601 // Possible null reference assignment. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider adding the 'required' modifier or declaring as nullable. +#pragma warning disable CS8603 // Possible null reference return. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. + +namespace Fantasy.Network.Roaming; + +internal sealed class SessionRoamingComponentDestroySystem : DestroySystem +{ + protected override void Destroy(SessionRoamingComponent self) + { + self.RoamingLock.Dispose(); + self.RoamingMessageLock.Dispose(); + + self.RoamingLock = null; + self.RoamingMessageLock = null; + self.TimerComponent = null; + self.NetworkMessagingComponent = null; + self.MessageDispatcherComponent = null; + } +} + +/// +/// Session的漫游组件。 +/// 用于关联对应的Session的功能。 +/// 但这个组件并不会挂载到这个Session下。 +/// +public sealed class SessionRoamingComponent : Entity +{ + internal CoroutineLock RoamingLock; + internal CoroutineLock RoamingMessageLock; + internal TimerComponent TimerComponent; + internal NetworkMessagingComponent NetworkMessagingComponent; + internal MessageDispatcherComponent MessageDispatcherComponent; + /// + /// 漫游的列表。 + /// + private readonly Dictionary _roaming = new Dictionary(); + + internal void Initialize(Session session) + { + session.SessionRoamingComponent = this; + + var scene = session.Scene; + TimerComponent = scene.TimerComponent; + NetworkMessagingComponent = scene.NetworkMessagingComponent; + MessageDispatcherComponent = scene.MessageDispatcherComponent; + RoamingLock = scene.CoroutineLockComponent.Create(this.GetType().TypeHandle.Value.ToInt64()); + RoamingMessageLock = scene.CoroutineLockComponent.Create(this.GetType().TypeHandle.Value.ToInt64()); + } + + #region Get + + /// + /// 尝试获取一个漫游。 + /// + /// + /// + /// + public bool TryGetRoaming(int roamingType, out Roaming roaming) + { + return _roaming.TryGetValue(roamingType, out roaming); + } + + #endregion + + #region Link + + /// + /// 建立漫游关系。 + /// + /// 要建立漫游协议的目标Scene的SceneConfig。 + /// 需要转发的Session + /// 要创建的漫游协议类型。 + /// 如果建立完成会返回为0，其余不为0的都是发生错误了。可以通过InnerErrorCode.cs来查看错误。 + public async FTask Link(Session session, SceneConfig targetSceneConfig, int roamingTyp) + { + return await Link(targetSceneConfig.RouteId, session.RuntimeId, roamingTyp); + } + + /// + /// 建立漫游关系。 + /// + /// 要建立漫游协议的目标Scene的RouteId。 + /// 需要转发的Session的RouteId。 + /// 要创建的漫游协议类型。 + /// 如果建立完成会返回为0，其余不为0的都是发生错误了。可以通过InnerErrorCode.cs来查看错误。 + public async FTask Link(long targetSceneRouteId, long forwardSessionRouteId, int roamingType) + { + if (_roaming.ContainsKey(roamingType)) + { + return InnerErrorCode.ErrLinkRoamingAlreadyExists; + } + + var response = (I_LinkRoamingResponse)await Scene.NetworkMessagingComponent.CallInnerRoute(targetSceneRouteId, + new I_LinkRoamingRequest() + { + RoamingId = Id, + RoamingType = roamingType, + ForwardSessionRouteId = forwardSessionRouteId, + SceneRouteId = Scene.RuntimeId + }); + + if (response.ErrorCode != 0) + { + return response.ErrorCode; + } + + var roaming = Entity.Create(Scene, true, true); + roaming.TerminusId = response.TerminusId; + roaming.TargetSceneRouteId = targetSceneRouteId; + roaming.ForwardSessionRouteId = forwardSessionRouteId; + roaming.SessionRoamingComponent = this; + roaming.RoamingType = roamingType; + roaming.RoamingLock = RoamingLock; + _roaming.Add(roamingType, roaming); + return 0; + } + + #endregion + + #region UnLink + + /// + /// 断开当前的所有漫游关系。 + /// 要移除的RoamingType，默认不设置是移除所有漫游。 + /// + public async FTask UnLink(int removeRoamingType = 0) + { + switch (removeRoamingType) + { + case 0: + { + foreach (var (roamingType,roaming) in _roaming) + { + try + { + var errorCode = await roaming.Disconnect(); + + if (errorCode != 0) + { + Log.Warning($"roaming roamingId:{Id} roamingType:{roamingType} disconnect errorCode:{errorCode}"); + } + } + finally + { + roaming.Dispose(); + } + } + + _roaming.Clear(); + return; + } + default: + { + if (!_roaming.Remove(removeRoamingType, out var roaming)) + { + return; + } + + var errorCode = await roaming.Disconnect(); + + if (errorCode != 0) + { + Log.Warning($"roaming roamingId:{Id} roamingType:{removeRoamingType} disconnect errorCode:{errorCode}"); + } + + roaming.Dispose(); + return; + } + } + } + + #endregion + + #region Message + + internal async FTask Send(int roamingType, Type requestType, APackInfo packInfo) + { + await Call(roamingType, requestType, packInfo); + } + + internal async FTask Call(int roamingType, Type requestType, APackInfo packInfo) + { + if (IsDisposed) + { + return MessageDispatcherComponent.CreateResponse(requestType, InnerErrorCode.ErrNotFoundRoaming); + } + + packInfo.IsDisposed = true; + + if (!_roaming.TryGetValue(roamingType, out var roaming)) + { + return MessageDispatcherComponent.CreateResponse(requestType, InnerErrorCode.ErrNotFoundRoaming); + } + + var failCount = 0; + var runtimeId = RuntimeId; + var routeId = roaming.TerminusId; + IResponse iRouteResponse = null; + + try + { + using (await RoamingMessageLock.Wait(roamingType, "RoamingComponent Call MemoryStream")) + { + while (!IsDisposed) + { + if (routeId == 0) + { + routeId = await roaming.GetTerminusId(); + } + + if (routeId == 0) + { + return MessageDispatcherComponent.CreateResponse(requestType, InnerErrorCode.ErrNotFoundRoaming); + } + + iRouteResponse = await NetworkMessagingComponent.CallInnerRoute(routeId, requestType, packInfo); + + if (runtimeId != RuntimeId) + { + iRouteResponse.ErrorCode = InnerErrorCode.ErrRoamingTimeout; + } + + switch (iRouteResponse.ErrorCode) + { + case InnerErrorCode.ErrRouteTimeout: + case InnerErrorCode.ErrRoamingTimeout: + { + return iRouteResponse; + } + case InnerErrorCode.ErrNotFoundRoute: + case InnerErrorCode.ErrNotFoundRoaming: + { + if (++failCount > 20) + { + Log.Error($"RoamingComponent.Call failCount > 20 route send message fail, LinkRoamingId: {routeId}"); + return iRouteResponse; + } + + await TimerComponent.Net.WaitAsync(100); + + if (runtimeId != RuntimeId) + { + iRouteResponse.ErrorCode = InnerErrorCode.ErrNotFoundRoaming; + } + routeId = 0; + continue; + } + default: + { + return iRouteResponse; // 对于其他情况，直接返回响应，无需额外处理 + } + } + } + } + } + finally + { + packInfo.Dispose(); + } + + return iRouteResponse; + } + + #endregion +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingComponent.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingComponent.cs.meta new file mode 100644 index 0000000..2cfe74b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingComponent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 74edcb82197ea4a7bad43a62b4967ea5 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingFlgComponent.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingFlgComponent.cs new file mode 100644 index 0000000..23f4c33 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingFlgComponent.cs @@ -0,0 +1,23 @@ +#if FANTASY_NET +using Fantasy.Async; +using Fantasy.Entitas; +namespace Fantasy.Network.Roaming; + +internal sealed class SessionRoamingFlgComponent : Entity +{ + public int DelayRemove; + + public override void Dispose() + { + DisposeAsync().Coroutine(); + } + + private async FTask DisposeAsync() + { + var roamingId = Id; + await Scene.RoamingComponent.Remove(roamingId, 0, DelayRemove); + DelayRemove = 0; + base.Dispose(); + } +} +#endif diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingFlgComponent.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingFlgComponent.cs.meta new file mode 100644 index 0000000..6a1c9dc --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Component/SessionRoamingFlgComponent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 106dfb8bdf9184a528886880fd913536 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Component/TerminusComponent.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Component/TerminusComponent.cs new file mode 100644 index 0000000..0185261 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Component/TerminusComponent.cs @@ -0,0 +1,138 @@ +#if FANTASY_NET +using Fantasy.Async; +using Fantasy.DataStructure.Dictionary; +using Fantasy.Entitas; +using Fantasy.Network; +#pragma warning disable CS8601 // Possible null reference assignment. +#pragma warning disable CS8619 // Nullability of reference types in value doesn't match target type. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. + +namespace Fantasy.Network.Roaming; + +/// +/// 当Terminus创建完成后发送的事件参数 +/// +public struct OnCreateTerminus +{ + /// + /// 获取与事件关联的场景实体。 + /// + public readonly Scene Scene; + /// + /// 获取与事件关联的Terminus。 + /// + public readonly Terminus Terminus; + /// + /// 初始化一个新的 OnCreateTerminus 实例。 + /// + /// + /// + public OnCreateTerminus(Scene scene, Terminus terminus) + { + Scene = scene; + Terminus = terminus; + } +} + +/// +/// 漫游终端管理组件。 +/// 这个组件不需要手动挂载，会在Scene启动的时候自动挂载这个组件。 +/// +public sealed class TerminusComponent : Entity +{ + /// + /// 漫游终端的实体集合。 + /// + private readonly Dictionary _terminals = new(); + + /// + /// Dispose + /// + public override void Dispose() + { + foreach (var (_, terminus) in _terminals) + { + terminus.Dispose(); + } + + _terminals.Clear(); + base.Dispose(); + } + + /// + /// 创建一个新的漫游终端。 + /// + /// + /// + /// + /// + /// + public async FTask<(uint, Terminus)> Create(long roamingId, int roamingType, long forwardSessionRouteId, long forwardSceneRouteId) + { + if (_terminals.ContainsKey(roamingId)) + { + return (InnerErrorCode.ErrAddRoamingTerminalAlreadyExists, null); + } + + var terminus = roamingId == 0 + ? Entity.Create(Scene, false, true) + : Entity.Create(Scene, roamingId, false, true); + terminus.RoamingType = roamingType; + terminus.TerminusId = terminus.RuntimeId; + terminus.ForwardSceneRouteId = forwardSceneRouteId; + terminus.ForwardSessionRouteId = forwardSessionRouteId; + terminus.RoamingMessageLock = Scene.CoroutineLockComponent.Create(terminus.Type.TypeHandle.Value.ToInt64()); + await Scene.EventComponent.PublishAsync(new OnCreateTerminus(Scene, terminus)); + _terminals.Add(terminus.Id, terminus); + return (0U, terminus); + } + + /// + /// 添加一个漫游终端。 + /// + /// + public void AddTerminus(Terminus terminus) + { + _terminals.Add(terminus.Id, terminus); + } + + /// + /// 根据roamingId获取一个漫游终端。 + /// + /// + /// + /// + public bool TryGetTerminus(long roamingId, out Terminus terminus) + { + return _terminals.TryGetValue(roamingId, out terminus); + } + + /// + /// 根据roamingId获取一个漫游终端。 + /// + /// + /// + public Terminus GetTerminus(long roamingId) + { + return _terminals[roamingId]; + } + + /// + /// 根据roamingId移除一个漫游终端。 + /// + /// + /// + public void RemoveTerminus(long roamingId, bool isDispose = true) + { + if (!_terminals.Remove(roamingId, out var terminus)) + { + return; + } + + if (isDispose) + { + terminus.Dispose(); + } + } +} +#endif diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Component/TerminusComponent.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Component/TerminusComponent.cs.meta new file mode 100644 index 0000000..ed5f981 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Component/TerminusComponent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 6fff17badf29a449bb933ae25159f55e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Entity.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Entity.meta new file mode 100644 index 0000000..bbc5457 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Entity.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 16b497b4b6cac4b40a1338ea17110fcb +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Roaming.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Roaming.cs new file mode 100644 index 0000000..33a5355 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Roaming.cs @@ -0,0 +1,132 @@ +#if FANTASY_NET +using Fantasy.Async; +using Fantasy.Entitas; +using Fantasy.InnerMessage; + +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider adding the 'required' modifier or declaring as nullable. + +namespace Fantasy.Network.Roaming; + +/// +/// 漫游实体 +/// +public sealed class Roaming : Entity +{ + /// + /// 连接到漫游TerminusId。 + /// 也可以理解为目标实体的RouteId。 + /// + internal long TerminusId; + /// + /// 漫游目标Scene的RouteId。 + /// + public long TargetSceneRouteId { get; internal set; } + /// + /// 漫游转发Session的RouteId。 + /// + public long ForwardSessionRouteId { get; internal set; } + /// + /// 当前漫游类型。 + /// + public int RoamingType { get; internal set; } + /// + /// 协程锁。 + /// + internal CoroutineLock RoamingLock; + /// + /// 当前正在执行的协程锁。 + /// + private WaitCoroutineLock? _waitCoroutineLock; + /// + /// 关联Session的漫游组件。 + /// + internal SessionRoamingComponent SessionRoamingComponent; + /// + /// 获得当前漫游对应终端的TerminusId。 + /// + /// + internal async FTask GetTerminusId() + { + using (await RoamingLock.Wait(RoamingType,"Roaming.cs GetTerminusId")) + { + return TerminusId; + } + } + /// + /// 设置当前漫游对应的终端的TerminusId。 + /// + /// + internal async FTask SetTerminusId(long terminusId) + { + using (await RoamingLock.Wait(RoamingType,"Roaming.cs SetTerminusId")) + { + TerminusId = terminusId; + } + } + /// + /// 锁定TerminusId。 + /// + internal async FTask LockTerminusId() + { + _waitCoroutineLock = await RoamingLock.Wait(RoamingType,"Roaming.cs LockTerminusId"); + } + + /// + /// 解锁TerminusId。 + /// + /// + /// + internal void UnLockTerminusId(long terminusId, long targetSceneRouteId) + { + if (_waitCoroutineLock == null) + { + Log.Error("terminusId unlock waitCoroutineLock is null"); + return; + } + + TerminusId = terminusId; + TargetSceneRouteId = targetSceneRouteId; + _waitCoroutineLock.Dispose(); + _waitCoroutineLock = null; + } + + /// + /// 断开当前漫游的连接。 + /// + /// + public async FTask Disconnect() + { + var response = + await Scene.NetworkMessagingComponent.CallInnerRoute(TargetSceneRouteId, new I_UnLinkRoamingRequest() + { + RoamingId = SessionRoamingComponent.Id + }); + return response.ErrorCode; + } + /// + /// 销毁方法 + /// + public override void Dispose() + { + if (IsDisposed) + { + return; + } + + if (_waitCoroutineLock != null) + { + _waitCoroutineLock.Dispose(); + _waitCoroutineLock = null; + } + + TerminusId = 0; + TargetSceneRouteId = 0; + ForwardSessionRouteId = 0; + + RoamingLock = null; + SessionRoamingComponent = null; + base.Dispose(); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Roaming.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Roaming.cs.meta new file mode 100644 index 0000000..e9a45f9 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Roaming.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 5ef973321a0414053855b287df8e3a17 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Terminus.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Terminus.cs new file mode 100644 index 0000000..8d4448b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Terminus.cs @@ -0,0 +1,338 @@ +#if FANTASY_NET +using Fantasy.Async; +using Fantasy.Entitas; +using Fantasy.InnerMessage; +using Fantasy.Network; +using Fantasy.Network.Interface; +using Fantasy.Scheduler; +using MongoDB.Bson.Serialization.Attributes; +// ReSharper disable UnassignedField.Global +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider adding the 'required' modifier or declaring as nullable. +#pragma warning disable CS8603 // Possible null reference return. +namespace Fantasy.Network.Roaming; + +/// +/// 漫游终端实体 +/// +public sealed class Terminus : Entity +{ + /// + /// 当前漫游终端的TerminusId。 + /// 可以通过 TerminusId 发送消息给这个漫游终端。 + /// 也可以理解为实体的RuntimeId。 + /// + internal long TerminusId; + /// + /// 当前漫游终端的类型。 + /// + [BsonElement("r")] + internal int RoamingType; + /// + /// 漫游转发Session所在的Scene的RouteId。 + /// + [BsonElement("s")] + internal long ForwardSceneRouteId; + /// + /// 漫游转发Session的RouteId。 + /// 不知道原理千万不要手动赋值这个。 + /// + [BsonElement("f")] + internal long ForwardSessionRouteId; + /// + /// 关联的玩家实体 + /// + [BsonElement("e")] + public Entity TerminusEntity; + /// + /// 漫游消息锁。 + /// + [BsonIgnore] + internal CoroutineLock RoamingMessageLock; + /// + /// 获得转发的SessionRouteId，可以通过这个Id来发送消息来自动转发到客户端。 + /// + public long SessionRouteId => ForwardSessionRouteId; + /// + /// 存放其他漫游终端的Id。 + /// 通过这个Id可以发送消息给它。 + /// + [BsonIgnore] + private readonly Dictionary _roamingTerminusId = new Dictionary(); + /// + /// 创建关联的终端实体。 + /// 创建完成后，接收消息都是由关联的终端实体来处理。 + /// 注意，当你销毁这个实体的时候，并不能直接销毁Terminus，会导致无法接收到漫游消息。 + /// + /// + /// + public T LinkTerminusEntity() where T : Entity, new() + { + if (TerminusEntity != null) + { + Log.Error($"TerminusEntity:{TerminusEntity.Type.FullName} Already exists!"); + return null; + } + + var t = Entity.Create(Scene, true, true); + TerminusEntity = t; + TerminusId = TerminusEntity.RuntimeId; + return t; + } + + /// + /// 关联的终端实体。 + /// 注意，当你销毁这个实体的时候，并不能直接销毁Terminus，会导致无法接收到漫游消息 + /// + /// + public void LinkTerminusEntity(Entity entity) + { + if (entity == null) + { + Log.Error("Entity cannot be empty"); + return; + } + + if (TerminusEntity != null) + { + Log.Error($"TerminusEntity:{TerminusEntity.Type.FullName} Already exists!"); + return; + } + + TerminusEntity = entity; + TerminusId = TerminusEntity.RuntimeId; + } + + #region Transfer + + /// + /// 传送漫游终端 + /// 传送完成后，漫游终端和关联的玩家实体都会被销毁。 + /// 所以如果有其他组件关联这个实体，要提前记录好Id，方便传送后清理。 + /// + /// + public async FTask StartTransfer(long targetSceneRouteId) + { + var currentSceneRouteId = Scene.SceneConfig.RouteId; + if (targetSceneRouteId == currentSceneRouteId) + { + Log.Warning($"Unable to teleport to your own scene targetSceneRouteId:{targetSceneRouteId} == currentSceneRouteId:{currentSceneRouteId}"); + return 0; + } + + try + { + // 传送目标服务器之前要先锁定，防止再传送过程中还有其他消息发送过来。 + var lockErrorCode = await Lock(); + if (lockErrorCode != 0) + { + return lockErrorCode; + } + // 开始执行传送请求。 + var response = (I_TransferTerminusResponse)await Scene.NetworkMessagingComponent.CallInnerRoute( + targetSceneRouteId, + new I_TransferTerminusRequest() + { + Terminus = this + }); + if (response.ErrorCode != 0) + { + // 如果传送出现异常，需要先解锁，不然会出现一直卡死的问题。 + await UnLock(); + return response.ErrorCode; + } + // 在当前Scene下移除漫游终端。 + Scene.TerminusComponent.RemoveTerminus(Id); + } + catch (Exception e) + { + Log.Error(e); + // 如果代码执行出现任何异常，要先去解锁，避免会出现卡死的问题。 + await UnLock(); + return InnerErrorCode.ErrTerminusStartTransfer; + } + + return 0; + } + + /// + /// 传送完成。 + /// 当传送完成后，需要清理漫游终端。 + /// + /// + public async FTask TransferComplete(Scene scene) + { + // 首先恢复漫游终端的序列化数据。并且注册到框架中。 + Deserialize(scene); + TerminusId = RuntimeId; + if (TerminusEntity != null) + { + TerminusEntity.Deserialize(scene); + TerminusId = TerminusEntity.RuntimeId; + } + // 然后要解锁下漫游 + return await UnLock(); + } + + /// + /// 锁定漫游当执行锁定了后，所有消息都会被暂时放入队列中不会发送。 + /// 必须要解锁后才能继续发送消息。 + /// + /// + public async FTask Lock() + { + var response = await Scene.NetworkMessagingComponent.CallInnerRoute(ForwardSceneRouteId, + new I_LockTerminusIdRequest() + { + SessionRuntimeId = ForwardSessionRouteId, + RoamingType = RoamingType + }); + return response.ErrorCode; + } + + /// + /// 锁定漫游 + /// + /// + public async FTask UnLock() + { + var response = await Scene.NetworkMessagingComponent.CallInnerRoute(ForwardSceneRouteId, + new I_UnLockTerminusIdRequest() + { + SessionRuntimeId = ForwardSessionRouteId, + RoamingType = RoamingType, + TerminusId = TerminusId, + TargetSceneRouteId = Scene.RouteId + }); + return response.ErrorCode; + } + + #endregion + + #region Message + + private async FTask GetTerminusId(int roamingType) + { + if (IsDisposed) + { + return 0; + } + + var response = (I_GetTerminusIdResponse)await Scene.NetworkMessagingComponent.CallInnerRoute( + ForwardSceneRouteId, + new I_GetTerminusIdRequest() + { + SessionRuntimeId = ForwardSessionRouteId, + RoamingType = roamingType + }); + return response.TerminusId; + } + + /// + /// 发送一个消息给客户端 + /// + /// + public void Send(IRouteMessage message) + { + Scene.NetworkMessagingComponent.SendInnerRoute(ForwardSessionRouteId, message); + } + /// + /// 发送一个漫游消息 + /// + /// + /// + public void Send(int roamingType, IRoamingMessage message) + { + Call(roamingType, message).Coroutine(); + } + + /// + /// 发送一个漫游RPC消息。 + /// + /// + /// + /// + public async FTask Call(int roamingType, IRoamingMessage request) + { + if (IsDisposed) + { + return Scene.MessageDispatcherComponent.CreateResponse(request.GetType(), InnerErrorCode.ErrNotFoundRoaming); + } + + if (roamingType == RoamingType) + { + Log.Warning($"Does not support sending messages to the same scene as roamingType currentRoamingType:{RoamingType} roamingType:{roamingType}"); + return Scene.MessageDispatcherComponent.CreateResponse(request.GetType(), InnerErrorCode.ErrNotFoundRoaming); + } + + var failCount = 0; + var runtimeId = RuntimeId; + IResponse iRouteResponse = null; + _roamingTerminusId.TryGetValue(roamingType, out var routeId); + + using (await RoamingMessageLock.Wait(roamingType, "Terminus Call request")) + { + while (!IsDisposed) + { + if (routeId == 0) + { + routeId = await GetTerminusId(roamingType); + + if (routeId != 0) + { + _roamingTerminusId[roamingType] = routeId; + } + else + { + return Scene.MessageDispatcherComponent.CreateResponse(request.GetType(), InnerErrorCode.ErrNotFoundRoaming); + } + } + + iRouteResponse = await Scene.NetworkMessagingComponent.CallInnerRoute(routeId, request); + + if (runtimeId != RuntimeId) + { + iRouteResponse.ErrorCode = InnerErrorCode.ErrRoamingTimeout; + } + + switch (iRouteResponse.ErrorCode) + { + case InnerErrorCode.ErrRouteTimeout: + case InnerErrorCode.ErrRoamingTimeout: + { + return iRouteResponse; + } + case InnerErrorCode.ErrNotFoundRoute: + case InnerErrorCode.ErrNotFoundRoaming: + { + if (++failCount > 20) + { + Log.Error($"Terminus.Call failCount > 20 route send message fail, TerminusId: {routeId}"); + return iRouteResponse; + } + + await Scene.TimerComponent.Net.WaitAsync(100); + + if (runtimeId != RuntimeId) + { + iRouteResponse.ErrorCode = InnerErrorCode.ErrNotFoundRoaming; + } + + routeId = 0; + continue; + } + default: + { + return iRouteResponse; // 对于其他情况，直接返回响应，无需额外处理 + } + } + } + } + + return iRouteResponse; + } + + #endregion +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Terminus.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Terminus.cs.meta new file mode 100644 index 0000000..dffdbb8 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Entity/Terminus.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: e31e22d659e724157b2328aadade93fb +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Handler.meta new file mode 100644 index 0000000..834129e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: b490c6b817db24ce088ffa2a17740314 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_GetTerminusIdRequestHandler.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_GetTerminusIdRequestHandler.cs new file mode 100644 index 0000000..90f7ab9 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_GetTerminusIdRequestHandler.cs @@ -0,0 +1,32 @@ +#if FANTASY_NET +using Fantasy.Async; +using Fantasy.InnerMessage; +using Fantasy.Network; +using Fantasy.Network.Interface; +using Fantasy.Network.Roaming; +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract + +namespace Fantasy.Roaming.Handler; + +internal sealed class I_GetTerminusIdRequestHandler : RouteRPC +{ + protected override async FTask Run(Scene scene, I_GetTerminusIdRequest request, I_GetTerminusIdResponse response, Action reply) + { + if (!scene.TryGetEntity(request.SessionRuntimeId, out var sessionEntity)) + { + response.ErrorCode = InnerErrorCode.ErrLockTerminusIdNotFoundSession; + return; + } + + var session = (Session)sessionEntity; + + if (!scene.RoamingComponent.TryGet(session, out var sessionRoamingComponent) || !sessionRoamingComponent.TryGetRoaming(request.RoamingType, out var sessionRoaming)) + { + response.ErrorCode = InnerErrorCode.ErrLockTerminusIdNotFoundRoamingType; + return; + } + + response.TerminusId = await sessionRoaming.GetTerminusId(); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_GetTerminusIdRequestHandler.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_GetTerminusIdRequestHandler.cs.meta new file mode 100644 index 0000000..0c1859f --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_GetTerminusIdRequestHandler.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: eea659b5f12f74a65a70272287f713b9 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LinkRoamingRequestHandler.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LinkRoamingRequestHandler.cs new file mode 100644 index 0000000..6efb58c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LinkRoamingRequestHandler.cs @@ -0,0 +1,26 @@ +#if FANTASY_NET +using Fantasy.Async; +using Fantasy.InnerMessage; +using Fantasy.Network.Interface; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace Fantasy.Roaming.Handler; + +public sealed class I_LinkRoamingRequestHandler : RouteRPC +{ + protected override async FTask Run(Scene scene, I_LinkRoamingRequest request, I_LinkRoamingResponse response, Action reply) + { + var (errorCode, roamingTerminal) = await scene.TerminusComponent.Create( + request.RoamingId, request.RoamingType, + request.ForwardSessionRouteId, request.SceneRouteId); + + if (errorCode != 0) + { + response.ErrorCode = errorCode; + return; + } + + response.TerminusId = roamingTerminal.TerminusId; + } +} +#endif diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LinkRoamingRequestHandler.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LinkRoamingRequestHandler.cs.meta new file mode 100644 index 0000000..3407594 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LinkRoamingRequestHandler.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 1edab638c51b7422484830f3b7c3d11b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LockTerminusIdRequestHandler.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LockTerminusIdRequestHandler.cs new file mode 100644 index 0000000..c530a1e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LockTerminusIdRequestHandler.cs @@ -0,0 +1,35 @@ +#if FANTASY_NET +using Fantasy.Async; +using Fantasy.InnerMessage; +using Fantasy.Network; +using Fantasy.Network.Interface; +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace Fantasy.Roaming.Handler; + +/// +/// 内部网络漫游锁定的请求处理。 +/// +internal sealed class I_LockTerminusIdRequestHandler : RouteRPC +{ + protected override async FTask Run(Scene scene, I_LockTerminusIdRequest request, I_LockTerminusIdResponse response, Action reply) + { + if (!scene.TryGetEntity(request.SessionRuntimeId, out var sessionEntity)) + { + response.ErrorCode = InnerErrorCode.ErrLockTerminusIdNotFoundSession; + return; + } + + var session = (Session)sessionEntity; + + if (!scene.RoamingComponent.TryGet(session, out var sessionRoamingComponent) || !sessionRoamingComponent.TryGetRoaming(request.RoamingType, out var sessionRoaming)) + { + response.ErrorCode = InnerErrorCode.ErrLockTerminusIdNotFoundRoamingType; + return; + } + + await sessionRoaming.LockTerminusId(); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LockTerminusIdRequestHandler.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LockTerminusIdRequestHandler.cs.meta new file mode 100644 index 0000000..bb4486d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_LockTerminusIdRequestHandler.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 4d3953fb917eb4b8fb53d654c653a0a8 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_TransferTerminusRequestHandler.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_TransferTerminusRequestHandler.cs new file mode 100644 index 0000000..162171f --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_TransferTerminusRequestHandler.cs @@ -0,0 +1,22 @@ +#if FANTASY_NET +using Fantasy.Async; +using Fantasy.InnerMessage; +using Fantasy.Network.Interface; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace Fantasy.Roaming.Handler; + +/// +/// 传送漫游Terminus的请求处理 +/// +internal sealed class I_TransferTerminusRequestHandler : RouteRPC +{ + protected override async FTask Run(Scene scene, I_TransferTerminusRequest request, I_TransferTerminusResponse response, Action reply) + { + // 添加Terminus到当前Scene下。 + scene.TerminusComponent.AddTerminus(request.Terminus); + // 执行Terminus的传送完成逻辑。 + await request.Terminus.TransferComplete(scene); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_TransferTerminusRequestHandler.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_TransferTerminusRequestHandler.cs.meta new file mode 100644 index 0000000..97f68f5 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_TransferTerminusRequestHandler.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 2f1b1162d244f496da2990219d989a58 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLinkRoamingRequestHandler.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLinkRoamingRequestHandler.cs new file mode 100644 index 0000000..5849b11 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLinkRoamingRequestHandler.cs @@ -0,0 +1,16 @@ +#if FANTASY_NET +using Fantasy.Async; +using Fantasy.InnerMessage; +using Fantasy.Network.Interface; + +namespace Fantasy.Roaming.Handler; + +internal sealed class I_UnLinkRoamingRequestHandler : RouteRPC +{ + protected override async FTask Run(Scene scene, I_UnLinkRoamingRequest request, I_UnLinkRoamingResponse response, Action reply) + { + scene.TerminusComponent.RemoveTerminus(request.RoamingId, request.DisposeRoaming); + await FTask.CompletedTask; + } +} +#endif diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLinkRoamingRequestHandler.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLinkRoamingRequestHandler.cs.meta new file mode 100644 index 0000000..763fdd3 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLinkRoamingRequestHandler.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 558534d3f205f482582990fa4f4584cd +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLockTerminusIdRequestHandler.cs b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLockTerminusIdRequestHandler.cs new file mode 100644 index 0000000..8a04079 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLockTerminusIdRequestHandler.cs @@ -0,0 +1,36 @@ +#if FANTASY_NET +using Fantasy.Async; +using Fantasy.InnerMessage; +using Fantasy.Network; +using Fantasy.Network.Interface; +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace Fantasy.Roaming.Handler; + +/// +/// 内部网络漫游解锁的请求处理。 +/// +internal sealed class I_UnLockTerminusIdRequestHandler : RouteRPC +{ + protected override async FTask Run(Scene scene, I_UnLockTerminusIdRequest request, I_UnLockTerminusIdResponse response, Action reply) + { + if (!scene.TryGetEntity(request.SessionRuntimeId, out var sessionEntity)) + { + response.ErrorCode = InnerErrorCode.ErrUnLockTerminusIdNotFoundSession; + return; + } + + var session = (Session)sessionEntity; + + if (!scene.RoamingComponent.TryGet(session, out var sessionRoamingComponent) || !sessionRoamingComponent.TryGetRoaming(request.RoamingType, out var sessionRoaming)) + { + response.ErrorCode = InnerErrorCode.ErrLockTerminusIdNotFoundRoamingType; + return; + } + + sessionRoaming.UnLockTerminusId(request.TerminusId, request.TargetSceneRouteId); + await FTask.CompletedTask; + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLockTerminusIdRequestHandler.cs.meta b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLockTerminusIdRequestHandler.cs.meta new file mode 100644 index 0000000..0911e33 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Roaming/Handler/I_UnLockTerminusIdRequestHandler.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 420ffc47f17df46eb87f2629ef51dc17 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Route/RouteComponent.cs b/FantasyNetTest/NBC/Core/Network/Route/RouteComponent.cs new file mode 100644 index 0000000..0d52e9a --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Route/RouteComponent.cs @@ -0,0 +1,82 @@ +using NBC.Entitas; +using NBC.Entitas.Interface; + +#if FANTASY_NET +namespace Fantasy.Network; + +/// +/// RouteComponent的AwakeSystem +/// +public sealed class RouteComponentAwakeSystem : AwakeSystem +{ + /// + /// Awake + /// + /// + /// + protected override void Awake(RouteComponent self) + { + ((Session)self.Parent).RouteComponent = self; + } +} + +/// +/// 自定义Route组件、如果要自定义Route协议必须使用这个组件 +/// +public sealed class RouteComponent : Entity +{ + /// + /// 存储路由类型和路由ID的映射关系。 + /// + public readonly Dictionary RouteAddress = new Dictionary(); + + /// + /// 添加路由类型和路由ID的映射关系。 + /// + /// 路由类型。 + /// 路由ID。 + public void AddAddress(long routeType, long routeId) + { + RouteAddress.Add(routeType, routeId); + } + + /// + /// 移除指定路由类型的映射关系。 + /// + /// 路由类型。 + public void RemoveAddress(long routeType) + { + RouteAddress.Remove(routeType); + } + + /// + /// 获取指定路由类型的路由ID。 + /// + /// 路由类型。 + /// 路由ID。 + public long GetRouteId(long routeType) + { + return RouteAddress.GetValueOrDefault(routeType, 0); + } + + /// + /// 尝试获取指定路由类型的路由ID。 + /// + /// 路由类型。 + /// 输出的路由ID。 + /// 如果获取成功返回true，否则返回false。 + public bool TryGetRouteId(long routeType, out long routeId) + { + return RouteAddress.TryGetValue(routeType, out routeId); + } + + /// + /// 释放组件资源，清空映射关系。 + /// + public override void Dispose() + { + RouteAddress.Clear(); + base.Dispose(); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Route/RouteComponent.cs.meta b/FantasyNetTest/NBC/Core/Network/Route/RouteComponent.cs.meta new file mode 100644 index 0000000..ce869a4 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Route/RouteComponent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 061c0d492751d4ca695e8ce5dff4253e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Session/Component.meta b/FantasyNetTest/NBC/Core/Network/Session/Component.meta new file mode 100644 index 0000000..f74fe28 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/Component.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 913e8547caf3843af95a4b3325cb03db +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Session/Component/ConsoleSessionHeartbeatComponent.cs b/FantasyNetTest/NBC/Core/Network/Session/Component/ConsoleSessionHeartbeatComponent.cs new file mode 100644 index 0000000..dc4677e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/Component/ConsoleSessionHeartbeatComponent.cs @@ -0,0 +1,156 @@ +// ReSharper disable MemberCanBePrivate.Global + +#if FANTASY_CONSOLE + +using System; +using Fantasy.Async; +using Fantasy.Entitas; +using Fantasy.Entitas.Interface; +using Fantasy.Helper; +using Fantasy.InnerMessage; +using Fantasy.Timer; +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. + +namespace Fantasy.Network +{ + public class SessionHeartbeatComponentAwakeSystem : AwakeSystem + { + protected override void Awake(SessionHeartbeatComponent self) + { + self.TimerComponent = self.Scene.TimerComponent; + } + } + + /// + /// 负责管理会话心跳的组件。 + /// + public class SessionHeartbeatComponent : Entity + { + public int TimeOut; + public long TimerId; + public long LastTime; + public long SelfRunTimeId; + public long TimeOutTimerId; + public long SessionRunTimeId; + public TimerComponent TimerComponent; + public EntityReference Session; + private readonly PingRequest _pingRequest = new PingRequest(); + + public int Ping { get; private set; } + + public override void Dispose() + { + if (IsDisposed) + { + return; + } + + Stop(); + Ping = 0; + Session = null; + TimeOut = 0; + SelfRunTimeId = 0; + base.Dispose(); + } + + /// + /// 使用指定的间隔启动心跳功能。 + /// + /// 以毫秒为单位的心跳请求发送间隔。 + /// 设置与服务器的通信超时时间，如果超过这个时间限制，将自动断开会话(Session)。 + /// 用于检测与服务器连接超时频率。 + public void Start(int interval, int timeOut = 2000, int timeOutInterval = 3000) + { + TimeOut = timeOut + interval; + Session = (Session)Parent; + SelfRunTimeId = RuntimeId; + LastTime = TimeHelper.Now; + + if (TimerComponent == null) + { + Log.Error("请在Unity的菜单执行Fantasy->Generate link.xml再重新打包"); + return; + } + + TimerId = TimerComponent.Net.RepeatedTimer(interval, () => RepeatedSend().Coroutine()); + TimeOutTimerId = TimerComponent.Net.RepeatedTimer(timeOutInterval, CheckTimeOut); + } + + private void CheckTimeOut() + { + if (TimeHelper.Now - LastTime < TimeOut) + { + return; + } + + Session entityReference = Session; + + if (entityReference == null) + { + return; + } + + entityReference.Dispose(); + } + + /// + /// 停止心跳功能。 + /// + public void Stop() + { + if (TimerId != 0) + { + TimerComponent?.Net.Remove(ref TimerId); + } + + if (TimeOutTimerId != 0) + { + TimerComponent?.Net.Remove(ref TimeOutTimerId); + } + } + + /// + /// 异步发送心跳请求并处理响应。 + /// + /// 表示进行中操作的异步任务。 + private async FTask RepeatedSend() + { + if (SelfRunTimeId != RuntimeId) + { + Stop(); + return; + } + + Session session = Session; + + if (session == null) + { + Dispose(); + return; + } + + try + { + var requestTime = TimeHelper.Now; + + var pingResponse = (PingResponse)await session.Call(_pingRequest); + + if (pingResponse.ErrorCode != 0) + { + return; + } + + var responseTime = TimeHelper.Now; + LastTime = responseTime; + Ping = (int)(responseTime - requestTime) / 2; + TimeHelper.TimeDiff = pingResponse.Now + Ping - responseTime; + } + catch (Exception) + { + Dispose(); + } + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Session/Component/ConsoleSessionHeartbeatComponent.cs.meta b/FantasyNetTest/NBC/Core/Network/Session/Component/ConsoleSessionHeartbeatComponent.cs.meta new file mode 100644 index 0000000..c71229b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/Component/ConsoleSessionHeartbeatComponent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 99fb296c5f69d491d9c4d0450f42318f +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Session/Component/SessionIdleCheckerComponent.cs b/FantasyNetTest/NBC/Core/Network/Session/Component/SessionIdleCheckerComponent.cs new file mode 100644 index 0000000..d50c2b1 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/Component/SessionIdleCheckerComponent.cs @@ -0,0 +1,103 @@ +using NBC.Entitas; +using NBC.Entitas.Interface; +using NBC.Helper; + +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#if FANTASY_NET +namespace Fantasy.Network; + +public class SessionIdleCheckerComponentAwakeSystem : AwakeSystem +{ + protected override void Awake(SessionIdleCheckerComponent self) + { + self.TimerComponent = self.Scene.TimerComponent; + } +} + +/// +/// 负责检查会话空闲超时的组件。 +/// +public class SessionIdleCheckerComponent : Entity +{ + /// + /// 空闲超时时间（毫秒） + /// + private long _timeOut; + /// + /// 检查计时器的 ID + /// + private long _timerId; + /// + /// 用于确保组件完整性的自身运行时 ID + /// + private long _selfRuntimeId; + /// + /// 对会话对象的引用 + /// + private Session _session; + public TimerComponent TimerComponent; + + /// + /// 重写 Dispose 方法以释放资源。 + /// + public override void Dispose() + { + Stop(); // 停止检查计时器 + _timeOut = 0; // 重置空闲超时时间 + _selfRuntimeId = 0; // 重置自身运行时 ID + _session = null; // 清除会话引用 + base.Dispose(); + } + + /// + /// 使用指定的间隔和空闲超时时间启动空闲检查功能。 + /// + /// 以毫秒为单位的检查间隔。 + /// 以毫秒为单位的空闲超时时间。 + public void Start(int interval, int timeOut) + { + _timeOut = timeOut; + _session = (Session)Parent; + _selfRuntimeId = RuntimeId; + // 安排重复计时器，在指定的间隔内执行 Check 方法 + _timerId = TimerComponent.Net.RepeatedTimer(interval, Check); + } + + /// + /// 停止空闲检查功能。 + /// + public void Stop() + { + if (_timerId == 0) + { + return; + } + + TimerComponent.Net.Remove(ref _timerId); + } + + /// + /// 执行空闲检查操作。 + /// + private void Check() + { + if (_selfRuntimeId != RuntimeId || IsDisposed || _session == null) + { + Stop(); + return; + } + + var timeNow = TimeHelper.Now; + + if (timeNow - _session.LastReceiveTime < _timeOut) + { + return; + } + + Log.Warning($"session timeout id:{Id} timeNow:{timeNow} _session.LastReceiveTime:{_session.LastReceiveTime} _timeOut:{_timeOut}"); + _session.Dispose(); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Session/Component/SessionIdleCheckerComponent.cs.meta b/FantasyNetTest/NBC/Core/Network/Session/Component/SessionIdleCheckerComponent.cs.meta new file mode 100644 index 0000000..8eae6c8 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/Component/SessionIdleCheckerComponent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: c6536d2ffd3214fdf87a649ad0914c90 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Session/Component/UnitySessionHeartbeatComponent.cs b/FantasyNetTest/NBC/Core/Network/Session/Component/UnitySessionHeartbeatComponent.cs new file mode 100644 index 0000000..2fb6975 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/Component/UnitySessionHeartbeatComponent.cs @@ -0,0 +1,153 @@ +// ReSharper disable MemberCanBePrivate.Global + +using System; +using NBC.Async; +using NBC.Entitas; +using NBC.Entitas.Interface; +using NBC.Helper; +using NBC.InnerMessage; + + +namespace NBC.Network +{ + public class SessionHeartbeatComponentAwakeSystem : AwakeSystem + { + protected override void Awake(SessionHeartbeatComponent self) + { + self.TimerComponent = self.Scene.TimerComponent; + } + } + + /// + /// 负责管理会话心跳的组件。 + /// + public class SessionHeartbeatComponent : Entity + { + public int TimeOut; + public long TimerId; + public long LastTime; + public long SelfRunTimeId; + public long TimeOutTimerId; + public TimerComponent TimerComponent; + public EntityReference Session; + private readonly PingRequest _pingRequest = new PingRequest(); + + public int Ping { get; private set; } + + public override void Dispose() + { + if (IsDisposed) + { + return; + } + + Stop(); + Ping = 0; + Session = null; + TimeOut = 0; + LastTime = 0; + SelfRunTimeId = 0; + base.Dispose(); + } + + /// + /// 使用指定的间隔启动心跳功能。 + /// + /// 以毫秒为单位的心跳请求发送间隔。 + /// 设置与服务器的通信超时时间，如果超过这个时间限制，将自动断开会话(Session)。 + /// 用于检测与服务器连接超时频率。 + public void Start(int interval, int timeOut = 5000, int timeOutInterval = 3000) + { + TimeOut = timeOut + interval; + Session = (Session)Parent; + SelfRunTimeId = RuntimeId; + LastTime = TimeHelper.Now; + + if (TimerComponent == null) + { + Log.Error("请在Unity的菜单执行Fantasy->Generate link.xml再重新打包"); + return; + } + + TimerId = TimerComponent.Unity.RepeatedTimer(interval, () => + { + RepeatedSend().Coroutine(); + }); + TimeOutTimerId = TimerComponent.Unity.RepeatedTimer(timeOutInterval, CheckTimeOut); + } + + private void CheckTimeOut() + { + if (TimeHelper.Now - LastTime < TimeOut) + { + return; + } + + Session entityReference = Session; + + if (entityReference == null) + { + return; + } + + entityReference.Dispose(); + } + + /// + /// 停止心跳功能。 + /// + public void Stop() + { + if (TimerId != 0) + { + TimerComponent?.Unity.Remove(ref TimerId); + } + + if (TimeOutTimerId != 0) + { + TimerComponent?.Unity.Remove(ref TimeOutTimerId); + } + } + + /// + /// 异步发送心跳请求并处理响应。 + /// + /// 表示进行中操作的异步任务。 + private async FTask RepeatedSend() + { + if (SelfRunTimeId != RuntimeId) + { + Stop(); + return; + } + + Session session = Session; + + if (session == null) + { + Dispose(); + return; + } + + try + { + var requestTime = TimeHelper.Now; + var pingResponse = (PingResponse)await session.Call(_pingRequest); + + if (pingResponse.ErrorCode != 0) + { + return; + } + + var responseTime = TimeHelper.Now; + LastTime = responseTime; + Ping = (int)(responseTime - requestTime) / 2; + TimeHelper.TimeDiff = pingResponse.Now + Ping - responseTime; + } + catch (Exception) + { + Dispose(); + } + } + } +} diff --git a/FantasyNetTest/NBC/Core/Network/Session/Component/UnitySessionHeartbeatComponent.cs.meta b/FantasyNetTest/NBC/Core/Network/Session/Component/UnitySessionHeartbeatComponent.cs.meta new file mode 100644 index 0000000..4749110 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/Component/UnitySessionHeartbeatComponent.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 457cbbb00597a4a50b1ff761ccd0335a +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Session/ProcessSession.meta b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession.meta new file mode 100644 index 0000000..361739c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: c344eba409d3d479295fec3e198e0376 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessScheduler.cs b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessScheduler.cs new file mode 100644 index 0000000..ec7c30c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessScheduler.cs @@ -0,0 +1,269 @@ +#if FANTASY_NET +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +using Fantasy.IdFactory; +using Fantasy.Network; +using Fantasy.Network.Interface; +using Fantasy.PacketParser.Interface; +using Fantasy.Platform.Net; + +namespace Fantasy.Scheduler; + +internal static class ProcessScheduler +{ + public static void Scheduler(this ProcessSession session, Type messageType, uint rpcId, long routeId, APackInfo packInfo) + { + switch (packInfo.OpCodeIdStruct.Protocol) + { + case OpCodeType.InnerResponse: + case OpCodeType.InnerRouteResponse: + case OpCodeType.InnerAddressableResponse: + case OpCodeType.InnerRoamingResponse: + case OpCodeType.OuterAddressableResponse: + case OpCodeType.OuterCustomRouteResponse: + case OpCodeType.OuterRoamingResponse: + { + using (packInfo) + { + var sessionScene = session.Scene; + var message = packInfo.Deserialize(messageType); + sessionScene.ThreadSynchronizationContext.Post(() => + { + // 因为有可能是其他Scene线程下发送过来的、所以必须放到当前Scene进程下运行。 + sessionScene.NetworkMessagingComponent.ResponseHandler(rpcId, (IResponse)message); + }); + } + + return; + } + case OpCodeType.InnerRouteMessage: + { + using (packInfo) + { + var sceneId = IdFactoryHelper.RuntimeIdTool.GetSceneId(ref routeId); + + if (!Process.TryGetScene(sceneId, out var scene)) + { + throw new Exception($"not found scene routeId:{routeId}"); + } + + var message = packInfo.Deserialize(messageType); + + scene.ThreadSynchronizationContext.Post(() => + { + var entity = scene.GetEntity(routeId); + var sceneMessageDispatcherComponent = scene.MessageDispatcherComponent; + + if (entity == null || entity.IsDisposed) + { + return; + } + + sceneMessageDispatcherComponent.RouteMessageHandler(session, messageType, entity, message, rpcId).Coroutine(); + }); + } + + return; + } + case OpCodeType.InnerRouteRequest: + { + using (packInfo) + { + var sceneId = IdFactoryHelper.RuntimeIdTool.GetSceneId(ref routeId); + + if (!Process.TryGetScene(sceneId, out var scene)) + { + throw new Exception($"not found scene routeId:{routeId}"); + } + + var message = packInfo.Deserialize(messageType); + + scene.ThreadSynchronizationContext.Post(() => + { + var entity = scene.GetEntity(routeId); + var sceneMessageDispatcherComponent = scene.MessageDispatcherComponent; + + if (entity == null || entity.IsDisposed) + { + sceneMessageDispatcherComponent.FailRouteResponse(session, messageType, InnerErrorCode.ErrNotFoundRoute, rpcId); + return; + } + + sceneMessageDispatcherComponent.RouteMessageHandler(session, messageType, entity, message, rpcId).Coroutine(); + }); + } + + return; + } + case OpCodeType.OuterAddressableMessage: + case OpCodeType.OuterCustomRouteMessage: + case OpCodeType.OuterAddressableRequest: + case OpCodeType.OuterCustomRouteRequest: + case OpCodeType.OuterRoamingMessage: + case OpCodeType.OuterRoamingRequest: + { + using (packInfo) + { + var sceneId = IdFactoryHelper.RuntimeIdTool.GetSceneId(ref routeId); + + if (!Process.TryGetScene(sceneId, out var scene)) + { + throw new NotSupportedException($"not found scene routeId = {routeId}"); + } + + var message = packInfo.Deserialize(messageType); + + scene.ThreadSynchronizationContext.Post(() => + { + var entity = scene.GetEntity(routeId); + + if (entity == null || entity.IsDisposed) + { + scene.MessageDispatcherComponent.FailRouteResponse(session, messageType, InnerErrorCode.ErrNotFoundRoute, rpcId); + return; + } + + scene.MessageDispatcherComponent.RouteMessageHandler(session, messageType, entity, message, rpcId).Coroutine(); + }); + } + return; + } + default: + { + var packInfoProtocolCode = packInfo.ProtocolCode; + packInfo.Dispose(); + throw new NotSupportedException($"SessionInnerScheduler Received unsupported message protocolCode:{packInfoProtocolCode} messageType:{messageType}"); + } + } + } + + public static void Scheduler(this ProcessSession session, Type messageType, uint rpcId, long routeId, uint protocolCode, object message) + { + OpCodeIdStruct opCodeIdStruct = protocolCode; + + switch (opCodeIdStruct.Protocol) + { + case OpCodeType.InnerResponse: + case OpCodeType.InnerRouteResponse: + case OpCodeType.InnerAddressableResponse: + case OpCodeType.InnerRoamingResponse: + case OpCodeType.OuterAddressableResponse: + case OpCodeType.OuterCustomRouteResponse: + case OpCodeType.OuterRoamingResponse: + { + var sessionScene = session.Scene; + sessionScene.ThreadSynchronizationContext.Post(() => + { + var iResponse = (IResponse)session.Deserialize(messageType, message, ref opCodeIdStruct); + // 因为有可能是其他Scene线程下发送过来的、所以必须放到当前Scene进程下运行。 + sessionScene.NetworkMessagingComponent.ResponseHandler(rpcId, iResponse); + }); + + return; + } + case OpCodeType.InnerRoamingMessage: + case OpCodeType.InnerAddressableMessage: + case OpCodeType.InnerRouteMessage: + { + var sceneId = IdFactoryHelper.RuntimeIdTool.GetSceneId(ref routeId); + + if (!Process.TryGetScene(sceneId, out var scene)) + { + throw new Exception($"not found scene routeId:{routeId}"); + } + + var messageObject = session.Deserialize(messageType, message, ref opCodeIdStruct); + + scene.ThreadSynchronizationContext.Post(() => + { + var entity = scene.GetEntity(routeId); + var sceneMessageDispatcherComponent = scene.MessageDispatcherComponent; + + if (entity == null || entity.IsDisposed) + { + return; + } + + sceneMessageDispatcherComponent.RouteMessageHandler(session, messageType, entity, messageObject, rpcId).Coroutine(); + }); + + return; + } + case OpCodeType.InnerAddressableRequest: + case OpCodeType.InnerRoamingRequest: + case OpCodeType.InnerRouteRequest: + { + var sceneId = IdFactoryHelper.RuntimeIdTool.GetSceneId(ref routeId); + + if (!Process.TryGetScene(sceneId, out var scene)) + { + throw new Exception($"not found scene routeId:{routeId}"); + } + + var messageObject = session.Deserialize(messageType, message, ref opCodeIdStruct); + + scene.ThreadSynchronizationContext.Post(() => + { + var entity = scene.GetEntity(routeId); + var sceneMessageDispatcherComponent = scene.MessageDispatcherComponent; + + if (entity == null || entity.IsDisposed) + { + sceneMessageDispatcherComponent.FailRouteResponse(session, message.GetType(), InnerErrorCode.ErrNotFoundRoute, rpcId); + return; + } + + sceneMessageDispatcherComponent.RouteMessageHandler(session, messageType, entity, messageObject, rpcId).Coroutine(); + }); + + return; + } + case OpCodeType.OuterAddressableMessage: + case OpCodeType.OuterCustomRouteMessage: + case OpCodeType.OuterRoamingMessage: + { + var sceneId = IdFactoryHelper.RuntimeIdTool.GetSceneId(ref routeId); + + if (!Process.TryGetScene(sceneId, out var scene)) + { + Log.Error($"not found scene routeId:{routeId}"); + return; + } + + var messageObject = session.Deserialize(messageType, message, ref opCodeIdStruct); + + scene.ThreadSynchronizationContext.Post(() => + { + var entity = scene.GetEntity(routeId); + + switch (entity) + { + case null: + { + // 执行到这里是说明Session已经断开了 + // 因为这里是其他服务器Send到外网的数据、所以不需要给发送端返回就可以 + return; + } + case Session gateSession: + { + // 这里如果是Session只可能是Gate的Session、如果是的话、肯定是转发Address消息 + gateSession.Send((IMessage)messageObject, rpcId); + return; + } + default: + { + scene.MessageDispatcherComponent.RouteMessageHandler(session, messageType, entity, messageObject, rpcId).Coroutine(); + return; + } + } + }); + + return; + } + default: + { + throw new NotSupportedException($"SessionInnerScheduler Received unsupported message protocolCode:{protocolCode} messageType:{messageType}"); + } + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessScheduler.cs.meta b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessScheduler.cs.meta new file mode 100644 index 0000000..269c511 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessScheduler.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a88ea22f28c7247039d360c1139b976e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSession.cs b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSession.cs new file mode 100644 index 0000000..c55df2b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSession.cs @@ -0,0 +1,124 @@ +using NBC.Async; +using NBC.Network.Interface; +using NBC.PacketParser; +using NBC.PacketParser.Interface; +using NBC.Pool; +using NBC.Scheduler; +using NBC.Serialize; +#pragma warning disable CS8604 // Possible null reference argument. +#pragma warning disable CS8603 // Possible null reference return. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#if FANTASY_NET +namespace Fantasy.Network; + +/// +/// 网络服务器内部会话。 +/// +public sealed class ProcessSession : Session +{ + private readonly MemoryStreamBufferPool _memoryStreamBufferPool = new MemoryStreamBufferPool(); + private readonly Dictionary> _createInstances = new Dictionary>(); + + /// + /// 发送消息到服务器内部。 + /// + /// 要发送的消息。 + /// RPC 标识符。 + /// 路由标识符。 + public override void Send(IMessage message, uint rpcId = 0, long routeId = 0) + { + if (IsDisposed) + { + return; + } + + this.Scheduler(message.GetType(), rpcId, routeId, message.OpCode(), message); + } + + /// + /// 发送路由消息到服务器内部。 + /// + /// 要发送的路由消息。 + /// RPC 标识符。 + /// 路由标识符。 + public override void Send(IRouteMessage routeMessage, uint rpcId = 0, long routeId = 0) + { + if (IsDisposed) + { + return; + } + + this.Scheduler(routeMessage.GetType(), rpcId, routeId, routeMessage.OpCode(), routeMessage); + } + + public override void Send(uint rpcId, long routeId, Type messageType, APackInfo packInfo) + { + if (IsDisposed) + { + return; + } + + this.Scheduler(messageType, rpcId, routeId, packInfo); + } + + public override void Send(ProcessPackInfo packInfo, uint rpcId = 0, long routeId = 0) + { + this.Scheduler(packInfo.MessageType, rpcId, routeId, packInfo); + } + + public override void Send(MemoryStreamBuffer memoryStream, uint rpcId = 0, long routeId = 0) + { + throw new Exception("The use of this method is not supported"); + } + + public override FTask Call(IRouteRequest request, long routeId = 0) + { + throw new Exception("The use of this method is not supported"); + } + + public override FTask Call(IRequest request, long routeId = 0) + { + throw new Exception("The use of this method is not supported"); + } + + public object Deserialize(Type messageType, object message, ref OpCodeIdStruct opCodeIdStruct) + { + var memoryStream = _memoryStreamBufferPool.RentMemoryStream(MemoryStreamBufferSource.None); + + try + { + if (SerializerManager.TryGetSerializer(opCodeIdStruct.OpCodeProtocolType, out var serializer)) + { + serializer.Serialize(messageType, message, memoryStream); + + if (memoryStream.Position == 0) + { + if (_createInstances.TryGetValue(messageType, out var createInstance)) + { + return createInstance(); + } + + createInstance = CreateInstance.CreateObject(messageType); + _createInstances.Add(messageType, createInstance); + return createInstance(); + } + + memoryStream.SetLength(memoryStream.Position); + memoryStream.Seek(0, SeekOrigin.Begin); + return serializer.Deserialize(messageType, memoryStream); + } + } + catch (Exception e) + { + Log.Error($"ProcessSession.Deserialize {e}"); + } + finally + { + _memoryStreamBufferPool.ReturnMemoryStream(memoryStream); + } + + throw new Exception($"type:{messageType} Does not support processing protocol"); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSession.cs.meta b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSession.cs.meta new file mode 100644 index 0000000..6d2ab0e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSession.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: af272d9643ac74c4dad1cf580f9f6ba6 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSessionInfo.cs b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSessionInfo.cs new file mode 100644 index 0000000..1bc72bb --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSessionInfo.cs @@ -0,0 +1,17 @@ +using NBC.Network.Interface; + +#if FANTASY_NET +namespace Fantasy.Network; + +internal sealed class ProcessSessionInfo(Session session, AClientNetwork aClientNetwork) : IDisposable +{ + public readonly Session Session = session; + public readonly AClientNetwork AClientNetwork = aClientNetwork; + + public void Dispose() + { + Session.Dispose(); + AClientNetwork?.Dispose(); + } +} +#endif diff --git a/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSessionInfo.cs.meta b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSessionInfo.cs.meta new file mode 100644 index 0000000..b4df682 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/ProcessSession/ProcessSessionInfo.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 95db8925726a34b0dae70295cbd646f0 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Network/Session/Session.cs b/FantasyNetTest/NBC/Core/Network/Session/Session.cs new file mode 100644 index 0000000..d4f1991 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/Session.cs @@ -0,0 +1,278 @@ +// ReSharper disable RedundantUsingDirective + +using System; +using System.Collections.Generic; +using System.IO; +using System.Linq; +using System.Net; +using NBC.PacketParser; +using NBC.Serialize; +using NBC.Async; +using NBC.Entitas; +using NBC.Entitas.Interface; +using NBC.Helper; +using NBC.Network.Interface; +using NBC.PacketParser.Interface; +using NBC.Scheduler; +#if FANTASY_NET +using Fantasy.Network.Route; +using Fantasy.Platform.Net; +using Fantasy.Network.Roaming; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#endif + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8603 +#pragma warning disable CS8601 +#pragma warning disable CS8618 + +namespace NBC.Network +{ + /// + /// 网络会话的基类，用于管理网络通信。 + /// + public class Session : Entity, ISupportedMultiEntity + { + private uint _rpcId; + internal long LastReceiveTime; + + /// + /// 关联的网络连接通道 + /// + internal INetworkChannel Channel { get; private set; } + + /// + /// 当前Session的终结点信息 + /// + public IPEndPoint RemoteEndPoint { get; private set; } + + private ANetworkMessageScheduler NetworkMessageScheduler { get; set; } + internal readonly Dictionary> RequestCallback = new(); + /// + /// Session的Dispose委托 + /// + internal event Action OnDispose; +#if FANTASY_NET + internal RouteComponent RouteComponent; + internal SessionRoamingComponent SessionRoamingComponent; + internal AddressableRouteComponent AddressableRouteComponent; + internal static Session Create(ANetworkMessageScheduler networkMessageScheduler, ANetworkServerChannel channel, NetworkTarget networkTarget) + { + var session = Entity.Create(channel.Scene, false, true); + session.Channel = channel; + session.NetworkMessageScheduler = networkMessageScheduler; + session.RemoteEndPoint = channel.RemoteEndPoint as IPEndPoint; + session.OnDispose = channel.Dispose; + session.LastReceiveTime = TimeHelper.Now; + // 在外部网络目标下，添加会话空闲检查组件 + if (networkTarget == NetworkTarget.Outer) + { + var interval = ProcessDefine.SessionIdleCheckerInterval; + var timeOut = ProcessDefine.SessionIdleCheckerTimeout; + session.AddComponent().Start(interval, timeOut); + } + return session; + } +#endif + internal static Session Create(AClientNetwork network, IPEndPoint remoteEndPoint) + { + // 创建会话实例 + var session = Entity.Create(network.Scene, false, true); + session.Channel = network; + session.RemoteEndPoint = remoteEndPoint; + session.OnDispose = network.Dispose; + session.NetworkMessageScheduler = network.NetworkMessageScheduler; + session.LastReceiveTime = TimeHelper.Now; + return session; + } +#if FANTASY_NET + internal static ProcessSession CreateInnerSession(Scene scene) + { + var session = Entity.Create(scene, false, false); + session.NetworkMessageScheduler = new InnerMessageScheduler(scene); + return session; + } + + /// + /// 发送一个消息，框架内部使用建议不要用这个方法。 + /// + /// 如果是RPC消息需要传递一个RPCId + /// routeId + /// 消息的类型 + /// packInfo消息包 + public virtual void Send(uint rpcId, long routeId, Type messageType, APackInfo packInfo) + { + if (IsDisposed) + { + return; + } + + Channel.Send(rpcId, routeId, packInfo.MemoryStream, null); + } + + /// + /// 发送一个消息，框架内部使用建议不要用这个方法。 + /// + /// 一个ProcessPackInfo消息包 + /// 如果是RPC消息需要传递一个RPCId + /// routeId + public virtual void Send(ProcessPackInfo packInfo, uint rpcId = 0, long routeId = 0) + { + if (IsDisposed) + { + return; + } + + using (packInfo) + { + Channel.Send(rpcId, routeId, packInfo.MemoryStream, null); + } + } + + /// + /// 发送一个消息 + /// + /// 需要发送的MemoryStreamBuffer + /// 如果是RPC消息需要传递一个RPCId + /// routeId + public virtual void Send(MemoryStreamBuffer memoryStream, uint rpcId = 0, long routeId = 0) + { + if (IsDisposed) + { + return; + } + + Channel.Send(rpcId, routeId, memoryStream, null); + } +#endif + /// + /// 销毁一个Session，当执行了这个方法会自动断开网络的连接。 + /// + public override void Dispose() + { + if (IsDisposed) + { + return; + } + + _rpcId = 0; + LastReceiveTime = 0; + Channel = null; + RemoteEndPoint = null; + NetworkMessageScheduler = null; +#if FANTASY_NET + SessionRoamingComponent = null; + RouteComponent = null; + AddressableRouteComponent = null; +#endif + base.Dispose(); + + // 终止所有等待中的请求回调 + foreach (var requestCallback in RequestCallback.Values.ToArray()) + { + requestCallback.SetException(new Exception($"session is dispose: {Id}")); + } + + RequestCallback.Clear(); + OnDispose?.Invoke(); + } + + /// + /// 发送一个消息 + /// + /// 消息的实例 + /// 如果是RPC消息需要传递一个RPCId + /// routeId + public virtual void Send(IMessage message, uint rpcId = 0, long routeId = 0) + { + if (IsDisposed) + { + return; + } + + Channel.Send(rpcId, routeId, null, message); + } + + /// + /// 发送一个消息 + /// + /// 消息的实例，不同的是这个是发送Route消息使用的 + /// 如果是RPC消息需要传递一个RPCId + /// routeId + public virtual void Send(IRouteMessage routeMessage, uint rpcId = 0, long routeId = 0) + { + if (IsDisposed) + { + return; + } + + Channel.Send(rpcId, routeId, null, routeMessage); + } + + /// + /// 发送一个RPC消息 + /// + /// 请求Route消息的实例 + /// routeId + /// + public virtual FTask Call(IRouteRequest request, long routeId = 0) + { + if (IsDisposed) + { + return null; + } + + var requestCallback = FTask.Create(); + var rpcId = ++_rpcId; + RequestCallback.Add(rpcId, requestCallback); + Send(request, rpcId, routeId); + return requestCallback; + } + + /// + /// 发送一个RPC消息 + /// + /// 请求消息的实例 + /// routeId + /// + public virtual FTask Call(IRequest request, long routeId = 0) + { + if (IsDisposed) + { + return null; + } + + NetMessageDelegate.Request(request, routeId); + var requestCallback = FTask.Create(); + var rpcId = ++_rpcId; + RequestCallback.Add(rpcId, requestCallback); + Send(request, rpcId, routeId); + return requestCallback; + } + + internal void Receive(APackInfo packInfo) + { + if (IsDisposed) + { + return; + } + + LastReceiveTime = TimeHelper.Now; + + try + { + NetworkMessageScheduler.Scheduler(this, packInfo).Coroutine(); + } + catch (Exception e) + { + // 如果解析失败，只有一种可能，那就是有人恶意发包。 + // 所以这里强制关闭了当前连接。不让对方一直发包。 + Dispose(); + Log.Error(e); + } + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Network/Session/Session.cs.meta b/FantasyNetTest/NBC/Core/Network/Session/Session.cs.meta new file mode 100644 index 0000000..ad17a41 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Network/Session/Session.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 5376c3723b02540d4955f019e0826a7a +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonDefaultValueAttribute.cs b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonDefaultValueAttribute.cs new file mode 100644 index 0000000..b49d009 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonDefaultValueAttribute.cs @@ -0,0 +1,9 @@ +using System; +namespace MongoDB.Bson.Serialization.Attributes +{ + [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)] + public class BsonDefaultValueAttribute : Attribute + { + public BsonDefaultValueAttribute(object defaultValue) { } + } +} diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonDefaultValueAttribute.cs.meta b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonDefaultValueAttribute.cs.meta new file mode 100644 index 0000000..2d6be4d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonDefaultValueAttribute.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 0667920f73ddb4da4b61aaf8a6704520 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonElementAttribute.cs b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonElementAttribute.cs new file mode 100644 index 0000000..7e1d7cc --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonElementAttribute.cs @@ -0,0 +1,11 @@ +using System; +namespace MongoDB.Bson.Serialization.Attributes +{ + [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)] + public class BsonElementAttribute : Attribute + { + public BsonElementAttribute() { } + + public BsonElementAttribute(string elementName) { } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonElementAttribute.cs.meta b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonElementAttribute.cs.meta new file mode 100644 index 0000000..4de7566 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonElementAttribute.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 1bd8935bc9b394975ba1c0eeab13f817 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIdAttribute.cs b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIdAttribute.cs new file mode 100644 index 0000000..46e3bc7 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIdAttribute.cs @@ -0,0 +1,9 @@ +using System; +namespace MongoDB.Bson.Serialization.Attributes +{ + [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property)] + public class BsonIdAttribute : Attribute + { + + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIdAttribute.cs.meta b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIdAttribute.cs.meta new file mode 100644 index 0000000..b014fb9 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIdAttribute.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a024b9c70f7be4dfd8d94e184d729f63 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreAttribute.cs b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreAttribute.cs new file mode 100644 index 0000000..59852c4 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreAttribute.cs @@ -0,0 +1,9 @@ +using System; +namespace MongoDB.Bson.Serialization.Attributes +{ + [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)] + public class BsonIgnoreAttribute : Attribute + { + + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreAttribute.cs.meta b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreAttribute.cs.meta new file mode 100644 index 0000000..e2cc58c --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreAttribute.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: e44cd65ae1ffc4545a329acf15eaf24b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfDefaultAttribute.cs b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfDefaultAttribute.cs new file mode 100644 index 0000000..279653b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfDefaultAttribute.cs @@ -0,0 +1,11 @@ +using System; +namespace MongoDB.Bson.Serialization.Attributes +{ + [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)] + public class BsonIgnoreIfDefaultAttribute : Attribute + { + public BsonIgnoreIfDefaultAttribute() { } + + public BsonIgnoreIfDefaultAttribute(bool value) { } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfDefaultAttribute.cs.meta b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfDefaultAttribute.cs.meta new file mode 100644 index 0000000..e8488ad --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfDefaultAttribute.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 28808e0d128ab46e2b98ad3285c6fd3d +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfNullAttribute.cs b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfNullAttribute.cs new file mode 100644 index 0000000..08cf30d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfNullAttribute.cs @@ -0,0 +1,9 @@ +using System; +namespace MongoDB.Bson.Serialization.Attributes +{ + [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property)] + public class BsonIgnoreIfNullAttribute : Attribute + { + + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfNullAttribute.cs.meta b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfNullAttribute.cs.meta new file mode 100644 index 0000000..e70b6ba --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Attributes/BsonIgnoreIfNullAttribute.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: d6e7c0b5e3e9c4119aa3eddbe2bad2e0 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Entry.cs b/FantasyNetTest/NBC/Core/Platform/Unity/Entry.cs new file mode 100644 index 0000000..5300213 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Entry.cs @@ -0,0 +1,94 @@ +using NBC.Assembly; +using NBC.Serialize; + +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8603 // Possible null reference return. +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. + +namespace NBC.Platform.Unity +{ + // public sealed class FantasyObject : MonoBehaviour + // { + // public static GameObject FantasyObjectGameObject { get; private set; } + // + // public static void OnRuntimeMethodLoad() + // { + // FantasyObjectGameObject = new GameObject("Fantasy.Net"); + // DontDestroyOnLoad(FantasyObjectGameObject); + // } + // private void OnApplicationQuit() + // { + // Destroy(FantasyObjectGameObject); + // } + // } + + public struct OnSceneCreate + { + public Scene Scene; + public object Arg; + } + + public class Entry + { + private static bool _isInit; + public static Scene Scene { get; private set; } + + /// + /// 初始化框架 + /// + /// + public static async FTask Initialize(params System.Reflection.Assembly[] assemblies) + { + if (_isInit) + { + Log.Error("Fantasy has already been initialized and does not need to be initialized again!"); + return null; + } + // FantasyObject.OnRuntimeMethodLoad(); + Log.Register(new UnityLog()); + await AssemblySystem.InnerInitialize(assemblies); + // 初始化序列化 + SerializerManager.Initialize(); + _isInit = true; + // FantasyObject.FantasyObjectGameObject.AddComponent(); + Log.Debug("Fantasy Initialize Complete!"); + return new Entry(); + } + + /// + /// 在Entry中创建一个Scene，如果Scene已经被创建过，将先销毁Scene再创建。 + /// + /// + /// + /// + public static async FTask CreateScene(object arg = null, string sceneRuntimeMode = SceneRuntimeMode.MainThread) + { + Scene?.Dispose(); + Scene = await Scene.Create(sceneRuntimeMode); + await Scene.EventComponent.PublishAsync(new OnSceneCreate() + { + Arg = arg, + Scene = Scene + }); + return Scene; + } + + public void Update() + { + ThreadScheduler.Update(); + } + + public void OnDestroy() + { + AssemblySystem.Dispose(); + SerializerManager.Dispose(); + if (Scene != null) + { + Scene?.Dispose(); + Scene = null; + } + _isInit = false; + } + } +} diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/Temp.cs b/FantasyNetTest/NBC/Core/Platform/Unity/Temp.cs new file mode 100644 index 0000000..399488f --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/Temp.cs @@ -0,0 +1,108 @@ +// using System.Reflection; +// using Fantasy.Assembly; +// using Fantasy.Async; +// // using UnityEngine; +// #pragma warning disable CS0649 // Field is never assigned to, and will always have its default value +// #pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +// #pragma warning disable CS8603 // Possible null reference return. +// #pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +// #pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +// +// namespace Fantasy.Platform.Unity +// { +// public class MonoBehaviour +// { +// +// } +// +// public class GameObject +// { +// public GameObject(string name) +// { +// +// } +// } +// +// internal enum RuntimeInitializeLoadType +// { +// BeforeSceneLoad = 1, +// } +// +// internal class RuntimeInitializeOnLoadMethodAttribute : Attribute +// { +// public RuntimeInitializeLoadType RuntimeInitializeLoadType; +// +// public RuntimeInitializeOnLoadMethodAttribute(RuntimeInitializeLoadType loadType) +// { +// +// } +// } +// +// public sealed class FantasyObject : MonoBehaviour +// { +// public static GameObject FantasyObjectGameObject { get; private set; } +// // 这个方法将在游戏启动时自动调用 +// [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)] +// static void OnRuntimeMethodLoad() +// { +// FantasyObjectGameObject = new GameObject("Fantasy.Net"); +// // DontDestroyOnLoad(FantasyObjectGameObject); +// } +// private void OnApplicationQuit() +// { +// // Destroy(FantasyObjectGameObject); +// } +// } +// +// public struct OnFantasyInit +// { +// public Scene Scene; +// } +// +// public class Entry : MonoBehaviour +// { +// private static bool _isInit; +// public static Scene Scene { get; private set; } +// /// +// /// 初始化框架 +// /// +// public static async FTask Initialize(params System.Reflection.Assembly[] assemblies) +// { +// Scene?.Dispose(); +// // 初始化程序集管理系统 +// AssemblySystem.Initialize(assemblies); +// if (!_isInit) +// { +// #if FANTASY_WEBGL +// ThreadSynchronizationContext.Initialize(); +// #endif +// _isInit = true; +// // FantasyObject.FantasyObjectGameObject.AddComponent(); +// } +// // Scene = await Scene.Create(SceneRuntimeType.MainThread); +// // await Scene.EventComponent.PublishAsync(new OnFantasyInit() +// // { +// // Scene = Scene +// // }); +// // return Scene; +// await FTask.CompletedTask; +// return null; +// } +// +// private void Update() +// { +// ThreadScheduler.Update(); +// } +// +// private void OnDestroy() +// { +// AssemblySystem.Dispose(); +// if (Scene != null) +// { +// Scene?.Dispose(); +// Scene = null; +// } +// _isInit = false; +// } +// } +// } diff --git a/FantasyNetTest/NBC/Core/Platform/Unity/ThreadSynchronizationContext.cs b/FantasyNetTest/NBC/Core/Platform/Unity/ThreadSynchronizationContext.cs new file mode 100644 index 0000000..a0525ce --- /dev/null +++ b/FantasyNetTest/NBC/Core/Platform/Unity/ThreadSynchronizationContext.cs @@ -0,0 +1,40 @@ +#pragma warning disable CS8765 +#pragma warning disable CS8601 +#pragma warning disable CS8618 +using System; +using System.Collections.Concurrent; +using System.Threading; + +namespace NBC +{ + public sealed class ThreadSynchronizationContext : SynchronizationContext + { + private Action _actionHandler; + private readonly ConcurrentQueue _queue = new(); + + public void Update() + { + while (_queue.TryDequeue(out _actionHandler)) + { + try + { + _actionHandler(); + } + catch (Exception e) + { + Log.Error(e); + } + } + } + + public override void Post(SendOrPostCallback callback, object state) + { + Post(() => callback(state)); + } + + public void Post(Action action) + { + _queue.Enqueue(action); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPool.cs b/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPool.cs new file mode 100644 index 0000000..f3a61ec --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPool.cs @@ -0,0 +1,37 @@ +#if !FANTASY_WEBGL +using System; +using System.Collections.Concurrent; +using System.Runtime.CompilerServices; +#pragma warning disable CS8603 // Possible null reference return. + +namespace NBC.Pool +{ + /// + /// 线程安全的静态通用对象池。 + /// + internal static class MultiThreadPool + { + private static readonly ConcurrentDictionary ObjectPools = new ConcurrentDictionary(); + + public static T Rent() where T : IPool, new() + { + return ObjectPools.GetOrAdd(typeof(T), t => new MultiThreadPoolQueue(2000, () => new T())).Rent(); + } + + public static IPool Rent(Type type) + { + return ObjectPools.GetOrAdd(type, t => new MultiThreadPoolQueue(2000, CreateInstance.CreateIPool(type))).Rent(); + } + + public static void Return(T obj) where T : IPool, new() + { + if (!obj.IsPool()) + { + return; + } + + ObjectPools.GetOrAdd(typeof(T), t => new MultiThreadPoolQueue(2000, () => new T())).Return(obj); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPool.cs.meta b/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPool.cs.meta new file mode 100644 index 0000000..e0ae74a --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPool.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: f4295246cc4ad4e9ab1c09acbc4bbbc1 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPoolQueue.cs b/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPoolQueue.cs new file mode 100644 index 0000000..2cabc10 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPoolQueue.cs @@ -0,0 +1,76 @@ +#if !FANTASY_WEBGL +using System; +using System.Collections.Concurrent; +using System.Threading; +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8601 // Possible null reference assignment. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8603 // Possible null reference return. + +namespace NBC.Pool +{ + /// + /// 线程安全的对象池。 + /// + internal class MultiThreadPoolQueue + { + private int _poolCount; + private readonly int _maxCapacity; + private readonly Func _createInstance; + private readonly ConcurrentQueue _poolQueue = new ConcurrentQueue(); + private MultiThreadPoolQueue() { } + + public MultiThreadPoolQueue(int maxCapacity, Func createInstance) + { + _maxCapacity = maxCapacity; + _createInstance = createInstance; + } + + public T Rent() where T : IPool, new() + { + if (!_poolQueue.TryDequeue(out var t)) + { + var pool = new T(); + pool.SetIsPool(true); + return pool; + } + + t.SetIsPool(true); + Interlocked.Decrement(ref _poolCount); + return (T)t; + } + + public IPool Rent() + { + if (!_poolQueue.TryDequeue(out var t)) + { + var instance = _createInstance(); + instance.SetIsPool(true); + return instance; + } + + t.SetIsPool(true); + Interlocked.Decrement(ref _poolCount); + return t; + } + + public void Return(IPool obj) + { + if (!obj.IsPool()) + { + return; + } + + obj.SetIsPool(false); + + if (Interlocked.Increment(ref _poolCount) <= _maxCapacity) + { + _poolQueue.Enqueue(obj); + return; + } + + Interlocked.Decrement(ref _poolCount); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPoolQueue.cs.meta b/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPoolQueue.cs.meta new file mode 100644 index 0000000..d9a3267 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Concurrent/MultiThreadPoolQueue.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 5520348a236554f5380103f259f87dfd +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Pool/Interface/IPool.cs b/FantasyNetTest/NBC/Core/Pool/Interface/IPool.cs new file mode 100644 index 0000000..cccb018 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Interface/IPool.cs @@ -0,0 +1,18 @@ +namespace NBC.Pool +{ + /// + /// 实现了这个接口代表支持对象池 + /// + public interface IPool + { + /// + /// 是否从池里创建的 + /// + bool IsPool(); + /// + /// 设置是否从池里创建的 + /// + /// + void SetIsPool(bool isPool); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Pool/Interface/IPool.cs.meta b/FantasyNetTest/NBC/Core/Pool/Interface/IPool.cs.meta new file mode 100644 index 0000000..44c50ff --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Interface/IPool.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 91cd6661b42dc41cfaad00203a86ce3c +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Pool/Normal/Pool.cs b/FantasyNetTest/NBC/Core/Pool/Normal/Pool.cs new file mode 100644 index 0000000..be92ab8 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Normal/Pool.cs @@ -0,0 +1,77 @@ +using System; +using System.Collections.Generic; +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +// ReSharper disable CheckNamespace + +namespace NBC.Pool +{ + /// + /// 静态的对象池系统，不支持多线程。 + /// + /// + public static class Pool where T : IPool, new() + { + private static readonly Queue PoolQueue = new Queue(); + /// + /// 池子里可用的数量 + /// + public static int Count => PoolQueue.Count; + + /// + /// 租借 + /// + /// + public static T Rent() + { + return PoolQueue.Count == 0 ? new T() : PoolQueue.Dequeue(); + } + + /// + /// 租借 + /// + /// 如果池子里没有，会先执行这个委托。 + /// + public static T Rent(Func generator) + { + return PoolQueue.Count == 0 ? generator() : PoolQueue.Dequeue(); + } + + /// + /// 返还 + /// + /// + public static void Return(T t) + { + if (t == null) + { + return; + } + + PoolQueue.Enqueue(t); + } + + /// + /// 返还 + /// + /// 返还的东西 + /// 返还后执行的委托 + public static void Return(T t, Action reset) + { + if (t == null) + { + return; + } + + reset(t); + PoolQueue.Enqueue(t); + } + + /// + /// 清空池子 + /// + public static void Clear() + { + PoolQueue.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Pool/Normal/Pool.cs.meta b/FantasyNetTest/NBC/Core/Pool/Normal/Pool.cs.meta new file mode 100644 index 0000000..ef447aa --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Normal/Pool.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 6bf3e1dd4e39a4ae4ababd3770ed431d +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Pool/Normal/PoolCore.cs b/FantasyNetTest/NBC/Core/Pool/Normal/PoolCore.cs new file mode 100644 index 0000000..78d28bc --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Normal/PoolCore.cs @@ -0,0 +1,203 @@ +using System; +using System.Collections.Generic; +using System.Runtime.CompilerServices; +using NBC.DataStructure.Collection; + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +#pragma warning disable CS8603 // Possible null reference return. + +namespace NBC.Pool +{ + /// + /// 对象池抽象接口，用于创建和管理可重复使用的对象实例。 + /// + public abstract class PoolCore : IDisposable + { + private int _poolCount; + private readonly int _maxCapacity; + /// + /// 池子里可用的数量 + /// + public int Count => _poolQueue.Count; + private readonly OneToManyQueue _poolQueue = new OneToManyQueue(); + private readonly Dictionary> _typeCheckCache = new Dictionary>(); + + /// + /// 构造函数 + /// + /// 初始的容量 + protected PoolCore(int maxCapacity) + { + _maxCapacity = maxCapacity; + } + + /// + /// 租借 + /// + /// + /// + public T Rent() where T : IPool, new() + { + if (!_poolQueue.TryDequeue(typeof(T), out var queue)) + { + queue = new T(); + } + + queue.SetIsPool(true); + _poolCount--; + return (T)queue; + } + + /// + /// 租借 + /// + /// 租借的类型 + /// + /// + public IPool Rent(Type type) + { + if (!_poolQueue.TryDequeue(type, out var queue)) + { + if (!_typeCheckCache.TryGetValue(type, out var createInstance)) + { + if (!typeof(IPool).IsAssignableFrom(type)) + { + throw new NotSupportedException($"{this.GetType().FullName} Type:{type.FullName} must inherit from IPool"); + } + else + { + createInstance = CreateInstance.CreateIPool(type); + _typeCheckCache[type] = createInstance; + } + } + + var instance = createInstance(); + instance.SetIsPool(true); + return instance; + } + + queue.SetIsPool(true); + _poolCount--; + return queue; + } + + /// + /// 返还 + /// + /// + /// + public void Return(Type type, IPool obj) + { + if (obj == null) + { + return; + } + + if (!obj.IsPool()) + { + return; + } + + if (_poolCount >= _maxCapacity) + { + return; + } + + _poolCount++; + obj.SetIsPool(false); + _poolQueue.Enqueue(type, obj); + } + + /// + /// 销毁方法 + /// + public virtual void Dispose() + { + _poolCount = 0; + _poolQueue.Clear(); + _typeCheckCache.Clear(); + } + } + + /// + /// 泛型对象池核心类，用于创建和管理可重复使用的对象实例。 + /// + /// 要池化的对象类型 + public abstract class PoolCore where T : IPool, new() + { + private int _poolCount; + private readonly int _maxCapacity; + private readonly Queue _poolQueue = new Queue(); + /// + /// 池子里可用的数量 + /// + public int Count => _poolQueue.Count; + + /// + /// 构造函数 + /// + /// 初始的容量 + protected PoolCore(int maxCapacity) + { + _maxCapacity = maxCapacity; + } + + /// + /// 租借 + /// + /// + public virtual T Rent() + { + T dequeue; + + if (_poolQueue.Count == 0) + { + dequeue = new T(); + } + else + { + _poolCount--; + dequeue = _poolQueue.Dequeue(); + } + + dequeue.SetIsPool(true); + return dequeue; + } + + /// + /// 返还 + /// + /// + public virtual void Return(T item) + { + if (item == null) + { + return; + } + + if (!item.IsPool()) + { + return; + } + + if (_poolCount >= _maxCapacity) + { + return; + } + + _poolCount++; + item.SetIsPool(false); + _poolQueue.Enqueue(item); + } + + /// + /// 销毁方法 + /// + public virtual void Dispose() + { + _poolCount = 0; + _poolQueue.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Pool/Normal/PoolCore.cs.meta b/FantasyNetTest/NBC/Core/Pool/Normal/PoolCore.cs.meta new file mode 100644 index 0000000..5ed7e6a --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Normal/PoolCore.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 12336238185b447c1af2fbd1eb1f2b7f +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Pool/Normal/PoolWithDisposable.cs b/FantasyNetTest/NBC/Core/Pool/Normal/PoolWithDisposable.cs new file mode 100644 index 0000000..3e27100 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Normal/PoolWithDisposable.cs @@ -0,0 +1,140 @@ +using System; +using System.Collections.Generic; +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract + +namespace NBC.Pool +{ + /// + /// 静态通用对象池，用于存储实现了 IDisposable 接口的对象。 + /// + /// 要存储在对象池中的对象类型，必须实现 IDisposable 接口。 + public abstract class PoolWithDisposable : IDisposable where T : IPool, IDisposable, new() + { + private int _poolCount; + private readonly int _maxCapacity; + private readonly Queue _poolQueue = new Queue(); + /// + /// 池子里可用的数量 + /// + public int Count => _poolQueue.Count; + + /// + /// 构造函数 + /// + /// 初始的容量 + protected PoolWithDisposable(int maxCapacity) + { + _maxCapacity = maxCapacity; + } + + /// + /// 租借 + /// + /// + public T Rent() + { + T dequeue; + if (_poolQueue.Count == 0) + { + dequeue = new T(); + } + else + { + _poolCount--; + dequeue = _poolQueue.Dequeue(); + } + + dequeue.SetIsPool(true); + return dequeue; + } + + /// + /// 租借 + /// + /// + /// + public T Rent(Func generator) + { + T dequeue; + + if (_poolQueue.Count == 0) + { + dequeue = generator(); + } + else + { + _poolCount--; + dequeue = _poolQueue.Dequeue(); + } + + dequeue.SetIsPool(true); + return dequeue; + } + + /// + /// 返还 + /// + /// + public void Return(T t) + { + if (t == null) + { + return; + } + + if (!t.IsPool()) + { + return; + } + + if (_poolCount >= _maxCapacity) + { + return; + } + + _poolCount++; + t.SetIsPool(true); + _poolQueue.Enqueue(t); + t.Dispose(); + } + + /// + /// 返还 + /// + /// + /// + public void Return(T t, Action reset) + { + if (t == null) + { + return; + } + + if (!t.IsPool()) + { + reset(t); + return; + } + + if (_poolCount >= _maxCapacity) + { + return; + } + + reset(t); + _poolCount++; + t.SetIsPool(false); + _poolQueue.Enqueue(t); + t.Dispose(); + } + + /// + /// 销毁方法 + /// + public virtual void Dispose() + { + _poolCount = 0; + _poolQueue.Clear(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Pool/Normal/PoolWithDisposable.cs.meta b/FantasyNetTest/NBC/Core/Pool/Normal/PoolWithDisposable.cs.meta new file mode 100644 index 0000000..9fa4476 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/Normal/PoolWithDisposable.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 37d96a9ea60d8412c9c549446e970aaf +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Pool/PoolHelper.cs b/FantasyNetTest/NBC/Core/Pool/PoolHelper.cs new file mode 100644 index 0000000..e56b428 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Pool/PoolHelper.cs @@ -0,0 +1,79 @@ +using System; +using System.Reflection.Emit; +using NBC.Serialize; + +#pragma warning disable CS8604 // Possible null reference argument. + +namespace NBC.Pool +{ + internal static class CreateInstance where T : IPool + { + public static Func Create { get; } + + static CreateInstance() + { + var type = typeof(T); + var dynamicMethod = new DynamicMethod($"CreateInstance_{type.Name}", type, Type.EmptyTypes, true); + var il = dynamicMethod.GetILGenerator(); + il.Emit(OpCodes.Newobj, type.GetConstructor(Type.EmptyTypes)); + il.Emit(OpCodes.Ret); + Create = (Func) dynamicMethod.CreateDelegate(typeof(Func)); + } + } + + internal static class CreateInstance + { + public static Func CreateIPool(Type type) + { + var dynamicMethod = new DynamicMethod($"CreateInstance_{type.Name}", type, Type.EmptyTypes, true); + var il = dynamicMethod.GetILGenerator(); + il.Emit(OpCodes.Newobj, type.GetConstructor(Type.EmptyTypes)); + il.Emit(OpCodes.Ret); + return (Func)dynamicMethod.CreateDelegate(typeof(Func)); + } + + public static Func CreateObject(Type type) + { + var dynamicMethod = new DynamicMethod($"CreateInstance_{type.Name}", type, Type.EmptyTypes, true); + var il = dynamicMethod.GetILGenerator(); + il.Emit(OpCodes.Newobj, type.GetConstructor(Type.EmptyTypes)); + il.Emit(OpCodes.Ret); + return (Func)dynamicMethod.CreateDelegate(typeof(Func)); + } + + public static Func CreateMessage(Type type) + { + var dynamicMethod = new DynamicMethod($"CreateInstance_{type.Name}", type, Type.EmptyTypes, true); + var il = dynamicMethod.GetILGenerator(); + il.Emit(OpCodes.Newobj, type.GetConstructor(Type.EmptyTypes)); + il.Emit(OpCodes.Ret); + return (Func)dynamicMethod.CreateDelegate(typeof(Func)); + } + } + + // public static class CreateInstance + // { + // public static Func Create(Type type) + // { + // var dynamicMethod = new DynamicMethod($"CreateInstance_{type.Name}", type, Type.EmptyTypes, true); + // var il = dynamicMethod.GetILGenerator(); + // il.Emit(OpCodes.Newobj, type.GetConstructor(Type.EmptyTypes)); + // il.Emit(OpCodes.Ret); + // return (Func)dynamicMethod.CreateDelegate(typeof(Func)); + // } + // } + + // /// + // /// 利用泛型的特性来减少反射的使用。 + // /// + // /// + // public static class PoolChecker where T : new() + // { + // public static bool IsPool { get; } + // + // static PoolChecker() + // { + // IsPool = typeof(IPool).IsAssignableFrom(typeof(T)); + // } + // } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Scene/ISceneUpdate.cs b/FantasyNetTest/NBC/Core/Scene/ISceneUpdate.cs new file mode 100644 index 0000000..ee34034 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Scene/ISceneUpdate.cs @@ -0,0 +1,15 @@ +namespace NBC +{ + internal interface ISceneUpdate + { + void Update(); + } + + internal sealed class EmptySceneUpdate : ISceneUpdate + { + public void Update() + { + + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Scene/Scene.cs b/FantasyNetTest/NBC/Core/Scene/Scene.cs new file mode 100644 index 0000000..2cca4e8 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Scene/Scene.cs @@ -0,0 +1,399 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using NBC.Scheduler; +using NBC.Async; +using NBC.Entitas; +using NBC.Event; +using NBC.IdFactory; +using NBC.Network; +using NBC.Network.Interface; +using NBC.Pool; + +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8601 // Possible null reference assignment. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8603 // Possible null reference return. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. +namespace NBC +{ + /// + /// 当Scene创建完成后发送的事件参数 + /// + public struct OnCreateScene + { + /// + /// 获取与事件关联的场景实体。 + /// + public readonly Scene Scene; + + /// + /// 初始化一个新的 OnCreateScene 实例。 + /// + /// + public OnCreateScene(Scene scene) + { + Scene = scene; + } + } + + /// + /// 表示一个场景实体，用于创建与管理特定的游戏场景信息。 + /// + public partial class Scene : Entity + { + #region Members + + /// + /// Scene的运行类型 + /// + public SceneRuntimeType SceneRuntimeType { get; protected set; } + + /// + /// 当前Scene的上下文 + /// + public ThreadSynchronizationContext ThreadSynchronizationContext { get; internal set; } + + /// + /// 当前Scene的下创建的Entity + /// + private readonly Dictionary _entities = new Dictionary(); + + internal readonly Dictionary> TypeInstance = new Dictionary>(); + + #endregion + + #region IdFactory + + /// + /// Entity实体Id的生成器 + /// + public IEntityIdFactory EntityIdFactory { get; protected set; } + + /// + /// Entity实体RuntimeId的生成器 + /// + public IRuntimeIdFactory RuntimeIdFactory { get; protected set; } + + #endregion + + #region Pool + + internal EntityPool EntityPool; + internal EntityListPool EntityListPool; + internal EntitySortedDictionaryPool EntitySortedDictionaryPool; + + #endregion + + #region Component + + /// + /// Scene下的任务调度器系统组件 + /// + public TimerComponent TimerComponent { get; internal set; } + + /// + /// Scene下的事件系统组件 + /// + public EventComponent EventComponent { get; internal set; } + + /// + /// Scene下的ESC系统组件 + /// + public EntityComponent EntityComponent { get; internal set; } + + /// + /// Scene下的网络消息对象池组件 + /// + public MessagePoolComponent MessagePoolComponent { get; internal set; } + + /// + /// Scene下的协程锁组件 + /// + public CoroutineLockComponent CoroutineLockComponent { get; internal set; } + + /// + /// Scene下的网络消息派发组件 + /// + internal MessageDispatcherComponent MessageDispatcherComponent { get; set; } + + #endregion + + #region Initialize + + private async FTask Initialize() + { + EntityPool = new EntityPool(); + EntityListPool = new EntityListPool(); + EntitySortedDictionaryPool = new EntitySortedDictionaryPool(); + SceneUpdate = EntityComponent = await Create(this, false, false).Initialize(); + MessagePoolComponent = Create(this, false, true); + EventComponent = await Create(this, false, true).Initialize(); + TimerComponent = Create(this, false, true).Initialize(); + CoroutineLockComponent = Create(this, false, true).Initialize(); + MessageDispatcherComponent = await Create(this, false, true).Initialize(); + } + + /// + /// Scene销毁方法，执行了该方法会把当前Scene下的所有实体都销毁掉。 + /// + public override void Dispose() + { + if (IsDisposed) + { + return; + } + + base.Dispose(); + _entities.Remove(RuntimeId); + + switch (SceneRuntimeType) + { + case SceneRuntimeType.Root: + { + _entities.Remove(EntityComponent.RuntimeId); + + foreach (var (runtimeId, entity) in _entities.ToList()) + { + if (runtimeId != entity.RuntimeId) + { + continue; + } + + entity.Dispose(); + } + + _entities.Clear(); + _unityWorldId--; + _unitySceneId--; + TypeInstance.Clear(); + EntityComponent.Dispose(); + EntityPool.Dispose(); + EntityListPool.Dispose(); + EntitySortedDictionaryPool.Dispose(); + break; + } + case SceneRuntimeType.SubScene: + { + break; + } + default: + { + Log.Error( + $"SceneRuntimeType: {SceneRuntimeType} The unsupported SceneRuntimeType of the Scene executed Dispose."); + break; + } + } + + SceneUpdate = null; + EntityIdFactory = null; + RuntimeIdFactory = null; + + EntityPool = null; + EntityListPool = null; + EntitySortedDictionaryPool = null; + EntityComponent = null; + TimerComponent = null; + EventComponent = null; + MessagePoolComponent = null; + CoroutineLockComponent = null; + MessageDispatcherComponent = null; + Session = null; + UnityNetwork = null; + ThreadSynchronizationContext = null; + SceneRuntimeType = SceneRuntimeType.None; + } + + #endregion + + internal ISceneUpdate SceneUpdate { get; set; } + + internal void Update() + { + try + { + SceneUpdate.Update(); + } + catch (Exception e) + { + Log.Error(e); + } + } + + #region Create + + private static uint _unitySceneId = 0; + private static byte _unityWorldId = 0; + public Session Session { get; private set; } + private AClientNetwork UnityNetwork { get; set; } + + /// + /// 创建一个Unity的Scene，注意:该方法只能在主线程下使用。 + /// + /// 选择Scene的运行方式 + /// + /// + public static async FTask Create(string sceneRuntimeMode = SceneRuntimeMode.MainThread) + { + var world = ++_unityWorldId; + + if (world > byte.MaxValue - 1) + { + throw new Exception($"World ID ({world}) exceeds the maximum allowed value of 255."); + } + + var sceneId = (uint)(++_unitySceneId + world * 1000); + + if (sceneId > 255255) + { + throw new Exception($"Scene ID ({sceneId}) exceeds the maximum allowed value of 255255."); + } + + var scene = new Scene(); + scene.Scene = scene; + scene.Parent = scene; + scene.Type = typeof(Scene); + scene.SceneRuntimeType = SceneRuntimeType.Root; + scene.EntityIdFactory = IdFactoryHelper.EntityIdFactory(sceneId, world); + scene.RuntimeIdFactory = IdFactoryHelper.RuntimeIdFactory(0, sceneId, world); + scene.Id = IdFactoryHelper.EntityId(0, sceneId, world, 0); + scene.RuntimeId = IdFactoryHelper.RuntimeId(0, sceneId, world, 0); + scene.AddEntity(scene); + await SetScheduler(scene, sceneRuntimeMode); + scene.ThreadSynchronizationContext.Post(() => + { + scene.EventComponent.PublishAsync(new OnCreateScene(scene)).Coroutine(); + }); + return scene; + } + + public Session Connect(string remoteAddress, NetworkProtocolType networkProtocolType, Action onConnectComplete, + Action onConnectFail, Action onConnectDisconnect, bool isHttps, int connectTimeout = 5000) + { + UnityNetwork?.Dispose(); + UnityNetwork = NetworkProtocolFactory.CreateClient(this, networkProtocolType, NetworkTarget.Outer); + Session = UnityNetwork.Connect(remoteAddress, onConnectComplete, onConnectFail, onConnectDisconnect, + isHttps, connectTimeout); + return Session; + } + + private static async FTask SetScheduler(Scene scene, string sceneRuntimeMode) + { + switch (sceneRuntimeMode) + { + case "MainThread": + { + scene.ThreadSynchronizationContext = ThreadScheduler.MainScheduler.ThreadSynchronizationContext; + scene.SceneUpdate = new EmptySceneUpdate(); + ThreadScheduler.AddMainScheduler(scene); + await scene.Initialize(); + break; + } + case "MultiThread": + { + scene.ThreadSynchronizationContext = new ThreadSynchronizationContext(); + scene.SceneUpdate = new EmptySceneUpdate(); + ThreadScheduler.AddToMultiThreadScheduler(scene); + await scene.Initialize(); + break; + } + case "ThreadPool": + { + scene.ThreadSynchronizationContext = new ThreadSynchronizationContext(); + scene.SceneUpdate = new EmptySceneUpdate(); + ThreadScheduler.AddToThreadPoolScheduler(scene); + await scene.Initialize(); + break; + } + } + } + + #endregion + + #region Entities + + /// + /// 添加一个实体到当前Scene下 + /// + /// 实体实例 + public virtual void AddEntity(Entity entity) + { + _entities.Add(entity.RuntimeId, entity); + } + + /// + /// 根据RunTimeId查询一个实体 + /// + /// 实体的RunTimeId + /// 返回的实体 + public virtual Entity GetEntity(long runTimeId) + { + return _entities.TryGetValue(runTimeId, out var entity) ? entity : null; + } + + /// + /// 根据RunTimeId查询一个实体 + /// + /// 实体的RunTimeId + /// 实体实例 + /// 返回一个bool值来提示是否查找到这个实体 + public virtual bool TryGetEntity(long runTimeId, out Entity entity) + { + return _entities.TryGetValue(runTimeId, out entity); + } + + /// + /// 根据RunTimeId查询一个实体 + /// + /// 实体的RunTimeId + /// 要查询实体的泛型类型 + /// 返回的实体 + public virtual T GetEntity(long runTimeId) where T : Entity + { + return _entities.TryGetValue(runTimeId, out var entity) ? (T)entity : null; + } + + /// + /// 根据RunTimeId查询一个实体 + /// + /// 实体的RunTimeId + /// 实体实例 + /// 要查询实体的泛型类型 + /// 返回一个bool值来提示是否查找到这个实体 + public virtual bool TryGetEntity(long runTimeId, out T entity) where T : Entity + { + if (_entities.TryGetValue(runTimeId, out var getEntity)) + { + entity = (T)getEntity; + return true; + } + + entity = null; + return false; + } + + /// + /// 删除一个实体，仅是删除不会指定实体的销毁方法 + /// + /// 实体的RunTimeId + /// 返回一个bool值来提示是否删除了这个实体 + public virtual bool RemoveEntity(long runTimeId) + { + return _entities.Remove(runTimeId); + } + + /// + /// 删除一个实体，仅是删除不会指定实体的销毁方法 + /// + /// 实体实例 + /// 返回一个bool值来提示是否删除了这个实体 + public virtual bool RemoveEntity(Entity entity) + { + return _entities.Remove(entity.RuntimeId); + } + + #endregion + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Scene/SceneRuntimeMode.cs b/FantasyNetTest/NBC/Core/Scene/SceneRuntimeMode.cs new file mode 100644 index 0000000..f0af689 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Scene/SceneRuntimeMode.cs @@ -0,0 +1,21 @@ +namespace NBC +{ + /// + /// Scene的运行类型 + /// + public class SceneRuntimeMode + { + /// + /// Scene在主线程中运行. + /// + public const string MainThread = "MainThread"; + /// + /// Scene在一个独立的线程中运行. + /// + public const string MultiThread = "MultiThread"; + /// + /// Scene在一个根据当前CPU核心数创建的线程池中运行. + /// + public const string ThreadPool = "ThreadPool"; + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Scene/SceneRuntimeType.cs b/FantasyNetTest/NBC/Core/Scene/SceneRuntimeType.cs new file mode 100644 index 0000000..1189017 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Scene/SceneRuntimeType.cs @@ -0,0 +1,21 @@ +namespace NBC +{ + /// + /// 代表一个Scene的类型 + /// + public enum SceneRuntimeType + { + /// + /// 默认 + /// + None = 0, + /// + /// 代表一个普通的Scene，一个普通的Scene肯定是是Root的 + /// + Root = 1, + /// + /// 代表一个子场景，子场景肯定是有父场景的 + /// + SubScene = 2, + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Scene/Scheduler/ISceneScheduler.cs b/FantasyNetTest/NBC/Core/Scene/Scheduler/ISceneScheduler.cs new file mode 100644 index 0000000..7a83036 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Scene/Scheduler/ISceneScheduler.cs @@ -0,0 +1,11 @@ +using System; + +namespace NBC +{ + internal interface ISceneScheduler : IDisposable + { + void Add(Scene scene); + void Remove(Scene scene); + void Update(); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Scene/Scheduler/MainScheduler.cs b/FantasyNetTest/NBC/Core/Scene/Scheduler/MainScheduler.cs new file mode 100644 index 0000000..6ddba79 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Scene/Scheduler/MainScheduler.cs @@ -0,0 +1,77 @@ +using System.Collections.Generic; +using System.Threading; + +namespace NBC +{ + internal sealed class MainScheduler : ISceneScheduler + { + private readonly Queue _queue = new Queue(); + public readonly ThreadSynchronizationContext ThreadSynchronizationContext; + + public MainScheduler() + { + ThreadSynchronizationContext = new ThreadSynchronizationContext(); + SynchronizationContext.SetSynchronizationContext(ThreadSynchronizationContext); + } + public void Dispose() + { + _queue.Clear(); + } + + public void Add(Scene scene) + { + ThreadSynchronizationContext.Post(() => + { + if (scene.IsDisposed) + { + return; + } + + _queue.Enqueue(scene); + }); + } + + public void Remove(Scene scene) + { + ThreadSynchronizationContext.Post(() => + { + if (scene.IsDisposed) + { + return; + } + + var initialCount = _queue.Count; + for (var i = 0; i < initialCount; i++) + { + var currentScene = _queue.Dequeue(); + if (currentScene != scene) + { + _queue.Enqueue(currentScene); + } + } + }); + } + + public void Update() + { + ThreadSynchronizationContext.Update(); + var initialCount = _queue.Count; + + while (initialCount-- > 0) + { + if(!_queue.TryDequeue(out var scene)) + { + continue; + } + + if (scene.IsDisposed) + { + continue; + } + + scene.Update(); + _queue.Enqueue(scene); + } + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Scene/Scheduler/MultiThreadScheduler.cs b/FantasyNetTest/NBC/Core/Scene/Scheduler/MultiThreadScheduler.cs new file mode 100644 index 0000000..9f0fa4d --- /dev/null +++ b/FantasyNetTest/NBC/Core/Scene/Scheduler/MultiThreadScheduler.cs @@ -0,0 +1,103 @@ +#if !FANTASY_WEBGL || !FANTASY_SINGLETHREAD +using System; +using System.Collections.Concurrent; +using System.Threading; +namespace NBC +{ + internal struct MultiThreadStruct : IDisposable + { + public readonly Thread Thread; + public readonly CancellationTokenSource Cts; + + public MultiThreadStruct(Thread thread, CancellationTokenSource cts) + { + Thread = thread; + Cts = cts; + } + + public void Dispose() + { + Cts.Cancel(); + if (Thread.IsAlive) + { + Thread.Join(); + } + Cts.Dispose(); + } + } + + internal sealed class MultiThreadScheduler : ISceneScheduler + { + private bool _isDisposed; + private readonly ConcurrentDictionary _threads = new ConcurrentDictionary(); + public int ThreadCount => _threads.Count; + + public void Dispose() + { + if (_isDisposed) + { + return; + } + + _isDisposed = true; + + foreach (var (_, multiThreadStruct) in _threads.ToArray()) + { + multiThreadStruct.Dispose(); + } + + _threads.Clear(); + } + + public void Add(Scene scene) + { + var cts = new CancellationTokenSource(); + var thread = new Thread(() => Loop(scene, cts.Token)); + _threads.TryAdd(scene.RuntimeId, new MultiThreadStruct(thread, cts)); + thread.Start(); + } + + public void Remove(Scene scene) + { + if (_threads.TryRemove(scene.RuntimeId, out var multiThreadStruct)) + { + multiThreadStruct.Dispose(); + } + } + + public void Update() + { + throw new NotImplementedException(); + } + + private void Loop(Scene scene, CancellationToken cancellationToken) + { + var sceneThreadSynchronizationContext = scene.ThreadSynchronizationContext; + SynchronizationContext.SetSynchronizationContext(sceneThreadSynchronizationContext); + + while (!cancellationToken.IsCancellationRequested) + { + try + { + if (scene.IsDisposed) + { + Remove(scene); + return; + } + + sceneThreadSynchronizationContext.Update(); + scene.Update(); + } + catch (Exception e) + { + Log.Error($"Error in MultiThreadScheduler loop: {e.Message}"); + } + finally + { + Thread.Sleep(1); + } + } + } + } +} +#endif diff --git a/FantasyNetTest/NBC/Core/Scene/Scheduler/ThreadPoolScheduler.cs b/FantasyNetTest/NBC/Core/Scene/Scheduler/ThreadPoolScheduler.cs new file mode 100644 index 0000000..4ea7dc2 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Scene/Scheduler/ThreadPoolScheduler.cs @@ -0,0 +1,140 @@ +#if !FANTASY_WEBGL || !FANTASY_SINGLETHREAD +using System; +using System.Collections.Concurrent; +using System.Collections.Generic; +using System.Threading; +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8604 // Possible null reference argument. +namespace NBC +{ + internal sealed class ThreadPoolScheduler : ISceneScheduler + { + private bool _isDisposed; + private readonly List _threads; + private readonly ConcurrentBag _queue = new ConcurrentBag(); + private readonly CancellationTokenSource _cancellationTokenSource = new CancellationTokenSource(); + + public ThreadPoolScheduler() + { + // 最大线程数、避免线程过多发生的资源抢占问题。 + // 但如果使用了MultiThreadScheduler，那么这里的线程数就算是设置了也有可能导致线程过多的问题。 + // 线程过多看每个线程的抢占情况，如果抢占资源占用不是很大也没什么大问题。如果过大的情况，就会有性能问题。 + // 所以根据情况来使用不同的调度器。 + var maxThreadCount = Environment.ProcessorCount; + _threads = new List(maxThreadCount); + + for (var i = 0; i < maxThreadCount; ++i) + { + Thread thread = new(() => Loop(_cancellationTokenSource.Token)) + { + IsBackground = true + }; + _threads.Add(thread); + thread.Start(); + } + } + + public void Dispose() + { + if (_isDisposed) + { + return; + } + + _isDisposed = true; + _cancellationTokenSource.Cancel(); + + foreach (var thread in _threads) + { + if (thread.IsAlive) + { + thread.Join(); + } + } + + _cancellationTokenSource.Dispose(); + _threads.Clear(); + } + + public void Add(Scene scene) + { + if (_isDisposed) + { + return; + } + + _queue.Add(scene); + } + + public void Remove(Scene scene) + { + if (_isDisposed) + { + return; + } + + var newQueue = new Queue(); + + while (!_queue.IsEmpty) + { + if (_queue.TryTake(out var currentScene)) + { + if (currentScene != scene) + { + newQueue.Enqueue(currentScene); + } + } + } + + while (newQueue.TryDequeue(out var newScene)) + { + _queue.Add(newScene); + } + } + + public void Update() + { + throw new NotImplementedException(); + } + + private void Loop(CancellationToken cancellationToken) + { + while (!cancellationToken.IsCancellationRequested) + { + if (_queue.TryTake(out var scene)) + { + if (scene == null || scene.IsDisposed) + { + continue; + } + + var sceneThreadSynchronizationContext = scene.ThreadSynchronizationContext; + SynchronizationContext.SetSynchronizationContext(sceneThreadSynchronizationContext); + + try + { + sceneThreadSynchronizationContext.Update(); + scene.Update(); + } + catch (Exception e) + { + Log.Error($"Error in ThreadPoolScheduler scene: {e.Message}"); + } + finally + { + SynchronizationContext.SetSynchronizationContext(null); + } + + _queue.Add(scene); + Thread.Sleep(1); + } + else + { + // 当队列为空的时候、避免无效循环消耗CPU。 + Thread.Sleep(10); + } + } + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Scene/Scheduler/ThreadScheduler.cs b/FantasyNetTest/NBC/Core/Scene/Scheduler/ThreadScheduler.cs new file mode 100644 index 0000000..88b4979 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Scene/Scheduler/ThreadScheduler.cs @@ -0,0 +1,66 @@ +// ReSharper disable ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +namespace NBC +{ + /// + /// 线程调度器 + /// + internal static class ThreadScheduler + { + /// + /// 主线程调度器 + /// + public static MainScheduler MainScheduler { get; private set; } + /// + /// 多线程调度器，根据当前CPU核心数量创建的固定线程。 + /// + public static ISceneScheduler MultiThreadScheduler { get; private set; } + /// + /// 线程池调度器 + /// + public static ISceneScheduler ThreadPoolScheduler { get; private set; } + + static ThreadScheduler() + { + MainScheduler = new MainScheduler(); + } + + internal static void Update() + { + MainScheduler.Update(); + } + + internal static void AddMainScheduler(Scene scene) + { + MainScheduler.Add(scene); + } + + internal static void AddToMultiThreadScheduler(Scene scene) + { + if (MultiThreadScheduler == null) + { +#if FANTASY_SINGLETHREAD || FANTASY_WEBGL + MultiThreadScheduler = MainScheduler; +#else + MultiThreadScheduler = new MultiThreadScheduler(); +#endif + } + + MultiThreadScheduler.Add(scene); + } + + internal static void AddToThreadPoolScheduler(Scene scene) + { + if (ThreadPoolScheduler == null) + { +#if FANTASY_SINGLETHREAD || FANTASY_WEBGL + ThreadPoolScheduler = MainScheduler; +#else + ThreadPoolScheduler = new ThreadPoolScheduler(); +#endif + } + + ThreadPoolScheduler.Add(scene); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Scene/SubScene.cs b/FantasyNetTest/NBC/Core/Scene/SubScene.cs new file mode 100644 index 0000000..f436611 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Scene/SubScene.cs @@ -0,0 +1,154 @@ +using System.Collections.Generic; +using System.Linq; +using NBC.Network; +using NBC.Entitas; + +#pragma warning disable CS8601 // Possible null reference assignment. +#pragma warning disable CS8603 // Possible null reference return. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider adding the 'required' modifier or declaring as nullable. + +namespace NBC +{ + /// + /// 代表一个Scene下的子Scene + /// + public sealed partial class SubScene : Scene + { + /// + /// 子Scene的根Scene + /// + public Scene RootScene { get; internal set; } + /// + /// 存储当前Scene下管理的实体。 + /// + private readonly Dictionary _entities = new Dictionary(); + + internal void Initialize(Scene rootScene) + { + EntityPool = rootScene.EntityPool; + EntityListPool = rootScene.EntityListPool; + EntitySortedDictionaryPool = rootScene.EntitySortedDictionaryPool; + SceneUpdate = rootScene.SceneUpdate; + TimerComponent = rootScene.TimerComponent; + EventComponent = rootScene.EventComponent; + EntityComponent = rootScene.EntityComponent; + MessagePoolComponent = rootScene.MessagePoolComponent; + CoroutineLockComponent = rootScene.CoroutineLockComponent; + MessageDispatcherComponent = rootScene.MessageDispatcherComponent; + ThreadSynchronizationContext = rootScene.ThreadSynchronizationContext; + } + + /// + /// 当子Scene销毁时执行 + /// + public override void Dispose() + { + if (IsDisposed) + { + return; + } + + ThreadSynchronizationContext.Post(() => + { + if (IsDisposed) + { + return; + } + + foreach (var (runtimeId, entity) in _entities.ToList()) + { + if (runtimeId != entity.RuntimeId) + { + continue; + } + entity.Dispose(); + } + + _entities.Clear(); + base.Dispose(); + }); + } + + /// + /// 添加一个实体到当前Scene下 + /// + /// 实体实例 + public override void AddEntity(Entity entity) + { + _entities.Add(entity.RuntimeId, entity); + RootScene.AddEntity(entity); + } + + /// + /// 根据RunTimeId查询一个实体 + /// + /// 实体的RunTimeId + /// 返回的实体 + public override Entity GetEntity(long runTimeId) + { + return _entities.GetValueOrDefault(runTimeId); + } + + /// + /// 根据RunTimeId查询一个实体 + /// + /// 实体的RunTimeId + /// 实体实例 + /// 返回一个bool值来提示是否查找到这个实体 + public override bool TryGetEntity(long runTimeId, out Entity entity) + { + return _entities.TryGetValue(runTimeId, out entity); + } + + /// + /// 根据RunTimeId查询一个实体 + /// + /// 实体的RunTimeId + /// 要查询实体的泛型类型 + /// 返回的实体 + public override T GetEntity(long runTimeId) + { + return _entities.TryGetValue(runTimeId, out var entity) ? (T)entity : null; + } + + /// + /// 根据RunTimeId查询一个实体 + /// + /// 实体的RunTimeId + /// 实体实例 + /// 要查询实体的泛型类型 + /// 返回一个bool值来提示是否查找到这个实体 + public override bool TryGetEntity(long runTimeId, out T entity) + { + if (_entities.TryGetValue(runTimeId, out var getEntity)) + { + entity = (T)getEntity; + return true; + } + + entity = null; + return false; + } + + /// + /// 删除一个实体，仅是删除不会指定实体的销毁方法 + /// + /// 实体的RunTimeId + /// 返回一个bool值来提示是否删除了这个实体 + public override bool RemoveEntity(long runTimeId) + { + return _entities.Remove(runTimeId) && RootScene.RemoveEntity(runTimeId); + } + + /// + /// 删除一个实体，仅是删除不会指定实体的销毁方法 + /// + /// 实体实例 + /// 返回一个bool值来提示是否删除了这个实体 + public override bool RemoveEntity(Entity entity) + { + return RemoveEntity(entity.RuntimeId); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Serialize/BsonPack.meta b/FantasyNetTest/NBC/Core/Serialize/BsonPack.meta new file mode 100644 index 0000000..1617db2 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/BsonPack.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 0a19189e3038447bb88d6d991d3f1228 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Serialize/BsonPack/BsonPackHelperUnity.cs b/FantasyNetTest/NBC/Core/Serialize/BsonPack/BsonPackHelperUnity.cs new file mode 100644 index 0000000..64bd01b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/BsonPack/BsonPackHelperUnity.cs @@ -0,0 +1,58 @@ +using System; +using System.Buffers; +namespace NBC.Serialize +{ + public class BsonPackHelper : ISerialize + { + public string SerializeName { get; } = "Bson"; + public T Deserialize(byte[] bytes) + { + throw new NotImplementedException(); + } + + public T Deserialize(MemoryStreamBuffer buffer) + { + throw new NotImplementedException(); + } + + public object Deserialize(Type type, byte[] bytes) + { + throw new NotImplementedException(); + } + + public object Deserialize(Type type, MemoryStreamBuffer buffer) + { + throw new NotImplementedException(); + } + + public T Deserialize(byte[] bytes, int index, int count) + { + throw new NotImplementedException(); + } + + public object Deserialize(Type type, byte[] bytes, int index, int count) + { + throw new NotImplementedException(); + } + + public void Serialize(T @object, IBufferWriter buffer) + { + throw new NotImplementedException(); + } + + public void Serialize(object @object, IBufferWriter buffer) + { + throw new NotImplementedException(); + } + + public void Serialize(Type type, object @object, IBufferWriter buffer) + { + throw new NotImplementedException(); + } + + public T Clone(T t) + { + throw new NotImplementedException(); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Serialize/BsonPack/BsonPackHelperUnity.cs.meta b/FantasyNetTest/NBC/Core/Serialize/BsonPack/BsonPackHelperUnity.cs.meta new file mode 100644 index 0000000..6b18f45 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/BsonPack/BsonPackHelperUnity.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 564581ee1c8ee4e348fe55a0d02977ed +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Serialize/Interface.meta b/FantasyNetTest/NBC/Core/Serialize/Interface.meta new file mode 100644 index 0000000..817a200 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/Interface.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 67cee2b81543348e8b18e5425e0e4863 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Serialize/Interface/ASerialize.cs b/FantasyNetTest/NBC/Core/Serialize/Interface/ASerialize.cs new file mode 100644 index 0000000..9fddf84 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/Interface/ASerialize.cs @@ -0,0 +1,55 @@ +using System; +using System.ComponentModel; +using System.Runtime.Serialization; +using MongoDB.Bson.Serialization.Attributes; +using NBC.Pool; +using Newtonsoft.Json; +using ProtoBuf; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. + +namespace NBC.Serialize +{ + public abstract class ASerialize : ISupportInitialize, IDisposable + { + public virtual void Dispose() { } + public virtual void BeginInit() { } + public virtual void EndInit() { } + public virtual void AfterDeserialization() => EndInit(); + } + + public abstract class AMessage : ASerialize, IPool + { + + [BsonIgnore] + [JsonIgnore] + [IgnoreDataMember] + [ProtoIgnore] + private Scene _scene; + protected Scene GetScene() + { + return _scene; + } + + public void SetScene(Scene scene) + { + _scene = scene; + } + + [JsonIgnore] + [IgnoreDataMember] + [ProtoIgnore] + private bool _isPool; + + public bool IsPool() + { + return _isPool; + } + + public void SetIsPool(bool isPool) + { + _isPool = isPool; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Serialize/Interface/ASerialize.cs.meta b/FantasyNetTest/NBC/Core/Serialize/Interface/ASerialize.cs.meta new file mode 100644 index 0000000..9ab76f2 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/Interface/ASerialize.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: c0d1f037ce81346e8a04a78f128b0e65 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Serialize/Interface/ISerialize.cs b/FantasyNetTest/NBC/Core/Serialize/Interface/ISerialize.cs new file mode 100644 index 0000000..95c1b17 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/Interface/ISerialize.cs @@ -0,0 +1,87 @@ +using System; +using System.Buffers; + +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member +namespace NBC.Serialize +{ + public interface ISerialize + { + /// + /// 序列化器的名字，用于在协议里指定用什么协议序列化使用 + /// + string SerializeName { get; } + /// + /// 反序列化 + /// + /// + /// + /// + T Deserialize(byte[] bytes); + /// + /// 反序列化 + /// + /// + /// + /// + T Deserialize(MemoryStreamBuffer buffer); + /// + /// 反序列化 + /// + /// + /// + /// + object Deserialize(Type type, byte[] bytes); + /// + /// 反序列化 + /// + /// + /// + /// + object Deserialize(Type type, MemoryStreamBuffer buffer); + /// + /// 反序列化 + /// + /// + /// + /// + /// + /// + T Deserialize(byte[] bytes, int index, int count); + /// + /// 反序列化 + /// + /// + /// + /// + /// + /// + object Deserialize(Type type, byte[] bytes, int index, int count); + /// + /// 序列化 + /// + /// + /// + /// + void Serialize(T @object, IBufferWriter buffer); + /// + /// 序列化 + /// + /// + /// + void Serialize(object @object, IBufferWriter buffer); + /// + /// 序列化 + /// + /// + /// + /// + void Serialize(Type type, object @object, IBufferWriter buffer); + /// + /// 克隆 + /// + /// + /// + /// + T Clone(T t); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Serialize/Interface/ISerialize.cs.meta b/FantasyNetTest/NBC/Core/Serialize/Interface/ISerialize.cs.meta new file mode 100644 index 0000000..e492336 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/Interface/ISerialize.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 8a7d62fda7ac04f3fb7d1fd6955da409 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Serialize/MemoryStreamBuffer.cs b/FantasyNetTest/NBC/Core/Serialize/MemoryStreamBuffer.cs new file mode 100644 index 0000000..0467754 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/MemoryStreamBuffer.cs @@ -0,0 +1,73 @@ +using System; +using System.Buffers; +using System.IO; +#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member + +namespace NBC.Serialize +{ + public enum MemoryStreamBufferSource + { + None = 0, + Pack = 1, + UnPack = 2, + } + + public sealed class MemoryStreamBuffer : MemoryStream, IBufferWriter + { + public MemoryStreamBufferSource MemoryStreamBufferSource; + public MemoryStreamBuffer() { } + + public MemoryStreamBuffer(MemoryStreamBufferSource memoryStreamBufferSource, int capacity) : base(capacity) + { + MemoryStreamBufferSource = memoryStreamBufferSource; + } + public MemoryStreamBuffer(byte[] buffer): base(buffer) { } + + public void Advance(int count) + { + if (count < 0) + { + throw new ArgumentOutOfRangeException(nameof(count), count, "The value of 'count' cannot be negative."); + } + + var newLength = Position + count; + + if (newLength != Length) + { + SetLength(newLength); + } + + Position = newLength; + } + + public Memory GetMemory(int sizeHint = 0) + { + if (sizeHint < 0) + { + throw new ArgumentOutOfRangeException(nameof(sizeHint), sizeHint, "The value of 'count' cannot be negative."); + } + + if (Length - Position <= sizeHint) + { + SetLength(Position + sizeHint); + } + + return new Memory(GetBuffer(), (int)Position, (int)(Length - Position)); + } + + public Span GetSpan(int sizeHint = 0) + { + if (sizeHint < 0) + { + throw new ArgumentOutOfRangeException(nameof(sizeHint), sizeHint, "The value of 'count' cannot be negative."); + } + + if (Length - Position <= sizeHint) + { + SetLength(Position + sizeHint); + } + + return new Span(GetBuffer(), (int)Position, (int)(Length - Position)); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Serialize/MemoryStreamBuffer.cs.meta b/FantasyNetTest/NBC/Core/Serialize/MemoryStreamBuffer.cs.meta new file mode 100644 index 0000000..21bbeed --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/MemoryStreamBuffer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 8c6e3b5d66fc8451482eaf828663e6a1 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper.meta b/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper.meta new file mode 100644 index 0000000..b414d6f --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 0f56f731b0e9a4bdb931dce6773bc1e1 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/IProto.cs b/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/IProto.cs new file mode 100644 index 0000000..7520f30 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/IProto.cs @@ -0,0 +1,9 @@ +namespace NBC.Serialize +{ + /// + /// 代表是一个ProtoBuf协议 + /// + public interface IProto + { + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/IProto.cs.meta b/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/IProto.cs.meta new file mode 100644 index 0000000..eff9820 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/IProto.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: d8890f4dc3e2c433fbd22b91ead3bfe4 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/ProtoBufPackHelperUnity.cs b/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/ProtoBufPackHelperUnity.cs new file mode 100644 index 0000000..a891d2e --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/ProtoBufPackHelperUnity.cs @@ -0,0 +1,200 @@ +using System; +using System.Buffers; +using System.IO; +using NBC.Assembly; +using ProtoBuf; +using ProtoBuf.Meta; + +namespace NBC.Serialize +{ + /// + /// ProtoBufP帮助类，Unity平台使用 + /// + public sealed class ProtoBufPackHelper : ISerialize + { + /// + /// 序列化器的名字 + /// + public string SerializeName { get; } = "ProtoBuf"; + + /// + /// 使用ProtoBuf反序列化数据到实例 + /// + /// + /// + /// + public unsafe T Deserialize(byte[] bytes) + { + fixed (byte* ptr = bytes) + { + using var stream = new UnmanagedMemoryStream(ptr, bytes.Length); + var @object = ProtoBuf.Serializer.Deserialize(stream); + if (@object is ASerialize aSerialize) + { + aSerialize.AfterDeserialization(); + } + return @object; + } + } + /// + /// 使用ProtoBuf反序列化数据到实例 + /// + /// + /// + /// + public T Deserialize(MemoryStreamBuffer buffer) + { + var @object = ProtoBuf.Serializer.Deserialize(buffer); + if (@object is ASerialize aSerialize) + { + aSerialize.AfterDeserialization(); + } + return @object; + } + /// + /// 使用ProtoBuf反序列化数据到实例 + /// + /// + /// + /// + public unsafe object Deserialize(Type type, byte[] bytes) + { + fixed (byte* ptr = bytes) + { + using var stream = new UnmanagedMemoryStream(ptr, bytes.Length); + var @object = ProtoBuf.Serializer.Deserialize(type, stream); + if (@object is ASerialize aSerialize) + { + aSerialize.AfterDeserialization(); + } + + return @object; + } + } + /// + /// 使用ProtoBuf反序列化数据到实例 + /// + /// + /// + /// + public object Deserialize(Type type, MemoryStreamBuffer buffer) + { + var @object = ProtoBuf.Serializer.Deserialize(type, buffer); + if (@object is ASerialize aSerialize) + { + aSerialize.AfterDeserialization(); + } + + return @object; + } + /// + /// 使用ProtoBuf反序列化数据到实例 + /// + /// + /// + /// + /// + /// + public unsafe T Deserialize(byte[] bytes, int index, int count) + { + fixed (byte* ptr = &bytes[index]) + { + using var stream = new UnmanagedMemoryStream(ptr, count); + var @object = ProtoBuf.Serializer.Deserialize(stream); + if (@object is ASerialize aSerialize) + { + aSerialize.AfterDeserialization(); + } + return @object; + } + } + /// + /// 使用ProtoBuf反序列化数据到实例 + /// + /// + /// + /// + /// + /// + public unsafe object Deserialize(Type type, byte[] bytes, int index, int count) + { + fixed (byte* ptr = &bytes[index]) + { + using var stream = new UnmanagedMemoryStream(ptr, count); + var @object = ProtoBuf.Serializer.Deserialize(type, stream); + if (@object is ASerialize aSerialize) + { + aSerialize.AfterDeserialization(); + } + return @object; + } + } + /// + /// 使用ProtoBuf序列化某一个实例到IBufferWriter中 + /// + /// + /// + /// + public void Serialize(T @object, IBufferWriter buffer) + { + if (@object is ASerialize aSerialize) + { + aSerialize.BeginInit(); + } + + RuntimeTypeModel.Default.Serialize((MemoryStream)buffer, @object); + } + /// + /// 使用ProtoBuf序列化某一个实例到IBufferWriter中 + /// + /// + /// + public void Serialize(object @object, IBufferWriter buffer) + { + if (@object is ASerialize aSerialize) + { + aSerialize.BeginInit(); + } + + RuntimeTypeModel.Default.Serialize((MemoryStream)buffer, @object); + } + /// + /// 使用ProtoBuf序列化某一个实例到IBufferWriter中 + /// + /// + /// + /// + public void Serialize(Type type, object @object, IBufferWriter buffer) + { + if (@object is ASerialize aSerialize) + { + aSerialize.BeginInit(); + } + + RuntimeTypeModel.Default.Serialize((MemoryStream)buffer, @object); + } + private byte[] Serialize(T @object) + { + if (@object is ASerialize aSerialize) + { + aSerialize.BeginInit(); + } + + using (var buffer = new MemoryStream()) + { + RuntimeTypeModel.Default.Serialize(buffer, @object); + return buffer.ToArray(); + } + } + /// + /// 克隆 + /// + /// + /// + /// + public T Clone(T t) + { + return Deserialize(Serialize(t)); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/ProtoBufPackHelperUnity.cs.meta b/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/ProtoBufPackHelperUnity.cs.meta new file mode 100644 index 0000000..acf19ee --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/ProtoBufPackHelper/ProtoBufPackHelperUnity.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: b5e2bbc6d50014a4693df1cf25208d0d +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Serialize/SerializerManager.cs b/FantasyNetTest/NBC/Core/Serialize/SerializerManager.cs new file mode 100644 index 0000000..8b236af --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/SerializerManager.cs @@ -0,0 +1,136 @@ +using System; +using System.Collections.Generic; +using NBC.Assembly; +using NBC.Helper; +#if !FANTASY_EXPORTER +using NBC.Network; +#endif +#pragma warning disable CS8604 // Possible null reference argument. +#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable. +#pragma warning disable CS8625 // Cannot convert null literal to non-nullable reference type. +#pragma warning disable CS8602 // Dereference of a possibly null reference. +#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. + +namespace NBC.Serialize +{ + /// + /// 框架内置的序列化器类型 + /// + public static class FantasySerializerType + { + /// + /// ProtoBuf在SerializerManager的数组下标 + /// + public const int ProtoBuf = 0; + /// + /// Bson在SerializerManager的数组下标 + /// + public const int Bson = 1; + } + + /// + /// 管理序列化静态方法，主要是优化网络协议时使用。 + /// + public static class SerializerManager + { + private static ISerialize[] _serializers; + private static bool _isInitialized = false; + + /// + /// 初始化方法 + /// + public static void Initialize() + { + if (_isInitialized) + { + return; + } + + try + { + var sort = new SortedList(); + + foreach (var serializerType in AssemblySystem.ForEach(typeof(ISerialize))) + { + var serializer = (ISerialize)Activator.CreateInstance(serializerType); + var computeHash64 = HashCodeHelper.ComputeHash64(serializer.SerializeName); + sort.Add(computeHash64, serializer); + } + + var index = 1; + _serializers = new ISerialize[sort.Count]; + + foreach (var (_, serialize) in sort) + { + var serializerIndex = 0; + + switch (serialize) + { + case ProtoBufPackHelper: + { + serializerIndex = FantasySerializerType.ProtoBuf; + break; + } + case BsonPackHelper: + { + serializerIndex = FantasySerializerType.Bson; + break; + } + default: + { + serializerIndex = ++index; + break; + } + } + + _serializers[serializerIndex] = serialize; + } + + _isInitialized = true; + Log.Info($"初始化序列化器成功，数量为：{_serializers.Length}"); + } + catch (Exception e) + { + Log.Error(e); + Dispose(); + } + } + + /// + /// 销毁方法 + /// + public static void Dispose() + { + _isInitialized = false; + Array.Clear(_serializers, 0, _serializers.Length); + } + + /// + /// 根据协议类型获取序列化器 + /// + /// + /// + public static ISerialize GetSerializer(uint opCodeProtocolType) + { + return _serializers[opCodeProtocolType]; + } + + /// + /// 获得一个序列化器 + /// + /// + /// + /// + public static bool TryGetSerializer(uint opCodeProtocolType, out ISerialize serializer) + { + if (opCodeProtocolType < _serializers.Length) + { + serializer = _serializers[opCodeProtocolType]; + return true; + } + + serializer = default; + return false; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Serialize/SerializerManager.cs.meta b/FantasyNetTest/NBC/Core/Serialize/SerializerManager.cs.meta new file mode 100644 index 0000000..e4fd974 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Serialize/SerializerManager.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 697ffcbc908194a5c9175595fd4e78e9 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/FantasyNetTest/NBC/Core/Services/ISingletonAwake.cs b/FantasyNetTest/NBC/Core/Services/ISingletonAwake.cs new file mode 100644 index 0000000..7383db4 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Services/ISingletonAwake.cs @@ -0,0 +1,22 @@ +namespace NBC +{ + public interface ISingletonAwake + { + void Awake(); + } + + public interface ISingletonAwake + { + void Awake(A a); + } + + public interface ISingletonAwake + { + void Awake(A a, B b); + } + + public interface ISingletonAwake + { + void Awake(A a, B b, C c); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Services/MonoManager.cs b/FantasyNetTest/NBC/Core/Services/MonoManager.cs new file mode 100644 index 0000000..94e32ac --- /dev/null +++ b/FantasyNetTest/NBC/Core/Services/MonoManager.cs @@ -0,0 +1,85 @@ +// using System; +// using UnityEngine; +// +// namespace NBC +// { +// public class MonoManager : MonoBehaviour +// { +// public event Action OnUpdate; +// public event Action OnLateUpdate; +// public event Action OnFixedUpdate; +// public event Action OnApplicationQuitAction; +// public event Action OnApplicationPauseAction; +// +// private static bool IsQuiting { get; set; } +// +// private static MonoManager _inst; +// +// public static MonoManager Inst +// { +// get +// { +// if (_inst != null || IsQuiting) return _inst; +// _inst = FindObjectOfType(); +// if (_inst == null) +// { +// _inst = new GameObject("_MonoTimer").AddComponent(); +// } +// +// return _inst; +// } +// } +// +// +// ///Creates the MonoManager singleton +// public static void Create() +// { +// _inst = Inst; +// } +// +// protected void OnApplicationQuit() +// { +// IsQuiting = true; +// OnApplicationQuitAction?.Invoke(); +// } +// +// protected void OnApplicationPause(bool isPause) +// { +// OnApplicationPauseAction?.Invoke(isPause); +// } +// +// protected void Awake() +// { +// if (_inst != null && _inst != this) +// { +// DestroyImmediate(this.gameObject); +// return; +// } +// +// DontDestroyOnLoad(gameObject); +// _inst = this; +// } +// +// protected void Update() +// { +// try +// { +// OnUpdate?.Invoke(); +// } +// catch (Exception e) +// { +// Debug.LogError(e); +// } +// } +// +// protected void LateUpdate() +// { +// OnLateUpdate?.Invoke(); +// } +// +// protected void FixedUpdate() +// { +// OnFixedUpdate?.Invoke(); +// } +// } +// } \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Services/Singleton.cs b/FantasyNetTest/NBC/Core/Services/Singleton.cs new file mode 100644 index 0000000..2ca9e01 --- /dev/null +++ b/FantasyNetTest/NBC/Core/Services/Singleton.cs @@ -0,0 +1,65 @@ +using System; +using System.ComponentModel; + +namespace NBC +{ + public interface ISingletonReverseDispose + { + } + + public abstract class DisposeObject : IDisposable, ISupportInitialize + { + public virtual void Dispose() + { + } + + public virtual void BeginInit() + { + } + + public virtual void EndInit() + { + } + } + + public abstract class ASingleton : DisposeObject + { + internal abstract void Register(); + } + + public abstract class Singleton : ASingleton where T : Singleton + { + private bool _isDisposed; + + + public static T Instance { get; private set; } + + internal override void Register() + { + Instance = (T)this; + } + + public bool IsDisposed() + { + return this._isDisposed; + } + + protected virtual void Destroy() + { + } + + public override void Dispose() + { + if (this._isDisposed) + { + return; + } + + this._isDisposed = true; + + this.Destroy(); + + Instance = null; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Core/Services/TimeInfo.cs b/FantasyNetTest/NBC/Core/Services/TimeInfo.cs new file mode 100644 index 0000000..0e2ed4b --- /dev/null +++ b/FantasyNetTest/NBC/Core/Services/TimeInfo.cs @@ -0,0 +1,77 @@ +using System; + +namespace NBC +{ + public class TimeInfo: Singleton, ISingletonAwake + { + private int timeZone; + + public int TimeZone + { + get + { + return this.timeZone; + } + set + { + this.timeZone = value; + dt = dt1970.AddHours(TimeZone); + } + } + + private DateTime dt1970; + private DateTime dt; + + // ping消息会设置该值，原子操作 + public long ServerMinusClientTime { private get; set; } + + public long FrameTime { get; private set; } + + public void Awake() + { + this.dt1970 = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc); + this.dt = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc); + this.FrameTime = this.ClientNow(); + } + + public void Update() + { + // 赋值long型是原子操作，线程安全 + this.FrameTime = this.ClientNow(); + } + + /// + /// 根据时间戳获取时间 + /// + public DateTime ToDateTime(long timeStamp) + { + return dt.AddTicks(timeStamp * 10000); + } + + // 线程安全 + public long ClientNow() + { + return (DateTime.UtcNow.Ticks - this.dt1970.Ticks) / 10000; + } + + public long ServerNow() + { + return ClientNow() + this.ServerMinusClientTime; + } + + public long ClientFrameTime() + { + return this.FrameTime; + } + + public long ServerFrameTime() + { + return this.FrameTime + this.ServerMinusClientTime; + } + + public long Transition(DateTime d) + { + return (d.Ticks - dt.Ticks) / 10000; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/JWT/JWTParseComponent.cs b/FantasyNetTest/NBC/JWT/JWTParseComponent.cs new file mode 100644 index 0000000..1dc7a8e --- /dev/null +++ b/FantasyNetTest/NBC/JWT/JWTParseComponent.cs @@ -0,0 +1,74 @@ +namespace NBC; + +public sealed class Payload +{ + public long aId { get; set; } + public string Address { get; set; } + public uint SceneId { get; set; } + public int exp { get; set; } + public string iss { get; set; } + public string aud { get; set; } +} + +public sealed class JWTParseComponent : NBC.Entitas.Entity +{ +} + +public static class JWTParseComponentSystem + { + //payload:{"aId":433552570364198912,"Address":"127.0.0.1:8080","exp":1729842327,"iss":"Fantasy","aud":"Fantasy"} + public static bool Parse(this JWTParseComponent self, string toKen, out Payload payloadData) + { + payloadData = null; + + try + { + // JWT通常是由三个部分组成的,Header,Payload,Signature。 + var tokens = toKen.Split('.'); + + if (tokens.Length != 3) + { + Log.Error("Invalid JWT token"); + return false; + } + // JWT的Payload不是标准的Base64格式，因为咱们C#的Convert要求是一个标准的Base64格式。 + // JWT的Payload是Base64URL格式,它里面的"-"替代成了"+","_"替代成了"/",需要把这些给还原成Base64格式 + var basePayload = tokens[1].Replace('-', '+').Replace('_', '/'); + // 因为Base64的编码长度需要是4的倍数，如果不是的话咱们需要把这个长度用=来填充，使其长度符合要求 + switch (basePayload.Length % 4) + { + // case 0: + // { + // // 如果这个余数是0，那就表示长度已经是4的倍数，那就没必要处理了。 + // break; + // } + // case 1: + // { + // // 如果这个余数是1，那就表示这个Base64格式是不正确的，不是咱们发放的token。 + // // 这样情况下，也不需要处理了。 + // break; + // } + case 2: + { + basePayload +="=="; + break; + } + case 3: + { + basePayload +="="; + break; + } + } + // 将修复后的字符串解码为数组 + var basePayloadBytes = Convert.FromBase64String(basePayload); + var payload = System.Text.Encoding.UTF8.GetString(basePayloadBytes); + payloadData = JsonHelper.Deserialize(payload); + return true; + } + catch (Exception e) + { + Log.Error(e); + return false; + } + } + } \ No newline at end of file diff --git a/FantasyNetTest/NBC/JsonHelper.cs b/FantasyNetTest/NBC/JsonHelper.cs new file mode 100644 index 0000000..f0e00ad --- /dev/null +++ b/FantasyNetTest/NBC/JsonHelper.cs @@ -0,0 +1,54 @@ +using Newtonsoft.Json; + +namespace NBC; + +/// +/// 提供操作 JSON 数据的辅助方法。 +/// +public static partial class JsonHelper +{ + /// + /// 将对象序列化为 JSON 字符串。 + /// + /// 要序列化的对象类型。 + /// 要序列化的对象。 + /// 表示序列化对象的 JSON 字符串。 + public static string ToJson(this T t) + { + return JsonConvert.SerializeObject(t); + } + + /// + /// 反序列化 JSON 字符串为指定类型的对象。 + /// + /// 要反序列化的 JSON 字符串。 + /// 目标对象的类型。 + /// 是否使用反射进行反序列化（默认为 true）。 + /// 反序列化后的对象。 + public static object Deserialize(this string json, Type type, bool reflection = true) + { + return JsonConvert.DeserializeObject(json, type); + } + + /// + /// 反序列化 JSON 字符串为指定类型的对象。 + /// + /// 目标对象的类型。 + /// 要反序列化的 JSON 字符串。 + /// 反序列化后的对象。 + public static T Deserialize(this string json) + { + return JsonConvert.DeserializeObject(json); + } + + /// + /// 克隆对象，通过将对象序列化为 JSON，然后再进行反序列化。 + /// + /// 要克隆的对象类型。 + /// 要克隆的对象。 + /// 克隆后的对象。 + public static T Clone(T t) + { + return t.ToJson().Deserialize(); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/NetMessageDelegate.cs b/FantasyNetTest/NBC/NetMessageDelegate.cs new file mode 100644 index 0000000..7162f3b --- /dev/null +++ b/FantasyNetTest/NBC/NetMessageDelegate.cs @@ -0,0 +1,29 @@ +using NBC.Network; +using NBC.Network.Interface; + +namespace NBC; + +public static class NetMessageDelegate +{ + public static event Action? OnMessage; + + public static event Action OnRequest; + + public static event Action OnResponse; + + //(IRequest request, long routeId = 0) + public static void Message(Session session, Type type, object message, uint rpcId, uint protocolCode) + { + OnMessage?.Invoke(session, type, message, rpcId, protocolCode); + } + + public static void Request(IRequest request, long routeId = 0) + { + OnRequest?.Invoke(request, routeId); + } + + public static void Response(IResponse response) + { + OnResponse?.Invoke(response); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/PACK/OuterOpcode.cs b/FantasyNetTest/NBC/PACK/OuterOpcode.cs new file mode 100644 index 0000000..4f2dae0 --- /dev/null +++ b/FantasyNetTest/NBC/PACK/OuterOpcode.cs @@ -0,0 +1,10 @@ +// namespace Fantasy +// { +// public static partial class OuterOpcode +// { +// public const uint C2A_LoginRequest = 268445457; +// public const uint A2C_LoginResponse = 402663185; +// public const uint C2G_LoginRequest = 268445458; +// public const uint G2C_LoginResponse = 402663186; +// } +// } \ No newline at end of file diff --git a/FantasyNetTest/NBC/PACK/Pack.cs b/FantasyNetTest/NBC/PACK/Pack.cs new file mode 100644 index 0000000..ec8a625 --- /dev/null +++ b/FantasyNetTest/NBC/PACK/Pack.cs @@ -0,0 +1,143 @@ +// using Fantasy; +// using NBC.Network.Interface; +// using NBC.Serialize; +// using ProtoBuf; +// +// namespace NBC; +// +// [ProtoContract] +// public partial class C2A_LoginRequest : AMessage, IRequest, IProto +// { +// public static C2A_LoginRequest Create(Scene scene) +// { +// return scene.MessagePoolComponent.Rent(); +// } +// +// public override void Dispose() +// { +// Username = default; +// Password = default; +// LoginType = default; +// Region = default; +// #if FANTASY_NET || FANTASY_UNITY +// GetScene().MessagePoolComponent.Return(this); +// #endif +// } +// +// [ProtoIgnore] public A2C_LoginResponse ResponseType { get; set; } +// +// public uint OpCode() +// { +// return OuterOpcode.C2A_LoginRequest; +// } +// +// [ProtoMember(1)] public string Username { get; set; } +// [ProtoMember(2)] public string Password { get; set; } +// [ProtoMember(3)] public int LoginType { get; set; } +// [ProtoMember(4)] public int Region { get; set; } +// } +// +// [ProtoContract] +// public partial class A2C_LoginResponse : AMessage, IResponse, IProto +// { +// public static A2C_LoginResponse Create(Scene scene) +// { +// return scene.MessagePoolComponent.Rent(); +// } +// +// public override void Dispose() +// { +// ErrorCode = default; +// ToKen = default; +// #if FANTASY_NET || FANTASY_UNITY +// GetScene().MessagePoolComponent.Return(this); +// #endif +// } +// +// public uint OpCode() +// { +// return OuterOpcode.A2C_LoginResponse; +// } +// +// [ProtoMember(1)] public string ToKen { get; set; } +// [ProtoMember(2)] public uint ErrorCode { get; set; } +// } +// +// /// +// /// 客户端登录到Gate服务器 +// /// +// [ProtoContract] +// public partial class C2G_LoginRequest : AMessage, IRequest, IProto +// { +// public static C2G_LoginRequest Create(Scene scene) +// { +// return scene.MessagePoolComponent.Rent(); +// } +// +// public override void Dispose() +// { +// ToKen = default; +// #if FANTASY_NET || FANTASY_UNITY +// GetScene().MessagePoolComponent.Return(this); +// #endif +// } +// +// [ProtoIgnore] public G2C_LoginResponse ResponseType { get; set; } +// +// public uint OpCode() +// { +// return OuterOpcode.C2G_LoginRequest; +// } +// +// [ProtoMember(1)] public string ToKen { get; set; } +// } +// +// [ProtoContract] +// public partial class G2C_LoginResponse : AMessage, IResponse, IProto +// { +// public static G2C_LoginResponse Create(Scene scene) +// { +// return scene.MessagePoolComponent.Rent(); +// } +// +// public override void Dispose() +// { +// ErrorCode = default; +// GameAccountInfo = default; +// #if FANTASY_NET || FANTASY_UNITY +// GetScene().MessagePoolComponent.Return(this); +// #endif +// } +// +// public uint OpCode() +// { +// return OuterOpcode.G2C_LoginResponse; +// } +// +// [ProtoMember(1)] public GameAccountInfo GameAccountInfo { get; set; } +// [ProtoMember(2)] public uint ErrorCode { get; set; } +// } +// +// /// +// /// GameAccount实体类 +// /// +// [ProtoContract] +// public partial class GameAccountInfo : AMessage, IProto +// { +// public static GameAccountInfo Create(Scene scene) +// { +// return scene.MessagePoolComponent.Rent(); +// } +// public override void Dispose() +// { +// CreateTime = default; +// LoginTime = default; +// #if FANTASY_NET || FANTASY_UNITY +// GetScene().MessagePoolComponent.Return(this); +// #endif +// } +// [ProtoMember(1)] +// public long CreateTime { get; set; } +// [ProtoMember(2)] +// public long LoginTime { get; set; } +// } \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/BclHelpers.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/BclHelpers.cs new file mode 100644 index 0000000..bcff9a4 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/BclHelpers.cs @@ -0,0 +1,712 @@ +using System; +using System.Reflection; +namespace ProtoBuf +{ + internal enum TimeSpanScale + { + Days = 0, + Hours = 1, + Minutes = 2, + Seconds = 3, + Milliseconds = 4, + Ticks = 5, + + MinMax = 15 + } + + /// + /// Provides support for common .NET types that do not have a direct representation + /// in protobuf, using the definitions from bcl.proto + /// + public static class BclHelpers + { + /// + /// Creates a new instance of the specified type, bypassing the constructor. + /// + /// The type to create + /// The new instance + /// If the platform does not support constructor-skipping + public static object GetUninitializedObject(Type type) + { +#if COREFX + object obj = TryGetUninitializedObjectWithFormatterServices(type); + if (obj != null) return obj; +#endif +#if PLAT_BINARYFORMATTER && !(COREFX || PROFILE259) + return System.Runtime.Serialization.FormatterServices.GetUninitializedObject(type); +#else + throw new NotSupportedException("Constructor-skipping is not supported on this platform"); +#endif + } + +#if COREFX // this is inspired by DCS: https://github.com/dotnet/corefx/blob/c02d33b18398199f6acc17d375dab154e9a1df66/src/System.Private.DataContractSerialization/src/System/Runtime/Serialization/XmlFormatReaderGenerator.cs#L854-L894 + static Func getUninitializedObject; + static internal object TryGetUninitializedObjectWithFormatterServices(Type type) + { + if (getUninitializedObject == null) + { + try { + var formatterServiceType = typeof(string).GetTypeInfo().Assembly.GetType("System.Runtime.Serialization.FormatterServices"); + if (formatterServiceType == null) + { + // fallback for .Net Core 3.0 + var formatterAssembly = Assembly.Load(new AssemblyName("System.Runtime.Serialization.Formatters")); + formatterServiceType = formatterAssembly.GetType("System.Runtime.Serialization.FormatterServices"); + } + MethodInfo method = formatterServiceType?.GetMethod("GetUninitializedObject", BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Static); + if (method != null) + { + getUninitializedObject = (Func)method.CreateDelegate(typeof(Func)); + } + } + catch { /* best efforts only */ } + if(getUninitializedObject == null) getUninitializedObject = x => null; + } + return getUninitializedObject(type); + } +#endif + + const int FieldTimeSpanValue = 0x01, FieldTimeSpanScale = 0x02, FieldTimeSpanKind = 0x03; + + internal static readonly DateTime[] EpochOrigin = { + new DateTime(1970, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), + new DateTime(1970, 1, 1, 0, 0, 0, 0, DateTimeKind.Utc), + new DateTime(1970, 1, 1, 0, 0, 0, 0, DateTimeKind.Local) + }; + + /// + /// The default value for dates that are following google.protobuf.Timestamp semantics + /// + private static readonly DateTime TimestampEpoch = EpochOrigin[(int)DateTimeKind.Utc]; + + /// + /// Writes a TimeSpan to a protobuf stream using protobuf-net's own representation, bcl.TimeSpan + /// + public static void WriteTimeSpan(TimeSpan timeSpan, ProtoWriter dest) + { + WriteTimeSpanImpl(timeSpan, dest, DateTimeKind.Unspecified); + } + + private static void WriteTimeSpanImpl(TimeSpan timeSpan, ProtoWriter dest, DateTimeKind kind) + { + if (dest == null) throw new ArgumentNullException(nameof(dest)); + long value; + switch (dest.WireType) + { + case WireType.String: + case WireType.StartGroup: + TimeSpanScale scale; + value = timeSpan.Ticks; + if (timeSpan == TimeSpan.MaxValue) + { + value = 1; + scale = TimeSpanScale.MinMax; + } + else if (timeSpan == TimeSpan.MinValue) + { + value = -1; + scale = TimeSpanScale.MinMax; + } + else if (value % TimeSpan.TicksPerDay == 0) + { + scale = TimeSpanScale.Days; + value /= TimeSpan.TicksPerDay; + } + else if (value % TimeSpan.TicksPerHour == 0) + { + scale = TimeSpanScale.Hours; + value /= TimeSpan.TicksPerHour; + } + else if (value % TimeSpan.TicksPerMinute == 0) + { + scale = TimeSpanScale.Minutes; + value /= TimeSpan.TicksPerMinute; + } + else if (value % TimeSpan.TicksPerSecond == 0) + { + scale = TimeSpanScale.Seconds; + value /= TimeSpan.TicksPerSecond; + } + else if (value % TimeSpan.TicksPerMillisecond == 0) + { + scale = TimeSpanScale.Milliseconds; + value /= TimeSpan.TicksPerMillisecond; + } + else + { + scale = TimeSpanScale.Ticks; + } + + SubItemToken token = ProtoWriter.StartSubItem(null, dest); + + if (value != 0) + { + ProtoWriter.WriteFieldHeader(FieldTimeSpanValue, WireType.SignedVariant, dest); + ProtoWriter.WriteInt64(value, dest); + } + if (scale != TimeSpanScale.Days) + { + ProtoWriter.WriteFieldHeader(FieldTimeSpanScale, WireType.Variant, dest); + ProtoWriter.WriteInt32((int)scale, dest); + } + if (kind != DateTimeKind.Unspecified) + { + ProtoWriter.WriteFieldHeader(FieldTimeSpanKind, WireType.Variant, dest); + ProtoWriter.WriteInt32((int)kind, dest); + } + ProtoWriter.EndSubItem(token, dest); + break; + case WireType.Fixed64: + ProtoWriter.WriteInt64(timeSpan.Ticks, dest); + break; + default: + throw new ProtoException("Unexpected wire-type: " + dest.WireType.ToString()); + } + } + + /// + /// Parses a TimeSpan from a protobuf stream using protobuf-net's own representation, bcl.TimeSpan + /// + public static TimeSpan ReadTimeSpan(ProtoReader source) + { + long ticks = ReadTimeSpanTicks(source, out DateTimeKind kind); + if (ticks == long.MinValue) return TimeSpan.MinValue; + if (ticks == long.MaxValue) return TimeSpan.MaxValue; + return TimeSpan.FromTicks(ticks); + } + + /// + /// Parses a TimeSpan from a protobuf stream using the standardized format, google.protobuf.Duration + /// + public static TimeSpan ReadDuration(ProtoReader source) + { + long seconds = 0; + int nanos = 0; + SubItemToken token = ProtoReader.StartSubItem(source); + int fieldNumber; + while ((fieldNumber = source.ReadFieldHeader()) > 0) + { + switch (fieldNumber) + { + case 1: + seconds = source.ReadInt64(); + break; + case 2: + nanos = source.ReadInt32(); + break; + default: + source.SkipField(); + break; + } + } + ProtoReader.EndSubItem(token, source); + return FromDurationSeconds(seconds, nanos); + } + + /// + /// Writes a TimeSpan to a protobuf stream using the standardized format, google.protobuf.Duration + /// + public static void WriteDuration(TimeSpan value, ProtoWriter dest) + { + var seconds = ToDurationSeconds(value, out int nanos); + WriteSecondsNanos(seconds, nanos, dest); + } + + private static void WriteSecondsNanos(long seconds, int nanos, ProtoWriter dest) + { + SubItemToken token = ProtoWriter.StartSubItem(null, dest); + if (seconds != 0) + { + ProtoWriter.WriteFieldHeader(1, WireType.Variant, dest); + ProtoWriter.WriteInt64(seconds, dest); + } + if (nanos != 0) + { + ProtoWriter.WriteFieldHeader(2, WireType.Variant, dest); + ProtoWriter.WriteInt32(nanos, dest); + } + ProtoWriter.EndSubItem(token, dest); + } + + /// + /// Parses a DateTime from a protobuf stream using the standardized format, google.protobuf.Timestamp + /// + public static DateTime ReadTimestamp(ProtoReader source) + { + // note: DateTime is only defined for just over 0000 to just below 10000; + // TimeSpan has a range of +/- 10,675,199 days === 29k years; + // so we can just use epoch time delta + return TimestampEpoch + ReadDuration(source); + } + + /// + /// Writes a DateTime to a protobuf stream using the standardized format, google.protobuf.Timestamp + /// + public static void WriteTimestamp(DateTime value, ProtoWriter dest) + { + var seconds = ToDurationSeconds(value - TimestampEpoch, out int nanos); + + if (nanos < 0) + { // from Timestamp.proto: + // "Negative second values with fractions must still have + // non -negative nanos values that count forward in time." + seconds--; + nanos += 1000000000; + } + WriteSecondsNanos(seconds, nanos, dest); + } + + static TimeSpan FromDurationSeconds(long seconds, int nanos) + { + + long ticks = checked((seconds * TimeSpan.TicksPerSecond) + + (nanos * TimeSpan.TicksPerMillisecond) / 1000000); + return TimeSpan.FromTicks(ticks); + } + + static long ToDurationSeconds(TimeSpan value, out int nanos) + { + nanos = (int)(((value.Ticks % TimeSpan.TicksPerSecond) * 1000000) + / TimeSpan.TicksPerMillisecond); + return value.Ticks / TimeSpan.TicksPerSecond; + } + + /// + /// Parses a DateTime from a protobuf stream + /// + public static DateTime ReadDateTime(ProtoReader source) + { + long ticks = ReadTimeSpanTicks(source, out DateTimeKind kind); + if (ticks == long.MinValue) return DateTime.MinValue; + if (ticks == long.MaxValue) return DateTime.MaxValue; + return EpochOrigin[(int)kind].AddTicks(ticks); + } + + /// + /// Writes a DateTime to a protobuf stream, excluding the Kind + /// + public static void WriteDateTime(DateTime value, ProtoWriter dest) + { + WriteDateTimeImpl(value, dest, false); + } + + /// + /// Writes a DateTime to a protobuf stream, including the Kind + /// + public static void WriteDateTimeWithKind(DateTime value, ProtoWriter dest) + { + WriteDateTimeImpl(value, dest, true); + } + + private static void WriteDateTimeImpl(DateTime value, ProtoWriter dest, bool includeKind) + { + if (dest == null) throw new ArgumentNullException(nameof(dest)); + TimeSpan delta; + switch (dest.WireType) + { + case WireType.StartGroup: + case WireType.String: + if (value == DateTime.MaxValue) + { + delta = TimeSpan.MaxValue; + includeKind = false; + } + else if (value == DateTime.MinValue) + { + delta = TimeSpan.MinValue; + includeKind = false; + } + else + { + delta = value - EpochOrigin[0]; + } + break; + default: + delta = value - EpochOrigin[0]; + break; + } + WriteTimeSpanImpl(delta, dest, includeKind ? value.Kind : DateTimeKind.Unspecified); + } + + private static long ReadTimeSpanTicks(ProtoReader source, out DateTimeKind kind) + { + kind = DateTimeKind.Unspecified; + switch (source.WireType) + { + case WireType.String: + case WireType.StartGroup: + SubItemToken token = ProtoReader.StartSubItem(source); + int fieldNumber; + TimeSpanScale scale = TimeSpanScale.Days; + long value = 0; + while ((fieldNumber = source.ReadFieldHeader()) > 0) + { + switch (fieldNumber) + { + case FieldTimeSpanScale: + scale = (TimeSpanScale)source.ReadInt32(); + break; + case FieldTimeSpanValue: + source.Assert(WireType.SignedVariant); + value = source.ReadInt64(); + break; + case FieldTimeSpanKind: + kind = (DateTimeKind)source.ReadInt32(); + switch (kind) + { + case DateTimeKind.Unspecified: + case DateTimeKind.Utc: + case DateTimeKind.Local: + break; // fine + default: + throw new ProtoException("Invalid date/time kind: " + kind.ToString()); + } + break; + default: + source.SkipField(); + break; + } + } + ProtoReader.EndSubItem(token, source); + switch (scale) + { + case TimeSpanScale.Days: + return value * TimeSpan.TicksPerDay; + case TimeSpanScale.Hours: + return value * TimeSpan.TicksPerHour; + case TimeSpanScale.Minutes: + return value * TimeSpan.TicksPerMinute; + case TimeSpanScale.Seconds: + return value * TimeSpan.TicksPerSecond; + case TimeSpanScale.Milliseconds: + return value * TimeSpan.TicksPerMillisecond; + case TimeSpanScale.Ticks: + return value; + case TimeSpanScale.MinMax: + switch (value) + { + case 1: return long.MaxValue; + case -1: return long.MinValue; + default: throw new ProtoException("Unknown min/max value: " + value.ToString()); + } + default: + throw new ProtoException("Unknown timescale: " + scale.ToString()); + } + case WireType.Fixed64: + return source.ReadInt64(); + default: + throw new ProtoException("Unexpected wire-type: " + source.WireType.ToString()); + } + } + + const int FieldDecimalLow = 0x01, FieldDecimalHigh = 0x02, FieldDecimalSignScale = 0x03; + + /// + /// Parses a decimal from a protobuf stream + /// + public static decimal ReadDecimal(ProtoReader reader) + { + ulong low = 0; + uint high = 0; + uint signScale = 0; + + int fieldNumber; + SubItemToken token = ProtoReader.StartSubItem(reader); + while ((fieldNumber = reader.ReadFieldHeader()) > 0) + { + switch (fieldNumber) + { + case FieldDecimalLow: low = reader.ReadUInt64(); break; + case FieldDecimalHigh: high = reader.ReadUInt32(); break; + case FieldDecimalSignScale: signScale = reader.ReadUInt32(); break; + default: reader.SkipField(); break; + } + + } + ProtoReader.EndSubItem(token, reader); + + int lo = (int)(low & 0xFFFFFFFFL), + mid = (int)((low >> 32) & 0xFFFFFFFFL), + hi = (int)high; + bool isNeg = (signScale & 0x0001) == 0x0001; + byte scale = (byte)((signScale & 0x01FE) >> 1); + return new decimal(lo, mid, hi, isNeg, scale); + } + + /// + /// Writes a decimal to a protobuf stream + /// + public static void WriteDecimal(decimal value, ProtoWriter writer) + { + int[] bits = decimal.GetBits(value); + ulong a = ((ulong)bits[1]) << 32, b = ((ulong)bits[0]) & 0xFFFFFFFFL; + ulong low = a | b; + uint high = (uint)bits[2]; + uint signScale = (uint)(((bits[3] >> 15) & 0x01FE) | ((bits[3] >> 31) & 0x0001)); + + SubItemToken token = ProtoWriter.StartSubItem(null, writer); + if (low != 0) + { + ProtoWriter.WriteFieldHeader(FieldDecimalLow, WireType.Variant, writer); + ProtoWriter.WriteUInt64(low, writer); + } + if (high != 0) + { + ProtoWriter.WriteFieldHeader(FieldDecimalHigh, WireType.Variant, writer); + ProtoWriter.WriteUInt32(high, writer); + } + if (signScale != 0) + { + ProtoWriter.WriteFieldHeader(FieldDecimalSignScale, WireType.Variant, writer); + ProtoWriter.WriteUInt32(signScale, writer); + } + ProtoWriter.EndSubItem(token, writer); + } + + const int FieldGuidLow = 1, FieldGuidHigh = 2; + /// + /// Writes a Guid to a protobuf stream + /// + public static void WriteGuid(Guid value, ProtoWriter dest) + { + byte[] blob = value.ToByteArray(); + + SubItemToken token = ProtoWriter.StartSubItem(null, dest); + if (value != Guid.Empty) + { + ProtoWriter.WriteFieldHeader(FieldGuidLow, WireType.Fixed64, dest); + ProtoWriter.WriteBytes(blob, 0, 8, dest); + ProtoWriter.WriteFieldHeader(FieldGuidHigh, WireType.Fixed64, dest); + ProtoWriter.WriteBytes(blob, 8, 8, dest); + } + ProtoWriter.EndSubItem(token, dest); + } + /// + /// Parses a Guid from a protobuf stream + /// + public static Guid ReadGuid(ProtoReader source) + { + ulong low = 0, high = 0; + int fieldNumber; + SubItemToken token = ProtoReader.StartSubItem(source); + while ((fieldNumber = source.ReadFieldHeader()) > 0) + { + switch (fieldNumber) + { + case FieldGuidLow: low = source.ReadUInt64(); break; + case FieldGuidHigh: high = source.ReadUInt64(); break; + default: source.SkipField(); break; + } + } + ProtoReader.EndSubItem(token, source); + if (low == 0 && high == 0) return Guid.Empty; + uint a = (uint)(low >> 32), b = (uint)low, c = (uint)(high >> 32), d = (uint)high; + return new Guid((int)b, (short)a, (short)(a >> 16), + (byte)d, (byte)(d >> 8), (byte)(d >> 16), (byte)(d >> 24), + (byte)c, (byte)(c >> 8), (byte)(c >> 16), (byte)(c >> 24)); + + } + + + private const int + FieldExistingObjectKey = 1, + FieldNewObjectKey = 2, + FieldExistingTypeKey = 3, + FieldNewTypeKey = 4, + FieldTypeName = 8, + FieldObject = 10; + + /// + /// Optional behaviours that introduce .NET-specific functionality + /// + [Flags] + public enum NetObjectOptions : byte + { + /// + /// No special behaviour + /// + None = 0, + /// + /// Enables full object-tracking/full-graph support. + /// + AsReference = 1, + /// + /// Embeds the type information into the stream, allowing usage with types not known in advance. + /// + DynamicType = 2, + /// + /// If false, the constructor for the type is bypassed during deserialization, meaning any field initializers + /// or other initialization code is skipped. + /// + UseConstructor = 4, + /// + /// Should the object index be reserved, rather than creating an object promptly + /// + LateSet = 8 + } + + /// + /// Reads an *implementation specific* bundled .NET object, including (as options) type-metadata, identity/re-use, etc. + /// + public static object ReadNetObject(object value, ProtoReader source, int key, Type type, NetObjectOptions options) + { + SubItemToken token = ProtoReader.StartSubItem(source); + int fieldNumber; + int newObjectKey = -1, newTypeKey = -1, tmp; + while ((fieldNumber = source.ReadFieldHeader()) > 0) + { + switch (fieldNumber) + { + case FieldExistingObjectKey: + tmp = source.ReadInt32(); + value = source.NetCache.GetKeyedObject(tmp); + break; + case FieldNewObjectKey: + newObjectKey = source.ReadInt32(); + break; + case FieldExistingTypeKey: + tmp = source.ReadInt32(); + type = (Type)source.NetCache.GetKeyedObject(tmp); + key = source.GetTypeKey(ref type); + break; + case FieldNewTypeKey: + newTypeKey = source.ReadInt32(); + break; + case FieldTypeName: + string typeName = source.ReadString(); + type = source.DeserializeType(typeName); + if (type == null) + { + throw new ProtoException("Unable to resolve type: " + typeName + " (you can use the TypeModel.DynamicTypeFormatting event to provide a custom mapping)"); + } + if (type == typeof(string)) + { + key = -1; + } + else + { + key = source.GetTypeKey(ref type); + if (key < 0) + throw new InvalidOperationException("Dynamic type is not a contract-type: " + type.Name); + } + break; + case FieldObject: + bool isString = type == typeof(string); + bool wasNull = value == null; + bool lateSet = wasNull && (isString || ((options & NetObjectOptions.LateSet) != 0)); + + if (newObjectKey >= 0 && !lateSet) + { + if (value == null) + { + source.TrapNextObject(newObjectKey); + } + else + { + source.NetCache.SetKeyedObject(newObjectKey, value); + } + if (newTypeKey >= 0) source.NetCache.SetKeyedObject(newTypeKey, type); + } + object oldValue = value; + if (isString) + { + value = source.ReadString(); + } + else + { + value = ProtoReader.ReadTypedObject(oldValue, key, source, type); + } + + if (newObjectKey >= 0) + { + if (wasNull && !lateSet) + { // this both ensures (via exception) that it *was* set, and makes sure we don't shout + // about changed references + oldValue = source.NetCache.GetKeyedObject(newObjectKey); + } + if (lateSet) + { + source.NetCache.SetKeyedObject(newObjectKey, value); + if (newTypeKey >= 0) source.NetCache.SetKeyedObject(newTypeKey, type); + } + } + if (newObjectKey >= 0 && !lateSet && !ReferenceEquals(oldValue, value)) + { + throw new ProtoException("A reference-tracked object changed reference during deserialization"); + } + if (newObjectKey < 0 && newTypeKey >= 0) + { // have a new type, but not a new object + source.NetCache.SetKeyedObject(newTypeKey, type); + } + break; + default: + source.SkipField(); + break; + } + } + if (newObjectKey >= 0 && (options & NetObjectOptions.AsReference) == 0) + { + throw new ProtoException("Object key in input stream, but reference-tracking was not expected"); + } + ProtoReader.EndSubItem(token, source); + + return value; + } + + /// + /// Writes an *implementation specific* bundled .NET object, including (as options) type-metadata, identity/re-use, etc. + /// + public static void WriteNetObject(object value, ProtoWriter dest, int key, NetObjectOptions options) + { + if (dest == null) throw new ArgumentNullException("dest"); + bool dynamicType = (options & NetObjectOptions.DynamicType) != 0, + asReference = (options & NetObjectOptions.AsReference) != 0; + WireType wireType = dest.WireType; + SubItemToken token = ProtoWriter.StartSubItem(null, dest); + bool writeObject = true; + if (asReference) + { + int objectKey = dest.NetCache.AddObjectKey(value, out bool existing); + ProtoWriter.WriteFieldHeader(existing ? FieldExistingObjectKey : FieldNewObjectKey, WireType.Variant, dest); + ProtoWriter.WriteInt32(objectKey, dest); + if (existing) + { + writeObject = false; + } + } + + if (writeObject) + { + if (dynamicType) + { + Type type = value.GetType(); + + if (!(value is string)) + { + key = dest.GetTypeKey(ref type); + if (key < 0) throw new InvalidOperationException("Dynamic type is not a contract-type: " + type.Name); + } + int typeKey = dest.NetCache.AddObjectKey(type, out bool existing); + ProtoWriter.WriteFieldHeader(existing ? FieldExistingTypeKey : FieldNewTypeKey, WireType.Variant, dest); + ProtoWriter.WriteInt32(typeKey, dest); + if (!existing) + { + ProtoWriter.WriteFieldHeader(FieldTypeName, WireType.String, dest); + ProtoWriter.WriteString(dest.SerializeType(type), dest); + } + + } + ProtoWriter.WriteFieldHeader(FieldObject, wireType, dest); + if (value is string) + { + ProtoWriter.WriteString((string)value, dest); + } + else + { + ProtoWriter.WriteObject(value, key, dest); + } + } + ProtoWriter.EndSubItem(token, dest); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/BufferExtension.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/BufferExtension.cs new file mode 100644 index 0000000..ea428dd --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/BufferExtension.cs @@ -0,0 +1,78 @@ +using System; +using System.IO; + +namespace ProtoBuf +{ + /// + /// Provides a simple buffer-based implementation of an extension object. + /// + public sealed class BufferExtension : IExtension, IExtensionResettable + { + private byte[] buffer; + + void IExtensionResettable.Reset() + { + buffer = null; + } + + int IExtension.GetLength() + { + return buffer == null ? 0 : buffer.Length; + } + + Stream IExtension.BeginAppend() + { + return new MemoryStream(); + } + + void IExtension.EndAppend(Stream stream, bool commit) + { + using (stream) + { + int len; + if (commit && (len = (int)stream.Length) > 0) + { + MemoryStream ms = (MemoryStream)stream; + + if (buffer == null) + { // allocate new buffer + buffer = ms.ToArray(); + } + else + { // resize and copy the data + // note: Array.Resize not available on CF + int offset = buffer.Length; + byte[] tmp = new byte[offset + len]; + Buffer.BlockCopy(buffer, 0, tmp, 0, offset); + +#if PORTABLE // no GetBuffer() - fine, we'll use Read instead + int bytesRead; + long oldPos = ms.Position; + ms.Position = 0; + while (len > 0 && (bytesRead = ms.Read(tmp, offset, len)) > 0) + { + len -= bytesRead; + offset += bytesRead; + } + if(len != 0) throw new EndOfStreamException(); + ms.Position = oldPos; +#else + Buffer.BlockCopy(Helpers.GetBuffer(ms), 0, tmp, offset, len); +#endif + buffer = tmp; + } + } + } + } + + Stream IExtension.BeginQuery() + { + return buffer == null ? Stream.Null : new MemoryStream(buffer); + } + + void IExtension.EndQuery(Stream stream) + { + using (stream) { } // just clean up + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/BufferPool.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/BufferPool.cs new file mode 100644 index 0000000..8ad3d1a --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/BufferPool.cs @@ -0,0 +1,149 @@ +using System; + +namespace ProtoBuf +{ + internal sealed class BufferPool + { + internal static void Flush() + { + lock (Pool) + { + for (var i = 0; i < Pool.Length; i++) + Pool[i] = null; + } + } + + private BufferPool() { } + private const int POOL_SIZE = 20; + internal const int BUFFER_LENGTH = 1024; + private static readonly CachedBuffer[] Pool = new CachedBuffer[POOL_SIZE]; + + internal static byte[] GetBuffer() => GetBuffer(BUFFER_LENGTH); + + internal static byte[] GetBuffer(int minSize) + { + byte[] cachedBuff = GetCachedBuffer(minSize); + return cachedBuff ?? new byte[minSize]; + } + + internal static byte[] GetCachedBuffer(int minSize) + { + lock (Pool) + { + var bestIndex = -1; + byte[] bestMatch = null; + for (var i = 0; i < Pool.Length; i++) + { + var buffer = Pool[i]; + if (buffer == null || buffer.Size < minSize) + { + continue; + } + if (bestMatch != null && bestMatch.Length < buffer.Size) + { + continue; + } + + var tmp = buffer.Buffer; + if (tmp == null) + { + Pool[i] = null; + } + else + { + bestMatch = tmp; + bestIndex = i; + } + } + + if (bestIndex >= 0) + { + Pool[bestIndex] = null; + } + + return bestMatch; + } + } + + /// + /// https://docs.microsoft.com/en-us/dotnet/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element + /// + private const int MaxByteArraySize = int.MaxValue - 56; + + internal static void ResizeAndFlushLeft(ref byte[] buffer, int toFitAtLeastBytes, int copyFromIndex, int copyBytes) + { + Helpers.DebugAssert(buffer != null); + Helpers.DebugAssert(toFitAtLeastBytes > buffer.Length); + Helpers.DebugAssert(copyFromIndex >= 0); + Helpers.DebugAssert(copyBytes >= 0); + + int newLength = buffer.Length * 2; + if (newLength < 0) + { + newLength = MaxByteArraySize; + } + + if (newLength < toFitAtLeastBytes) newLength = toFitAtLeastBytes; + + if (copyBytes == 0) + { + ReleaseBufferToPool(ref buffer); + } + + var newBuffer = GetCachedBuffer(toFitAtLeastBytes) ?? new byte[newLength]; + + if (copyBytes > 0) + { + Buffer.BlockCopy(buffer, copyFromIndex, newBuffer, 0, copyBytes); + ReleaseBufferToPool(ref buffer); + } + + buffer = newBuffer; + } + + internal static void ReleaseBufferToPool(ref byte[] buffer) + { + if (buffer == null) return; + + lock (Pool) + { + var minIndex = 0; + var minSize = int.MaxValue; + for (var i = 0; i < Pool.Length; i++) + { + var tmp = Pool[i]; + if (tmp == null || !tmp.IsAlive) + { + minIndex = 0; + break; + } + if (tmp.Size < minSize) + { + minIndex = i; + minSize = tmp.Size; + } + } + + Pool[minIndex] = new CachedBuffer(buffer); + } + + buffer = null; + } + + private class CachedBuffer + { + private readonly WeakReference _reference; + + public int Size { get; } + + public bool IsAlive => _reference.IsAlive; + public byte[] Buffer => (byte[])_reference.Target; + + public CachedBuffer(byte[] buffer) + { + Size = buffer.Length; + _reference = new WeakReference(buffer); + } + } + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/CallbackAttributes.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/CallbackAttributes.cs new file mode 100644 index 0000000..1adb8e5 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/CallbackAttributes.cs @@ -0,0 +1,33 @@ +using System; +using System.ComponentModel; + +namespace ProtoBuf +{ + /// Specifies a method on the root-contract in an hierarchy to be invoked before serialization. + [AttributeUsage(AttributeTargets.Method, AllowMultiple = false, Inherited = false)] +#if !CF && !PORTABLE && !COREFX && !PROFILE259 + [ImmutableObject(true)] +#endif + public sealed class ProtoBeforeSerializationAttribute : Attribute { } + + /// Specifies a method on the root-contract in an hierarchy to be invoked after serialization. + [AttributeUsage(AttributeTargets.Method, AllowMultiple = false, Inherited = false)] +#if !CF && !PORTABLE && !COREFX && !PROFILE259 + [ImmutableObject(true)] +#endif + public sealed class ProtoAfterSerializationAttribute : Attribute { } + + /// Specifies a method on the root-contract in an hierarchy to be invoked before deserialization. + [AttributeUsage(AttributeTargets.Method, AllowMultiple = false, Inherited = false)] +#if !CF && !PORTABLE && !COREFX && !PROFILE259 + [ImmutableObject(true)] +#endif + public sealed class ProtoBeforeDeserializationAttribute : Attribute { } + + /// Specifies a method on the root-contract in an hierarchy to be invoked after deserialization. + [AttributeUsage(AttributeTargets.Method, AllowMultiple = false, Inherited = false)] +#if !CF && !PORTABLE && !COREFX && !PROFILE259 + [ImmutableObject(true)] +#endif + public sealed class ProtoAfterDeserializationAttribute : Attribute { } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/CompilerContext.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/CompilerContext.cs new file mode 100644 index 0000000..6100200 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/CompilerContext.cs @@ -0,0 +1,1435 @@ +#if FEAT_COMPILER +//#define DEBUG_COMPILE +using System; +using System.Threading; +using ProtoBuf.Meta; +using ProtoBuf.Serializers; +using System.Reflection; +using System.Reflection.Emit; + +namespace ProtoBuf.Compiler +{ + internal readonly struct CodeLabel + { + public readonly Label Value; + public readonly int Index; + public CodeLabel(Label value, int index) + { + this.Value = value; + this.Index = index; + } + } + internal sealed class CompilerContext + { + public TypeModel Model => model; + + readonly DynamicMethod method; + static int next; + + internal CodeLabel DefineLabel() + { + CodeLabel result = new CodeLabel(il.DefineLabel(), nextLabel++); + return result; + } +#if DEBUG_COMPILE + static readonly string traceCompilePath; + static CompilerContext() + { + traceCompilePath = System.IO.Path.Combine(System.IO.Directory.GetCurrentDirectory(), + "TraceCompile.txt"); + Console.WriteLine("DEBUG_COMPILE enabled; writing to " + traceCompilePath); + } +#endif + [System.Diagnostics.Conditional("DEBUG_COMPILE")] + private void TraceCompile(string value) + { +#if DEBUG_COMPILE + if (!string.IsNullOrWhiteSpace(value)) + { + using (System.IO.StreamWriter sw = System.IO.File.AppendText(traceCompilePath)) + { + sw.WriteLine(value); + } + } +#endif + } + internal void MarkLabel(CodeLabel label) + { + il.MarkLabel(label.Value); + TraceCompile("#: " + label.Index); + } + + public static ProtoSerializer BuildSerializer(IProtoSerializer head, TypeModel model) + { + Type type = head.ExpectedType; + try + { + CompilerContext ctx = new CompilerContext(type, true, true, model, typeof(object)); + ctx.LoadValue(ctx.InputValue); + ctx.CastFromObject(type); + ctx.WriteNullCheckedTail(type, head, null); + ctx.Emit(OpCodes.Ret); + return (ProtoSerializer)ctx.method.CreateDelegate( + typeof(ProtoSerializer)); + } + catch (Exception ex) + { + string name = type.FullName; + if (string.IsNullOrEmpty(name)) name = type.Name; + throw new InvalidOperationException("It was not possible to prepare a serializer for: " + name, ex); + } + } + /*public static ProtoCallback BuildCallback(IProtoTypeSerializer head) + { + Type type = head.ExpectedType; + CompilerContext ctx = new CompilerContext(type, true, true); + using (Local typedVal = new Local(ctx, type)) + { + ctx.LoadValue(Local.InputValue); + ctx.CastFromObject(type); + ctx.StoreValue(typedVal); + CodeLabel[] jumpTable = new CodeLabel[4]; + for(int i = 0 ; i < jumpTable.Length ; i++) { + jumpTable[i] = ctx.DefineLabel(); + } + ctx.LoadReaderWriter(); + ctx.Switch(jumpTable); + ctx.Return(); + for(int i = 0 ; i < jumpTable.Length ; i++) { + ctx.MarkLabel(jumpTable[i]); + if (head.HasCallbacks((TypeModel.CallbackType)i)) + { + head.EmitCallback(ctx, typedVal, (TypeModel.CallbackType)i); + } + ctx.Return(); + } + } + + ctx.Emit(OpCodes.Ret); + return (ProtoCallback)ctx.method.CreateDelegate( + typeof(ProtoCallback)); + }*/ + public static ProtoDeserializer BuildDeserializer(IProtoSerializer head, TypeModel model) + { + Type type = head.ExpectedType; + CompilerContext ctx = new CompilerContext(type, false, true, model, typeof(object)); + + using (Local typedVal = new Local(ctx, type)) + { + if (!Helpers.IsValueType(type)) + { + ctx.LoadValue(ctx.InputValue); + ctx.CastFromObject(type); + ctx.StoreValue(typedVal); + } + else + { + ctx.LoadValue(ctx.InputValue); + CodeLabel notNull = ctx.DefineLabel(), endNull = ctx.DefineLabel(); + ctx.BranchIfTrue(notNull, true); + + ctx.LoadAddress(typedVal, type); + ctx.EmitCtor(type); + ctx.Branch(endNull, true); + + ctx.MarkLabel(notNull); + ctx.LoadValue(ctx.InputValue); + ctx.CastFromObject(type); + ctx.StoreValue(typedVal); + + ctx.MarkLabel(endNull); + } + head.EmitRead(ctx, typedVal); + + if (head.ReturnsValue) + { + ctx.StoreValue(typedVal); + } + + ctx.LoadValue(typedVal); + ctx.CastToObject(type); + } + ctx.Emit(OpCodes.Ret); + return (ProtoDeserializer)ctx.method.CreateDelegate( + typeof(ProtoDeserializer)); + } + + internal void Return() + { + Emit(OpCodes.Ret); + } + + static bool IsObject(Type type) + { + return type == typeof(object); + } + + internal void CastToObject(Type type) + { + if (IsObject(type)) + { } + else if (Helpers.IsValueType(type)) + { + il.Emit(OpCodes.Box, type); + TraceCompile(OpCodes.Box + ": " + type); + } + else + { + il.Emit(OpCodes.Castclass, MapType(typeof(object))); + TraceCompile(OpCodes.Castclass + ": " + type); + } + } + + internal void CastFromObject(Type type) + { + if (IsObject(type)) + { } + else if (Helpers.IsValueType(type)) + { + switch (MetadataVersion) + { + case ILVersion.Net1: + il.Emit(OpCodes.Unbox, type); + il.Emit(OpCodes.Ldobj, type); + TraceCompile(OpCodes.Unbox + ": " + type); + TraceCompile(OpCodes.Ldobj + ": " + type); + break; + default: + + il.Emit(OpCodes.Unbox_Any, type); + TraceCompile(OpCodes.Unbox_Any + ": " + type); + break; + } + } + else + { + il.Emit(OpCodes.Castclass, type); + TraceCompile(OpCodes.Castclass + ": " + type); + } + } + private readonly bool isStatic; + private readonly RuntimeTypeModel.SerializerPair[] methodPairs; + + internal MethodBuilder GetDedicatedMethod(int metaKey, bool read) + { + if (methodPairs == null) return null; + // but if we *do* have pairs, we demand that we find a match... + for (int i = 0; i < methodPairs.Length; i++) + { + if (methodPairs[i].MetaKey == metaKey) { return read ? methodPairs[i].Deserialize : methodPairs[i].Serialize; } + } + throw new ArgumentException("Meta-key not found", "metaKey"); + } + + internal int MapMetaKeyToCompiledKey(int metaKey) + { + if (metaKey < 0 || methodPairs == null) return metaKey; // all meta, or a dummy/wildcard key + + for (int i = 0; i < methodPairs.Length; i++) + { + if (methodPairs[i].MetaKey == metaKey) return i; + } + throw new ArgumentException("Key could not be mapped: " + metaKey.ToString(), "metaKey"); + } + + + private readonly bool isWriter; + + private readonly bool nonPublic; + internal bool NonPublic { get { return nonPublic; } } + + private readonly Local inputValue; + public Local InputValue { get { return inputValue; } } + + private readonly string assemblyName; + internal CompilerContext(ILGenerator il, bool isStatic, bool isWriter, RuntimeTypeModel.SerializerPair[] methodPairs, TypeModel model, ILVersion metadataVersion, string assemblyName, Type inputType, string traceName) + { + if (string.IsNullOrEmpty(assemblyName)) throw new ArgumentNullException(nameof(assemblyName)); + this.assemblyName = assemblyName; + this.isStatic = isStatic; + this.methodPairs = methodPairs ?? throw new ArgumentNullException(nameof(methodPairs)); + this.il = il ?? throw new ArgumentNullException(nameof(il)); + // nonPublic = false; <== implicit + this.isWriter = isWriter; + this.model = model ?? throw new ArgumentNullException(nameof(model)); + this.metadataVersion = metadataVersion; + if (inputType != null) this.inputValue = new Local(null, inputType); + TraceCompile(">> " + traceName); + } + + private CompilerContext(Type associatedType, bool isWriter, bool isStatic, TypeModel model, Type inputType) + { + metadataVersion = ILVersion.Net2; + this.isStatic = isStatic; + this.isWriter = isWriter; + this.model = model ?? throw new ArgumentNullException(nameof(model)); + nonPublic = true; + Type[] paramTypes; + Type returnType; + if (isWriter) + { + returnType = typeof(void); + paramTypes = new Type[] { typeof(object), typeof(ProtoWriter) }; + } + else + { + returnType = typeof(object); + paramTypes = new Type[] { typeof(object), typeof(ProtoReader) }; + } + int uniqueIdentifier; +#if PLAT_NO_INTERLOCKED + uniqueIdentifier = ++next; +#else + uniqueIdentifier = Interlocked.Increment(ref next); +#endif + method = new DynamicMethod("proto_" + uniqueIdentifier.ToString(), returnType, paramTypes, associatedType +#if COREFX + .GetTypeInfo() +#endif + .IsInterface ? typeof(object) : associatedType, true); + this.il = method.GetILGenerator(); + if (inputType != null) this.inputValue = new Local(null, inputType); + TraceCompile(">> " + method.Name); + } + + private readonly ILGenerator il; + + private void Emit(OpCode opcode) + { + il.Emit(opcode); + TraceCompile(opcode.ToString()); + } + + public void LoadValue(string value) + { + if (value == null) + { + LoadNullRef(); + } + else + { + il.Emit(OpCodes.Ldstr, value); + TraceCompile(OpCodes.Ldstr + ": " + value); + } + } + + public void LoadValue(float value) + { + il.Emit(OpCodes.Ldc_R4, value); + TraceCompile(OpCodes.Ldc_R4 + ": " + value); + } + + public void LoadValue(double value) + { + il.Emit(OpCodes.Ldc_R8, value); + TraceCompile(OpCodes.Ldc_R8 + ": " + value); + } + + public void LoadValue(long value) + { + il.Emit(OpCodes.Ldc_I8, value); + TraceCompile(OpCodes.Ldc_I8 + ": " + value); + } + + public void LoadValue(int value) + { + switch (value) + { + case 0: Emit(OpCodes.Ldc_I4_0); break; + case 1: Emit(OpCodes.Ldc_I4_1); break; + case 2: Emit(OpCodes.Ldc_I4_2); break; + case 3: Emit(OpCodes.Ldc_I4_3); break; + case 4: Emit(OpCodes.Ldc_I4_4); break; + case 5: Emit(OpCodes.Ldc_I4_5); break; + case 6: Emit(OpCodes.Ldc_I4_6); break; + case 7: Emit(OpCodes.Ldc_I4_7); break; + case 8: Emit(OpCodes.Ldc_I4_8); break; + case -1: Emit(OpCodes.Ldc_I4_M1); break; + default: + if (value >= -128 && value <= 127) + { + il.Emit(OpCodes.Ldc_I4_S, (sbyte)value); + TraceCompile(OpCodes.Ldc_I4_S + ": " + value); + } + else + { + il.Emit(OpCodes.Ldc_I4, value); + TraceCompile(OpCodes.Ldc_I4 + ": " + value); + } + break; + + } + } + + MutableList locals = new MutableList(); + internal LocalBuilder GetFromPool(Type type) + { + int count = locals.Count; + for (int i = 0; i < count; i++) + { + LocalBuilder item = (LocalBuilder)locals[i]; + if (item != null && item.LocalType == type) + { + locals[i] = null; // remove from pool + return item; + } + } + LocalBuilder result = il.DeclareLocal(type); + TraceCompile("$ " + result + ": " + type); + return result; + } + + // + internal void ReleaseToPool(LocalBuilder value) + { + int count = locals.Count; + for (int i = 0; i < count; i++) + { + if (locals[i] == null) + { + locals[i] = value; // released into existing slot + return; + } + } + locals.Add(value); // create a new slot + } + + public void LoadReaderWriter() + { + Emit(isStatic ? OpCodes.Ldarg_1 : OpCodes.Ldarg_2); + } + + public void StoreValue(Local local) + { + if (local == this.InputValue) + { + byte b = isStatic ? (byte)0 : (byte)1; + il.Emit(OpCodes.Starg_S, b); + TraceCompile(OpCodes.Starg_S + ": $" + b); + } + else + { + + switch (local.Value.LocalIndex) + { + case 0: Emit(OpCodes.Stloc_0); break; + case 1: Emit(OpCodes.Stloc_1); break; + case 2: Emit(OpCodes.Stloc_2); break; + case 3: Emit(OpCodes.Stloc_3); break; + default: + + OpCode code = UseShortForm(local) ? OpCodes.Stloc_S : OpCodes.Stloc; + il.Emit(code, local.Value); + TraceCompile(code + ": $" + local.Value); + + break; + } + } + } + + public void LoadValue(Local local) + { + if (local == null) { /* nothing to do; top of stack */} + else if (local == this.InputValue) + { + Emit(isStatic ? OpCodes.Ldarg_0 : OpCodes.Ldarg_1); + } + else + { + + switch (local.Value.LocalIndex) + { + case 0: Emit(OpCodes.Ldloc_0); break; + case 1: Emit(OpCodes.Ldloc_1); break; + case 2: Emit(OpCodes.Ldloc_2); break; + case 3: Emit(OpCodes.Ldloc_3); break; + default: + + OpCode code = UseShortForm(local) ? OpCodes.Ldloc_S : OpCodes.Ldloc; + il.Emit(code, local.Value); + TraceCompile(code + ": $" + local.Value); + + break; + } + } + } + + public Local GetLocalWithValue(Type type, Compiler.Local fromValue) + { + if (fromValue != null) + { + if (fromValue.Type == type) return fromValue.AsCopy(); + // otherwise, load onto the stack and let the default handling (below) deal with it + LoadValue(fromValue); + if (!Helpers.IsValueType(type) && (fromValue.Type == null || !type.IsAssignableFrom(fromValue.Type))) + { // need to cast + Cast(type); + } + } + // need to store the value from the stack + Local result = new Local(this, type); + StoreValue(result); + return result; + } + + internal void EmitBasicRead(string methodName, Type expectedType) + { + MethodInfo method = MapType(typeof(ProtoReader)).GetMethod( + methodName, BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance); + if (method == null || method.ReturnType != expectedType + || method.GetParameters().Length != 0) throw new ArgumentException("methodName"); + LoadReaderWriter(); + EmitCall(method); + } + + internal void EmitBasicRead(Type helperType, string methodName, Type expectedType) + { + MethodInfo method = helperType.GetMethod( + methodName, BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static); + if (method == null || method.ReturnType != expectedType + || method.GetParameters().Length != 1) throw new ArgumentException("methodName"); + LoadReaderWriter(); + EmitCall(method); + } + + internal void EmitBasicWrite(string methodName, Compiler.Local fromValue) + { + if (string.IsNullOrEmpty(methodName)) throw new ArgumentNullException("methodName"); + LoadValue(fromValue); + LoadReaderWriter(); + EmitCall(GetWriterMethod(methodName)); + } + + private MethodInfo GetWriterMethod(string methodName) + { + Type writerType = MapType(typeof(ProtoWriter)); + MethodInfo[] methods = writerType.GetMethods(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static); + foreach (MethodInfo method in methods) + { + if (method.Name != methodName) continue; + ParameterInfo[] pis = method.GetParameters(); + if (pis.Length == 2 && pis[1].ParameterType == writerType) return method; + } + throw new ArgumentException("No suitable method found for: " + methodName, "methodName"); + } + + internal void EmitWrite(Type helperType, string methodName, Compiler.Local valueFrom) + { + if (string.IsNullOrEmpty(methodName)) throw new ArgumentNullException("methodName"); + MethodInfo method = helperType.GetMethod( + methodName, BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static); + if (method == null || method.ReturnType != MapType(typeof(void))) throw new ArgumentException("methodName"); + LoadValue(valueFrom); + LoadReaderWriter(); + EmitCall(method); + } + + public void EmitCall(MethodInfo method) { EmitCall(method, null); } + + public void EmitCall(MethodInfo method, Type targetType) + { + Helpers.DebugAssert(method != null); + MemberInfo member = method; + CheckAccessibility(ref member); + OpCode opcode; + if (method.IsStatic || Helpers.IsValueType(method.DeclaringType)) + { + opcode = OpCodes.Call; + } + else + { + opcode = OpCodes.Callvirt; + if (targetType != null && Helpers.IsValueType(targetType) && !Helpers.IsValueType(method.DeclaringType)) + { + Constrain(targetType); + } + } + il.EmitCall(opcode, method, null); + TraceCompile(opcode + ": " + method + " on " + method.DeclaringType + (targetType == null ? "" : (" via " + targetType))); + } + + /// + /// Pushes a null reference onto the stack. Note that this should only + /// be used to return a null (or set a variable to null); for null-tests + /// use BranchIfTrue / BranchIfFalse. + /// + public void LoadNullRef() + { + Emit(OpCodes.Ldnull); + } + + private int nextLabel; + + internal void WriteNullCheckedTail(Type type, IProtoSerializer tail, Compiler.Local valueFrom) + { + if (Helpers.IsValueType(type)) + { + Type underlyingType = Helpers.GetUnderlyingType(type); + + if (underlyingType == null) + { // not a nullable T; can invoke directly + tail.EmitWrite(this, valueFrom); + } + else + { // nullable T; check HasValue + using (Compiler.Local valOrNull = GetLocalWithValue(type, valueFrom)) + { + LoadAddress(valOrNull, type); + LoadValue(type.GetProperty("HasValue")); + CodeLabel @end = DefineLabel(); + BranchIfFalse(@end, false); + LoadAddress(valOrNull, type); + EmitCall(type.GetMethod("GetValueOrDefault", Helpers.EmptyTypes)); + tail.EmitWrite(this, null); + MarkLabel(@end); + } + } + } + else + { // ref-type; do a null-check + LoadValue(valueFrom); + CopyValue(); + CodeLabel hasVal = DefineLabel(), @end = DefineLabel(); + BranchIfTrue(hasVal, true); + DiscardValue(); + Branch(@end, false); + MarkLabel(hasVal); + tail.EmitWrite(this, null); + MarkLabel(@end); + } + } + + internal void ReadNullCheckedTail(Type type, IProtoSerializer tail, Compiler.Local valueFrom) + { + + Type underlyingType; + + if (Helpers.IsValueType(type) && (underlyingType = Helpers.GetUnderlyingType(type)) != null) + { + if (tail.RequiresOldValue) + { + // we expect the input value to be in valueFrom; need to unpack it from T? + using (Local loc = GetLocalWithValue(type, valueFrom)) + { + LoadAddress(loc, type); + EmitCall(type.GetMethod("GetValueOrDefault", Helpers.EmptyTypes)); + } + } + else + { + Helpers.DebugAssert(valueFrom == null); // not expecting a valueFrom in this case + } + tail.EmitRead(this, null); // either unwrapped on the stack or not provided + if (tail.ReturnsValue) + { + // now re-wrap the value + EmitCtor(type, underlyingType); + } + return; + } + + // either a ref-type of a non-nullable struct; treat "as is", even if null + // (the type-serializer will handle the null case; it needs to allow null + // inputs to perform the correct type of subclass creation) + tail.EmitRead(this, valueFrom); + } + + public void EmitCtor(Type type) + { + EmitCtor(type, Helpers.EmptyTypes); + } + + public void EmitCtor(ConstructorInfo ctor) + { + if (ctor == null) throw new ArgumentNullException("ctor"); + MemberInfo ctorMember = ctor; + CheckAccessibility(ref ctorMember); + il.Emit(OpCodes.Newobj, ctor); + TraceCompile(OpCodes.Newobj + ": " + ctor.DeclaringType); + } + + public void InitLocal(Type type, Compiler.Local target) + { + LoadAddress(target, type, evenIfClass: true); // for class, initobj is a load-null, store-indirect + il.Emit(OpCodes.Initobj, type); + TraceCompile(OpCodes.Initobj + ": " + type); + } + + public void EmitCtor(Type type, params Type[] parameterTypes) + { + Helpers.DebugAssert(type != null); + Helpers.DebugAssert(parameterTypes != null); + if (Helpers.IsValueType(type) && parameterTypes.Length == 0) + { + il.Emit(OpCodes.Initobj, type); + TraceCompile(OpCodes.Initobj + ": " + type); + } + else + { + ConstructorInfo ctor = Helpers.GetConstructor(type +#if COREFX + .GetTypeInfo() +#endif + , parameterTypes, true); + if (ctor == null) throw new InvalidOperationException("No suitable constructor found for " + type.FullName); + EmitCtor(ctor); + } + } + + BasicList knownTrustedAssemblies, knownUntrustedAssemblies; + + bool InternalsVisible(Assembly assembly) + { + if (string.IsNullOrEmpty(assemblyName)) return false; + if (knownTrustedAssemblies != null) + { + if (knownTrustedAssemblies.IndexOfReference(assembly) >= 0) + { + return true; + } + } + if (knownUntrustedAssemblies != null) + { + if (knownUntrustedAssemblies.IndexOfReference(assembly) >= 0) + { + return false; + } + } + bool isTrusted = false; + Type attributeType = MapType(typeof(System.Runtime.CompilerServices.InternalsVisibleToAttribute)); + if (attributeType == null) return false; + +#if COREFX + foreach (System.Runtime.CompilerServices.InternalsVisibleToAttribute attrib in assembly.GetCustomAttributes(attributeType)) +#else + foreach (System.Runtime.CompilerServices.InternalsVisibleToAttribute attrib in assembly.GetCustomAttributes(attributeType, false)) +#endif + { + if (attrib.AssemblyName == assemblyName || attrib.AssemblyName.StartsWith(assemblyName + ",")) + { + isTrusted = true; + break; + } + } + + if (isTrusted) + { + if (knownTrustedAssemblies == null) knownTrustedAssemblies = new BasicList(); + knownTrustedAssemblies.Add(assembly); + } + else + { + if (knownUntrustedAssemblies == null) knownUntrustedAssemblies = new BasicList(); + knownUntrustedAssemblies.Add(assembly); + } + return isTrusted; + } + + internal void CheckAccessibility(ref MemberInfo member) + { + if (member == null) + { + throw new ArgumentNullException(nameof(member)); + } +#if !COREFX + Type type; +#endif + if (!NonPublic) + { + if (member is FieldInfo && member.Name.StartsWith("<") & member.Name.EndsWith(">k__BackingField")) + { + var propName = member.Name.Substring(1, member.Name.Length - 17); + var prop = member.DeclaringType.GetProperty(propName, BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static); + if (prop != null) member = prop; + } + bool isPublic; +#if COREFX + if (member is TypeInfo) + { + TypeInfo ti = (TypeInfo)member; + do + { + isPublic = ti.IsNestedPublic || ti.IsPublic || ((ti.IsNested || ti.IsNestedAssembly || ti.IsNestedFamORAssem) && InternalsVisible(ti.Assembly)); + } while (isPublic && ti.IsNested && (ti = ti.DeclaringType.GetTypeInfo()) != null); + } + else if (member is FieldInfo) + { + FieldInfo field = ((FieldInfo)member); + isPublic = field.IsPublic || ((field.IsAssembly || field.IsFamilyOrAssembly) && InternalsVisible(Helpers.GetAssembly(field.DeclaringType))); + } + else if (member is PropertyInfo) + { + isPublic = true; // defer to get/set + } + else if (member is ConstructorInfo) + { + ConstructorInfo ctor = ((ConstructorInfo)member); + isPublic = ctor.IsPublic || ((ctor.IsAssembly || ctor.IsFamilyOrAssembly) && InternalsVisible(Helpers.GetAssembly(ctor.DeclaringType))); + } + else if (member is MethodInfo) + { + MethodInfo method = ((MethodInfo)member); + isPublic = method.IsPublic || ((method.IsAssembly || method.IsFamilyOrAssembly) && InternalsVisible(Helpers.GetAssembly(method.DeclaringType))); + if (!isPublic) + { + // allow calls to TypeModel protected methods, and methods we are in the process of creating + if ( + member is MethodBuilder || + member.DeclaringType == MapType(typeof(TypeModel))) + isPublic = true; + } + } + else + { + throw new NotSupportedException(member.GetType().Name); + } +#else + MemberTypes memberType = member.MemberType; + switch (memberType) + { + case MemberTypes.TypeInfo: + // top-level type + type = (Type)member; + isPublic = type.IsPublic || InternalsVisible(type.Assembly); + break; + case MemberTypes.NestedType: + type = (Type)member; + do + { + isPublic = type.IsNestedPublic || type.IsPublic || ((type.DeclaringType == null || type.IsNestedAssembly || type.IsNestedFamORAssem) && InternalsVisible(type.Assembly)); + } while (isPublic && (type = type.DeclaringType) != null); // ^^^ !type.IsNested, but not all runtimes have that + break; + case MemberTypes.Field: + FieldInfo field = ((FieldInfo)member); + isPublic = field.IsPublic || ((field.IsAssembly || field.IsFamilyOrAssembly) && InternalsVisible(field.DeclaringType.Assembly)); + break; + case MemberTypes.Constructor: + ConstructorInfo ctor = ((ConstructorInfo)member); + isPublic = ctor.IsPublic || ((ctor.IsAssembly || ctor.IsFamilyOrAssembly) && InternalsVisible(ctor.DeclaringType.Assembly)); + break; + case MemberTypes.Method: + MethodInfo method = ((MethodInfo)member); + isPublic = method.IsPublic || ((method.IsAssembly || method.IsFamilyOrAssembly) && InternalsVisible(method.DeclaringType.Assembly)); + if (!isPublic) + { + // allow calls to TypeModel protected methods, and methods we are in the process of creating + if ( + member is MethodBuilder || + member.DeclaringType == MapType(typeof(TypeModel))) isPublic = true; + } + break; + case MemberTypes.Property: + isPublic = true; // defer to get/set + break; + default: + throw new NotSupportedException(memberType.ToString()); + } +#endif + if (!isPublic) + { +#if COREFX + if (member is TypeInfo) + { + throw new InvalidOperationException("Non-public type cannot be used with full dll compilation: " + + ((TypeInfo)member).FullName); + } + else + { + throw new InvalidOperationException("Non-public member cannot be used with full dll compilation: " + + member.DeclaringType.FullName + "." + member.Name); + } + +#else + switch (memberType) + { + case MemberTypes.TypeInfo: + case MemberTypes.NestedType: + throw new InvalidOperationException("Non-public type cannot be used with full dll compilation: " + + ((Type)member).FullName); + default: + throw new InvalidOperationException("Non-public member cannot be used with full dll compilation: " + + member.DeclaringType.FullName + "." + member.Name); + } +#endif + + } + } + } + + public void LoadValue(FieldInfo field) + { + MemberInfo member = field; + CheckAccessibility(ref member); + if (member is PropertyInfo) + { + LoadValue((PropertyInfo)member); + } + else + { + OpCode code = field.IsStatic ? OpCodes.Ldsfld : OpCodes.Ldfld; + il.Emit(code, field); + TraceCompile(code + ": " + field + " on " + field.DeclaringType); + } + } + + public void StoreValue(FieldInfo field) + { + MemberInfo member = field; + CheckAccessibility(ref member); + if (member is PropertyInfo) + { + StoreValue((PropertyInfo)member); + } + else + { + OpCode code = field.IsStatic ? OpCodes.Stsfld : OpCodes.Stfld; + il.Emit(code, field); + TraceCompile(code + ": " + field + " on " + field.DeclaringType); + } + } + + public void LoadValue(PropertyInfo property) + { + MemberInfo member = property; + CheckAccessibility(ref member); + EmitCall(Helpers.GetGetMethod(property, true, true)); + } + + public void StoreValue(PropertyInfo property) + { + MemberInfo member = property; + CheckAccessibility(ref member); + EmitCall(Helpers.GetSetMethod(property, true, true)); + } + + //internal void EmitInstance() + //{ + // if (isStatic) throw new InvalidOperationException(); + // Emit(OpCodes.Ldarg_0); + //} + + internal static void LoadValue(ILGenerator il, int value) + { + switch (value) + { + case 0: il.Emit(OpCodes.Ldc_I4_0); break; + case 1: il.Emit(OpCodes.Ldc_I4_1); break; + case 2: il.Emit(OpCodes.Ldc_I4_2); break; + case 3: il.Emit(OpCodes.Ldc_I4_3); break; + case 4: il.Emit(OpCodes.Ldc_I4_4); break; + case 5: il.Emit(OpCodes.Ldc_I4_5); break; + case 6: il.Emit(OpCodes.Ldc_I4_6); break; + case 7: il.Emit(OpCodes.Ldc_I4_7); break; + case 8: il.Emit(OpCodes.Ldc_I4_8); break; + case -1: il.Emit(OpCodes.Ldc_I4_M1); break; + default: il.Emit(OpCodes.Ldc_I4, value); break; + } + } + + private bool UseShortForm(Local local) + { + return local.Value.LocalIndex < 256; + } + + internal void LoadAddress(Local local, Type type, bool evenIfClass = false) + { + if (evenIfClass || Helpers.IsValueType(type)) + { + if (local == null) + { + throw new InvalidOperationException("Cannot load the address of the head of the stack"); + } + + if (local == this.InputValue) + { + il.Emit(OpCodes.Ldarga_S, (isStatic ? (byte)0 : (byte)1)); + TraceCompile(OpCodes.Ldarga_S + ": $" + (isStatic ? 0 : 1)); + } + else + { + OpCode code = UseShortForm(local) ? OpCodes.Ldloca_S : OpCodes.Ldloca; + il.Emit(code, local.Value); + TraceCompile(code + ": $" + local.Value); + } + + } + else + { // reference-type; already *is* the address; just load it + LoadValue(local); + } + } + + internal void Branch(CodeLabel label, bool @short) + { + OpCode code = @short ? OpCodes.Br_S : OpCodes.Br; + il.Emit(code, label.Value); + TraceCompile(code + ": " + label.Index); + } + + internal void BranchIfFalse(CodeLabel label, bool @short) + { + OpCode code = @short ? OpCodes.Brfalse_S : OpCodes.Brfalse; + il.Emit(code, label.Value); + TraceCompile(code + ": " + label.Index); + } + + internal void BranchIfTrue(CodeLabel label, bool @short) + { + OpCode code = @short ? OpCodes.Brtrue_S : OpCodes.Brtrue; + il.Emit(code, label.Value); + TraceCompile(code + ": " + label.Index); + } + + internal void BranchIfEqual(CodeLabel label, bool @short) + { + OpCode code = @short ? OpCodes.Beq_S : OpCodes.Beq; + il.Emit(code, label.Value); + TraceCompile(code + ": " + label.Index); + } + + //internal void TestEqual() + //{ + // Emit(OpCodes.Ceq); + //} + + internal void CopyValue() + { + Emit(OpCodes.Dup); + } + + internal void BranchIfGreater(CodeLabel label, bool @short) + { + OpCode code = @short ? OpCodes.Bgt_S : OpCodes.Bgt; + il.Emit(code, label.Value); + TraceCompile(code + ": " + label.Index); + } + + internal void BranchIfLess(CodeLabel label, bool @short) + { + OpCode code = @short ? OpCodes.Blt_S : OpCodes.Blt; + il.Emit(code, label.Value); + TraceCompile(code + ": " + label.Index); + } + + internal void DiscardValue() + { + Emit(OpCodes.Pop); + } + + public void Subtract() + { + Emit(OpCodes.Sub); + } + + public void Switch(CodeLabel[] jumpTable) + { + const int MAX_JUMPS = 128; + + if (jumpTable.Length <= MAX_JUMPS) + { + // simple case + Label[] labels = new Label[jumpTable.Length]; + for (int i = 0; i < labels.Length; i++) + { + labels[i] = jumpTable[i].Value; + } + TraceCompile(OpCodes.Switch.ToString()); + il.Emit(OpCodes.Switch, labels); + } + else + { + // too many to jump easily (especially on Android) - need to split up (note: uses a local pulled from the stack) + using (Local val = GetLocalWithValue(MapType(typeof(int)), null)) + { + int count = jumpTable.Length, offset = 0; + int blockCount = count / MAX_JUMPS; + if ((count % MAX_JUMPS) != 0) blockCount++; + + Label[] blockLabels = new Label[blockCount]; + for (int i = 0; i < blockCount; i++) + { + blockLabels[i] = il.DefineLabel(); + } + CodeLabel endOfSwitch = DefineLabel(); + + LoadValue(val); + LoadValue(MAX_JUMPS); + Emit(OpCodes.Div); + TraceCompile(OpCodes.Switch.ToString()); + il.Emit(OpCodes.Switch, blockLabels); + Branch(endOfSwitch, false); + + Label[] innerLabels = new Label[MAX_JUMPS]; + for (int blockIndex = 0; blockIndex < blockCount; blockIndex++) + { + il.MarkLabel(blockLabels[blockIndex]); + + int itemsThisBlock = Math.Min(MAX_JUMPS, count); + count -= itemsThisBlock; + if (innerLabels.Length != itemsThisBlock) innerLabels = new Label[itemsThisBlock]; + + int subtract = offset; + for (int j = 0; j < itemsThisBlock; j++) + { + innerLabels[j] = jumpTable[offset++].Value; + } + LoadValue(val); + if (subtract != 0) // switches are always zero-based + { + LoadValue(subtract); + Emit(OpCodes.Sub); + } + TraceCompile(OpCodes.Switch.ToString()); + il.Emit(OpCodes.Switch, innerLabels); + if (count != 0) + { // force default to the very bottom + Branch(endOfSwitch, false); + } + } + Helpers.DebugAssert(count == 0, "Should use exactly all switch items"); + MarkLabel(endOfSwitch); + } + } + } + + internal void EndFinally() + { + il.EndExceptionBlock(); + TraceCompile("EndExceptionBlock"); + } + + internal void BeginFinally() + { + il.BeginFinallyBlock(); + TraceCompile("BeginFinallyBlock"); + } + + internal void EndTry(CodeLabel label, bool @short) + { + OpCode code = @short ? OpCodes.Leave_S : OpCodes.Leave; + il.Emit(code, label.Value); + TraceCompile(code + ": " + label.Index); + } + + internal CodeLabel BeginTry() + { + CodeLabel label = new CodeLabel(il.BeginExceptionBlock(), nextLabel++); + TraceCompile("BeginExceptionBlock: " + label.Index); + return label; + } + + internal void Constrain(Type type) + { + il.Emit(OpCodes.Constrained, type); + TraceCompile(OpCodes.Constrained + ": " + type); + } + + internal void TryCast(Type type) + { + il.Emit(OpCodes.Isinst, type); + TraceCompile(OpCodes.Isinst + ": " + type); + } + + internal void Cast(Type type) + { + il.Emit(OpCodes.Castclass, type); + TraceCompile(OpCodes.Castclass + ": " + type); + } + + public IDisposable Using(Local local) + { + return new UsingBlock(this, local); + } + + private sealed class UsingBlock : IDisposable + { + private Local local; + CompilerContext ctx; + CodeLabel label; + /// + /// Creates a new "using" block (equivalent) around a variable; + /// the variable must exist, and note that (unlike in C#) it is + /// the variables *final* value that gets disposed. If you need + /// *original* disposal, copy your variable first. + /// + /// It is the callers responsibility to ensure that the variable's + /// scope fully-encapsulates the "using"; if not, the variable + /// may be re-used (and thus re-assigned) unexpectedly. + /// + public UsingBlock(CompilerContext ctx, Local local) + { + if (ctx == null) throw new ArgumentNullException("ctx"); + if (local == null) throw new ArgumentNullException("local"); + + Type type = local.Type; + // check if **never** disposable + if ((Helpers.IsValueType(type) || Helpers.IsSealed(type)) && + !ctx.MapType(typeof(IDisposable)).IsAssignableFrom(type)) + { + return; // nothing to do! easiest "using" block ever + // (note that C# wouldn't allow this as a "using" block, + // but we'll be generous and simply not do anything) + } + this.local = local; + this.ctx = ctx; + label = ctx.BeginTry(); + + } + public void Dispose() + { + if (local == null || ctx == null) return; + + ctx.EndTry(label, false); + ctx.BeginFinally(); + Type disposableType = ctx.MapType(typeof(IDisposable)); + MethodInfo dispose = disposableType.GetMethod("Dispose"); + Type type = local.Type; + // remember that we've already (in the .ctor) excluded the case + // where it *cannot* be disposable + if (Helpers.IsValueType(type)) + { + ctx.LoadAddress(local, type); + switch (ctx.MetadataVersion) + { + case ILVersion.Net1: + ctx.LoadValue(local); + ctx.CastToObject(type); + break; + default: + ctx.Constrain(type); + break; + } + ctx.EmitCall(dispose); + } + else + { + Compiler.CodeLabel @null = ctx.DefineLabel(); + if (disposableType.IsAssignableFrom(type)) + { // *known* to be IDisposable; just needs a null-check + ctx.LoadValue(local); + ctx.BranchIfFalse(@null, true); + ctx.LoadAddress(local, type); + } + else + { // *could* be IDisposable; test via "as" + using (Compiler.Local disp = new Compiler.Local(ctx, disposableType)) + { + ctx.LoadValue(local); + ctx.TryCast(disposableType); + ctx.CopyValue(); + ctx.StoreValue(disp); + ctx.BranchIfFalse(@null, true); + ctx.LoadAddress(disp, disposableType); + } + } + ctx.EmitCall(dispose); + ctx.MarkLabel(@null); + } + ctx.EndFinally(); + this.local = null; + this.ctx = null; + label = new CodeLabel(); // default + } + } + + internal void Add() + { + Emit(OpCodes.Add); + } + + internal void LoadLength(Local arr, bool zeroIfNull) + { + Helpers.DebugAssert(arr.Type.IsArray && arr.Type.GetArrayRank() == 1); + + if (zeroIfNull) + { + Compiler.CodeLabel notNull = DefineLabel(), done = DefineLabel(); + LoadValue(arr); + CopyValue(); // optimised for non-null case + BranchIfTrue(notNull, true); + DiscardValue(); + LoadValue(0); + Branch(done, true); + MarkLabel(notNull); + Emit(OpCodes.Ldlen); + Emit(OpCodes.Conv_I4); + MarkLabel(done); + } + else + { + LoadValue(arr); + Emit(OpCodes.Ldlen); + Emit(OpCodes.Conv_I4); + } + } + + internal void CreateArray(Type elementType, Local length) + { + LoadValue(length); + il.Emit(OpCodes.Newarr, elementType); + TraceCompile(OpCodes.Newarr + ": " + elementType); + } + + internal void LoadArrayValue(Local arr, Local i) + { + Type type = arr.Type; + Helpers.DebugAssert(type.IsArray && arr.Type.GetArrayRank() == 1); + type = type.GetElementType(); + Helpers.DebugAssert(type != null, "Not an array: " + arr.Type.FullName); + LoadValue(arr); + LoadValue(i); + switch (Helpers.GetTypeCode(type)) + { + case ProtoTypeCode.SByte: Emit(OpCodes.Ldelem_I1); break; + case ProtoTypeCode.Int16: Emit(OpCodes.Ldelem_I2); break; + case ProtoTypeCode.Int32: Emit(OpCodes.Ldelem_I4); break; + case ProtoTypeCode.Int64: Emit(OpCodes.Ldelem_I8); break; + + case ProtoTypeCode.Byte: Emit(OpCodes.Ldelem_U1); break; + case ProtoTypeCode.UInt16: Emit(OpCodes.Ldelem_U2); break; + case ProtoTypeCode.UInt32: Emit(OpCodes.Ldelem_U4); break; + case ProtoTypeCode.UInt64: Emit(OpCodes.Ldelem_I8); break; // odd, but this is what C# does... + + case ProtoTypeCode.Single: Emit(OpCodes.Ldelem_R4); break; + case ProtoTypeCode.Double: Emit(OpCodes.Ldelem_R8); break; + default: + if (Helpers.IsValueType(type)) + { + il.Emit(OpCodes.Ldelema, type); + il.Emit(OpCodes.Ldobj, type); + TraceCompile(OpCodes.Ldelema + ": " + type); + TraceCompile(OpCodes.Ldobj + ": " + type); + } + else + { + Emit(OpCodes.Ldelem_Ref); + } + + break; + } + } + + internal void LoadValue(Type type) + { + il.Emit(OpCodes.Ldtoken, type); + TraceCompile(OpCodes.Ldtoken + ": " + type); + EmitCall(MapType(typeof(System.Type)).GetMethod("GetTypeFromHandle")); + } + + internal void ConvertToInt32(ProtoTypeCode typeCode, bool uint32Overflow) + { + switch (typeCode) + { + case ProtoTypeCode.Byte: + case ProtoTypeCode.SByte: + case ProtoTypeCode.Int16: + case ProtoTypeCode.UInt16: + Emit(OpCodes.Conv_I4); + break; + case ProtoTypeCode.Int32: + break; + case ProtoTypeCode.Int64: + Emit(OpCodes.Conv_Ovf_I4); + break; + case ProtoTypeCode.UInt32: + Emit(uint32Overflow ? OpCodes.Conv_Ovf_I4_Un : OpCodes.Conv_Ovf_I4); + break; + case ProtoTypeCode.UInt64: + Emit(OpCodes.Conv_Ovf_I4_Un); + break; + default: + throw new InvalidOperationException("ConvertToInt32 not implemented for: " + typeCode.ToString()); + } + } + + internal void ConvertFromInt32(ProtoTypeCode typeCode, bool uint32Overflow) + { + switch (typeCode) + { + case ProtoTypeCode.SByte: Emit(OpCodes.Conv_Ovf_I1); break; + case ProtoTypeCode.Byte: Emit(OpCodes.Conv_Ovf_U1); break; + case ProtoTypeCode.Int16: Emit(OpCodes.Conv_Ovf_I2); break; + case ProtoTypeCode.UInt16: Emit(OpCodes.Conv_Ovf_U2); break; + case ProtoTypeCode.Int32: break; + case ProtoTypeCode.UInt32: Emit(uint32Overflow ? OpCodes.Conv_Ovf_U4 : OpCodes.Conv_U4); break; + case ProtoTypeCode.Int64: Emit(OpCodes.Conv_I8); break; + case ProtoTypeCode.UInt64: Emit(OpCodes.Conv_U8); break; + default: throw new InvalidOperationException(); + } + } + + internal void LoadValue(decimal value) + { + if (value == 0M) + { + LoadValue(typeof(decimal).GetField("Zero")); + } + else + { + int[] bits = decimal.GetBits(value); + LoadValue(bits[0]); // lo + LoadValue(bits[1]); // mid + LoadValue(bits[2]); // hi + LoadValue((int)(((uint)bits[3]) >> 31)); // isNegative (bool, but int for CLI purposes) + LoadValue((bits[3] >> 16) & 0xFF); // scale (byte, but int for CLI purposes) + + EmitCtor(MapType(typeof(decimal)), new Type[] { MapType(typeof(int)), MapType(typeof(int)), MapType(typeof(int)), MapType(typeof(bool)), MapType(typeof(byte)) }); + } + } + + internal void LoadValue(Guid value) + { + if (value == Guid.Empty) + { + LoadValue(typeof(Guid).GetField("Empty")); + } + else + { // note we're adding lots of shorts/bytes here - but at the IL level they are I4, not I1/I2 (which barely exist) + byte[] bytes = value.ToByteArray(); + int i = (bytes[0]) | (bytes[1] << 8) | (bytes[2] << 16) | (bytes[3] << 24); + LoadValue(i); + short s = (short)((bytes[4]) | (bytes[5] << 8)); + LoadValue(s); + s = (short)((bytes[6]) | (bytes[7] << 8)); + LoadValue(s); + for (i = 8; i <= 15; i++) + { + LoadValue(bytes[i]); + } + EmitCtor(MapType(typeof(Guid)), new Type[] { MapType(typeof(int)), MapType(typeof(short)), MapType(typeof(short)), + MapType(typeof(byte)), MapType(typeof(byte)), MapType(typeof(byte)), MapType(typeof(byte)), MapType(typeof(byte)), MapType(typeof(byte)), MapType(typeof(byte)), MapType(typeof(byte)) }); + } + } + + //internal void LoadValue(bool value) + //{ + // Emit(value ? OpCodes.Ldc_I4_1 : OpCodes.Ldc_I4_0); + //} + + internal void LoadSerializationContext() + { + LoadReaderWriter(); + LoadValue((isWriter ? typeof(ProtoWriter) : typeof(ProtoReader)).GetProperty("Context")); + } + + private readonly TypeModel model; + + internal Type MapType(Type type) + { + return model.MapType(type); + } + + private readonly ILVersion metadataVersion; + public ILVersion MetadataVersion { get { return metadataVersion; } } + public enum ILVersion + { + Net1, Net2 + } + + internal bool AllowInternal(PropertyInfo property) + { + return NonPublic ? true : InternalsVisible(Helpers.GetAssembly(property.DeclaringType)); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/CompilerDelegates.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/CompilerDelegates.cs new file mode 100644 index 0000000..e7f0508 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/CompilerDelegates.cs @@ -0,0 +1,7 @@ +#if FEAT_COMPILER +namespace ProtoBuf.Compiler +{ + internal delegate void ProtoSerializer(object value, ProtoWriter dest); + internal delegate object ProtoDeserializer(object value, ProtoReader source); +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/Local.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/Local.cs new file mode 100644 index 0000000..fd3dfa9 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Compiler/Local.cs @@ -0,0 +1,58 @@ +#if FEAT_COMPILER +using System; +using System.Reflection.Emit; + +namespace ProtoBuf.Compiler +{ + internal sealed class Local : IDisposable + { + // public static readonly Local InputValue = new Local(null, null); + private LocalBuilder value; + private readonly Type type; + private CompilerContext ctx; + + private Local(LocalBuilder value, Type type) + { + this.value = value; + this.type = type; + } + + internal Local(CompilerContext ctx, Type type) + { + this.ctx = ctx; + if (ctx != null) { value = ctx.GetFromPool(type); } + this.type = type; + } + + internal LocalBuilder Value => value ?? throw new ObjectDisposedException(GetType().Name); + + public Type Type => type; + + public Local AsCopy() + { + if (ctx == null) return this; // can re-use if context-free + return new Local(value, this.type); + } + + public void Dispose() + { + if (ctx != null) + { + // only *actually* dispose if this is context-bound; note that non-bound + // objects are cheekily re-used, and *must* be left intact agter a "using" etc + ctx.ReleaseToPool(value); + value = null; + ctx = null; + } + } + + internal bool IsSame(Local other) + { + if((object)this == (object)other) return true; + + object ourVal = value; // use prop to ensure obj-disposed etc + return other != null && ourVal == (object)(other.value); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/DataFormat.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/DataFormat.cs new file mode 100644 index 0000000..4d97b4f --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/DataFormat.cs @@ -0,0 +1,49 @@ + +namespace ProtoBuf +{ + /// + /// Sub-format to use when serializing/deserializing data + /// + public enum DataFormat + { + /// + /// Uses the default encoding for the data-type. + /// + Default, + + /// + /// When applied to signed integer-based data (including Decimal), this + /// indicates that zigzag variant encoding will be used. This means that values + /// with small magnitude (regardless of sign) take a small amount + /// of space to encode. + /// + ZigZag, + + /// + /// When applied to signed integer-based data (including Decimal), this + /// indicates that two's-complement variant encoding will be used. + /// This means that any -ve number will take 10 bytes (even for 32-bit), + /// so should only be used for compatibility. + /// + TwosComplement, + + /// + /// When applied to signed integer-based data (including Decimal), this + /// indicates that a fixed amount of space will be used. + /// + FixedSize, + + /// + /// When applied to a sub-message, indicates that the value should be treated + /// as group-delimited. + /// + Group, + + /// + /// When applied to members of types such as DateTime or TimeSpan, specifies + /// that the "well known" standardized representation should be use; DateTime uses Timestamp, + /// + /// + WellKnown + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/DiscriminatedUnion.Serializable.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/DiscriminatedUnion.Serializable.cs new file mode 100644 index 0000000..0fd671f --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/DiscriminatedUnion.Serializable.cs @@ -0,0 +1,176 @@ +#if PLAT_BINARYFORMATTER +using System; +using System.Runtime.InteropServices; +using System.Runtime.Serialization; + +namespace ProtoBuf +{ + [Serializable] + public readonly partial struct DiscriminatedUnionObject : ISerializable + { + void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) + { + if (Discriminator != default) info.AddValue("d", Discriminator); + if (Object is object) info.AddValue("o", Object); + } + private DiscriminatedUnionObject(SerializationInfo info, StreamingContext context) + { + this = default; + foreach (var field in info) + { + switch (field.Name) + { + case "d": Discriminator = (int)field.Value; break; + case "o": Object = field.Value; break; + } + } + } + } + + [Serializable] + public readonly partial struct DiscriminatedUnion128Object : ISerializable + { + [FieldOffset(8)] private readonly long _lo; + [FieldOffset(16)] private readonly long _hi; + void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) + { + if (_discriminator != default) info.AddValue("d", _discriminator); + if (_lo != default) info.AddValue("l", _lo); + if (_hi != default) info.AddValue("h", _hi); + if (Object != null) info.AddValue("o", Object); + } + private DiscriminatedUnion128Object(SerializationInfo info, StreamingContext context) + { + this = default; + foreach (var field in info) + { + switch (field.Name) + { + case "d": _discriminator = (int)field.Value; break; + case "l": _lo = (long)field.Value; break; + case "h": _hi = (long)field.Value; break; + case "o": Object = field.Value; break; + } + } + } + } + + [Serializable] + public readonly partial struct DiscriminatedUnion128 : ISerializable + { + [FieldOffset(8)] private readonly long _lo; + [FieldOffset(16)] private readonly long _hi; + void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) + { + if (_discriminator != default) info.AddValue("d", _discriminator); + if (_lo != default) info.AddValue("l", _lo); + if (_hi != default) info.AddValue("h", _hi); + } + private DiscriminatedUnion128(SerializationInfo info, StreamingContext context) + { + this = default; + foreach (var field in info) + { + switch (field.Name) + { + case "d": _discriminator = (int)field.Value; break; + case "l": _lo = (long)field.Value; break; + case "h": _hi = (long)field.Value; break; + } + } + } + } + + [Serializable] + public readonly partial struct DiscriminatedUnion64 : ISerializable + { + void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) + { + if (_discriminator != default) info.AddValue("d", _discriminator); + if (Int64 != default) info.AddValue("i", Int64); + } + private DiscriminatedUnion64(SerializationInfo info, StreamingContext context) + { + this = default; + foreach (var field in info) + { + switch (field.Name) + { + case "d": _discriminator = (int)field.Value; break; + case "i": Int64 = (long)field.Value; break; + } + } + } + } + + [Serializable] + public readonly partial struct DiscriminatedUnion64Object : ISerializable + { + void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) + { + if (_discriminator != default) info.AddValue("d", _discriminator); + if (Int64 != default) info.AddValue("i", Int64); + if (Object is object) info.AddValue("o", Object); + } + private DiscriminatedUnion64Object(SerializationInfo info, StreamingContext context) + { + this = default; + foreach (var field in info) + { + switch (field.Name) + { + case "d": _discriminator = (int)field.Value; break; + case "i": Int64 = (long)field.Value; break; + case "o": Object = field.Value; break; + } + } + } + } + + [Serializable] + public readonly partial struct DiscriminatedUnion32 : ISerializable + { + void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) + { + if (_discriminator != default) info.AddValue("d", _discriminator); + if (Int32 != default) info.AddValue("i", Int32); + } + private DiscriminatedUnion32(SerializationInfo info, StreamingContext context) + { + this = default; + foreach (var field in info) + { + switch (field.Name) + { + case "d": _discriminator = (int)field.Value; break; + case "i": Int32 = (int)field.Value; break; + } + } + } + } + + [Serializable] + public readonly partial struct DiscriminatedUnion32Object : ISerializable + { + void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) + { + if (_discriminator != default) info.AddValue("d", _discriminator); + if (Int32 != default) info.AddValue("i", Int32); + if (Object is object) info.AddValue("o", Object); + } + private DiscriminatedUnion32Object(SerializationInfo info, StreamingContext context) + { + this = default; + foreach (var field in info) + { + switch (field.Name) + { + case "d": _discriminator = (int)field.Value; break; + case "i": Int32 = (int)field.Value; break; + case "o": Object = field.Value; break; + } + } + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/DiscriminatedUnion.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/DiscriminatedUnion.cs new file mode 100644 index 0000000..7cc8cf8 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/DiscriminatedUnion.cs @@ -0,0 +1,416 @@ +using System; +using System.Runtime.InteropServices; + +namespace ProtoBuf +{ + /// Represent multiple types as a union; this is used as part of OneOf - + /// note that it is the caller's responsbility to only read/write the value as the same type + public readonly partial struct DiscriminatedUnionObject + { + + /// The value typed as Object + public readonly object Object; + + /// Indicates whether the specified discriminator is assigned + public bool Is(int discriminator) => Discriminator == discriminator; + + /// Create a new discriminated union value + public DiscriminatedUnionObject(int discriminator, object value) + { + Discriminator = discriminator; + Object = value; + } + + /// Reset a value if the specified discriminator is assigned + public static void Reset(ref DiscriminatedUnionObject value, int discriminator) + { + if (value.Discriminator == discriminator) value = default; + } + + /// The discriminator value + public int Discriminator { get; } + } + + /// Represent multiple types as a union; this is used as part of OneOf - + /// note that it is the caller's responsbility to only read/write the value as the same type + [StructLayout(LayoutKind.Explicit)] + public readonly partial struct DiscriminatedUnion64 + { +#if !FEAT_SAFE + unsafe static DiscriminatedUnion64() + { + if (sizeof(DateTime) > 8) throw new InvalidOperationException(nameof(DateTime) + " was unexpectedly too big for " + nameof(DiscriminatedUnion64)); + if (sizeof(TimeSpan) > 8) throw new InvalidOperationException(nameof(TimeSpan) + " was unexpectedly too big for " + nameof(DiscriminatedUnion64)); + } +#endif + [FieldOffset(0)] private readonly int _discriminator; // note that we can't pack further because Object needs x8 alignment/padding on x64 + + /// The value typed as Int64 + [FieldOffset(8)] public readonly long Int64; + /// The value typed as UInt64 + [FieldOffset(8)] public readonly ulong UInt64; + /// The value typed as Int32 + [FieldOffset(8)] public readonly int Int32; + /// The value typed as UInt32 + [FieldOffset(8)] public readonly uint UInt32; + /// The value typed as Boolean + [FieldOffset(8)] public readonly bool Boolean; + /// The value typed as Single + [FieldOffset(8)] public readonly float Single; + /// The value typed as Double + [FieldOffset(8)] public readonly double Double; + /// The value typed as DateTime + [FieldOffset(8)] public readonly DateTime DateTime; + /// The value typed as TimeSpan + [FieldOffset(8)] public readonly TimeSpan TimeSpan; + + private DiscriminatedUnion64(int discriminator) : this() + { + _discriminator = discriminator; + } + + /// Indicates whether the specified discriminator is assigned + public bool Is(int discriminator) => _discriminator == discriminator; + + /// Create a new discriminated union value + public DiscriminatedUnion64(int discriminator, long value) : this(discriminator) { Int64 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64(int discriminator, int value) : this(discriminator) { Int32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64(int discriminator, ulong value) : this(discriminator) { UInt64 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64(int discriminator, uint value) : this(discriminator) { UInt32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64(int discriminator, float value) : this(discriminator) { Single = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64(int discriminator, double value) : this(discriminator) { Double = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64(int discriminator, bool value) : this(discriminator) { Boolean = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64(int discriminator, DateTime? value) : this(value.HasValue ? discriminator: 0) { DateTime = value.GetValueOrDefault(); } + /// Create a new discriminated union value + public DiscriminatedUnion64(int discriminator, TimeSpan? value) : this(value.HasValue ? discriminator : 0) { TimeSpan = value.GetValueOrDefault(); } + + /// Reset a value if the specified discriminator is assigned + public static void Reset(ref DiscriminatedUnion64 value, int discriminator) + { + if (value.Discriminator == discriminator) value = default; + } + /// The discriminator value + public int Discriminator => _discriminator; + } + + /// Represent multiple types as a union; this is used as part of OneOf - + /// note that it is the caller's responsbility to only read/write the value as the same type + [StructLayout(LayoutKind.Explicit)] + public readonly partial struct DiscriminatedUnion128Object + { +#if !FEAT_SAFE + unsafe static DiscriminatedUnion128Object() + { + if (sizeof(DateTime) > 16) throw new InvalidOperationException(nameof(DateTime) + " was unexpectedly too big for " + nameof(DiscriminatedUnion128Object)); + if (sizeof(TimeSpan) > 16) throw new InvalidOperationException(nameof(TimeSpan) + " was unexpectedly too big for " + nameof(DiscriminatedUnion128Object)); + if (sizeof(Guid) > 16) throw new InvalidOperationException(nameof(Guid) + " was unexpectedly too big for " + nameof(DiscriminatedUnion128Object)); + } +#endif + + [FieldOffset(0)] private readonly int _discriminator; // note that we can't pack further because Object needs x8 alignment/padding on x64 + + /// The value typed as Int64 + [FieldOffset(8)] public readonly long Int64; + /// The value typed as UInt64 + [FieldOffset(8)] public readonly ulong UInt64; + /// The value typed as Int32 + [FieldOffset(8)] public readonly int Int32; + /// The value typed as UInt32 + [FieldOffset(8)] public readonly uint UInt32; + /// The value typed as Boolean + [FieldOffset(8)] public readonly bool Boolean; + /// The value typed as Single + [FieldOffset(8)] public readonly float Single; + /// The value typed as Double + [FieldOffset(8)] public readonly double Double; + /// The value typed as DateTime + [FieldOffset(8)] public readonly DateTime DateTime; + /// The value typed as TimeSpan + [FieldOffset(8)] public readonly TimeSpan TimeSpan; + /// The value typed as Guid + [FieldOffset(8)] public readonly Guid Guid; + /// The value typed as Object + [FieldOffset(24)] public readonly object Object; + + private DiscriminatedUnion128Object(int discriminator) : this() + { + _discriminator = discriminator; + } + + /// Indicates whether the specified discriminator is assigned + public bool Is(int discriminator) => _discriminator == discriminator; + + /// Create a new discriminated union value + public DiscriminatedUnion128Object(int discriminator, long value) : this(discriminator) { Int64 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128Object(int discriminator, int value) : this(discriminator) { Int32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128Object(int discriminator, ulong value) : this(discriminator) { UInt64 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128Object(int discriminator, uint value) : this(discriminator) { UInt32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128Object(int discriminator, float value) : this(discriminator) { Single = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128Object(int discriminator, double value) : this(discriminator) { Double = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128Object(int discriminator, bool value) : this(discriminator) { Boolean = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128Object(int discriminator, object value) : this(value != null ? discriminator : 0) { Object = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128Object(int discriminator, DateTime? value) : this(value.HasValue ? discriminator: 0) { DateTime = value.GetValueOrDefault(); } + /// Create a new discriminated union value + public DiscriminatedUnion128Object(int discriminator, TimeSpan? value) : this(value.HasValue ? discriminator : 0) { TimeSpan = value.GetValueOrDefault(); } + /// Create a new discriminated union value + public DiscriminatedUnion128Object(int discriminator, Guid? value) : this(value.HasValue ? discriminator : 0) { Guid = value.GetValueOrDefault(); } + + /// Reset a value if the specified discriminator is assigned + public static void Reset(ref DiscriminatedUnion128Object value, int discriminator) + { + if (value.Discriminator == discriminator) value = default; + } + /// The discriminator value + public int Discriminator => _discriminator; + } + + /// Represent multiple types as a union; this is used as part of OneOf - + /// note that it is the caller's responsbility to only read/write the value as the same type + [StructLayout(LayoutKind.Explicit)] + public readonly partial struct DiscriminatedUnion128 + { +#if !FEAT_SAFE + unsafe static DiscriminatedUnion128() + { + if (sizeof(DateTime) > 16) throw new InvalidOperationException(nameof(DateTime) + " was unexpectedly too big for " + nameof(DiscriminatedUnion128)); + if (sizeof(TimeSpan) > 16) throw new InvalidOperationException(nameof(TimeSpan) + " was unexpectedly too big for " + nameof(DiscriminatedUnion128)); + if (sizeof(Guid) > 16) throw new InvalidOperationException(nameof(Guid) + " was unexpectedly too big for " + nameof(DiscriminatedUnion128)); + } +#endif + [FieldOffset(0)] private readonly int _discriminator; // note that we can't pack further because Object needs x8 alignment/padding on x64 + + /// The value typed as Int64 + [FieldOffset(8)] public readonly long Int64; + /// The value typed as UInt64 + [FieldOffset(8)] public readonly ulong UInt64; + /// The value typed as Int32 + [FieldOffset(8)] public readonly int Int32; + /// The value typed as UInt32 + [FieldOffset(8)] public readonly uint UInt32; + /// The value typed as Boolean + [FieldOffset(8)] public readonly bool Boolean; + /// The value typed as Single + [FieldOffset(8)] public readonly float Single; + /// The value typed as Double + [FieldOffset(8)] public readonly double Double; + /// The value typed as DateTime + [FieldOffset(8)] public readonly DateTime DateTime; + /// The value typed as TimeSpan + [FieldOffset(8)] public readonly TimeSpan TimeSpan; + /// The value typed as Guid + [FieldOffset(8)] public readonly Guid Guid; + + private DiscriminatedUnion128(int discriminator) : this() + { + _discriminator = discriminator; + } + + /// Indicates whether the specified discriminator is assigned + public bool Is(int discriminator) => _discriminator == discriminator; + + /// Create a new discriminated union value + public DiscriminatedUnion128(int discriminator, long value) : this(discriminator) { Int64 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128(int discriminator, int value) : this(discriminator) { Int32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128(int discriminator, ulong value) : this(discriminator) { UInt64 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128(int discriminator, uint value) : this(discriminator) { UInt32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128(int discriminator, float value) : this(discriminator) { Single = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128(int discriminator, double value) : this(discriminator) { Double = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128(int discriminator, bool value) : this(discriminator) { Boolean = value; } + /// Create a new discriminated union value + public DiscriminatedUnion128(int discriminator, DateTime? value) : this(value.HasValue ? discriminator: 0) { DateTime = value.GetValueOrDefault(); } + /// Create a new discriminated union value + public DiscriminatedUnion128(int discriminator, TimeSpan? value) : this(value.HasValue ? discriminator : 0) { TimeSpan = value.GetValueOrDefault(); } + /// Create a new discriminated union value + public DiscriminatedUnion128(int discriminator, Guid? value) : this(value.HasValue ? discriminator : 0) { Guid = value.GetValueOrDefault(); } + + /// Reset a value if the specified discriminator is assigned + public static void Reset(ref DiscriminatedUnion128 value, int discriminator) + { + if (value.Discriminator == discriminator) value = default; + } + /// The discriminator value + public int Discriminator => _discriminator; + } + + /// Represent multiple types as a union; this is used as part of OneOf - + /// note that it is the caller's responsbility to only read/write the value as the same type + [StructLayout(LayoutKind.Explicit)] + public readonly partial struct DiscriminatedUnion64Object + { +#if !FEAT_SAFE + unsafe static DiscriminatedUnion64Object() + { + if (sizeof(DateTime) > 8) throw new InvalidOperationException(nameof(DateTime) + " was unexpectedly too big for " + nameof(DiscriminatedUnion64Object)); + if (sizeof(TimeSpan) > 8) throw new InvalidOperationException(nameof(TimeSpan) + " was unexpectedly too big for " + nameof(DiscriminatedUnion64Object)); + } +#endif + [FieldOffset(0)] private readonly int _discriminator; // note that we can't pack further because Object needs x8 alignment/padding on x64 + + /// The value typed as Int64 + [FieldOffset(8)] public readonly long Int64; + /// The value typed as UInt64 + [FieldOffset(8)] public readonly ulong UInt64; + /// The value typed as Int32 + [FieldOffset(8)] public readonly int Int32; + /// The value typed as UInt32 + [FieldOffset(8)] public readonly uint UInt32; + /// The value typed as Boolean + [FieldOffset(8)] public readonly bool Boolean; + /// The value typed as Single + [FieldOffset(8)] public readonly float Single; + /// The value typed as Double + [FieldOffset(8)] public readonly double Double; + /// The value typed as DateTime + [FieldOffset(8)] public readonly DateTime DateTime; + /// The value typed as TimeSpan + [FieldOffset(8)] public readonly TimeSpan TimeSpan; + /// The value typed as Object + [FieldOffset(16)] public readonly object Object; + + private DiscriminatedUnion64Object(int discriminator) : this() + { + _discriminator = discriminator; + } + + /// Indicates whether the specified discriminator is assigned + public bool Is(int discriminator) => _discriminator == discriminator; + + /// Create a new discriminated union value + public DiscriminatedUnion64Object(int discriminator, long value) : this(discriminator) { Int64 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64Object(int discriminator, int value) : this(discriminator) { Int32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64Object(int discriminator, ulong value) : this(discriminator) { UInt64 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64Object(int discriminator, uint value) : this(discriminator) { UInt32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64Object(int discriminator, float value) : this(discriminator) { Single = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64Object(int discriminator, double value) : this(discriminator) { Double = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64Object(int discriminator, bool value) : this(discriminator) { Boolean = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64Object(int discriminator, object value) : this(value != null ? discriminator : 0) { Object = value; } + /// Create a new discriminated union value + public DiscriminatedUnion64Object(int discriminator, DateTime? value) : this(value.HasValue ? discriminator: 0) { DateTime = value.GetValueOrDefault(); } + /// Create a new discriminated union value + public DiscriminatedUnion64Object(int discriminator, TimeSpan? value) : this(value.HasValue ? discriminator : 0) { TimeSpan = value.GetValueOrDefault(); } + + /// Reset a value if the specified discriminator is assigned + public static void Reset(ref DiscriminatedUnion64Object value, int discriminator) + { + if (value.Discriminator == discriminator) value = default; + } + /// The discriminator value + public int Discriminator => _discriminator; + } + + /// Represent multiple types as a union; this is used as part of OneOf - + /// note that it is the caller's responsbility to only read/write the value as the same type + [StructLayout(LayoutKind.Explicit)] + public readonly partial struct DiscriminatedUnion32 + { + [FieldOffset(0)] private readonly int _discriminator; + + /// The value typed as Int32 + [FieldOffset(4)] public readonly int Int32; + /// The value typed as UInt32 + [FieldOffset(4)] public readonly uint UInt32; + /// The value typed as Boolean + [FieldOffset(4)] public readonly bool Boolean; + /// The value typed as Single + [FieldOffset(4)] public readonly float Single; + + private DiscriminatedUnion32(int discriminator) : this() + { + _discriminator = discriminator; + } + + /// Indicates whether the specified discriminator is assigned + public bool Is(int discriminator) => _discriminator == discriminator; + + /// Create a new discriminated union value + public DiscriminatedUnion32(int discriminator, int value) : this(discriminator) { Int32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion32(int discriminator, uint value) : this(discriminator) { UInt32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion32(int discriminator, float value) : this(discriminator) { Single = value; } + /// Create a new discriminated union value + public DiscriminatedUnion32(int discriminator, bool value) : this(discriminator) { Boolean = value; } + + /// Reset a value if the specified discriminator is assigned + public static void Reset(ref DiscriminatedUnion32 value, int discriminator) + { + if (value.Discriminator == discriminator) value = default; + } + /// The discriminator value + public int Discriminator => _discriminator; + } + + /// Represent multiple types as a union; this is used as part of OneOf - + /// note that it is the caller's responsbility to only read/write the value as the same type + [StructLayout(LayoutKind.Explicit)] + public readonly partial struct DiscriminatedUnion32Object + { + [FieldOffset(0)] private readonly int _discriminator; + + /// The value typed as Int32 + [FieldOffset(4)] public readonly int Int32; + /// The value typed as UInt32 + [FieldOffset(4)] public readonly uint UInt32; + /// The value typed as Boolean + [FieldOffset(4)] public readonly bool Boolean; + /// The value typed as Single + [FieldOffset(4)] public readonly float Single; + /// The value typed as Object + [FieldOffset(8)] public readonly object Object; + + private DiscriminatedUnion32Object(int discriminator) : this() + { + _discriminator = discriminator; + } + + /// Indicates whether the specified discriminator is assigned + public bool Is(int discriminator) => _discriminator == discriminator; + + /// Create a new discriminated union value + public DiscriminatedUnion32Object(int discriminator, int value) : this(discriminator) { Int32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion32Object(int discriminator, uint value) : this(discriminator) { UInt32 = value; } + /// Create a new discriminated union value + public DiscriminatedUnion32Object(int discriminator, float value) : this(discriminator) { Single = value; } + /// Create a new discriminated union value + public DiscriminatedUnion32Object(int discriminator, bool value) : this(discriminator) { Boolean = value; } + /// Create a new discriminated union value + public DiscriminatedUnion32Object(int discriminator, object value) : this(value != null ? discriminator : 0) { Object = value; } + + /// Reset a value if the specified discriminator is assigned + public static void Reset(ref DiscriminatedUnion32Object value, int discriminator) + { + if (value.Discriminator == discriminator) value = default; + } + /// The discriminator value + public int Discriminator => _discriminator; + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Extensible.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Extensible.cs new file mode 100644 index 0000000..6bd528b --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Extensible.cs @@ -0,0 +1,284 @@ +using System; +using System.Collections.Generic; +using ProtoBuf.Meta; +using System.Collections; + +namespace ProtoBuf +{ + /// + /// Simple base class for supporting unexpected fields allowing + /// for loss-less round-tips/merge, even if the data is not understod. + /// The additional fields are (by default) stored in-memory in a buffer. + /// + /// As an example of an alternative implementation, you might + /// choose to use the file system (temporary files) as the back-end, tracking + /// only the paths [such an object would ideally be IDisposable and use + /// a finalizer to ensure that the files are removed]. + /// + public abstract class Extensible : IExtensible + { + // note: not marked ProtoContract - no local state, and can't + // predict sub-classes + + private IExtension extensionObject; + + IExtension IExtensible.GetExtensionObject(bool createIfMissing) + { + return GetExtensionObject(createIfMissing); + } + + /// + /// Retrieves the extension object for the current + /// instance, optionally creating it if it does not already exist. + /// + /// Should a new extension object be + /// created if it does not already exist? + /// The extension object if it exists (or was created), or null + /// if the extension object does not exist or is not available. + /// The createIfMissing argument is false during serialization, + /// and true during deserialization upon encountering unexpected fields. + protected virtual IExtension GetExtensionObject(bool createIfMissing) + { + return GetExtensionObject(ref extensionObject, createIfMissing); + } + + /// + /// Provides a simple, default implementation for extension support, + /// optionally creating it if it does not already exist. Designed to be called by + /// classes implementing . + /// + /// Should a new extension object be + /// created if it does not already exist? + /// The extension field to check (and possibly update). + /// The extension object if it exists (or was created), or null + /// if the extension object does not exist or is not available. + /// The createIfMissing argument is false during serialization, + /// and true during deserialization upon encountering unexpected fields. + public static IExtension GetExtensionObject(ref IExtension extensionObject, bool createIfMissing) + { + if (createIfMissing && extensionObject == null) + { + extensionObject = new BufferExtension(); + } + return extensionObject; + } + +#if !NO_RUNTIME + /// + /// Appends the value as an additional (unexpected) data-field for the instance. + /// Note that for non-repeated sub-objects, this equates to a merge operation; + /// for repeated sub-objects this adds a new instance to the set; for simple + /// values the new value supercedes the old value. + /// + /// Note that appending a value does not remove the old value from + /// the stream; avoid repeatedly appending values for the same field. + /// The type of the value to append. + /// The extensible object to append the value to. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// The value to append. + public static void AppendValue(IExtensible instance, int tag, TValue value) + { + AppendValue(instance, tag, DataFormat.Default, value); + } + + /// + /// Appends the value as an additional (unexpected) data-field for the instance. + /// Note that for non-repeated sub-objects, this equates to a merge operation; + /// for repeated sub-objects this adds a new instance to the set; for simple + /// values the new value supercedes the old value. + /// + /// Note that appending a value does not remove the old value from + /// the stream; avoid repeatedly appending values for the same field. + /// The data-type of the field. + /// The data-format to use when encoding the value. + /// The extensible object to append the value to. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// The value to append. + public static void AppendValue(IExtensible instance, int tag, DataFormat format, TValue value) + { + ExtensibleUtil.AppendExtendValue(RuntimeTypeModel.Default, instance, tag, format, value); + } + /// + /// Queries an extensible object for an additional (unexpected) data-field for the instance. + /// The value returned is the composed value after merging any duplicated content; if the + /// value is "repeated" (a list), then use GetValues instead. + /// + /// The data-type of the field. + /// The extensible object to obtain the value from. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// The effective value of the field, or the default value if not found. + public static TValue GetValue(IExtensible instance, int tag) + { + return GetValue(instance, tag, DataFormat.Default); + } + + /// + /// Queries an extensible object for an additional (unexpected) data-field for the instance. + /// The value returned is the composed value after merging any duplicated content; if the + /// value is "repeated" (a list), then use GetValues instead. + /// + /// The data-type of the field. + /// The extensible object to obtain the value from. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// The data-format to use when decoding the value. + /// The effective value of the field, or the default value if not found. + public static TValue GetValue(IExtensible instance, int tag, DataFormat format) + { + TryGetValue(instance, tag, format, out TValue value); + return value; + } + + /// + /// Queries an extensible object for an additional (unexpected) data-field for the instance. + /// The value returned (in "value") is the composed value after merging any duplicated content; + /// if the value is "repeated" (a list), then use GetValues instead. + /// + /// The data-type of the field. + /// The effective value of the field, or the default value if not found. + /// The extensible object to obtain the value from. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// True if data for the field was present, false otherwise. + public static bool TryGetValue(IExtensible instance, int tag, out TValue value) + { + return TryGetValue(instance, tag, DataFormat.Default, out value); + } + + /// + /// Queries an extensible object for an additional (unexpected) data-field for the instance. + /// The value returned (in "value") is the composed value after merging any duplicated content; + /// if the value is "repeated" (a list), then use GetValues instead. + /// + /// The data-type of the field. + /// The effective value of the field, or the default value if not found. + /// The extensible object to obtain the value from. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// The data-format to use when decoding the value. + /// True if data for the field was present, false otherwise. + public static bool TryGetValue(IExtensible instance, int tag, DataFormat format, out TValue value) + { + return TryGetValue(instance, tag, format, false, out value); + } + + /// + /// Queries an extensible object for an additional (unexpected) data-field for the instance. + /// The value returned (in "value") is the composed value after merging any duplicated content; + /// if the value is "repeated" (a list), then use GetValues instead. + /// + /// The data-type of the field. + /// The effective value of the field, or the default value if not found. + /// The extensible object to obtain the value from. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// The data-format to use when decoding the value. + /// Allow tags that are present as part of the definition; for example, to query unknown enum values. + /// True if data for the field was present, false otherwise. + public static bool TryGetValue(IExtensible instance, int tag, DataFormat format, bool allowDefinedTag, out TValue value) + { + value = default; + bool set = false; + foreach (TValue val in ExtensibleUtil.GetExtendedValues(instance, tag, format, true, allowDefinedTag)) + { + // expecting at most one yield... + // but don't break; need to read entire stream + value = val; + set = true; + } + + return set; + } + + /// + /// Queries an extensible object for an additional (unexpected) data-field for the instance. + /// Each occurrence of the field is yielded separately, making this usage suitable for "repeated" + /// (list) fields. + /// + /// The extended data is processed lazily as the enumerator is iterated. + /// The data-type of the field. + /// The extensible object to obtain the value from. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// An enumerator that yields each occurrence of the field. + public static IEnumerable GetValues(IExtensible instance, int tag) + { + return ExtensibleUtil.GetExtendedValues(instance, tag, DataFormat.Default, false, false); + } + + /// + /// Queries an extensible object for an additional (unexpected) data-field for the instance. + /// Each occurrence of the field is yielded separately, making this usage suitable for "repeated" + /// (list) fields. + /// + /// The extended data is processed lazily as the enumerator is iterated. + /// The data-type of the field. + /// The extensible object to obtain the value from. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// The data-format to use when decoding the value. + /// An enumerator that yields each occurrence of the field. + public static IEnumerable GetValues(IExtensible instance, int tag, DataFormat format) + { + return ExtensibleUtil.GetExtendedValues(instance, tag, format, false, false); + } +#endif + + /// + /// Queries an extensible object for an additional (unexpected) data-field for the instance. + /// The value returned (in "value") is the composed value after merging any duplicated content; + /// if the value is "repeated" (a list), then use GetValues instead. + /// + /// The data-type of the field. + /// The model to use for configuration. + /// The effective value of the field, or the default value if not found. + /// The extensible object to obtain the value from. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// The data-format to use when decoding the value. + /// Allow tags that are present as part of the definition; for example, to query unknown enum values. + /// True if data for the field was present, false otherwise. + public static bool TryGetValue(TypeModel model, Type type, IExtensible instance, int tag, DataFormat format, bool allowDefinedTag, out object value) + { + value = null; + bool set = false; + foreach (object val in ExtensibleUtil.GetExtendedValues(model, type, instance, tag, format, true, allowDefinedTag)) + { + // expecting at most one yield... + // but don't break; need to read entire stream + value = val; + set = true; + } + + return set; + } + + /// + /// Queries an extensible object for an additional (unexpected) data-field for the instance. + /// Each occurrence of the field is yielded separately, making this usage suitable for "repeated" + /// (list) fields. + /// + /// The extended data is processed lazily as the enumerator is iterated. + /// The model to use for configuration. + /// The data-type of the field. + /// The extensible object to obtain the value from. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// The data-format to use when decoding the value. + /// An enumerator that yields each occurrence of the field. + public static IEnumerable GetValues(TypeModel model, Type type, IExtensible instance, int tag, DataFormat format) + { + return ExtensibleUtil.GetExtendedValues(model, type, instance, tag, format, false, false); + } + + /// + /// Appends the value as an additional (unexpected) data-field for the instance. + /// Note that for non-repeated sub-objects, this equates to a merge operation; + /// for repeated sub-objects this adds a new instance to the set; for simple + /// values the new value supercedes the old value. + /// + /// Note that appending a value does not remove the old value from + /// the stream; avoid repeatedly appending values for the same field. + /// The model to use for configuration. + /// The data-format to use when encoding the value. + /// The extensible object to append the value to. + /// The field identifier; the tag should not be defined as a known data-field for the instance. + /// The value to append. + public static void AppendValue(TypeModel model, IExtensible instance, int tag, DataFormat format, object value) + { + ExtensibleUtil.AppendExtendValue(model, instance, tag, format, value); + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ExtensibleUtil.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ExtensibleUtil.cs new file mode 100644 index 0000000..9cc1613 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ExtensibleUtil.cs @@ -0,0 +1,118 @@ +using System; +using System.Collections; +using System.Collections.Generic; +using System.IO; +using ProtoBuf.Meta; + +namespace ProtoBuf +{ + /// + /// This class acts as an internal wrapper allowing us to do a dynamic + /// methodinfo invoke; an't put into Serializer as don't want on public + /// API; can't put into Serializer<T> since we need to invoke + /// across classes + /// + internal static class ExtensibleUtil + { + +#if !NO_RUNTIME + /// + /// All this does is call GetExtendedValuesTyped with the correct type for "instance"; + /// this ensures that we don't get issues with subclasses declaring conflicting types - + /// the caller must respect the fields defined for the type they pass in. + /// + internal static IEnumerable GetExtendedValues(IExtensible instance, int tag, DataFormat format, bool singleton, bool allowDefinedTag) + { + foreach (TValue value in GetExtendedValues(RuntimeTypeModel.Default, typeof(TValue), instance, tag, format, singleton, allowDefinedTag)) + { + yield return value; + } + } +#endif + /// + /// All this does is call GetExtendedValuesTyped with the correct type for "instance"; + /// this ensures that we don't get issues with subclasses declaring conflicting types - + /// the caller must respect the fields defined for the type they pass in. + /// + internal static IEnumerable GetExtendedValues(TypeModel model, Type type, IExtensible instance, int tag, DataFormat format, bool singleton, bool allowDefinedTag) + { + if (instance == null) throw new ArgumentNullException(nameof(instance)); + if (tag <= 0) throw new ArgumentOutOfRangeException(nameof(tag)); + IExtension extn = instance.GetExtensionObject(false); + + if (extn == null) + { + yield break; + } + + Stream stream = extn.BeginQuery(); + object value = null; + ProtoReader reader = null; + try + { + SerializationContext ctx = new SerializationContext(); + reader = ProtoReader.Create(stream, model, ctx, ProtoReader.TO_EOF); + while (model.TryDeserializeAuxiliaryType(reader, format, tag, type, ref value, true, true, false, false, null) && value != null) + { + if (!singleton) + { + yield return value; + + value = null; // fresh item each time + } + } + if (singleton && value != null) + { + yield return value; + } + } + finally + { + ProtoReader.Recycle(reader); + extn.EndQuery(stream); + } + } + + internal static void AppendExtendValue(TypeModel model, IExtensible instance, int tag, DataFormat format, object value) + { + if (instance == null) throw new ArgumentNullException(nameof(instance)); + if (value == null) throw new ArgumentNullException(nameof(value)); + + // TODO + //model.CheckTagNotInUse(tag); + + // obtain the extension object and prepare to write + IExtension extn = instance.GetExtensionObject(true); + if (extn == null) throw new InvalidOperationException("No extension object available; appended data would be lost."); + bool commit = false; + Stream stream = extn.BeginAppend(); + try + { + using (ProtoWriter writer = ProtoWriter.Create(stream, model, null)) + { + model.TrySerializeAuxiliaryType(writer, null, format, tag, value, false, null); + writer.Close(); + } + commit = true; + } + finally + { + extn.EndAppend(stream, commit); + } + } + + // /// + // /// Stores the given value into the instance's stream; the serializer + // /// is inferred from TValue and format. + // /// + // /// Needs to be public to be callable thru reflection in Silverlight + // public static void AppendExtendValueTyped( + // TypeModel model, TSource instance, int tag, DataFormat format, TValue value) + // where TSource : class, IExtensible + // { + // AppendExtendValue(model, instance, tag, format, value); + // } + + } + +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/GlobalSuppressions.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/GlobalSuppressions.cs new file mode 100644 index 0000000000000000000000000000000000000000..48b91900b51b472ffc30340fc102117033e243b7 GIT binary patch literal 2750 zcmeH|UuzRl5XI+N@H;H~q|l}cf>`jOR)juOgycoUhc(&!(PUGyyM=st^>=1^+06z; z1RpFVB)j*{+%sp+%-sC=er9Ku*~FH%vYNL!&$X4j#kys;v>EF!w&(ZKwyb2ou*wR2 z_jrVFgDtZSyDMzX-7~YXwRXd2$GMu%_1&|ug(E$-N3al&f>RBCE26c$$v@+{bc^i5 z&{KG8{DNCVmR~SYtgU^;I_31px(FW*ET^99Eq-fI>jBRd7?m?9!4-PR>CD;aOomk% zE7P6l(y-dPPhz^@qoyJayqv}lU8~dSL z@KOC!-PI+XwPW+U9*Z7oL2p1()El@*za@70QO9M2p3D7YQn=5xW0BjH^BZ<=QsNy^ zH7R*d(ab)=riIna6;*$zCo258F9Y#>`PRLn{iFFr}o*W{h=Z;>-~zv-7Fn- w$IrPdG#$- + /// Not all frameworks are created equal (fx1.1 vs fx2.0, + /// micro-framework, compact-framework, + /// silverlight, etc). This class simply wraps up a few things that would + /// otherwise make the real code unnecessarily messy, providing fallback + /// implementations if necessary. + /// + internal sealed class Helpers + { + private Helpers() { } + + public static StringBuilder AppendLine(StringBuilder builder) + { + return builder.AppendLine(); + } + + [System.Diagnostics.Conditional("DEBUG")] + public static void DebugWriteLine(string message, object obj) + { +#if DEBUG + string suffix; + try + { + suffix = obj == null ? "(null)" : obj.ToString(); + } + catch + { + suffix = "(exception)"; + } + DebugWriteLine(message + ": " + suffix); +#endif + } + [System.Diagnostics.Conditional("DEBUG")] + public static void DebugWriteLine(string message) + { +#if DEBUG + System.Diagnostics.Debug.WriteLine(message); +#endif + } + [System.Diagnostics.Conditional("TRACE")] + public static void TraceWriteLine(string message) + { +#if TRACE +#if CF2 || PORTABLE || COREFX || PROFILE259 + System.Diagnostics.Debug.WriteLine(message); +#else + System.Diagnostics.Trace.WriteLine(message); +#endif +#endif + } + + [System.Diagnostics.Conditional("DEBUG")] + public static void DebugAssert(bool condition, string message) + { +#if DEBUG + if (!condition) + { + System.Diagnostics.Debug.Assert(false, message); + } +#endif + } + [System.Diagnostics.Conditional("DEBUG")] + public static void DebugAssert(bool condition, string message, params object[] args) + { +#if DEBUG + if (!condition) DebugAssert(false, string.Format(message, args)); +#endif + } + [System.Diagnostics.Conditional("DEBUG")] + public static void DebugAssert(bool condition) + { +#if DEBUG + if (!condition && System.Diagnostics.Debugger.IsAttached) System.Diagnostics.Debugger.Break(); + System.Diagnostics.Debug.Assert(condition); +#endif + } +#if !NO_RUNTIME + public static void Sort(int[] keys, object[] values) + { + // bubble-sort; it'll work on MF, has small code, + // and works well-enough for our sizes. This approach + // also allows us to do `int` compares without having + // to go via IComparable etc, so win:win + bool swapped; + do + { + swapped = false; + for (int i = 1; i < keys.Length; i++) + { + if (keys[i - 1] > keys[i]) + { + int tmpKey = keys[i]; + keys[i] = keys[i - 1]; + keys[i - 1] = tmpKey; + object tmpValue = values[i]; + values[i] = values[i - 1]; + values[i - 1] = tmpValue; + swapped = true; + } + } + } while (swapped); + } +#endif + +#if COREFX + internal static MemberInfo GetInstanceMember(TypeInfo declaringType, string name) + { + var members = declaringType.AsType().GetMember(name, BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic); + switch(members.Length) + { + case 0: return null; + case 1: return members[0]; + default: throw new AmbiguousMatchException(name); + } + } + internal static MethodInfo GetInstanceMethod(Type declaringType, string name) + { + foreach (MethodInfo method in declaringType.GetMethods(BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic)) + { + if (method.Name == name) return method; + } + return null; + } + internal static MethodInfo GetInstanceMethod(TypeInfo declaringType, string name) + { + return GetInstanceMethod(declaringType.AsType(), name); ; + } + internal static MethodInfo GetStaticMethod(Type declaringType, string name) + { + foreach (MethodInfo method in declaringType.GetMethods(BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic)) + { + if (method.Name == name) return method; + } + return null; + } + + internal static MethodInfo GetStaticMethod(TypeInfo declaringType, string name) + { + return GetStaticMethod(declaringType.AsType(), name); + } + internal static MethodInfo GetStaticMethod(Type declaringType, string name, Type[] parameterTypes) + { + foreach(MethodInfo method in declaringType.GetMethods(BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic)) + { + if (method.Name == name && IsMatch(method.GetParameters(), parameterTypes)) return method; + } + return null; + } + internal static MethodInfo GetInstanceMethod(Type declaringType, string name, Type[] parameterTypes) + { + foreach (MethodInfo method in declaringType.GetMethods(BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic)) + { + if (method.Name == name && IsMatch(method.GetParameters(), parameterTypes)) return method; + } + return null; + } + internal static MethodInfo GetInstanceMethod(TypeInfo declaringType, string name, Type[] types) + { + return GetInstanceMethod(declaringType.AsType(), name, types); + } +#elif PROFILE259 + internal static MemberInfo GetInstanceMember(TypeInfo declaringType, string name) + { + IEnumerable members = declaringType.DeclaredMembers; + IList found = new List(); + foreach (MemberInfo member in members) + { + if (member.Name.Equals(name)) + { + found.Add(member); + } + } + switch (found.Count) + { + case 0: return null; + case 1: return found.First(); + default: throw new AmbiguousMatchException(name); + } + } + internal static MethodInfo GetInstanceMethod(Type declaringType, string name) + { + var methods = declaringType.GetRuntimeMethods(); + foreach (MethodInfo method in methods) + { + if (method.Name == name) + { + return method; + } + } + return null; + } + internal static MethodInfo GetInstanceMethod(TypeInfo declaringType, string name) + { + return GetInstanceMethod(declaringType.AsType(), name); ; + } + internal static MethodInfo GetStaticMethod(Type declaringType, string name) + { + var methods = declaringType.GetRuntimeMethods(); + foreach (MethodInfo method in methods) + { + if (method.Name == name) + { + return method; + } + } + return null; + } + + internal static MethodInfo GetStaticMethod(TypeInfo declaringType, string name) + { + return GetStaticMethod(declaringType.AsType(), name); + } + internal static MethodInfo GetStaticMethod(Type declaringType, string name, Type[] parameterTypes) + { + var methods = declaringType.GetRuntimeMethods(); + foreach (MethodInfo method in methods) + { + if (method.Name == name && + IsMatch(method.GetParameters(), parameterTypes)) + { + return method; + } + } + return null; + } + internal static MethodInfo GetInstanceMethod(Type declaringType, string name, Type[] parameterTypes) + { + var methods = declaringType.GetRuntimeMethods(); + foreach (MethodInfo method in methods) + { + if (method.Name == name && + IsMatch(method.GetParameters(), parameterTypes)) + { + return method; + } + } + return null; + } + internal static MethodInfo GetInstanceMethod(TypeInfo declaringType, string name, Type[] types) + { + return GetInstanceMethod(declaringType.AsType(), name, types); + } +#else + internal static MethodInfo GetInstanceMethod(Type declaringType, string name) + { + return declaringType.GetMethod(name, BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic); + } + internal static MethodInfo GetStaticMethod(Type declaringType, string name) + { + return declaringType.GetMethod(name, BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic); + } + internal static MethodInfo GetStaticMethod(Type declaringType, string name, Type[] parameterTypes) + { +#if PORTABLE + foreach (MethodInfo method in declaringType.GetMethods(BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic)) + { + if (method.Name == name && IsMatch(method.GetParameters(), parameterTypes)) return method; + } + return null; +#else + return declaringType.GetMethod(name, BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic, null, parameterTypes, null); +#endif + } + internal static MethodInfo GetInstanceMethod(Type declaringType, string name, Type[] types) + { + if (types == null) types = EmptyTypes; +#if PORTABLE || COREFX + MethodInfo method = declaringType.GetMethod(name, types); + if (method != null && method.IsStatic) method = null; + return method; +#else + return declaringType.GetMethod(name, BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic, + null, types, null); +#endif + } +#endif + + internal static bool IsSubclassOf(Type type, Type baseClass) + { +#if COREFX || PROFILE259 + return type.GetTypeInfo().IsSubclassOf(baseClass); +#else + return type.IsSubclassOf(baseClass); +#endif + } + + public readonly static Type[] EmptyTypes = +#if PORTABLE || CF2 || CF35 || PROFILE259 + new Type[0]; +#else + Type.EmptyTypes; +#endif + +#if COREFX || PROFILE259 + private static readonly Type[] knownTypes = new Type[] { + typeof(bool), typeof(char), typeof(sbyte), typeof(byte), + typeof(short), typeof(ushort), typeof(int), typeof(uint), + typeof(long), typeof(ulong), typeof(float), typeof(double), + typeof(decimal), typeof(string), + typeof(DateTime), typeof(TimeSpan), typeof(Guid), typeof(Uri), + typeof(byte[]), typeof(Type)}; + private static readonly ProtoTypeCode[] knownCodes = new ProtoTypeCode[] { + ProtoTypeCode.Boolean, ProtoTypeCode.Char, ProtoTypeCode.SByte, ProtoTypeCode.Byte, + ProtoTypeCode.Int16, ProtoTypeCode.UInt16, ProtoTypeCode.Int32, ProtoTypeCode.UInt32, + ProtoTypeCode.Int64, ProtoTypeCode.UInt64, ProtoTypeCode.Single, ProtoTypeCode.Double, + ProtoTypeCode.Decimal, ProtoTypeCode.String, + ProtoTypeCode.DateTime, ProtoTypeCode.TimeSpan, ProtoTypeCode.Guid, ProtoTypeCode.Uri, + ProtoTypeCode.ByteArray, ProtoTypeCode.Type + }; + +#endif + + public static ProtoTypeCode GetTypeCode(Type type) + { +#if COREFX || PROFILE259 + if (IsEnum(type)) + { + type = Enum.GetUnderlyingType(type); + } + int idx = Array.IndexOf(knownTypes, type); + if (idx >= 0) return knownCodes[idx]; + return type == null ? ProtoTypeCode.Empty : ProtoTypeCode.Unknown; +#else + TypeCode code = Type.GetTypeCode(type); + switch (code) + { + case TypeCode.Empty: + case TypeCode.Boolean: + case TypeCode.Char: + case TypeCode.SByte: + case TypeCode.Byte: + case TypeCode.Int16: + case TypeCode.UInt16: + case TypeCode.Int32: + case TypeCode.UInt32: + case TypeCode.Int64: + case TypeCode.UInt64: + case TypeCode.Single: + case TypeCode.Double: + case TypeCode.Decimal: + case TypeCode.DateTime: + case TypeCode.String: + return (ProtoTypeCode)code; + } + if (type == typeof(TimeSpan)) return ProtoTypeCode.TimeSpan; + if (type == typeof(Guid)) return ProtoTypeCode.Guid; + if (type == typeof(Uri)) return ProtoTypeCode.Uri; +#if PORTABLE + // In PCLs, the Uri type may not match (WinRT uses Internal/Uri, .Net uses System/Uri), so match on the full name instead + if (type.FullName == typeof(Uri).FullName) return ProtoTypeCode.Uri; +#endif + if (type == typeof(byte[])) return ProtoTypeCode.ByteArray; + if (type == typeof(Type)) return ProtoTypeCode.Type; + + return ProtoTypeCode.Unknown; +#endif + } + + internal static Type GetUnderlyingType(Type type) + { + return Nullable.GetUnderlyingType(type); + } + + internal static bool IsValueType(Type type) + { +#if COREFX || PROFILE259 + return type.GetTypeInfo().IsValueType; +#else + return type.IsValueType; +#endif + } + internal static bool IsSealed(Type type) + { +#if COREFX || PROFILE259 + return type.GetTypeInfo().IsSealed; +#else + return type.IsSealed; +#endif + } + internal static bool IsClass(Type type) + { +#if COREFX || PROFILE259 + return type.GetTypeInfo().IsClass; +#else + return type.IsClass; +#endif + } + + internal static bool IsEnum(Type type) + { +#if COREFX || PROFILE259 + return type.GetTypeInfo().IsEnum; +#else + return type.IsEnum; +#endif + } + + internal static MethodInfo GetGetMethod(PropertyInfo property, bool nonPublic, bool allowInternal) + { + if (property == null) return null; +#if COREFX || PROFILE259 + MethodInfo method = property.GetMethod; + if (!nonPublic && method != null && !method.IsPublic) method = null; + return method; +#else + MethodInfo method = property.GetGetMethod(nonPublic); + if (method == null && !nonPublic && allowInternal) + { // could be "internal" or "protected internal"; look for a non-public, then back-check + method = property.GetGetMethod(true); + if (method == null && !(method.IsAssembly || method.IsFamilyOrAssembly)) + { + method = null; + } + } + return method; +#endif + } + internal static MethodInfo GetSetMethod(PropertyInfo property, bool nonPublic, bool allowInternal) + { + if (property == null) return null; +#if COREFX || PROFILE259 + MethodInfo method = property.SetMethod; + if (!nonPublic && method != null && !method.IsPublic) method = null; + return method; +#else + MethodInfo method = property.GetSetMethod(nonPublic); + if (method == null && !nonPublic && allowInternal) + { // could be "internal" or "protected internal"; look for a non-public, then back-check + method = property.GetGetMethod(true); + if (method == null && !(method.IsAssembly || method.IsFamilyOrAssembly)) + { + method = null; + } + } + return method; +#endif + } + +#if COREFX || PORTABLE || PROFILE259 + private static bool IsMatch(ParameterInfo[] parameters, Type[] parameterTypes) + { + if (parameterTypes == null) parameterTypes = EmptyTypes; + if (parameters.Length != parameterTypes.Length) return false; + for (int i = 0; i < parameters.Length; i++) + { + if (parameters[i].ParameterType != parameterTypes[i]) return false; + } + return true; + } +#endif +#if COREFX || PROFILE259 + internal static ConstructorInfo GetConstructor(Type type, Type[] parameterTypes, bool nonPublic) + { + return GetConstructor(type.GetTypeInfo(), parameterTypes, nonPublic); + } + internal static ConstructorInfo GetConstructor(TypeInfo type, Type[] parameterTypes, bool nonPublic) + { + return GetConstructors(type, nonPublic).SingleOrDefault(ctor => IsMatch(ctor.GetParameters(), parameterTypes)); + } + internal static ConstructorInfo[] GetConstructors(TypeInfo typeInfo, bool nonPublic) + { + return typeInfo.DeclaredConstructors.Where(c => !c.IsStatic && ((!nonPublic && c.IsPublic) || nonPublic)).ToArray(); + } + internal static PropertyInfo GetProperty(Type type, string name, bool nonPublic) + { + return GetProperty(type.GetTypeInfo(), name, nonPublic); + } + internal static PropertyInfo GetProperty(TypeInfo type, string name, bool nonPublic) + { + return type.GetDeclaredProperty(name); + } +#else + + internal static ConstructorInfo GetConstructor(Type type, Type[] parameterTypes, bool nonPublic) + { +#if PORTABLE || COREFX + // pretty sure this will only ever return public, but... + ConstructorInfo ctor = type.GetConstructor(parameterTypes); + return (ctor != null && (nonPublic || ctor.IsPublic)) ? ctor : null; +#else + return type.GetConstructor( + nonPublic ? BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic + : BindingFlags.Instance | BindingFlags.Public, + null, parameterTypes, null); +#endif + + } + internal static ConstructorInfo[] GetConstructors(Type type, bool nonPublic) + { + return type.GetConstructors( + nonPublic ? BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic + : BindingFlags.Instance | BindingFlags.Public); + } + internal static PropertyInfo GetProperty(Type type, string name, bool nonPublic) + { + return type.GetProperty(name, + nonPublic ? BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic + : BindingFlags.Instance | BindingFlags.Public); + } +#endif + + + internal static object ParseEnum(Type type, string value) + { + return Enum.Parse(type, value, true); + } + + + internal static MemberInfo[] GetInstanceFieldsAndProperties(Type type, bool publicOnly) + { +#if PROFILE259 + var members = new List(); + foreach (FieldInfo field in type.GetRuntimeFields()) + { + if (field.IsStatic) continue; + if (field.IsPublic || !publicOnly) members.Add(field); + } + foreach (PropertyInfo prop in type.GetRuntimeProperties()) + { + MethodInfo getter = Helpers.GetGetMethod(prop, true, true); + if (getter == null || getter.IsStatic) continue; + if (getter.IsPublic || !publicOnly) members.Add(prop); + } + return members.ToArray(); +#else + BindingFlags flags = publicOnly ? BindingFlags.Public | BindingFlags.Instance : BindingFlags.Public | BindingFlags.Instance | BindingFlags.NonPublic; + PropertyInfo[] props = type.GetProperties(flags); + FieldInfo[] fields = type.GetFields(flags); + MemberInfo[] members = new MemberInfo[fields.Length + props.Length]; + props.CopyTo(members, 0); + fields.CopyTo(members, props.Length); + return members; +#endif + } + + internal static Type GetMemberType(MemberInfo member) + { +#if PORTABLE || COREFX || PROFILE259 + if (member is PropertyInfo prop) return prop.PropertyType; + FieldInfo fld = member as FieldInfo; + return fld?.FieldType; +#else + switch (member.MemberType) + { + case MemberTypes.Field: return ((FieldInfo)member).FieldType; + case MemberTypes.Property: return ((PropertyInfo)member).PropertyType; + default: return null; + } +#endif + } + + internal static bool IsAssignableFrom(Type target, Type type) + { +#if PROFILE259 + return target.GetTypeInfo().IsAssignableFrom(type.GetTypeInfo()); +#else + return target.IsAssignableFrom(type); +#endif + } + internal static Assembly GetAssembly(Type type) + { +#if COREFX || PROFILE259 + return type.GetTypeInfo().Assembly; +#else + return type.Assembly; +#endif + } + internal static byte[] GetBuffer(MemoryStream ms) + { +#if COREFX + if(!ms.TryGetBuffer(out var segment)) + { + throw new InvalidOperationException("Unable to obtain underlying MemoryStream buffer"); + } else if(segment.Offset != 0) + { + throw new InvalidOperationException("Underlying MemoryStream buffer was not zero-offset"); + } else + { + return segment.Array; + } +#elif PORTABLE || PROFILE259 + return ms.ToArray(); +#else + return ms.GetBuffer(); +#endif + } + } + /// + /// Intended to be a direct map to regular TypeCode, but: + /// - with missing types + /// - existing on WinRT + /// + internal enum ProtoTypeCode + { + Empty = 0, + Unknown = 1, // maps to TypeCode.Object + Boolean = 3, + Char = 4, + SByte = 5, + Byte = 6, + Int16 = 7, + UInt16 = 8, + Int32 = 9, + UInt32 = 10, + Int64 = 11, + UInt64 = 12, + Single = 13, + Double = 14, + Decimal = 15, + DateTime = 16, + String = 18, + + // additions + TimeSpan = 100, + ByteArray = 101, + Guid = 102, + Uri = 103, + Type = 104 + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/IExtensible.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/IExtensible.cs new file mode 100644 index 0000000..b7c0b57 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/IExtensible.cs @@ -0,0 +1,23 @@ + +namespace ProtoBuf +{ + /// + /// Indicates that the implementing type has support for protocol-buffer + /// extensions. + /// + /// Can be implemented by deriving from Extensible. + public interface IExtensible + { + /// + /// Retrieves the extension object for the current + /// instance, optionally creating it if it does not already exist. + /// + /// Should a new extension object be + /// created if it does not already exist? + /// The extension object if it exists (or was created), or null + /// if the extension object does not exist or is not available. + /// The createIfMissing argument is false during serialization, + /// and true during deserialization upon encountering unexpected fields. + IExtension GetExtensionObject(bool createIfMissing); + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/IExtension.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/IExtension.cs new file mode 100644 index 0000000..0a137ac --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/IExtension.cs @@ -0,0 +1,58 @@ + +using System.IO; +namespace ProtoBuf +{ + /// + /// Provides addition capability for supporting unexpected fields during + /// protocol-buffer serialization/deserialization. This allows for loss-less + /// round-trip/merge, even when the data is not fully understood. + /// + public interface IExtension + { + /// + /// Requests a stream into which any unexpected fields can be persisted. + /// + /// A new stream suitable for storing data. + Stream BeginAppend(); + + /// + /// Indicates that all unexpected fields have now been stored. The + /// implementing class is responsible for closing the stream. If + /// "commit" is not true the data may be discarded. + /// + /// The stream originally obtained by BeginAppend. + /// True if the append operation completed successfully. + void EndAppend(Stream stream, bool commit); + + /// + /// Requests a stream of the unexpected fields previously stored. + /// + /// A prepared stream of the unexpected fields. + Stream BeginQuery(); + + /// + /// Indicates that all unexpected fields have now been read. The + /// implementing class is responsible for closing the stream. + /// + /// The stream originally obtained by BeginQuery. + void EndQuery(Stream stream); + + /// + /// Requests the length of the raw binary stream; this is used + /// when serializing sub-entities to indicate the expected size. + /// + /// The length of the binary stream representing unexpected data. + int GetLength(); + } + + /// + /// Provides the ability to remove all existing extension data + /// + public interface IExtensionResettable : IExtension + { + /// + /// Remove all existing extension data + /// + void Reset(); + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/IProtoInputT.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/IProtoInputT.cs new file mode 100644 index 0000000..6eaa0ce --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/IProtoInputT.cs @@ -0,0 +1,13 @@ +namespace ProtoBuf +{ + /// + /// Represents the ability to deserialize values from an input of type + /// + public interface IProtoInput + { + /// + /// Deserialize a value from the input + /// + T Deserialize(TInput source, T value = default, object userState = null); + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/IProtoOutputT.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/IProtoOutputT.cs new file mode 100644 index 0000000..1c7dd42 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/IProtoOutputT.cs @@ -0,0 +1,55 @@ +using System; + +namespace ProtoBuf +{ + /// + /// Represents the ability to serialize values to an output of type + /// + public interface IProtoOutput + { + /// + /// Serialize the provided value + /// + void Serialize(TOutput destination, T value, object userState = null); + } + + /// + /// Represents the ability to serialize values to an output of type + /// with pre-computation of the length + /// + public interface IMeasuredProtoOutput : IProtoOutput + { + /// + /// Measure the length of a value in advance of serialization + /// + MeasureState Measure(T value, object userState = null); + + /// + /// Serialize the previously measured value + /// + void Serialize(MeasureState measured, TOutput destination); + } + + /// + /// Represents the outcome of computing the length of an object; since this may have required computing lengths + /// for multiple objects, some metadata is retained so that a subsequent serialize operation using + /// this instance can re-use the previously calculated lengths. If the object state changes between the + /// measure and serialize operations, the behavior is undefined. + /// + public struct MeasureState : IDisposable + // note: 2.4.* does not actually implement this API; + // it only advertises it for 3.* capability/feature-testing, i.e. + // callers can check whether a model implements + // IMeasuredProtoOutput, and *work from that* + { + /// + /// Releases all resources associated with this value + /// + public void Dispose() => throw new NotImplementedException(); + + /// + /// Gets the calculated length of this serialize operation, in bytes + /// + public long Length => throw new NotImplementedException(); + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ImplicitFields.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ImplicitFields.cs new file mode 100644 index 0000000..211abdd --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ImplicitFields.cs @@ -0,0 +1,29 @@ +namespace ProtoBuf +{ + /// + /// Specifies the method used to infer field tags for members of the type + /// under consideration. Tags are deduced using the invariant alphabetic + /// sequence of the members' names; this makes implicit field tags very brittle, + /// and susceptible to changes such as field names (normally an isolated + /// change). + /// + public enum ImplicitFields + { + /// + /// No members are serialized implicitly; all members require a suitable + /// attribute such as [ProtoMember]. This is the recmomended mode for + /// most scenarios. + /// + None = 0, + /// + /// Public properties and fields are eligible for implicit serialization; + /// this treats the public API as a contract. Ordering beings from ImplicitFirstTag. + /// + AllPublic = 1, + /// + /// Public and non-public fields are eligible for implicit serialization; + /// this acts as a state/implementation serializer. Ordering beings from ImplicitFirstTag. + /// + AllFields = 2 + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/KeyValuePairProxy.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/KeyValuePairProxy.cs new file mode 100644 index 0000000..0da5761 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/KeyValuePairProxy.cs @@ -0,0 +1,44 @@ +//using System.Collections.Generic; + +//namespace ProtoBuf +//{ +// /// +// /// Mutable version of the common key/value pair struct; used during serialization. This type is intended for internal use only and should not +// /// be used by calling code; it is required to be public for implementation reasons. +// /// +// [ProtoContract] +// public struct KeyValuePairSurrogate +// { +// private TKey key; +// private TValue value; +// /// +// /// The key of the pair. +// /// +// [ProtoMember(1, IsRequired = true)] +// public TKey Key { get { return key; } set { key = value; } } +// /// +// /// The value of the pair. +// /// +// [ProtoMember(2)] +// public TValue Value{ get { return value; } set { this.value = value; } } +// private KeyValuePairSurrogate(TKey key, TValue value) +// { +// this.key = key; +// this.value = value; +// } +// /// +// /// Convert a surrogate instance to a standard pair instance. +// /// +// public static implicit operator KeyValuePair (KeyValuePairSurrogate value) +// { +// return new KeyValuePair(value.key, value.value); +// } +// /// +// /// Convert a standard pair instance to a surrogate instance. +// /// +// public static implicit operator KeyValuePairSurrogate(KeyValuePair value) +// { +// return new KeyValuePairSurrogate(value.Key, value.Value); +// } +// } +//} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/AttributeMap.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/AttributeMap.cs new file mode 100644 index 0000000..5bab942 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/AttributeMap.cs @@ -0,0 +1,108 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; + +namespace ProtoBuf.Meta +{ + internal abstract class AttributeMap + { +#if DEBUG + [Obsolete("Please use AttributeType instead")] + new public Type GetType() => AttributeType; +#endif + public override string ToString() => AttributeType?.FullName ?? ""; + public abstract bool TryGet(string key, bool publicOnly, out object value); + public bool TryGet(string key, out object value) + { + return TryGet(key, true, out value); + } + public abstract Type AttributeType { get; } + public static AttributeMap[] Create(TypeModel model, Type type, bool inherit) + { + +#if COREFX || PROFILE259 + Attribute[] all = System.Linq.Enumerable.ToArray(System.Linq.Enumerable.OfType(type.GetTypeInfo().GetCustomAttributes(inherit))); +#else + object[] all = type.GetCustomAttributes(inherit); +#endif + AttributeMap[] result = new AttributeMap[all.Length]; + for(int i = 0 ; i < all.Length ; i++) + { + result[i] = new ReflectionAttributeMap((Attribute)all[i]); + } + return result; + } + + public static AttributeMap[] Create(TypeModel model, MemberInfo member, bool inherit) + { + +#if COREFX || PROFILE259 + Attribute[] all = System.Linq.Enumerable.ToArray(System.Linq.Enumerable.OfType(member.GetCustomAttributes(inherit))); +#else + object[] all = member.GetCustomAttributes(inherit); +#endif + AttributeMap[] result = new AttributeMap[all.Length]; + for(int i = 0 ; i < all.Length ; i++) + { + result[i] = new ReflectionAttributeMap((Attribute)all[i]); + } + return result; + } + public static AttributeMap[] Create(TypeModel model, Assembly assembly) + { +#if COREFX || PROFILE259 + Attribute[] all = System.Linq.Enumerable.ToArray(assembly.GetCustomAttributes()); +#else + const bool inherit = false; + object[] all = assembly.GetCustomAttributes(inherit); +#endif + AttributeMap[] result = new AttributeMap[all.Length]; + for(int i = 0 ; i < all.Length ; i++) + { + result[i] = new ReflectionAttributeMap((Attribute)all[i]); + } + return result; + + } + + public abstract object Target { get; } + + private sealed class ReflectionAttributeMap : AttributeMap + { + private readonly Attribute attribute; + + public ReflectionAttributeMap(Attribute attribute) + { + this.attribute = attribute; + } + + public override object Target => attribute; + + public override Type AttributeType => attribute.GetType(); + + public override bool TryGet(string key, bool publicOnly, out object value) + { + MemberInfo[] members = Helpers.GetInstanceFieldsAndProperties(attribute.GetType(), publicOnly); + foreach (MemberInfo member in members) + { + if (string.Equals(member.Name, key, StringComparison.OrdinalIgnoreCase)) + { + if (member is PropertyInfo prop) { + value = prop.GetValue(attribute, null); + return true; + } + if (member is FieldInfo field) { + value = field.GetValue(attribute); + return true; + } + + throw new NotSupportedException(member.GetType().Name); + } + } + value = null; + return false; + } + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/BasicList.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/BasicList.cs new file mode 100644 index 0000000..d1308f3 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/BasicList.cs @@ -0,0 +1,267 @@ +using System; +using System.Collections; + +namespace ProtoBuf.Meta +{ + internal sealed class MutableList : BasicList + { + /* Like BasicList, but allows existing values to be changed + */ + public new object this[int index] + { + get { return head[index]; } + set { head[index] = value; } + } + public void RemoveLast() + { + head.RemoveLastWithMutate(); + } + + public void Clear() + { + head.Clear(); + } + } + + internal class BasicList : IEnumerable + { + /* Requirements: + * - Fast access by index + * - Immutable in the tail, so a node can be read (iterated) without locking + * - Lock-free tail handling must match the memory mode; struct for Node + * wouldn't work as "read" would not be atomic + * - Only operation required is append, but this shouldn't go out of its + * way to be inefficient + * - Assume that the caller is handling thread-safety (to co-ordinate with + * other code); no attempt to be thread-safe + * - Assume that the data is private; internal data structure is allowed to + * be mutable (i.e. array is fine as long as we don't screw it up) + */ + private static readonly Node nil = new Node(null, 0); + + public void CopyTo(Array array, int offset) + { + head.CopyTo(array, offset); + } + + protected Node head = nil; + + public int Add(object value) + { + return (head = head.Append(value)).Length - 1; + } + + public object this[int index] => head[index]; + + //public object TryGet(int index) + //{ + // return head.TryGet(index); + //} + + public void Trim() { head = head.Trim(); } + + public int Count => head.Length; + + IEnumerator IEnumerable.GetEnumerator() => new NodeEnumerator(head); + + public NodeEnumerator GetEnumerator() => new NodeEnumerator(head); + + public struct NodeEnumerator : IEnumerator + { + private int position; + private readonly Node node; + internal NodeEnumerator(Node node) + { + this.position = -1; + this.node = node; + } + void IEnumerator.Reset() { position = -1; } + public object Current { get { return node[position]; } } + public bool MoveNext() + { + int len = node.Length; + return (position <= len) && (++position < len); + } + } + + internal sealed class Node + { + public object this[int index] + { + get + { + if (index >= 0 && index < length) + { + return data[index]; + } + throw new ArgumentOutOfRangeException(nameof(index)); + } + set + { + if (index >= 0 && index < length) + { + data[index] = value; + } + else + { + throw new ArgumentOutOfRangeException(nameof(index)); + } + } + } + //public object TryGet(int index) + //{ + // return (index >= 0 && index < length) ? data[index] : null; + //} + private readonly object[] data; + + private int length; + public int Length => length; + + internal Node(object[] data, int length) + { + Helpers.DebugAssert((data == null && length == 0) || + (data != null && length > 0 && length <= data.Length)); + this.data = data; + + this.length = length; + } + + public void RemoveLastWithMutate() + { + if (length == 0) throw new InvalidOperationException(); + length -= 1; + } + + public Node Append(object value) + { + object[] newData; + int newLength = length + 1; + if (data == null) + { + newData = new object[10]; + } + else if (length == data.Length) + { + newData = new object[data.Length * 2]; + Array.Copy(data, newData, length); + } + else + { + newData = data; + } + newData[length] = value; + return new Node(newData, newLength); + } + + public Node Trim() + { + if (length == 0 || length == data.Length) return this; + object[] newData = new object[length]; + Array.Copy(data, newData, length); + return new Node(newData, length); + } + + internal int IndexOfString(string value) + { + for (int i = 0; i < length; i++) + { + if ((string)value == (string)data[i]) return i; + } + return -1; + } + + internal int IndexOfReference(object instance) + { + for (int i = 0; i < length; i++) + { + if ((object)instance == (object)data[i]) return i; + } // ^^^ (object) above should be preserved, even if this was typed; needs + // to be a reference check + return -1; + } + + internal int IndexOf(MatchPredicate predicate, object ctx) + { + for (int i = 0; i < length; i++) + { + if (predicate(data[i], ctx)) return i; + } + return -1; + } + + internal void CopyTo(Array array, int offset) + { + if (length > 0) + { + Array.Copy(data, 0, array, offset, length); + } + } + + internal void Clear() + { + if (data != null) + { + Array.Clear(data, 0, data.Length); + } + length = 0; + } + } + + internal int IndexOf(MatchPredicate predicate, object ctx) + { + return head.IndexOf(predicate, ctx); + } + + internal int IndexOfString(string value) + { + return head.IndexOfString(value); + } + + internal int IndexOfReference(object instance) + { + return head.IndexOfReference(instance); + } + + internal delegate bool MatchPredicate(object value, object ctx); + + internal bool Contains(object value) + { + foreach (object obj in this) + { + if (object.Equals(obj, value)) return true; + } + return false; + } + + internal sealed class Group + { + public readonly int First; + public readonly BasicList Items; + public Group(int first) + { + this.First = first; + this.Items = new BasicList(); + } + } + + internal static BasicList GetContiguousGroups(int[] keys, object[] values) + { + if (keys == null) throw new ArgumentNullException(nameof(keys)); + if (values == null) throw new ArgumentNullException(nameof(values)); + if (values.Length < keys.Length) throw new ArgumentException("Not all keys are covered by values", nameof(values)); + BasicList outer = new BasicList(); + Group group = null; + for (int i = 0; i < keys.Length; i++) + { + if (i == 0 || keys[i] != keys[i - 1]) { group = null; } + if (group == null) + { + group = new Group(keys[i]); + outer.Add(group); + } + group.Items.Add(values[i]); + } + return outer; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/CallbackSet.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/CallbackSet.cs new file mode 100644 index 0000000..8b08585 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/CallbackSet.cs @@ -0,0 +1,110 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; + +namespace ProtoBuf.Meta +{ + /// + /// Represents the set of serialization callbacks to be used when serializing/deserializing a type. + /// + public class CallbackSet + { + private readonly MetaType metaType; + internal CallbackSet(MetaType metaType) + { + this.metaType = metaType ?? throw new ArgumentNullException(nameof(metaType)); + } + + internal MethodInfo this[TypeModel.CallbackType callbackType] + { + get + { + switch (callbackType) + { + case TypeModel.CallbackType.BeforeSerialize: return beforeSerialize; + case TypeModel.CallbackType.AfterSerialize: return afterSerialize; + case TypeModel.CallbackType.BeforeDeserialize: return beforeDeserialize; + case TypeModel.CallbackType.AfterDeserialize: return afterDeserialize; + default: throw new ArgumentException("Callback type not supported: " + callbackType.ToString(), "callbackType"); + } + } + } + + internal static bool CheckCallbackParameters(TypeModel model, MethodInfo method) + { + ParameterInfo[] args = method.GetParameters(); + for (int i = 0; i < args.Length; i++) + { + Type paramType = args[i].ParameterType; + if (paramType == model.MapType(typeof(SerializationContext))) { } + else if (paramType == model.MapType(typeof(System.Type))) { } +#if PLAT_BINARYFORMATTER + else if (paramType == model.MapType(typeof(System.Runtime.Serialization.StreamingContext))) { } +#endif + else return false; + } + return true; + } + + private MethodInfo SanityCheckCallback(TypeModel model, MethodInfo callback) + { + metaType.ThrowIfFrozen(); + if (callback == null) return callback; // fine + if (callback.IsStatic) throw new ArgumentException("Callbacks cannot be static", nameof(callback)); + if (callback.ReturnType != model.MapType(typeof(void)) + || !CheckCallbackParameters(model, callback)) + { + throw CreateInvalidCallbackSignature(callback); + } + return callback; + } + + internal static Exception CreateInvalidCallbackSignature(MethodInfo method) + { + return new NotSupportedException("Invalid callback signature in " + method.DeclaringType.FullName + "." + method.Name); + } + + private MethodInfo beforeSerialize, afterSerialize, beforeDeserialize, afterDeserialize; + + /// Called before serializing an instance + public MethodInfo BeforeSerialize + { + get { return beforeSerialize; } + set { beforeSerialize = SanityCheckCallback(metaType.Model, value); } + } + + /// Called before deserializing an instance + public MethodInfo BeforeDeserialize + { + get { return beforeDeserialize; } + set { beforeDeserialize = SanityCheckCallback(metaType.Model, value); } + } + + /// Called after serializing an instance + public MethodInfo AfterSerialize + { + get { return afterSerialize; } + set { afterSerialize = SanityCheckCallback(metaType.Model, value); } + } + + /// Called after deserializing an instance + public MethodInfo AfterDeserialize + { + get { return afterDeserialize; } + set { afterDeserialize = SanityCheckCallback(metaType.Model, value); } + } + + /// + /// True if any callback is set, else False + /// + public bool NonTrivial + { + get + { + return beforeSerialize != null || beforeDeserialize != null + || afterSerialize != null || afterDeserialize != null; + } + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/MetaType.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/MetaType.cs new file mode 100644 index 0000000..8d9bed6 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/MetaType.cs @@ -0,0 +1,2171 @@ +#if !NO_RUNTIME +using System; +using System.Collections; +using System.Text; +using ProtoBuf.Serializers; +using System.Reflection; +using System.Collections.Generic; + +#if PROFILE259 +using System.Linq; +#endif + +namespace ProtoBuf.Meta +{ + /// + /// Represents a type at runtime for use with protobuf, allowing the field mappings (etc) to be defined + /// + public class MetaType : ISerializerProxy + { + internal sealed class Comparer : IComparer, IComparer + { + public static readonly Comparer Default = new Comparer(); + public int Compare(object x, object y) + { + return Compare(x as MetaType, y as MetaType); + } + public int Compare(MetaType x, MetaType y) + { + if (ReferenceEquals(x, y)) return 0; + if (x == null) return -1; + if (y == null) return 1; + + return string.Compare(x.GetSchemaTypeName(), y.GetSchemaTypeName(), StringComparison.Ordinal); + } + } + /// + /// Get the name of the type being represented + /// + public override string ToString() + { + return type.ToString(); + } + + IProtoSerializer ISerializerProxy.Serializer => Serializer; + private MetaType baseType; + + /// + /// Gets the base-type for this type + /// + public MetaType BaseType => baseType; + + internal TypeModel Model => model; + + /// + /// When used to compile a model, should public serialization/deserialzation methods + /// be included for this type? + /// + public bool IncludeSerializerMethod + { // negated to minimize common-case / initializer + get { return !HasFlag(OPTIONS_PrivateOnApi); } + set { SetFlag(OPTIONS_PrivateOnApi, !value, true); } + } + + /// + /// Should this type be treated as a reference by default? + /// + public bool AsReferenceDefault + { + get { return HasFlag(OPTIONS_AsReferenceDefault); } + set { SetFlag(OPTIONS_AsReferenceDefault, value, true); } + } + + private BasicList subTypes; + private bool IsValidSubType(Type subType) + { +#if COREFX || PROFILE259 + return typeInfo.IsAssignableFrom(subType.GetTypeInfo()); +#else + return type.IsAssignableFrom(subType); +#endif + } + /// + /// Adds a known sub-type to the inheritance model + /// + public MetaType AddSubType(int fieldNumber, Type derivedType) + { + return AddSubType(fieldNumber, derivedType, DataFormat.Default); + } + /// + /// Adds a known sub-type to the inheritance model + /// + public MetaType AddSubType(int fieldNumber, Type derivedType, DataFormat dataFormat) + { + if (derivedType == null) throw new ArgumentNullException("derivedType"); + if (fieldNumber < 1) throw new ArgumentOutOfRangeException("fieldNumber"); +#if COREFX || COREFX || PROFILE259 + if (!(typeInfo.IsClass || typeInfo.IsInterface) || typeInfo.IsSealed) { +#else + if (!(type.IsClass || type.IsInterface) || type.IsSealed) + { +#endif + throw new InvalidOperationException("Sub-types can only be added to non-sealed classes"); + } + if (!IsValidSubType(derivedType)) + { + throw new ArgumentException(derivedType.Name + " is not a valid sub-type of " + type.Name, "derivedType"); + } + MetaType derivedMeta = model[derivedType]; + ThrowIfFrozen(); + derivedMeta.ThrowIfFrozen(); + SubType subType = new SubType(fieldNumber, derivedMeta, dataFormat); + ThrowIfFrozen(); + + derivedMeta.SetBaseType(this); // includes ThrowIfFrozen + if (subTypes == null) subTypes = new BasicList(); + subTypes.Add(subType); + model.ResetKeyCache(); + return this; + } +#if COREFX || PROFILE259 + internal static readonly TypeInfo ienumerable = typeof(IEnumerable).GetTypeInfo(); +#else + internal static readonly Type ienumerable = typeof(IEnumerable); +#endif + private void SetBaseType(MetaType baseType) + { + if (baseType == null) throw new ArgumentNullException("baseType"); + if (this.baseType == baseType) return; + if (this.baseType != null) throw new InvalidOperationException($"Type '{this.baseType.Type.FullName}' can only participate in one inheritance hierarchy"); + + MetaType type = baseType; + while (type != null) + { + if (ReferenceEquals(type, this)) throw new InvalidOperationException($"Cyclic inheritance of '{this.baseType.Type.FullName}' is not allowed"); + type = type.baseType; + } + this.baseType = baseType; + } + + private CallbackSet callbacks; + + /// + /// Indicates whether the current type has defined callbacks + /// + public bool HasCallbacks => callbacks != null && callbacks.NonTrivial; + + /// + /// Indicates whether the current type has defined subtypes + /// + public bool HasSubtypes => subTypes != null && subTypes.Count != 0; + + /// + /// Returns the set of callbacks defined for this type + /// + public CallbackSet Callbacks + { + get + { + if (callbacks == null) callbacks = new CallbackSet(this); + return callbacks; + } + } + + private bool IsValueType + { + get + { +#if COREFX || PROFILE259 + return typeInfo.IsValueType; +#else + return type.IsValueType; +#endif + } + } + /// + /// Assigns the callbacks to use during serialiation/deserialization. + /// + /// The method (or null) called before serialization begins. + /// The method (or null) called when serialization is complete. + /// The method (or null) called before deserialization begins (or when a new instance is created during deserialization). + /// The method (or null) called when deserialization is complete. + /// The set of callbacks. + public MetaType SetCallbacks(MethodInfo beforeSerialize, MethodInfo afterSerialize, MethodInfo beforeDeserialize, MethodInfo afterDeserialize) + { + CallbackSet callbacks = Callbacks; + callbacks.BeforeSerialize = beforeSerialize; + callbacks.AfterSerialize = afterSerialize; + callbacks.BeforeDeserialize = beforeDeserialize; + callbacks.AfterDeserialize = afterDeserialize; + return this; + } + /// + /// Assigns the callbacks to use during serialiation/deserialization. + /// + /// The name of the method (or null) called before serialization begins. + /// The name of the method (or null) called when serialization is complete. + /// The name of the method (or null) called before deserialization begins (or when a new instance is created during deserialization). + /// The name of the method (or null) called when deserialization is complete. + /// The set of callbacks. + public MetaType SetCallbacks(string beforeSerialize, string afterSerialize, string beforeDeserialize, string afterDeserialize) + { + if (IsValueType) throw new InvalidOperationException(); + CallbackSet callbacks = Callbacks; + callbacks.BeforeSerialize = ResolveMethod(beforeSerialize, true); + callbacks.AfterSerialize = ResolveMethod(afterSerialize, true); + callbacks.BeforeDeserialize = ResolveMethod(beforeDeserialize, true); + callbacks.AfterDeserialize = ResolveMethod(afterDeserialize, true); + return this; + } + + /// + /// Returns the public Type name of this Type used in serialization + /// + public string GetSchemaTypeName() + { + if (surrogate != null) return model[surrogate].GetSchemaTypeName(); + + if (!string.IsNullOrEmpty(name)) return name; + + string typeName = type.Name; + if (type +#if COREFX || PROFILE259 + .GetTypeInfo() +#endif + .IsGenericType) + { + var sb = new StringBuilder(typeName); + int split = typeName.IndexOf('`'); + if (split >= 0) sb.Length = split; + foreach (Type arg in type +#if COREFX || PROFILE259 + .GetTypeInfo().GenericTypeArguments +#else + .GetGenericArguments() +#endif + ) + { + sb.Append('_'); + Type tmp = arg; + int key = model.GetKey(ref tmp); + MetaType mt; + if (key >= 0 && (mt = model[tmp]) != null && mt.surrogate == null) // <=== need to exclude surrogate to avoid chance of infinite loop + { + + sb.Append(mt.GetSchemaTypeName()); + } + else + { + sb.Append(tmp.Name); + } + } + return sb.ToString(); + } + + return typeName; + } + + private string name; + + /// + /// Gets or sets the name of this contract. + /// + public string Name + { + get + { + return name; + } + set + { + ThrowIfFrozen(); + name = value; + } + } + + private MethodInfo factory; + /// + /// Designate a factory-method to use to create instances of this type + /// + public MetaType SetFactory(MethodInfo factory) + { + model.VerifyFactory(factory, type); + ThrowIfFrozen(); + this.factory = factory; + return this; + } + + /// + /// Designate a factory-method to use to create instances of this type + /// + public MetaType SetFactory(string factory) + { + return SetFactory(ResolveMethod(factory, false)); + } + + private MethodInfo ResolveMethod(string name, bool instance) + { + if (string.IsNullOrEmpty(name)) return null; +#if COREFX + return instance ? Helpers.GetInstanceMethod(typeInfo, name) : Helpers.GetStaticMethod(typeInfo, name); +#else + return instance ? Helpers.GetInstanceMethod(type, name) : Helpers.GetStaticMethod(type, name); +#endif + } + + private readonly RuntimeTypeModel model; + + internal static Exception InbuiltType(Type type) + { + return new ArgumentException("Data of this type has inbuilt behaviour, and cannot be added to a model in this way: " + type.FullName); + } + + internal MetaType(RuntimeTypeModel model, Type type, MethodInfo factory) + { + this.factory = factory; + if (model == null) throw new ArgumentNullException("model"); + if (type == null) throw new ArgumentNullException("type"); + + if (type.IsArray) throw InbuiltType(type); + IProtoSerializer coreSerializer = model.TryGetBasicTypeSerializer(type); + if (coreSerializer != null) + { + throw InbuiltType(type); + } + + this.type = type; +#if COREFX || PROFILE259 + this.typeInfo = type.GetTypeInfo(); +#endif + this.model = model; + + if (Helpers.IsEnum(type)) + { +#if COREFX || PROFILE259 + EnumPassthru = typeInfo.IsDefined(typeof(FlagsAttribute), false); +#else + EnumPassthru = type.IsDefined(model.MapType(typeof(FlagsAttribute)), false); +#endif + } + } +#if COREFX || PROFILE259 + private readonly TypeInfo typeInfo; +#endif + /// + /// Throws an exception if the type has been made immutable + /// + protected internal void ThrowIfFrozen() + { + if ((flags & OPTIONS_Frozen) != 0) throw new InvalidOperationException("The type cannot be changed once a serializer has been generated for " + type.FullName); + } + + // internal void Freeze() { flags |= OPTIONS_Frozen; } + + private readonly Type type; + /// + /// The runtime type that the meta-type represents + /// + public Type Type => type; + + private IProtoTypeSerializer serializer; + internal IProtoTypeSerializer Serializer + { + get + { + if (serializer == null) + { + int opaqueToken = 0; + try + { + model.TakeLock(ref opaqueToken); + if (serializer == null) + { // double-check, but our main purpse with this lock is to ensure thread-safety with + // serializers needing to wait until another thread has finished adding the properties + SetFlag(OPTIONS_Frozen, true, false); + serializer = BuildSerializer(); +#if FEAT_COMPILER + if (model.AutoCompile) CompileInPlace(); +#endif + } + } + finally + { + model.ReleaseLock(opaqueToken); + } + } + return serializer; + } + } + internal bool IsList + { + get + { + Type itemType = IgnoreListHandling ? null : TypeModel.GetListItemType(model, type); + return itemType != null; + } + } + private IProtoTypeSerializer BuildSerializer() + { + if (Helpers.IsEnum(type)) + { + return new TagDecorator(ProtoBuf.Serializer.ListItemTag, WireType.Variant, false, new EnumSerializer(type, GetEnumMap())); + } + Type itemType = IgnoreListHandling ? null : TypeModel.GetListItemType(model, type); + if (itemType != null) + { + if (surrogate != null) + { + throw new ArgumentException("Repeated data (a list, collection, etc) has inbuilt behaviour and cannot use a surrogate"); + } + if (subTypes != null && subTypes.Count != 0) + { + throw new ArgumentException("Repeated data (a list, collection, etc) has inbuilt behaviour and cannot be subclassed"); + } + Type defaultType = null; + ResolveListTypes(model, type, ref itemType, ref defaultType); + ValueMember fakeMember = new ValueMember(model, ProtoBuf.Serializer.ListItemTag, type, itemType, defaultType, DataFormat.Default); + return new TypeSerializer(model, type, new int[] { ProtoBuf.Serializer.ListItemTag }, new IProtoSerializer[] { fakeMember.Serializer }, null, true, true, null, constructType, factory); + } + if (surrogate != null) + { + MetaType mt = model[surrogate], mtBase; + while ((mtBase = mt.baseType) != null) { mt = mtBase; } + return new SurrogateSerializer(model, type, surrogate, mt.Serializer); + } + if (IsAutoTuple) + { + ConstructorInfo ctor = ResolveTupleConstructor(type, out MemberInfo[] mapping); + if (ctor == null) throw new InvalidOperationException(); + return new TupleSerializer(model, ctor, mapping); + } + + fields.Trim(); + int fieldCount = fields.Count; + int subTypeCount = subTypes == null ? 0 : subTypes.Count; + int[] fieldNumbers = new int[fieldCount + subTypeCount]; + IProtoSerializer[] serializers = new IProtoSerializer[fieldCount + subTypeCount]; + int i = 0; + if (subTypeCount != 0) + { + foreach (SubType subType in subTypes) + { +#if COREFX || PROFILE259 + if (!subType.DerivedType.IgnoreListHandling && ienumerable.IsAssignableFrom(subType.DerivedType.Type.GetTypeInfo())) +#else + if (!subType.DerivedType.IgnoreListHandling && model.MapType(ienumerable).IsAssignableFrom(subType.DerivedType.Type)) +#endif + { + throw new ArgumentException("Repeated data (a list, collection, etc) has inbuilt behaviour and cannot be used as a subclass"); + } + fieldNumbers[i] = subType.FieldNumber; + serializers[i++] = subType.Serializer; + } + } + if (fieldCount != 0) + { + foreach (ValueMember member in fields) + { + fieldNumbers[i] = member.FieldNumber; + serializers[i++] = member.Serializer; + } + } + + BasicList baseCtorCallbacks = null; + MetaType tmp = BaseType; + + while (tmp != null) + { + MethodInfo method = tmp.HasCallbacks ? tmp.Callbacks.BeforeDeserialize : null; + if (method != null) + { + if (baseCtorCallbacks == null) baseCtorCallbacks = new BasicList(); + baseCtorCallbacks.Add(method); + } + tmp = tmp.BaseType; + } + MethodInfo[] arr = null; + if (baseCtorCallbacks != null) + { + arr = new MethodInfo[baseCtorCallbacks.Count]; + baseCtorCallbacks.CopyTo(arr, 0); + Array.Reverse(arr); + } + return new TypeSerializer(model, type, fieldNumbers, serializers, arr, baseType == null, UseConstructor, callbacks, constructType, factory); + } + + [Flags] + internal enum AttributeFamily + { + None = 0, ProtoBuf = 1, DataContractSerialier = 2, XmlSerializer = 4, AutoTuple = 8 + } + static Type GetBaseType(MetaType type) + { +#if COREFX || PROFILE259 + return type.typeInfo.BaseType; +#else + return type.type.BaseType; +#endif + } + internal static bool GetAsReferenceDefault(RuntimeTypeModel model, Type type) + { + if (type == null) throw new ArgumentNullException(nameof(type)); + if (Helpers.IsEnum(type)) return false; // never as-ref + AttributeMap[] typeAttribs = AttributeMap.Create(model, type, false); + for (int i = 0; i < typeAttribs.Length; i++) + { + if (typeAttribs[i].AttributeType.FullName == "ProtoBuf.ProtoContractAttribute") + { + if (typeAttribs[i].TryGet("AsReferenceDefault", out object tmp)) return (bool)tmp; + } + } + return false; + } + + internal void ApplyDefaultBehaviour() + { + TypeAddedEventArgs args = null; // allows us to share the event-args between events + RuntimeTypeModel.OnBeforeApplyDefaultBehaviour(this, ref args); + if (args == null || args.ApplyDefaultBehaviour) ApplyDefaultBehaviourImpl(); + RuntimeTypeModel.OnAfterApplyDefaultBehaviour(this, ref args); + } + + internal void ApplyDefaultBehaviourImpl() + { + Type baseType = GetBaseType(this); + if (baseType != null && model.FindWithoutAdd(baseType) == null + && GetContractFamily(model, baseType, null) != MetaType.AttributeFamily.None) + { + model.FindOrAddAuto(baseType, true, false, false); + } + + AttributeMap[] typeAttribs = AttributeMap.Create(model, type, false); + AttributeFamily family = GetContractFamily(model, type, typeAttribs); + if (family == AttributeFamily.AutoTuple) + { + SetFlag(OPTIONS_AutoTuple, true, true); + } + bool isEnum = !EnumPassthru && Helpers.IsEnum(type); + if (family == AttributeFamily.None && !isEnum) return; // and you'd like me to do what, exactly? + + bool enumShouldUseImplicitPassThru = isEnum; + BasicList partialIgnores = null, partialMembers = null; + int dataMemberOffset = 0, implicitFirstTag = 1; + bool inferTagByName = model.InferTagFromNameDefault; + ImplicitFields implicitMode = ImplicitFields.None; + string name = null; + for (int i = 0; i < typeAttribs.Length; i++) + { + AttributeMap item = (AttributeMap)typeAttribs[i]; + object tmp; + string fullAttributeTypeName = item.AttributeType.FullName; + if (!isEnum && fullAttributeTypeName == "ProtoBuf.ProtoIncludeAttribute") + { + int tag = 0; + if (item.TryGet("tag", out tmp)) tag = (int)tmp; + DataFormat dataFormat = DataFormat.Default; + if (item.TryGet("DataFormat", out tmp)) + { + dataFormat = (DataFormat)(int)tmp; + } + Type knownType = null; + try + { + if (item.TryGet("knownTypeName", out tmp)) knownType = model.GetType((string)tmp, type +#if COREFX || PROFILE259 + .GetTypeInfo() +#endif + .Assembly); + else if (item.TryGet("knownType", out tmp)) knownType = (Type)tmp; + } + catch (Exception ex) + { + throw new InvalidOperationException("Unable to resolve sub-type of: " + type.FullName, ex); + } + if (knownType == null) + { + throw new InvalidOperationException("Unable to resolve sub-type of: " + type.FullName); + } + if (IsValidSubType(knownType)) AddSubType(tag, knownType, dataFormat); + } + + if (fullAttributeTypeName == "ProtoBuf.ProtoPartialIgnoreAttribute") + { + if (item.TryGet(nameof(ProtoPartialIgnoreAttribute.MemberName), out tmp) && tmp != null) + { + if (partialIgnores == null) partialIgnores = new BasicList(); + partialIgnores.Add((string)tmp); + } + } + if (!isEnum && fullAttributeTypeName == "ProtoBuf.ProtoPartialMemberAttribute") + { + if (partialMembers == null) partialMembers = new BasicList(); + partialMembers.Add(item); + } + + if (fullAttributeTypeName == "ProtoBuf.ProtoContractAttribute") + { + if (item.TryGet(nameof(ProtoContractAttribute.Name), out tmp)) name = (string)tmp; + if (Helpers.IsEnum(type)) // note this is subtly different to isEnum; want to do this even if [Flags] + { + if (item.TryGet(nameof(ProtoContractAttribute.EnumPassthruHasValue), false, out tmp) && (bool)tmp) + { + if (item.TryGet(nameof(ProtoContractAttribute.EnumPassthru), out tmp)) + { + EnumPassthru = (bool)tmp; + enumShouldUseImplicitPassThru = false; + if (EnumPassthru) isEnum = false; // no longer treated as an enum + } + } + } + else + { + if (item.TryGet(nameof(ProtoContractAttribute.DataMemberOffset), out tmp)) dataMemberOffset = (int)tmp; + + if (item.TryGet(nameof(ProtoContractAttribute.InferTagFromNameHasValue), false, out tmp) && (bool)tmp) + { + if (item.TryGet(nameof(ProtoContractAttribute.InferTagFromName), out tmp)) inferTagByName = (bool)tmp; + } + + if (item.TryGet(nameof(ProtoContractAttribute.ImplicitFields), out tmp) && tmp != null) + { + implicitMode = (ImplicitFields)(int)tmp; // note that this uses the bizarre unboxing rules of enums/underlying-types + } + + if (item.TryGet(nameof(ProtoContractAttribute.SkipConstructor), out tmp)) UseConstructor = !(bool)tmp; + if (item.TryGet(nameof(ProtoContractAttribute.IgnoreListHandling), out tmp)) IgnoreListHandling = (bool)tmp; + if (item.TryGet(nameof(ProtoContractAttribute.AsReferenceDefault), out tmp)) AsReferenceDefault = (bool)tmp; + if (item.TryGet(nameof(ProtoContractAttribute.ImplicitFirstTag), out tmp) && (int)tmp > 0) implicitFirstTag = (int)tmp; + if (item.TryGet(nameof(ProtoContractAttribute.IsGroup), out tmp)) IsGroup = (bool)tmp; + + if (item.TryGet(nameof(ProtoContractAttribute.Surrogate), out tmp)) + { + SetSurrogate((Type)tmp); + } + } + } + + if (fullAttributeTypeName == "System.Runtime.Serialization.DataContractAttribute") + { + if (name == null && item.TryGet("Name", out tmp)) name = (string)tmp; + } + if (fullAttributeTypeName == "System.Xml.Serialization.XmlTypeAttribute") + { + if (name == null && item.TryGet("TypeName", out tmp)) name = (string)tmp; + } + } + if (!string.IsNullOrEmpty(name)) Name = name; + if (implicitMode != ImplicitFields.None) + { + family &= AttributeFamily.ProtoBuf; // with implicit fields, **only** proto attributes are important + } + MethodInfo[] callbacks = null; + + BasicList members = new BasicList(); + +#if PROFILE259 + IEnumerable foundList; + if(isEnum) { + foundList = type.GetRuntimeFields(); + } + else + { + List list = new List(); + foreach(PropertyInfo prop in type.GetRuntimeProperties()) { + MethodInfo getter = Helpers.GetGetMethod(prop, false, false); + if(getter != null && !getter.IsStatic) list.Add(prop); + } + foreach(FieldInfo fld in type.GetRuntimeFields()) if(fld.IsPublic && !fld.IsStatic) list.Add(fld); + foreach(MethodInfo mthd in type.GetRuntimeMethods()) if(mthd.IsPublic && !mthd.IsStatic) list.Add(mthd); + foundList = list; + } +#else + MemberInfo[] foundList = type.GetMembers(isEnum ? BindingFlags.Public | BindingFlags.Static + : BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance); +#endif + bool hasConflictingEnumValue = false; + foreach (MemberInfo member in foundList) + { + if (member.DeclaringType != type) continue; + if (member.IsDefined(model.MapType(typeof(ProtoIgnoreAttribute)), true)) continue; + if (partialIgnores != null && partialIgnores.Contains(member.Name)) continue; + + bool forced = false, isPublic, isField; + Type effectiveType; + + if (member is PropertyInfo property) + { + if (isEnum) continue; // wasn't expecting any props! + MemberInfo backingField = null; + if (!property.CanWrite) + { + // roslyn automatically implemented properties, in particular for get-only properties: <{Name}>k__BackingField; + var backingFieldName = $"<{property.Name}>k__BackingField"; + foreach (var fieldMemeber in foundList) + { + if ((fieldMemeber as FieldInfo != null) && fieldMemeber.Name == backingFieldName) + { + backingField = fieldMemeber; + break; + } + } + } + effectiveType = property.PropertyType; + isPublic = Helpers.GetGetMethod(property, false, false) != null; + isField = false; + ApplyDefaultBehaviour_AddMembers(model, family, isEnum, partialMembers, dataMemberOffset, inferTagByName, implicitMode, members, member, ref forced, isPublic, isField, ref effectiveType, ref hasConflictingEnumValue, backingField); + } + else if (member is FieldInfo field) + { + effectiveType = field.FieldType; + isPublic = field.IsPublic; + isField = true; + if (isEnum && !field.IsStatic) + { // only care about static things on enums; WinRT has a __value instance field! + continue; + } + ApplyDefaultBehaviour_AddMembers(model, family, isEnum, partialMembers, dataMemberOffset, inferTagByName, implicitMode, members, member, ref forced, isPublic, isField, ref effectiveType, ref hasConflictingEnumValue); + } + else if (member is MethodInfo method) + { + if (isEnum) continue; + AttributeMap[] memberAttribs = AttributeMap.Create(model, method, false); + if (memberAttribs != null && memberAttribs.Length > 0) + { + CheckForCallback(method, memberAttribs, "ProtoBuf.ProtoBeforeSerializationAttribute", ref callbacks, 0); + CheckForCallback(method, memberAttribs, "ProtoBuf.ProtoAfterSerializationAttribute", ref callbacks, 1); + CheckForCallback(method, memberAttribs, "ProtoBuf.ProtoBeforeDeserializationAttribute", ref callbacks, 2); + CheckForCallback(method, memberAttribs, "ProtoBuf.ProtoAfterDeserializationAttribute", ref callbacks, 3); + CheckForCallback(method, memberAttribs, "System.Runtime.Serialization.OnSerializingAttribute", ref callbacks, 4); + CheckForCallback(method, memberAttribs, "System.Runtime.Serialization.OnSerializedAttribute", ref callbacks, 5); + CheckForCallback(method, memberAttribs, "System.Runtime.Serialization.OnDeserializingAttribute", ref callbacks, 6); + CheckForCallback(method, memberAttribs, "System.Runtime.Serialization.OnDeserializedAttribute", ref callbacks, 7); + } + } + } + + if (isEnum && enumShouldUseImplicitPassThru && !hasConflictingEnumValue) + { + EnumPassthru = true; + // but leave isEnum alone + } + var arr = new ProtoMemberAttribute[members.Count]; + members.CopyTo(arr, 0); + + if (inferTagByName || implicitMode != ImplicitFields.None) + { + Array.Sort(arr); + int nextTag = implicitFirstTag; + foreach (ProtoMemberAttribute normalizedAttribute in arr) + { + if (!normalizedAttribute.TagIsPinned) // if ProtoMember etc sets a tag, we'll trust it + { + normalizedAttribute.Rebase(nextTag++); + } + } + } + + foreach (ProtoMemberAttribute normalizedAttribute in arr) + { + ValueMember vm = ApplyDefaultBehaviour(isEnum, normalizedAttribute); + if (vm != null) + { + Add(vm); + } + } + + if (callbacks != null) + { + SetCallbacks(Coalesce(callbacks, 0, 4), Coalesce(callbacks, 1, 5), + Coalesce(callbacks, 2, 6), Coalesce(callbacks, 3, 7)); + } + } + + private static void ApplyDefaultBehaviour_AddMembers(TypeModel model, AttributeFamily family, bool isEnum, BasicList partialMembers, int dataMemberOffset, bool inferTagByName, ImplicitFields implicitMode, BasicList members, MemberInfo member, ref bool forced, bool isPublic, bool isField, ref Type effectiveType, ref bool hasConflictingEnumValue, MemberInfo backingMember = null) + { + switch (implicitMode) + { + case ImplicitFields.AllFields: + if (isField) forced = true; + break; + case ImplicitFields.AllPublic: + if (isPublic) forced = true; + break; + } + + // we just don't like delegate types ;p +#if COREFX || PROFILE259 + if (effectiveType.GetTypeInfo().IsSubclassOf(typeof(Delegate))) effectiveType = null; +#else + if (effectiveType.IsSubclassOf(model.MapType(typeof(Delegate)))) effectiveType = null; +#endif + if (effectiveType != null) + { + ProtoMemberAttribute normalizedAttribute = NormalizeProtoMember(model, member, family, forced, isEnum, partialMembers, dataMemberOffset, inferTagByName, ref hasConflictingEnumValue, backingMember); + if (normalizedAttribute != null) members.Add(normalizedAttribute); + } + } + + static MethodInfo Coalesce(MethodInfo[] arr, int x, int y) + { + MethodInfo mi = arr[x]; + if (mi == null) mi = arr[y]; + return mi; + } + + internal static AttributeFamily GetContractFamily(RuntimeTypeModel model, Type type, AttributeMap[] attributes) + { + AttributeFamily family = AttributeFamily.None; + + if (attributes == null) attributes = AttributeMap.Create(model, type, false); + + for (int i = 0; i < attributes.Length; i++) + { + switch (attributes[i].AttributeType.FullName) + { + case "ProtoBuf.ProtoContractAttribute": + bool tmp = false; + GetFieldBoolean(ref tmp, attributes[i], "UseProtoMembersOnly"); + if (tmp) return AttributeFamily.ProtoBuf; + family |= AttributeFamily.ProtoBuf; + break; + case "System.Xml.Serialization.XmlTypeAttribute": + if (!model.AutoAddProtoContractTypesOnly) + { + family |= AttributeFamily.XmlSerializer; + } + break; + case "System.Runtime.Serialization.DataContractAttribute": + if (!model.AutoAddProtoContractTypesOnly) + { + family |= AttributeFamily.DataContractSerialier; + } + break; + } + } + if (family == AttributeFamily.None) + { // check for obvious tuples + if (ResolveTupleConstructor(type, out MemberInfo[] mapping) != null) + { + family |= AttributeFamily.AutoTuple; + } + } + return family; + } + internal static ConstructorInfo ResolveTupleConstructor(Type type, out MemberInfo[] mappedMembers) + { + mappedMembers = null; + if (type == null) throw new ArgumentNullException(nameof(type)); +#if COREFX || PROFILE259 + TypeInfo typeInfo = type.GetTypeInfo(); + if (typeInfo.IsAbstract) return null; // as if! + ConstructorInfo[] ctors = Helpers.GetConstructors(typeInfo, false); +#else + if (type.IsAbstract) return null; // as if! + ConstructorInfo[] ctors = Helpers.GetConstructors(type, false); +#endif + // need to have an interesting constructor to bother even checking this stuff + if (ctors.Length == 0 || (ctors.Length == 1 && ctors[0].GetParameters().Length == 0)) return null; + + MemberInfo[] fieldsPropsUnfiltered = Helpers.GetInstanceFieldsAndProperties(type, true); + BasicList memberList = new BasicList(); + // for most types we'll enforce that you need readonly, because that is what protobuf-net + // always did historically; but: if you smell so much like a Tuple that it is *in your name*, + // we'll let you past that + bool demandReadOnly = type.Name.IndexOf("Tuple", StringComparison.OrdinalIgnoreCase) < 0; + for (int i = 0; i < fieldsPropsUnfiltered.Length; i++) + { + if (fieldsPropsUnfiltered[i] is PropertyInfo prop) + { + if (!prop.CanRead) return null; // no use if can't read + if (demandReadOnly && prop.CanWrite && Helpers.GetSetMethod(prop, false, false) != null) return null; // don't allow a public set (need to allow non-public to handle Mono's KeyValuePair<,>) + memberList.Add(prop); + } + else + { + if (fieldsPropsUnfiltered[i] is FieldInfo field) + { + if (demandReadOnly && !field.IsInitOnly) return null; // all public fields must be readonly to be counted a tuple + memberList.Add(field); + } + } + } + if (memberList.Count == 0) + { + return null; + } + + MemberInfo[] members = new MemberInfo[memberList.Count]; + memberList.CopyTo(members, 0); + + int[] mapping = new int[members.Length]; + int found = 0; + ConstructorInfo result = null; + mappedMembers = new MemberInfo[mapping.Length]; + for (int i = 0; i < ctors.Length; i++) + { + ParameterInfo[] parameters = ctors[i].GetParameters(); + + if (parameters.Length != members.Length) continue; + + // reset the mappings to test + for (int j = 0; j < mapping.Length; j++) mapping[j] = -1; + + for (int j = 0; j < parameters.Length; j++) + { + for (int k = 0; k < members.Length; k++) + { + if (string.Compare(parameters[j].Name, members[k].Name, StringComparison.OrdinalIgnoreCase) != 0) continue; + Type memberType = Helpers.GetMemberType(members[k]); + if (memberType != parameters[j].ParameterType) continue; + + mapping[j] = k; + } + } + // did we map all? + bool notMapped = false; + for (int j = 0; j < mapping.Length; j++) + { + if (mapping[j] < 0) + { + notMapped = true; + break; + } + mappedMembers[j] = members[mapping[j]]; + } + + if (notMapped) continue; + found++; + result = ctors[i]; + + } + return found == 1 ? result : null; + } + + private static void CheckForCallback(MethodInfo method, AttributeMap[] attributes, string callbackTypeName, ref MethodInfo[] callbacks, int index) + { + for (int i = 0; i < attributes.Length; i++) + { + if (attributes[i].AttributeType.FullName == callbackTypeName) + { + if (callbacks == null) { callbacks = new MethodInfo[8]; } + else if (callbacks[index] != null) + { +#if COREFX || PROFILE259 + Type reflected = method.DeclaringType; +#else + Type reflected = method.ReflectedType; +#endif + throw new ProtoException("Duplicate " + callbackTypeName + " callbacks on " + reflected.FullName); + } + callbacks[index] = method; + } + } + } + private static bool HasFamily(AttributeFamily value, AttributeFamily required) + { + return (value & required) == required; + } + + private static ProtoMemberAttribute NormalizeProtoMember(TypeModel model, MemberInfo member, AttributeFamily family, bool forced, bool isEnum, BasicList partialMembers, int dataMemberOffset, bool inferByTagName, ref bool hasConflictingEnumValue, MemberInfo backingMember = null) + { + if (member == null || (family == AttributeFamily.None && !isEnum)) return null; // nix + int fieldNumber = int.MinValue, minAcceptFieldNumber = inferByTagName ? -1 : 1; + string name = null; + bool isPacked = false, ignore = false, done = false, isRequired = false, asReference = false, asReferenceHasValue = false, dynamicType = false, tagIsPinned = false, overwriteList = false; + DataFormat dataFormat = DataFormat.Default; + if (isEnum) forced = true; + AttributeMap[] attribs = AttributeMap.Create(model, member, true); + AttributeMap attrib; + + if (isEnum) + { + attrib = GetAttribute(attribs, "ProtoBuf.ProtoIgnoreAttribute"); + if (attrib != null) + { + ignore = true; + } + else + { + attrib = GetAttribute(attribs, "ProtoBuf.ProtoEnumAttribute"); +#if PORTABLE || CF || COREFX || PROFILE259 + fieldNumber = Convert.ToInt32(((FieldInfo)member).GetValue(null)); +#else + fieldNumber = Convert.ToInt32(((FieldInfo)member).GetRawConstantValue()); +#endif + if (attrib != null) + { + GetFieldName(ref name, attrib, nameof(ProtoEnumAttribute.Name)); + + if ((bool)Helpers.GetInstanceMethod(attrib.AttributeType +#if COREFX || PROFILE259 + .GetTypeInfo() +#endif + , nameof(ProtoEnumAttribute.HasValue)).Invoke(attrib.Target, null)) + { + if (attrib.TryGet(nameof(ProtoEnumAttribute.Value), out object tmp)) + { + if (fieldNumber != (int)tmp) + { + hasConflictingEnumValue = true; + } + fieldNumber = (int)tmp; + } + } + } + + } + done = true; + } + + if (!ignore && !done) // always consider ProtoMember + { + attrib = GetAttribute(attribs, "ProtoBuf.ProtoMemberAttribute"); + GetIgnore(ref ignore, attrib, attribs, "ProtoBuf.ProtoIgnoreAttribute"); + + if (!ignore && attrib != null) + { + GetFieldNumber(ref fieldNumber, attrib, "Tag"); + GetFieldName(ref name, attrib, "Name"); + GetFieldBoolean(ref isRequired, attrib, "IsRequired"); + GetFieldBoolean(ref isPacked, attrib, "IsPacked"); + GetFieldBoolean(ref overwriteList, attrib, "OverwriteList"); + GetDataFormat(ref dataFormat, attrib, "DataFormat"); + GetFieldBoolean(ref asReferenceHasValue, attrib, "AsReferenceHasValue", false); + + if (asReferenceHasValue) + { + asReferenceHasValue = GetFieldBoolean(ref asReference, attrib, "AsReference", true); + } + GetFieldBoolean(ref dynamicType, attrib, "DynamicType"); + done = tagIsPinned = fieldNumber > 0; // note minAcceptFieldNumber only applies to non-proto + } + + if (!done && partialMembers != null) + { + foreach (AttributeMap ppma in partialMembers) + { + if (ppma.TryGet("MemberName", out object tmp) && (string)tmp == member.Name) + { + GetFieldNumber(ref fieldNumber, ppma, "Tag"); + GetFieldName(ref name, ppma, "Name"); + GetFieldBoolean(ref isRequired, ppma, "IsRequired"); + GetFieldBoolean(ref isPacked, ppma, "IsPacked"); + GetFieldBoolean(ref overwriteList, attrib, "OverwriteList"); + GetDataFormat(ref dataFormat, ppma, "DataFormat"); + GetFieldBoolean(ref asReferenceHasValue, attrib, "AsReferenceHasValue", false); + + if (asReferenceHasValue) + { + asReferenceHasValue = GetFieldBoolean(ref asReference, ppma, "AsReference", true); + } + GetFieldBoolean(ref dynamicType, ppma, "DynamicType"); + if (done = tagIsPinned = fieldNumber > 0) break; // note minAcceptFieldNumber only applies to non-proto + } + } + } + } + + if (!ignore && !done && HasFamily(family, AttributeFamily.DataContractSerialier)) + { + attrib = GetAttribute(attribs, "System.Runtime.Serialization.DataMemberAttribute"); + if (attrib != null) + { + GetFieldNumber(ref fieldNumber, attrib, "Order"); + GetFieldName(ref name, attrib, "Name"); + GetFieldBoolean(ref isRequired, attrib, "IsRequired"); + done = fieldNumber >= minAcceptFieldNumber; + if (done) fieldNumber += dataMemberOffset; // dataMemberOffset only applies to DCS flags, to allow us to "bump" WCF by a notch + } + } + if (!ignore && !done && HasFamily(family, AttributeFamily.XmlSerializer)) + { + attrib = GetAttribute(attribs, "System.Xml.Serialization.XmlElementAttribute"); + if (attrib == null) attrib = GetAttribute(attribs, "System.Xml.Serialization.XmlArrayAttribute"); + GetIgnore(ref ignore, attrib, attribs, "System.Xml.Serialization.XmlIgnoreAttribute"); + if (attrib != null && !ignore) + { + GetFieldNumber(ref fieldNumber, attrib, "Order"); + GetFieldName(ref name, attrib, "ElementName"); + done = fieldNumber >= minAcceptFieldNumber; + } + } + if (!ignore && !done) + { + if (GetAttribute(attribs, "System.NonSerializedAttribute") != null) ignore = true; + } + if (ignore || (fieldNumber < minAcceptFieldNumber && !forced)) return null; + ProtoMemberAttribute result = new ProtoMemberAttribute(fieldNumber, forced || inferByTagName) + { + AsReference = asReference, + AsReferenceHasValue = asReferenceHasValue, + DataFormat = dataFormat, + DynamicType = dynamicType, + IsPacked = isPacked, + OverwriteList = overwriteList, + IsRequired = isRequired, + Name = string.IsNullOrEmpty(name) ? member.Name : name, + Member = member, + BackingMember = backingMember, + TagIsPinned = tagIsPinned + }; + return result; + } + + private ValueMember ApplyDefaultBehaviour(bool isEnum, ProtoMemberAttribute normalizedAttribute) + { + MemberInfo member; + if (normalizedAttribute == null || (member = normalizedAttribute.Member) == null) return null; // nix + + Type effectiveType = Helpers.GetMemberType(member); + + + Type itemType = null; + Type defaultType = null; + + // check for list types + ResolveListTypes(model, effectiveType, ref itemType, ref defaultType); + bool ignoreListHandling = false; + // but take it back if it is explicitly excluded + if (itemType != null) + { // looks like a list, but double check for IgnoreListHandling + int idx = model.FindOrAddAuto(effectiveType, false, true, false); + if (idx >= 0 && (ignoreListHandling = model[effectiveType].IgnoreListHandling)) + { + itemType = null; + defaultType = null; + } + } + AttributeMap[] attribs = AttributeMap.Create(model, member, true); + AttributeMap attrib; + + object defaultValue = null; + // implicit zero default + if (model.UseImplicitZeroDefaults) + { + switch (Helpers.GetTypeCode(effectiveType)) + { + case ProtoTypeCode.Boolean: defaultValue = false; break; + case ProtoTypeCode.Decimal: defaultValue = (decimal)0; break; + case ProtoTypeCode.Single: defaultValue = (float)0; break; + case ProtoTypeCode.Double: defaultValue = (double)0; break; + case ProtoTypeCode.Byte: defaultValue = (byte)0; break; + case ProtoTypeCode.Char: defaultValue = (char)0; break; + case ProtoTypeCode.Int16: defaultValue = (short)0; break; + case ProtoTypeCode.Int32: defaultValue = (int)0; break; + case ProtoTypeCode.Int64: defaultValue = (long)0; break; + case ProtoTypeCode.SByte: defaultValue = (sbyte)0; break; + case ProtoTypeCode.UInt16: defaultValue = (ushort)0; break; + case ProtoTypeCode.UInt32: defaultValue = (uint)0; break; + case ProtoTypeCode.UInt64: defaultValue = (ulong)0; break; + case ProtoTypeCode.TimeSpan: defaultValue = TimeSpan.Zero; break; + case ProtoTypeCode.Guid: defaultValue = Guid.Empty; break; + } + } + if ((attrib = GetAttribute(attribs, "System.ComponentModel.DefaultValueAttribute")) != null) + { + if (attrib.TryGet("Value", out object tmp)) defaultValue = tmp; + } + ValueMember vm = ((isEnum || normalizedAttribute.Tag > 0)) + ? new ValueMember(model, type, normalizedAttribute.Tag, member, effectiveType, itemType, defaultType, normalizedAttribute.DataFormat, defaultValue) + : null; + if (vm != null) + { + vm.BackingMember = normalizedAttribute.BackingMember; +#if COREFX || PROFILE259 + TypeInfo finalType = typeInfo; +#else + Type finalType = type; +#endif + PropertyInfo prop = Helpers.GetProperty(finalType, member.Name + "Specified", true); + MethodInfo getMethod = Helpers.GetGetMethod(prop, true, true); + if (getMethod == null || getMethod.IsStatic) prop = null; + if (prop != null) + { + vm.SetSpecified(getMethod, Helpers.GetSetMethod(prop, true, true)); + } + else + { + MethodInfo method = Helpers.GetInstanceMethod(finalType, "ShouldSerialize" + member.Name, Helpers.EmptyTypes); + if (method != null && method.ReturnType == model.MapType(typeof(bool))) + { + vm.SetSpecified(method, null); + } + } + if (!string.IsNullOrEmpty(normalizedAttribute.Name)) vm.SetName(normalizedAttribute.Name); + vm.IsPacked = normalizedAttribute.IsPacked; + vm.IsRequired = normalizedAttribute.IsRequired; + vm.OverwriteList = normalizedAttribute.OverwriteList; + if (normalizedAttribute.AsReferenceHasValue) + { + vm.AsReference = normalizedAttribute.AsReference; + } + vm.DynamicType = normalizedAttribute.DynamicType; + + vm.IsMap = ignoreListHandling ? false : vm.ResolveMapTypes(out var _, out var _, out var _); + if (vm.IsMap) // is it even *allowed* to be a map? + { + if ((attrib = GetAttribute(attribs, "ProtoBuf.ProtoMapAttribute")) != null) + { + if (attrib.TryGet(nameof(ProtoMapAttribute.DisableMap), out object tmp) && (bool)tmp) + { + vm.IsMap = false; + } + else + { + if (attrib.TryGet(nameof(ProtoMapAttribute.KeyFormat), out tmp)) vm.MapKeyFormat = (DataFormat)tmp; + if (attrib.TryGet(nameof(ProtoMapAttribute.ValueFormat), out tmp)) vm.MapValueFormat = (DataFormat)tmp; + } + } + } + + } + return vm; + } + + private static void GetDataFormat(ref DataFormat value, AttributeMap attrib, string memberName) + { + if ((attrib == null) || (value != DataFormat.Default)) return; + if (attrib.TryGet(memberName, out object obj) && obj != null) value = (DataFormat)obj; + } + + private static void GetIgnore(ref bool ignore, AttributeMap attrib, AttributeMap[] attribs, string fullName) + { + if (ignore || attrib == null) return; + ignore = GetAttribute(attribs, fullName) != null; + return; + } + + private static void GetFieldBoolean(ref bool value, AttributeMap attrib, string memberName) + { + GetFieldBoolean(ref value, attrib, memberName, true); + } + private static bool GetFieldBoolean(ref bool value, AttributeMap attrib, string memberName, bool publicOnly) + { + if (attrib == null) return false; + if (value) return true; + if (attrib.TryGet(memberName, publicOnly, out object obj) && obj != null) + { + value = (bool)obj; + return true; + } + return false; + } + + private static void GetFieldNumber(ref int value, AttributeMap attrib, string memberName) + { + if (attrib == null || value > 0) return; + if (attrib.TryGet(memberName, out object obj) && obj != null) value = (int)obj; + } + + private static void GetFieldName(ref string name, AttributeMap attrib, string memberName) + { + if (attrib == null || !string.IsNullOrEmpty(name)) return; + if (attrib.TryGet(memberName, out object obj) && obj != null) name = (string)obj; + } + + private static AttributeMap GetAttribute(AttributeMap[] attribs, string fullName) + { + for (int i = 0; i < attribs.Length; i++) + { + AttributeMap attrib = attribs[i]; + if (attrib != null && attrib.AttributeType.FullName == fullName) return attrib; + } + return null; + } + + /// + /// Adds a member (by name) to the MetaType + /// + public MetaType Add(int fieldNumber, string memberName) + { + AddField(fieldNumber, memberName, null, null, null); + return this; + } + + /// + /// Adds a member (by name) to the MetaType, returning the ValueMember rather than the fluent API. + /// This is otherwise identical to Add. + /// + public ValueMember AddField(int fieldNumber, string memberName) + { + return AddField(fieldNumber, memberName, null, null, null); + } + + /// + /// Gets or sets whether the type should use a parameterless constructor (the default), + /// or whether the type should skip the constructor completely. This option is not supported + /// on compact-framework. + /// + public bool UseConstructor + { // negated to have defaults as flat zero + get { return !HasFlag(OPTIONS_SkipConstructor); } + set { SetFlag(OPTIONS_SkipConstructor, !value, true); } + } + + /// + /// The concrete type to create when a new instance of this type is needed; this may be useful when dealing + /// with dynamic proxies, or with interface-based APIs + /// + public Type ConstructType + { + get { return constructType; } + set + { + ThrowIfFrozen(); + constructType = value; + } + } + + private Type constructType; + /// + /// Adds a member (by name) to the MetaType + /// + public MetaType Add(string memberName) + { + Add(GetNextFieldNumber(), memberName); + return this; + } + + Type surrogate; + /// + /// Performs serialization of this type via a surrogate; all + /// other serialization options are ignored and handled + /// by the surrogate's configuration. + /// + public void SetSurrogate(Type surrogateType) + { + if (surrogateType == type) surrogateType = null; + if (surrogateType != null) + { + // note that BuildSerializer checks the **CURRENT TYPE** is OK to be surrogated + if (surrogateType != null && Helpers.IsAssignableFrom(model.MapType(typeof(IEnumerable)), surrogateType)) + { + throw new ArgumentException("Repeated data (a list, collection, etc) has inbuilt behaviour and cannot be used as a surrogate"); + } + } + ThrowIfFrozen(); + this.surrogate = surrogateType; + // no point in offering chaining; no options are respected + } + + internal MetaType GetSurrogateOrSelf() + { + if (surrogate != null) return model[surrogate]; + return this; + } + + internal MetaType GetSurrogateOrBaseOrSelf(bool deep) + { + if (surrogate != null) return model[surrogate]; + MetaType snapshot = this.baseType; + if (snapshot != null) + { + if (deep) + { + MetaType tmp; + do + { + tmp = snapshot; + snapshot = snapshot.baseType; + } while (snapshot != null); + return tmp; + } + return snapshot; + } + return this; + } + + private int GetNextFieldNumber() + { + int maxField = 0; + foreach (ValueMember member in fields) + { + if (member.FieldNumber > maxField) maxField = member.FieldNumber; + } + if (subTypes != null) + { + foreach (SubType subType in subTypes) + { + if (subType.FieldNumber > maxField) maxField = subType.FieldNumber; + } + } + return maxField + 1; + } + + /// + /// Adds a set of members (by name) to the MetaType + /// + public MetaType Add(params string[] memberNames) + { + if (memberNames == null) throw new ArgumentNullException("memberNames"); + int next = GetNextFieldNumber(); + for (int i = 0; i < memberNames.Length; i++) + { + Add(next++, memberNames[i]); + } + return this; + } + + /// + /// Adds a member (by name) to the MetaType + /// + public MetaType Add(int fieldNumber, string memberName, object defaultValue) + { + AddField(fieldNumber, memberName, null, null, defaultValue); + return this; + } + + /// + /// Adds a member (by name) to the MetaType, including an itemType and defaultType for representing lists + /// + public MetaType Add(int fieldNumber, string memberName, Type itemType, Type defaultType) + { + AddField(fieldNumber, memberName, itemType, defaultType, null); + return this; + } + + /// + /// Adds a member (by name) to the MetaType, including an itemType and defaultType for representing lists, returning the ValueMember rather than the fluent API. + /// This is otherwise identical to Add. + /// + public ValueMember AddField(int fieldNumber, string memberName, Type itemType, Type defaultType) + { + return AddField(fieldNumber, memberName, itemType, defaultType, null); + } + + private ValueMember AddField(int fieldNumber, string memberName, Type itemType, Type defaultType, object defaultValue) + { + MemberInfo mi = null; +#if PROFILE259 + mi = Helpers.IsEnum(type) ? type.GetTypeInfo().GetDeclaredField(memberName) : Helpers.GetInstanceMember(type.GetTypeInfo(), memberName); + +#else + MemberInfo[] members = type.GetMember(memberName, Helpers.IsEnum(type) ? BindingFlags.Static | BindingFlags.Public : BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic); + if (members != null && members.Length == 1) mi = members[0]; +#endif + if (mi == null) throw new ArgumentException("Unable to determine member: " + memberName, "memberName"); + + Type miType; + PropertyInfo pi = null; + FieldInfo fi = null; +#if PORTABLE || COREFX || PROFILE259 + pi = mi as PropertyInfo; + if (pi == null) + { + fi = mi as FieldInfo; + if (fi == null) + { + throw new NotSupportedException(mi.GetType().Name); + } + else + { + miType = fi.FieldType; + } + } + else + { + miType = pi.PropertyType; + } +#else + switch (mi.MemberType) + { + case MemberTypes.Field: + fi = (FieldInfo)mi; + miType = fi.FieldType; break; + case MemberTypes.Property: + pi = (PropertyInfo)mi; + miType = pi.PropertyType; break; + default: + throw new NotSupportedException(mi.MemberType.ToString()); + } +#endif + ResolveListTypes(model, miType, ref itemType, ref defaultType); + + MemberInfo backingField = null; + if (pi?.CanWrite == false) + { + string name = $"<{((PropertyInfo)mi).Name}>k__BackingField"; +#if PROFILE259 + var backingMembers = type.GetTypeInfo().DeclaredMembers; + var memberInfos = backingMembers as MemberInfo[] ?? backingMembers.ToArray(); + if (memberInfos.Count() == 1) + { + MemberInfo first = memberInfos.FirstOrDefault(); + if (first is FieldInfo) + { + backingField = first; + } + } +#else + var backingMembers = type.GetMember($"<{((PropertyInfo)mi).Name}>k__BackingField", Helpers.IsEnum(type) ? BindingFlags.Static | BindingFlags.Public : BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic); + if (backingMembers != null && backingMembers.Length == 1 && (backingMembers[0] as FieldInfo) != null) + backingField = backingMembers[0]; +#endif + } + ValueMember newField = new ValueMember(model, type, fieldNumber, backingField ?? mi, miType, itemType, defaultType, DataFormat.Default, defaultValue); + if (backingField != null) + newField.SetName(mi.Name); + Add(newField); + return newField; + } + + internal static void ResolveListTypes(TypeModel model, Type type, ref Type itemType, ref Type defaultType) + { + if (type == null) return; + // handle arrays + if (type.IsArray) + { + if (type.GetArrayRank() != 1) + { + throw new NotSupportedException("Multi-dimensional arrays are not supported"); + } + itemType = type.GetElementType(); + if (itemType == model.MapType(typeof(byte))) + { + defaultType = itemType = null; + } + else + { + defaultType = type; + } + } + // handle lists + if (itemType == null) { itemType = TypeModel.GetListItemType(model, type); } + + // check for nested data (not allowed) + if (itemType != null) + { + Type nestedItemType = null, nestedDefaultType = null; + ResolveListTypes(model, itemType, ref nestedItemType, ref nestedDefaultType); + if (nestedItemType != null) + { + throw TypeModel.CreateNestedListsNotSupported(type); + } + } + + if (itemType != null && defaultType == null) + { +#if COREFX || PROFILE259 + TypeInfo typeInfo = type.GetTypeInfo(); + if (typeInfo.IsClass && !typeInfo.IsAbstract && Helpers.GetConstructor(typeInfo, Helpers.EmptyTypes, true) != null) +#else + if (type.IsClass && !type.IsAbstract && Helpers.GetConstructor(type, Helpers.EmptyTypes, true) != null) +#endif + { + defaultType = type; + } + if (defaultType == null) + { +#if COREFX || PROFILE259 + if (typeInfo.IsInterface) +#else + if (type.IsInterface) +#endif + { + + Type[] genArgs; +#if COREFX || PROFILE259 + if (typeInfo.IsGenericType && type.GetGenericTypeDefinition() == typeof(System.Collections.Generic.IDictionary<,>) + && itemType == typeof(System.Collections.Generic.KeyValuePair<,>).MakeGenericType(genArgs = typeInfo.GenericTypeArguments)) +#else + if (type.IsGenericType && type.GetGenericTypeDefinition() == model.MapType(typeof(System.Collections.Generic.IDictionary<,>)) + && itemType == model.MapType(typeof(System.Collections.Generic.KeyValuePair<,>)).MakeGenericType(genArgs = type.GetGenericArguments())) +#endif + { + defaultType = model.MapType(typeof(System.Collections.Generic.Dictionary<,>)).MakeGenericType(genArgs); + } + else + { + defaultType = model.MapType(typeof(System.Collections.Generic.List<>)).MakeGenericType(itemType); + } + } + } + // verify that the default type is appropriate + if (defaultType != null && !Helpers.IsAssignableFrom(type, defaultType)) { defaultType = null; } + } + } + + private void Add(ValueMember member) + { + int opaqueToken = 0; + try + { + model.TakeLock(ref opaqueToken); + ThrowIfFrozen(); + fields.Add(member); + } + finally + { + model.ReleaseLock(opaqueToken); + } + } + + /// + /// Returns the ValueMember that matchs a given field number, or null if not found + /// + public ValueMember this[int fieldNumber] + { + get + { + foreach (ValueMember member in fields) + { + if (member.FieldNumber == fieldNumber) return member; + } + return null; + } + } + /// + /// Returns the ValueMember that matchs a given member (property/field), or null if not found + /// + public ValueMember this[MemberInfo member] + { + get + { + if (member == null) return null; + foreach (ValueMember x in fields) + { + if (x.Member == member || x.BackingMember == member) return x; + } + return null; + } + } + private readonly BasicList fields = new BasicList(); + + /// + /// Returns the ValueMember instances associated with this type + /// + public ValueMember[] GetFields() + { + ValueMember[] arr = new ValueMember[fields.Count]; + fields.CopyTo(arr, 0); + Array.Sort(arr, ValueMember.Comparer.Default); + return arr; + } + + /// + /// Returns the SubType instances associated with this type + /// + public SubType[] GetSubtypes() + { + if (subTypes == null || subTypes.Count == 0) return new SubType[0]; + SubType[] arr = new SubType[subTypes.Count]; + subTypes.CopyTo(arr, 0); + Array.Sort(arr, SubType.Comparer.Default); + return arr; + } + + internal IEnumerable GetAllGenericArguments() + { + return GetAllGenericArguments(type); + } + + private static IEnumerable GetAllGenericArguments(Type type) + { + +#if PROFILE259 + var genericArguments = type.GetGenericTypeDefinition().GenericTypeArguments; +#else + var genericArguments = type.GetGenericArguments(); +#endif + foreach (var arg in genericArguments) + { + yield return arg; + foreach (var inner in GetAllGenericArguments(arg)) + { + yield return inner; + } + } + } + +#if FEAT_COMPILER + /// + /// Compiles the serializer for this type; this is *not* a full + /// standalone compile, but can significantly boost performance + /// while allowing additional types to be added. + /// + /// An in-place compile can access non-public types / members + public void CompileInPlace() + { + serializer = CompiledSerializer.Wrap(Serializer, model); + } +#endif + + internal bool IsDefined(int fieldNumber) + { + foreach (ValueMember field in fields) + { + if (field.FieldNumber == fieldNumber) return true; + } + return false; + } + + internal int GetKey(bool demand, bool getBaseKey) + { + return model.GetKey(type, demand, getBaseKey); + } + + internal EnumSerializer.EnumPair[] GetEnumMap() + { + if (HasFlag(OPTIONS_EnumPassThru)) return null; + EnumSerializer.EnumPair[] result = new EnumSerializer.EnumPair[fields.Count]; + for (int i = 0; i < result.Length; i++) + { + ValueMember member = (ValueMember)fields[i]; + int wireValue = member.FieldNumber; + object value = member.GetRawEnumValue(); + result[i] = new EnumSerializer.EnumPair(wireValue, value, member.MemberType); + } + return result; + } + + /// + /// Gets or sets a value indicating that an enum should be treated directly as an int/short/etc, rather + /// than enforcing .proto enum rules. This is useful *in particul* for [Flags] enums. + /// + public bool EnumPassthru + { + get { return HasFlag(OPTIONS_EnumPassThru); } + set { SetFlag(OPTIONS_EnumPassThru, value, true); } + } + + /// + /// Gets or sets a value indicating that this type should NOT be treated as a list, even if it has + /// familiar list-like characteristics (enumerable, add, etc) + /// + public bool IgnoreListHandling + { + get { return HasFlag(OPTIONS_IgnoreListHandling); } + set { SetFlag(OPTIONS_IgnoreListHandling, value, true); } + } + + internal bool Pending + { + get { return HasFlag(OPTIONS_Pending); } + set { SetFlag(OPTIONS_Pending, value, false); } + } + + private const ushort + OPTIONS_Pending = 1, + OPTIONS_EnumPassThru = 2, + OPTIONS_Frozen = 4, + OPTIONS_PrivateOnApi = 8, + OPTIONS_SkipConstructor = 16, + OPTIONS_AsReferenceDefault = 32, + OPTIONS_AutoTuple = 64, + OPTIONS_IgnoreListHandling = 128, + OPTIONS_IsGroup = 256; + + private volatile ushort flags; + private bool HasFlag(ushort flag) { return (flags & flag) == flag; } + private void SetFlag(ushort flag, bool value, bool throwIfFrozen) + { + if (throwIfFrozen && HasFlag(flag) != value) + { + ThrowIfFrozen(); + } + if (value) + flags |= flag; + else + flags = (ushort)(flags & ~flag); + } + + internal static MetaType GetRootType(MetaType source) + { + while (source.serializer != null) + { + MetaType tmp = source.baseType; + if (tmp == null) return source; + source = tmp; // else loop until we reach something that isn't generated, or is the root + } + + // now we get into uncertain territory + RuntimeTypeModel model = source.model; + int opaqueToken = 0; + try + { + model.TakeLock(ref opaqueToken); + + MetaType tmp; + while ((tmp = source.baseType) != null) source = tmp; + return source; + + } + finally + { + model.ReleaseLock(opaqueToken); + } + } + + internal bool IsPrepared() + { +#if FEAT_COMPILER + return serializer is CompiledSerializer; +#else + return false; +#endif + } + + internal IEnumerable Fields => this.fields; + + internal static StringBuilder NewLine(StringBuilder builder, int indent) + { + return Helpers.AppendLine(builder).Append(' ', indent * 3); + } + + internal bool IsAutoTuple => HasFlag(OPTIONS_AutoTuple); + + /// + /// Indicates whether this type should always be treated as a "group" (rather than a string-prefixed sub-message) + /// + public bool IsGroup + { + get { return HasFlag(OPTIONS_IsGroup); } + set { SetFlag(OPTIONS_IsGroup, value, true); } + } + + internal void WriteSchema(StringBuilder builder, int indent, ref RuntimeTypeModel.CommonImports imports, ProtoSyntax syntax) + { + if (surrogate != null) return; // nothing to write + + ValueMember[] fieldsArr = new ValueMember[fields.Count]; + fields.CopyTo(fieldsArr, 0); + Array.Sort(fieldsArr, ValueMember.Comparer.Default); + + if (IsList) + { + string itemTypeName = model.GetSchemaTypeName(TypeModel.GetListItemType(model, type), DataFormat.Default, false, false, ref imports); + NewLine(builder, indent).Append("message ").Append(GetSchemaTypeName()).Append(" {"); + NewLine(builder, indent + 1).Append("repeated ").Append(itemTypeName).Append(" items = 1;"); + NewLine(builder, indent).Append('}'); + } + else if (IsAutoTuple) + { // key-value-pair etc + + if (ResolveTupleConstructor(type, out MemberInfo[] mapping) != null) + { + NewLine(builder, indent).Append("message ").Append(GetSchemaTypeName()).Append(" {"); + for (int i = 0; i < mapping.Length; i++) + { + Type effectiveType; + if (mapping[i] is PropertyInfo property) + { + effectiveType = property.PropertyType; + } + else if (mapping[i] is FieldInfo field) + { + effectiveType = field.FieldType; + } + else + { + throw new NotSupportedException("Unknown member type: " + mapping[i].GetType().Name); + } + NewLine(builder, indent + 1).Append(syntax == ProtoSyntax.Proto2 ? "optional " : "").Append(model.GetSchemaTypeName(effectiveType, DataFormat.Default, false, false, ref imports).Replace('.', '_')) + .Append(' ').Append(mapping[i].Name).Append(" = ").Append(i + 1).Append(';'); + } + NewLine(builder, indent).Append('}'); + } + } + else if (Helpers.IsEnum(type)) + { + NewLine(builder, indent).Append("enum ").Append(GetSchemaTypeName()).Append(" {"); + if (fieldsArr.Length == 0 && EnumPassthru) + { + if (type +#if COREFX || PROFILE259 + .GetTypeInfo() +#endif +.IsDefined(model.MapType(typeof(FlagsAttribute)), false)) + { + NewLine(builder, indent + 1).Append("// this is a composite/flags enumeration"); + } + else + { + NewLine(builder, indent + 1).Append("// this enumeration will be passed as a raw value"); + } + foreach (FieldInfo field in +#if PROFILE259 + type.GetRuntimeFields() +#else + type.GetFields() +#endif + + ) + { + if (field.IsStatic && field.IsLiteral) + { + object enumVal; +#if PORTABLE || CF || NETSTANDARD1_3 || NETSTANDARD1_4 || PROFILE259 || UAP + enumVal = Convert.ChangeType(field.GetValue(null), Enum.GetUnderlyingType(field.FieldType), System.Globalization.CultureInfo.InvariantCulture); +#else + enumVal = field.GetRawConstantValue(); +#endif + NewLine(builder, indent + 1).Append(field.Name).Append(" = ").Append(enumVal).Append(";"); + } + } + + } + else + { + Dictionary countByField = new Dictionary(fieldsArr.Length); + bool needsAlias = false; + foreach (var field in fieldsArr) + { + if (countByField.ContainsKey(field.FieldNumber)) + { // no point actually counting; that's enough to know we have a problem + needsAlias = true; + break; + } + countByField.Add(field.FieldNumber, 1); + } + if (needsAlias) + { // duplicated value requires allow_alias + NewLine(builder, indent + 1).Append("option allow_alias = true;"); + } + + bool haveWrittenZero = false; + // write zero values **first** + foreach (ValueMember member in fieldsArr) + { + if (member.FieldNumber == 0) + { + NewLine(builder, indent + 1).Append(member.Name).Append(" = ").Append(member.FieldNumber).Append(';'); + haveWrittenZero = true; + } + } + if (syntax == ProtoSyntax.Proto3 && !haveWrittenZero) + { + NewLine(builder, indent + 1).Append("ZERO = 0; // proto3 requires a zero value as the first item (it can be named anything)"); + } + // note array is already sorted, so zero would already be first + foreach (ValueMember member in fieldsArr) + { + if (member.FieldNumber == 0) continue; + NewLine(builder, indent + 1).Append(member.Name).Append(" = ").Append(member.FieldNumber).Append(';'); + } + } + NewLine(builder, indent).Append('}'); + } + else + { + NewLine(builder, indent).Append("message ").Append(GetSchemaTypeName()).Append(" {"); + foreach (ValueMember member in fieldsArr) + { + string schemaTypeName; + bool hasOption = false; + if (member.IsMap) + { + member.ResolveMapTypes(out var _, out var keyType, out var valueType); + + var keyTypeName = model.GetSchemaTypeName(keyType, member.MapKeyFormat, false, false, ref imports); + schemaTypeName = model.GetSchemaTypeName(valueType, member.MapKeyFormat, member.AsReference, member.DynamicType, ref imports); + NewLine(builder, indent + 1).Append("map<").Append(keyTypeName).Append(",").Append(schemaTypeName).Append("> ") + .Append(member.Name).Append(" = ").Append(member.FieldNumber).Append(";"); + } + else + { + string ordinality = member.ItemType != null ? "repeated " : (syntax == ProtoSyntax.Proto2 ? (member.IsRequired ? "required " : "optional ") : ""); + NewLine(builder, indent + 1).Append(ordinality); + if (member.DataFormat == DataFormat.Group) builder.Append("group "); + schemaTypeName = member.GetSchemaTypeName(true, ref imports); + builder.Append(schemaTypeName).Append(" ") + .Append(member.Name).Append(" = ").Append(member.FieldNumber); + + if (syntax == ProtoSyntax.Proto2 && member.DefaultValue != null && member.IsRequired == false) + { + if (member.DefaultValue is string) + { + AddOption(builder, ref hasOption).Append("default = \"").Append(member.DefaultValue).Append("\""); + } + else if (member.DefaultValue is TimeSpan) + { + // ignore + } + else if (member.DefaultValue is bool) + { // need to be lower case (issue 304) + AddOption(builder, ref hasOption).Append((bool)member.DefaultValue ? "default = true" : "default = false"); + } + else + { + AddOption(builder, ref hasOption).Append("default = ").Append(member.DefaultValue); + } + } + if (CanPack(member.ItemType)) + { + if (syntax == ProtoSyntax.Proto2) + { + if (member.IsPacked) AddOption(builder, ref hasOption).Append("packed = true"); // disabled by default + } + else + { + if (!member.IsPacked) AddOption(builder, ref hasOption).Append("packed = false"); // enabled by default + } + } + if (member.AsReference) + { + imports |= RuntimeTypeModel.CommonImports.Protogen; + AddOption(builder, ref hasOption).Append("(.protobuf_net.fieldopt).asRef = true"); + } + if (member.DynamicType) + { + imports |= RuntimeTypeModel.CommonImports.Protogen; + AddOption(builder, ref hasOption).Append("(.protobuf_net.fieldopt).dynamicType = true"); + } + CloseOption(builder, ref hasOption).Append(';'); + if (syntax != ProtoSyntax.Proto2 && member.DefaultValue != null && !member.IsRequired) + { + if (IsImplicitDefault(member.DefaultValue)) + { + // don't emit; we're good + } + else + { + builder.Append(" // default value could not be applied: ").Append(member.DefaultValue); + } + } + } + if (schemaTypeName == ".bcl.NetObjectProxy" && member.AsReference && !member.DynamicType) // we know what it is; tell the user + { + builder.Append(" // reference-tracked ").Append(member.GetSchemaTypeName(false, ref imports)); + } + } + if (subTypes != null && subTypes.Count != 0) + { + SubType[] subTypeArr = new SubType[subTypes.Count]; + subTypes.CopyTo(subTypeArr, 0); + Array.Sort(subTypeArr, SubType.Comparer.Default); + string[] fieldNames = new string[subTypeArr.Length]; + for(int i = 0; i < subTypeArr.Length;i++) + fieldNames[i] = subTypeArr[i].DerivedType.GetSchemaTypeName(); + + string fieldName = "subtype"; + while (Array.IndexOf(fieldNames, fieldName) >= 0) + fieldName = "_" + fieldName; + + NewLine(builder, indent + 1).Append("oneof ").Append(fieldName).Append(" {"); + for(int i = 0; i < subTypeArr.Length; i++) + { + var subTypeName = fieldNames[i]; + NewLine(builder, indent + 2).Append(subTypeName) + .Append(" ").Append(subTypeName).Append(" = ").Append(subTypeArr[i].FieldNumber).Append(';'); + } + NewLine(builder, indent + 1).Append("}"); + } + NewLine(builder, indent).Append('}'); + } + } + + private static StringBuilder AddOption(StringBuilder builder, ref bool hasOption) + { + if (hasOption) + return builder.Append(", "); + hasOption = true; + return builder.Append(" ["); + } + + private static StringBuilder CloseOption(StringBuilder builder, ref bool hasOption) + { + if (hasOption) + { + hasOption = false; + return builder.Append("]"); + } + return builder; + } + + private static bool IsImplicitDefault(object value) + { + try + { + if (value == null) return false; + switch (Helpers.GetTypeCode(value.GetType())) + { + case ProtoTypeCode.Boolean: return ((bool)value) == false; + case ProtoTypeCode.Byte: return ((byte)value) == (byte)0; + case ProtoTypeCode.Char: return ((char)value) == (char)0; + case ProtoTypeCode.DateTime: return ((DateTime)value) == default; + case ProtoTypeCode.Decimal: return ((decimal)value) == 0M; + case ProtoTypeCode.Double: return ((double)value) == (double)0; + case ProtoTypeCode.Int16: return ((short)value) == (short)0; + case ProtoTypeCode.Int32: return ((int)value) == (int)0; + case ProtoTypeCode.Int64: return ((long)value) == (long)0; + case ProtoTypeCode.SByte: return ((sbyte)value) == (sbyte)0; + case ProtoTypeCode.Single: return ((float)value) == (float)0; + case ProtoTypeCode.String: return ((string)value) == ""; + case ProtoTypeCode.TimeSpan: return ((TimeSpan)value) == TimeSpan.Zero; + case ProtoTypeCode.UInt16: return ((ushort)value) == (ushort)0; + case ProtoTypeCode.UInt32: return ((uint)value) == (uint)0; + case ProtoTypeCode.UInt64: return ((ulong)value) == (ulong)0; + } + } + catch { } + return false; + } + + private static bool CanPack(Type type) + { + if (type == null) return false; + switch (Helpers.GetTypeCode(type)) + { + case ProtoTypeCode.Boolean: + case ProtoTypeCode.Byte: + case ProtoTypeCode.Char: + case ProtoTypeCode.Double: + case ProtoTypeCode.Int16: + case ProtoTypeCode.Int32: + case ProtoTypeCode.Int64: + case ProtoTypeCode.SByte: + case ProtoTypeCode.Single: + case ProtoTypeCode.UInt16: + case ProtoTypeCode.UInt32: + case ProtoTypeCode.UInt64: + return true; + } + return false; + } + + /// + /// Apply a shift to all fields (and sub-types) on this type + /// + /// The change in field number to apply + /// The resultant field numbers must still all be considered valid +#if !(NETSTANDARD1_0 || NETSTANDARD1_3 || UAP) + [System.ComponentModel.Browsable(false)] +#endif + [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)] + public void ApplyFieldOffset(int offset) + { + if (Helpers.IsEnum(type)) throw new InvalidOperationException("Cannot apply field-offset to an enum"); + if (offset == 0) return; // nothing to do + int opaqueToken = 0; + try + { + model.TakeLock(ref opaqueToken); + ThrowIfFrozen(); + + if (fields != null) + { + foreach(ValueMember field in fields) + AssertValidFieldNumber(field.FieldNumber + offset); + } + if (subTypes != null) + { + foreach (SubType subType in subTypes) + AssertValidFieldNumber(subType.FieldNumber + offset); + } + + // we've checked the ranges are all OK; since we're moving everything, we can't overlap ourselves + // so: we can just move + if (fields != null) + { + foreach (ValueMember field in fields) + field.FieldNumber += offset; + } + if (subTypes != null) + { + foreach (SubType subType in subTypes) + subType.FieldNumber += offset; + } + } + finally + { + model.ReleaseLock(opaqueToken); + } + } + + internal static void AssertValidFieldNumber(int fieldNumber) + { + if (fieldNumber < 1) throw new ArgumentOutOfRangeException(nameof(fieldNumber)); + } + } +} +#endif diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/ProtoSyntax.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/ProtoSyntax.cs new file mode 100644 index 0000000..ab90d5b --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/ProtoSyntax.cs @@ -0,0 +1,17 @@ +namespace ProtoBuf.Meta +{ + /// + /// Indiate the variant of the protobuf .proto DSL syntax to use + /// + public enum ProtoSyntax + { + /// + /// https://developers.google.com/protocol-buffers/docs/proto + /// + Proto2 = 0, + /// + /// https://developers.google.com/protocol-buffers/docs/proto3 + /// + Proto3 = 1, + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/RuntimeTypeModel.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/RuntimeTypeModel.cs new file mode 100644 index 0000000..05dfcf1 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/RuntimeTypeModel.cs @@ -0,0 +1,2036 @@ +#if !NO_RUNTIME +using System; +using System.Collections; +using System.Text; +using System.Reflection; +#if FEAT_COMPILER +using System.Reflection.Emit; +#endif + +using ProtoBuf.Serializers; +using System.Threading; +using System.IO; +using System.Diagnostics; +using System.Runtime.CompilerServices; + +namespace ProtoBuf.Meta +{ + /// + /// Provides protobuf serialization support for a number of types that can be defined at runtime + /// + public sealed class RuntimeTypeModel : TypeModel + { + private ushort options; + private const ushort + OPTIONS_InferTagFromNameDefault = 1, + OPTIONS_IsDefaultModel = 2, + OPTIONS_Frozen = 4, + OPTIONS_AutoAddMissingTypes = 8, +#if FEAT_COMPILER + OPTIONS_AutoCompile = 16, +#endif + OPTIONS_UseImplicitZeroDefaults = 32, + OPTIONS_AllowParseableTypes = 64, + OPTIONS_AutoAddProtoContractTypesOnly = 128, + OPTIONS_IncludeDateTimeKind = 256, + OPTIONS_DoNotInternStrings = 512; + + private bool GetOption(ushort option) + { + return (options & option) == option; + } + + private void SetOption(ushort option, bool value) + { + if (value) options |= option; + else options &= (ushort)~option; + } + + /// + /// Global default that + /// enables/disables automatic tag generation based on the existing name / order + /// of the defined members. See + /// for usage and important warning / explanation. + /// You must set the global default before attempting to serialize/deserialize any + /// impacted type. + /// + public bool InferTagFromNameDefault + { + get { return GetOption(OPTIONS_InferTagFromNameDefault); } + set { SetOption(OPTIONS_InferTagFromNameDefault, value); } + } + + /// + /// Global default that determines whether types are considered serializable + /// if they have [DataContract] / [XmlType]. With this enabled, ONLY + /// types marked as [ProtoContract] are added automatically. + /// + public bool AutoAddProtoContractTypesOnly + { + get { return GetOption(OPTIONS_AutoAddProtoContractTypesOnly); } + set { SetOption(OPTIONS_AutoAddProtoContractTypesOnly, value); } + } + + /// + /// Global switch that enables or disables the implicit + /// handling of "zero defaults"; meanning: if no other default is specified, + /// it assumes bools always default to false, integers to zero, etc. + /// + /// If this is disabled, no such assumptions are made and only *explicit* + /// default values are processed. This is enabled by default to + /// preserve similar logic to v1. + /// + public bool UseImplicitZeroDefaults + { + get { return GetOption(OPTIONS_UseImplicitZeroDefaults); } + set + { + if (!value && GetOption(OPTIONS_IsDefaultModel)) + { + throw new InvalidOperationException("UseImplicitZeroDefaults cannot be disabled on the default model"); + } + SetOption(OPTIONS_UseImplicitZeroDefaults, value); + } + } + + /// + /// Global switch that determines whether types with a .ToString() and a Parse(string) + /// should be serialized as strings. + /// + public bool AllowParseableTypes + { + get { return GetOption(OPTIONS_AllowParseableTypes); } + set { SetOption(OPTIONS_AllowParseableTypes, value); } + } + + /// + /// Global switch that determines whether DateTime serialization should include the Kind of the date/time. + /// + public bool IncludeDateTimeKind + { + get { return GetOption(OPTIONS_IncludeDateTimeKind); } + set { SetOption(OPTIONS_IncludeDateTimeKind, value); } + } + + /// + /// Global switch that determines whether a single instance of the same string should be used during deserialization. + /// + /// Note this does not use the global .NET string interner + public bool InternStrings + { + get { return !GetOption(OPTIONS_DoNotInternStrings); } + set { SetOption(OPTIONS_DoNotInternStrings, !value); } + } + + /// + /// Should the Kind be included on date/time values? + /// + protected internal override bool SerializeDateTimeKind() + { + return GetOption(OPTIONS_IncludeDateTimeKind); + } + + private sealed class Singleton + { + private Singleton() { } + internal static readonly RuntimeTypeModel Value = new RuntimeTypeModel(true); + } + + /// + /// The default model, used to support ProtoBuf.Serializer + /// + public static RuntimeTypeModel Default => Singleton.Value; + + /// + /// Returns a sequence of the Type instances that can be + /// processed by this model. + /// + public IEnumerable GetTypes() => types; + + /// + /// Suggest a .proto definition for the given type + /// + /// The type to generate a .proto definition for, or null to generate a .proto that represents the entire model + /// The .proto definition as a string + /// The .proto syntax to use + public override string GetSchema(Type type, ProtoSyntax syntax) + { + BasicList requiredTypes = new BasicList(); + MetaType primaryType = null; + bool isInbuiltType = false; + if (type == null) + { // generate for the entire model + foreach (MetaType meta in types) + { + MetaType tmp = meta.GetSurrogateOrBaseOrSelf(false); + if (!requiredTypes.Contains(tmp)) + { // ^^^ note that the type might have been added as a descendent + requiredTypes.Add(tmp); + CascadeDependents(requiredTypes, tmp); + } + } + } + else + { + Type tmp = Helpers.GetUnderlyingType(type); + if (tmp != null) type = tmp; + + WireType defaultWireType; + isInbuiltType = (ValueMember.TryGetCoreSerializer(this, DataFormat.Default, type, out defaultWireType, false, false, false, false) != null); + if (!isInbuiltType) + { + //Agenerate just relative to the supplied type + int index = FindOrAddAuto(type, false, false, false); + if (index < 0) throw new ArgumentException("The type specified is not a contract-type", "type"); + + // get the required types + primaryType = ((MetaType)types[index]).GetSurrogateOrBaseOrSelf(false); + requiredTypes.Add(primaryType); + CascadeDependents(requiredTypes, primaryType); + } + } + + // use the provided type's namespace for the "package" + StringBuilder headerBuilder = new StringBuilder(); + string package = null; + + if (!isInbuiltType) + { + IEnumerable typesForNamespace = primaryType == null ? types : requiredTypes; + foreach (MetaType meta in typesForNamespace) + { + if (meta.IsList) continue; + string tmp = meta.Type.Namespace; + if (!string.IsNullOrEmpty(tmp)) + { + if (tmp.StartsWith("System.")) continue; + if (package == null) + { // haven't seen any suggestions yet + package = tmp; + } + else if (package == tmp) + { // that's fine; a repeat of the one we already saw + } + else + { // something else; have confliucting suggestions; abort + package = null; + break; + } + } + } + } + switch (syntax) + { + case ProtoSyntax.Proto2: + headerBuilder.AppendLine(@"syntax = ""proto2"";"); + break; + case ProtoSyntax.Proto3: + headerBuilder.AppendLine(@"syntax = ""proto3"";"); + break; + default: + throw new ArgumentOutOfRangeException(nameof(syntax)); + } + + if (!string.IsNullOrEmpty(package)) + { + headerBuilder.Append("package ").Append(package).Append(';'); + Helpers.AppendLine(headerBuilder); + } + + var imports = CommonImports.None; + StringBuilder bodyBuilder = new StringBuilder(); + // sort them by schema-name + MetaType[] metaTypesArr = new MetaType[requiredTypes.Count]; + requiredTypes.CopyTo(metaTypesArr, 0); + Array.Sort(metaTypesArr, MetaType.Comparer.Default); + + // write the messages + if (isInbuiltType) + { + Helpers.AppendLine(bodyBuilder).Append("message ").Append(type.Name).Append(" {"); + MetaType.NewLine(bodyBuilder, 1).Append(syntax == ProtoSyntax.Proto2 ? "optional " : "").Append(GetSchemaTypeName(type, DataFormat.Default, false, false, ref imports)) + .Append(" value = 1;"); + Helpers.AppendLine(bodyBuilder).Append('}'); + } + else + { + for (int i = 0; i < metaTypesArr.Length; i++) + { + MetaType tmp = metaTypesArr[i]; + if (tmp.IsList && tmp != primaryType) continue; + tmp.WriteSchema(bodyBuilder, 0, ref imports, syntax); + } + } + if ((imports & CommonImports.Bcl) != 0) + { + headerBuilder.Append("import \"protobuf-net/bcl.proto\"; // schema for protobuf-net's handling of core .NET types"); + Helpers.AppendLine(headerBuilder); + } + if ((imports & CommonImports.Protogen) != 0) + { + headerBuilder.Append("import \"protobuf-net/protogen.proto\"; // custom protobuf-net options"); + Helpers.AppendLine(headerBuilder); + } + if ((imports & CommonImports.Timestamp) != 0) + { + headerBuilder.Append("import \"google/protobuf/timestamp.proto\";"); + Helpers.AppendLine(headerBuilder); + } + if ((imports & CommonImports.Duration) != 0) + { + headerBuilder.Append("import \"google/protobuf/duration.proto\";"); + Helpers.AppendLine(headerBuilder); + } + return Helpers.AppendLine(headerBuilder.Append(bodyBuilder)).ToString(); + } + [Flags] + internal enum CommonImports + { + None = 0, + Bcl = 1, + Timestamp = 2, + Duration = 4, + Protogen = 8 + } + private void CascadeDependents(BasicList list, MetaType metaType) + { + MetaType tmp; + if (metaType.IsList) + { + Type itemType = TypeModel.GetListItemType(this, metaType.Type); + TryGetCoreSerializer(list, itemType); + } + else + { + if (metaType.IsAutoTuple) + { + MemberInfo[] mapping; + if (MetaType.ResolveTupleConstructor(metaType.Type, out mapping) != null) + { + for (int i = 0; i < mapping.Length; i++) + { + Type type = null; + if (mapping[i] is PropertyInfo) type = ((PropertyInfo)mapping[i]).PropertyType; + else if (mapping[i] is FieldInfo) type = ((FieldInfo)mapping[i]).FieldType; + TryGetCoreSerializer(list, type); + } + } + } + else + { + foreach (ValueMember member in metaType.Fields) + { + Type type = member.ItemType; + if (member.IsMap) + { + member.ResolveMapTypes(out _, out _, out type); // don't need key-type + } + if (type == null) type = member.MemberType; + TryGetCoreSerializer(list, type); + } + } + foreach (var genericArgument in metaType.GetAllGenericArguments()) + { + TryGetCoreSerializer(list, genericArgument); + } + if (metaType.HasSubtypes) + { + foreach (SubType subType in metaType.GetSubtypes()) + { + tmp = subType.DerivedType.GetSurrogateOrSelf(); // note: exclude base-types! + if (!list.Contains(tmp)) + { + list.Add(tmp); + CascadeDependents(list, tmp); + } + } + } + tmp = metaType.BaseType; + if (tmp != null) tmp = tmp.GetSurrogateOrSelf(); // note: already walking base-types; exclude base + if (tmp != null && !list.Contains(tmp)) + { + list.Add(tmp); + CascadeDependents(list, tmp); + } + } + } + + private void TryGetCoreSerializer(BasicList list, Type itemType) + { + var coreSerializer = ValueMember.TryGetCoreSerializer(this, DataFormat.Default, itemType, out _, false, false, false, false); + if (coreSerializer != null) + { + return; + } + int index = FindOrAddAuto(itemType, false, false, false); + if (index < 0) + { + return; + } + var temp = ((MetaType)types[index]).GetSurrogateOrBaseOrSelf(false); + if (list.Contains(temp)) + { + return; + } + // could perhaps also implement as a queue, but this should work OK for sane models + list.Add(temp); + CascadeDependents(list, temp); + } + +#if !NO_RUNTIME + /// + /// Creates a new runtime model, to which the caller + /// can add support for a range of types. A model + /// can be used "as is", or can be compiled for + /// optimal performance. + /// + /// not used currently; this is for compatibility with v3 +#pragma warning disable IDE0060 // Remove unused parameter + public static RuntimeTypeModel Create(string name = null) +#pragma warning restore IDE0060 // Remove unused parameter + { + return new RuntimeTypeModel(false); + } +#endif + + private RuntimeTypeModel(bool isDefault) + { + AutoAddMissingTypes = true; + UseImplicitZeroDefaults = true; + SetOption(OPTIONS_IsDefaultModel, isDefault); +#if FEAT_COMPILER && !DEBUG + try + { + AutoCompile = EnableAutoCompile(); + } + catch { } // this is all kinds of brittle on things like UWP +#endif + } + +#if FEAT_COMPILER + [MethodImpl(MethodImplOptions.NoInlining)] + internal static bool EnableAutoCompile() + { + try + { + var dm = new DynamicMethod("CheckCompilerAvailable", typeof(bool), new Type[] { typeof(int) }); + var il = dm.GetILGenerator(); + il.Emit(OpCodes.Ldarg_0); + il.Emit(OpCodes.Ldc_I4, 42); + il.Emit(OpCodes.Ceq); + il.Emit(OpCodes.Ret); + var func = (Predicate)dm.CreateDelegate(typeof(Predicate)); + return func(42); + } + catch (Exception ex) + { + Debug.WriteLine(ex); + return false; + } + } +#endif + + /// + /// Obtains the MetaType associated with a given Type for the current model, + /// allowing additional configuration. + /// + public MetaType this[Type type] { get { return (MetaType)types[FindOrAddAuto(type, true, false, false)]; } } + + internal MetaType FindWithoutAdd(Type type) + { + // this list is thread-safe for reading + foreach (MetaType metaType in types) + { + if (metaType.Type == type) + { + if (metaType.Pending) WaitOnLock(metaType); + return metaType; + } + } + // if that failed, check for a proxy + Type underlyingType = ResolveProxies(type); + return underlyingType == null ? null : FindWithoutAdd(underlyingType); + } + + static readonly BasicList.MatchPredicate + MetaTypeFinder = new BasicList.MatchPredicate(MetaTypeFinderImpl), + BasicTypeFinder = new BasicList.MatchPredicate(BasicTypeFinderImpl); + + static bool MetaTypeFinderImpl(object value, object ctx) + { + return ((MetaType)value).Type == (Type)ctx; + } + + static bool BasicTypeFinderImpl(object value, object ctx) + { + return ((BasicType)value).Type == (Type)ctx; + } + + private void WaitOnLock(MetaType type) + { + int opaqueToken = 0; + try + { + TakeLock(ref opaqueToken); + } + finally + { + ReleaseLock(opaqueToken); + } + } + + BasicList basicTypes = new BasicList(); + + sealed class BasicType + { + private readonly Type type; + public Type Type => type; + private readonly IProtoSerializer serializer; + public IProtoSerializer Serializer => serializer; + + public BasicType(Type type, IProtoSerializer serializer) + { + this.type = type; + this.serializer = serializer; + } + } + internal IProtoSerializer TryGetBasicTypeSerializer(Type type) + { + int idx = basicTypes.IndexOf(BasicTypeFinder, type); + + if (idx >= 0) return ((BasicType)basicTypes[idx]).Serializer; + + lock (basicTypes) + { // don't need a full model lock for this + + // double-checked + idx = basicTypes.IndexOf(BasicTypeFinder, type); + if (idx >= 0) return ((BasicType)basicTypes[idx]).Serializer; + + MetaType.AttributeFamily family = MetaType.GetContractFamily(this, type, null); + IProtoSerializer ser = family == MetaType.AttributeFamily.None + ? ValueMember.TryGetCoreSerializer(this, DataFormat.Default, type, out WireType defaultWireType, false, false, false, false) + : null; + + if (ser != null) basicTypes.Add(new BasicType(type, ser)); + return ser; + } + } + + internal int FindOrAddAuto(Type type, bool demand, bool addWithContractOnly, bool addEvenIfAutoDisabled) + { + int key = types.IndexOf(MetaTypeFinder, type); + MetaType metaType; + + // the fast happy path: meta-types we've already seen + if (key >= 0) + { + metaType = (MetaType)types[key]; + if (metaType.Pending) + { + WaitOnLock(metaType); + } + return key; + } + + // the fast fail path: types that will never have a meta-type + bool shouldAdd = AutoAddMissingTypes || addEvenIfAutoDisabled; + + if (!Helpers.IsEnum(type) && TryGetBasicTypeSerializer(type) != null) + { + if (shouldAdd && !addWithContractOnly) throw MetaType.InbuiltType(type); + return -1; // this will never be a meta-type + } + + // otherwise: we don't yet know + + // check for proxy types + Type underlyingType = ResolveProxies(type); + if (underlyingType != null && underlyingType != type) + { + key = types.IndexOf(MetaTypeFinder, underlyingType); + type = underlyingType; // if new added, make it reflect the underlying type + } + + if (key < 0) + { + int opaqueToken = 0; + Type origType = type; + bool weAdded = false; + try + { + TakeLock(ref opaqueToken); + // try to recognise a few familiar patterns... + if ((metaType = RecogniseCommonTypes(type)) == null) + { // otherwise, check if it is a contract + MetaType.AttributeFamily family = MetaType.GetContractFamily(this, type, null); + if (family == MetaType.AttributeFamily.AutoTuple) + { + shouldAdd = addEvenIfAutoDisabled = true; // always add basic tuples, such as KeyValuePair + } + + if (!shouldAdd || ( + !Helpers.IsEnum(type) && addWithContractOnly && family == MetaType.AttributeFamily.None) + ) + { + if (demand) ThrowUnexpectedType(type); + return key; + } + metaType = Create(type); + } + + metaType.Pending = true; + + // double-checked + int winner = types.IndexOf(MetaTypeFinder, type); + if (winner < 0) + { + ThrowIfFrozen(); + key = types.Add(metaType); + weAdded = true; + } + else + { + key = winner; + } + if (weAdded) + { + metaType.ApplyDefaultBehaviour(); + metaType.Pending = false; + } + } + finally + { + ReleaseLock(opaqueToken); + if (weAdded) + { + ResetKeyCache(); + } + } + } + return key; + } + + private MetaType RecogniseCommonTypes(Type type) + { + // if (type.IsGenericType && type.GetGenericTypeDefinition() == typeof(System.Collections.Generic.KeyValuePair<,>)) + // { + // MetaType mt = new MetaType(this, type); + + // Type surrogate = typeof (KeyValuePairSurrogate<,>).MakeGenericType(type.GetGenericArguments()); + + // mt.SetSurrogate(surrogate); + // mt.IncludeSerializerMethod = false; + // mt.Freeze(); + + // MetaType surrogateMeta = (MetaType)types[FindOrAddAuto(surrogate, true, true, true)]; // this forcibly adds it if needed + // if(surrogateMeta.IncludeSerializerMethod) + // { // don't blindly set - it might be frozen + // surrogateMeta.IncludeSerializerMethod = false; + // } + // surrogateMeta.Freeze(); + // return mt; + // } + return null; + } + private MetaType Create(Type type) + { + ThrowIfFrozen(); + return new MetaType(this, type, defaultFactory); + } + + /// + /// Adds support for an additional type in this model, optionally + /// applying inbuilt patterns. If the type is already known to the + /// model, the existing type is returned **without** applying + /// any additional behaviour. + /// + /// Inbuilt patterns include: + /// [ProtoContract]/[ProtoMember(n)] + /// [DataContract]/[DataMember(Order=n)] + /// [XmlType]/[XmlElement(Order=n)] + /// [On{Des|S}erializ{ing|ed}] + /// ShouldSerialize*/*Specified + /// + /// The type to be supported + /// Whether to apply the inbuilt configuration patterns (via attributes etc), or + /// just add the type with no additional configuration (the type must then be manually configured). + /// The MetaType representing this type, allowing + /// further configuration. + public MetaType Add(Type type, bool applyDefaultBehaviour) + { + if (type == null) throw new ArgumentNullException("type"); + MetaType newType = FindWithoutAdd(type); + if (newType != null) return newType; // return existing + int opaqueToken = 0; + +#if COREFX || PROFILE259 + TypeInfo typeInfo = IntrospectionExtensions.GetTypeInfo(type); + if (typeInfo.IsInterface && MetaType.ienumerable.IsAssignableFrom(typeInfo) +#else + if (type.IsInterface && MapType(MetaType.ienumerable).IsAssignableFrom(type) +#endif + && GetListItemType(this, type) == null) + { + throw new ArgumentException("IEnumerable[] data cannot be used as a meta-type unless an Add method can be resolved"); + } + try + { + newType = RecogniseCommonTypes(type); + if (newType != null) + { + if (!applyDefaultBehaviour) + { + throw new ArgumentException( + "Default behaviour must be observed for certain types with special handling; " + type.FullName, + "applyDefaultBehaviour"); + } + // we should assume that type is fully configured, though; no need to re-run: + applyDefaultBehaviour = false; + } + if (newType == null) newType = Create(type); + newType.Pending = true; + TakeLock(ref opaqueToken); + // double checked + if (FindWithoutAdd(type) != null) throw new ArgumentException("Duplicate type", "type"); + ThrowIfFrozen(); + types.Add(newType); + if (applyDefaultBehaviour) { newType.ApplyDefaultBehaviour(); } + newType.Pending = false; + } + finally + { + ReleaseLock(opaqueToken); + ResetKeyCache(); + } + + return newType; + } + +#if FEAT_COMPILER + /// + /// Should serializers be compiled on demand? It may be useful + /// to disable this for debugging purposes. + /// + public bool AutoCompile + { + get { return GetOption(OPTIONS_AutoCompile); } + set { SetOption(OPTIONS_AutoCompile, value); } + } +#endif + /// + /// Should support for unexpected types be added automatically? + /// If false, an exception is thrown when unexpected types + /// are encountered. + /// + public bool AutoAddMissingTypes + { + get { return GetOption(OPTIONS_AutoAddMissingTypes); } + set + { + if (!value && GetOption(OPTIONS_IsDefaultModel)) + { + throw new InvalidOperationException("The default model must allow missing types"); + } + ThrowIfFrozen(); + SetOption(OPTIONS_AutoAddMissingTypes, value); + } + } + /// + /// Verifies that the model is still open to changes; if not, an exception is thrown + /// + private void ThrowIfFrozen() + { + if (GetOption(OPTIONS_Frozen)) throw new InvalidOperationException("The model cannot be changed once frozen"); + } + + /// + /// Prevents further changes to this model + /// + public void Freeze() + { + if (GetOption(OPTIONS_IsDefaultModel)) throw new InvalidOperationException("The default model cannot be frozen"); + SetOption(OPTIONS_Frozen, true); + } + + private readonly BasicList types = new BasicList(); + + /// + /// Provides the key that represents a given type in the current model. + /// + protected override int GetKeyImpl(Type type) + { + return GetKey(type, false, true); + } + + internal int GetKey(Type type, bool demand, bool getBaseKey) + { + Helpers.DebugAssert(type != null); + try + { + int typeIndex = FindOrAddAuto(type, demand, true, false); + if (typeIndex >= 0) + { + MetaType mt = (MetaType)types[typeIndex]; + if (getBaseKey) + { + mt = MetaType.GetRootType(mt); + typeIndex = FindOrAddAuto(mt.Type, true, true, false); + } + } + return typeIndex; + } + catch (NotSupportedException) + { + throw; // re-surface "as-is" + } + catch (Exception ex) + { + if (ex.Message.IndexOf(type.FullName) >= 0) throw; // already enough info + throw new ProtoException(ex.Message + " (" + type.FullName + ")", ex); + } + } + + /// + /// Writes a protocol-buffer representation of the given instance to the supplied stream. + /// + /// Represents the type (including inheritance) to consider. + /// The existing instance to be serialized (cannot be null). + /// The destination stream to write to. + protected internal override void Serialize(int key, object value, ProtoWriter dest) + { + //Helpers.DebugWriteLine("Serialize", value); + ((MetaType)types[key]).Serializer.Write(value, dest); + } + + /// + /// Applies a protocol-buffer stream to an existing instance (which may be null). + /// + /// Represents the type (including inheritance) to consider. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + protected internal override object Deserialize(int key, object value, ProtoReader source) + { + //Helpers.DebugWriteLine("Deserialize", value); + IProtoSerializer ser = ((MetaType)types[key]).Serializer; + if (value == null && Helpers.IsValueType(ser.ExpectedType)) + { + if (ser.RequiresOldValue) value = Activator.CreateInstance(ser.ExpectedType); + return ser.Read(value, source); + } + else + { + return ser.Read(value, source); + } + } + +#if FEAT_COMPILER + // this is used by some unit-tests; do not remove + internal Compiler.ProtoSerializer GetSerializer(IProtoSerializer serializer, bool compiled) + { + if (serializer == null) throw new ArgumentNullException("serializer"); +#if FEAT_COMPILER + if (compiled) return Compiler.CompilerContext.BuildSerializer(serializer, this); +#endif + return new Compiler.ProtoSerializer(serializer.Write); + } + + /// + /// Compiles the serializers individually; this is *not* a full + /// standalone compile, but can significantly boost performance + /// while allowing additional types to be added. + /// + /// An in-place compile can access non-public types / members + public void CompileInPlace() + { + foreach (MetaType type in types) + { + type.CompileInPlace(); + } + } + +#endif + //internal override IProtoSerializer GetTypeSerializer(Type type) + //{ // this list is thread-safe for reading + // .Serializer; + //} + //internal override IProtoSerializer GetTypeSerializer(int key) + //{ // this list is thread-safe for reading + // MetaType type = (MetaType)types.TryGet(key); + // if (type != null) return type.Serializer; + // throw new KeyNotFoundException(); + + //} + +#if FEAT_COMPILER + private void BuildAllSerializers() + { + // note that types.Count may increase during this operation, as some serializers + // bring other types into play + for (int i = 0; i < types.Count; i++) + { + // the primary purpose of this is to force the creation of the Serializer + MetaType mt = (MetaType)types[i]; + if (mt.Serializer == null) + throw new InvalidOperationException("No serializer available for " + mt.Type.Name); + } + } + + internal sealed class SerializerPair : IComparable + { + int IComparable.CompareTo(object obj) + { + if (obj == null) throw new ArgumentException("obj"); + SerializerPair other = (SerializerPair)obj; + + // we want to bunch all the items with the same base-type together, but we need the items with a + // different base **first**. + if (this.BaseKey == this.MetaKey) + { + if (other.BaseKey == other.MetaKey) + { // neither is a subclass + return this.MetaKey.CompareTo(other.MetaKey); + } + else + { // "other" (only) is involved in inheritance; "other" should be first + return 1; + } + } + else + { + if (other.BaseKey == other.MetaKey) + { // "this" (only) is involved in inheritance; "this" should be first + return -1; + } + else + { // both are involved in inheritance + int result = this.BaseKey.CompareTo(other.BaseKey); + if (result == 0) result = this.MetaKey.CompareTo(other.MetaKey); + return result; + } + } + } + public readonly int MetaKey, BaseKey; + public readonly MetaType Type; + public readonly MethodBuilder Serialize, Deserialize; + public readonly ILGenerator SerializeBody, DeserializeBody; + public SerializerPair(int metaKey, int baseKey, MetaType type, MethodBuilder serialize, MethodBuilder deserialize, + ILGenerator serializeBody, ILGenerator deserializeBody) + { + this.MetaKey = metaKey; + this.BaseKey = baseKey; + this.Serialize = serialize; + this.Deserialize = deserialize; + this.SerializeBody = serializeBody; + this.DeserializeBody = deserializeBody; + this.Type = type; + } + } + + /// + /// Fully compiles the current model into a static-compiled model instance + /// + /// A full compilation is restricted to accessing public types / members + /// An instance of the newly created compiled type-model + public TypeModel Compile() + { + CompilerOptions options = new CompilerOptions(); + return Compile(options); + } + + static ILGenerator Override(TypeBuilder type, string name) + { + MethodInfo baseMethod = type.BaseType.GetMethod(name, BindingFlags.NonPublic | BindingFlags.Instance); + + ParameterInfo[] parameters = baseMethod.GetParameters(); + Type[] paramTypes = new Type[parameters.Length]; + for (int i = 0; i < paramTypes.Length; i++) + { + paramTypes[i] = parameters[i].ParameterType; + } + MethodBuilder newMethod = type.DefineMethod(baseMethod.Name, + (baseMethod.Attributes & ~MethodAttributes.Abstract) | MethodAttributes.Final, baseMethod.CallingConvention, baseMethod.ReturnType, paramTypes); + ILGenerator il = newMethod.GetILGenerator(); + type.DefineMethodOverride(newMethod, baseMethod); + return il; + } + + /// + /// Represents configuration options for compiling a model to + /// a standalone assembly. + /// + public sealed class CompilerOptions + { + /// + /// Import framework options from an existing type + /// + public void SetFrameworkOptions(MetaType from) + { + if (from == null) throw new ArgumentNullException("from"); + AttributeMap[] attribs = AttributeMap.Create(from.Model, Helpers.GetAssembly(from.Type)); + foreach (AttributeMap attrib in attribs) + { + if (attrib.AttributeType.FullName == "System.Runtime.Versioning.TargetFrameworkAttribute") + { + object tmp; + if (attrib.TryGet("FrameworkName", out tmp)) TargetFrameworkName = (string)tmp; + if (attrib.TryGet("FrameworkDisplayName", out tmp)) TargetFrameworkDisplayName = (string)tmp; + break; + } + } + } + + private string targetFrameworkName, targetFrameworkDisplayName, typeName, outputPath, imageRuntimeVersion; + private int metaDataVersion; + /// + /// The TargetFrameworkAttribute FrameworkName value to burn into the generated assembly + /// + public string TargetFrameworkName { get { return targetFrameworkName; } set { targetFrameworkName = value; } } + + /// + /// The TargetFrameworkAttribute FrameworkDisplayName value to burn into the generated assembly + /// + public string TargetFrameworkDisplayName { get { return targetFrameworkDisplayName; } set { targetFrameworkDisplayName = value; } } + /// + /// The name of the TypeModel class to create + /// + public string TypeName { get { return typeName; } set { typeName = value; } } + +#if COREFX + internal const string NoPersistence = "Assembly persistence not supported on this runtime"; +#endif + /// + /// The path for the new dll + /// +#if COREFX + [Obsolete(NoPersistence)] +#endif + public string OutputPath { get { return outputPath; } set { outputPath = value; } } + /// + /// The runtime version for the generated assembly + /// + public string ImageRuntimeVersion { get { return imageRuntimeVersion; } set { imageRuntimeVersion = value; } } + /// + /// The runtime version for the generated assembly + /// + public int MetaDataVersion { get { return metaDataVersion; } set { metaDataVersion = value; } } + + + private Accessibility accessibility = Accessibility.Public; + /// + /// The acecssibility of the generated serializer + /// + public Accessibility Accessibility { get { return accessibility; } set { accessibility = value; } } + } + + /// + /// Type accessibility + /// + public enum Accessibility + { + /// + /// Available to all callers + /// + Public, + /// + /// Available to all callers in the same assembly, or assemblies specified via [InternalsVisibleTo(...)] + /// + Internal + } + +#if !COREFX + /// + /// Fully compiles the current model into a static-compiled serialization dll + /// (the serialization dll still requires protobuf-net for support services). + /// + /// A full compilation is restricted to accessing public types / members + /// The name of the TypeModel class to create + /// The path for the new dll + /// An instance of the newly created compiled type-model + public TypeModel Compile(string name, string path) + { + CompilerOptions options = new CompilerOptions(); + options.TypeName = name; + options.OutputPath = path; + return Compile(options); + } +#endif + /// + /// Fully compiles the current model into a static-compiled serialization dll + /// (the serialization dll still requires protobuf-net for support services). + /// + /// A full compilation is restricted to accessing public types / members + /// An instance of the newly created compiled type-model + public TypeModel Compile(CompilerOptions options) + { + if (options == null) throw new ArgumentNullException("options"); + string typeName = options.TypeName; +#pragma warning disable 0618 + string path = options.OutputPath; +#pragma warning restore 0618 + BuildAllSerializers(); + Freeze(); + bool save = !string.IsNullOrEmpty(path); + if (string.IsNullOrEmpty(typeName)) + { + if (save) throw new ArgumentNullException("typeName"); + typeName = Guid.NewGuid().ToString(); + } + + + string assemblyName, moduleName; + if (path == null) + { + assemblyName = typeName; + moduleName = assemblyName + ".dll"; + } + else + { + assemblyName = new System.IO.FileInfo(System.IO.Path.GetFileNameWithoutExtension(path)).Name; + moduleName = assemblyName + System.IO.Path.GetExtension(path); + } + +#if COREFX + AssemblyName an = new AssemblyName(); + an.Name = assemblyName; + AssemblyBuilder asm = AssemblyBuilder.DefineDynamicAssembly(an, + AssemblyBuilderAccess.Run); + ModuleBuilder module = asm.DefineDynamicModule(moduleName); +#else + AssemblyName an = new AssemblyName(); + an.Name = assemblyName; + AssemblyBuilder asm = AppDomain.CurrentDomain.DefineDynamicAssembly(an, + (save ? AssemblyBuilderAccess.RunAndSave : AssemblyBuilderAccess.Run) + ); + ModuleBuilder module = save ? asm.DefineDynamicModule(moduleName, path) + : asm.DefineDynamicModule(moduleName); +#endif + + WriteAssemblyAttributes(options, assemblyName, asm); + + TypeBuilder type = WriteBasicTypeModel(options, typeName, module); + + int index; + bool hasInheritance; + SerializerPair[] methodPairs; + Compiler.CompilerContext.ILVersion ilVersion; + WriteSerializers(options, assemblyName, type, out index, out hasInheritance, out methodPairs, out ilVersion); + + ILGenerator il; + int knownTypesCategory; + FieldBuilder knownTypes; + Type knownTypesLookupType; + WriteGetKeyImpl(type, hasInheritance, methodPairs, ilVersion, assemblyName, out il, out knownTypesCategory, out knownTypes, out knownTypesLookupType); + + // trivial flags + il = Override(type, "SerializeDateTimeKind"); + il.Emit(IncludeDateTimeKind ? OpCodes.Ldc_I4_1 : OpCodes.Ldc_I4_0); + il.Emit(OpCodes.Ret); + // end: trivial flags + + Compiler.CompilerContext ctx = WriteSerializeDeserialize(assemblyName, type, methodPairs, ilVersion, ref il); + + WriteConstructors(type, ref index, methodPairs, ref il, knownTypesCategory, knownTypes, knownTypesLookupType, ctx); + + +#if COREFX + Type finalType = type.CreateTypeInfo().AsType(); +#else + Type finalType = type.CreateType(); +#endif + if (!string.IsNullOrEmpty(path)) + { +#if COREFX + throw new NotSupportedException(CompilerOptions.NoPersistence); +#else + try + { + asm.Save(path); + } + catch (IOException ex) + { + // advertise the file info + throw new IOException(path + ", " + ex.Message, ex); + } + Helpers.DebugWriteLine("Wrote dll:" + path); +#endif + } + return (TypeModel)Activator.CreateInstance(finalType); + } + + private void WriteConstructors(TypeBuilder type, ref int index, SerializerPair[] methodPairs, ref ILGenerator il, int knownTypesCategory, FieldBuilder knownTypes, Type knownTypesLookupType, Compiler.CompilerContext ctx) + { + type.DefineDefaultConstructor(MethodAttributes.Public); + il = type.DefineTypeInitializer().GetILGenerator(); + switch (knownTypesCategory) + { + case KnownTypes_Array: + { + Compiler.CompilerContext.LoadValue(il, types.Count); + il.Emit(OpCodes.Newarr, ctx.MapType(typeof(System.Type))); + index = 0; + foreach (SerializerPair pair in methodPairs) + { + il.Emit(OpCodes.Dup); + Compiler.CompilerContext.LoadValue(il, index); + il.Emit(OpCodes.Ldtoken, pair.Type.Type); + il.EmitCall(OpCodes.Call, ctx.MapType(typeof(System.Type)).GetMethod("GetTypeFromHandle"), null); + il.Emit(OpCodes.Stelem_Ref); + index++; + } + il.Emit(OpCodes.Stsfld, knownTypes); + il.Emit(OpCodes.Ret); + } + break; + case KnownTypes_Dictionary: + { + Compiler.CompilerContext.LoadValue(il, types.Count); + //LocalBuilder loc = il.DeclareLocal(knownTypesLookupType); + il.Emit(OpCodes.Newobj, knownTypesLookupType.GetConstructor(new Type[] { MapType(typeof(int)) })); + il.Emit(OpCodes.Stsfld, knownTypes); + int typeIndex = 0; + foreach (SerializerPair pair in methodPairs) + { + il.Emit(OpCodes.Ldsfld, knownTypes); + il.Emit(OpCodes.Ldtoken, pair.Type.Type); + il.EmitCall(OpCodes.Call, ctx.MapType(typeof(System.Type)).GetMethod("GetTypeFromHandle"), null); + int keyIndex = typeIndex++, lastKey = pair.BaseKey; + if (lastKey != pair.MetaKey) // not a base-type; need to give the index of the base-type + { + keyIndex = -1; // assume epic fail + for (int j = 0; j < methodPairs.Length; j++) + { + if (methodPairs[j].BaseKey == lastKey && methodPairs[j].MetaKey == lastKey) + { + keyIndex = j; + break; + } + } + } + Compiler.CompilerContext.LoadValue(il, keyIndex); + il.EmitCall(OpCodes.Callvirt, knownTypesLookupType.GetMethod("Add", new Type[] { MapType(typeof(System.Type)), MapType(typeof(int)) }), null); + } + il.Emit(OpCodes.Ret); + } + break; + case KnownTypes_Hashtable: + { + Compiler.CompilerContext.LoadValue(il, types.Count); + il.Emit(OpCodes.Newobj, knownTypesLookupType.GetConstructor(new Type[] { MapType(typeof(int)) })); + il.Emit(OpCodes.Stsfld, knownTypes); + int typeIndex = 0; + foreach (SerializerPair pair in methodPairs) + { + il.Emit(OpCodes.Ldsfld, knownTypes); + il.Emit(OpCodes.Ldtoken, pair.Type.Type); + il.EmitCall(OpCodes.Call, ctx.MapType(typeof(System.Type)).GetMethod("GetTypeFromHandle"), null); + int keyIndex = typeIndex++, lastKey = pair.BaseKey; + if (lastKey != pair.MetaKey) // not a base-type; need to give the index of the base-type + { + keyIndex = -1; // assume epic fail + for (int j = 0; j < methodPairs.Length; j++) + { + if (methodPairs[j].BaseKey == lastKey && methodPairs[j].MetaKey == lastKey) + { + keyIndex = j; + break; + } + } + } + Compiler.CompilerContext.LoadValue(il, keyIndex); + il.Emit(OpCodes.Box, MapType(typeof(int))); + il.EmitCall(OpCodes.Callvirt, knownTypesLookupType.GetMethod("Add", new Type[] { MapType(typeof(object)), MapType(typeof(object)) }), null); + } + il.Emit(OpCodes.Ret); + } + break; + default: + throw new InvalidOperationException(); + } + } + + private Compiler.CompilerContext WriteSerializeDeserialize(string assemblyName, TypeBuilder type, SerializerPair[] methodPairs, Compiler.CompilerContext.ILVersion ilVersion, ref ILGenerator il) + { + il = Override(type, "Serialize"); + Compiler.CompilerContext ctx = new Compiler.CompilerContext(il, false, true, methodPairs, this, ilVersion, assemblyName, MapType(typeof(object)), "Serialize " + type.Name); + // arg0 = this, arg1 = key, arg2=obj, arg3=dest + Compiler.CodeLabel[] jumpTable = new Compiler.CodeLabel[types.Count]; + for (int i = 0; i < jumpTable.Length; i++) + { + jumpTable[i] = ctx.DefineLabel(); + } + il.Emit(OpCodes.Ldarg_1); + ctx.Switch(jumpTable); + ctx.Return(); + for (int i = 0; i < jumpTable.Length; i++) + { + SerializerPair pair = methodPairs[i]; + ctx.MarkLabel(jumpTable[i]); + il.Emit(OpCodes.Ldarg_2); + ctx.CastFromObject(pair.Type.Type); + il.Emit(OpCodes.Ldarg_3); + il.EmitCall(OpCodes.Call, pair.Serialize, null); + ctx.Return(); + } + + il = Override(type, "Deserialize"); + ctx = new Compiler.CompilerContext(il, false, false, methodPairs, this, ilVersion, assemblyName, MapType(typeof(object)), "Deserialize " + type.Name); + // arg0 = this, arg1 = key, arg2=obj, arg3=source + for (int i = 0; i < jumpTable.Length; i++) + { + jumpTable[i] = ctx.DefineLabel(); + } + il.Emit(OpCodes.Ldarg_1); + ctx.Switch(jumpTable); + ctx.LoadNullRef(); + ctx.Return(); + for (int i = 0; i < jumpTable.Length; i++) + { + SerializerPair pair = methodPairs[i]; + ctx.MarkLabel(jumpTable[i]); + Type keyType = pair.Type.Type; + if (Helpers.IsValueType(keyType)) + { + il.Emit(OpCodes.Ldarg_2); + il.Emit(OpCodes.Ldarg_3); + il.EmitCall(OpCodes.Call, EmitBoxedSerializer(type, i, keyType, methodPairs, this, ilVersion, assemblyName), null); + ctx.Return(); + } + else + { + il.Emit(OpCodes.Ldarg_2); + ctx.CastFromObject(keyType); + il.Emit(OpCodes.Ldarg_3); + il.EmitCall(OpCodes.Call, pair.Deserialize, null); + ctx.Return(); + } + } + return ctx; + } + + private const int KnownTypes_Array = 1, KnownTypes_Dictionary = 2, KnownTypes_Hashtable = 3, KnownTypes_ArrayCutoff = 20; + private void WriteGetKeyImpl(TypeBuilder type, bool hasInheritance, SerializerPair[] methodPairs, Compiler.CompilerContext.ILVersion ilVersion, string assemblyName, out ILGenerator il, out int knownTypesCategory, out FieldBuilder knownTypes, out Type knownTypesLookupType) + { + + il = Override(type, "GetKeyImpl"); + Compiler.CompilerContext ctx = new Compiler.CompilerContext(il, false, false, methodPairs, this, ilVersion, assemblyName, MapType(typeof(System.Type), true), "GetKeyImpl"); + + + if (types.Count <= KnownTypes_ArrayCutoff) + { + knownTypesCategory = KnownTypes_Array; + knownTypesLookupType = MapType(typeof(System.Type[]), true); + } + else + { + knownTypesLookupType = MapType(typeof(System.Collections.Generic.Dictionary), false); + +#if !COREFX + if (knownTypesLookupType == null) + { + knownTypesLookupType = MapType(typeof(Hashtable), true); + knownTypesCategory = KnownTypes_Hashtable; + } + else +#endif + { + knownTypesCategory = KnownTypes_Dictionary; + } + } + knownTypes = type.DefineField("knownTypes", knownTypesLookupType, FieldAttributes.Private | FieldAttributes.InitOnly | FieldAttributes.Static); + + switch (knownTypesCategory) + { + case KnownTypes_Array: + { + il.Emit(OpCodes.Ldsfld, knownTypes); + il.Emit(OpCodes.Ldarg_1); + // note that Array.IndexOf is not supported under CF + il.EmitCall(OpCodes.Callvirt, MapType(typeof(IList)).GetMethod( + "IndexOf", new Type[] { MapType(typeof(object)) }), null); + if (hasInheritance) + { + il.DeclareLocal(MapType(typeof(int))); // loc-0 + il.Emit(OpCodes.Dup); + il.Emit(OpCodes.Stloc_0); + + BasicList getKeyLabels = new BasicList(); + int lastKey = -1; + for (int i = 0; i < methodPairs.Length; i++) + { + if (methodPairs[i].MetaKey == methodPairs[i].BaseKey) break; + if (lastKey == methodPairs[i].BaseKey) + { // add the last label again + getKeyLabels.Add(getKeyLabels[getKeyLabels.Count - 1]); + } + else + { // add a new unique label + getKeyLabels.Add(ctx.DefineLabel()); + lastKey = methodPairs[i].BaseKey; + } + } + Compiler.CodeLabel[] subtypeLabels = new Compiler.CodeLabel[getKeyLabels.Count]; + getKeyLabels.CopyTo(subtypeLabels, 0); + + ctx.Switch(subtypeLabels); + il.Emit(OpCodes.Ldloc_0); // not a sub-type; use the original value + il.Emit(OpCodes.Ret); + + lastKey = -1; + // now output the different branches per sub-type (not derived type) + for (int i = subtypeLabels.Length - 1; i >= 0; i--) + { + if (lastKey != methodPairs[i].BaseKey) + { + lastKey = methodPairs[i].BaseKey; + // find the actual base-index for this base-key (i.e. the index of + // the base-type) + int keyIndex = -1; + for (int j = subtypeLabels.Length; j < methodPairs.Length; j++) + { + if (methodPairs[j].BaseKey == lastKey && methodPairs[j].MetaKey == lastKey) + { + keyIndex = j; + break; + } + } + ctx.MarkLabel(subtypeLabels[i]); + Compiler.CompilerContext.LoadValue(il, keyIndex); + il.Emit(OpCodes.Ret); + } + } + } + else + { + il.Emit(OpCodes.Ret); + } + } + break; + case KnownTypes_Dictionary: + { + LocalBuilder result = il.DeclareLocal(MapType(typeof(int))); + Label otherwise = il.DefineLabel(); + il.Emit(OpCodes.Ldsfld, knownTypes); + il.Emit(OpCodes.Ldarg_1); + il.Emit(OpCodes.Ldloca_S, result); + il.EmitCall(OpCodes.Callvirt, knownTypesLookupType.GetMethod("TryGetValue", BindingFlags.Instance | BindingFlags.Public), null); + il.Emit(OpCodes.Brfalse_S, otherwise); + il.Emit(OpCodes.Ldloc_S, result); + il.Emit(OpCodes.Ret); + il.MarkLabel(otherwise); + il.Emit(OpCodes.Ldc_I4_M1); + il.Emit(OpCodes.Ret); + } + break; + case KnownTypes_Hashtable: + { + Label otherwise = il.DefineLabel(); + il.Emit(OpCodes.Ldsfld, knownTypes); + il.Emit(OpCodes.Ldarg_1); + il.EmitCall(OpCodes.Callvirt, knownTypesLookupType.GetProperty("Item").GetGetMethod(), null); + il.Emit(OpCodes.Dup); + il.Emit(OpCodes.Brfalse_S, otherwise); + if (ilVersion == Compiler.CompilerContext.ILVersion.Net1) + { + il.Emit(OpCodes.Unbox, MapType(typeof(int))); + il.Emit(OpCodes.Ldobj, MapType(typeof(int))); + } + else + { + il.Emit(OpCodes.Unbox_Any, MapType(typeof(int))); + } + il.Emit(OpCodes.Ret); + il.MarkLabel(otherwise); + il.Emit(OpCodes.Pop); + il.Emit(OpCodes.Ldc_I4_M1); + il.Emit(OpCodes.Ret); + } + break; + default: + throw new InvalidOperationException(); + } + } + + private void WriteSerializers(CompilerOptions options, string assemblyName, TypeBuilder type, out int index, out bool hasInheritance, out SerializerPair[] methodPairs, out Compiler.CompilerContext.ILVersion ilVersion) + { + Compiler.CompilerContext ctx; + + index = 0; + hasInheritance = false; + methodPairs = new SerializerPair[types.Count]; + foreach (MetaType metaType in types) + { + MethodBuilder writeMethod = type.DefineMethod("Write" +#if DEBUG + + metaType.Type.Name +#endif +, + MethodAttributes.Private | MethodAttributes.Static, CallingConventions.Standard, + MapType(typeof(void)), new Type[] { metaType.Type, MapType(typeof(ProtoWriter)) }); + + MethodBuilder readMethod = type.DefineMethod("Read" +#if DEBUG + + metaType.Type.Name +#endif +, + MethodAttributes.Private | MethodAttributes.Static, CallingConventions.Standard, + metaType.Type, new Type[] { metaType.Type, MapType(typeof(ProtoReader)) }); + + SerializerPair pair = new SerializerPair( + GetKey(metaType.Type, true, false), GetKey(metaType.Type, true, true), metaType, + writeMethod, readMethod, writeMethod.GetILGenerator(), readMethod.GetILGenerator()); + methodPairs[index++] = pair; + if (pair.MetaKey != pair.BaseKey) hasInheritance = true; + } + + if (hasInheritance) + { + Array.Sort(methodPairs); + } + + ilVersion = Compiler.CompilerContext.ILVersion.Net2; + if (options.MetaDataVersion == 0x10000) + { + ilVersion = Compiler.CompilerContext.ILVersion.Net1; // old-school! + } + for (index = 0; index < methodPairs.Length; index++) + { + SerializerPair pair = methodPairs[index]; + ctx = new Compiler.CompilerContext(pair.SerializeBody, true, true, methodPairs, this, ilVersion, assemblyName, pair.Type.Type, "SerializeImpl " + pair.Type.Type.Name); + MemberInfo returnType = pair.Deserialize.ReturnType +#if COREFX + .GetTypeInfo() +#endif + ; + ctx.CheckAccessibility(ref returnType); + pair.Type.Serializer.EmitWrite(ctx, ctx.InputValue); + ctx.Return(); + + ctx = new Compiler.CompilerContext(pair.DeserializeBody, true, false, methodPairs, this, ilVersion, assemblyName, pair.Type.Type, "DeserializeImpl " + pair.Type.Type.Name); + pair.Type.Serializer.EmitRead(ctx, ctx.InputValue); + if (!pair.Type.Serializer.ReturnsValue) + { + ctx.LoadValue(ctx.InputValue); + } + ctx.Return(); + } + } + + private TypeBuilder WriteBasicTypeModel(CompilerOptions options, string typeName, ModuleBuilder module) + { + Type baseType = MapType(typeof(TypeModel)); +#if COREFX + TypeAttributes typeAttributes = (baseType.GetTypeInfo().Attributes & ~TypeAttributes.Abstract) | TypeAttributes.Sealed; +#else + TypeAttributes typeAttributes = (baseType.Attributes & ~TypeAttributes.Abstract) | TypeAttributes.Sealed; +#endif + if (options.Accessibility == Accessibility.Internal) + { + typeAttributes &= ~TypeAttributes.Public; + } + + TypeBuilder type = module.DefineType(typeName, typeAttributes, baseType); + return type; + } + + private void WriteAssemblyAttributes(CompilerOptions options, string assemblyName, AssemblyBuilder asm) + { + if (!string.IsNullOrEmpty(options.TargetFrameworkName)) + { + // get [TargetFramework] from mscorlib/equivalent and burn into the new assembly + Type versionAttribType = null; + try + { // this is best-endeavours only + versionAttribType = GetType("System.Runtime.Versioning.TargetFrameworkAttribute", Helpers.GetAssembly(MapType(typeof(string)))); + } + catch { /* don't stress */ } + if (versionAttribType != null) + { + PropertyInfo[] props; + object[] propValues; + if (string.IsNullOrEmpty(options.TargetFrameworkDisplayName)) + { + props = new PropertyInfo[0]; + propValues = new object[0]; + } + else + { + props = new PropertyInfo[1] { versionAttribType.GetProperty("FrameworkDisplayName") }; + propValues = new object[1] { options.TargetFrameworkDisplayName }; + } + CustomAttributeBuilder builder = new CustomAttributeBuilder( + versionAttribType.GetConstructor(new Type[] { MapType(typeof(string)) }), + new object[] { options.TargetFrameworkName }, + props, + propValues); + asm.SetCustomAttribute(builder); + } + } + + // copy assembly:InternalsVisibleTo + Type internalsVisibleToAttribType = null; + + try + { + internalsVisibleToAttribType = MapType(typeof(System.Runtime.CompilerServices.InternalsVisibleToAttribute)); + } + catch { /* best endeavors only */ } + + if (internalsVisibleToAttribType != null) + { + BasicList internalAssemblies = new BasicList(), consideredAssemblies = new BasicList(); + foreach (MetaType metaType in types) + { + Assembly assembly = Helpers.GetAssembly(metaType.Type); + if (consideredAssemblies.IndexOfReference(assembly) >= 0) continue; + consideredAssemblies.Add(assembly); + + AttributeMap[] assemblyAttribsMap = AttributeMap.Create(this, assembly); + for (int i = 0; i < assemblyAttribsMap.Length; i++) + { + + if (assemblyAttribsMap[i].AttributeType != internalsVisibleToAttribType) continue; + + object privelegedAssemblyObj; + assemblyAttribsMap[i].TryGet("AssemblyName", out privelegedAssemblyObj); + string privelegedAssemblyName = privelegedAssemblyObj as string; + if (privelegedAssemblyName == assemblyName || string.IsNullOrEmpty(privelegedAssemblyName)) continue; // ignore + + if (internalAssemblies.IndexOfString(privelegedAssemblyName) >= 0) continue; // seen it before + internalAssemblies.Add(privelegedAssemblyName); + + CustomAttributeBuilder builder = new CustomAttributeBuilder( + internalsVisibleToAttribType.GetConstructor(new Type[] { MapType(typeof(string)) }), + new object[] { privelegedAssemblyName }); + asm.SetCustomAttribute(builder); + } + } + } + } + + private static MethodBuilder EmitBoxedSerializer(TypeBuilder type, int i, Type valueType, SerializerPair[] methodPairs, TypeModel model, Compiler.CompilerContext.ILVersion ilVersion, string assemblyName) + { + MethodInfo dedicated = methodPairs[i].Deserialize; + MethodBuilder boxedSerializer = type.DefineMethod("_" + i.ToString(), MethodAttributes.Static, CallingConventions.Standard, + model.MapType(typeof(object)), new Type[] { model.MapType(typeof(object)), model.MapType(typeof(ProtoReader)) }); + Compiler.CompilerContext ctx = new Compiler.CompilerContext(boxedSerializer.GetILGenerator(), true, false, methodPairs, model, ilVersion, assemblyName, model.MapType(typeof(object)), "BoxedSerializer " + valueType.Name); + ctx.LoadValue(ctx.InputValue); + Compiler.CodeLabel @null = ctx.DefineLabel(); + ctx.BranchIfFalse(@null, true); + + Type mappedValueType = valueType; + ctx.LoadValue(ctx.InputValue); + ctx.CastFromObject(mappedValueType); + ctx.LoadReaderWriter(); + ctx.EmitCall(dedicated); + ctx.CastToObject(mappedValueType); + ctx.Return(); + + ctx.MarkLabel(@null); + using (Compiler.Local typedVal = new Compiler.Local(ctx, mappedValueType)) + { + // create a new valueType + ctx.LoadAddress(typedVal, mappedValueType); + ctx.EmitCtor(mappedValueType); + ctx.LoadValue(typedVal); + ctx.LoadReaderWriter(); + ctx.EmitCall(dedicated); + ctx.CastToObject(mappedValueType); + ctx.Return(); + } + return boxedSerializer; + } + +#endif + //internal bool IsDefined(Type type, int fieldNumber) + //{ + // return FindWithoutAdd(type).IsDefined(fieldNumber); + //} + + // note that this is used by some of the unit tests + internal bool IsPrepared(Type type) + { + MetaType meta = FindWithoutAdd(type); + return meta != null && meta.IsPrepared(); + } + + internal EnumSerializer.EnumPair[] GetEnumMap(Type type) + { + int index = FindOrAddAuto(type, false, false, false); + return index < 0 ? null : ((MetaType)types[index]).GetEnumMap(); + } + + private int metadataTimeoutMilliseconds = 5000; + /// + /// The amount of time to wait if there are concurrent metadata access operations + /// + public int MetadataTimeoutMilliseconds + { + get { return metadataTimeoutMilliseconds; } + set + { + if (value <= 0) throw new ArgumentOutOfRangeException("MetadataTimeoutMilliseconds"); + metadataTimeoutMilliseconds = value; + } + } + +#if DEBUG + int lockCount; + /// + /// Gets how many times a model lock was taken + /// + public int LockCount { get { return lockCount; } } +#endif + internal void TakeLock(ref int opaqueToken) + { + const string message = "Timeout while inspecting metadata; this may indicate a deadlock. This can often be avoided by preparing necessary serializers during application initialization, rather than allowing multiple threads to perform the initial metadata inspection; please also see the LockContended event"; + opaqueToken = 0; +#if PORTABLE + if(!Monitor.TryEnter(types, metadataTimeoutMilliseconds)) throw new TimeoutException(message); + opaqueToken = Interlocked.CompareExchange(ref contentionCounter, 0, 0); // just fetch current value (starts at 1) +#elif CF2 || CF35 + int remaining = metadataTimeoutMilliseconds; + bool lockTaken; + do { + lockTaken = Monitor.TryEnter(types); + if(!lockTaken) + { + if(remaining <= 0) throw new TimeoutException(message); + remaining -= 50; + Thread.Sleep(50); + } + } while(!lockTaken); + opaqueToken = Interlocked.CompareExchange(ref contentionCounter, 0, 0); // just fetch current value (starts at 1) +#else + if (Monitor.TryEnter(types, metadataTimeoutMilliseconds)) + { + opaqueToken = GetContention(); // just fetch current value (starts at 1) + } + else + { + AddContention(); + + throw new TimeoutException(message); + } +#endif + +#if DEBUG // note that here, through all code-paths: we have the lock + lockCount++; +#endif + } + + private int contentionCounter = 1; +#if PLAT_NO_INTERLOCKED + private readonly object contentionLock = new object(); +#endif + private int GetContention() + { +#if PLAT_NO_INTERLOCKED + lock(contentionLock) + { + return contentionCounter; + } +#else + return Interlocked.CompareExchange(ref contentionCounter, 0, 0); +#endif + } + private void AddContention() + { +#if PLAT_NO_INTERLOCKED + lock(contentionLock) + { + contentionCounter++; + } +#else + Interlocked.Increment(ref contentionCounter); +#endif + } + + internal void ReleaseLock(int opaqueToken) + { + if (opaqueToken != 0) + { + Monitor.Exit(types); + if (opaqueToken != GetContention()) // contention-count changes since we looked! + { + LockContentedEventHandler handler = LockContended; + if (handler != null) + { + // not hugely elegant, but this is such a far-corner-case that it doesn't need to be slick - I'll settle for cross-platform + string stackTrace; + try + { + throw new ProtoException(); + } + catch (Exception ex) + { + stackTrace = ex.StackTrace; + } + + handler(this, new LockContentedEventArgs(stackTrace)); + } + } + } + } + /// + /// If a lock-contention is detected, this event signals the *owner* of the lock responsible for the blockage, indicating + /// what caused the problem; this is only raised if the lock-owning code successfully completes. + /// + public event LockContentedEventHandler LockContended; + + internal void ResolveListTypes(Type type, ref Type itemType, ref Type defaultType) + { + if (type == null) return; + if (Helpers.GetTypeCode(type) != ProtoTypeCode.Unknown) return; // don't try this[type] for inbuilts + + // handle arrays + if (type.IsArray) + { + if (type.GetArrayRank() != 1) + { + throw new NotSupportedException("Multi-dimension arrays are supported"); + } + itemType = type.GetElementType(); + if (itemType == MapType(typeof(byte))) + { + defaultType = itemType = null; + } + else + { + defaultType = type; + } + } + else + { + // if not an array, first check it isn't explicitly opted out + if (this[type].IgnoreListHandling) return; + } + + // handle lists + if (itemType == null) { itemType = TypeModel.GetListItemType(this, type); } + + // check for nested data (not allowed) + if (itemType != null) + { + Type nestedItemType = null, nestedDefaultType = null; + ResolveListTypes(itemType, ref nestedItemType, ref nestedDefaultType); + if (nestedItemType != null) + { + throw TypeModel.CreateNestedListsNotSupported(type); + } + } + + if (itemType != null && defaultType == null) + { +#if COREFX || PROFILE259 + TypeInfo typeInfo = IntrospectionExtensions.GetTypeInfo(type); + if (typeInfo.IsClass && !typeInfo.IsAbstract && Helpers.GetConstructor(typeInfo, Helpers.EmptyTypes, true) != null) +#else + if (type.IsClass && !type.IsAbstract && Helpers.GetConstructor(type, Helpers.EmptyTypes, true) != null) +#endif + { + defaultType = type; + } + if (defaultType == null) + { +#if COREFX || PROFILE259 + if (typeInfo.IsInterface) +#else + if (type.IsInterface) +#endif + { + + Type[] genArgs; +#if COREFX || PROFILE259 + if (typeInfo.IsGenericType && typeInfo.GetGenericTypeDefinition() == typeof(System.Collections.Generic.IDictionary<,>) + && itemType == typeof(System.Collections.Generic.KeyValuePair<,>).MakeGenericType(genArgs = typeInfo.GenericTypeArguments)) +#else + if (type.IsGenericType && type.GetGenericTypeDefinition() == MapType(typeof(System.Collections.Generic.IDictionary<,>)) + && itemType == MapType(typeof(System.Collections.Generic.KeyValuePair<,>)).MakeGenericType(genArgs = type.GetGenericArguments())) +#endif + { + defaultType = MapType(typeof(System.Collections.Generic.Dictionary<,>)).MakeGenericType(genArgs); + } + else + { + defaultType = MapType(typeof(System.Collections.Generic.List<>)).MakeGenericType(itemType); + } + } + } + // verify that the default type is appropriate + if (defaultType != null && !Helpers.IsAssignableFrom(type, defaultType)) { defaultType = null; } + } + } + + internal string GetSchemaTypeName(Type effectiveType, DataFormat dataFormat, bool asReference, bool dynamicType, ref CommonImports imports) + { + Type tmp = Helpers.GetUnderlyingType(effectiveType); + if (tmp != null) effectiveType = tmp; + + if (effectiveType == this.MapType(typeof(byte[]))) return "bytes"; + + WireType wireType; + IProtoSerializer ser = ValueMember.TryGetCoreSerializer(this, dataFormat, effectiveType, out wireType, false, false, false, false); + if (ser == null) + { // model type + if (asReference || dynamicType) + { + imports |= CommonImports.Bcl; + return ".bcl.NetObjectProxy"; + } + return this[effectiveType].GetSurrogateOrBaseOrSelf(true).GetSchemaTypeName(); + } + else + { + if (ser is ParseableSerializer) + { + if (asReference) imports |= CommonImports.Bcl; + return asReference ? ".bcl.NetObjectProxy" : "string"; + } + + switch (Helpers.GetTypeCode(effectiveType)) + { + case ProtoTypeCode.Boolean: return "bool"; + case ProtoTypeCode.Single: return "float"; + case ProtoTypeCode.Double: return "double"; + case ProtoTypeCode.String: + if (asReference) imports |= CommonImports.Bcl; + return asReference ? ".bcl.NetObjectProxy" : "string"; + case ProtoTypeCode.Byte: + case ProtoTypeCode.Char: + case ProtoTypeCode.UInt16: + case ProtoTypeCode.UInt32: + switch (dataFormat) + { + case DataFormat.FixedSize: return "fixed32"; + default: return "uint32"; + } + case ProtoTypeCode.SByte: + case ProtoTypeCode.Int16: + case ProtoTypeCode.Int32: + switch (dataFormat) + { + case DataFormat.ZigZag: return "sint32"; + case DataFormat.FixedSize: return "sfixed32"; + default: return "int32"; + } + case ProtoTypeCode.UInt64: + switch (dataFormat) + { + case DataFormat.FixedSize: return "fixed64"; + default: return "uint64"; + } + case ProtoTypeCode.Int64: + switch (dataFormat) + { + case DataFormat.ZigZag: return "sint64"; + case DataFormat.FixedSize: return "sfixed64"; + default: return "int64"; + } + case ProtoTypeCode.DateTime: + switch (dataFormat) + { + case DataFormat.FixedSize: return "sint64"; + case DataFormat.WellKnown: + imports |= CommonImports.Timestamp; + return ".google.protobuf.Timestamp"; + default: + imports |= CommonImports.Bcl; + return ".bcl.DateTime"; + } + case ProtoTypeCode.TimeSpan: + switch (dataFormat) + { + case DataFormat.FixedSize: return "sint64"; + case DataFormat.WellKnown: + imports |= CommonImports.Duration; + return ".google.protobuf.Duration"; + default: + imports |= CommonImports.Bcl; + return ".bcl.TimeSpan"; + } + case ProtoTypeCode.Decimal: imports |= CommonImports.Bcl; return ".bcl.Decimal"; + case ProtoTypeCode.Guid: imports |= CommonImports.Bcl; return ".bcl.Guid"; + case ProtoTypeCode.Type: return "string"; + default: throw new NotSupportedException("No .proto map found for: " + effectiveType.FullName); + } + } + + } + + /// + /// Designate a factory-method to use to create instances of any type; note that this only affect types seen by the serializer *after* setting the factory. + /// + public void SetDefaultFactory(MethodInfo methodInfo) + { + VerifyFactory(methodInfo, null); + defaultFactory = methodInfo; + } + private MethodInfo defaultFactory; + + internal void VerifyFactory(MethodInfo factory, Type type) + { + if (factory != null) + { + if (type != null && Helpers.IsValueType(type)) throw new InvalidOperationException(); + if (!factory.IsStatic) throw new ArgumentException("A factory-method must be static", "factory"); + if ((type != null && factory.ReturnType != type) && factory.ReturnType != MapType(typeof(object))) throw new ArgumentException("The factory-method must return object" + (type == null ? "" : (" or " + type.FullName)), "factory"); + + if (!CallbackSet.CheckCallbackParameters(this, factory)) throw new ArgumentException("Invalid factory signature in " + factory.DeclaringType.FullName + "." + factory.Name, "factory"); + } + } + + /// + /// Raised before a type is auto-configured; this allows the auto-configuration to be electively suppressed + /// + /// This callback should be fast and not involve complex external calls, as it may block the model + public event EventHandler BeforeApplyDefaultBehaviour; + + /// + /// Raised after a type is auto-configured; this allows additional external customizations + /// + /// This callback should be fast and not involve complex external calls, as it may block the model + public event EventHandler AfterApplyDefaultBehaviour; + + internal static void OnBeforeApplyDefaultBehaviour(MetaType metaType, ref TypeAddedEventArgs args) + => OnApplyDefaultBehaviour((metaType?.Model as RuntimeTypeModel)?.BeforeApplyDefaultBehaviour, metaType, ref args); + + internal static void OnAfterApplyDefaultBehaviour(MetaType metaType, ref TypeAddedEventArgs args) + => OnApplyDefaultBehaviour((metaType?.Model as RuntimeTypeModel)?.AfterApplyDefaultBehaviour, metaType, ref args); + + private static void OnApplyDefaultBehaviour( + EventHandler handler, MetaType metaType, ref TypeAddedEventArgs args) + { + if (handler != null) + { + if (args == null) args = new TypeAddedEventArgs(metaType); + handler(metaType.Model, args); + } + } + } + + /// + /// Contains the stack-trace of the owning code when a lock-contention scenario is detected + /// + public sealed class LockContentedEventArgs : EventArgs + { + private readonly string ownerStackTrace; + internal LockContentedEventArgs(string ownerStackTrace) + { + this.ownerStackTrace = ownerStackTrace; + } + + /// + /// The stack-trace of the code that owned the lock when a lock-contention scenario occurred + /// + public string OwnerStackTrace => ownerStackTrace; + } + /// + /// Event-type that is raised when a lock-contention scenario is detected + /// + public delegate void LockContentedEventHandler(object sender, LockContentedEventArgs args); +} +#endif diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/SubType.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/SubType.cs new file mode 100644 index 0000000..72c8126 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/SubType.cs @@ -0,0 +1,97 @@ +#if !NO_RUNTIME +using System; +using System.Collections.Generic; +using ProtoBuf.Serializers; + +namespace ProtoBuf.Meta +{ + /// + /// Represents an inherited type in a type hierarchy. + /// + public sealed class SubType + { + internal sealed class Comparer : System.Collections.IComparer, IComparer + { + public static readonly Comparer Default = new Comparer(); + + public int Compare(object x, object y) + { + return Compare(x as SubType, y as SubType); + } + + public int Compare(SubType x, SubType y) + { + if (ReferenceEquals(x, y)) return 0; + if (x == null) return -1; + if (y == null) return 1; + + return x.FieldNumber.CompareTo(y.FieldNumber); + } + } + + private int _fieldNumber; + + /// + /// The field-number that is used to encapsulate the data (as a nested + /// message) for the derived dype. + /// + public int FieldNumber + { + get => _fieldNumber; + internal set + { + if (_fieldNumber != value) + { + MetaType.AssertValidFieldNumber(value); + ThrowIfFrozen(); + _fieldNumber = value; + } + } + } + + private void ThrowIfFrozen() + { + if (serializer != null) throw new InvalidOperationException("The type cannot be changed once a serializer has been generated"); + } + + + /// + /// The sub-type to be considered. + /// + public MetaType DerivedType => derivedType; + private readonly MetaType derivedType; + + /// + /// Creates a new SubType instance. + /// + /// The field-number that is used to encapsulate the data (as a nested + /// message) for the derived dype. + /// The sub-type to be considered. + /// Specific encoding style to use; in particular, Grouped can be used to avoid buffering, but is not the default. + public SubType(int fieldNumber, MetaType derivedType, DataFormat format) + { + if (derivedType == null) throw new ArgumentNullException(nameof(derivedType)); + if (fieldNumber <= 0) throw new ArgumentOutOfRangeException(nameof(fieldNumber)); + _fieldNumber = fieldNumber; + this.derivedType = derivedType; + this.dataFormat = format; + } + + private readonly DataFormat dataFormat; + + private IProtoSerializer serializer; + + internal IProtoSerializer Serializer => serializer ?? (serializer = BuildSerializer()); + + private IProtoSerializer BuildSerializer() + { + // note the caller here is MetaType.BuildSerializer, which already has the sync-lock + WireType wireType = WireType.String; + if(dataFormat == DataFormat.Group) wireType = WireType.StartGroup; // only one exception + + IProtoSerializer ser = new SubItemSerializer(derivedType.Type, derivedType.GetKey(false, false), derivedType, false); + return new TagDecorator(_fieldNumber, wireType, false, ser); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeAddedEventArgs.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeAddedEventArgs.cs new file mode 100644 index 0000000..399c638 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeAddedEventArgs.cs @@ -0,0 +1,33 @@ +using System; + +namespace ProtoBuf.Meta +{ + /// + /// Event data associated with new types being added to a model + /// + public sealed class TypeAddedEventArgs : EventArgs + { + internal TypeAddedEventArgs(MetaType metaType) + { + MetaType = metaType; + ApplyDefaultBehaviour = true; + } + + /// + /// Whether or not to apply the default mapping behavior + /// + public bool ApplyDefaultBehaviour { get; set; } + /// + /// The configuration of the type being added + /// + public MetaType MetaType { get; } + /// + /// The type that was added to the model + /// + public Type Type => MetaType.Type; + /// + /// The model that is being changed + /// + public RuntimeTypeModel Model => MetaType.Model as RuntimeTypeModel; + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeFormatEventArgs.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeFormatEventArgs.cs new file mode 100644 index 0000000..3db0999 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeFormatEventArgs.cs @@ -0,0 +1,64 @@ +using System; + +namespace ProtoBuf.Meta +{ + /// + /// Event arguments needed to perform type-formatting functions; this could be resolving a Type to a string suitable for serialization, or could + /// be requesting a Type from a string. If no changes are made, a default implementation will be used (from the assembly-qualified names). + /// + public class TypeFormatEventArgs : EventArgs + { + private Type type; + private string formattedName; + private readonly bool typeFixed; + /// + /// The type involved in this map; if this is initially null, a Type is expected to be provided for the string in FormattedName. + /// + public Type Type + { + get { return type; } + set + { + if (type != value) + { + if (typeFixed) throw new InvalidOperationException("The type is fixed and cannot be changed"); + type = value; + } + } + } + + /// + /// The formatted-name involved in this map; if this is initially null, a formatted-name is expected from the type in Type. + /// + public string FormattedName + { + get { return formattedName; } + set + { + if (formattedName != value) + { + if (!typeFixed) throw new InvalidOperationException("The formatted-name is fixed and cannot be changed"); + formattedName = value; + } + } + } + + internal TypeFormatEventArgs(string formattedName) + { + if (string.IsNullOrEmpty(formattedName)) throw new ArgumentNullException("formattedName"); + this.formattedName = formattedName; + // typeFixed = false; <== implicit + } + + internal TypeFormatEventArgs(Type type) + { + this.type = type ?? throw new ArgumentNullException(nameof(type)); + typeFixed = true; + } + } + + /// + /// Delegate type used to perform type-formatting functions; the sender originates as the type-model. + /// + public delegate void TypeFormatEventHandler(object sender, TypeFormatEventArgs args); +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeModel.InputOutput.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeModel.InputOutput.cs new file mode 100644 index 0000000..9b023a6 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeModel.InputOutput.cs @@ -0,0 +1,45 @@ +using System; +using System.IO; + +namespace ProtoBuf.Meta +{ + partial class TypeModel : + IProtoInput, + IProtoInput>, + IProtoInput, + IProtoOutput + { + static SerializationContext CreateContext(object userState) + { + if (userState == null) + return SerializationContext.Default; + if (userState is SerializationContext ctx) + return ctx; + + var obj = new SerializationContext { Context = userState }; + obj.Freeze(); + return obj; + } + T IProtoInput.Deserialize(Stream source, T value, object userState) + => (T)Deserialize(source, value, typeof(T), CreateContext(userState)); + + T IProtoInput>.Deserialize(ArraySegment source, T value, object userState) + { + using (var ms = new MemoryStream(source.Array, source.Offset, source.Count)) + { + return (T)Deserialize(ms, value, typeof(T), CreateContext(userState)); + } + } + + T IProtoInput.Deserialize(byte[] source, T value, object userState) + { + using (var ms = new MemoryStream(source)) + { + return (T)Deserialize(ms, value, typeof(T), CreateContext(userState)); + } + } + + void IProtoOutput.Serialize(Stream destination, T value, object userState) + => Serialize(destination, value, CreateContext(userState)); + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeModel.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeModel.cs new file mode 100644 index 0000000..1867cf2 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/TypeModel.cs @@ -0,0 +1,1696 @@ +using System; +using System.IO; + +using System.Collections; +using System.Collections.Generic; +using System.Reflection; + +namespace ProtoBuf.Meta +{ + /// + /// Provides protobuf serialization support for a number of types + /// + public abstract partial class TypeModel + { +#if COREFX + internal TypeInfo MapType(TypeInfo type) + { + return type; + } +#endif + + /// + /// Should the Kind be included on date/time values? + /// + protected internal virtual bool SerializeDateTimeKind() { return false; } + + /// + /// Resolve a System.Type to the compiler-specific type + /// + protected internal Type MapType(Type type) + { + return MapType(type, true); + } + /// + /// Resolve a System.Type to the compiler-specific type + /// + protected internal virtual Type MapType(Type type, bool demand) + { + return type; + } + + private WireType GetWireType(ProtoTypeCode code, DataFormat format, ref Type type, out int modelKey) + { + modelKey = -1; + if (Helpers.IsEnum(type)) + { + modelKey = GetKey(ref type); + return WireType.Variant; + } + switch (code) + { + case ProtoTypeCode.Int64: + case ProtoTypeCode.UInt64: + return format == DataFormat.FixedSize ? WireType.Fixed64 : WireType.Variant; + case ProtoTypeCode.Int16: + case ProtoTypeCode.Int32: + case ProtoTypeCode.UInt16: + case ProtoTypeCode.UInt32: + case ProtoTypeCode.Boolean: + case ProtoTypeCode.SByte: + case ProtoTypeCode.Byte: + case ProtoTypeCode.Char: + return format == DataFormat.FixedSize ? WireType.Fixed32 : WireType.Variant; + case ProtoTypeCode.Double: + return WireType.Fixed64; + case ProtoTypeCode.Single: + return WireType.Fixed32; + case ProtoTypeCode.String: + case ProtoTypeCode.DateTime: + case ProtoTypeCode.Decimal: + case ProtoTypeCode.ByteArray: + case ProtoTypeCode.TimeSpan: + case ProtoTypeCode.Guid: + case ProtoTypeCode.Uri: + return WireType.String; + } + + if ((modelKey = GetKey(ref type)) >= 0) + { + return WireType.String; + } + return WireType.None; + } + + + /// + /// This is the more "complete" version of Serialize, which handles single instances of mapped types. + /// The value is written as a complete field, including field-header and (for sub-objects) a + /// length-prefix + /// In addition to that, this provides support for: + /// - basic values; individual int / string / Guid / etc + /// - IEnumerable sequences of any type handled by TrySerializeAuxiliaryType + /// + /// + internal bool TrySerializeAuxiliaryType(ProtoWriter writer, Type type, DataFormat format, int tag, object value, bool isInsideList, object parentList) + { + if (type == null) { type = value.GetType(); } + + ProtoTypeCode typecode = Helpers.GetTypeCode(type); + // note the "ref type" here normalizes against proxies + WireType wireType = GetWireType(typecode, format, ref type, out int modelKey); + + + if (modelKey >= 0) + { // write the header, but defer to the model + if (Helpers.IsEnum(type)) + { // no header + Serialize(modelKey, value, writer); + return true; + } + else + { + ProtoWriter.WriteFieldHeader(tag, wireType, writer); + switch (wireType) + { + case WireType.None: + throw ProtoWriter.CreateException(writer); + case WireType.StartGroup: + case WireType.String: + // needs a wrapping length etc + SubItemToken token = ProtoWriter.StartSubItem(value, writer); + Serialize(modelKey, value, writer); + ProtoWriter.EndSubItem(token, writer); + return true; + default: + Serialize(modelKey, value, writer); + return true; + } + } + } + + if (wireType != WireType.None) + { + ProtoWriter.WriteFieldHeader(tag, wireType, writer); + } + switch (typecode) + { + case ProtoTypeCode.Int16: ProtoWriter.WriteInt16((short)value, writer); return true; + case ProtoTypeCode.Int32: ProtoWriter.WriteInt32((int)value, writer); return true; + case ProtoTypeCode.Int64: ProtoWriter.WriteInt64((long)value, writer); return true; + case ProtoTypeCode.UInt16: ProtoWriter.WriteUInt16((ushort)value, writer); return true; + case ProtoTypeCode.UInt32: ProtoWriter.WriteUInt32((uint)value, writer); return true; + case ProtoTypeCode.UInt64: ProtoWriter.WriteUInt64((ulong)value, writer); return true; + case ProtoTypeCode.Boolean: ProtoWriter.WriteBoolean((bool)value, writer); return true; + case ProtoTypeCode.SByte: ProtoWriter.WriteSByte((sbyte)value, writer); return true; + case ProtoTypeCode.Byte: ProtoWriter.WriteByte((byte)value, writer); return true; + case ProtoTypeCode.Char: ProtoWriter.WriteUInt16((ushort)(char)value, writer); return true; + case ProtoTypeCode.Double: ProtoWriter.WriteDouble((double)value, writer); return true; + case ProtoTypeCode.Single: ProtoWriter.WriteSingle((float)value, writer); return true; + case ProtoTypeCode.DateTime: + if (SerializeDateTimeKind()) + BclHelpers.WriteDateTimeWithKind((DateTime)value, writer); + else + BclHelpers.WriteDateTime((DateTime)value, writer); + return true; + case ProtoTypeCode.Decimal: BclHelpers.WriteDecimal((decimal)value, writer); return true; + case ProtoTypeCode.String: ProtoWriter.WriteString((string)value, writer); return true; + case ProtoTypeCode.ByteArray: ProtoWriter.WriteBytes((byte[])value, writer); return true; + case ProtoTypeCode.TimeSpan: BclHelpers.WriteTimeSpan((TimeSpan)value, writer); return true; + case ProtoTypeCode.Guid: BclHelpers.WriteGuid((Guid)value, writer); return true; + case ProtoTypeCode.Uri: ProtoWriter.WriteString(((Uri)value).OriginalString, writer); return true; + } + + // by now, we should have covered all the simple cases; if we wrote a field-header, we have + // forgotten something! + Helpers.DebugAssert(wireType == WireType.None); + + // now attempt to handle sequences (including arrays and lists) + if (value is IEnumerable sequence) + { + if (isInsideList) throw CreateNestedListsNotSupported(parentList?.GetType()); + foreach (object item in sequence) + { + if (item == null) { throw new NullReferenceException(); } + if (!TrySerializeAuxiliaryType(writer, null, format, tag, item, true, sequence)) + { + ThrowUnexpectedType(item.GetType()); + } + } + return true; + } + return false; + } + + private void SerializeCore(ProtoWriter writer, object value) + { + if (value == null) throw new ArgumentNullException(nameof(value)); + Type type = value.GetType(); + int key = GetKey(ref type); + if (key >= 0) + { + Serialize(key, value, writer); + } + else if (!TrySerializeAuxiliaryType(writer, type, DataFormat.Default, Serializer.ListItemTag, value, false, null)) + { + ThrowUnexpectedType(type); + } + } + + /// + /// Writes a protocol-buffer representation of the given instance to the supplied stream. + /// + /// The existing instance to be serialized (cannot be null). + /// The destination stream to write to. + public void Serialize(Stream dest, object value) + { + Serialize(dest, value, null); + } + + /// + /// Writes a protocol-buffer representation of the given instance to the supplied stream. + /// + /// The existing instance to be serialized (cannot be null). + /// The destination stream to write to. + /// Additional information about this serialization operation. + public void Serialize(Stream dest, object value, SerializationContext context) + { + using (ProtoWriter writer = ProtoWriter.Create(dest, this, context)) + { + writer.SetRootObject(value); + SerializeCore(writer, value); + writer.Close(); + } + } + + /// + /// Writes a protocol-buffer representation of the given instance to the supplied writer. + /// + /// The existing instance to be serialized (cannot be null). + /// The destination writer to write to. + public void Serialize(ProtoWriter dest, object value) + { + if (dest == null) throw new ArgumentNullException(nameof(dest)); + dest.CheckDepthFlushlock(); + dest.SetRootObject(value); + SerializeCore(dest, value); + dest.CheckDepthFlushlock(); + ProtoWriter.Flush(dest); + } + + /// + /// Applies a protocol-buffer stream to an existing instance (or null), using length-prefixed + /// data - useful with network IO. + /// + /// The type being merged. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// How to encode the length prefix. + /// The tag used as a prefix to each record (only used with base-128 style prefixes). + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + public object DeserializeWithLengthPrefix(Stream source, object value, Type type, PrefixStyle style, int fieldNumber) + => DeserializeWithLengthPrefix(source, value, type, style, fieldNumber, null, out long bytesRead); + + /// + /// Applies a protocol-buffer stream to an existing instance (or null), using length-prefixed + /// data - useful with network IO. + /// + /// The type being merged. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// How to encode the length prefix. + /// The tag used as a prefix to each record (only used with base-128 style prefixes). + /// Used to resolve types on a per-field basis. + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + public object DeserializeWithLengthPrefix(Stream source, object value, Type type, PrefixStyle style, int expectedField, Serializer.TypeResolver resolver) + => DeserializeWithLengthPrefix(source, value, type, style, expectedField, resolver, out long bytesRead); + + /// + /// Applies a protocol-buffer stream to an existing instance (or null), using length-prefixed + /// data - useful with network IO. + /// + /// The type being merged. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// How to encode the length prefix. + /// The tag used as a prefix to each record (only used with base-128 style prefixes). + /// Used to resolve types on a per-field basis. + /// Returns the number of bytes consumed by this operation (includes length-prefix overheads and any skipped data). + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + public object DeserializeWithLengthPrefix(Stream source, object value, Type type, PrefixStyle style, int expectedField, Serializer.TypeResolver resolver, out int bytesRead) + { + object result = DeserializeWithLengthPrefix(source, value, type, style, expectedField, resolver, out long bytesRead64, out bool haveObject, null); + bytesRead = checked((int)bytesRead64); + return result; + } + + /// + /// Applies a protocol-buffer stream to an existing instance (or null), using length-prefixed + /// data - useful with network IO. + /// + /// The type being merged. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// How to encode the length prefix. + /// The tag used as a prefix to each record (only used with base-128 style prefixes). + /// Used to resolve types on a per-field basis. + /// Returns the number of bytes consumed by this operation (includes length-prefix overheads and any skipped data). + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + public object DeserializeWithLengthPrefix(Stream source, object value, Type type, PrefixStyle style, int expectedField, Serializer.TypeResolver resolver, out long bytesRead) => DeserializeWithLengthPrefix(source, value, type, style, expectedField, resolver, out bytesRead, out bool haveObject, null); + + private object DeserializeWithLengthPrefix(Stream source, object value, Type type, PrefixStyle style, int expectedField, Serializer.TypeResolver resolver, out long bytesRead, out bool haveObject, SerializationContext context) + { + haveObject = false; + bool skip; + long len; + bytesRead = 0; + if (type == null && (style != PrefixStyle.Base128 || resolver == null)) + { + throw new InvalidOperationException("A type must be provided unless base-128 prefixing is being used in combination with a resolver"); + } + do + { + + bool expectPrefix = expectedField > 0 || resolver != null; + len = ProtoReader.ReadLongLengthPrefix(source, expectPrefix, style, out int actualField, out int tmpBytesRead); + if (tmpBytesRead == 0) return value; + bytesRead += tmpBytesRead; + if (len < 0) return value; + + switch (style) + { + case PrefixStyle.Base128: + if (expectPrefix && expectedField == 0 && type == null && resolver != null) + { + type = resolver(actualField); + skip = type == null; + } + else { skip = expectedField != actualField; } + break; + default: + skip = false; + break; + } + + if (skip) + { + if (len == long.MaxValue) throw new InvalidOperationException(); + ProtoReader.Seek(source, len, null); + bytesRead += len; + } + } while (skip); + + ProtoReader reader = null; + try + { + reader = ProtoReader.Create(source, this, context, len); + int key = GetKey(ref type); + if (key >= 0 && !Helpers.IsEnum(type)) + { + value = Deserialize(key, value, reader); + } + else + { + if (!(TryDeserializeAuxiliaryType(reader, DataFormat.Default, Serializer.ListItemTag, type, ref value, true, false, true, false, null) || len == 0)) + { + TypeModel.ThrowUnexpectedType(type); // throws + } + } + bytesRead += reader.LongPosition; + haveObject = true; + return value; + } + finally + { + ProtoReader.Recycle(reader); + } + } + + /// + /// Reads a sequence of consecutive length-prefixed items from a stream, using + /// either base-128 or fixed-length prefixes. Base-128 prefixes with a tag + /// are directly comparable to serializing multiple items in succession + /// (use the tag to emulate the implicit behavior + /// when serializing a list/array). When a tag is + /// specified, any records with different tags are silently omitted. The + /// tag is ignored. The tag is ignores for fixed-length prefixes. + /// + /// The binary stream containing the serialized records. + /// The prefix style used in the data. + /// The tag of records to return (if non-positive, then no tag is + /// expected and all records are returned). + /// On a field-by-field basis, the type of object to deserialize (can be null if "type" is specified). + /// The type of object to deserialize (can be null if "resolver" is specified). + /// The sequence of deserialized objects. + public IEnumerable DeserializeItems(System.IO.Stream source, Type type, PrefixStyle style, int expectedField, Serializer.TypeResolver resolver) + { + return DeserializeItems(source, type, style, expectedField, resolver, null); + } + /// + /// Reads a sequence of consecutive length-prefixed items from a stream, using + /// either base-128 or fixed-length prefixes. Base-128 prefixes with a tag + /// are directly comparable to serializing multiple items in succession + /// (use the tag to emulate the implicit behavior + /// when serializing a list/array). When a tag is + /// specified, any records with different tags are silently omitted. The + /// tag is ignored. The tag is ignores for fixed-length prefixes. + /// + /// The binary stream containing the serialized records. + /// The prefix style used in the data. + /// The tag of records to return (if non-positive, then no tag is + /// expected and all records are returned). + /// On a field-by-field basis, the type of object to deserialize (can be null if "type" is specified). + /// The type of object to deserialize (can be null if "resolver" is specified). + /// The sequence of deserialized objects. + /// Additional information about this serialization operation. + public IEnumerable DeserializeItems(System.IO.Stream source, Type type, PrefixStyle style, int expectedField, Serializer.TypeResolver resolver, SerializationContext context) + { + return new DeserializeItemsIterator(this, source, type, style, expectedField, resolver, context); + } + + /// + /// Reads a sequence of consecutive length-prefixed items from a stream, using + /// either base-128 or fixed-length prefixes. Base-128 prefixes with a tag + /// are directly comparable to serializing multiple items in succession + /// (use the tag to emulate the implicit behavior + /// when serializing a list/array). When a tag is + /// specified, any records with different tags are silently omitted. The + /// tag is ignored. The tag is ignores for fixed-length prefixes. + /// + /// The type of object to deserialize. + /// The binary stream containing the serialized records. + /// The prefix style used in the data. + /// The tag of records to return (if non-positive, then no tag is + /// expected and all records are returned). + /// The sequence of deserialized objects. + public IEnumerable DeserializeItems(Stream source, PrefixStyle style, int expectedField) + { + return DeserializeItems(source, style, expectedField, null); + } + /// + /// Reads a sequence of consecutive length-prefixed items from a stream, using + /// either base-128 or fixed-length prefixes. Base-128 prefixes with a tag + /// are directly comparable to serializing multiple items in succession + /// (use the tag to emulate the implicit behavior + /// when serializing a list/array). When a tag is + /// specified, any records with different tags are silently omitted. The + /// tag is ignored. The tag is ignores for fixed-length prefixes. + /// + /// The type of object to deserialize. + /// The binary stream containing the serialized records. + /// The prefix style used in the data. + /// The tag of records to return (if non-positive, then no tag is + /// expected and all records are returned). + /// The sequence of deserialized objects. + /// Additional information about this serialization operation. + public IEnumerable DeserializeItems(Stream source, PrefixStyle style, int expectedField, SerializationContext context) + { + return new DeserializeItemsIterator(this, source, style, expectedField, context); + } + + private sealed class DeserializeItemsIterator : DeserializeItemsIterator, + IEnumerator, + IEnumerable + { + IEnumerator IEnumerable.GetEnumerator() { return this; } + public new T Current { get { return (T)base.Current; } } + void IDisposable.Dispose() { } + public DeserializeItemsIterator(TypeModel model, Stream source, PrefixStyle style, int expectedField, SerializationContext context) + : base(model, source, model.MapType(typeof(T)), style, expectedField, null, context) { } + } + + private class DeserializeItemsIterator : IEnumerator, IEnumerable + { + IEnumerator IEnumerable.GetEnumerator() { return this; } + private bool haveObject; + private object current; + public bool MoveNext() + { + if (haveObject) + { + current = model.DeserializeWithLengthPrefix(source, null, type, style, expectedField, resolver, out long bytesRead, out haveObject, context); + } + return haveObject; + } + void IEnumerator.Reset() { throw new NotSupportedException(); } + public object Current { get { return current; } } + private readonly Stream source; + private readonly Type type; + private readonly PrefixStyle style; + private readonly int expectedField; + private readonly Serializer.TypeResolver resolver; + private readonly TypeModel model; + private readonly SerializationContext context; + public DeserializeItemsIterator(TypeModel model, Stream source, Type type, PrefixStyle style, int expectedField, Serializer.TypeResolver resolver, SerializationContext context) + { + haveObject = true; + this.source = source; + this.type = type; + this.style = style; + this.expectedField = expectedField; + this.resolver = resolver; + this.model = model; + this.context = context; + } + } + + /// + /// Writes a protocol-buffer representation of the given instance to the supplied stream, + /// with a length-prefix. This is useful for socket programming, + /// as DeserializeWithLengthPrefix can be used to read the single object back + /// from an ongoing stream. + /// + /// The type being serialized. + /// The existing instance to be serialized (cannot be null). + /// How to encode the length prefix. + /// The destination stream to write to. + /// The tag used as a prefix to each record (only used with base-128 style prefixes). + public void SerializeWithLengthPrefix(Stream dest, object value, Type type, PrefixStyle style, int fieldNumber) + { + SerializeWithLengthPrefix(dest, value, type, style, fieldNumber, null); + } + + /// + /// Writes a protocol-buffer representation of the given instance to the supplied stream, + /// with a length-prefix. This is useful for socket programming, + /// as DeserializeWithLengthPrefix can be used to read the single object back + /// from an ongoing stream. + /// + /// The type being serialized. + /// The existing instance to be serialized (cannot be null). + /// How to encode the length prefix. + /// The destination stream to write to. + /// The tag used as a prefix to each record (only used with base-128 style prefixes). + /// Additional information about this serialization operation. + public void SerializeWithLengthPrefix(Stream dest, object value, Type type, PrefixStyle style, int fieldNumber, SerializationContext context) + { + if (type == null) + { + if (value == null) throw new ArgumentNullException(nameof(value)); + type = MapType(value.GetType()); + } + int key = GetKey(ref type); + using (ProtoWriter writer = ProtoWriter.Create(dest, this, context)) + { + switch (style) + { + case PrefixStyle.None: + Serialize(key, value, writer); + break; + case PrefixStyle.Base128: + case PrefixStyle.Fixed32: + case PrefixStyle.Fixed32BigEndian: + ProtoWriter.WriteObject(value, key, writer, style, fieldNumber); + break; + default: + throw new ArgumentOutOfRangeException("style"); + } + writer.Close(); + } + } + /// + /// Applies a protocol-buffer stream to an existing instance (which may be null). + /// + /// The type (including inheritance) to consider. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + public object Deserialize(Stream source, object value, Type type) + { + return Deserialize(source, value, type, null); + } + + /// + /// Applies a protocol-buffer stream to an existing instance (which may be null). + /// + /// The type (including inheritance) to consider. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + /// Additional information about this serialization operation. + public object Deserialize(Stream source, object value, Type type, SerializationContext context) + { + bool autoCreate = PrepareDeserialize(value, ref type); + ProtoReader reader = null; + try + { + reader = ProtoReader.Create(source, this, context, ProtoReader.TO_EOF); + if (value != null) reader.SetRootObject(value); + object obj = DeserializeCore(reader, type, value, autoCreate); + reader.CheckFullyConsumed(); + return obj; + } + finally + { + ProtoReader.Recycle(reader); + } + } + + private bool PrepareDeserialize(object value, ref Type type) + { + if (type == null) + { + if (value == null) + { + throw new ArgumentNullException(nameof(type)); + } + else + { + type = MapType(value.GetType()); + } + } + + bool autoCreate = true; + Type underlyingType = Helpers.GetUnderlyingType(type); + if (underlyingType != null) + { + type = underlyingType; + autoCreate = false; + } + return autoCreate; + } + + /// + /// Applies a protocol-buffer stream to an existing instance (which may be null). + /// + /// The type (including inheritance) to consider. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// The number of bytes to consume. + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + public object Deserialize(Stream source, object value, System.Type type, int length) + => Deserialize(source, value, type, length, null); + + /// + /// Applies a protocol-buffer stream to an existing instance (which may be null). + /// + /// The type (including inheritance) to consider. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// The number of bytes to consume. + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + public object Deserialize(Stream source, object value, System.Type type, long length) + => Deserialize(source, value, type, length, null); + + /// + /// Applies a protocol-buffer stream to an existing instance (which may be null). + /// + /// The type (including inheritance) to consider. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// The number of bytes to consume (or -1 to read to the end of the stream). + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + /// Additional information about this serialization operation. + public object Deserialize(Stream source, object value, System.Type type, int length, SerializationContext context) + => Deserialize(source, value, type, length == int.MaxValue ? long.MaxValue : (long)length, context); + + /// + /// Applies a protocol-buffer stream to an existing instance (which may be null). + /// + /// The type (including inheritance) to consider. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// The number of bytes to consume (or -1 to read to the end of the stream). + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + /// Additional information about this serialization operation. + public object Deserialize(Stream source, object value, System.Type type, long length, SerializationContext context) + { + bool autoCreate = PrepareDeserialize(value, ref type); + ProtoReader reader = null; + try + { + reader = ProtoReader.Create(source, this, context, length); + if (value != null) reader.SetRootObject(value); + object obj = DeserializeCore(reader, type, value, autoCreate); + reader.CheckFullyConsumed(); + return obj; + } + finally + { + ProtoReader.Recycle(reader); + } + } + + /// + /// Applies a protocol-buffer reader to an existing instance (which may be null). + /// + /// The type (including inheritance) to consider. + /// The existing instance to be modified (can be null). + /// The reader to apply to the instance (cannot be null). + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + public object Deserialize(ProtoReader source, object value, System.Type type) + { + if (source == null) throw new ArgumentNullException("source"); + bool autoCreate = PrepareDeserialize(value, ref type); + if (value != null) source.SetRootObject(value); + object obj = DeserializeCore(source, type, value, autoCreate); + source.CheckFullyConsumed(); + return obj; + } + + private object DeserializeCore(ProtoReader reader, Type type, object value, bool noAutoCreate) + { + int key = GetKey(ref type); + if (key >= 0 && !Helpers.IsEnum(type)) + { + return Deserialize(key, value, reader); + } + // this returns true to say we actively found something, but a value is assigned either way (or throws) + TryDeserializeAuxiliaryType(reader, DataFormat.Default, Serializer.ListItemTag, type, ref value, true, false, noAutoCreate, false, null); + return value; + } + +#if COREFX + private static readonly System.Reflection.TypeInfo ilist = typeof(IList).GetTypeInfo(); +#else + private static readonly System.Type ilist = typeof(IList); +#endif + internal static MethodInfo ResolveListAdd(TypeModel model, Type listType, Type itemType, out bool isList) + { +#if COREFX || PROFILE259 + TypeInfo listTypeInfo = listType.GetTypeInfo(); +#else + Type listTypeInfo = listType; +#endif +#if PROFILE259 + isList = model.MapType(ilist).GetTypeInfo().IsAssignableFrom(listTypeInfo); +#else + isList = model.MapType(ilist).IsAssignableFrom(listTypeInfo); +#endif + Type[] types = { itemType }; + MethodInfo add = Helpers.GetInstanceMethod(listTypeInfo, "Add", types); + +#if !NO_GENERICS + if (add == null) + { // fallback: look for ICollection's Add(typedObject) method + + bool forceList = listTypeInfo.IsInterface && + model.MapType(typeof(System.Collections.Generic.IEnumerable<>)).MakeGenericType(types) +#if COREFX || PROFILE259 + .GetTypeInfo() +#endif + .IsAssignableFrom(listTypeInfo); + +#if COREFX || PROFILE259 + TypeInfo constuctedListType = typeof(System.Collections.Generic.ICollection<>).MakeGenericType(types).GetTypeInfo(); +#else + Type constuctedListType = model.MapType(typeof(System.Collections.Generic.ICollection<>)).MakeGenericType(types); +#endif + if (forceList || constuctedListType.IsAssignableFrom(listTypeInfo)) + { + add = Helpers.GetInstanceMethod(constuctedListType, "Add", types); + } + } + + if (add == null) + { + +#if COREFX || PROFILE259 + foreach (Type tmpType in listTypeInfo.ImplementedInterfaces) +#else + foreach (Type interfaceType in listTypeInfo.GetInterfaces()) +#endif + { +#if COREFX || PROFILE259 + TypeInfo interfaceType = tmpType.GetTypeInfo(); +#endif + if (interfaceType.Name == "IProducerConsumerCollection`1" && interfaceType.IsGenericType && interfaceType.GetGenericTypeDefinition().FullName == "System.Collections.Concurrent.IProducerConsumerCollection`1") + { + add = Helpers.GetInstanceMethod(interfaceType, "TryAdd", types); + if (add != null) break; + } + } + } +#endif + + if (add == null) + { // fallback: look for a public list.Add(object) method + types[0] = model.MapType(typeof(object)); + add = Helpers.GetInstanceMethod(listTypeInfo, "Add", types); + } + if (add == null && isList) + { // fallback: look for IList's Add(object) method + add = Helpers.GetInstanceMethod(model.MapType(ilist), "Add", types); + } + return add; + } + internal static Type GetListItemType(TypeModel model, Type listType) + { + Helpers.DebugAssert(listType != null); + +#if PROFILE259 + TypeInfo listTypeInfo = listType.GetTypeInfo(); + if (listType == typeof(string) || listType.IsArray + || !typeof(IEnumerable).GetTypeInfo().IsAssignableFrom(listTypeInfo)) return null; +#else + if (listType == model.MapType(typeof(string)) || listType.IsArray + || !model.MapType(typeof(IEnumerable)).IsAssignableFrom(listType)) return null; +#endif + + BasicList candidates = new BasicList(); +#if PROFILE259 + foreach (MethodInfo method in listType.GetRuntimeMethods()) +#else + foreach (MethodInfo method in listType.GetMethods()) +#endif + { + if (method.IsStatic || method.Name != "Add") continue; + ParameterInfo[] parameters = method.GetParameters(); + Type paramType; + if (parameters.Length == 1 && !candidates.Contains(paramType = parameters[0].ParameterType)) + { + candidates.Add(paramType); + } + } + + string name = listType.Name; + bool isQueueStack = name != null && (name.IndexOf("Queue") >= 0 || name.IndexOf("Stack") >= 0); + + if (!isQueueStack) + { + TestEnumerableListPatterns(model, candidates, listType); +#if PROFILE259 + foreach (Type iType in listTypeInfo.ImplementedInterfaces) + { + TestEnumerableListPatterns(model, candidates, iType); + } +#else + foreach (Type iType in listType.GetInterfaces()) + { + TestEnumerableListPatterns(model, candidates, iType); + } +#endif + } + +#if PROFILE259 + // more convenient GetProperty overload not supported on all platforms + foreach (PropertyInfo indexer in listType.GetRuntimeProperties()) + { + if (indexer.Name != "Item" || candidates.Contains(indexer.PropertyType)) continue; + ParameterInfo[] args = indexer.GetIndexParameters(); + if (args.Length != 1 || args[0].ParameterType != typeof(int)) continue; + MethodInfo getter = indexer.GetMethod; + if (getter == null || getter.IsStatic) continue; + candidates.Add(indexer.PropertyType); + } +#else + // more convenient GetProperty overload not supported on all platforms + foreach (PropertyInfo indexer in listType.GetProperties(BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic)) + { + if (indexer.Name != "Item" || candidates.Contains(indexer.PropertyType)) continue; + ParameterInfo[] args = indexer.GetIndexParameters(); + if (args.Length != 1 || args[0].ParameterType != model.MapType(typeof(int))) continue; + candidates.Add(indexer.PropertyType); + } +#endif + + switch (candidates.Count) + { + case 0: + return null; + case 1: + if ((Type)candidates[0] == listType) return null; // recursive + return (Type)candidates[0]; + case 2: + if ((Type)candidates[0] != listType && CheckDictionaryAccessors(model, (Type)candidates[0], (Type)candidates[1])) return (Type)candidates[0]; + if ((Type)candidates[1] != listType && CheckDictionaryAccessors(model, (Type)candidates[1], (Type)candidates[0])) return (Type)candidates[1]; + break; + } + + return null; + } + + private static void TestEnumerableListPatterns(TypeModel model, BasicList candidates, Type iType) + { + +#if COREFX || PROFILE259 + TypeInfo iTypeInfo = iType.GetTypeInfo(); + if (iTypeInfo.IsGenericType) + { + Type typeDef = iTypeInfo.GetGenericTypeDefinition(); + if( + typeDef == model.MapType(typeof(System.Collections.Generic.IEnumerable<>)) + || typeDef == model.MapType(typeof(System.Collections.Generic.ICollection<>)) + || typeDef.GetTypeInfo().FullName == "System.Collections.Concurrent.IProducerConsumerCollection`1") + { + + Type[] iTypeArgs = iTypeInfo.GenericTypeArguments; + if (!candidates.Contains(iTypeArgs[0])) + { + candidates.Add(iTypeArgs[0]); + } + } + } +#else + if (iType.IsGenericType) + { + Type typeDef = iType.GetGenericTypeDefinition(); + if (typeDef == model.MapType(typeof(System.Collections.Generic.IEnumerable<>)) + || typeDef == model.MapType(typeof(System.Collections.Generic.ICollection<>)) + || typeDef.FullName == "System.Collections.Concurrent.IProducerConsumerCollection`1") + { + Type[] iTypeArgs = iType.GetGenericArguments(); + if (!candidates.Contains(iTypeArgs[0])) + { + candidates.Add(iTypeArgs[0]); + } + } + } +#endif + } + + private static bool CheckDictionaryAccessors(TypeModel model, Type pair, Type value) + { +#if COREFX || PROFILE259 + TypeInfo finalType = pair.GetTypeInfo(); + return finalType.IsGenericType && finalType.GetGenericTypeDefinition() == typeof(System.Collections.Generic.KeyValuePair<,>) + && finalType.GenericTypeArguments[1] == value; +#else + return pair.IsGenericType && pair.GetGenericTypeDefinition() == model.MapType(typeof(System.Collections.Generic.KeyValuePair<,>)) + && pair.GetGenericArguments()[1] == value; +#endif + } + + private bool TryDeserializeList(TypeModel model, ProtoReader reader, DataFormat format, int tag, Type listType, Type itemType, ref object value) + { + MethodInfo addMethod = TypeModel.ResolveListAdd(model, listType, itemType, out bool isList); + if (addMethod == null) throw new NotSupportedException("Unknown list variant: " + listType.FullName); + bool found = false; + object nextItem = null; + IList list = value as IList; + object[] args = isList ? null : new object[1]; + BasicList arraySurrogate = listType.IsArray ? new BasicList() : null; + + while (TryDeserializeAuxiliaryType(reader, format, tag, itemType, ref nextItem, true, true, true, true, value ?? listType)) + { + found = true; + if (value == null && arraySurrogate == null) + { + value = CreateListInstance(listType, itemType); + list = value as IList; + } + if (list != null) + { + list.Add(nextItem); + } + else if (arraySurrogate != null) + { + arraySurrogate.Add(nextItem); + } + else + { + args[0] = nextItem; + addMethod.Invoke(value, args); + } + nextItem = null; + } + if (arraySurrogate != null) + { + Array newArray; + if (value != null) + { + if (arraySurrogate.Count == 0) + { // we'll stay with what we had, thanks + } + else + { + Array existing = (Array)value; + newArray = Array.CreateInstance(itemType, existing.Length + arraySurrogate.Count); + Array.Copy(existing, newArray, existing.Length); + arraySurrogate.CopyTo(newArray, existing.Length); + value = newArray; + } + } + else + { + newArray = Array.CreateInstance(itemType, arraySurrogate.Count); + arraySurrogate.CopyTo(newArray, 0); + value = newArray; + } + } + return found; + } + + private static object CreateListInstance(Type listType, Type itemType) + { + Type concreteListType = listType; + + if (listType.IsArray) + { + return Array.CreateInstance(itemType, 0); + } + +#if COREFX || PROFILE259 + TypeInfo listTypeInfo = listType.GetTypeInfo(); + if (!listTypeInfo.IsClass || listTypeInfo.IsAbstract || + Helpers.GetConstructor(listTypeInfo, Helpers.EmptyTypes, true) == null) +#else + if (!listType.IsClass || listType.IsAbstract || + Helpers.GetConstructor(listType, Helpers.EmptyTypes, true) == null) +#endif + { + string fullName; + bool handled = false; +#if COREFX || PROFILE259 + if (listTypeInfo.IsInterface && +#else + if (listType.IsInterface && +#endif + (fullName = listType.FullName) != null && fullName.IndexOf("Dictionary") >= 0) // have to try to be frugal here... + { +#if COREFX || PROFILE259 + TypeInfo finalType = listType.GetTypeInfo(); + if (finalType.IsGenericType && finalType.GetGenericTypeDefinition() == typeof(System.Collections.Generic.IDictionary<,>)) + { + Type[] genericTypes = listType.GenericTypeArguments; + concreteListType = typeof(System.Collections.Generic.Dictionary<,>).MakeGenericType(genericTypes); + handled = true; + } +#else + if (listType.IsGenericType && listType.GetGenericTypeDefinition() == typeof(System.Collections.Generic.IDictionary<,>)) + { + Type[] genericTypes = listType.GetGenericArguments(); + concreteListType = typeof(System.Collections.Generic.Dictionary<,>).MakeGenericType(genericTypes); + handled = true; + } +#endif + +#if !PORTABLE && !COREFX && !PROFILE259 + if (!handled && listType == typeof(IDictionary)) + { + concreteListType = typeof(Hashtable); + handled = true; + } +#endif + } + + if (!handled) + { + concreteListType = typeof(System.Collections.Generic.List<>).MakeGenericType(itemType); + handled = true; + } + +#if !PORTABLE && !COREFX && !PROFILE259 + if (!handled) + { + concreteListType = typeof(ArrayList); + handled = true; + } +#endif + } + return Activator.CreateInstance(concreteListType); + } + + /// + /// This is the more "complete" version of Deserialize, which handles single instances of mapped types. + /// The value is read as a complete field, including field-header and (for sub-objects) a + /// length-prefix..kmc + /// + /// In addition to that, this provides support for: + /// - basic values; individual int / string / Guid / etc + /// - IList sets of any type handled by TryDeserializeAuxiliaryType + /// + internal bool TryDeserializeAuxiliaryType(ProtoReader reader, DataFormat format, int tag, Type type, ref object value, bool skipOtherFields, bool asListItem, bool autoCreate, bool insideList, object parentListOrType) + { + if (type == null) throw new ArgumentNullException(nameof(type)); + Type itemType = null; + ProtoTypeCode typecode = Helpers.GetTypeCode(type); + WireType wiretype = GetWireType(typecode, format, ref type, out int modelKey); + + bool found = false; + if (wiretype == WireType.None) + { + itemType = GetListItemType(this, type); + if (itemType == null && type.IsArray && type.GetArrayRank() == 1 && type != typeof(byte[])) + { + itemType = type.GetElementType(); + } + if (itemType != null) + { + if (insideList) throw TypeModel.CreateNestedListsNotSupported((parentListOrType as Type) ?? (parentListOrType?.GetType())); + found = TryDeserializeList(this, reader, format, tag, type, itemType, ref value); + if (!found && autoCreate) + { + value = CreateListInstance(type, itemType); + } + return found; + } + + // otherwise, not a happy bunny... + ThrowUnexpectedType(type); + } + + // to treat correctly, should read all values + + while (true) + { + // for convenience (re complex exit conditions), additional exit test here: + // if we've got the value, are only looking for one, and we aren't a list - then exit + if (found && asListItem) break; + + + // read the next item + int fieldNumber = reader.ReadFieldHeader(); + if (fieldNumber <= 0) break; + if (fieldNumber != tag) + { + if (skipOtherFields) + { + reader.SkipField(); + continue; + } + throw ProtoReader.AddErrorData(new InvalidOperationException( + "Expected field " + tag.ToString() + ", but found " + fieldNumber.ToString()), reader); + } + found = true; + reader.Hint(wiretype); // handle signed data etc + + if (modelKey >= 0) + { + switch (wiretype) + { + case WireType.String: + case WireType.StartGroup: + SubItemToken token = ProtoReader.StartSubItem(reader); + value = Deserialize(modelKey, value, reader); + ProtoReader.EndSubItem(token, reader); + continue; + default: + value = Deserialize(modelKey, value, reader); + continue; + } + } + switch (typecode) + { + case ProtoTypeCode.Int16: value = reader.ReadInt16(); continue; + case ProtoTypeCode.Int32: value = reader.ReadInt32(); continue; + case ProtoTypeCode.Int64: value = reader.ReadInt64(); continue; + case ProtoTypeCode.UInt16: value = reader.ReadUInt16(); continue; + case ProtoTypeCode.UInt32: value = reader.ReadUInt32(); continue; + case ProtoTypeCode.UInt64: value = reader.ReadUInt64(); continue; + case ProtoTypeCode.Boolean: value = reader.ReadBoolean(); continue; + case ProtoTypeCode.SByte: value = reader.ReadSByte(); continue; + case ProtoTypeCode.Byte: value = reader.ReadByte(); continue; + case ProtoTypeCode.Char: value = (char)reader.ReadUInt16(); continue; + case ProtoTypeCode.Double: value = reader.ReadDouble(); continue; + case ProtoTypeCode.Single: value = reader.ReadSingle(); continue; + case ProtoTypeCode.DateTime: value = BclHelpers.ReadDateTime(reader); continue; + case ProtoTypeCode.Decimal: value = BclHelpers.ReadDecimal(reader); continue; + case ProtoTypeCode.String: value = reader.ReadString(); continue; + case ProtoTypeCode.ByteArray: value = ProtoReader.AppendBytes((byte[])value, reader); continue; + case ProtoTypeCode.TimeSpan: value = BclHelpers.ReadTimeSpan(reader); continue; + case ProtoTypeCode.Guid: value = BclHelpers.ReadGuid(reader); continue; + case ProtoTypeCode.Uri: value = new Uri(reader.ReadString(), UriKind.RelativeOrAbsolute); continue; + } + + } + if (!found && !asListItem && autoCreate) + { + if (type != typeof(string)) + { + value = Activator.CreateInstance(type); + } + } + return found; + } + +#if !NO_RUNTIME + /// + /// Creates a new runtime model, to which the caller + /// can add support for a range of types. A model + /// can be used "as is", or can be compiled for + /// optimal performance. + /// + [Obsolete("Please use RuntimeTypeModel.Create", false)] + public static RuntimeTypeModel Create() + { + return RuntimeTypeModel.Create(); + } +#endif + + /// + /// Applies common proxy scenarios, resolving the actual type to consider + /// + protected internal static Type ResolveProxies(Type type) + { + if (type == null) return null; +#if !NO_GENERICS + if (type.IsGenericParameter) return null; + // Nullable + Type tmp = Helpers.GetUnderlyingType(type); + if (tmp != null) return tmp; +#endif + +#if !CF + // EF POCO + string fullName = type.FullName; + if (fullName != null && fullName.StartsWith("System.Data.Entity.DynamicProxies.")) + { +#if COREFX || PROFILE259 + return type.GetTypeInfo().BaseType; +#else + return type.BaseType; +#endif + } + + // NHibernate +#if PROFILE259 + IEnumerable interfaces = type.GetTypeInfo().ImplementedInterfaces; +#else + Type[] interfaces = type.GetInterfaces(); +#endif + foreach (Type t in interfaces) + { + switch (t.FullName) + { + case "NHibernate.Proxy.INHibernateProxy": + case "NHibernate.Proxy.DynamicProxy.IProxy": + case "NHibernate.Intercept.IFieldInterceptorAccessor": +#if COREFX || PROFILE259 + return type.GetTypeInfo().BaseType; +#else + return type.BaseType; +#endif + } + } +#endif + return null; + } + + /// + /// Indicates whether the supplied type is explicitly modelled by the model + /// + public bool IsDefined(Type type) => GetKey(ref type) >= 0; + + readonly Dictionary knownKeys = new Dictionary(); + + // essentially just a ValueTuple - I just don't want the extra dependency + private readonly struct KnownTypeKey + { + public KnownTypeKey(Type type, int key) + { + Type = type; + Key = key; + } + + public int Key { get; } + + public Type Type { get; } + } + + /// + /// Provides the key that represents a given type in the current model. + /// The type is also normalized for proxies at the same time. + /// + protected internal int GetKey(ref Type type) + { + if (type == null) return -1; + int key; + lock (knownKeys) + { + if (knownKeys.TryGetValue(type, out var tuple)) + { + // the type can be changed via ResolveProxies etc +#if DEBUG + var actualKey = GetKeyImpl(type); + if(actualKey != tuple.Key) + { + throw new InvalidOperationException( + $"Key cache failure; got {tuple.Key} instead of {actualKey} for '{type.Name}'"); + } +#endif + type = tuple.Type; + return tuple.Key; + } + } + key = GetKeyImpl(type); + Type originalType = type; + if (key < 0) + { + Type normalized = ResolveProxies(type); + if (normalized != null && normalized != type) + { + type = normalized; // hence ref + key = GetKeyImpl(type); + } + } + lock (knownKeys) + { + knownKeys[originalType] = new KnownTypeKey(type, key); + } + return key; + } + + /// + /// Advertise that a type's key can have changed + /// + internal void ResetKeyCache() + { + // clear *everything* (think: multi-level - can be many descendents) + lock(knownKeys) + { + knownKeys.Clear(); + } + } + + /// + /// Provides the key that represents a given type in the current model. + /// + protected abstract int GetKeyImpl(Type type); + /// + /// Writes a protocol-buffer representation of the given instance to the supplied stream. + /// + /// Represents the type (including inheritance) to consider. + /// The existing instance to be serialized (cannot be null). + /// The destination stream to write to. + protected internal abstract void Serialize(int key, object value, ProtoWriter dest); + + /// + /// Applies a protocol-buffer stream to an existing instance (which may be null). + /// + /// Represents the type (including inheritance) to consider. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + protected internal abstract object Deserialize(int key, object value, ProtoReader source); + + //internal ProtoSerializer Create(IProtoSerializer head) + //{ + // return new RuntimeSerializer(head, this); + //} + //internal ProtoSerializer Compile + + /// + /// Indicates the type of callback to be used + /// + protected internal enum CallbackType + { + /// + /// Invoked before an object is serialized + /// + BeforeSerialize, + /// + /// Invoked after an object is serialized + /// + AfterSerialize, + /// + /// Invoked before an object is deserialized (or when a new instance is created) + /// + BeforeDeserialize, + /// + /// Invoked after an object is deserialized + /// + AfterDeserialize + } + + /// + /// Create a deep clone of the supplied instance; any sub-items are also cloned. + /// + public object DeepClone(object value) + { + if (value == null) return null; + Type type = value.GetType(); + int key = GetKey(ref type); + + if (key >= 0 && !Helpers.IsEnum(type)) + { + using (MemoryStream ms = new MemoryStream()) + { + using (ProtoWriter writer = ProtoWriter.Create(ms, this, null)) + { + writer.SetRootObject(value); + Serialize(key, value, writer); + writer.Close(); + } + ms.Position = 0; + ProtoReader reader = null; + try + { + reader = ProtoReader.Create(ms, this, null, ProtoReader.TO_EOF); + return Deserialize(key, null, reader); + } + finally + { + ProtoReader.Recycle(reader); + } + } + } + if (type == typeof(byte[])) + { + byte[] orig = (byte[])value, clone = new byte[orig.Length]; + Buffer.BlockCopy(orig, 0, clone, 0, orig.Length); + return clone; + } + else if (GetWireType(Helpers.GetTypeCode(type), DataFormat.Default, ref type, out int modelKey) != WireType.None && modelKey < 0) + { // immutable; just return the original value + return value; + } + using (MemoryStream ms = new MemoryStream()) + { + using (ProtoWriter writer = ProtoWriter.Create(ms, this, null)) + { + if (!TrySerializeAuxiliaryType(writer, type, DataFormat.Default, Serializer.ListItemTag, value, false, null)) ThrowUnexpectedType(type); + writer.Close(); + } + ms.Position = 0; + ProtoReader reader = null; + try + { + reader = ProtoReader.Create(ms, this, null, ProtoReader.TO_EOF); + value = null; // start from scratch! + TryDeserializeAuxiliaryType(reader, DataFormat.Default, Serializer.ListItemTag, type, ref value, true, false, true, false, null); + return value; + } + finally + { + ProtoReader.Recycle(reader); + } + } + } + + /// + /// Indicates that while an inheritance tree exists, the exact type encountered was not + /// specified in that hierarchy and cannot be processed. + /// + protected internal static void ThrowUnexpectedSubtype(Type expected, Type actual) + { + if (expected != TypeModel.ResolveProxies(actual)) + { + throw new InvalidOperationException("Unexpected sub-type: " + actual.FullName); + } + } + + /// + /// Indicates that the given type was not expected, and cannot be processed. + /// + protected internal static void ThrowUnexpectedType(Type type) + { + string fullName = type == null ? "(unknown)" : type.FullName; + + if (type != null) + { + Type baseType = type +#if COREFX || PROFILE259 + .GetTypeInfo() +#endif + .BaseType; + if (baseType != null && baseType +#if COREFX || PROFILE259 + .GetTypeInfo() +#endif + .IsGenericType && baseType.GetGenericTypeDefinition().Name == "GeneratedMessage`2") + { + throw new InvalidOperationException( + "Are you mixing protobuf-net and protobuf-csharp-port? See https://stackoverflow.com/q/11564914/23354; type: " + fullName); + } + } + + throw new InvalidOperationException("Type is not expected, and no contract can be inferred: " + fullName); + } + + internal static Exception CreateNestedListsNotSupported(Type type) + { + return new NotSupportedException("Nested or jagged lists and arrays are not supported: " + (type?.FullName ?? "(null)")); + } + + /// + /// Indicates that the given type cannot be constructed; it may still be possible to + /// deserialize into existing instances. + /// + public static void ThrowCannotCreateInstance(Type type) + { + throw new ProtoException("No parameterless constructor found for " + (type?.FullName ?? "(null)")); + } + + internal static string SerializeType(TypeModel model, System.Type type) + { + if (model != null) + { + TypeFormatEventHandler handler = model.DynamicTypeFormatting; + if (handler != null) + { + TypeFormatEventArgs args = new TypeFormatEventArgs(type); + handler(model, args); + if (!string.IsNullOrEmpty(args.FormattedName)) return args.FormattedName; + } + } + return type.AssemblyQualifiedName; + } + + internal static Type DeserializeType(TypeModel model, string value) + { + + if (model != null) + { + TypeFormatEventHandler handler = model.DynamicTypeFormatting; + if (handler != null) + { + TypeFormatEventArgs args = new TypeFormatEventArgs(value); + handler(model, args); + if (args.Type != null) return args.Type; + } + } + return Type.GetType(value); + } + + /// + /// Returns true if the type supplied is either a recognised contract type, + /// or a *list* of a recognised contract type. + /// + /// Note that primitives always return false, even though the engine + /// will, if forced, try to serialize such + /// True if this type is recognised as a serializable entity, else false + public bool CanSerializeContractType(Type type) => CanSerialize(type, false, true, true); + + /// + /// Returns true if the type supplied is a basic type with inbuilt handling, + /// a recognised contract type, or a *list* of a basic / contract type. + /// + public bool CanSerialize(Type type) => CanSerialize(type, true, true, true); + + /// + /// Returns true if the type supplied is a basic type with inbuilt handling, + /// or a *list* of a basic type with inbuilt handling + /// + public bool CanSerializeBasicType(Type type) => CanSerialize(type, true, false, true); + + private bool CanSerialize(Type type, bool allowBasic, bool allowContract, bool allowLists) + { + if (type == null) throw new ArgumentNullException(nameof(type)); + Type tmp = Helpers.GetUnderlyingType(type); + if (tmp != null) type = tmp; + + // is it a basic type? + ProtoTypeCode typeCode = Helpers.GetTypeCode(type); + switch (typeCode) + { + case ProtoTypeCode.Empty: + case ProtoTypeCode.Unknown: + break; + default: + return allowBasic; // well-known basic type + } + int modelKey = GetKey(ref type); + if (modelKey >= 0) return allowContract; // known contract type + + // is it a list? + if (allowLists) + { + Type itemType = null; + if (type.IsArray) + { // note we don't need to exclude byte[], as that is handled by GetTypeCode already + if (type.GetArrayRank() == 1) itemType = type.GetElementType(); + } + else + { + itemType = GetListItemType(this, type); + } + if (itemType != null) return CanSerialize(itemType, allowBasic, allowContract, false); + } + return false; + } + + /// + /// Suggest a .proto definition for the given type + /// + /// The type to generate a .proto definition for, or null to generate a .proto that represents the entire model + /// The .proto definition as a string + public virtual string GetSchema(Type type) => GetSchema(type, ProtoSyntax.Proto2); + + /// + /// Suggest a .proto definition for the given type + /// + /// The type to generate a .proto definition for, or null to generate a .proto that represents the entire model + /// The .proto definition as a string + /// The .proto syntax to use for the operation + public virtual string GetSchema(Type type, ProtoSyntax syntax) + { + throw new NotSupportedException(); + } + + /// + /// Used to provide custom services for writing and parsing type names when using dynamic types. Both parsing and formatting + /// are provided on a single API as it is essential that both are mapped identically at all times. + /// + public event TypeFormatEventHandler DynamicTypeFormatting; + +#if PLAT_BINARYFORMATTER && !(COREFX || PROFILE259) + /// + /// Creates a new IFormatter that uses protocol-buffer [de]serialization. + /// + /// A new IFormatter to be used during [de]serialization. + /// The type of object to be [de]deserialized by the formatter. + public System.Runtime.Serialization.IFormatter CreateFormatter(Type type) + { + return new Formatter(this, type); + } + + internal sealed class Formatter : System.Runtime.Serialization.IFormatter + { + private readonly TypeModel model; + private readonly Type type; + internal Formatter(TypeModel model, Type type) + { + this.model = model ?? throw new ArgumentNullException(nameof(model)); + this.type = type ?? throw new ArgumentNullException(nameof(type)); + } + private System.Runtime.Serialization.SerializationBinder binder; + public System.Runtime.Serialization.SerializationBinder Binder + { + get { return binder; } + set { binder = value; } + } + + private System.Runtime.Serialization.StreamingContext context; + public System.Runtime.Serialization.StreamingContext Context + { + get { return context; } + set { context = value; } + } + + public object Deserialize(Stream source) + { + return model.Deserialize(source, null, type, (long)-1, Context); + } + + public void Serialize(Stream destination, object graph) + { + model.Serialize(destination, graph, Context); + } + + private System.Runtime.Serialization.ISurrogateSelector surrogateSelector; + public System.Runtime.Serialization.ISurrogateSelector SurrogateSelector + { + get { return surrogateSelector; } + set { surrogateSelector = value; } + } + } +#endif + +#if DEBUG // this is used by some unit tests only, to ensure no buffering when buffering is disabled + private bool forwardsOnly; + /// + /// If true, buffering of nested objects is disabled + /// + public bool ForwardsOnly + { + get { return forwardsOnly; } + set { forwardsOnly = value; } + } +#endif + + internal virtual Type GetType(string fullName, Assembly context) + { + return ResolveKnownType(fullName, this, context); + } + + [System.Runtime.CompilerServices.MethodImpl(System.Runtime.CompilerServices.MethodImplOptions.NoInlining)] + internal static Type ResolveKnownType(string name, TypeModel model, Assembly assembly) + { + if (string.IsNullOrEmpty(name)) return null; + try + { + Type type = Type.GetType(name); + + if (type != null) return type; + } + catch { } + try + { + int i = name.IndexOf(','); + string fullName = (i > 0 ? name.Substring(0, i) : name).Trim(); +#if !(COREFX || PROFILE259) + if (assembly == null) assembly = Assembly.GetCallingAssembly(); +#endif + Type type = assembly?.GetType(fullName); + if (type != null) return type; + } + catch { } + return null; + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/ValueMember.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/ValueMember.cs new file mode 100644 index 0000000..9566312 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Meta/ValueMember.cs @@ -0,0 +1,855 @@ +#if !NO_RUNTIME +using System; + +using ProtoBuf.Serializers; +using System.Globalization; +using System.Collections.Generic; + +#if PROFILE259 +using System.Reflection; +using System.Linq; +#else +using System.Reflection; +#endif + +namespace ProtoBuf.Meta +{ + /// + /// Represents a member (property/field) that is mapped to a protobuf field + /// + public class ValueMember + { + private int _fieldNumber; + /// + /// The number that identifies this member in a protobuf stream + /// + public int FieldNumber + { + get => _fieldNumber; + internal set + { + if (_fieldNumber != value) + { + MetaType.AssertValidFieldNumber(value); + ThrowIfFrozen(); + _fieldNumber = value; + } + } + } + + private readonly MemberInfo originalMember; + private MemberInfo backingMember; + /// + /// Gets the member (field/property) which this member relates to. + /// + public MemberInfo Member { get { return originalMember; } } + /// + /// Gets the backing member (field/property) which this member relates to + /// + public MemberInfo BackingMember + { + get { return backingMember; } + set + { + if (backingMember != value) + { + ThrowIfFrozen(); + backingMember = value; + } + } + } + + private readonly Type parentType, itemType, defaultType, memberType; + private object defaultValue; + + /// + /// Within a list / array / etc, the type of object for each item in the list (especially useful with ArrayList) + /// + public Type ItemType => itemType; + + /// + /// The underlying type of the member + /// + public Type MemberType => memberType; + + /// + /// For abstract types (IList etc), the type of concrete object to create (if required) + /// + public Type DefaultType => defaultType; + + /// + /// The type the defines the member + /// + public Type ParentType => parentType; + + /// + /// The default value of the item (members with this value will not be serialized) + /// + public object DefaultValue + { + get { return defaultValue; } + set + { + if (defaultValue != value) + { + ThrowIfFrozen(); + defaultValue = value; + } + } + } + + private readonly RuntimeTypeModel model; + /// + /// Creates a new ValueMember instance + /// + public ValueMember(RuntimeTypeModel model, Type parentType, int fieldNumber, MemberInfo member, Type memberType, Type itemType, Type defaultType, DataFormat dataFormat, object defaultValue) + : this(model, fieldNumber, memberType, itemType, defaultType, dataFormat) + { + if (parentType == null) throw new ArgumentNullException("parentType"); + if (fieldNumber < 1 && !Helpers.IsEnum(parentType)) throw new ArgumentOutOfRangeException("fieldNumber"); + + this.originalMember = member ?? throw new ArgumentNullException("member"); + this.parentType = parentType; + if (fieldNumber < 1 && !Helpers.IsEnum(parentType)) throw new ArgumentOutOfRangeException("fieldNumber"); + //#if WINRT + if (defaultValue != null && model.MapType(defaultValue.GetType()) != memberType) + //#else + // if (defaultValue != null && !memberType.IsInstanceOfType(defaultValue)) + //#endif + { + defaultValue = ParseDefaultValue(memberType, defaultValue); + } + this.defaultValue = defaultValue; + + MetaType type = model.FindWithoutAdd(memberType); + if (type != null) + { + AsReference = type.AsReferenceDefault; + } + else + { // we need to scan the hard way; can't risk recursion by fully walking it + AsReference = MetaType.GetAsReferenceDefault(model, memberType); + } + } + /// + /// Creates a new ValueMember instance + /// + internal ValueMember(RuntimeTypeModel model, int fieldNumber, Type memberType, Type itemType, Type defaultType, DataFormat dataFormat) + { + _fieldNumber = fieldNumber; + this.memberType = memberType ?? throw new ArgumentNullException(nameof(memberType)); + this.itemType = itemType; + this.defaultType = defaultType; + + this.model = model ?? throw new ArgumentNullException(nameof(model)); + this.dataFormat = dataFormat; + } + internal object GetRawEnumValue() + { +#if PORTABLE || CF || COREFX || PROFILE259 + object value = ((FieldInfo)originalMember).GetValue(null); + switch(Helpers.GetTypeCode(Enum.GetUnderlyingType(((FieldInfo)originalMember).FieldType))) + { + case ProtoTypeCode.SByte: return (sbyte)value; + case ProtoTypeCode.Byte: return (byte)value; + case ProtoTypeCode.Int16: return (short)value; + case ProtoTypeCode.UInt16: return (ushort)value; + case ProtoTypeCode.Int32: return (int)value; + case ProtoTypeCode.UInt32: return (uint)value; + case ProtoTypeCode.Int64: return (long)value; + case ProtoTypeCode.UInt64: return (ulong)value; + default: + throw new InvalidOperationException(); + } +#else + return ((FieldInfo)originalMember).GetRawConstantValue(); +#endif + } + private static object ParseDefaultValue(Type type, object value) + { + { + Type tmp = Helpers.GetUnderlyingType(type); + if (tmp != null) type = tmp; + } + if (value is string s) + { + if (Helpers.IsEnum(type)) return Helpers.ParseEnum(type, s); + + switch (Helpers.GetTypeCode(type)) + { + case ProtoTypeCode.Boolean: return bool.Parse(s); + case ProtoTypeCode.Byte: return byte.Parse(s, NumberStyles.Integer, CultureInfo.InvariantCulture); + case ProtoTypeCode.Char: // char.Parse missing on CF/phone7 + if (s.Length == 1) return s[0]; + throw new FormatException("Single character expected: \"" + s + "\""); + case ProtoTypeCode.DateTime: return DateTime.Parse(s, CultureInfo.InvariantCulture); + case ProtoTypeCode.Decimal: return decimal.Parse(s, NumberStyles.Any, CultureInfo.InvariantCulture); + case ProtoTypeCode.Double: return double.Parse(s, NumberStyles.Any, CultureInfo.InvariantCulture); + case ProtoTypeCode.Int16: return short.Parse(s, NumberStyles.Any, CultureInfo.InvariantCulture); + case ProtoTypeCode.Int32: return int.Parse(s, NumberStyles.Any, CultureInfo.InvariantCulture); + case ProtoTypeCode.Int64: return long.Parse(s, NumberStyles.Any, CultureInfo.InvariantCulture); + case ProtoTypeCode.SByte: return sbyte.Parse(s, NumberStyles.Integer, CultureInfo.InvariantCulture); + case ProtoTypeCode.Single: return float.Parse(s, NumberStyles.Any, CultureInfo.InvariantCulture); + case ProtoTypeCode.String: return s; + case ProtoTypeCode.UInt16: return ushort.Parse(s, NumberStyles.Any, CultureInfo.InvariantCulture); + case ProtoTypeCode.UInt32: return uint.Parse(s, NumberStyles.Any, CultureInfo.InvariantCulture); + case ProtoTypeCode.UInt64: return ulong.Parse(s, NumberStyles.Any, CultureInfo.InvariantCulture); + case ProtoTypeCode.TimeSpan: return TimeSpan.Parse(s); + case ProtoTypeCode.Uri: return s; // Uri is decorated as string + case ProtoTypeCode.Guid: return new Guid(s); + } + } + + if (Helpers.IsEnum(type)) return Enum.ToObject(type, value); + return Convert.ChangeType(value, type, CultureInfo.InvariantCulture); + + } + + private IProtoSerializer serializer; + internal IProtoSerializer Serializer + { + get + { + return serializer ?? (serializer = BuildSerializer()); + } + } + + private DataFormat dataFormat; + /// + /// Specifies the rules used to process the field; this is used to determine the most appropriate + /// wite-type, but also to describe subtypes within that wire-type (such as SignedVariant) + /// + public DataFormat DataFormat + { + get { return dataFormat; } + set + { + if (value != dataFormat) + { + ThrowIfFrozen(); + this.dataFormat = value; + } + } + } + + /// + /// Indicates whether this field should follow strict encoding rules; this means (for example) that if a "fixed32" + /// is encountered when "variant" is defined, then it will fail (throw an exception) when parsing. Note that + /// when serializing the defined type is always used. + /// + public bool IsStrict + { + get { return HasFlag(OPTIONS_IsStrict); } + set { SetFlag(OPTIONS_IsStrict, value, true); } + } + + /// + /// Indicates whether this field should use packed encoding (which can save lots of space for repeated primitive values). + /// This option only applies to list/array data of primitive types (int, double, etc). + /// + public bool IsPacked + { + get { return HasFlag(OPTIONS_IsPacked); } + set { SetFlag(OPTIONS_IsPacked, value, true); } + } + + /// + /// Indicates whether this field should *repace* existing values (the default is false, meaning *append*). + /// This option only applies to list/array data. + /// + public bool OverwriteList + { + get { return HasFlag(OPTIONS_OverwriteList); } + set { SetFlag(OPTIONS_OverwriteList, value, true); } + } + + /// + /// Indicates whether this field is mandatory. + /// + public bool IsRequired + { + get { return HasFlag(OPTIONS_IsRequired); } + set { SetFlag(OPTIONS_IsRequired, value, true); } + } + + /// + /// Enables full object-tracking/full-graph support. + /// + public bool AsReference + { + get { return HasFlag(OPTIONS_AsReference); } + set { SetFlag(OPTIONS_AsReference, value, true); } + } + + /// + /// Embeds the type information into the stream, allowing usage with types not known in advance. + /// + public bool DynamicType + { + get { return HasFlag(OPTIONS_DynamicType); } + set { SetFlag(OPTIONS_DynamicType, value, true); } + } + + /// + /// Indicates that the member should be treated as a protobuf Map + /// + public bool IsMap + { + get { return HasFlag(OPTIONS_IsMap); } + set { SetFlag(OPTIONS_IsMap, value, true); } + } + + private DataFormat mapKeyFormat, mapValueFormat; + /// + /// Specifies the data-format that should be used for the key, when IsMap is enabled + /// + public DataFormat MapKeyFormat + { + get { return mapKeyFormat; } + set + { + if (mapKeyFormat != value) + { + ThrowIfFrozen(); + mapKeyFormat = value; + } + } + } + /// + /// Specifies the data-format that should be used for the value, when IsMap is enabled + /// + public DataFormat MapValueFormat + { + get { return mapValueFormat; } + set + { + if (mapValueFormat != value) + { + ThrowIfFrozen(); + mapValueFormat = value; + } + } + } + + private MethodInfo getSpecified, setSpecified; + /// + /// Specifies methods for working with optional data members. + /// + /// Provides a method (null for none) to query whether this member should + /// be serialized; it must be of the form "bool {Method}()". The member is only serialized if the + /// method returns true. + /// Provides a method (null for none) to indicate that a member was + /// deserialized; it must be of the form "void {Method}(bool)", and will be called with "true" + /// when data is found. + public void SetSpecified(MethodInfo getSpecified, MethodInfo setSpecified) + { + if (this.getSpecified != getSpecified || this.setSpecified != setSpecified) + { + if (getSpecified != null) + { + if (getSpecified.ReturnType != model.MapType(typeof(bool)) + || getSpecified.IsStatic + || getSpecified.GetParameters().Length != 0) + { + throw new ArgumentException("Invalid pattern for checking member-specified", "getSpecified"); + } + } + if (setSpecified != null) + { + ParameterInfo[] args; + if (setSpecified.ReturnType != model.MapType(typeof(void)) + || setSpecified.IsStatic + || (args = setSpecified.GetParameters()).Length != 1 + || args[0].ParameterType != model.MapType(typeof(bool))) + { + throw new ArgumentException("Invalid pattern for setting member-specified", "setSpecified"); + } + } + + ThrowIfFrozen(); + this.getSpecified = getSpecified; + this.setSpecified = setSpecified; + } + } + + private void ThrowIfFrozen() + { + if (serializer != null) throw new InvalidOperationException("The type cannot be changed once a serializer has been generated"); + } + + internal bool ResolveMapTypes(out Type dictionaryType, out Type keyType, out Type valueType) + { + dictionaryType = keyType = valueType = null; + try + { +#if COREFX || PROFILE259 + var info = memberType.GetTypeInfo(); +#else + var info = memberType; +#endif + if (ImmutableCollectionDecorator.IdentifyImmutable(model, MemberType, out _, out _, out _, out _, out _, out _)) + { + return false; + } + if (info.IsInterface && info.IsGenericType && info.GetGenericTypeDefinition() == typeof(IDictionary<,>)) + { +#if PROFILE259 + var typeArgs = memberType.GetGenericTypeDefinition().GenericTypeArguments; +#else + var typeArgs = memberType.GetGenericArguments(); +#endif + if (IsValidMapKeyType(typeArgs[0])) + { + keyType = typeArgs[0]; + valueType = typeArgs[1]; + dictionaryType = memberType; + } + return false; + } +#if PROFILE259 + foreach (var iType in memberType.GetTypeInfo().ImplementedInterfaces) +#else + foreach (var iType in memberType.GetInterfaces()) +#endif + { +#if COREFX || PROFILE259 + info = iType.GetTypeInfo(); +#else + info = iType; +#endif + if (info.IsGenericType && info.GetGenericTypeDefinition() == typeof(IDictionary<,>)) + { + if (dictionaryType != null) throw new InvalidOperationException("Multiple dictionary interfaces implemented by type: " + memberType.FullName); +#if PROFILE259 + var typeArgs = iType.GetGenericTypeDefinition().GenericTypeArguments; +#else + var typeArgs = iType.GetGenericArguments(); +#endif + if (IsValidMapKeyType(typeArgs[0])) + { + keyType = typeArgs[0]; + valueType = typeArgs[1]; + dictionaryType = memberType; + } + } + } + if (dictionaryType == null) return false; + + // (note we checked the key type already) + // not a map if value is repeated + Type itemType = null, defaultType = null; + model.ResolveListTypes(valueType, ref itemType, ref defaultType); + if (itemType != null) return false; + + return dictionaryType != null; + } + catch + { + // if it isn't a good fit; don't use "map" + return false; + } + } + + static bool IsValidMapKeyType(Type type) + { + if (type == null || Helpers.IsEnum(type)) return false; + switch (Helpers.GetTypeCode(type)) + { + case ProtoTypeCode.Boolean: + case ProtoTypeCode.Byte: + case ProtoTypeCode.Char: + case ProtoTypeCode.Int16: + case ProtoTypeCode.Int32: + case ProtoTypeCode.Int64: + case ProtoTypeCode.String: + + case ProtoTypeCode.SByte: + case ProtoTypeCode.UInt16: + case ProtoTypeCode.UInt32: + case ProtoTypeCode.UInt64: + return true; + } + return false; + } + private IProtoSerializer BuildSerializer() + { + int opaqueToken = 0; + try + { + model.TakeLock(ref opaqueToken);// check nobody is still adding this type + var member = backingMember ?? originalMember; + IProtoSerializer ser; + if (IsMap) + { + ResolveMapTypes(out var dictionaryType, out var keyType, out var valueType); + + if (dictionaryType == null) + { + throw new InvalidOperationException("Unable to resolve map type for type: " + memberType.FullName); + } + var concreteType = defaultType; + if (concreteType == null && Helpers.IsClass(memberType)) + { + concreteType = memberType; + } + var keySer = TryGetCoreSerializer(model, MapKeyFormat, keyType, out var keyWireType, false, false, false, false); + if (!AsReference) + { + AsReference = MetaType.GetAsReferenceDefault(model, valueType); + } + var valueSer = TryGetCoreSerializer(model, MapValueFormat, valueType, out var valueWireType, AsReference, DynamicType, false, true); +#if PROFILE259 + IEnumerable ctors = typeof(MapDecorator<,,>).MakeGenericType(new Type[] { dictionaryType, keyType, valueType }).GetTypeInfo().DeclaredConstructors; + if (ctors.Count() != 1) + { + throw new InvalidOperationException("Unable to resolve MapDecorator constructor"); + } + ser = (IProtoSerializer)ctors.First().Invoke(new object[] {model, concreteType, keySer, valueSer, _fieldNumber, + DataFormat == DataFormat.Group ? WireType.StartGroup : WireType.String, keyWireType, valueWireType, OverwriteList }); +#else + var ctors = typeof(MapDecorator<,,>).MakeGenericType(new Type[] { dictionaryType, keyType, valueType }).GetConstructors( + BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Instance); + if (ctors.Length != 1) throw new InvalidOperationException("Unable to resolve MapDecorator constructor"); + ser = (IProtoSerializer)ctors[0].Invoke(new object[] {model, concreteType, keySer, valueSer, _fieldNumber, + DataFormat == DataFormat.Group ? WireType.StartGroup : WireType.String, keyWireType, valueWireType, OverwriteList }); +#endif + } + else + { + Type finalType = itemType ?? memberType; + ser = TryGetCoreSerializer(model, dataFormat, finalType, out WireType wireType, AsReference, DynamicType, OverwriteList, true); + if (ser == null) + { + throw new InvalidOperationException("No serializer defined for type: " + finalType.FullName); + } + + // apply tags + if (itemType != null && SupportNull) + { + if (IsPacked) + { + throw new NotSupportedException("Packed encodings cannot support null values"); + } + ser = new TagDecorator(NullDecorator.Tag, wireType, IsStrict, ser); + ser = new NullDecorator(model, ser); + ser = new TagDecorator(_fieldNumber, WireType.StartGroup, false, ser); + } + else + { + ser = new TagDecorator(_fieldNumber, wireType, IsStrict, ser); + } + // apply lists if appropriate + if (itemType != null) + { + Type underlyingItemType = SupportNull ? itemType : Helpers.GetUnderlyingType(itemType) ?? itemType; + + Helpers.DebugAssert(underlyingItemType == ser.ExpectedType + || (ser.ExpectedType == model.MapType(typeof(object)) && !Helpers.IsValueType(underlyingItemType)) + , "Wrong type in the tail; expected {0}, received {1}", ser.ExpectedType, underlyingItemType); + if (memberType.IsArray) + { + ser = new ArrayDecorator(model, ser, _fieldNumber, IsPacked, wireType, memberType, OverwriteList, SupportNull); + } + else + { + ser = ListDecorator.Create(model, memberType, defaultType, ser, _fieldNumber, IsPacked, wireType, member != null && PropertyDecorator.CanWrite(model, member), OverwriteList, SupportNull); + } + } + else if (defaultValue != null && !IsRequired && getSpecified == null) + { // note: "ShouldSerialize*" / "*Specified" / etc ^^^^ take precedence over defaultValue, + // as does "IsRequired" + ser = new DefaultValueDecorator(model, defaultValue, ser); + } + if (memberType == model.MapType(typeof(Uri))) + { + ser = new UriDecorator(model, ser); + } +#if PORTABLE + else if(memberType.FullName == typeof(Uri).FullName) + { + // In PCLs, the Uri type may not match (WinRT uses Internal/Uri, .Net uses System/Uri) + ser = new ReflectedUriDecorator(memberType, model, ser); + } +#endif + } + if (member != null) + { + if (member is PropertyInfo prop) + { + ser = new PropertyDecorator(model, parentType, prop, ser); + } + else if (member is FieldInfo fld) + { + ser = new FieldDecorator(parentType, fld, ser); + } + else + { + throw new InvalidOperationException(); + } + + if (getSpecified != null || setSpecified != null) + { + ser = new MemberSpecifiedDecorator(getSpecified, setSpecified, ser); + } + } + return ser; + } + finally + { + model.ReleaseLock(opaqueToken); + } + } + + private static WireType GetIntWireType(DataFormat format, int width) + { + switch (format) + { + case DataFormat.ZigZag: return WireType.SignedVariant; + case DataFormat.FixedSize: return width == 32 ? WireType.Fixed32 : WireType.Fixed64; + case DataFormat.TwosComplement: + case DataFormat.Default: return WireType.Variant; + default: throw new InvalidOperationException(); + } + } + private static WireType GetDateTimeWireType(DataFormat format) + { + switch (format) + { + + case DataFormat.Group: return WireType.StartGroup; + case DataFormat.FixedSize: return WireType.Fixed64; + case DataFormat.WellKnown: + case DataFormat.Default: + return WireType.String; + default: throw new InvalidOperationException(); + } + } + + internal static IProtoSerializer TryGetCoreSerializer(RuntimeTypeModel model, DataFormat dataFormat, Type type, out WireType defaultWireType, + bool asReference, bool dynamicType, bool overwriteList, bool allowComplexTypes) + { + { + Type tmp = Helpers.GetUnderlyingType(type); + if (tmp != null) type = tmp; + } + if (Helpers.IsEnum(type)) + { + if (allowComplexTypes && model != null) + { + // need to do this before checking the typecode; an int enum will report Int32 etc + defaultWireType = WireType.Variant; + return new EnumSerializer(type, model.GetEnumMap(type)); + } + else + { // enum is fine for adding as a meta-type + defaultWireType = WireType.None; + return null; + } + } + ProtoTypeCode code = Helpers.GetTypeCode(type); + switch (code) + { + case ProtoTypeCode.Int32: + defaultWireType = GetIntWireType(dataFormat, 32); + return new Int32Serializer(model); + case ProtoTypeCode.UInt32: + defaultWireType = GetIntWireType(dataFormat, 32); + return new UInt32Serializer(model); + case ProtoTypeCode.Int64: + defaultWireType = GetIntWireType(dataFormat, 64); + return new Int64Serializer(model); + case ProtoTypeCode.UInt64: + defaultWireType = GetIntWireType(dataFormat, 64); + return new UInt64Serializer(model); + case ProtoTypeCode.String: + defaultWireType = WireType.String; + if (asReference) + { + return new NetObjectSerializer(model, model.MapType(typeof(string)), 0, BclHelpers.NetObjectOptions.AsReference); + } + return new StringSerializer(model); + case ProtoTypeCode.Single: + defaultWireType = WireType.Fixed32; + return new SingleSerializer(model); + case ProtoTypeCode.Double: + defaultWireType = WireType.Fixed64; + return new DoubleSerializer(model); + case ProtoTypeCode.Boolean: + defaultWireType = WireType.Variant; + return new BooleanSerializer(model); + case ProtoTypeCode.DateTime: + defaultWireType = GetDateTimeWireType(dataFormat); + return new DateTimeSerializer(dataFormat, model); + case ProtoTypeCode.Decimal: + defaultWireType = WireType.String; + return new DecimalSerializer(model); + case ProtoTypeCode.Byte: + defaultWireType = GetIntWireType(dataFormat, 32); + return new ByteSerializer(model); + case ProtoTypeCode.SByte: + defaultWireType = GetIntWireType(dataFormat, 32); + return new SByteSerializer(model); + case ProtoTypeCode.Char: + defaultWireType = WireType.Variant; + return new CharSerializer(model); + case ProtoTypeCode.Int16: + defaultWireType = GetIntWireType(dataFormat, 32); + return new Int16Serializer(model); + case ProtoTypeCode.UInt16: + defaultWireType = GetIntWireType(dataFormat, 32); + return new UInt16Serializer(model); + case ProtoTypeCode.TimeSpan: + defaultWireType = GetDateTimeWireType(dataFormat); + return new TimeSpanSerializer(dataFormat, model); + case ProtoTypeCode.Guid: + defaultWireType = dataFormat == DataFormat.Group ? WireType.StartGroup : WireType.String; + return new GuidSerializer(model); + case ProtoTypeCode.Uri: + defaultWireType = WireType.String; + return new StringSerializer(model); + case ProtoTypeCode.ByteArray: + defaultWireType = WireType.String; + return new BlobSerializer(model, overwriteList); + case ProtoTypeCode.Type: + defaultWireType = WireType.String; + return new SystemTypeSerializer(model); + } + IProtoSerializer parseable = model.AllowParseableTypes ? ParseableSerializer.TryCreate(type, model) : null; + if (parseable != null) + { + defaultWireType = WireType.String; + return parseable; + } + if (allowComplexTypes && model != null) + { + int key = model.GetKey(type, false, true); + MetaType meta = null; + if (key >= 0) + { + meta = model[type]; + if (dataFormat == DataFormat.Default && meta.IsGroup) + { + dataFormat = DataFormat.Group; + } + } + + if (asReference || dynamicType) + { + BclHelpers.NetObjectOptions options = BclHelpers.NetObjectOptions.None; + if (asReference) options |= BclHelpers.NetObjectOptions.AsReference; + if (dynamicType) options |= BclHelpers.NetObjectOptions.DynamicType; + if (meta != null) + { // exists + if (asReference && Helpers.IsValueType(type)) + { + string message = "AsReference cannot be used with value-types"; + + if (type.Name == "KeyValuePair`2") + { + message += "; please see https://stackoverflow.com/q/14436606/23354"; + } + else + { + message += ": " + type.FullName; + } + throw new InvalidOperationException(message); + } + + if (asReference && meta.IsAutoTuple) options |= BclHelpers.NetObjectOptions.LateSet; + if (meta.UseConstructor) options |= BclHelpers.NetObjectOptions.UseConstructor; + } + defaultWireType = dataFormat == DataFormat.Group ? WireType.StartGroup : WireType.String; + return new NetObjectSerializer(model, type, key, options); + } + if (key >= 0) + { + defaultWireType = dataFormat == DataFormat.Group ? WireType.StartGroup : WireType.String; + return new SubItemSerializer(type, key, meta, true); + } + } + defaultWireType = WireType.None; + return null; + } + + + private string name; + internal void SetName(string name) + { + if (name != this.name) + { + ThrowIfFrozen(); + this.name = name; + } + } + /// + /// Gets the logical name for this member in the schema (this is not critical for binary serialization, but may be used + /// when inferring a schema). + /// + public string Name + { + get { return string.IsNullOrEmpty(name) ? originalMember.Name : name; } + set { SetName(value); } + } + + private const byte + OPTIONS_IsStrict = 1, + OPTIONS_IsPacked = 2, + OPTIONS_IsRequired = 4, + OPTIONS_OverwriteList = 8, + OPTIONS_SupportNull = 16, + OPTIONS_AsReference = 32, + OPTIONS_IsMap = 64, + OPTIONS_DynamicType = 128; + + private byte flags; + private bool HasFlag(byte flag) { return (flags & flag) == flag; } + private void SetFlag(byte flag, bool value, bool throwIfFrozen) + { + if (throwIfFrozen && HasFlag(flag) != value) + { + ThrowIfFrozen(); + } + if (value) + flags |= flag; + else + flags = (byte)(flags & ~flag); + } + + /// + /// Should lists have extended support for null values? Note this makes the serialization less efficient. + /// + public bool SupportNull + { + get { return HasFlag(OPTIONS_SupportNull); } + set { SetFlag(OPTIONS_SupportNull, value, true); } + } + + internal string GetSchemaTypeName(bool applyNetObjectProxy, ref RuntimeTypeModel.CommonImports imports) + { + Type effectiveType = ItemType; + if (effectiveType == null) effectiveType = MemberType; + return model.GetSchemaTypeName(effectiveType, DataFormat, applyNetObjectProxy && AsReference, applyNetObjectProxy && DynamicType, ref imports); + } + + + internal sealed class Comparer : System.Collections.IComparer, IComparer + { + public static readonly Comparer Default = new Comparer(); + + public int Compare(object x, object y) + { + return Compare(x as ValueMember, y as ValueMember); + } + + public int Compare(ValueMember x, ValueMember y) + { + if (ReferenceEquals(x, y)) return 0; + if (x == null) return -1; + if (y == null) return 1; + + return x.FieldNumber.CompareTo(y.FieldNumber); + } + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/NetObjectCache.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/NetObjectCache.cs new file mode 100644 index 0000000..8e83549 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/NetObjectCache.cs @@ -0,0 +1,190 @@ +using System; +using System.Collections.Generic; +using ProtoBuf.Meta; + +namespace ProtoBuf +{ + internal sealed class NetObjectCache + { + internal const int Root = 0; + private MutableList underlyingList; + + private MutableList List => underlyingList ?? (underlyingList = new MutableList()); + + internal object GetKeyedObject(int key) + { + if (key-- == Root) + { + if (rootObject == null) throw new ProtoException("No root object assigned"); + return rootObject; + } + BasicList list = List; + + if (key < 0 || key >= list.Count) + { + Helpers.DebugWriteLine("Missing key: " + key); + throw new ProtoException("Internal error; a missing key occurred"); + } + + object tmp = list[key]; + if (tmp == null) + { + throw new ProtoException("A deferred key does not have a value yet"); + } + return tmp; + } + + internal void SetKeyedObject(int key, object value) + { + if (key-- == Root) + { + if (value == null) throw new ArgumentNullException(nameof(value)); + if (rootObject != null && ((object)rootObject != (object)value)) throw new ProtoException("The root object cannot be reassigned"); + rootObject = value; + } + else + { + MutableList list = List; + if (key < list.Count) + { + object oldVal = list[key]; + if (oldVal == null) + { + list[key] = value; + } + else if (!ReferenceEquals(oldVal, value)) + { + throw new ProtoException("Reference-tracked objects cannot change reference"); + } // otherwise was the same; nothing to do + } + else if (key != list.Add(value)) + { + throw new ProtoException("Internal error; a key mismatch occurred"); + } + } + } + + private object rootObject; + internal int AddObjectKey(object value, out bool existing) + { + if (value == null) throw new ArgumentNullException(nameof(value)); + + if ((object)value == (object)rootObject) // (object) here is no-op, but should be + { // preserved even if this was typed - needs ref-check + existing = true; + return Root; + } + + string s = value as string; + BasicList list = List; + int index; + + if (s == null) + { +#if CF || PORTABLE // CF has very limited proper object ref-tracking; so instead, we'll search it the hard way + index = list.IndexOfReference(value); +#else + if (objectKeys == null) + { + objectKeys = new Dictionary(ReferenceComparer.Default); + index = -1; + } + else + { + if (!objectKeys.TryGetValue(value, out index)) index = -1; + } +#endif + } + else + { + if (stringKeys == null) + { + stringKeys = new Dictionary(); + index = -1; + } + else + { + if (!stringKeys.TryGetValue(s, out index)) index = -1; + } + } + + if (!(existing = index >= 0)) + { + index = list.Add(value); + + if (s == null) + { +#if !CF && !PORTABLE // CF can't handle the object keys very well + objectKeys.Add(value, index); +#endif + } + else + { + stringKeys.Add(s, index); + } + } + return index + 1; + } + + private int trapStartIndex; // defaults to 0 - optimization for RegisterTrappedObject + // to make it faster at seeking to find deferred-objects + + internal void RegisterTrappedObject(object value) + { + if (rootObject == null) + { + rootObject = value; + } + else + { + if (underlyingList != null) + { + for (int i = trapStartIndex; i < underlyingList.Count; i++) + { + trapStartIndex = i + 1; // things never *become* null; whether or + // not the next item is null, it will never + // need to be checked again + + if (underlyingList[i] == null) + { + underlyingList[i] = value; + break; + } + } + } + } + } + + private Dictionary stringKeys; + +#if !CF && !PORTABLE // CF lacks the ability to get a robust reference-based hash-code, so we'll do it the harder way instead + private System.Collections.Generic.Dictionary objectKeys; + private sealed class ReferenceComparer : IEqualityComparer + { + public readonly static ReferenceComparer Default = new ReferenceComparer(); + private ReferenceComparer() { } + + bool IEqualityComparer.Equals(object x, object y) + { + return x == y; // ref equality + } + + int IEqualityComparer.GetHashCode(object obj) + { + return System.Runtime.CompilerServices.RuntimeHelpers.GetHashCode(obj); + } + } +#endif + + internal void Clear() + { + trapStartIndex = 0; + rootObject = null; + if (underlyingList != null) underlyingList.Clear(); + if (stringKeys != null) stringKeys.Clear(); +#if !CF && !PORTABLE + if (objectKeys != null) objectKeys.Clear(); +#endif + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/PrefixStyle.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/PrefixStyle.cs new file mode 100644 index 0000000..0ebef04 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/PrefixStyle.cs @@ -0,0 +1,26 @@ + +namespace ProtoBuf +{ + /// + /// Specifies the type of prefix that should be applied to messages. + /// + public enum PrefixStyle + { + /// + /// No length prefix is applied to the data; the data is terminated only be the end of the stream. + /// + None = 0, + /// + /// A base-128 ("varint", the default prefix format in protobuf) length prefix is applied to the data (efficient for short messages). + /// + Base128 = 1, + /// + /// A fixed-length (little-endian) length prefix is applied to the data (useful for compatibility). + /// + Fixed32 = 2, + /// + /// A fixed-length (big-endian) length prefix is applied to the data (useful for compatibility). + /// + Fixed32BigEndian = 3 + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoContractAttribute.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoContractAttribute.cs new file mode 100644 index 0000000..e2e8054 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoContractAttribute.cs @@ -0,0 +1,175 @@ +using System; + +namespace ProtoBuf +{ + /// + /// Indicates that a type is defined for protocol-buffer serialization. + /// + [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Enum | AttributeTargets.Interface, + AllowMultiple = false, Inherited = false)] + public sealed class ProtoContractAttribute : Attribute + { + /// + /// Gets or sets the defined name of the type. + /// + public string Name { get; set; } + + /// + /// Gets or sets the fist offset to use with implicit field tags; + /// only uesd if ImplicitFields is set. + /// + public int ImplicitFirstTag + { + get { return implicitFirstTag; } + set + { + if (value < 1) throw new ArgumentOutOfRangeException("ImplicitFirstTag"); + implicitFirstTag = value; + } + } + private int implicitFirstTag; + + /// + /// If specified, alternative contract markers (such as markers for XmlSerailizer or DataContractSerializer) are ignored. + /// + public bool UseProtoMembersOnly + { + get { return HasFlag(OPTIONS_UseProtoMembersOnly); } + set { SetFlag(OPTIONS_UseProtoMembersOnly, value); } + } + + /// + /// If specified, do NOT treat this type as a list, even if it looks like one. + /// + public bool IgnoreListHandling + { + get { return HasFlag(OPTIONS_IgnoreListHandling); } + set { SetFlag(OPTIONS_IgnoreListHandling, value); } + } + + /// + /// Gets or sets the mechanism used to automatically infer field tags + /// for members. This option should be used in advanced scenarios only. + /// Please review the important notes against the ImplicitFields enumeration. + /// + public ImplicitFields ImplicitFields { get; set; } + + /// + /// Enables/disables automatic tag generation based on the existing name / order + /// of the defined members. This option is not used for members marked + /// with ProtoMemberAttribute, as intended to provide compatibility with + /// WCF serialization. WARNING: when adding new fields you must take + /// care to increase the Order for new elements, otherwise data corruption + /// may occur. + /// + /// If not explicitly specified, the default is assumed from Serializer.GlobalOptions.InferTagFromName. + public bool InferTagFromName + { + get { return HasFlag(OPTIONS_InferTagFromName); } + set + { + SetFlag(OPTIONS_InferTagFromName, value); + SetFlag(OPTIONS_InferTagFromNameHasValue, true); + } + } + + /// + /// Has a InferTagFromName value been explicitly set? if not, the default from the type-model is assumed. + /// + internal bool InferTagFromNameHasValue + { // note that this property is accessed via reflection and should not be removed + get { return HasFlag(OPTIONS_InferTagFromNameHasValue); } + } + + /// + /// Specifies an offset to apply to [DataMember(Order=...)] markers; + /// this is useful when working with mex-generated classes that have + /// a different origin (usually 1 vs 0) than the original data-contract. + /// + /// This value is added to the Order of each member. + /// + public int DataMemberOffset { get; set; } + + /// + /// If true, the constructor for the type is bypassed during deserialization, meaning any field initializers + /// or other initialization code is skipped. + /// + public bool SkipConstructor + { + get { return HasFlag(OPTIONS_SkipConstructor); } + set { SetFlag(OPTIONS_SkipConstructor, value); } + } + + /// + /// Should this type be treated as a reference by default? Please also see the implications of this, + /// as recorded on ProtoMemberAttribute.AsReference + /// + public bool AsReferenceDefault + { + get { return HasFlag(OPTIONS_AsReferenceDefault); } + set + { + SetFlag(OPTIONS_AsReferenceDefault, value); + } + } + + /// + /// Indicates whether this type should always be treated as a "group" (rather than a string-prefixed sub-message) + /// + public bool IsGroup + { + get { return HasFlag(OPTIONS_IsGroup); } + set + { + SetFlag(OPTIONS_IsGroup, value); + } + } + + private bool HasFlag(ushort flag) { return (flags & flag) == flag; } + private void SetFlag(ushort flag, bool value) + { + if (value) flags |= flag; + else flags = (ushort)(flags & ~flag); + } + + private ushort flags; + + private const ushort + OPTIONS_InferTagFromName = 1, + OPTIONS_InferTagFromNameHasValue = 2, + OPTIONS_UseProtoMembersOnly = 4, + OPTIONS_SkipConstructor = 8, + OPTIONS_IgnoreListHandling = 16, + OPTIONS_AsReferenceDefault = 32, + OPTIONS_EnumPassthru = 64, + OPTIONS_EnumPassthruHasValue = 128, + OPTIONS_IsGroup = 256; + + /// + /// Applies only to enums (not to DTO classes themselves); gets or sets a value indicating that an enum should be treated directly as an int/short/etc, rather + /// than enforcing .proto enum rules. This is useful *in particul* for [Flags] enums. + /// + public bool EnumPassthru + { + get { return HasFlag(OPTIONS_EnumPassthru); } + set + { + SetFlag(OPTIONS_EnumPassthru, value); + SetFlag(OPTIONS_EnumPassthruHasValue, true); + } + } + + /// + /// Allows to define a surrogate type used for serialization/deserialization purpose. + /// + public Type Surrogate { get; set; } + + /// + /// Has a EnumPassthru value been explicitly set? + /// + internal bool EnumPassthruHasValue + { // note that this property is accessed via reflection and should not be removed + get { return HasFlag(OPTIONS_EnumPassthruHasValue); } + } + } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoConverterAttribute.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoConverterAttribute.cs new file mode 100644 index 0000000..b75bb80 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoConverterAttribute.cs @@ -0,0 +1,13 @@ +using System; + +namespace ProtoBuf +{ + /// + /// Indicates that a static member should be considered the same as though + /// were an implicit / explicit conversion operator; in particular, this + /// is useful for conversions that operator syntax does not allow, such as + /// to/from interface types. + /// + [AttributeUsage(AttributeTargets.Method, AllowMultiple = false, Inherited = true)] + public class ProtoConverterAttribute : Attribute { } +} \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoEnumAttribute.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoEnumAttribute.cs new file mode 100644 index 0000000..1d82645 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoEnumAttribute.cs @@ -0,0 +1,36 @@ +using System; + +namespace ProtoBuf +{ + /// + /// Used to define protocol-buffer specific behavior for + /// enumerated values. + /// + [AttributeUsage(AttributeTargets.Field, AllowMultiple = false)] + public sealed class ProtoEnumAttribute : Attribute + { + /// + /// Gets or sets the specific value to use for this enum during serialization. + /// + public int Value + { + get { return enumValue; } + set { this.enumValue = value; hasValue = true; } + } + + /// + /// Indicates whether this instance has a customised value mapping + /// + /// true if a specific value is set + public bool HasValue() => hasValue; + + private bool hasValue; + private int enumValue; + + /// + /// Gets or sets the defined name of the enum, as used in .proto + /// (this name is not used during serialization). + /// + public string Name { get; set; } + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoException.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoException.cs new file mode 100644 index 0000000..f502527 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoException.cs @@ -0,0 +1,30 @@ +using System; + +#if PLAT_BINARYFORMATTER && !(COREFX || PROFILE259) +using System.Runtime.Serialization; +#endif +namespace ProtoBuf +{ + /// + /// Indicates an error during serialization/deserialization of a proto stream. + /// +#if PLAT_BINARYFORMATTER && !(COREFX || PROFILE259) + [Serializable] +#endif + public class ProtoException : Exception + { + /// Creates a new ProtoException instance. + public ProtoException() { } + + /// Creates a new ProtoException instance. + public ProtoException(string message) : base(message) { } + + /// Creates a new ProtoException instance. + public ProtoException(string message, Exception innerException) : base(message, innerException) { } + +#if PLAT_BINARYFORMATTER && !(COREFX || PROFILE259) + /// Creates a new ProtoException instance. + protected ProtoException(SerializationInfo info, StreamingContext context) : base(info, context) { } +#endif + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoIgnoreAttribute.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoIgnoreAttribute.cs new file mode 100644 index 0000000..775674e --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoIgnoreAttribute.cs @@ -0,0 +1,40 @@ +using System; + +namespace ProtoBuf +{ + /// + /// Indicates that a member should be excluded from serialization; this + /// is only normally used when using implict fields. + /// + [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field, + AllowMultiple = false, Inherited = true)] + public class ProtoIgnoreAttribute : Attribute { } + + /// + /// Indicates that a member should be excluded from serialization; this + /// is only normally used when using implict fields. This allows + /// ProtoIgnoreAttribute usage + /// even for partial classes where the individual members are not + /// under direct control. + /// + [AttributeUsage(AttributeTargets.Class, + AllowMultiple = true, Inherited = false)] + public sealed class ProtoPartialIgnoreAttribute : ProtoIgnoreAttribute + { + /// + /// Creates a new ProtoPartialIgnoreAttribute instance. + /// + /// Specifies the member to be ignored. + public ProtoPartialIgnoreAttribute(string memberName) + : base() + { + if (string.IsNullOrEmpty(memberName)) throw new ArgumentNullException(nameof(memberName)); + + MemberName = memberName; + } + /// + /// The name of the member to be ignored. + /// + public string MemberName { get; } + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoIncludeAttribute.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoIncludeAttribute.cs new file mode 100644 index 0000000..bb83ef7 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoIncludeAttribute.cs @@ -0,0 +1,60 @@ +using System; +using System.ComponentModel; + +using ProtoBuf.Meta; + +namespace ProtoBuf +{ + /// + /// Indicates the known-types to support for an individual + /// message. This serializes each level in the hierarchy as + /// a nested message to retain wire-compatibility with + /// other protocol-buffer implementations. + /// + [AttributeUsage(AttributeTargets.Class | AttributeTargets.Interface, AllowMultiple = true, Inherited = false)] + public sealed class ProtoIncludeAttribute : Attribute + { + /// + /// Creates a new instance of the ProtoIncludeAttribute. + /// + /// The unique index (within the type) that will identify this data. + /// The additional type to serialize/deserialize. + public ProtoIncludeAttribute(int tag, Type knownType) + : this(tag, knownType == null ? "" : knownType.AssemblyQualifiedName) { } + + /// + /// Creates a new instance of the ProtoIncludeAttribute. + /// + /// The unique index (within the type) that will identify this data. + /// The additional type to serialize/deserialize. + public ProtoIncludeAttribute(int tag, string knownTypeName) + { + if (tag <= 0) throw new ArgumentOutOfRangeException(nameof(tag), "Tags must be positive integers"); + if (string.IsNullOrEmpty(knownTypeName)) throw new ArgumentNullException(nameof(knownTypeName), "Known type cannot be blank"); + Tag = tag; + KnownTypeName = knownTypeName; + } + + /// + /// Gets the unique index (within the type) that will identify this data. + /// + public int Tag { get; } + + /// + /// Gets the additional type to serialize/deserialize. + /// + public string KnownTypeName { get; } + + /// + /// Gets the additional type to serialize/deserialize. + /// + public Type KnownType => TypeModel.ResolveKnownType(KnownTypeName, null, null); + + /// + /// Specifies whether the inherited sype's sub-message should be + /// written with a length-prefix (default), or with group markers. + /// + [DefaultValue(DataFormat.Default)] + public DataFormat DataFormat { get; set; } = DataFormat.Default; + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoMapAttribute.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoMapAttribute.cs new file mode 100644 index 0000000..e85441a --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoMapAttribute.cs @@ -0,0 +1,29 @@ +using System; + +namespace ProtoBuf +{ + /// + /// Controls the formatting of elements in a dictionary, and indicates that + /// "map" rules should be used: duplicates *replace* earlier values, rather + /// than throwing an exception + /// + [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)] + public class ProtoMapAttribute : Attribute + { + /// + /// Describes the data-format used to store the key + /// + public DataFormat KeyFormat { get; set; } + /// + /// Describes the data-format used to store the value + /// + public DataFormat ValueFormat { get; set; } + + /// + /// Disables "map" handling; dictionaries will use ".Add(key,value)" instead of "[key] = value", + /// which means duplicate keys will cause an exception (instead of retaining the final value); if + /// a proto schema is emitted, it will be produced using "repeated" instead of "map" + /// + public bool DisableMap { get; set; } + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoMemberAttribute.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoMemberAttribute.cs new file mode 100644 index 0000000..e5ab896 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoMemberAttribute.cs @@ -0,0 +1,228 @@ +using System; +using System.Reflection; + +namespace ProtoBuf +{ + /// + /// Declares a member to be used in protocol-buffer serialization, using + /// the given Tag. A DataFormat may be used to optimise the serialization + /// format (for instance, using zigzag encoding for negative numbers, or + /// fixed-length encoding for large values. + /// + [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field, + AllowMultiple = false, Inherited = true)] + public class ProtoMemberAttribute : Attribute + , IComparable + , IComparable + + { + /// + /// Compare with another ProtoMemberAttribute for sorting purposes + /// + public int CompareTo(object other) => CompareTo(other as ProtoMemberAttribute); + /// + /// Compare with another ProtoMemberAttribute for sorting purposes + /// + public int CompareTo(ProtoMemberAttribute other) + { + if (other == null) return -1; + if ((object)this == (object)other) return 0; + int result = this.tag.CompareTo(other.tag); + if (result == 0) result = string.CompareOrdinal(this.name, other.name); + return result; + } + + /// + /// Creates a new ProtoMemberAttribute instance. + /// + /// Specifies the unique tag used to identify this member within the type. + public ProtoMemberAttribute(int tag) : this(tag, false) + { } + + internal ProtoMemberAttribute(int tag, bool forced) + { + if (tag <= 0 && !forced) throw new ArgumentOutOfRangeException(nameof(tag)); + this.tag = tag; + } + +#if !NO_RUNTIME + internal MemberInfo Member, BackingMember; + internal bool TagIsPinned; +#endif + /// + /// Gets or sets the original name defined in the .proto; not used + /// during serialization. + /// + public string Name { get { return name; } set { name = value; } } + private string name; + + /// + /// Gets or sets the data-format to be used when encoding this value. + /// + public DataFormat DataFormat { get { return dataFormat; } set { dataFormat = value; } } + private DataFormat dataFormat; + + /// + /// Gets the unique tag used to identify this member within the type. + /// + public int Tag { get { return tag; } } + private int tag; + internal void Rebase(int tag) { this.tag = tag; } + + /// + /// Gets or sets a value indicating whether this member is mandatory. + /// + public bool IsRequired + { + get { return (options & MemberSerializationOptions.Required) == MemberSerializationOptions.Required; } + set + { + if (value) options |= MemberSerializationOptions.Required; + else options &= ~MemberSerializationOptions.Required; + } + } + + /// + /// Gets a value indicating whether this member is packed. + /// This option only applies to list/array data of primitive types (int, double, etc). + /// + public bool IsPacked + { + get { return (options & MemberSerializationOptions.Packed) == MemberSerializationOptions.Packed; } + set + { + if (value) options |= MemberSerializationOptions.Packed; + else options &= ~MemberSerializationOptions.Packed; + } + } + + /// + /// Indicates whether this field should *repace* existing values (the default is false, meaning *append*). + /// This option only applies to list/array data. + /// + public bool OverwriteList + { + get { return (options & MemberSerializationOptions.OverwriteList) == MemberSerializationOptions.OverwriteList; } + set + { + if (value) options |= MemberSerializationOptions.OverwriteList; + else options &= ~MemberSerializationOptions.OverwriteList; + } + } + + /// + /// Enables full object-tracking/full-graph support. + /// + public bool AsReference + { + get { return (options & MemberSerializationOptions.AsReference) == MemberSerializationOptions.AsReference; } + set + { + if (value) options |= MemberSerializationOptions.AsReference; + else options &= ~MemberSerializationOptions.AsReference; + + options |= MemberSerializationOptions.AsReferenceHasValue; + } + } + + internal bool AsReferenceHasValue + { + get { return (options & MemberSerializationOptions.AsReferenceHasValue) == MemberSerializationOptions.AsReferenceHasValue; } + set + { + if (value) options |= MemberSerializationOptions.AsReferenceHasValue; + else options &= ~MemberSerializationOptions.AsReferenceHasValue; + } + } + + /// + /// Embeds the type information into the stream, allowing usage with types not known in advance. + /// + public bool DynamicType + { + get { return (options & MemberSerializationOptions.DynamicType) == MemberSerializationOptions.DynamicType; } + set + { + if (value) options |= MemberSerializationOptions.DynamicType; + else options &= ~MemberSerializationOptions.DynamicType; + } + } + + /// + /// Gets or sets a value indicating whether this member is packed (lists/arrays). + /// + public MemberSerializationOptions Options { get { return options; } set { options = value; } } + private MemberSerializationOptions options; + + + } + + /// + /// Additional (optional) settings that control serialization of members + /// + [Flags] + public enum MemberSerializationOptions + { + /// + /// Default; no additional options + /// + None = 0, + /// + /// Indicates that repeated elements should use packed (length-prefixed) encoding + /// + Packed = 1, + /// + /// Indicates that the given item is required + /// + Required = 2, + /// + /// Enables full object-tracking/full-graph support + /// + AsReference = 4, + /// + /// Embeds the type information into the stream, allowing usage with types not known in advance + /// + DynamicType = 8, + /// + /// Indicates whether this field should *repace* existing values (the default is false, meaning *append*). + /// This option only applies to list/array data. + /// + OverwriteList = 16, + /// + /// Determines whether the types AsReferenceDefault value is used, or whether this member's AsReference should be used + /// + AsReferenceHasValue = 32 + } + + /// + /// Declares a member to be used in protocol-buffer serialization, using + /// the given Tag and MemberName. This allows ProtoMemberAttribute usage + /// even for partial classes where the individual members are not + /// under direct control. + /// A DataFormat may be used to optimise the serialization + /// format (for instance, using zigzag encoding for negative numbers, or + /// fixed-length encoding for large values. + /// + [AttributeUsage(AttributeTargets.Class, + AllowMultiple = true, Inherited = false)] + public sealed class ProtoPartialMemberAttribute : ProtoMemberAttribute + { + /// + /// Creates a new ProtoMemberAttribute instance. + /// + /// Specifies the unique tag used to identify this member within the type. + /// Specifies the member to be serialized. + public ProtoPartialMemberAttribute(int tag, string memberName) + : base(tag) + { +#if !NO_RUNTIME + if (string.IsNullOrEmpty(memberName)) throw new ArgumentNullException(nameof(memberName)); +#endif + this.MemberName = memberName; + } + /// + /// The name of the member to be serialized. + /// + public string MemberName { get; private set; } + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoReader.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoReader.cs new file mode 100644 index 0000000..3ea9bf9 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoReader.cs @@ -0,0 +1,1444 @@ + +using System; +using System.Collections.Generic; +using System.IO; +using System.Text; +using ProtoBuf.Meta; + +namespace ProtoBuf +{ + /// + /// A stateful reader, used to read a protobuf stream. Typical usage would be (sequentially) to call + /// ReadFieldHeader and (after matching the field) an appropriate Read* method. + /// + public sealed class ProtoReader : IDisposable + { + Stream source; + byte[] ioBuffer; + TypeModel model; + int fieldNumber, depth, ioIndex, available; + long position64, blockEnd64, dataRemaining64; + WireType wireType; + bool isFixedLength, internStrings; + private NetObjectCache netCache; + + // this is how many outstanding objects do not currently have + // values for the purposes of reference tracking; we'll default + // to just trapping the root object + // note: objects are trapped (the ref and key mapped) via NoteObject + uint trapCount; // uint is so we can use beq/bne more efficiently than bgt + + /// + /// Gets the number of the field being processed. + /// + public int FieldNumber => fieldNumber; + + /// + /// Indicates the underlying proto serialization format on the wire. + /// + public WireType WireType => wireType; + + /// + /// Creates a new reader against a stream + /// + /// The source stream + /// The model to use for serialization; this can be null, but this will impair the ability to deserialize sub-objects + /// Additional context about this serialization operation + [Obsolete("Please use ProtoReader.Create; this API may be removed in a future version", error: false)] + public ProtoReader(Stream source, TypeModel model, SerializationContext context) + { + + Init(this, source, model, context, TO_EOF); + } + + internal const long TO_EOF = -1; + + /// + /// Gets / sets a flag indicating whether strings should be checked for repetition; if + /// true, any repeated UTF-8 byte sequence will result in the same String instance, rather + /// than a second instance of the same string. Enabled by default. Note that this uses + /// a custom interner - the system-wide string interner is not used. + /// + public bool InternStrings { get { return internStrings; } set { internStrings = value; } } + + /// + /// Creates a new reader against a stream + /// + /// The source stream + /// The model to use for serialization; this can be null, but this will impair the ability to deserialize sub-objects + /// Additional context about this serialization operation + /// The number of bytes to read, or -1 to read until the end of the stream + [Obsolete("Please use ProtoReader.Create; this API may be removed in a future version", error: false)] + public ProtoReader(Stream source, TypeModel model, SerializationContext context, int length) + { + Init(this, source, model, context, length); + } + + /// + /// Creates a new reader against a stream + /// + /// The source stream + /// The model to use for serialization; this can be null, but this will impair the ability to deserialize sub-objects + /// Additional context about this serialization operation + /// The number of bytes to read, or -1 to read until the end of the stream + [Obsolete("Please use ProtoReader.Create; this API may be removed in a future version", error: false)] + public ProtoReader(Stream source, TypeModel model, SerializationContext context, long length) + { + Init(this, source, model, context, length); + } + + private static void Init(ProtoReader reader, Stream source, TypeModel model, SerializationContext context, long length) + { + if (source == null) throw new ArgumentNullException(nameof(source)); + if (!source.CanRead) throw new ArgumentException("Cannot read from stream", nameof(source)); + reader.source = source; + reader.ioBuffer = BufferPool.GetBuffer(); + reader.model = model; + bool isFixedLength = length >= 0; + reader.isFixedLength = isFixedLength; + reader.dataRemaining64 = isFixedLength ? length : 0; + + if (context == null) { context = SerializationContext.Default; } + else { context.Freeze(); } + reader.context = context; + reader.position64 = 0; + reader.available = reader.depth = reader.fieldNumber = reader.ioIndex = 0; + reader.blockEnd64 = long.MaxValue; + reader.internStrings = RuntimeTypeModel.Default.InternStrings; + reader.wireType = WireType.None; + reader.trapCount = 1; + if (reader.netCache == null) reader.netCache = new NetObjectCache(); + } + + private SerializationContext context; + + /// + /// Addition information about this deserialization operation. + /// + public SerializationContext Context => context; + + /// + /// Releases resources used by the reader, but importantly does not Dispose the + /// underlying stream; in many typical use-cases the stream is used for different + /// processes, so it is assumed that the consumer will Dispose their stream separately. + /// + public void Dispose() + { + // importantly, this does **not** own the stream, and does not dispose it + source = null; + model = null; + BufferPool.ReleaseBufferToPool(ref ioBuffer); + if (stringInterner != null) + { + stringInterner.Clear(); + stringInterner = null; + } + if (netCache != null) netCache.Clear(); + } + internal int TryReadUInt32VariantWithoutMoving(bool trimNegative, out uint value) + { + if (available < 10) Ensure(10, false); + if (available == 0) + { + value = 0; + return 0; + } + int readPos = ioIndex; + value = ioBuffer[readPos++]; + if ((value & 0x80) == 0) return 1; + value &= 0x7F; + if (available == 1) throw EoF(this); + + uint chunk = ioBuffer[readPos++]; + value |= (chunk & 0x7F) << 7; + if ((chunk & 0x80) == 0) return 2; + if (available == 2) throw EoF(this); + + chunk = ioBuffer[readPos++]; + value |= (chunk & 0x7F) << 14; + if ((chunk & 0x80) == 0) return 3; + if (available == 3) throw EoF(this); + + chunk = ioBuffer[readPos++]; + value |= (chunk & 0x7F) << 21; + if ((chunk & 0x80) == 0) return 4; + if (available == 4) throw EoF(this); + + chunk = ioBuffer[readPos]; + value |= chunk << 28; // can only use 4 bits from this chunk + if ((chunk & 0xF0) == 0) return 5; + + if (trimNegative // allow for -ve values + && (chunk & 0xF0) == 0xF0 + && available >= 10 + && ioBuffer[++readPos] == 0xFF + && ioBuffer[++readPos] == 0xFF + && ioBuffer[++readPos] == 0xFF + && ioBuffer[++readPos] == 0xFF + && ioBuffer[++readPos] == 0x01) + { + return 10; + } + throw AddErrorData(new OverflowException(), this); + } + + private uint ReadUInt32Variant(bool trimNegative) + { + int read = TryReadUInt32VariantWithoutMoving(trimNegative, out uint value); + if (read > 0) + { + ioIndex += read; + available -= read; + position64 += read; + return value; + } + throw EoF(this); + } + + private bool TryReadUInt32Variant(out uint value) + { + int read = TryReadUInt32VariantWithoutMoving(false, out value); + if (read > 0) + { + ioIndex += read; + available -= read; + position64 += read; + return true; + } + return false; + } + + /// + /// Reads an unsigned 32-bit integer from the stream; supported wire-types: Variant, Fixed32, Fixed64 + /// + public uint ReadUInt32() + { + switch (wireType) + { + case WireType.Variant: + return ReadUInt32Variant(false); + case WireType.Fixed32: + if (available < 4) Ensure(4, true); + position64 += 4; + available -= 4; + return ((uint)ioBuffer[ioIndex++]) + | (((uint)ioBuffer[ioIndex++]) << 8) + | (((uint)ioBuffer[ioIndex++]) << 16) + | (((uint)ioBuffer[ioIndex++]) << 24); + case WireType.Fixed64: + ulong val = ReadUInt64(); + checked { return (uint)val; } + default: + throw CreateWireTypeException(); + } + } + + /// + /// Returns the position of the current reader (note that this is not necessarily the same as the position + /// in the underlying stream, if multiple readers are used on the same stream) + /// + public int Position { get { return checked((int)position64); } } + + /// + /// Returns the position of the current reader (note that this is not necessarily the same as the position + /// in the underlying stream, if multiple readers are used on the same stream) + /// + public long LongPosition { get { return position64; } } + internal void Ensure(int count, bool strict) + { + Helpers.DebugAssert(available <= count, "Asking for data without checking first"); + if (count > ioBuffer.Length) + { + BufferPool.ResizeAndFlushLeft(ref ioBuffer, count, ioIndex, available); + ioIndex = 0; + } + else if (ioIndex + count >= ioBuffer.Length) + { + // need to shift the buffer data to the left to make space + Buffer.BlockCopy(ioBuffer, ioIndex, ioBuffer, 0, available); + ioIndex = 0; + } + count -= available; + int writePos = ioIndex + available, bytesRead; + int canRead = ioBuffer.Length - writePos; + if (isFixedLength) + { // throttle it if needed + if (dataRemaining64 < canRead) canRead = (int)dataRemaining64; + } + while (count > 0 && canRead > 0 && (bytesRead = source.Read(ioBuffer, writePos, canRead)) > 0) + { + available += bytesRead; + count -= bytesRead; + canRead -= bytesRead; + writePos += bytesRead; + if (isFixedLength) { dataRemaining64 -= bytesRead; } + } + if (strict && count > 0) + { + throw EoF(this); + } + + } + /// + /// Reads a signed 16-bit integer from the stream: Variant, Fixed32, Fixed64, SignedVariant + /// + public short ReadInt16() + { + checked { return (short)ReadInt32(); } + } + /// + /// Reads an unsigned 16-bit integer from the stream; supported wire-types: Variant, Fixed32, Fixed64 + /// + public ushort ReadUInt16() + { + checked { return (ushort)ReadUInt32(); } + } + + /// + /// Reads an unsigned 8-bit integer from the stream; supported wire-types: Variant, Fixed32, Fixed64 + /// + public byte ReadByte() + { + checked { return (byte)ReadUInt32(); } + } + + /// + /// Reads a signed 8-bit integer from the stream; supported wire-types: Variant, Fixed32, Fixed64, SignedVariant + /// + public sbyte ReadSByte() + { + checked { return (sbyte)ReadInt32(); } + } + + /// + /// Reads a signed 32-bit integer from the stream; supported wire-types: Variant, Fixed32, Fixed64, SignedVariant + /// + public int ReadInt32() + { + switch (wireType) + { + case WireType.Variant: + return (int)ReadUInt32Variant(true); + case WireType.Fixed32: + if (available < 4) Ensure(4, true); + position64 += 4; + available -= 4; + return ((int)ioBuffer[ioIndex++]) + | (((int)ioBuffer[ioIndex++]) << 8) + | (((int)ioBuffer[ioIndex++]) << 16) + | (((int)ioBuffer[ioIndex++]) << 24); + case WireType.Fixed64: + long l = ReadInt64(); + checked { return (int)l; } + case WireType.SignedVariant: + return Zag(ReadUInt32Variant(true)); + default: + throw CreateWireTypeException(); + } + } + private const long Int64Msb = ((long)1) << 63; + private const int Int32Msb = ((int)1) << 31; + private static int Zag(uint ziggedValue) + { + int value = (int)ziggedValue; + return (-(value & 0x01)) ^ ((value >> 1) & ~ProtoReader.Int32Msb); + } + + private static long Zag(ulong ziggedValue) + { + long value = (long)ziggedValue; + return (-(value & 0x01L)) ^ ((value >> 1) & ~ProtoReader.Int64Msb); + } + /// + /// Reads a signed 64-bit integer from the stream; supported wire-types: Variant, Fixed32, Fixed64, SignedVariant + /// + public long ReadInt64() + { + switch (wireType) + { + case WireType.Variant: + return (long)ReadUInt64Variant(); + case WireType.Fixed32: + return ReadInt32(); + case WireType.Fixed64: + if (available < 8) Ensure(8, true); + position64 += 8; + available -= 8; + +#if NETCOREAPP2_1 + var result = System.Buffers.Binary.BinaryPrimitives.ReadInt64LittleEndian(ioBuffer.AsSpan(ioIndex, 8)); + + ioIndex+= 8; + + return result; +#else + return ((long)ioBuffer[ioIndex++]) + | (((long)ioBuffer[ioIndex++]) << 8) + | (((long)ioBuffer[ioIndex++]) << 16) + | (((long)ioBuffer[ioIndex++]) << 24) + | (((long)ioBuffer[ioIndex++]) << 32) + | (((long)ioBuffer[ioIndex++]) << 40) + | (((long)ioBuffer[ioIndex++]) << 48) + | (((long)ioBuffer[ioIndex++]) << 56); +#endif + case WireType.SignedVariant: + return Zag(ReadUInt64Variant()); + default: + throw CreateWireTypeException(); + } + } + + private int TryReadUInt64VariantWithoutMoving(out ulong value) + { + if (available < 10) Ensure(10, false); + if (available == 0) + { + value = 0; + return 0; + } + int readPos = ioIndex; + value = ioBuffer[readPos++]; + if ((value & 0x80) == 0) return 1; + value &= 0x7F; + if (available == 1) throw EoF(this); + + ulong chunk = ioBuffer[readPos++]; + value |= (chunk & 0x7F) << 7; + if ((chunk & 0x80) == 0) return 2; + if (available == 2) throw EoF(this); + + chunk = ioBuffer[readPos++]; + value |= (chunk & 0x7F) << 14; + if ((chunk & 0x80) == 0) return 3; + if (available == 3) throw EoF(this); + + chunk = ioBuffer[readPos++]; + value |= (chunk & 0x7F) << 21; + if ((chunk & 0x80) == 0) return 4; + if (available == 4) throw EoF(this); + + chunk = ioBuffer[readPos++]; + value |= (chunk & 0x7F) << 28; + if ((chunk & 0x80) == 0) return 5; + if (available == 5) throw EoF(this); + + chunk = ioBuffer[readPos++]; + value |= (chunk & 0x7F) << 35; + if ((chunk & 0x80) == 0) return 6; + if (available == 6) throw EoF(this); + + chunk = ioBuffer[readPos++]; + value |= (chunk & 0x7F) << 42; + if ((chunk & 0x80) == 0) return 7; + if (available == 7) throw EoF(this); + + + chunk = ioBuffer[readPos++]; + value |= (chunk & 0x7F) << 49; + if ((chunk & 0x80) == 0) return 8; + if (available == 8) throw EoF(this); + + chunk = ioBuffer[readPos++]; + value |= (chunk & 0x7F) << 56; + if ((chunk & 0x80) == 0) return 9; + if (available == 9) throw EoF(this); + + chunk = ioBuffer[readPos]; + value |= chunk << 63; // can only use 1 bit from this chunk + + if ((chunk & ~(ulong)0x01) != 0) throw AddErrorData(new OverflowException(), this); + return 10; + } + + private ulong ReadUInt64Variant() + { + int read = TryReadUInt64VariantWithoutMoving(out ulong value); + if (read > 0) + { + ioIndex += read; + available -= read; + position64 += read; + return value; + } + throw EoF(this); + } + + private Dictionary stringInterner; + private string Intern(string value) + { + if (value == null) return null; + if (value.Length == 0) return ""; + if (stringInterner == null) + { + stringInterner = new Dictionary + { + { value, value } + }; + } + else if (stringInterner.TryGetValue(value, out string found)) + { + value = found; + } + else + { + stringInterner.Add(value, value); + } + return value; + } + +#if COREFX + static readonly Encoding encoding = Encoding.UTF8; +#else + static readonly UTF8Encoding encoding = new UTF8Encoding(); +#endif + /// + /// Reads a string from the stream (using UTF8); supported wire-types: String + /// + public string ReadString() + { + if (wireType == WireType.String) + { + int bytes = (int)ReadUInt32Variant(false); + if (bytes == 0) return ""; + if (bytes < 0) ThrowInvalidLength(bytes); + if (available < bytes) Ensure(bytes, true); + + string s = encoding.GetString(ioBuffer, ioIndex, bytes); + + if (internStrings) { s = Intern(s); } + available -= bytes; + position64 += bytes; + ioIndex += bytes; + return s; + } + throw CreateWireTypeException(); + } + /// + /// Throws an exception indication that the given value cannot be mapped to an enum. + /// + public void ThrowEnumException(Type type, int value) + { + string desc = type == null ? "" : type.FullName; + throw AddErrorData(new ProtoException("No " + desc + " enum is mapped to the wire-value " + value.ToString()), this); + } + + private void ThrowInvalidLength(long length) + { + throw AddErrorData(new InvalidOperationException("Invalid length: " + length.ToString()), this); + } + + private Exception CreateWireTypeException() + { + return CreateException("Invalid wire-type; this usually means you have over-written a file without truncating or setting the length; see https://stackoverflow.com/q/2152978/23354"); + } + + private Exception CreateException(string message) + { + return AddErrorData(new ProtoException(message), this); + } + /// + /// Reads a double-precision number from the stream; supported wire-types: Fixed32, Fixed64 + /// + public +#if !FEAT_SAFE + unsafe +#endif + double ReadDouble() + { + switch (wireType) + { + case WireType.Fixed32: + return ReadSingle(); + case WireType.Fixed64: + long value = ReadInt64(); +#if FEAT_SAFE + return BitConverter.ToDouble(BitConverter.GetBytes(value), 0); +#else + return *(double*)&value; +#endif + default: + throw CreateWireTypeException(); + } + } + + /// + /// Reads (merges) a sub-message from the stream, internally calling StartSubItem and EndSubItem, and (in between) + /// parsing the message in accordance with the model associated with the reader + /// + public static object ReadObject(object value, int key, ProtoReader reader) + { + return ReadTypedObject(value, key, reader, null); + } + + internal static object ReadTypedObject(object value, int key, ProtoReader reader, Type type) + { + if (reader.model == null) + { + throw AddErrorData(new InvalidOperationException("Cannot deserialize sub-objects unless a model is provided"), reader); + } + SubItemToken token = ProtoReader.StartSubItem(reader); + if (key >= 0) + { + value = reader.model.Deserialize(key, value, reader); + } + else if (type != null && reader.model.TryDeserializeAuxiliaryType(reader, DataFormat.Default, Serializer.ListItemTag, type, ref value, true, false, true, false, null)) + { + // ok + } + else + { + TypeModel.ThrowUnexpectedType(type); + } + ProtoReader.EndSubItem(token, reader); + return value; + } + + /// + /// Makes the end of consuming a nested message in the stream; the stream must be either at the correct EndGroup + /// marker, or all fields of the sub-message must have been consumed (in either case, this means ReadFieldHeader + /// should return zero) + /// + public static void EndSubItem(SubItemToken token, ProtoReader reader) + { + if (reader == null) throw new ArgumentNullException("reader"); + long value64 = token.value64; + switch (reader.wireType) + { + case WireType.EndGroup: + if (value64 >= 0) throw AddErrorData(new ArgumentException("token"), reader); + if (-(int)value64 != reader.fieldNumber) throw reader.CreateException("Wrong group was ended"); // wrong group ended! + reader.wireType = WireType.None; // this releases ReadFieldHeader + reader.depth--; + break; + // case WireType.None: // TODO reinstate once reads reset the wire-type + default: + if (value64 < reader.position64) throw reader.CreateException($"Sub-message not read entirely; expected {value64}, was {reader.position64}"); + if (reader.blockEnd64 != reader.position64 && reader.blockEnd64 != long.MaxValue) + { + throw reader.CreateException("Sub-message not read correctly"); + } + reader.blockEnd64 = value64; + reader.depth--; + break; + /*default: + throw reader.BorkedIt(); */ + } + } + + /// + /// Begins consuming a nested message in the stream; supported wire-types: StartGroup, String + /// + /// The token returned must be help and used when callining EndSubItem + public static SubItemToken StartSubItem(ProtoReader reader) + { + if (reader == null) throw new ArgumentNullException("reader"); + switch (reader.wireType) + { + case WireType.StartGroup: + reader.wireType = WireType.None; // to prevent glitches from double-calling + reader.depth++; + return new SubItemToken((long)(-reader.fieldNumber)); + case WireType.String: + long len = (long)reader.ReadUInt64Variant(); + if (len < 0) reader.ThrowInvalidLength(len); + long lastEnd = reader.blockEnd64; + reader.blockEnd64 = reader.position64 + len; + reader.depth++; + return new SubItemToken(lastEnd); + default: + throw reader.CreateWireTypeException(); // throws + } + } + + /// + /// Reads a field header from the stream, setting the wire-type and retuning the field number. If no + /// more fields are available, then 0 is returned. This methods respects sub-messages. + /// + public int ReadFieldHeader() + { + // at the end of a group the caller must call EndSubItem to release the + // reader (which moves the status to Error, since ReadFieldHeader must + // then be called) + if (blockEnd64 <= position64 || wireType == WireType.EndGroup) { return 0; } + + if (TryReadUInt32Variant(out uint tag) && tag != 0) + { + wireType = (WireType)(tag & 7); + fieldNumber = (int)(tag >> 3); + if (fieldNumber < 1) throw new ProtoException("Invalid field in source data: " + fieldNumber.ToString()); + } + else + { + wireType = WireType.None; + fieldNumber = 0; + } + if (wireType == ProtoBuf.WireType.EndGroup) + { + if (depth > 0) return 0; // spoof an end, but note we still set the field-number + throw new ProtoException("Unexpected end-group in source data; this usually means the source data is corrupt"); + } + return fieldNumber; + } + /// + /// Looks ahead to see whether the next field in the stream is what we expect + /// (typically; what we've just finished reading - for example ot read successive list items) + /// + public bool TryReadFieldHeader(int field) + { + // check for virtual end of stream + if (blockEnd64 <= position64 || wireType == WireType.EndGroup) { return false; } + + int read = TryReadUInt32VariantWithoutMoving(false, out uint tag); + WireType tmpWireType; // need to catch this to exclude (early) any "end group" tokens + if (read > 0 && ((int)tag >> 3) == field + && (tmpWireType = (WireType)(tag & 7)) != WireType.EndGroup) + { + wireType = tmpWireType; + fieldNumber = field; + position64 += read; + ioIndex += read; + available -= read; + return true; + } + return false; + } + + /// + /// Get the TypeModel associated with this reader + /// + public TypeModel Model { get { return model; } } + + /// + /// Compares the streams current wire-type to the hinted wire-type, updating the reader if necessary; for example, + /// a Variant may be updated to SignedVariant. If the hinted wire-type is unrelated then no change is made. + /// + public void Hint(WireType wireType) + { + if (this.wireType == wireType) { } // fine; everything as we expect + else if (((int)wireType & 7) == (int)this.wireType) + { // the underling type is a match; we're customising it with an extension + this.wireType = wireType; + } + // note no error here; we're OK about using alternative data + } + + /// + /// Verifies that the stream's current wire-type is as expected, or a specialized sub-type (for example, + /// SignedVariant) - in which case the current wire-type is updated. Otherwise an exception is thrown. + /// + public void Assert(WireType wireType) + { + if (this.wireType == wireType) { } // fine; everything as we expect + else if (((int)wireType & 7) == (int)this.wireType) + { // the underling type is a match; we're customising it with an extension + this.wireType = wireType; + } + else + { // nope; that is *not* what we were expecting! + throw CreateWireTypeException(); + } + } + + /// + /// Discards the data for the current field. + /// + public void SkipField() + { + switch (wireType) + { + case WireType.Fixed32: + if (available < 4) Ensure(4, true); + available -= 4; + ioIndex += 4; + position64 += 4; + return; + case WireType.Fixed64: + if (available < 8) Ensure(8, true); + available -= 8; + ioIndex += 8; + position64 += 8; + return; + case WireType.String: + long len = (long)ReadUInt64Variant(); + if (len < 0) ThrowInvalidLength(len); + if (len <= available) + { // just jump it! + available -= (int)len; + ioIndex += (int)len; + position64 += len; + return; + } + // everything remaining in the buffer is garbage + position64 += len; // assumes success, but if it fails we're screwed anyway + len -= available; // discount anything we've got to-hand + ioIndex = available = 0; // note that we have no data in the buffer + if (isFixedLength) + { + if (len > dataRemaining64) throw EoF(this); + // else assume we're going to be OK + dataRemaining64 -= len; + } + ProtoReader.Seek(source, len, ioBuffer); + return; + case WireType.Variant: + case WireType.SignedVariant: + ReadUInt64Variant(); // and drop it + return; + case WireType.StartGroup: + int originalFieldNumber = this.fieldNumber; + depth++; // need to satisfy the sanity-checks in ReadFieldHeader + while (ReadFieldHeader() > 0) { SkipField(); } + depth--; + if (wireType == WireType.EndGroup && fieldNumber == originalFieldNumber) + { // we expect to exit in a similar state to how we entered + wireType = ProtoBuf.WireType.None; + return; + } + throw CreateWireTypeException(); + case WireType.None: // treat as explicit errorr + case WireType.EndGroup: // treat as explicit error + default: // treat as implicit error + throw CreateWireTypeException(); + } + } + + /// + /// Reads an unsigned 64-bit integer from the stream; supported wire-types: Variant, Fixed32, Fixed64 + /// + public ulong ReadUInt64() + { + switch (wireType) + { + case WireType.Variant: + return ReadUInt64Variant(); + case WireType.Fixed32: + return ReadUInt32(); + case WireType.Fixed64: + if (available < 8) Ensure(8, true); + position64 += 8; + available -= 8; + + return ((ulong)ioBuffer[ioIndex++]) + | (((ulong)ioBuffer[ioIndex++]) << 8) + | (((ulong)ioBuffer[ioIndex++]) << 16) + | (((ulong)ioBuffer[ioIndex++]) << 24) + | (((ulong)ioBuffer[ioIndex++]) << 32) + | (((ulong)ioBuffer[ioIndex++]) << 40) + | (((ulong)ioBuffer[ioIndex++]) << 48) + | (((ulong)ioBuffer[ioIndex++]) << 56); + default: + throw CreateWireTypeException(); + } + } + /// + /// Reads a single-precision number from the stream; supported wire-types: Fixed32, Fixed64 + /// + public +#if !FEAT_SAFE + unsafe +#endif + float ReadSingle() + { + switch (wireType) + { + case WireType.Fixed32: + { + int value = ReadInt32(); +#if FEAT_SAFE + return BitConverter.ToSingle(BitConverter.GetBytes(value), 0); +#else + return *(float*)&value; +#endif + } + case WireType.Fixed64: + { + double value = ReadDouble(); + float f = (float)value; + if (float.IsInfinity(f) && !double.IsInfinity(value)) + { + throw AddErrorData(new OverflowException(), this); + } + return f; + } + default: + throw CreateWireTypeException(); + } + } + + /// + /// Reads a boolean value from the stream; supported wire-types: Variant, Fixed32, Fixed64 + /// + /// + public bool ReadBoolean() + { + switch (ReadUInt32()) + { + case 0: return false; + case 1: return true; + default: throw CreateException("Unexpected boolean value"); + } + } + + private static readonly byte[] EmptyBlob = new byte[0]; + /// + /// Reads a byte-sequence from the stream, appending them to an existing byte-sequence (which can be null); supported wire-types: String + /// + public static byte[] AppendBytes(byte[] value, ProtoReader reader) + { + if (reader == null) throw new ArgumentNullException(nameof(reader)); + switch (reader.wireType) + { + case WireType.String: + int len = (int)reader.ReadUInt32Variant(false); + reader.wireType = WireType.None; + if (len == 0) return value ?? EmptyBlob; + if (len < 0) reader.ThrowInvalidLength(len); + int offset; + if (value == null || value.Length == 0) + { + offset = 0; + value = new byte[len]; + } + else + { + offset = value.Length; + byte[] tmp = new byte[value.Length + len]; + Buffer.BlockCopy(value, 0, tmp, 0, value.Length); + value = tmp; + } + // value is now sized with the final length, and (if necessary) + // contains the old data up to "offset" + reader.position64 += len; // assume success + while (len > reader.available) + { + if (reader.available > 0) + { + // copy what we *do* have + Buffer.BlockCopy(reader.ioBuffer, reader.ioIndex, value, offset, reader.available); + len -= reader.available; + offset += reader.available; + reader.ioIndex = reader.available = 0; // we've drained the buffer + } + // now refill the buffer (without overflowing it) + int count = len > reader.ioBuffer.Length ? reader.ioBuffer.Length : len; + if (count > 0) reader.Ensure(count, true); + } + // at this point, we know that len <= available + if (len > 0) + { // still need data, but we have enough buffered + Buffer.BlockCopy(reader.ioBuffer, reader.ioIndex, value, offset, len); + reader.ioIndex += len; + reader.available -= len; + } + return value; + case WireType.Variant: + return new byte[0]; + default: + throw reader.CreateWireTypeException(); + } + } + + //static byte[] ReadBytes(Stream stream, int length) + //{ + // if (stream == null) throw new ArgumentNullException("stream"); + // if (length < 0) throw new ArgumentOutOfRangeException("length"); + // byte[] buffer = new byte[length]; + // int offset = 0, read; + // while (length > 0 && (read = stream.Read(buffer, offset, length)) > 0) + // { + // length -= read; + // } + // if (length > 0) throw EoF(null); + // return buffer; + //} + private static int ReadByteOrThrow(Stream source) + { + int val = source.ReadByte(); + if (val < 0) throw EoF(null); + return val; + } + + /// + /// Reads the length-prefix of a message from a stream without buffering additional data, allowing a fixed-length + /// reader to be created. + /// + public static int ReadLengthPrefix(Stream source, bool expectHeader, PrefixStyle style, out int fieldNumber) + => ReadLengthPrefix(source, expectHeader, style, out fieldNumber, out int bytesRead); + + /// + /// Reads a little-endian encoded integer. An exception is thrown if the data is not all available. + /// + public static int DirectReadLittleEndianInt32(Stream source) + { + return ReadByteOrThrow(source) + | (ReadByteOrThrow(source) << 8) + | (ReadByteOrThrow(source) << 16) + | (ReadByteOrThrow(source) << 24); + } + + /// + /// Reads a big-endian encoded integer. An exception is thrown if the data is not all available. + /// + public static int DirectReadBigEndianInt32(Stream source) + { + return (ReadByteOrThrow(source) << 24) + | (ReadByteOrThrow(source) << 16) + | (ReadByteOrThrow(source) << 8) + | ReadByteOrThrow(source); + } + + /// + /// Reads a varint encoded integer. An exception is thrown if the data is not all available. + /// + public static int DirectReadVarintInt32(Stream source) + { + int bytes = TryReadUInt64Variant(source, out ulong val); + if (bytes <= 0) throw EoF(null); + return checked((int)val); + } + + /// + /// Reads a string (of a given lenth, in bytes) directly from the source into a pre-existing buffer. An exception is thrown if the data is not all available. + /// + public static void DirectReadBytes(Stream source, byte[] buffer, int offset, int count) + { + int read; + if (source == null) throw new ArgumentNullException("source"); + while (count > 0 && (read = source.Read(buffer, offset, count)) > 0) + { + count -= read; + offset += read; + } + if (count > 0) throw EoF(null); + } + + /// + /// Reads a given number of bytes directly from the source. An exception is thrown if the data is not all available. + /// + public static byte[] DirectReadBytes(Stream source, int count) + { + byte[] buffer = new byte[count]; + DirectReadBytes(source, buffer, 0, count); + return buffer; + } + + /// + /// Reads a string (of a given lenth, in bytes) directly from the source. An exception is thrown if the data is not all available. + /// + public static string DirectReadString(Stream source, int length) + { + byte[] buffer = new byte[length]; + DirectReadBytes(source, buffer, 0, length); + return Encoding.UTF8.GetString(buffer, 0, length); + } + + /// + /// Reads the length-prefix of a message from a stream without buffering additional data, allowing a fixed-length + /// reader to be created. + /// + public static int ReadLengthPrefix(Stream source, bool expectHeader, PrefixStyle style, out int fieldNumber, out int bytesRead) + { + if (style == PrefixStyle.None) + { + bytesRead = fieldNumber = 0; + return int.MaxValue; // avoid the long.maxvalue causing overflow + } + long len64 = ReadLongLengthPrefix(source, expectHeader, style, out fieldNumber, out bytesRead); + return checked((int)len64); + } + + /// + /// Reads the length-prefix of a message from a stream without buffering additional data, allowing a fixed-length + /// reader to be created. + /// + public static long ReadLongLengthPrefix(Stream source, bool expectHeader, PrefixStyle style, out int fieldNumber, out int bytesRead) + { + fieldNumber = 0; + switch (style) + { + case PrefixStyle.None: + bytesRead = 0; + return long.MaxValue; + case PrefixStyle.Base128: + ulong val; + int tmpBytesRead; + bytesRead = 0; + if (expectHeader) + { + tmpBytesRead = ProtoReader.TryReadUInt64Variant(source, out val); + bytesRead += tmpBytesRead; + if (tmpBytesRead > 0) + { + if ((val & 7) != (uint)WireType.String) + { // got a header, but it isn't a string + throw new InvalidOperationException(); + } + fieldNumber = (int)(val >> 3); + tmpBytesRead = ProtoReader.TryReadUInt64Variant(source, out val); + bytesRead += tmpBytesRead; + if (bytesRead == 0) + { // got a header, but no length + throw EoF(null); + } + return (long)val; + } + else + { // no header + bytesRead = 0; + return -1; + } + } + // check for a length + tmpBytesRead = ProtoReader.TryReadUInt64Variant(source, out val); + bytesRead += tmpBytesRead; + return bytesRead < 0 ? -1 : (long)val; + + case PrefixStyle.Fixed32: + { + int b = source.ReadByte(); + if (b < 0) + { + bytesRead = 0; + return -1; + } + bytesRead = 4; + return b + | (ReadByteOrThrow(source) << 8) + | (ReadByteOrThrow(source) << 16) + | (ReadByteOrThrow(source) << 24); + } + case PrefixStyle.Fixed32BigEndian: + { + int b = source.ReadByte(); + if (b < 0) + { + bytesRead = 0; + return -1; + } + bytesRead = 4; + return (b << 24) + | (ReadByteOrThrow(source) << 16) + | (ReadByteOrThrow(source) << 8) + | ReadByteOrThrow(source); + } + default: + throw new ArgumentOutOfRangeException("style"); + } + } + + /// The number of bytes consumed; 0 if no data available + private static int TryReadUInt64Variant(Stream source, out ulong value) + { + value = 0; + int b = source.ReadByte(); + if (b < 0) { return 0; } + value = (uint)b; + if ((value & 0x80) == 0) { return 1; } + value &= 0x7F; + int bytesRead = 1, shift = 7; + while (bytesRead < 9) + { + b = source.ReadByte(); + if (b < 0) throw EoF(null); + value |= ((ulong)b & 0x7F) << shift; + shift += 7; + bytesRead++; + + if ((b & 0x80) == 0) return bytesRead; + } + b = source.ReadByte(); + if (b < 0) throw EoF(null); + if ((b & 1) == 0) // only use 1 bit from the last byte + { + value |= ((ulong)b & 0x7F) << shift; + return ++bytesRead; + } + throw new OverflowException(); + } + + internal static void Seek(Stream source, long count, byte[] buffer) + { + if (source.CanSeek) + { + source.Seek(count, SeekOrigin.Current); + count = 0; + } + else if (buffer != null) + { + int bytesRead; + while (count > buffer.Length && (bytesRead = source.Read(buffer, 0, buffer.Length)) > 0) + { + count -= bytesRead; + } + while (count > 0 && (bytesRead = source.Read(buffer, 0, (int)count)) > 0) + { + count -= bytesRead; + } + } + else // borrow a buffer + { + buffer = BufferPool.GetBuffer(); + try + { + int bytesRead; + while (count > buffer.Length && (bytesRead = source.Read(buffer, 0, buffer.Length)) > 0) + { + count -= bytesRead; + } + while (count > 0 && (bytesRead = source.Read(buffer, 0, (int)count)) > 0) + { + count -= bytesRead; + } + } + finally + { + BufferPool.ReleaseBufferToPool(ref buffer); + } + } + if (count > 0) throw EoF(null); + } + internal static Exception AddErrorData(Exception exception, ProtoReader source) + { +#if !CF && !PORTABLE + if (exception != null && source != null && !exception.Data.Contains("protoSource")) + { + exception.Data.Add("protoSource", string.Format("tag={0}; wire-type={1}; offset={2}; depth={3}", + source.fieldNumber, source.wireType, source.position64, source.depth)); + } +#endif + return exception; + } + + private static Exception EoF(ProtoReader source) + { + return AddErrorData(new EndOfStreamException(), source); + } + + /// + /// Copies the current field into the instance as extension data + /// + public void AppendExtensionData(IExtensible instance) + { + if (instance == null) throw new ArgumentNullException(nameof(instance)); + IExtension extn = instance.GetExtensionObject(true); + bool commit = false; + // unusually we *don't* want "using" here; the "finally" does that, with + // the extension object being responsible for disposal etc + Stream dest = extn.BeginAppend(); + try + { + //TODO: replace this with stream-based, buffered raw copying + using (ProtoWriter writer = ProtoWriter.Create(dest, model, null)) + { + AppendExtensionField(writer); + writer.Close(); + } + commit = true; + } + finally { extn.EndAppend(dest, commit); } + } + + private void AppendExtensionField(ProtoWriter writer) + { + //TODO: replace this with stream-based, buffered raw copying + ProtoWriter.WriteFieldHeader(fieldNumber, wireType, writer); + switch (wireType) + { + case WireType.Fixed32: + ProtoWriter.WriteInt32(ReadInt32(), writer); + return; + case WireType.Variant: + case WireType.SignedVariant: + case WireType.Fixed64: + ProtoWriter.WriteInt64(ReadInt64(), writer); + return; + case WireType.String: + ProtoWriter.WriteBytes(AppendBytes(null, this), writer); + return; + case WireType.StartGroup: + SubItemToken readerToken = StartSubItem(this), + writerToken = ProtoWriter.StartSubItem(null, writer); + while (ReadFieldHeader() > 0) { AppendExtensionField(writer); } + EndSubItem(readerToken, this); + ProtoWriter.EndSubItem(writerToken, writer); + return; + case WireType.None: // treat as explicit errorr + case WireType.EndGroup: // treat as explicit error + default: // treat as implicit error + throw CreateWireTypeException(); + } + } + + /// + /// Indicates whether the reader still has data remaining in the current sub-item, + /// additionally setting the wire-type for the next field if there is more data. + /// This is used when decoding packed data. + /// + public static bool HasSubValue(ProtoBuf.WireType wireType, ProtoReader source) + { + if (source == null) throw new ArgumentNullException("source"); + // check for virtual end of stream + if (source.blockEnd64 <= source.position64 || wireType == WireType.EndGroup) { return false; } + source.wireType = wireType; + return true; + } + + internal int GetTypeKey(ref Type type) + { + return model.GetKey(ref type); + } + + internal NetObjectCache NetCache => netCache; + + internal Type DeserializeType(string value) + { + return TypeModel.DeserializeType(model, value); + } + + internal void SetRootObject(object value) + { + netCache.SetKeyedObject(NetObjectCache.Root, value); + trapCount--; + } + + /// + /// Utility method, not intended for public use; this helps maintain the root object is complex scenarios + /// + public static void NoteObject(object value, ProtoReader reader) + { + if (reader == null) throw new ArgumentNullException("reader"); + if (reader.trapCount != 0) + { + reader.netCache.RegisterTrappedObject(value); + reader.trapCount--; + } + } + + /// + /// Reads a Type from the stream, using the model's DynamicTypeFormatting if appropriate; supported wire-types: String + /// + public Type ReadType() + { + return TypeModel.DeserializeType(model, ReadString()); + } + + internal void TrapNextObject(int newObjectKey) + { + trapCount++; + netCache.SetKeyedObject(newObjectKey, null); // use null as a temp + } + + internal void CheckFullyConsumed() + { + if (isFixedLength) + { + if (dataRemaining64 != 0) throw new ProtoException("Incorrect number of bytes consumed"); + } + else + { + if (available != 0) throw new ProtoException("Unconsumed data left in the buffer; this suggests corrupt input"); + } + } + + /// + /// Merge two objects using the details from the current reader; this is used to change the type + /// of objects when an inheritance relationship is discovered later than usual during deserilazation. + /// + public static object Merge(ProtoReader parent, object from, object to) + { + if (parent == null) throw new ArgumentNullException("parent"); + TypeModel model = parent.Model; + SerializationContext ctx = parent.Context; + if (model == null) throw new InvalidOperationException("Types cannot be merged unless a type-model has been specified"); + using (var ms = new MemoryStream()) + { + model.Serialize(ms, from, ctx); + ms.Position = 0; + return model.Deserialize(ms, to, null); + } + } + + #region RECYCLER + + internal static ProtoReader Create(Stream source, TypeModel model, SerializationContext context, int len) + => Create(source, model, context, (long)len); + /// + /// Creates a new reader against a stream + /// + /// The source stream + /// The model to use for serialization; this can be null, but this will impair the ability to deserialize sub-objects + /// Additional context about this serialization operation + /// The number of bytes to read, or -1 to read until the end of the stream + public static ProtoReader Create(Stream source, TypeModel model, SerializationContext context = null, long length = TO_EOF) + { + ProtoReader reader = GetRecycled(); + if (reader == null) + { +#pragma warning disable CS0618 + return new ProtoReader(source, model, context, length); +#pragma warning restore CS0618 + } + Init(reader, source, model, context, length); + return reader; + } + +#if !PLAT_NO_THREADSTATIC + [ThreadStatic] + private static ProtoReader lastReader; + + private static ProtoReader GetRecycled() + { + ProtoReader tmp = lastReader; + lastReader = null; + return tmp; + } + internal static void Recycle(ProtoReader reader) + { + if (reader != null) + { + reader.Dispose(); + lastReader = reader; + } + } +#elif !PLAT_NO_INTERLOCKED + private static object lastReader; + private static ProtoReader GetRecycled() + { + return (ProtoReader)System.Threading.Interlocked.Exchange(ref lastReader, null); + } + internal static void Recycle(ProtoReader reader) + { + if(reader != null) + { + reader.Dispose(); + System.Threading.Interlocked.Exchange(ref lastReader, reader); + } + } +#else + private static readonly object recycleLock = new object(); + private static ProtoReader lastReader; + private static ProtoReader GetRecycled() + { + lock(recycleLock) + { + ProtoReader tmp = lastReader; + lastReader = null; + return tmp; + } + } + internal static void Recycle(ProtoReader reader) + { + if(reader != null) + { + reader.Dispose(); + lock(recycleLock) + { + lastReader = reader; + } + } + } +#endif + + #endregion + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoWriter.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoWriter.cs new file mode 100644 index 0000000..23fa42d --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ProtoWriter.cs @@ -0,0 +1,1003 @@ +using System; +using System.IO; +using System.Text; +using ProtoBuf.Meta; + +namespace ProtoBuf +{ + /// + /// Represents an output stream for writing protobuf data. + /// + /// Why is the API backwards (static methods with writer arguments)? + /// See: http://marcgravell.blogspot.com/2010/03/last-will-be-first-and-first-will-be.html + /// + public sealed class ProtoWriter : IDisposable + { + private Stream dest; + TypeModel model; + /// + /// Write an encapsulated sub-object, using the supplied unique key (reprasenting a type). + /// + /// The object to write. + /// The key that uniquely identifies the type within the model. + /// The destination. + public static void WriteObject(object value, int key, ProtoWriter writer) + { + if (writer == null) throw new ArgumentNullException("writer"); + if (writer.model == null) + { + throw new InvalidOperationException("Cannot serialize sub-objects unless a model is provided"); + } + + SubItemToken token = StartSubItem(value, writer); + if (key >= 0) + { + writer.model.Serialize(key, value, writer); + } + else if (writer.model != null && writer.model.TrySerializeAuxiliaryType(writer, value.GetType(), DataFormat.Default, Serializer.ListItemTag, value, false, null)) + { + // all ok + } + else + { + TypeModel.ThrowUnexpectedType(value.GetType()); + } + + EndSubItem(token, writer); + } + /// + /// Write an encapsulated sub-object, using the supplied unique key (reprasenting a type) - but the + /// caller is asserting that this relationship is non-recursive; no recursion check will be + /// performed. + /// + /// The object to write. + /// The key that uniquely identifies the type within the model. + /// The destination. + public static void WriteRecursionSafeObject(object value, int key, ProtoWriter writer) + { + if (writer == null) throw new ArgumentNullException(nameof(writer)); + if (writer.model == null) + { + throw new InvalidOperationException("Cannot serialize sub-objects unless a model is provided"); + } + SubItemToken token = StartSubItem(null, writer); + writer.model.Serialize(key, value, writer); + EndSubItem(token, writer); + } + + internal static void WriteObject(object value, int key, ProtoWriter writer, PrefixStyle style, int fieldNumber) + { + if (writer.model == null) + { + throw new InvalidOperationException("Cannot serialize sub-objects unless a model is provided"); + } + if (writer.wireType != WireType.None) throw ProtoWriter.CreateException(writer); + + switch (style) + { + case PrefixStyle.Base128: + writer.wireType = WireType.String; + writer.fieldNumber = fieldNumber; + if (fieldNumber > 0) WriteHeaderCore(fieldNumber, WireType.String, writer); + break; + case PrefixStyle.Fixed32: + case PrefixStyle.Fixed32BigEndian: + writer.fieldNumber = 0; + writer.wireType = WireType.Fixed32; + break; + default: + throw new ArgumentOutOfRangeException("style"); + } + SubItemToken token = StartSubItem(value, writer, true); + if (key < 0) + { + if (!writer.model.TrySerializeAuxiliaryType(writer, value.GetType(), DataFormat.Default, Serializer.ListItemTag, value, false, null)) + { + TypeModel.ThrowUnexpectedType(value.GetType()); + } + } + else + { + writer.model.Serialize(key, value, writer); + } + EndSubItem(token, writer, style); + } + + internal int GetTypeKey(ref Type type) + { + return model.GetKey(ref type); + } + + private readonly NetObjectCache netCache = new NetObjectCache(); + internal NetObjectCache NetCache => netCache; + + private int fieldNumber, flushLock; + WireType wireType; + internal WireType WireType { get { return wireType; } } + /// + /// Writes a field-header, indicating the format of the next data we plan to write. + /// + public static void WriteFieldHeader(int fieldNumber, WireType wireType, ProtoWriter writer) + { + if (writer == null) throw new ArgumentNullException("writer"); + if (writer.wireType != WireType.None) throw new InvalidOperationException("Cannot write a " + wireType.ToString() + + " header until the " + writer.wireType.ToString() + " data has been written"); + if (fieldNumber < 0) throw new ArgumentOutOfRangeException("fieldNumber"); +#if DEBUG + switch (wireType) + { // validate requested header-type + case WireType.Fixed32: + case WireType.Fixed64: + case WireType.String: + case WireType.StartGroup: + case WireType.SignedVariant: + case WireType.Variant: + break; // fine + case WireType.None: + case WireType.EndGroup: + default: + throw new ArgumentException("Invalid wire-type: " + wireType.ToString(), "wireType"); + } +#endif + if (writer.packedFieldNumber == 0) + { + writer.fieldNumber = fieldNumber; + writer.wireType = wireType; + WriteHeaderCore(fieldNumber, wireType, writer); + } + else if (writer.packedFieldNumber == fieldNumber) + { // we'll set things up, but note we *don't* actually write the header here + switch (wireType) + { + case WireType.Fixed32: + case WireType.Fixed64: + case WireType.Variant: + case WireType.SignedVariant: + break; // fine + default: + throw new InvalidOperationException("Wire-type cannot be encoded as packed: " + wireType.ToString()); + } + writer.fieldNumber = fieldNumber; + writer.wireType = wireType; + } + else + { + throw new InvalidOperationException("Field mismatch during packed encoding; expected " + writer.packedFieldNumber.ToString() + " but received " + fieldNumber.ToString()); + } + } + internal static void WriteHeaderCore(int fieldNumber, WireType wireType, ProtoWriter writer) + { + uint header = (((uint)fieldNumber) << 3) + | (((uint)wireType) & 7); + WriteUInt32Variant(header, writer); + } + + /// + /// Writes a byte-array to the stream; supported wire-types: String + /// + public static void WriteBytes(byte[] data, ProtoWriter writer) + { + if (data == null) throw new ArgumentNullException(nameof(data)); + ProtoWriter.WriteBytes(data, 0, data.Length, writer); + } + /// + /// Writes a byte-array to the stream; supported wire-types: String + /// + public static void WriteBytes(byte[] data, int offset, int length, ProtoWriter writer) + { + if (data == null) throw new ArgumentNullException(nameof(data)); + if (writer == null) throw new ArgumentNullException(nameof(writer)); + switch (writer.wireType) + { + case WireType.Fixed32: + if (length != 4) throw new ArgumentException(nameof(length)); + goto CopyFixedLength; // ugly but effective + case WireType.Fixed64: + if (length != 8) throw new ArgumentException(nameof(length)); + goto CopyFixedLength; // ugly but effective + case WireType.String: + WriteUInt32Variant((uint)length, writer); + writer.wireType = WireType.None; + if (length == 0) return; + if (writer.flushLock != 0 || length <= writer.ioBuffer.Length) // write to the buffer + { + goto CopyFixedLength; // ugly but effective + } + // writing data that is bigger than the buffer (and the buffer + // isn't currently locked due to a sub-object needing the size backfilled) + Flush(writer); // commit any existing data from the buffer + // now just write directly to the underlying stream + writer.dest.Write(data, offset, length); + writer.position64 += length; // since we've flushed offset etc is 0, and remains + // zero since we're writing directly to the stream + return; + } + throw CreateException(writer); + CopyFixedLength: // no point duplicating this lots of times, and don't really want another stackframe + DemandSpace(length, writer); + Buffer.BlockCopy(data, offset, writer.ioBuffer, writer.ioIndex, length); + IncrementedAndReset(length, writer); + } + private static void CopyRawFromStream(Stream source, ProtoWriter writer) + { + byte[] buffer = writer.ioBuffer; + int space = buffer.Length - writer.ioIndex, bytesRead = 1; // 1 here to spoof case where already full + + // try filling the buffer first + while (space > 0 && (bytesRead = source.Read(buffer, writer.ioIndex, space)) > 0) + { + writer.ioIndex += bytesRead; + writer.position64 += bytesRead; + space -= bytesRead; + } + if (bytesRead <= 0) return; // all done using just the buffer; stream exhausted + + // at this point the stream still has data, but buffer is full; + if (writer.flushLock == 0) + { + // flush the buffer and write to the underlying stream instead + Flush(writer); + while ((bytesRead = source.Read(buffer, 0, buffer.Length)) > 0) + { + writer.dest.Write(buffer, 0, bytesRead); + writer.position64 += bytesRead; + } + } + else + { + do + { + // need more space; resize (double) as necessary, + // requesting a reasonable minimum chunk each time + // (128 is the minimum; there may actually be much + // more space than this in the buffer) + DemandSpace(128, writer); + if ((bytesRead = source.Read(writer.ioBuffer, writer.ioIndex, + writer.ioBuffer.Length - writer.ioIndex)) <= 0) break; + writer.position64 += bytesRead; + writer.ioIndex += bytesRead; + } while (true); + } + + } + private static void IncrementedAndReset(int length, ProtoWriter writer) + { + Helpers.DebugAssert(length >= 0); + writer.ioIndex += length; + writer.position64 += length; + writer.wireType = WireType.None; + } + int depth = 0; + const int RecursionCheckDepth = 25; + /// + /// Indicates the start of a nested record. + /// + /// The instance to write. + /// The destination. + /// A token representing the state of the stream; this token is given to EndSubItem. + public static SubItemToken StartSubItem(object instance, ProtoWriter writer) + { + return StartSubItem(instance, writer, false); + } + + MutableList recursionStack; + private void CheckRecursionStackAndPush(object instance) + { + int hitLevel; + if (recursionStack == null) { recursionStack = new MutableList(); } + else if (instance != null && (hitLevel = recursionStack.IndexOfReference(instance)) >= 0) + { +#if DEBUG + Helpers.DebugWriteLine("Stack:"); + foreach (object obj in recursionStack) + { + Helpers.DebugWriteLine(obj == null ? "" : obj.ToString()); + } + Helpers.DebugWriteLine(instance == null ? "" : instance.ToString()); +#endif + throw new ProtoException("Possible recursion detected (offset: " + (recursionStack.Count - hitLevel).ToString() + " level(s)): " + instance.ToString()); + } + recursionStack.Add(instance); + } + private void PopRecursionStack() { recursionStack.RemoveLast(); } + + private static SubItemToken StartSubItem(object instance, ProtoWriter writer, bool allowFixed) + { + if (writer == null) throw new ArgumentNullException("writer"); + if (++writer.depth > RecursionCheckDepth) + { + writer.CheckRecursionStackAndPush(instance); + } + if (writer.packedFieldNumber != 0) throw new InvalidOperationException("Cannot begin a sub-item while performing packed encoding"); + switch (writer.wireType) + { + case WireType.StartGroup: + writer.wireType = WireType.None; + return new SubItemToken((long)(-writer.fieldNumber)); + case WireType.String: +#if DEBUG + if (writer.model != null && writer.model.ForwardsOnly) + { + throw new ProtoException("Should not be buffering data: " + instance ?? "(null)"); + } +#endif + writer.wireType = WireType.None; + DemandSpace(32, writer); // make some space in anticipation... + writer.flushLock++; + writer.position64++; + return new SubItemToken((long)(writer.ioIndex++)); // leave 1 space (optimistic) for length + case WireType.Fixed32: + { + if (!allowFixed) throw CreateException(writer); + DemandSpace(32, writer); // make some space in anticipation... + writer.flushLock++; + SubItemToken token = new SubItemToken((long)writer.ioIndex); + ProtoWriter.IncrementedAndReset(4, writer); // leave 4 space (rigid) for length + return token; + } + default: + throw CreateException(writer); + } + } + + /// + /// Indicates the end of a nested record. + /// + /// The token obtained from StartubItem. + /// The destination. + public static void EndSubItem(SubItemToken token, ProtoWriter writer) + { + EndSubItem(token, writer, PrefixStyle.Base128); + } + private static void EndSubItem(SubItemToken token, ProtoWriter writer, PrefixStyle style) + { + if (writer == null) throw new ArgumentNullException("writer"); + if (writer.wireType != WireType.None) { throw CreateException(writer); } + int value = (int)token.value64; + if (writer.depth <= 0) throw CreateException(writer); + if (writer.depth-- > RecursionCheckDepth) + { + writer.PopRecursionStack(); + } + writer.packedFieldNumber = 0; // ending the sub-item always wipes packed encoding + if (value < 0) + { // group - very simple append + WriteHeaderCore(-value, WireType.EndGroup, writer); + writer.wireType = WireType.None; + return; + } + + // so we're backfilling the length into an existing sequence + int len; + switch (style) + { + case PrefixStyle.Fixed32: + len = (int)((writer.ioIndex - value) - 4); + ProtoWriter.WriteInt32ToBuffer(len, writer.ioBuffer, value); + break; + case PrefixStyle.Fixed32BigEndian: + len = (int)((writer.ioIndex - value) - 4); + byte[] buffer = writer.ioBuffer; + ProtoWriter.WriteInt32ToBuffer(len, buffer, value); + // and swap the byte order + byte b = buffer[value]; + buffer[value] = buffer[value + 3]; + buffer[value + 3] = b; + b = buffer[value + 1]; + buffer[value + 1] = buffer[value + 2]; + buffer[value + 2] = b; + break; + case PrefixStyle.Base128: + // string - complicated because we only reserved one byte; + // if the prefix turns out to need more than this then + // we need to shuffle the existing data + len = (int)((writer.ioIndex - value) - 1); + int offset = 0; + uint tmp = (uint)len; + while ((tmp >>= 7) != 0) offset++; + if (offset == 0) + { + writer.ioBuffer[value] = (byte)(len & 0x7F); + } + else + { + DemandSpace(offset, writer); + byte[] blob = writer.ioBuffer; + Buffer.BlockCopy(blob, value + 1, blob, value + 1 + offset, len); + tmp = (uint)len; + do + { + blob[value++] = (byte)((tmp & 0x7F) | 0x80); + } while ((tmp >>= 7) != 0); + blob[value - 1] = (byte)(blob[value - 1] & ~0x80); + writer.position64 += offset; + writer.ioIndex += offset; + } + break; + default: + throw new ArgumentOutOfRangeException("style"); + } + // and this object is no longer a blockage - also flush if sensible + const int ADVISORY_FLUSH_SIZE = 1024; + if (--writer.flushLock == 0 && writer.ioIndex >= ADVISORY_FLUSH_SIZE) + { + ProtoWriter.Flush(writer); + } + + } + + /// + /// Creates a new writer against a stream + /// + /// The destination stream + /// The model to use for serialization; this can be null, but this will impair the ability to serialize sub-objects + /// Additional context about this serialization operation + public static ProtoWriter Create(Stream dest, TypeModel model, SerializationContext context = null) +#pragma warning disable CS0618 + => new ProtoWriter(dest, model, context); +#pragma warning restore CS0618 + + /// + /// Creates a new writer against a stream + /// + /// The destination stream + /// The model to use for serialization; this can be null, but this will impair the ability to serialize sub-objects + /// Additional context about this serialization operation + [Obsolete("Please use ProtoWriter.Create; this API may be removed in a future version", error: false)] + public ProtoWriter(Stream dest, TypeModel model, SerializationContext context) + { + if (dest == null) throw new ArgumentNullException("dest"); + if (!dest.CanWrite) throw new ArgumentException("Cannot write to stream", "dest"); + //if (model == null) throw new ArgumentNullException("model"); + this.dest = dest; + this.ioBuffer = BufferPool.GetBuffer(); + this.model = model; + this.wireType = WireType.None; + if (context == null) { context = SerializationContext.Default; } + else { context.Freeze(); } + this.context = context; + + } + + private readonly SerializationContext context; + /// + /// Addition information about this serialization operation. + /// + public SerializationContext Context => context; + + void IDisposable.Dispose() + { + Dispose(); + } + + private void Dispose() + { // importantly, this does **not** own the stream, and does not dispose it + if (dest != null) + { + Flush(this); + dest = null; + } + model = null; + BufferPool.ReleaseBufferToPool(ref ioBuffer); + } + + private byte[] ioBuffer; + private int ioIndex; + // note that this is used by some of the unit tests and should not be removed + internal static long GetLongPosition(ProtoWriter writer) { return writer.position64; } + internal static int GetPosition(ProtoWriter writer) { return checked((int)writer.position64); } + private long position64; + private static void DemandSpace(int required, ProtoWriter writer) + { + // check for enough space + if ((writer.ioBuffer.Length - writer.ioIndex) < required) + { + TryFlushOrResize(required, writer); + } + } + + private static void TryFlushOrResize(int required, ProtoWriter writer) + { + if (writer.flushLock == 0) + { + Flush(writer); // try emptying the buffer + if ((writer.ioBuffer.Length - writer.ioIndex) >= required) return; + } + + // either can't empty the buffer, or that didn't help; need more space + BufferPool.ResizeAndFlushLeft(ref writer.ioBuffer, required + writer.ioIndex, 0, writer.ioIndex); + } + + /// + /// Flushes data to the underlying stream, and releases any resources. The underlying stream is *not* disposed + /// by this operation. + /// + public void Close() + { + if (depth != 0 || flushLock != 0) throw new InvalidOperationException("Unable to close stream in an incomplete state"); + Dispose(); + } + + internal void CheckDepthFlushlock() + { + if (depth != 0 || flushLock != 0) throw new InvalidOperationException("The writer is in an incomplete state"); + } + + /// + /// Get the TypeModel associated with this writer + /// + public TypeModel Model => model; + + /// + /// Writes any buffered data (if possible) to the underlying stream. + /// + /// The writer to flush + /// It is not always possible to fully flush, since some sequences + /// may require values to be back-filled into the byte-stream. + internal static void Flush(ProtoWriter writer) + { + if (writer.flushLock == 0 && writer.ioIndex != 0) + { + writer.dest.Write(writer.ioBuffer, 0, writer.ioIndex); + writer.ioIndex = 0; + } + } + + /// + /// Writes an unsigned 32-bit integer to the stream; supported wire-types: Variant, Fixed32, Fixed64 + /// + private static void WriteUInt32Variant(uint value, ProtoWriter writer) + { + DemandSpace(5, writer); + int count = 0; + do + { + writer.ioBuffer[writer.ioIndex++] = (byte)((value & 0x7F) | 0x80); + count++; + } while ((value >>= 7) != 0); + writer.ioBuffer[writer.ioIndex - 1] &= 0x7F; + writer.position64 += count; + } + +#if COREFX + static readonly Encoding encoding = Encoding.UTF8; +#else + static readonly UTF8Encoding encoding = new UTF8Encoding(); +#endif + + internal static uint Zig(int value) + { + return (uint)((value << 1) ^ (value >> 31)); + } + + internal static ulong Zig(long value) + { + return (ulong)((value << 1) ^ (value >> 63)); + } + + private static void WriteUInt64Variant(ulong value, ProtoWriter writer) + { + DemandSpace(10, writer); + int count = 0; + do + { + writer.ioBuffer[writer.ioIndex++] = (byte)((value & 0x7F) | 0x80); + count++; + } while ((value >>= 7) != 0); + writer.ioBuffer[writer.ioIndex - 1] &= 0x7F; + writer.position64 += count; + } + + /// + /// Writes a string to the stream; supported wire-types: String + /// + public static void WriteString(string value, ProtoWriter writer) + { + if (writer == null) throw new ArgumentNullException("writer"); + if (writer.wireType != WireType.String) throw CreateException(writer); + if (value == null) throw new ArgumentNullException("value"); // written header; now what? + int len = value.Length; + if (len == 0) + { + WriteUInt32Variant(0, writer); + writer.wireType = WireType.None; + return; // just a header + } + int predicted = encoding.GetByteCount(value); + WriteUInt32Variant((uint)predicted, writer); + DemandSpace(predicted, writer); + int actual = encoding.GetBytes(value, 0, value.Length, writer.ioBuffer, writer.ioIndex); + Helpers.DebugAssert(predicted == actual); + IncrementedAndReset(actual, writer); + } + + /// + /// Writes an unsigned 64-bit integer to the stream; supported wire-types: Variant, Fixed32, Fixed64 + /// + public static void WriteUInt64(ulong value, ProtoWriter writer) + { + if (writer == null) throw new ArgumentNullException(nameof(writer)); + switch (writer.wireType) + { + case WireType.Fixed64: + ProtoWriter.WriteInt64((long)value, writer); + return; + case WireType.Variant: + WriteUInt64Variant(value, writer); + writer.wireType = WireType.None; + return; + case WireType.Fixed32: + checked { ProtoWriter.WriteUInt32((uint)value, writer); } + return; + default: + throw CreateException(writer); + } + } + + /// + /// Writes a signed 64-bit integer to the stream; supported wire-types: Variant, Fixed32, Fixed64, SignedVariant + /// + public static void WriteInt64(long value, ProtoWriter writer) + { + byte[] buffer; + int index; + if (writer == null) throw new ArgumentNullException(nameof(writer)); + switch (writer.wireType) + { + case WireType.Fixed64: + DemandSpace(8, writer); + buffer = writer.ioBuffer; + index = writer.ioIndex; + +#if NETCOREAPP2_1 + System.Buffers.Binary.BinaryPrimitives.WriteInt64LittleEndian(buffer.AsSpan(index, 8), value); +#else + buffer[index] = (byte)value; + buffer[index + 1] = (byte)(value >> 8); + buffer[index + 2] = (byte)(value >> 16); + buffer[index + 3] = (byte)(value >> 24); + buffer[index + 4] = (byte)(value >> 32); + buffer[index + 5] = (byte)(value >> 40); + buffer[index + 6] = (byte)(value >> 48); + buffer[index + 7] = (byte)(value >> 56); +#endif + IncrementedAndReset(8, writer); + return; + case WireType.SignedVariant: + WriteUInt64Variant(Zig(value), writer); + writer.wireType = WireType.None; + return; + case WireType.Variant: + if (value >= 0) + { + WriteUInt64Variant((ulong)value, writer); + writer.wireType = WireType.None; + } + else + { + DemandSpace(10, writer); + buffer = writer.ioBuffer; + index = writer.ioIndex; + buffer[index] = (byte)(value | 0x80); + buffer[index + 1] = (byte)((int)(value >> 7) | 0x80); + buffer[index + 2] = (byte)((int)(value >> 14) | 0x80); + buffer[index + 3] = (byte)((int)(value >> 21) | 0x80); + buffer[index + 4] = (byte)((int)(value >> 28) | 0x80); + buffer[index + 5] = (byte)((int)(value >> 35) | 0x80); + buffer[index + 6] = (byte)((int)(value >> 42) | 0x80); + buffer[index + 7] = (byte)((int)(value >> 49) | 0x80); + buffer[index + 8] = (byte)((int)(value >> 56) | 0x80); + buffer[index + 9] = 0x01; // sign bit + IncrementedAndReset(10, writer); + } + return; + case WireType.Fixed32: + checked { WriteInt32((int)value, writer); } + return; + default: + throw CreateException(writer); + } + } + + /// + /// Writes an unsigned 16-bit integer to the stream; supported wire-types: Variant, Fixed32, Fixed64 + /// + public static void WriteUInt32(uint value, ProtoWriter writer) + { + if (writer == null) throw new ArgumentNullException("writer"); + switch (writer.wireType) + { + case WireType.Fixed32: + ProtoWriter.WriteInt32((int)value, writer); + return; + case WireType.Fixed64: + ProtoWriter.WriteInt64((int)value, writer); + return; + case WireType.Variant: + WriteUInt32Variant(value, writer); + writer.wireType = WireType.None; + return; + default: + throw CreateException(writer); + } + } + + /// + /// Writes a signed 16-bit integer to the stream; supported wire-types: Variant, Fixed32, Fixed64, SignedVariant + /// + public static void WriteInt16(short value, ProtoWriter writer) + { + ProtoWriter.WriteInt32(value, writer); + } + + /// + /// Writes an unsigned 16-bit integer to the stream; supported wire-types: Variant, Fixed32, Fixed64 + /// + public static void WriteUInt16(ushort value, ProtoWriter writer) + { + ProtoWriter.WriteUInt32(value, writer); + } + + /// + /// Writes an unsigned 8-bit integer to the stream; supported wire-types: Variant, Fixed32, Fixed64 + /// + public static void WriteByte(byte value, ProtoWriter writer) + { + ProtoWriter.WriteUInt32(value, writer); + } + /// + /// Writes a signed 8-bit integer to the stream; supported wire-types: Variant, Fixed32, Fixed64, SignedVariant + /// + public static void WriteSByte(sbyte value, ProtoWriter writer) + { + ProtoWriter.WriteInt32(value, writer); + } + + private static void WriteInt32ToBuffer(int value, byte[] buffer, int index) + { +#if NETCOREAPP2_1 + System.Buffers.Binary.BinaryPrimitives.WriteInt32LittleEndian(buffer.AsSpan(index, 4), value); +#else + buffer[index] = (byte)value; + buffer[index + 1] = (byte)(value >> 8); + buffer[index + 2] = (byte)(value >> 16); + buffer[index + 3] = (byte)(value >> 24); +#endif + } + + /// + /// Writes a signed 32-bit integer to the stream; supported wire-types: Variant, Fixed32, Fixed64, SignedVariant + /// + public static void WriteInt32(int value, ProtoWriter writer) + { + byte[] buffer; + int index; + if (writer == null) throw new ArgumentNullException(nameof(writer)); + switch (writer.wireType) + { + case WireType.Fixed32: + DemandSpace(4, writer); + WriteInt32ToBuffer(value, writer.ioBuffer, writer.ioIndex); + IncrementedAndReset(4, writer); + return; + case WireType.Fixed64: + DemandSpace(8, writer); + buffer = writer.ioBuffer; + index = writer.ioIndex; + buffer[index] = (byte)value; + buffer[index + 1] = (byte)(value >> 8); + buffer[index + 2] = (byte)(value >> 16); + buffer[index + 3] = (byte)(value >> 24); + buffer[index + 4] = buffer[index + 5] = + buffer[index + 6] = buffer[index + 7] = 0; + IncrementedAndReset(8, writer); + return; + case WireType.SignedVariant: + WriteUInt32Variant(Zig(value), writer); + writer.wireType = WireType.None; + return; + case WireType.Variant: + if (value >= 0) + { + WriteUInt32Variant((uint)value, writer); + writer.wireType = WireType.None; + } + else + { + DemandSpace(10, writer); + buffer = writer.ioBuffer; + index = writer.ioIndex; + buffer[index] = (byte)(value | 0x80); + buffer[index + 1] = (byte)((value >> 7) | 0x80); + buffer[index + 2] = (byte)((value >> 14) | 0x80); + buffer[index + 3] = (byte)((value >> 21) | 0x80); + buffer[index + 4] = (byte)((value >> 28) | 0x80); + buffer[index + 5] = buffer[index + 6] = + buffer[index + 7] = buffer[index + 8] = (byte)0xFF; + buffer[index + 9] = (byte)0x01; + IncrementedAndReset(10, writer); + } + return; + default: + throw CreateException(writer); + } + } + + /// + /// Writes a double-precision number to the stream; supported wire-types: Fixed32, Fixed64 + /// + public +#if !FEAT_SAFE + unsafe +#endif + + static void WriteDouble(double value, ProtoWriter writer) + { + if (writer == null) throw new ArgumentNullException("writer"); + switch (writer.wireType) + { + case WireType.Fixed32: + float f = (float)value; + if (float.IsInfinity(f) && !double.IsInfinity(value)) + { + throw new OverflowException(); + } + ProtoWriter.WriteSingle(f, writer); + return; + case WireType.Fixed64: +#if FEAT_SAFE + ProtoWriter.WriteInt64(BitConverter.ToInt64(BitConverter.GetBytes(value), 0), writer); +#else + ProtoWriter.WriteInt64(*(long*)&value, writer); +#endif + return; + default: + throw CreateException(writer); + } + } + /// + /// Writes a single-precision number to the stream; supported wire-types: Fixed32, Fixed64 + /// + public +#if !FEAT_SAFE + unsafe +#endif + static void WriteSingle(float value, ProtoWriter writer) + { + if (writer == null) throw new ArgumentNullException("writer"); + switch (writer.wireType) + { + case WireType.Fixed32: +#if FEAT_SAFE + ProtoWriter.WriteInt32(BitConverter.ToInt32(BitConverter.GetBytes(value), 0), writer); +#else + ProtoWriter.WriteInt32(*(int*)&value, writer); +#endif + return; + case WireType.Fixed64: + ProtoWriter.WriteDouble((double)value, writer); + return; + default: + throw CreateException(writer); + } + } + + /// + /// Throws an exception indicating that the given enum cannot be mapped to a serialized value. + /// + public static void ThrowEnumException(ProtoWriter writer, object enumValue) + { + if (writer == null) throw new ArgumentNullException("writer"); + string rhs = enumValue == null ? "" : (enumValue.GetType().FullName + "." + enumValue.ToString()); + throw new ProtoException("No wire-value is mapped to the enum " + rhs + " at position " + writer.position64.ToString()); + } + + // general purpose serialization exception message + internal static Exception CreateException(ProtoWriter writer) + { + if (writer == null) throw new ArgumentNullException("writer"); + return new ProtoException("Invalid serialization operation with wire-type " + writer.wireType.ToString() + " at position " + writer.position64.ToString()); + } + + /// + /// Writes a boolean to the stream; supported wire-types: Variant, Fixed32, Fixed64 + /// + public static void WriteBoolean(bool value, ProtoWriter writer) + { + ProtoWriter.WriteUInt32(value ? (uint)1 : (uint)0, writer); + } + + /// + /// Copies any extension data stored for the instance to the underlying stream + /// + public static void AppendExtensionData(IExtensible instance, ProtoWriter writer) + { + if (instance == null) throw new ArgumentNullException(nameof(instance)); + if (writer == null) throw new ArgumentNullException(nameof(writer)); + // we expect the writer to be raw here; the extension data will have the + // header detail, so we'll copy it implicitly + if (writer.wireType != WireType.None) throw CreateException(writer); + + IExtension extn = instance.GetExtensionObject(false); + if (extn != null) + { + // unusually we *don't* want "using" here; the "finally" does that, with + // the extension object being responsible for disposal etc + Stream source = extn.BeginQuery(); + try + { + CopyRawFromStream(source, writer); + } + finally { extn.EndQuery(source); } + } + } + + private int packedFieldNumber; + /// + /// Used for packed encoding; indicates that the next field should be skipped rather than + /// a field header written. Note that the field number must match, else an exception is thrown + /// when the attempt is made to write the (incorrect) field. The wire-type is taken from the + /// subsequent call to WriteFieldHeader. Only primitive types can be packed. + /// + public static void SetPackedField(int fieldNumber, ProtoWriter writer) + { + if (fieldNumber <= 0) throw new ArgumentOutOfRangeException(nameof(fieldNumber)); + if (writer == null) throw new ArgumentNullException(nameof(writer)); + writer.packedFieldNumber = fieldNumber; + } + + /// + /// Used for packed encoding; explicitly reset the packed field marker; this is not required + /// if using StartSubItem/EndSubItem + /// + public static void ClearPackedField(int fieldNumber, ProtoWriter writer) + { + if (fieldNumber != writer.packedFieldNumber) + throw new InvalidOperationException("Field mismatch during packed encoding; expected " + writer.packedFieldNumber.ToString() + " but received " + fieldNumber.ToString()); + writer.packedFieldNumber = 0; + } + + /// + /// Used for packed encoding; writes the length prefix using fixed sizes rather than using + /// buffering. Only valid for fixed-32 and fixed-64 encoding. + /// + public static void WritePackedPrefix(int elementCount, WireType wireType, ProtoWriter writer) + { + if (writer.WireType != WireType.String) throw new InvalidOperationException("Invalid wire-type: " + writer.WireType); + if (elementCount < 0) throw new ArgumentOutOfRangeException(nameof(elementCount)); + ulong bytes; + switch (wireType) + { + // use long in case very large arrays are enabled + case WireType.Fixed32: bytes = ((ulong)elementCount) << 2; break; // x4 + case WireType.Fixed64: bytes = ((ulong)elementCount) << 3; break; // x8 + default: + throw new ArgumentOutOfRangeException(nameof(wireType), "Invalid wire-type: " + wireType); + } + WriteUInt64Variant(bytes, writer); + writer.wireType = WireType.None; + } + + internal string SerializeType(Type type) + { + return TypeModel.SerializeType(model, type); + } + + /// + /// Specifies a known root object to use during reference-tracked serialization + /// + public void SetRootObject(object value) + { + NetCache.SetKeyedObject(NetObjectCache.Root, value); + } + + /// + /// Writes a Type to the stream, using the model's DynamicTypeFormatting if appropriate; supported wire-types: String + /// + public static void WriteType(Type value, ProtoWriter writer) + { + if (writer == null) throw new ArgumentNullException(nameof(writer)); + WriteString(writer.SerializeType(value), writer); + } + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/SerializationContext.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/SerializationContext.cs new file mode 100644 index 0000000..80b76af --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/SerializationContext.cs @@ -0,0 +1,76 @@ +using System; + +namespace ProtoBuf +{ + /// + /// Additional information about a serialization operation + /// + public sealed class SerializationContext + { + private bool frozen; + internal void Freeze() { frozen = true; } + private void ThrowIfFrozen() { if (frozen) throw new InvalidOperationException("The serialization-context cannot be changed once it is in use"); } + private object context; + /// + /// Gets or sets a user-defined object containing additional information about this serialization/deserialization operation. + /// + public object Context + { + get { return context; } + set { if (context != value) { ThrowIfFrozen(); context = value; } } + } + + private static readonly SerializationContext @default; + + static SerializationContext() + { + @default = new SerializationContext(); + @default.Freeze(); + } + /// + /// A default SerializationContext, with minimal information. + /// + internal static SerializationContext Default => @default; +#if PLAT_BINARYFORMATTER + +#if !(COREFX || PROFILE259) + private System.Runtime.Serialization.StreamingContextStates state = System.Runtime.Serialization.StreamingContextStates.Persistence; + /// + /// Gets or sets the source or destination of the transmitted data. + /// + public System.Runtime.Serialization.StreamingContextStates State + { + get { return state; } + set { if (state != value) { ThrowIfFrozen(); state = value; } } + } +#endif + /// + /// Convert a SerializationContext to a StreamingContext + /// + public static implicit operator System.Runtime.Serialization.StreamingContext(SerializationContext ctx) + { +#if COREFX + return new System.Runtime.Serialization.StreamingContext(); +#else + if (ctx == null) return new System.Runtime.Serialization.StreamingContext(System.Runtime.Serialization.StreamingContextStates.Persistence); + return new System.Runtime.Serialization.StreamingContext(ctx.state, ctx.context); +#endif + } + /// + /// Convert a StreamingContext to a SerializationContext + /// + public static implicit operator SerializationContext (System.Runtime.Serialization.StreamingContext ctx) + { + SerializationContext result = new SerializationContext(); + +#if !(COREFX || PROFILE259) + result.Context = ctx.Context; + result.State = ctx.State; +#endif + + return result; + } +#endif + } + +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializer.cs new file mode 100644 index 0000000..8a4c38a --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializer.cs @@ -0,0 +1,514 @@ +using ProtoBuf.Meta; +using System; +using System.IO; +using System.Collections.Generic; +using System.Reflection; + +namespace ProtoBuf +{ + /// + /// Provides protocol-buffer serialization capability for concrete, attributed types. This + /// is a *default* model, but custom serializer models are also supported. + /// + /// + /// Protocol-buffer serialization is a compact binary format, designed to take + /// advantage of sparse data and knowledge of specific data types; it is also + /// extensible, allowing a type to be deserialized / merged even if some data is + /// not recognised. + /// + public static class Serializer + { +#if !NO_RUNTIME + /// + /// Suggest a .proto definition for the given type + /// + /// The type to generate a .proto definition for + /// The .proto definition as a string + public static string GetProto() => GetProto(ProtoSyntax.Proto2); + + /// + /// Suggest a .proto definition for the given type + /// + /// The type to generate a .proto definition for + /// The .proto definition as a string + public static string GetProto(ProtoSyntax syntax) + { + return RuntimeTypeModel.Default.GetSchema(RuntimeTypeModel.Default.MapType(typeof(T)), syntax); + } + /// + /// Create a deep clone of the supplied instance; any sub-items are also cloned. + /// + public static T DeepClone(T instance) + { + return instance == null ? instance : (T)RuntimeTypeModel.Default.DeepClone(instance); + } + + /// + /// Applies a protocol-buffer stream to an existing instance. + /// + /// The type being merged. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + public static T Merge(Stream source, T instance) + { + return (T)RuntimeTypeModel.Default.Deserialize(source, instance, typeof(T)); + } + + /// + /// Creates a new instance from a protocol-buffer stream + /// + /// The type to be created. + /// The binary stream to apply to the new instance (cannot be null). + /// A new, initialized instance. + public static T Deserialize(Stream source) + { + return (T)RuntimeTypeModel.Default.Deserialize(source, null, typeof(T)); + } + + /// + /// Creates a new instance from a protocol-buffer stream + /// + /// The type to be created. + /// The binary stream to apply to the new instance (cannot be null). + /// A new, initialized instance. + public static object Deserialize(Type type, Stream source) + { + return RuntimeTypeModel.Default.Deserialize(source, null, type); + } + + /// + /// Writes a protocol-buffer representation of the given instance to the supplied stream. + /// + /// The existing instance to be serialized (cannot be null). + /// The destination stream to write to. + public static void Serialize(Stream destination, T instance) + { + if (instance != null) + { + RuntimeTypeModel.Default.Serialize(destination, instance); + } + } + + /// + /// Serializes a given instance and deserializes it as a different type; + /// this can be used to translate between wire-compatible objects (where + /// two .NET types represent the same data), or to promote/demote a type + /// through an inheritance hierarchy. + /// + /// No assumption of compatibility is made between the types. + /// The type of the object being copied. + /// The type of the new object to be created. + /// The existing instance to use as a template. + /// A new instane of type TNewType, with the data from TOldType. + public static TTo ChangeType(TFrom instance) + { + using (var ms = new MemoryStream()) + { + Serialize(ms, instance); + ms.Position = 0; + return Deserialize(ms); + } + } +#if PLAT_BINARYFORMATTER && !(COREFX || PROFILE259) + /// + /// Writes a protocol-buffer representation of the given instance to the supplied SerializationInfo. + /// + /// The type being serialized. + /// The existing instance to be serialized (cannot be null). + /// The destination SerializationInfo to write to. + public static void Serialize(System.Runtime.Serialization.SerializationInfo info, T instance) where T : class, System.Runtime.Serialization.ISerializable + { + Serialize(info, new System.Runtime.Serialization.StreamingContext(System.Runtime.Serialization.StreamingContextStates.Persistence), instance); + } + /// + /// Writes a protocol-buffer representation of the given instance to the supplied SerializationInfo. + /// + /// The type being serialized. + /// The existing instance to be serialized (cannot be null). + /// The destination SerializationInfo to write to. + /// Additional information about this serialization operation. + public static void Serialize(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context, T instance) where T : class, System.Runtime.Serialization.ISerializable + { + // note: also tried byte[]... it doesn't perform hugely well with either (compared to regular serialization) + if (info == null) throw new ArgumentNullException("info"); + if (instance == null) throw new ArgumentNullException("instance"); + if (instance.GetType() != typeof(T)) throw new ArgumentException("Incorrect type", "instance"); + using (MemoryStream ms = new MemoryStream()) + { + RuntimeTypeModel.Default.Serialize(ms, instance, context); + info.AddValue(ProtoBinaryField, ms.ToArray()); + } + } +#endif +#if PLAT_XMLSERIALIZER + /// + /// Writes a protocol-buffer representation of the given instance to the supplied XmlWriter. + /// + /// The type being serialized. + /// The existing instance to be serialized (cannot be null). + /// The destination XmlWriter to write to. + public static void Serialize(System.Xml.XmlWriter writer, T instance) where T : System.Xml.Serialization.IXmlSerializable + { + if (writer == null) throw new ArgumentNullException("writer"); + if (instance == null) throw new ArgumentNullException("instance"); + + using (MemoryStream ms = new MemoryStream()) + { + Serializer.Serialize(ms, instance); + writer.WriteBase64(Helpers.GetBuffer(ms), 0, (int)ms.Length); + } + } + /// + /// Applies a protocol-buffer from an XmlReader to an existing instance. + /// + /// The type being merged. + /// The existing instance to be modified (cannot be null). + /// The XmlReader containing the data to apply to the instance (cannot be null). + public static void Merge(System.Xml.XmlReader reader, T instance) where T : System.Xml.Serialization.IXmlSerializable + { + if (reader == null) throw new ArgumentNullException("reader"); + if (instance == null) throw new ArgumentNullException("instance"); + + const int LEN = 4096; + byte[] buffer = new byte[LEN]; + int read; + using (MemoryStream ms = new MemoryStream()) + { + int depth = reader.Depth; + while(reader.Read() && reader.Depth > depth) + { + if (reader.NodeType == System.Xml.XmlNodeType.Text) + { + while ((read = reader.ReadContentAsBase64(buffer, 0, LEN)) > 0) + { + ms.Write(buffer, 0, read); + } + if (reader.Depth <= depth) break; + } + } + ms.Position = 0; + Serializer.Merge(ms, instance); + } + } +#endif + + private const string ProtoBinaryField = "proto"; +#if PLAT_BINARYFORMATTER && !(COREFX || PROFILE259) + /// + /// Applies a protocol-buffer from a SerializationInfo to an existing instance. + /// + /// The type being merged. + /// The existing instance to be modified (cannot be null). + /// The SerializationInfo containing the data to apply to the instance (cannot be null). + public static void Merge(System.Runtime.Serialization.SerializationInfo info, T instance) where T : class, System.Runtime.Serialization.ISerializable + { + Merge(info, new System.Runtime.Serialization.StreamingContext(System.Runtime.Serialization.StreamingContextStates.Persistence), instance); + } + /// + /// Applies a protocol-buffer from a SerializationInfo to an existing instance. + /// + /// The type being merged. + /// The existing instance to be modified (cannot be null). + /// The SerializationInfo containing the data to apply to the instance (cannot be null). + /// Additional information about this serialization operation. + public static void Merge(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context, T instance) where T : class, System.Runtime.Serialization.ISerializable + { + // note: also tried byte[]... it doesn't perform hugely well with either (compared to regular serialization) + if (info == null) throw new ArgumentNullException("info"); + if (instance == null) throw new ArgumentNullException("instance"); + if (instance.GetType() != typeof(T)) throw new ArgumentException("Incorrect type", "instance"); + + byte[] buffer = (byte[])info.GetValue(ProtoBinaryField, typeof(byte[])); + using (MemoryStream ms = new MemoryStream(buffer)) + { + T result = (T)RuntimeTypeModel.Default.Deserialize(ms, instance, typeof(T), context); + if (!ReferenceEquals(result, instance)) + { + throw new ProtoException("Deserialization changed the instance; cannot succeed."); + } + } + } +#endif + + /// + /// Precompiles the serializer for a given type. + /// + public static void PrepareSerializer() + { + NonGeneric.PrepareSerializer(typeof(T)); + } + +#if PLAT_BINARYFORMATTER && !(COREFX || PROFILE259) + /// + /// Creates a new IFormatter that uses protocol-buffer [de]serialization. + /// + /// The type of object to be [de]deserialized by the formatter. + /// A new IFormatter to be used during [de]serialization. + public static System.Runtime.Serialization.IFormatter CreateFormatter() + { + return RuntimeTypeModel.Default.CreateFormatter(typeof(T)); + } +#endif + /// + /// Reads a sequence of consecutive length-prefixed items from a stream, using + /// either base-128 or fixed-length prefixes. Base-128 prefixes with a tag + /// are directly comparable to serializing multiple items in succession + /// (use the tag to emulate the implicit behavior + /// when serializing a list/array). When a tag is + /// specified, any records with different tags are silently omitted. The + /// tag is ignored. The tag is ignored for fixed-length prefixes. + /// + /// The type of object to deserialize. + /// The binary stream containing the serialized records. + /// The prefix style used in the data. + /// The tag of records to return (if non-positive, then no tag is + /// expected and all records are returned). + /// The sequence of deserialized objects. + public static IEnumerable DeserializeItems(Stream source, PrefixStyle style, int fieldNumber) + { + return RuntimeTypeModel.Default.DeserializeItems(source, style, fieldNumber); + } + + /// + /// Creates a new instance from a protocol-buffer stream that has a length-prefix + /// on data (to assist with network IO). + /// + /// The type to be created. + /// The binary stream to apply to the new instance (cannot be null). + /// How to encode the length prefix. + /// A new, initialized instance. + public static T DeserializeWithLengthPrefix(Stream source, PrefixStyle style) + { + return DeserializeWithLengthPrefix(source, style, 0); + } + + /// + /// Creates a new instance from a protocol-buffer stream that has a length-prefix + /// on data (to assist with network IO). + /// + /// The type to be created. + /// The binary stream to apply to the new instance (cannot be null). + /// How to encode the length prefix. + /// The expected tag of the item (only used with base-128 prefix style). + /// A new, initialized instance. + public static T DeserializeWithLengthPrefix(Stream source, PrefixStyle style, int fieldNumber) + { + RuntimeTypeModel model = RuntimeTypeModel.Default; + return (T)model.DeserializeWithLengthPrefix(source, null, model.MapType(typeof(T)), style, fieldNumber); + } + + /// + /// Applies a protocol-buffer stream to an existing instance, using length-prefixed + /// data - useful with network IO. + /// + /// The type being merged. + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// How to encode the length prefix. + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + public static T MergeWithLengthPrefix(Stream source, T instance, PrefixStyle style) + { + RuntimeTypeModel model = RuntimeTypeModel.Default; + return (T)model.DeserializeWithLengthPrefix(source, instance, model.MapType(typeof(T)), style, 0); + } + + /// + /// Writes a protocol-buffer representation of the given instance to the supplied stream, + /// with a length-prefix. This is useful for socket programming, + /// as DeserializeWithLengthPrefix/MergeWithLengthPrefix can be used to read the single object back + /// from an ongoing stream. + /// + /// The type being serialized. + /// The existing instance to be serialized (cannot be null). + /// How to encode the length prefix. + /// The destination stream to write to. + public static void SerializeWithLengthPrefix(Stream destination, T instance, PrefixStyle style) + { + SerializeWithLengthPrefix(destination, instance, style, 0); + } + + /// + /// Writes a protocol-buffer representation of the given instance to the supplied stream, + /// with a length-prefix. This is useful for socket programming, + /// as DeserializeWithLengthPrefix/MergeWithLengthPrefix can be used to read the single object back + /// from an ongoing stream. + /// + /// The type being serialized. + /// The existing instance to be serialized (cannot be null). + /// How to encode the length prefix. + /// The destination stream to write to. + /// The tag used as a prefix to each record (only used with base-128 style prefixes). + public static void SerializeWithLengthPrefix(Stream destination, T instance, PrefixStyle style, int fieldNumber) + { + RuntimeTypeModel model = RuntimeTypeModel.Default; + model.SerializeWithLengthPrefix(destination, instance, model.MapType(typeof(T)), style, fieldNumber); + } + + /// Indicates the number of bytes expected for the next message. + /// The stream containing the data to investigate for a length. + /// The algorithm used to encode the length. + /// The length of the message, if it could be identified. + /// True if a length could be obtained, false otherwise. + public static bool TryReadLengthPrefix(Stream source, PrefixStyle style, out int length) + { + length = ProtoReader.ReadLengthPrefix(source, false, style, out int fieldNumber, out int bytesRead); + return bytesRead > 0; + } + + /// Indicates the number of bytes expected for the next message. + /// The buffer containing the data to investigate for a length. + /// The offset of the first byte to read from the buffer. + /// The number of bytes to read from the buffer. + /// The algorithm used to encode the length. + /// The length of the message, if it could be identified. + /// True if a length could be obtained, false otherwise. + public static bool TryReadLengthPrefix(byte[] buffer, int index, int count, PrefixStyle style, out int length) + { + using (Stream source = new MemoryStream(buffer, index, count)) + { + return TryReadLengthPrefix(source, style, out length); + } + } +#endif + /// + /// The field number that is used as a default when serializing/deserializing a list of objects. + /// The data is treated as repeated message with field number 1. + /// + public const int ListItemTag = 1; + + +#if !NO_RUNTIME + /// + /// Provides non-generic access to the default serializer. + /// + public static class NonGeneric + { + /// + /// Create a deep clone of the supplied instance; any sub-items are also cloned. + /// + public static object DeepClone(object instance) + { + return instance == null ? null : RuntimeTypeModel.Default.DeepClone(instance); + } + + /// + /// Writes a protocol-buffer representation of the given instance to the supplied stream. + /// + /// The existing instance to be serialized (cannot be null). + /// The destination stream to write to. + public static void Serialize(Stream dest, object instance) + { + if (instance != null) + { + RuntimeTypeModel.Default.Serialize(dest, instance); + } + } + + /// + /// Creates a new instance from a protocol-buffer stream + /// + /// The type to be created. + /// The binary stream to apply to the new instance (cannot be null). + /// A new, initialized instance. + public static object Deserialize(Type type, Stream source) + { + return RuntimeTypeModel.Default.Deserialize(source, null, type); + } + + /// Applies a protocol-buffer stream to an existing instance. + /// The existing instance to be modified (cannot be null). + /// The binary stream to apply to the instance (cannot be null). + /// The updated instance + public static object Merge(Stream source, object instance) + { + if (instance == null) throw new ArgumentNullException(nameof(instance)); + return RuntimeTypeModel.Default.Deserialize(source, instance, instance.GetType(), null); + } + + /// + /// Writes a protocol-buffer representation of the given instance to the supplied stream, + /// with a length-prefix. This is useful for socket programming, + /// as DeserializeWithLengthPrefix/MergeWithLengthPrefix can be used to read the single object back + /// from an ongoing stream. + /// + /// The existing instance to be serialized (cannot be null). + /// How to encode the length prefix. + /// The destination stream to write to. + /// The tag used as a prefix to each record (only used with base-128 style prefixes). + public static void SerializeWithLengthPrefix(Stream destination, object instance, PrefixStyle style, int fieldNumber) + { + if (instance == null) throw new ArgumentNullException(nameof(instance)); + RuntimeTypeModel model = RuntimeTypeModel.Default; + model.SerializeWithLengthPrefix(destination, instance, model.MapType(instance.GetType()), style, fieldNumber); + } + /// + /// Applies a protocol-buffer stream to an existing instance (or null), using length-prefixed + /// data - useful with network IO. + /// + /// The existing instance to be modified (can be null). + /// The binary stream to apply to the instance (cannot be null). + /// How to encode the length prefix. + /// Used to resolve types on a per-field basis. + /// The updated instance; this may be different to the instance argument if + /// either the original instance was null, or the stream defines a known sub-type of the + /// original instance. + public static bool TryDeserializeWithLengthPrefix(Stream source, PrefixStyle style, TypeResolver resolver, out object value) + { + value = RuntimeTypeModel.Default.DeserializeWithLengthPrefix(source, null, null, style, 0, resolver); + return value != null; + } + + /// + /// Indicates whether the supplied type is explicitly modelled by the model + /// + public static bool CanSerialize(Type type) => RuntimeTypeModel.Default.IsDefined(type); + + /// + /// Precompiles the serializer for a given type. + /// + public static void PrepareSerializer(Type t) + { +#if FEAT_COMPILER + RuntimeTypeModel model = RuntimeTypeModel.Default; + model[model.MapType(t)].CompileInPlace(); +#endif + } + } + + /// + /// Global switches that change the behavior of protobuf-net + /// + public static class GlobalOptions + { + /// + /// + /// + [Obsolete("Please use RuntimeTypeModel.Default.InferTagFromNameDefault instead (or on a per-model basis)", false)] + public static bool InferTagFromName + { + get { return RuntimeTypeModel.Default.InferTagFromNameDefault; } + set { RuntimeTypeModel.Default.InferTagFromNameDefault = value; } + } + } +#endif + /// + /// Maps a field-number to a type + /// + public delegate Type TypeResolver(int fieldNumber); + + /// + /// Releases any internal buffers that have been reserved for efficiency; this does not affect any serialization + /// operations; simply: it can be used (optionally) to release the buffers for garbage collection (at the expense + /// of having to re-allocate a new buffer for the next operation, rather than re-use prior buffers). + /// + public static void FlushPool() + { + BufferPool.Flush(); + } + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ArrayDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ArrayDecorator.cs new file mode 100644 index 0000000..cad005f --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ArrayDecorator.cs @@ -0,0 +1,310 @@ +#if !NO_RUNTIME +using System; +using System.Collections; +using System.Reflection; +using ProtoBuf.Meta; + +namespace ProtoBuf.Serializers +{ + sealed class ArrayDecorator : ProtoDecoratorBase + { + private readonly int fieldNumber; + private const byte + OPTIONS_WritePacked = 1, + OPTIONS_OverwriteList = 2, + OPTIONS_SupportNull = 4; + private readonly byte options; + private readonly WireType packedWireType; + public ArrayDecorator(TypeModel model, IProtoSerializer tail, int fieldNumber, bool writePacked, WireType packedWireType, Type arrayType, bool overwriteList, bool supportNull) + : base(tail) + { + Helpers.DebugAssert(arrayType != null, "arrayType should be non-null"); + Helpers.DebugAssert(arrayType.IsArray && arrayType.GetArrayRank() == 1, "should be single-dimension array; " + arrayType.FullName); + this.itemType = arrayType.GetElementType(); + Type underlyingItemType = supportNull ? itemType : (Helpers.GetUnderlyingType(itemType) ?? itemType); + + Helpers.DebugAssert(underlyingItemType == Tail.ExpectedType + || (Tail.ExpectedType == model.MapType(typeof(object)) && !Helpers.IsValueType(underlyingItemType)), "invalid tail"); + Helpers.DebugAssert(Tail.ExpectedType != model.MapType(typeof(byte)), "Should have used BlobSerializer"); + if ((writePacked || packedWireType != WireType.None) && fieldNumber <= 0) throw new ArgumentOutOfRangeException("fieldNumber"); + if (!ListDecorator.CanPack(packedWireType)) + { + if (writePacked) throw new InvalidOperationException("Only simple data-types can use packed encoding"); + packedWireType = WireType.None; + } + this.fieldNumber = fieldNumber; + this.packedWireType = packedWireType; + if (writePacked) options |= OPTIONS_WritePacked; + if (overwriteList) options |= OPTIONS_OverwriteList; + if (supportNull) options |= OPTIONS_SupportNull; + this.arrayType = arrayType; + } + readonly Type arrayType, itemType; // this is, for example, typeof(int[]) + public override Type ExpectedType { get { return arrayType; } } + public override bool RequiresOldValue { get { return AppendToCollection; } } + public override bool ReturnsValue { get { return true; } } + private bool CanUsePackedPrefix() => CanUsePackedPrefix(packedWireType, itemType); + + internal static bool CanUsePackedPrefix(WireType packedWireType, Type itemType) + { + // needs to be a suitably simple type *and* be definitely not nullable + switch (packedWireType) + { + case WireType.Fixed32: + case WireType.Fixed64: + break; + default: + return false; // nope + } + if (!Helpers.IsValueType(itemType)) return false; + return Helpers.GetUnderlyingType(itemType) == null; + } + +#if FEAT_COMPILER + protected override void EmitWrite(ProtoBuf.Compiler.CompilerContext ctx, ProtoBuf.Compiler.Local valueFrom) + { + // int i and T[] arr + using (Compiler.Local arr = ctx.GetLocalWithValue(arrayType, valueFrom)) + using (Compiler.Local i = new ProtoBuf.Compiler.Local(ctx, ctx.MapType(typeof(int)))) + { + bool writePacked = (options & OPTIONS_WritePacked) != 0; + bool fixedLengthPacked = writePacked && CanUsePackedPrefix(); + + using (Compiler.Local token = (writePacked && !fixedLengthPacked) ? new Compiler.Local(ctx, ctx.MapType(typeof(SubItemToken))) : null) + { + Type mappedWriter = ctx.MapType(typeof(ProtoWriter)); + if (writePacked) + { + ctx.LoadValue(fieldNumber); + ctx.LoadValue((int)WireType.String); + ctx.LoadReaderWriter(); + ctx.EmitCall(mappedWriter.GetMethod("WriteFieldHeader")); + + if (fixedLengthPacked) + { + // write directly - no need for buffering + ctx.LoadLength(arr, false); + ctx.LoadValue((int)packedWireType); + ctx.LoadReaderWriter(); + ctx.EmitCall(mappedWriter.GetMethod("WritePackedPrefix")); + } + else + { + ctx.LoadValue(arr); + ctx.LoadReaderWriter(); + ctx.EmitCall(mappedWriter.GetMethod("StartSubItem")); + ctx.StoreValue(token); + } + ctx.LoadValue(fieldNumber); + ctx.LoadReaderWriter(); + ctx.EmitCall(mappedWriter.GetMethod("SetPackedField")); + } + EmitWriteArrayLoop(ctx, i, arr); + + if (writePacked) + { + if (fixedLengthPacked) + { + ctx.LoadValue(fieldNumber); + ctx.LoadReaderWriter(); + ctx.EmitCall(mappedWriter.GetMethod("ClearPackedField")); + } + else + { + ctx.LoadValue(token); + ctx.LoadReaderWriter(); + ctx.EmitCall(mappedWriter.GetMethod("EndSubItem")); + } + } + } + } + } + + private void EmitWriteArrayLoop(Compiler.CompilerContext ctx, Compiler.Local i, Compiler.Local arr) + { + // i = 0 + ctx.LoadValue(0); + ctx.StoreValue(i); + + // range test is last (to minimise branches) + Compiler.CodeLabel loopTest = ctx.DefineLabel(), processItem = ctx.DefineLabel(); + ctx.Branch(loopTest, false); + ctx.MarkLabel(processItem); + + // {...} + ctx.LoadArrayValue(arr, i); + if (SupportNull) + { + Tail.EmitWrite(ctx, null); + } + else + { + ctx.WriteNullCheckedTail(itemType, Tail, null); + } + + // i++ + ctx.LoadValue(i); + ctx.LoadValue(1); + ctx.Add(); + ctx.StoreValue(i); + + // i < arr.Length + ctx.MarkLabel(loopTest); + ctx.LoadValue(i); + ctx.LoadLength(arr, false); + ctx.BranchIfLess(processItem, false); + } +#endif + private bool AppendToCollection => (options & OPTIONS_OverwriteList) == 0; + + private bool SupportNull { get { return (options & OPTIONS_SupportNull) != 0; } } + + public override void Write(object value, ProtoWriter dest) + { + IList arr = (IList)value; + int len = arr.Count; + SubItemToken token; + bool writePacked = (options & OPTIONS_WritePacked) != 0; + bool fixedLengthPacked = writePacked && CanUsePackedPrefix(); + + if (writePacked) + { + ProtoWriter.WriteFieldHeader(fieldNumber, WireType.String, dest); + + if (fixedLengthPacked) + { + ProtoWriter.WritePackedPrefix(arr.Count, packedWireType, dest); + token = new SubItemToken(); // default + } + else + { + token = ProtoWriter.StartSubItem(value, dest); + } + ProtoWriter.SetPackedField(fieldNumber, dest); + } + else + { + token = new SubItemToken(); // default + } + bool checkForNull = !SupportNull; + for (int i = 0; i < len; i++) + { + object obj = arr[i]; + if (checkForNull && obj == null) { throw new NullReferenceException(); } + Tail.Write(obj, dest); + } + if (writePacked) + { + if (fixedLengthPacked) + { + ProtoWriter.ClearPackedField(fieldNumber, dest); + } + else + { + ProtoWriter.EndSubItem(token, dest); + } + } + } + public override object Read(object value, ProtoReader source) + { + int field = source.FieldNumber; + BasicList list = new BasicList(); + if (packedWireType != WireType.None && source.WireType == WireType.String) + { + SubItemToken token = ProtoReader.StartSubItem(source); + while (ProtoReader.HasSubValue(packedWireType, source)) + { + list.Add(Tail.Read(null, source)); + } + ProtoReader.EndSubItem(token, source); + } + else + { + do + { + list.Add(Tail.Read(null, source)); + } while (source.TryReadFieldHeader(field)); + } + int oldLen = AppendToCollection ? ((value == null ? 0 : ((Array)value).Length)) : 0; + Array result = Array.CreateInstance(itemType, oldLen + list.Count); + if (oldLen != 0) ((Array)value).CopyTo(result, 0); + list.CopyTo(result, oldLen); + return result; + } + +#if FEAT_COMPILER + protected override void EmitRead(ProtoBuf.Compiler.CompilerContext ctx, ProtoBuf.Compiler.Local valueFrom) + { + Type listType; + listType = ctx.MapType(typeof(System.Collections.Generic.List<>)).MakeGenericType(itemType); + Type expected = ExpectedType; + using (Compiler.Local oldArr = AppendToCollection ? ctx.GetLocalWithValue(expected, valueFrom) : null) + using (Compiler.Local newArr = new Compiler.Local(ctx, expected)) + using (Compiler.Local list = new Compiler.Local(ctx, listType)) + { + ctx.EmitCtor(listType); + ctx.StoreValue(list); + ListDecorator.EmitReadList(ctx, list, Tail, listType.GetMethod("Add"), packedWireType, false); + + // leave this "using" here, as it can share the "FieldNumber" local with EmitReadList + using (Compiler.Local oldLen = AppendToCollection ? new ProtoBuf.Compiler.Local(ctx, ctx.MapType(typeof(int))) : null) + { + Type[] copyToArrayInt32Args = new Type[] { ctx.MapType(typeof(Array)), ctx.MapType(typeof(int)) }; + + if (AppendToCollection) + { + ctx.LoadLength(oldArr, true); + ctx.CopyValue(); + ctx.StoreValue(oldLen); + + ctx.LoadAddress(list, listType); + ctx.LoadValue(listType.GetProperty("Count")); + ctx.Add(); + ctx.CreateArray(itemType, null); // length is on the stack + ctx.StoreValue(newArr); + + ctx.LoadValue(oldLen); + Compiler.CodeLabel nothingToCopy = ctx.DefineLabel(); + ctx.BranchIfFalse(nothingToCopy, true); + ctx.LoadValue(oldArr); + ctx.LoadValue(newArr); + ctx.LoadValue(0); // index in target + + ctx.EmitCall(expected.GetMethod("CopyTo", copyToArrayInt32Args)); + ctx.MarkLabel(nothingToCopy); + + ctx.LoadValue(list); + ctx.LoadValue(newArr); + ctx.LoadValue(oldLen); + + } + else + { + ctx.LoadAddress(list, listType); + ctx.LoadValue(listType.GetProperty("Count")); + ctx.CreateArray(itemType, null); + ctx.StoreValue(newArr); + + ctx.LoadAddress(list, listType); + ctx.LoadValue(newArr); + ctx.LoadValue(0); + } + + copyToArrayInt32Args[0] = expected; // // prefer: CopyTo(T[], int) + MethodInfo copyTo = listType.GetMethod("CopyTo", copyToArrayInt32Args); + if (copyTo == null) + { // fallback: CopyTo(Array, int) + copyToArrayInt32Args[1] = ctx.MapType(typeof(Array)); + copyTo = listType.GetMethod("CopyTo", copyToArrayInt32Args); + } + ctx.EmitCall(copyTo); + } + ctx.LoadValue(newArr); + } + + + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/BlobSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/BlobSerializer.cs new file mode 100644 index 0000000..40b2b89 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/BlobSerializer.cs @@ -0,0 +1,59 @@ +#if !NO_RUNTIME +using System; +#if COREFX +using System.Reflection; +#endif +#if FEAT_COMPILER +using System.Reflection.Emit; +#endif + +namespace ProtoBuf.Serializers +{ + sealed class BlobSerializer : IProtoSerializer + { + public Type ExpectedType { get { return expectedType; } } + + static readonly Type expectedType = typeof(byte[]); + + public BlobSerializer(ProtoBuf.Meta.TypeModel model, bool overwriteList) + { + this.overwriteList = overwriteList; + } + + private readonly bool overwriteList; + + public object Read(object value, ProtoReader source) + { + return ProtoReader.AppendBytes(overwriteList ? null : (byte[])value, source); + } + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteBytes((byte[])value, dest); + } + + bool IProtoSerializer.RequiresOldValue { get { return !overwriteList; } } + bool IProtoSerializer.ReturnsValue { get { return true; } } +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteBytes", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + if (overwriteList) + { + ctx.LoadNullRef(); + } + else + { + ctx.LoadValue(valueFrom); + } + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)) + .GetMethod("AppendBytes")); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/BooleanSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/BooleanSerializer.cs new file mode 100644 index 0000000..c64886a --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/BooleanSerializer.cs @@ -0,0 +1,41 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class BooleanSerializer : IProtoSerializer + { + static readonly Type expectedType = typeof(bool); + + public BooleanSerializer(ProtoBuf.Meta.TypeModel model) { } + + public Type ExpectedType => expectedType; + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteBoolean((bool)value, dest); + } + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadBoolean(); + } + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteBoolean", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadBoolean", ExpectedType); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ByteSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ByteSerializer.cs new file mode 100644 index 0000000..e44a83c --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ByteSerializer.cs @@ -0,0 +1,42 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class ByteSerializer : IProtoSerializer + { + public Type ExpectedType { get { return expectedType; } } + + static readonly Type expectedType = typeof(byte); + + public ByteSerializer(ProtoBuf.Meta.TypeModel model) { } + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteByte((byte)value, dest); + } + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadByte(); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteByte", valueFrom); + } + + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadByte", ExpectedType); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/CharSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/CharSerializer.cs new file mode 100644 index 0000000..3bc30d0 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/CharSerializer.cs @@ -0,0 +1,32 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class CharSerializer : UInt16Serializer + { + static readonly Type expectedType = typeof(char); + + public CharSerializer(ProtoBuf.Meta.TypeModel model) : base(model) + { + + } + + public override Type ExpectedType => expectedType; + + public override void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteUInt16((ushort)(char)value, dest); + } + + public override object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return (char)source.ReadUInt16(); + } + + // no need for any special IL here; ushort and char are + // interchangeable as long as there is no boxing/unboxing + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/CompiledSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/CompiledSerializer.cs new file mode 100644 index 0000000..1ec3027 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/CompiledSerializer.cs @@ -0,0 +1,88 @@ +#if FEAT_COMPILER +using System; +using ProtoBuf.Meta; + +namespace ProtoBuf.Serializers +{ + sealed class CompiledSerializer : IProtoTypeSerializer + { + bool IProtoTypeSerializer.HasCallbacks(TypeModel.CallbackType callbackType) + { + return head.HasCallbacks(callbackType); // these routes only used when bits of the model not compiled + } + + bool IProtoTypeSerializer.CanCreateInstance() + { + return head.CanCreateInstance(); + } + + object IProtoTypeSerializer.CreateInstance(ProtoReader source) + { + return head.CreateInstance(source); + } + + public void Callback(object value, TypeModel.CallbackType callbackType, SerializationContext context) + { + head.Callback(value, callbackType, context); // these routes only used when bits of the model not compiled + } + + public static CompiledSerializer Wrap(IProtoTypeSerializer head, TypeModel model) + { + CompiledSerializer result = head as CompiledSerializer; + if (result == null) + { + result = new CompiledSerializer(head, model); + Helpers.DebugAssert(((IProtoTypeSerializer)result).ExpectedType == head.ExpectedType); + } + return result; + } + + private readonly IProtoTypeSerializer head; + private readonly Compiler.ProtoSerializer serializer; + private readonly Compiler.ProtoDeserializer deserializer; + + private CompiledSerializer(IProtoTypeSerializer head, TypeModel model) + { + this.head = head; + serializer = Compiler.CompilerContext.BuildSerializer(head, model); + deserializer = Compiler.CompilerContext.BuildDeserializer(head, model); + } + + bool IProtoSerializer.RequiresOldValue => head.RequiresOldValue; + + bool IProtoSerializer.ReturnsValue => head.ReturnsValue; + + Type IProtoSerializer.ExpectedType => head.ExpectedType; + + void IProtoSerializer.Write(object value, ProtoWriter dest) + { + serializer(value, dest); + } + + object IProtoSerializer.Read(object value, ProtoReader source) + { + return deserializer(value, source); + } + + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + head.EmitWrite(ctx, valueFrom); + } + + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + head.EmitRead(ctx, valueFrom); + } + + void IProtoTypeSerializer.EmitCallback(Compiler.CompilerContext ctx, Compiler.Local valueFrom, TypeModel.CallbackType callbackType) + { + head.EmitCallback(ctx, valueFrom, callbackType); + } + + void IProtoTypeSerializer.EmitCreateInstance(Compiler.CompilerContext ctx) + { + head.EmitCreateInstance(ctx); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DateTimeSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DateTimeSerializer.cs new file mode 100644 index 0000000..9755df9 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DateTimeSerializer.cs @@ -0,0 +1,65 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; + +namespace ProtoBuf.Serializers +{ + internal sealed class DateTimeSerializer : IProtoSerializer + { + private static readonly Type expectedType = typeof(DateTime); + + public Type ExpectedType => expectedType; + + bool IProtoSerializer.RequiresOldValue => false; + bool IProtoSerializer.ReturnsValue => true; + + private readonly bool includeKind, wellKnown; + + public DateTimeSerializer(DataFormat dataFormat, ProtoBuf.Meta.TypeModel model) + { + wellKnown = dataFormat == DataFormat.WellKnown; + includeKind = model?.SerializeDateTimeKind() == true; + } + + public object Read(object value, ProtoReader source) + { + if (wellKnown) + { + return BclHelpers.ReadTimestamp(source); + } + else + { + Helpers.DebugAssert(value == null); // since replaces + return BclHelpers.ReadDateTime(source); + } + } + + public void Write(object value, ProtoWriter dest) + { + if (wellKnown) + BclHelpers.WriteTimestamp((DateTime)value, dest); + else if (includeKind) + BclHelpers.WriteDateTimeWithKind((DateTime)value, dest); + else + BclHelpers.WriteDateTime((DateTime)value, dest); + } +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitWrite(ctx.MapType(typeof(BclHelpers)), + wellKnown ? nameof(BclHelpers.WriteTimestamp) + : includeKind ? nameof(BclHelpers.WriteDateTimeWithKind) : nameof(BclHelpers.WriteDateTime), valueFrom); + } + + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local entity) + { + if (wellKnown) ctx.LoadValue(entity); + ctx.EmitBasicRead(ctx.MapType(typeof(BclHelpers)), + wellKnown ? nameof(BclHelpers.ReadTimestamp) : nameof(BclHelpers.ReadDateTime), + ExpectedType); + } +#endif + + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DecimalSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DecimalSerializer.cs new file mode 100644 index 0000000..1edc621 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DecimalSerializer.cs @@ -0,0 +1,42 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class DecimalSerializer : IProtoSerializer + { + static readonly Type expectedType = typeof(decimal); + + public DecimalSerializer(ProtoBuf.Meta.TypeModel model) { } + + public Type ExpectedType => expectedType; + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return BclHelpers.ReadDecimal(source); + } + + public void Write(object value, ProtoWriter dest) + { + BclHelpers.WriteDecimal((decimal)value, dest); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitWrite(ctx.MapType(typeof(BclHelpers)), "WriteDecimal", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead(ctx.MapType(typeof(BclHelpers)), "ReadDecimal", ExpectedType); + } +#endif + + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DefaultValueDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DefaultValueDecorator.cs new file mode 100644 index 0000000..895d0c4 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DefaultValueDecorator.cs @@ -0,0 +1,259 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; +using ProtoBuf.Meta; + +namespace ProtoBuf.Serializers +{ + sealed class DefaultValueDecorator : ProtoDecoratorBase + { + public override Type ExpectedType => Tail.ExpectedType; + + public override bool RequiresOldValue => Tail.RequiresOldValue; + + public override bool ReturnsValue => Tail.ReturnsValue; + + private readonly object defaultValue; + public DefaultValueDecorator(TypeModel model, object defaultValue, IProtoSerializer tail) : base(tail) + { + if (defaultValue == null) throw new ArgumentNullException(nameof(defaultValue)); + Type type = model.MapType(defaultValue.GetType()); + if (type != tail.ExpectedType) + { + throw new ArgumentException("Default value is of incorrect type", "defaultValue"); + } + this.defaultValue = defaultValue; + } + + public override void Write(object value, ProtoWriter dest) + { + if (!object.Equals(value, defaultValue)) + { + Tail.Write(value, dest); + } + } + + public override object Read(object value, ProtoReader source) + { + return Tail.Read(value, source); + } + +#if FEAT_COMPILER + protected override void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + Compiler.CodeLabel done = ctx.DefineLabel(); + if (valueFrom == null) + { + ctx.CopyValue(); // on the stack + Compiler.CodeLabel needToPop = ctx.DefineLabel(); + EmitBranchIfDefaultValue(ctx, needToPop); + Tail.EmitWrite(ctx, null); + ctx.Branch(done, true); + ctx.MarkLabel(needToPop); + ctx.DiscardValue(); + } + else + { + ctx.LoadValue(valueFrom); // variable/parameter + EmitBranchIfDefaultValue(ctx, done); + Tail.EmitWrite(ctx, valueFrom); + } + ctx.MarkLabel(done); + } + private void EmitBeq(Compiler.CompilerContext ctx, Compiler.CodeLabel label, Type type) + { + switch (Helpers.GetTypeCode(type)) + { + case ProtoTypeCode.Boolean: + case ProtoTypeCode.Byte: + case ProtoTypeCode.Char: + case ProtoTypeCode.Double: + case ProtoTypeCode.Int16: + case ProtoTypeCode.Int32: + case ProtoTypeCode.Int64: + case ProtoTypeCode.SByte: + case ProtoTypeCode.Single: + case ProtoTypeCode.UInt16: + case ProtoTypeCode.UInt32: + case ProtoTypeCode.UInt64: + ctx.BranchIfEqual(label, false); + break; + default: +#if COREFX + MethodInfo method = type.GetMethod("op_Equality", new Type[] { type, type }); + if (method == null || !method.IsPublic || !method.IsStatic) method = null; +#else + MethodInfo method = type.GetMethod("op_Equality", BindingFlags.Public | BindingFlags.Static, + null, new Type[] { type, type }, null); +#endif + if (method == null || method.ReturnType != ctx.MapType(typeof(bool))) + { + throw new InvalidOperationException("No suitable equality operator found for default-values of type: " + type.FullName); + } + ctx.EmitCall(method); + ctx.BranchIfTrue(label, false); + break; + + } + } + private void EmitBranchIfDefaultValue(Compiler.CompilerContext ctx, Compiler.CodeLabel label) + { + Type expected = ExpectedType; + switch (Helpers.GetTypeCode(expected)) + { + case ProtoTypeCode.Boolean: + if ((bool)defaultValue) + { + ctx.BranchIfTrue(label, false); + } + else + { + ctx.BranchIfFalse(label, false); + } + break; + case ProtoTypeCode.Byte: + if ((byte)defaultValue == (byte)0) + { + ctx.BranchIfFalse(label, false); + } + else + { + ctx.LoadValue((int)(byte)defaultValue); + EmitBeq(ctx, label, expected); + } + break; + case ProtoTypeCode.SByte: + if ((sbyte)defaultValue == (sbyte)0) + { + ctx.BranchIfFalse(label, false); + } + else + { + ctx.LoadValue((int)(sbyte)defaultValue); + EmitBeq(ctx, label, expected); + } + break; + case ProtoTypeCode.Int16: + if ((short)defaultValue == (short)0) + { + ctx.BranchIfFalse(label, false); + } + else + { + ctx.LoadValue((int)(short)defaultValue); + EmitBeq(ctx, label, expected); + } + break; + case ProtoTypeCode.UInt16: + if ((ushort)defaultValue == (ushort)0) + { + ctx.BranchIfFalse(label, false); + } + else + { + ctx.LoadValue((int)(ushort)defaultValue); + EmitBeq(ctx, label, expected); + } + break; + case ProtoTypeCode.Int32: + if ((int)defaultValue == (int)0) + { + ctx.BranchIfFalse(label, false); + } + else + { + ctx.LoadValue((int)defaultValue); + EmitBeq(ctx, label, expected); + } + break; + case ProtoTypeCode.UInt32: + if ((uint)defaultValue == (uint)0) + { + ctx.BranchIfFalse(label, false); + } + else + { + ctx.LoadValue((int)(uint)defaultValue); + EmitBeq(ctx, label, expected); + } + break; + case ProtoTypeCode.Char: + if ((char)defaultValue == (char)0) + { + ctx.BranchIfFalse(label, false); + } + else + { + ctx.LoadValue((int)(char)defaultValue); + EmitBeq(ctx, label, expected); + } + break; + case ProtoTypeCode.Int64: + ctx.LoadValue((long)defaultValue); + EmitBeq(ctx, label, expected); + break; + case ProtoTypeCode.UInt64: + ctx.LoadValue((long)(ulong)defaultValue); + EmitBeq(ctx, label, expected); + break; + case ProtoTypeCode.Double: + ctx.LoadValue((double)defaultValue); + EmitBeq(ctx, label, expected); + break; + case ProtoTypeCode.Single: + ctx.LoadValue((float)defaultValue); + EmitBeq(ctx, label, expected); + break; + case ProtoTypeCode.String: + ctx.LoadValue((string)defaultValue); + EmitBeq(ctx, label, expected); + break; + case ProtoTypeCode.Decimal: + { + decimal d = (decimal)defaultValue; + ctx.LoadValue(d); + EmitBeq(ctx, label, expected); + } + break; + case ProtoTypeCode.TimeSpan: + { + TimeSpan ts = (TimeSpan)defaultValue; + if (ts == TimeSpan.Zero) + { + ctx.LoadValue(typeof(TimeSpan).GetField("Zero")); + } + else + { + ctx.LoadValue(ts.Ticks); + ctx.EmitCall(ctx.MapType(typeof(TimeSpan)).GetMethod("FromTicks")); + } + EmitBeq(ctx, label, expected); + break; + } + case ProtoTypeCode.Guid: + { + ctx.LoadValue((Guid)defaultValue); + EmitBeq(ctx, label, expected); + break; + } + case ProtoTypeCode.DateTime: + { + ctx.LoadValue(((DateTime)defaultValue).ToBinary()); + ctx.EmitCall(ctx.MapType(typeof(DateTime)).GetMethod("FromBinary")); + + EmitBeq(ctx, label, expected); + break; + } + default: + throw new NotSupportedException("Type cannot be represented as a default value: " + expected.FullName); + } + } + + protected override void EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + Tail.EmitRead(ctx, valueFrom); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DoubleSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DoubleSerializer.cs new file mode 100644 index 0000000..8b25523 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/DoubleSerializer.cs @@ -0,0 +1,42 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class DoubleSerializer : IProtoSerializer + { + static readonly Type expectedType = typeof(double); + + public DoubleSerializer(ProtoBuf.Meta.TypeModel model) { } + + public Type ExpectedType => expectedType; + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadDouble(); + } + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteDouble((double)value, dest); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteDouble", valueFrom); + } + + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadDouble", ExpectedType); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/EnumSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/EnumSerializer.cs new file mode 100644 index 0000000..78cb78a --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/EnumSerializer.cs @@ -0,0 +1,267 @@ +#if !NO_RUNTIME +using System; +using ProtoBuf.Meta; +using System.Reflection; + +namespace ProtoBuf.Serializers +{ + sealed class EnumSerializer : IProtoSerializer + { + public readonly struct EnumPair + { + public readonly object RawValue; // note that this is boxing, but I'll live with it + public readonly Enum TypedValue; // note that this is boxing, but I'll live with it + public readonly int WireValue; + public EnumPair(int wireValue, object raw, Type type) + { + WireValue = wireValue; + RawValue = raw; + TypedValue = (Enum)Enum.ToObject(type, raw); + } + } + + private readonly Type enumType; + private readonly EnumPair[] map; + public EnumSerializer(Type enumType, EnumPair[] map) + { + this.enumType = enumType ?? throw new ArgumentNullException(nameof(enumType)); + this.map = map; + if (map != null) + { + for (int i = 1; i < map.Length; i++) + for (int j = 0; j < i; j++) + { + if (map[i].WireValue == map[j].WireValue && !Equals(map[i].RawValue, map[j].RawValue)) + { + throw new ProtoException("Multiple enums with wire-value " + map[i].WireValue.ToString()); + } + if (Equals(map[i].RawValue, map[j].RawValue) && map[i].WireValue != map[j].WireValue) + { + throw new ProtoException("Multiple enums with deserialized-value " + map[i].RawValue); + } + } + + } + } + + private ProtoTypeCode GetTypeCode() + { + Type type = Helpers.GetUnderlyingType(enumType); + if (type == null) type = enumType; + return Helpers.GetTypeCode(type); + } + + public Type ExpectedType => enumType; + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + private int EnumToWire(object value) + { + unchecked + { + switch (GetTypeCode()) + { // unbox then convert to int + case ProtoTypeCode.Byte: return (int)(byte)value; + case ProtoTypeCode.SByte: return (int)(sbyte)value; + case ProtoTypeCode.Int16: return (int)(short)value; + case ProtoTypeCode.Int32: return (int)value; + case ProtoTypeCode.Int64: return (int)(long)value; + case ProtoTypeCode.UInt16: return (int)(ushort)value; + case ProtoTypeCode.UInt32: return (int)(uint)value; + case ProtoTypeCode.UInt64: return (int)(ulong)value; + default: throw new InvalidOperationException(); + } + } + } + + private object WireToEnum(int value) + { + unchecked + { + switch (GetTypeCode()) + { // convert from int then box + case ProtoTypeCode.Byte: return Enum.ToObject(enumType, (byte)value); + case ProtoTypeCode.SByte: return Enum.ToObject(enumType, (sbyte)value); + case ProtoTypeCode.Int16: return Enum.ToObject(enumType, (short)value); + case ProtoTypeCode.Int32: return Enum.ToObject(enumType, value); + case ProtoTypeCode.Int64: return Enum.ToObject(enumType, (long)value); + case ProtoTypeCode.UInt16: return Enum.ToObject(enumType, (ushort)value); + case ProtoTypeCode.UInt32: return Enum.ToObject(enumType, (uint)value); + case ProtoTypeCode.UInt64: return Enum.ToObject(enumType, (ulong)value); + default: throw new InvalidOperationException(); + } + } + } + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + int wireValue = source.ReadInt32(); + if (map == null) + { + return WireToEnum(wireValue); + } + for (int i = 0; i < map.Length; i++) + { + if (map[i].WireValue == wireValue) + { + return map[i].TypedValue; + } + } + source.ThrowEnumException(ExpectedType, wireValue); + return null; // to make compiler happy + } + + public void Write(object value, ProtoWriter dest) + { + if (map == null) + { + ProtoWriter.WriteInt32(EnumToWire(value), dest); + } + else + { + for (int i = 0; i < map.Length; i++) + { + if (object.Equals(map[i].TypedValue, value)) + { + ProtoWriter.WriteInt32(map[i].WireValue, dest); + return; + } + } + ProtoWriter.ThrowEnumException(dest, value); + } + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ProtoTypeCode typeCode = GetTypeCode(); + if (map == null) + { + ctx.LoadValue(valueFrom); + ctx.ConvertToInt32(typeCode, false); + ctx.EmitBasicWrite("WriteInt32", null); + } + else + { + using (Compiler.Local loc = ctx.GetLocalWithValue(ExpectedType, valueFrom)) + { + Compiler.CodeLabel @continue = ctx.DefineLabel(); + for (int i = 0; i < map.Length; i++) + { + Compiler.CodeLabel tryNextValue = ctx.DefineLabel(), processThisValue = ctx.DefineLabel(); + ctx.LoadValue(loc); + WriteEnumValue(ctx, typeCode, map[i].RawValue); + ctx.BranchIfEqual(processThisValue, true); + ctx.Branch(tryNextValue, true); + ctx.MarkLabel(processThisValue); + ctx.LoadValue(map[i].WireValue); + ctx.EmitBasicWrite("WriteInt32", null); + ctx.Branch(@continue, false); + ctx.MarkLabel(tryNextValue); + } + ctx.LoadReaderWriter(); + ctx.LoadValue(loc); + ctx.CastToObject(ExpectedType); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("ThrowEnumException")); + ctx.MarkLabel(@continue); + } + } + } + + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ProtoTypeCode typeCode = GetTypeCode(); + if (map == null) + { + ctx.EmitBasicRead("ReadInt32", ctx.MapType(typeof(int))); + ctx.ConvertFromInt32(typeCode, false); + } + else + { + int[] wireValues = new int[map.Length]; + object[] values = new object[map.Length]; + for (int i = 0; i < map.Length; i++) + { + wireValues[i] = map[i].WireValue; + values[i] = map[i].RawValue; + } + using (Compiler.Local result = new Compiler.Local(ctx, ExpectedType)) + using (Compiler.Local wireValue = new Compiler.Local(ctx, ctx.MapType(typeof(int)))) + { + ctx.EmitBasicRead("ReadInt32", ctx.MapType(typeof(int))); + ctx.StoreValue(wireValue); + Compiler.CodeLabel @continue = ctx.DefineLabel(); + foreach (BasicList.Group group in BasicList.GetContiguousGroups(wireValues, values)) + { + Compiler.CodeLabel tryNextGroup = ctx.DefineLabel(); + int groupItemCount = group.Items.Count; + if (groupItemCount == 1) + { + // discreet group; use an equality test + ctx.LoadValue(wireValue); + ctx.LoadValue(group.First); + Compiler.CodeLabel processThisValue = ctx.DefineLabel(); + ctx.BranchIfEqual(processThisValue, true); + ctx.Branch(tryNextGroup, false); + WriteEnumValue(ctx, typeCode, processThisValue, @continue, group.Items[0], @result); + } + else + { + // implement as a jump-table-based switch + ctx.LoadValue(wireValue); + ctx.LoadValue(group.First); + ctx.Subtract(); // jump-tables are zero-based + Compiler.CodeLabel[] jmp = new Compiler.CodeLabel[groupItemCount]; + for (int i = 0; i < groupItemCount; i++) + { + jmp[i] = ctx.DefineLabel(); + } + ctx.Switch(jmp); + // write the default... + ctx.Branch(tryNextGroup, false); + for (int i = 0; i < groupItemCount; i++) + { + WriteEnumValue(ctx, typeCode, jmp[i], @continue, group.Items[i], @result); + } + } + ctx.MarkLabel(tryNextGroup); + } + // throw source.CreateEnumException(ExpectedType, wireValue); + ctx.LoadReaderWriter(); + ctx.LoadValue(ExpectedType); + ctx.LoadValue(wireValue); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("ThrowEnumException")); + ctx.MarkLabel(@continue); + ctx.LoadValue(result); + } + } + } + private static void WriteEnumValue(Compiler.CompilerContext ctx, ProtoTypeCode typeCode, object value) + { + switch (typeCode) + { + case ProtoTypeCode.Byte: ctx.LoadValue((int)(byte)value); break; + case ProtoTypeCode.SByte: ctx.LoadValue((int)(sbyte)value); break; + case ProtoTypeCode.Int16: ctx.LoadValue((int)(short)value); break; + case ProtoTypeCode.Int32: ctx.LoadValue((int)(int)value); break; + case ProtoTypeCode.Int64: ctx.LoadValue((long)(long)value); break; + case ProtoTypeCode.UInt16: ctx.LoadValue((int)(ushort)value); break; + case ProtoTypeCode.UInt32: ctx.LoadValue((int)(uint)value); break; + case ProtoTypeCode.UInt64: ctx.LoadValue((long)(ulong)value); break; + default: throw new InvalidOperationException(); + } + } + private static void WriteEnumValue(Compiler.CompilerContext ctx, ProtoTypeCode typeCode, Compiler.CodeLabel handler, Compiler.CodeLabel @continue, object value, Compiler.Local local) + { + ctx.MarkLabel(handler); + WriteEnumValue(ctx, typeCode, value); + ctx.StoreValue(local); + ctx.Branch(@continue, false); // "continue" + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/FieldDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/FieldDecorator.cs new file mode 100644 index 0000000..26c0452 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/FieldDecorator.cs @@ -0,0 +1,104 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; + +namespace ProtoBuf.Serializers +{ + sealed class FieldDecorator : ProtoDecoratorBase + { + public override Type ExpectedType => forType; + private readonly FieldInfo field; + private readonly Type forType; + public override bool RequiresOldValue => true; + public override bool ReturnsValue => false; + public FieldDecorator(Type forType, FieldInfo field, IProtoSerializer tail) : base(tail) + { + Helpers.DebugAssert(forType != null); + Helpers.DebugAssert(field != null); + this.forType = forType; + this.field = field; + } + + public override void Write(object value, ProtoWriter dest) + { + Helpers.DebugAssert(value != null); + value = field.GetValue(value); + if (value != null) Tail.Write(value, dest); + } + + public override object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value != null); + object newValue = Tail.Read((Tail.RequiresOldValue ? field.GetValue(value) : null), source); + if (newValue != null) field.SetValue(value, newValue); + return null; + } + + +#if FEAT_COMPILER + protected override void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.LoadAddress(valueFrom, ExpectedType); + ctx.LoadValue(field); + ctx.WriteNullCheckedTail(field.FieldType, Tail, null); + } + protected override void EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + using (Compiler.Local loc = ctx.GetLocalWithValue(ExpectedType, valueFrom)) + { + if (Tail.RequiresOldValue) + { + ctx.LoadAddress(loc, ExpectedType); + ctx.LoadValue(field); + } + // value is either now on the stack or not needed + ctx.ReadNullCheckedTail(field.FieldType, Tail, null); + + // the field could be a backing field that needs to be raised back to + // the property if we're doing a full compile + MemberInfo member = field; + ctx.CheckAccessibility(ref member); + bool writeValue = member is FieldInfo; + + if (writeValue) + { + if (Tail.ReturnsValue) + { + using (Compiler.Local newVal = new Compiler.Local(ctx, field.FieldType)) + { + ctx.StoreValue(newVal); + if (Helpers.IsValueType(field.FieldType)) + { + ctx.LoadAddress(loc, ExpectedType); + ctx.LoadValue(newVal); + ctx.StoreValue(field); + } + else + { + Compiler.CodeLabel allDone = ctx.DefineLabel(); + ctx.LoadValue(newVal); + ctx.BranchIfFalse(allDone, true); // interpret null as "don't assign" + + ctx.LoadAddress(loc, ExpectedType); + ctx.LoadValue(newVal); + ctx.StoreValue(field); + + ctx.MarkLabel(allDone); + } + } + } + } + else + { + // can't use result + if (Tail.ReturnsValue) + { + ctx.DiscardValue(); + } + } + } + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/GuidSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/GuidSerializer.cs new file mode 100644 index 0000000..27556d5 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/GuidSerializer.cs @@ -0,0 +1,43 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class GuidSerializer : IProtoSerializer + { + static readonly Type expectedType = typeof(Guid); + + public GuidSerializer(ProtoBuf.Meta.TypeModel model) { } + + public Type ExpectedType { get { return expectedType; } } + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public void Write(object value, ProtoWriter dest) + { + BclHelpers.WriteGuid((Guid)value, dest); + } + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return BclHelpers.ReadGuid(source); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitWrite(ctx.MapType(typeof(BclHelpers)), "WriteGuid", valueFrom); + } + + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead(ctx.MapType(typeof(BclHelpers)), "ReadGuid", ExpectedType); + } +#endif + + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/IProtoSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/IProtoSerializer.cs new file mode 100644 index 0000000..59e8cc2 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/IProtoSerializer.cs @@ -0,0 +1,64 @@ +#if !NO_RUNTIME +using System; + + +namespace ProtoBuf.Serializers +{ + interface IProtoSerializer + { + /// + /// The type that this serializer is intended to work for. + /// + Type ExpectedType { get; } + + /// + /// Perform the steps necessary to serialize this data. + /// + /// The value to be serialized. + /// The writer entity that is accumulating the output data. + void Write(object value, ProtoWriter dest); + + /// + /// Perform the steps necessary to deserialize this data. + /// + /// The current value, if appropriate. + /// The reader providing the input data. + /// The updated / replacement value. + object Read(object value, ProtoReader source); + + /// + /// Indicates whether a Read operation replaces the existing value, or + /// extends the value. If false, the "value" parameter to Read is + /// discarded, and should be passed in as null. + /// + bool RequiresOldValue { get; } + /// + /// Now all Read operations return a value (although most do); if false no + /// value should be expected. + /// + bool ReturnsValue { get; } + +#if FEAT_COMPILER + /// Emit the IL necessary to perform the given actions + /// to serialize this data. + /// + /// Details and utilities for the method being generated. + /// The source of the data to work against; + /// If the value is only needed once, then LoadValue is sufficient. If + /// the value is needed multiple times, then note that a "null" + /// means "the top of the stack", in which case you should create your + /// own copy - GetLocalWithValue. + void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom); + + /// + /// Emit the IL necessary to perform the given actions to deserialize this data. + /// + /// Details and utilities for the method being generated. + /// For nested values, the instance holding the values; note + /// that this is not always provided - a null means not supplied. Since this is always + /// a variable or argument, it is not necessary to consume this value. + void EmitRead(Compiler.CompilerContext ctx, Compiler.Local entity); +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/IProtoTypeSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/IProtoTypeSerializer.cs new file mode 100644 index 0000000..da1439b --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/IProtoTypeSerializer.cs @@ -0,0 +1,20 @@ +#if !NO_RUNTIME +using ProtoBuf.Meta; +namespace ProtoBuf.Serializers +{ + interface IProtoTypeSerializer : IProtoSerializer + { + bool HasCallbacks(TypeModel.CallbackType callbackType); + bool CanCreateInstance(); + object CreateInstance(ProtoReader source); + void Callback(object value, TypeModel.CallbackType callbackType, SerializationContext context); + +#if FEAT_COMPILER + void EmitCallback(Compiler.CompilerContext ctx, Compiler.Local valueFrom, TypeModel.CallbackType callbackType); +#endif +#if FEAT_COMPILER + void EmitCreateInstance(Compiler.CompilerContext ctx); +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ISerializerProxy.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ISerializerProxy.cs new file mode 100644 index 0000000..3ab2cb8 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ISerializerProxy.cs @@ -0,0 +1,10 @@ +#if !NO_RUNTIME + +namespace ProtoBuf.Serializers +{ + interface ISerializerProxy + { + IProtoSerializer Serializer { get; } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ImmutableCollectionDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ImmutableCollectionDecorator.cs new file mode 100644 index 0000000..918d1fd --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ImmutableCollectionDecorator.cs @@ -0,0 +1,304 @@ +#if !NO_RUNTIME +using System; +using System.Collections; +using System.Reflection; +using ProtoBuf.Meta; + +namespace ProtoBuf.Serializers +{ + sealed class ImmutableCollectionDecorator : ListDecorator + { + protected override bool RequireAdd { get { return false; } } + + static Type ResolveIReadOnlyCollection(Type declaredType, Type t) + { +#if COREFX || PROFILE259 + if (CheckIsIReadOnlyCollectionExactly(declaredType.GetTypeInfo())) return declaredType; + foreach (Type intImplBasic in declaredType.GetTypeInfo().ImplementedInterfaces) + { + TypeInfo intImpl = intImplBasic.GetTypeInfo(); + if (CheckIsIReadOnlyCollectionExactly(intImpl)) return intImplBasic; + } +#else + if (CheckIsIReadOnlyCollectionExactly(declaredType)) return declaredType; + foreach (Type intImpl in declaredType.GetInterfaces()) + { + if (CheckIsIReadOnlyCollectionExactly(intImpl)) return intImpl; + } +#endif + return null; + } + +#if WINRT || COREFX || PROFILE259 + static bool CheckIsIReadOnlyCollectionExactly(TypeInfo t) +#else + static bool CheckIsIReadOnlyCollectionExactly(Type t) +#endif + { + if (t != null && t.IsGenericType && t.Name.StartsWith("IReadOnlyCollection`")) + { +#if WINRT || COREFX || PROFILE259 + Type[] typeArgs = t.GenericTypeArguments; + if (typeArgs.Length != 1 && typeArgs[0].GetTypeInfo().Equals(t)) return false; +#else + Type[] typeArgs = t.GetGenericArguments(); + if (typeArgs.Length != 1 && typeArgs[0] != t) return false; +#endif + + return true; + } + return false; + } + + internal static bool IdentifyImmutable(TypeModel model, Type declaredType, out MethodInfo builderFactory, out PropertyInfo isEmpty, out PropertyInfo length, out MethodInfo add, out MethodInfo addRange, out MethodInfo finish) + { + builderFactory = add = addRange = finish = null; + isEmpty = length = null; + if (model == null || declaredType == null) return false; +#if COREFX || PROFILE259 + TypeInfo declaredTypeInfo = declaredType.GetTypeInfo(); +#else + Type declaredTypeInfo = declaredType; +#endif + + // try to detect immutable collections; firstly, they are all generic, and all implement IReadOnlyCollection for some T + if (!declaredTypeInfo.IsGenericType) return false; + +#if COREFX || PROFILE259 + Type[] typeArgs = declaredTypeInfo.GenericTypeArguments, effectiveType; +#else + Type[] typeArgs = declaredTypeInfo.GetGenericArguments(), effectiveType; +#endif + switch (typeArgs.Length) + { + case 1: + effectiveType = typeArgs; + break; // fine + case 2: + Type kvp = model.MapType(typeof(System.Collections.Generic.KeyValuePair<,>)); + if (kvp == null) return false; + kvp = kvp.MakeGenericType(typeArgs); + effectiveType = new Type[] { kvp }; + break; + default: + return false; // no clue! + } + + if (ResolveIReadOnlyCollection(declaredType, null) == null) return false; // no IReadOnlyCollection found + + // and we want to use the builder API, so for generic Foo or IFoo we want to use Foo.CreateBuilder + string name = declaredType.Name; + int i = name.IndexOf('`'); + if (i <= 0) return false; + name = declaredTypeInfo.IsInterface ? name.Substring(1, i - 1) : name.Substring(0, i); + + Type outerType = model.GetType(declaredType.Namespace + "." + name, declaredTypeInfo.Assembly); + // I hate special-cases... + if (outerType == null && name == "ImmutableSet") + { + outerType = model.GetType(declaredType.Namespace + ".ImmutableHashSet", declaredTypeInfo.Assembly); + } + if (outerType == null) return false; + +#if PROFILE259 + foreach (MethodInfo method in outerType.GetTypeInfo().DeclaredMethods) +#else + foreach (MethodInfo method in outerType.GetMethods()) +#endif + { + if (!method.IsStatic || method.Name != "CreateBuilder" || !method.IsGenericMethodDefinition || method.GetParameters().Length != 0 + || method.GetGenericArguments().Length != typeArgs.Length) continue; + + builderFactory = method.MakeGenericMethod(typeArgs); + break; + } + Type voidType = model.MapType(typeof(void)); + if (builderFactory == null || builderFactory.ReturnType == null || builderFactory.ReturnType == voidType) return false; + +#if COREFX + TypeInfo typeInfo = declaredType.GetTypeInfo(); +#else + Type typeInfo = declaredType; +#endif + isEmpty = Helpers.GetProperty(typeInfo, "IsDefaultOrEmpty", false); //struct based immutabletypes can have both a "default" and "empty" state + if (isEmpty == null) isEmpty = Helpers.GetProperty(typeInfo, "IsEmpty", false); + if (isEmpty == null) + { + //Fallback to checking length if a "IsEmpty" property is not found + length = Helpers.GetProperty(typeInfo, "Length", false); + if (length == null) length = Helpers.GetProperty(typeInfo, "Count", false); + + if (length == null) length = Helpers.GetProperty(ResolveIReadOnlyCollection(declaredType, effectiveType[0]), "Count", false); + + if (length == null) return false; + } + + add = Helpers.GetInstanceMethod(builderFactory.ReturnType, "Add", effectiveType); + if (add == null) return false; + + finish = Helpers.GetInstanceMethod(builderFactory.ReturnType, "ToImmutable", Helpers.EmptyTypes); + if (finish == null || finish.ReturnType == null || finish.ReturnType == voidType) return false; + + if (!(finish.ReturnType == declaredType || Helpers.IsAssignableFrom(declaredType, finish.ReturnType))) return false; + + addRange = Helpers.GetInstanceMethod(builderFactory.ReturnType, "AddRange", new Type[] { declaredType }); + if (addRange == null) + { + Type enumerable = model.MapType(typeof(System.Collections.Generic.IEnumerable<>), false); + if (enumerable != null) + { + addRange = Helpers.GetInstanceMethod(builderFactory.ReturnType, "AddRange", new Type[] { enumerable.MakeGenericType(effectiveType) }); + } + } + + return true; + } + + private readonly MethodInfo builderFactory, add, addRange, finish; + private readonly PropertyInfo isEmpty, length; + internal ImmutableCollectionDecorator(TypeModel model, Type declaredType, Type concreteType, IProtoSerializer tail, int fieldNumber, bool writePacked, WireType packedWireType, bool returnList, bool overwriteList, bool supportNull, + MethodInfo builderFactory, PropertyInfo isEmpty, PropertyInfo length, MethodInfo add, MethodInfo addRange, MethodInfo finish) + : base(model, declaredType, concreteType, tail, fieldNumber, writePacked, packedWireType, returnList, overwriteList, supportNull) + { + this.builderFactory = builderFactory; + this.isEmpty = isEmpty; + this.length = length; + this.add = add; + this.addRange = addRange; + this.finish = finish; + } + + public override object Read(object value, ProtoReader source) + { + object builderInstance = builderFactory.Invoke(null, null); + int field = source.FieldNumber; + object[] args = new object[1]; + if (AppendToCollection && value != null && (isEmpty != null ? !(bool)isEmpty.GetValue(value, null) : (int)length.GetValue(value, null) != 0)) + { + if (addRange != null) + { + args[0] = value; + addRange.Invoke(builderInstance, args); + } + else + { + foreach (object item in (ICollection)value) + { + args[0] = item; + add.Invoke(builderInstance, args); + } + } + } + + if (packedWireType != WireType.None && source.WireType == WireType.String) + { + SubItemToken token = ProtoReader.StartSubItem(source); + while (ProtoReader.HasSubValue(packedWireType, source)) + { + args[0] = Tail.Read(null, source); + add.Invoke(builderInstance, args); + } + ProtoReader.EndSubItem(token, source); + } + else + { + do + { + args[0] = Tail.Read(null, source); + add.Invoke(builderInstance, args); + } while (source.TryReadFieldHeader(field)); + } + + return finish.Invoke(builderInstance, null); + } + +#if FEAT_COMPILER + protected override void EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + using (Compiler.Local oldList = AppendToCollection ? ctx.GetLocalWithValue(ExpectedType, valueFrom) : null) + using (Compiler.Local builder = new Compiler.Local(ctx, builderFactory.ReturnType)) + { + ctx.EmitCall(builderFactory); + ctx.StoreValue(builder); + + if (AppendToCollection) + { + Compiler.CodeLabel done = ctx.DefineLabel(); + if (!Helpers.IsValueType(ExpectedType)) + { + ctx.LoadValue(oldList); + ctx.BranchIfFalse(done, false); // old value null; nothing to add + } + + ctx.LoadAddress(oldList, oldList.Type); + if (isEmpty != null) + { + ctx.EmitCall(Helpers.GetGetMethod(isEmpty, false, false)); + ctx.BranchIfTrue(done, false); // old list is empty; nothing to add + } + else + { + ctx.EmitCall(Helpers.GetGetMethod(length, false, false)); + ctx.BranchIfFalse(done, false); // old list is empty; nothing to add + } + + Type voidType = ctx.MapType(typeof(void)); + if (addRange != null) + { + ctx.LoadValue(builder); + ctx.LoadValue(oldList); + ctx.EmitCall(addRange); + if (addRange.ReturnType != null && add.ReturnType != voidType) ctx.DiscardValue(); + } + else + { + // loop and call Add repeatedly + MethodInfo moveNext, current, getEnumerator = GetEnumeratorInfo(ctx.Model, out moveNext, out current); + Helpers.DebugAssert(moveNext != null); + Helpers.DebugAssert(current != null); + Helpers.DebugAssert(getEnumerator != null); + + Type enumeratorType = getEnumerator.ReturnType; + using (Compiler.Local iter = new Compiler.Local(ctx, enumeratorType)) + { + ctx.LoadAddress(oldList, ExpectedType); + ctx.EmitCall(getEnumerator); + ctx.StoreValue(iter); + using (ctx.Using(iter)) + { + Compiler.CodeLabel body = ctx.DefineLabel(), next = ctx.DefineLabel(); + ctx.Branch(next, false); + + ctx.MarkLabel(body); + ctx.LoadAddress(builder, builder.Type); + ctx.LoadAddress(iter, enumeratorType); + ctx.EmitCall(current); + ctx.EmitCall(add); + if (add.ReturnType != null && add.ReturnType != voidType) ctx.DiscardValue(); + + ctx.MarkLabel(@next); + ctx.LoadAddress(iter, enumeratorType); + ctx.EmitCall(moveNext); + ctx.BranchIfTrue(body, false); + } + } + } + + + ctx.MarkLabel(done); + } + + EmitReadList(ctx, builder, Tail, add, packedWireType, false); + + ctx.LoadAddress(builder, builder.Type); + ctx.EmitCall(finish); + if (ExpectedType != finish.ReturnType) + { + ctx.Cast(ExpectedType); + } + } + } +#endif + } +} +#endif diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int16Serializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int16Serializer.cs new file mode 100644 index 0000000..eac4eb4 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int16Serializer.cs @@ -0,0 +1,42 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class Int16Serializer : IProtoSerializer + { + static readonly Type expectedType = typeof(short); + + public Int16Serializer(ProtoBuf.Meta.TypeModel model) { } + + public Type ExpectedType => expectedType; + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadInt16(); + } + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteInt16((short)value, dest); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteInt16", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadInt16", ExpectedType); + } +#endif + + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int32Serializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int32Serializer.cs new file mode 100644 index 0000000..204880e --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int32Serializer.cs @@ -0,0 +1,42 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class Int32Serializer : IProtoSerializer + { + static readonly Type expectedType = typeof(int); + + public Int32Serializer(ProtoBuf.Meta.TypeModel model) { } + + public Type ExpectedType => expectedType; + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadInt32(); + } + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteInt32((int)value, dest); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteInt32", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadInt32", ExpectedType); + } +#endif + + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int64Serializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int64Serializer.cs new file mode 100644 index 0000000..2791a1e --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/Int64Serializer.cs @@ -0,0 +1,41 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class Int64Serializer : IProtoSerializer + { + static readonly Type expectedType = typeof(long); + + public Int64Serializer(ProtoBuf.Meta.TypeModel model) { } + + public Type ExpectedType => expectedType; + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadInt64(); + } + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteInt64((long)value, dest); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteInt64", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadInt64", ExpectedType); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ListDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ListDecorator.cs new file mode 100644 index 0000000..82bb128 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ListDecorator.cs @@ -0,0 +1,579 @@ +#if !NO_RUNTIME +using System; +using System.Collections; +using ProtoBuf.Meta; +using System.Reflection; + +namespace ProtoBuf.Serializers +{ + class ListDecorator : ProtoDecoratorBase + { + internal static bool CanPack(WireType wireType) + { + switch (wireType) + { + case WireType.Fixed32: + case WireType.Fixed64: + case WireType.SignedVariant: + case WireType.Variant: + return true; + default: + return false; + } + } + + private readonly byte options; + + private const byte OPTIONS_IsList = 1, + OPTIONS_SuppressIList = 2, + OPTIONS_WritePacked = 4, + OPTIONS_ReturnList = 8, + OPTIONS_OverwriteList = 16, + OPTIONS_SupportNull = 32; + + private readonly Type declaredType, concreteType; + + private readonly MethodInfo add; + + private readonly int fieldNumber; + + private bool IsList { get { return (options & OPTIONS_IsList) != 0; } } + private bool SuppressIList { get { return (options & OPTIONS_SuppressIList) != 0; } } + private bool WritePacked { get { return (options & OPTIONS_WritePacked) != 0; } } + private bool SupportNull { get { return (options & OPTIONS_SupportNull) != 0; } } + private bool ReturnList { get { return (options & OPTIONS_ReturnList) != 0; } } + protected readonly WireType packedWireType; + + internal static ListDecorator Create(TypeModel model, Type declaredType, Type concreteType, IProtoSerializer tail, int fieldNumber, bool writePacked, WireType packedWireType, bool returnList, bool overwriteList, bool supportNull) + { + if (returnList && ImmutableCollectionDecorator.IdentifyImmutable(model, declaredType, + out MethodInfo builderFactory, + out PropertyInfo isEmpty, + out PropertyInfo length, + out MethodInfo add, + out MethodInfo addRange, + out MethodInfo finish)) + { + return new ImmutableCollectionDecorator( + model, declaredType, concreteType, tail, fieldNumber, writePacked, packedWireType, returnList, overwriteList, supportNull, + builderFactory, isEmpty, length, add, addRange, finish); + } + + return new ListDecorator(model, declaredType, concreteType, tail, fieldNumber, writePacked, packedWireType, returnList, overwriteList, supportNull); + } + + protected ListDecorator(TypeModel model, Type declaredType, Type concreteType, IProtoSerializer tail, int fieldNumber, bool writePacked, WireType packedWireType, bool returnList, bool overwriteList, bool supportNull) + : base(tail) + { + if (returnList) options |= OPTIONS_ReturnList; + if (overwriteList) options |= OPTIONS_OverwriteList; + if (supportNull) options |= OPTIONS_SupportNull; + if ((writePacked || packedWireType != WireType.None) && fieldNumber <= 0) throw new ArgumentOutOfRangeException("fieldNumber"); + if (!CanPack(packedWireType)) + { + if (writePacked) throw new InvalidOperationException("Only simple data-types can use packed encoding"); + packedWireType = WireType.None; + } + + this.fieldNumber = fieldNumber; + if (writePacked) options |= OPTIONS_WritePacked; + this.packedWireType = packedWireType; + if (declaredType == null) throw new ArgumentNullException("declaredType"); + if (declaredType.IsArray) throw new ArgumentException("Cannot treat arrays as lists", "declaredType"); + this.declaredType = declaredType; + this.concreteType = concreteType; + + // look for a public list.Add(typedObject) method + if (RequireAdd) + { + bool isList; + add = TypeModel.ResolveListAdd(model, declaredType, tail.ExpectedType, out isList); + if (isList) + { + options |= OPTIONS_IsList; + string fullName = declaredType.FullName; + if (fullName != null && fullName.StartsWith("System.Data.Linq.EntitySet`1[[")) + { // see http://stackoverflow.com/questions/6194639/entityset-is-there-a-sane-reason-that-ilist-add-doesnt-set-assigned + options |= OPTIONS_SuppressIList; + } + } + if (add == null) throw new InvalidOperationException("Unable to resolve a suitable Add method for " + declaredType.FullName); + } + + } + protected virtual bool RequireAdd => true; + + public override Type ExpectedType => declaredType; + + public override bool RequiresOldValue => AppendToCollection; + + public override bool ReturnsValue => ReturnList; + + protected bool AppendToCollection + { + get { return (options & OPTIONS_OverwriteList) == 0; } + } + +#if FEAT_COMPILER + protected override void EmitRead(ProtoBuf.Compiler.CompilerContext ctx, ProtoBuf.Compiler.Local valueFrom) + { + /* This looks more complex than it is. Look at the non-compiled Read to + * see what it is trying to do, but note that it needs to cope with a + * few more scenarios. Note that it picks the **most specific** Add, + * unlike the runtime version that uses IList when possible. The core + * is just a "do {list.Add(readValue())} while {thereIsMore}" + * + * The complexity is due to: + * - value types vs reference types (boxing etc) + * - initialization if we need to pass in a value to the tail + * - handling whether or not the tail *returns* the value vs updates the input + */ + bool returnList = ReturnList; + + using (Compiler.Local list = AppendToCollection ? ctx.GetLocalWithValue(ExpectedType, valueFrom) : new Compiler.Local(ctx, declaredType)) + using (Compiler.Local origlist = (returnList && AppendToCollection && !Helpers.IsValueType(ExpectedType)) ? new Compiler.Local(ctx, ExpectedType) : null) + { + if (!AppendToCollection) + { // always new + ctx.LoadNullRef(); + ctx.StoreValue(list); + } + else if (returnList && origlist != null) + { // need a copy + ctx.LoadValue(list); + ctx.StoreValue(origlist); + } + if (concreteType != null) + { + ctx.LoadValue(list); + Compiler.CodeLabel notNull = ctx.DefineLabel(); + ctx.BranchIfTrue(notNull, true); + ctx.EmitCtor(concreteType); + ctx.StoreValue(list); + ctx.MarkLabel(notNull); + } + + bool castListForAdd = !add.DeclaringType.IsAssignableFrom(declaredType); + EmitReadList(ctx, list, Tail, add, packedWireType, castListForAdd); + + if (returnList) + { + if (AppendToCollection && origlist != null) + { + // remember ^^^^ we had a spare copy of the list on the stack; now we'll compare + ctx.LoadValue(origlist); + ctx.LoadValue(list); // [orig] [new-value] + Compiler.CodeLabel sameList = ctx.DefineLabel(), allDone = ctx.DefineLabel(); + ctx.BranchIfEqual(sameList, true); + ctx.LoadValue(list); + ctx.Branch(allDone, true); + ctx.MarkLabel(sameList); + ctx.LoadNullRef(); + ctx.MarkLabel(allDone); + } + else + { + ctx.LoadValue(list); + } + } + } + } + + internal static void EmitReadList(ProtoBuf.Compiler.CompilerContext ctx, Compiler.Local list, IProtoSerializer tail, MethodInfo add, WireType packedWireType, bool castListForAdd) + { + using (Compiler.Local fieldNumber = new Compiler.Local(ctx, ctx.MapType(typeof(int)))) + { + Compiler.CodeLabel readPacked = packedWireType == WireType.None ? new Compiler.CodeLabel() : ctx.DefineLabel(); + if (packedWireType != WireType.None) + { + ctx.LoadReaderWriter(); + ctx.LoadValue(typeof(ProtoReader).GetProperty("WireType")); + ctx.LoadValue((int)WireType.String); + ctx.BranchIfEqual(readPacked, false); + } + ctx.LoadReaderWriter(); + ctx.LoadValue(typeof(ProtoReader).GetProperty("FieldNumber")); + ctx.StoreValue(fieldNumber); + + Compiler.CodeLabel @continue = ctx.DefineLabel(); + ctx.MarkLabel(@continue); + + EmitReadAndAddItem(ctx, list, tail, add, castListForAdd); + + ctx.LoadReaderWriter(); + ctx.LoadValue(fieldNumber); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("TryReadFieldHeader")); + ctx.BranchIfTrue(@continue, false); + + if (packedWireType != WireType.None) + { + Compiler.CodeLabel allDone = ctx.DefineLabel(); + ctx.Branch(allDone, false); + ctx.MarkLabel(readPacked); + + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("StartSubItem")); + + Compiler.CodeLabel testForData = ctx.DefineLabel(), noMoreData = ctx.DefineLabel(); + ctx.MarkLabel(testForData); + ctx.LoadValue((int)packedWireType); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("HasSubValue")); + ctx.BranchIfFalse(noMoreData, false); + + EmitReadAndAddItem(ctx, list, tail, add, castListForAdd); + ctx.Branch(testForData, false); + + ctx.MarkLabel(noMoreData); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("EndSubItem")); + ctx.MarkLabel(allDone); + } + } + } + + private static void EmitReadAndAddItem(Compiler.CompilerContext ctx, Compiler.Local list, IProtoSerializer tail, MethodInfo add, bool castListForAdd) + { + ctx.LoadAddress(list, list.Type); // needs to be the reference in case the list is value-type (static-call) + if (castListForAdd) ctx.Cast(add.DeclaringType); + + Type itemType = tail.ExpectedType; + bool tailReturnsValue = tail.ReturnsValue; + if (tail.RequiresOldValue) + { + if (Helpers.IsValueType(itemType) || !tailReturnsValue) + { + // going to need a variable + using (Compiler.Local item = new Compiler.Local(ctx, itemType)) + { + if (Helpers.IsValueType(itemType)) + { // initialise the struct + ctx.LoadAddress(item, itemType); + ctx.EmitCtor(itemType); + } + else + { // assign null + ctx.LoadNullRef(); + ctx.StoreValue(item); + } + tail.EmitRead(ctx, item); + if (!tailReturnsValue) { ctx.LoadValue(item); } + } + } + else + { // no variable; pass the null on the stack and take the value *off* the stack + ctx.LoadNullRef(); + tail.EmitRead(ctx, null); + } + } + else + { + if (tailReturnsValue) + { // out only (on the stack); just emit it + tail.EmitRead(ctx, null); + } + else + { // doesn't take anything in nor return anything! WTF? + throw new InvalidOperationException(); + } + } + // our "Add" is chosen either to take the correct type, or to take "object"; + // we may need to box the value + + Type addParamType = add.GetParameters()[0].ParameterType; + if (addParamType != itemType) + { + if (addParamType == ctx.MapType(typeof(object))) + { + ctx.CastToObject(itemType); + } + else if (Helpers.GetUnderlyingType(addParamType) == itemType) + { // list is nullable + ConstructorInfo ctor = Helpers.GetConstructor(addParamType, new Type[] { itemType }, false); + ctx.EmitCtor(ctor); // the itemType on the stack is now a Nullable + } + else + { + throw new InvalidOperationException("Conflicting item/add type"); + } + } + ctx.EmitCall(add, list.Type); + if (add.ReturnType != ctx.MapType(typeof(void))) + { + ctx.DiscardValue(); + } + } +#endif + +#if COREFX + private static readonly TypeInfo ienumeratorType = typeof(IEnumerator).GetTypeInfo(), ienumerableType = typeof (IEnumerable).GetTypeInfo(); +#else + private static readonly System.Type ienumeratorType = typeof(IEnumerator), ienumerableType = typeof(IEnumerable); +#endif + protected MethodInfo GetEnumeratorInfo(TypeModel model, out MethodInfo moveNext, out MethodInfo current) + => GetEnumeratorInfo(model, ExpectedType, Tail.ExpectedType, out moveNext, out current); + internal static MethodInfo GetEnumeratorInfo(TypeModel model, Type expectedType, Type itemType, out MethodInfo moveNext, out MethodInfo current) + { + +#if COREFX + TypeInfo enumeratorType = null, iteratorType; +#else + Type enumeratorType = null, iteratorType; +#endif + + // try a custom enumerator + MethodInfo getEnumerator = Helpers.GetInstanceMethod(expectedType, "GetEnumerator", null); + + Type getReturnType = null; + if (getEnumerator != null) + { + getReturnType = getEnumerator.ReturnType; + iteratorType = getReturnType +#if COREFX || COREFX + .GetTypeInfo() +#endif + ; + moveNext = Helpers.GetInstanceMethod(iteratorType, "MoveNext", null); + PropertyInfo prop = Helpers.GetProperty(iteratorType, "Current", false); + current = prop == null ? null : Helpers.GetGetMethod(prop, false, false); +#if PROFILE259 + if (moveNext == null && (model.MapType(ienumeratorType).GetTypeInfo().IsAssignableFrom(iteratorType.GetTypeInfo()))) +#else + if (moveNext == null && (model.MapType(ienumeratorType).IsAssignableFrom(iteratorType))) +#endif + { + moveNext = Helpers.GetInstanceMethod(model.MapType(ienumeratorType), "MoveNext", null); + } + // fully typed + if (moveNext != null && moveNext.ReturnType == model.MapType(typeof(bool)) + && current != null && current.ReturnType == itemType) + { + return getEnumerator; + } + moveNext = current = getEnumerator = null; + } + + // try IEnumerable + Type tmp = model.MapType(typeof(System.Collections.Generic.IEnumerable<>), false); + + if (tmp != null) + { + tmp = tmp.MakeGenericType(itemType); + +#if COREFX + enumeratorType = tmp.GetTypeInfo(); +#else + enumeratorType = tmp; +#endif + } +; +#if PROFILE259 + if (enumeratorType != null && enumeratorType.GetTypeInfo().IsAssignableFrom(expectedType +#else + if (enumeratorType != null && enumeratorType.IsAssignableFrom(expectedType +#endif +#if COREFX || PROFILE259 + .GetTypeInfo() +#endif + )) + { + getEnumerator = Helpers.GetInstanceMethod(enumeratorType, "GetEnumerator"); + getReturnType = getEnumerator.ReturnType; + +#if COREFX + iteratorType = getReturnType.GetTypeInfo(); +#else + iteratorType = getReturnType; +#endif + + moveNext = Helpers.GetInstanceMethod(model.MapType(ienumeratorType), "MoveNext"); + current = Helpers.GetGetMethod(Helpers.GetProperty(iteratorType, "Current", false), false, false); + return getEnumerator; + } + // give up and fall-back to non-generic IEnumerable + enumeratorType = model.MapType(ienumerableType); + getEnumerator = Helpers.GetInstanceMethod(enumeratorType, "GetEnumerator"); + getReturnType = getEnumerator.ReturnType; + iteratorType = getReturnType +#if COREFX + .GetTypeInfo() +#endif + ; + moveNext = Helpers.GetInstanceMethod(iteratorType, "MoveNext"); + current = Helpers.GetGetMethod(Helpers.GetProperty(iteratorType, "Current", false), false, false); + return getEnumerator; + } +#if FEAT_COMPILER + protected override void EmitWrite(ProtoBuf.Compiler.CompilerContext ctx, ProtoBuf.Compiler.Local valueFrom) + { + using (Compiler.Local list = ctx.GetLocalWithValue(ExpectedType, valueFrom)) + { + MethodInfo getEnumerator = GetEnumeratorInfo(ctx.Model, out MethodInfo moveNext, out MethodInfo current); + Helpers.DebugAssert(moveNext != null); + Helpers.DebugAssert(current != null); + Helpers.DebugAssert(getEnumerator != null); + Type enumeratorType = getEnumerator.ReturnType; + bool writePacked = WritePacked; + using (Compiler.Local iter = new Compiler.Local(ctx, enumeratorType)) + using (Compiler.Local token = writePacked ? new Compiler.Local(ctx, ctx.MapType(typeof(SubItemToken))) : null) + { + if (writePacked) + { + ctx.LoadValue(fieldNumber); + ctx.LoadValue((int)WireType.String); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("WriteFieldHeader")); + + ctx.LoadValue(list); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("StartSubItem")); + ctx.StoreValue(token); + + ctx.LoadValue(fieldNumber); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("SetPackedField")); + } + + ctx.LoadAddress(list, ExpectedType); + ctx.EmitCall(getEnumerator, ExpectedType); + ctx.StoreValue(iter); + using (ctx.Using(iter)) + { + Compiler.CodeLabel body = ctx.DefineLabel(), next = ctx.DefineLabel(); + ctx.Branch(next, false); + + ctx.MarkLabel(body); + + ctx.LoadAddress(iter, enumeratorType); + ctx.EmitCall(current, enumeratorType); + Type itemType = Tail.ExpectedType; + if (itemType != ctx.MapType(typeof(object)) && current.ReturnType == ctx.MapType(typeof(object))) + { + ctx.CastFromObject(itemType); + } + Tail.EmitWrite(ctx, null); + + ctx.MarkLabel(@next); + ctx.LoadAddress(iter, enumeratorType); + ctx.EmitCall(moveNext, enumeratorType); + ctx.BranchIfTrue(body, false); + } + + if (writePacked) + { + ctx.LoadValue(token); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("EndSubItem")); + } + } + } + } +#endif + + public override void Write(object value, ProtoWriter dest) + { + SubItemToken token; + bool writePacked = WritePacked; + bool fixedSizePacked = writePacked & CanUsePackedPrefix(value) && value is ICollection; + if (writePacked) + { + ProtoWriter.WriteFieldHeader(fieldNumber, WireType.String, dest); + if (fixedSizePacked) + { + ProtoWriter.WritePackedPrefix(((ICollection)value).Count, packedWireType, dest); + token = default(SubItemToken); + } + else + { + token = ProtoWriter.StartSubItem(value, dest); + } + ProtoWriter.SetPackedField(fieldNumber, dest); + } + else + { + token = new SubItemToken(); // default + } + bool checkForNull = !SupportNull; + foreach (object subItem in (IEnumerable)value) + { + if (checkForNull && subItem == null) { throw new NullReferenceException(); } + Tail.Write(subItem, dest); + } + if (writePacked) + { + if (fixedSizePacked) + { + ProtoWriter.ClearPackedField(fieldNumber, dest); + } + else + { + ProtoWriter.EndSubItem(token, dest); + } + } + } + + private bool CanUsePackedPrefix(object obj) => + ArrayDecorator.CanUsePackedPrefix(packedWireType, Tail.ExpectedType); + + public override object Read(object value, ProtoReader source) + { + try + { + int field = source.FieldNumber; + object origValue = value; + if (value == null) value = Activator.CreateInstance(concreteType); + bool isList = IsList && !SuppressIList; + if (packedWireType != WireType.None && source.WireType == WireType.String) + { + SubItemToken token = ProtoReader.StartSubItem(source); + if (isList) + { + IList list = (IList)value; + while (ProtoReader.HasSubValue(packedWireType, source)) + { + list.Add(Tail.Read(null, source)); + } + } + else + { + object[] args = new object[1]; + while (ProtoReader.HasSubValue(packedWireType, source)) + { + args[0] = Tail.Read(null, source); + add.Invoke(value, args); + } + } + ProtoReader.EndSubItem(token, source); + } + else + { + if (isList) + { + IList list = (IList)value; + do + { + list.Add(Tail.Read(null, source)); + } while (source.TryReadFieldHeader(field)); + } + else + { + object[] args = new object[1]; + do + { + args[0] = Tail.Read(null, source); + add.Invoke(value, args); + } while (source.TryReadFieldHeader(field)); + } + } + return origValue == value ? null : value; + } + catch (TargetInvocationException tie) + { + if (tie.InnerException != null) throw tie.InnerException; + throw; + } + } + + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/MapDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/MapDecorator.cs new file mode 100644 index 0000000..033cf26 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/MapDecorator.cs @@ -0,0 +1,298 @@ +using ProtoBuf.Meta; +using System; +#if FEAT_COMPILER +using ProtoBuf.Compiler; +#endif +using System.Collections.Generic; +using System.Reflection; + +namespace ProtoBuf.Serializers +{ + class MapDecorator : ProtoDecoratorBase where TDictionary : class, IDictionary + { + private readonly Type concreteType; + private readonly IProtoSerializer keyTail; + private readonly int fieldNumber; + private readonly WireType wireType; + + internal MapDecorator(TypeModel model, Type concreteType, IProtoSerializer keyTail, IProtoSerializer valueTail, + int fieldNumber, WireType wireType, WireType keyWireType, WireType valueWireType, bool overwriteList) + : base(DefaultValue == null + ? (IProtoSerializer)new TagDecorator(2, valueWireType, false, valueTail) + : (IProtoSerializer)new DefaultValueDecorator(model, DefaultValue, new TagDecorator(2, valueWireType, false, valueTail))) + { + this.wireType = wireType; + this.keyTail = new DefaultValueDecorator(model, DefaultKey, new TagDecorator(1, keyWireType, false, keyTail)); + this.fieldNumber = fieldNumber; + this.concreteType = concreteType ?? typeof(TDictionary); + + if (keyTail.RequiresOldValue) throw new InvalidOperationException("Key tail should not require the old value"); + if (!keyTail.ReturnsValue) throw new InvalidOperationException("Key tail should return a value"); + if (!valueTail.ReturnsValue) throw new InvalidOperationException("Value tail should return a value"); + + AppendToCollection = !overwriteList; + } + + private static readonly MethodInfo indexerSet = GetIndexerSetter(); + + private static MethodInfo GetIndexerSetter() + { +#if PROFILE259 + foreach(var prop in typeof(TDictionary).GetRuntimeProperties()) +#else + foreach (var prop in typeof(TDictionary).GetProperties(BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic)) +#endif + { + if (prop.Name != "Item") continue; + if (prop.PropertyType != typeof(TValue)) continue; + + var args = prop.GetIndexParameters(); + if (args == null || args.Length != 1) continue; + + if (args[0].ParameterType != typeof(TKey)) continue; +#if PROFILE259 + var method = prop.SetMethod; +#else + var method = prop.GetSetMethod(true); +#endif + if (method != null) + { + return method; + } + } + throw new InvalidOperationException("Unable to resolve indexer for map"); + } + + private static readonly TKey DefaultKey = (typeof(TKey) == typeof(string)) ? (TKey)(object)"" : default(TKey); + private static readonly TValue DefaultValue = (typeof(TValue) == typeof(string)) ? (TValue)(object)"" : default(TValue); + public override Type ExpectedType => typeof(TDictionary); + + public override bool ReturnsValue => true; + + public override bool RequiresOldValue => AppendToCollection; + + private bool AppendToCollection { get; } + + public override object Read(object untyped, ProtoReader source) + { + TDictionary typed = AppendToCollection ? ((TDictionary)untyped) : null; + if (typed == null) typed = (TDictionary)Activator.CreateInstance(concreteType); + + do + { + var key = DefaultKey; + var value = DefaultValue; + SubItemToken token = ProtoReader.StartSubItem(source); + int field; + while ((field = source.ReadFieldHeader()) > 0) + { + switch (field) + { + case 1: + key = (TKey)keyTail.Read(null, source); + break; + case 2: + value = (TValue)Tail.Read(Tail.RequiresOldValue ? (object)value : null, source); + break; + default: + source.SkipField(); + break; + } + } + + ProtoReader.EndSubItem(token, source); + typed[key] = value; + } while (source.TryReadFieldHeader(fieldNumber)); + + return typed; + } + + public override void Write(object untyped, ProtoWriter dest) + { + foreach (var pair in (TDictionary)untyped) + { + ProtoWriter.WriteFieldHeader(fieldNumber, wireType, dest); + var token = ProtoWriter.StartSubItem(null, dest); + if (pair.Key != null) keyTail.Write(pair.Key, dest); + if (pair.Value != null) Tail.Write(pair.Value, dest); + ProtoWriter.EndSubItem(token, dest); + } + } + +#if FEAT_COMPILER + protected override void EmitWrite(CompilerContext ctx, Local valueFrom) + { + Type itemType = typeof(KeyValuePair); + MethodInfo moveNext, current, getEnumerator = ListDecorator.GetEnumeratorInfo(ctx.Model, + ExpectedType, itemType, out moveNext, out current); + Type enumeratorType = getEnumerator.ReturnType; + + MethodInfo key = itemType.GetProperty(nameof(KeyValuePair.Key)).GetGetMethod(), + @value = itemType.GetProperty(nameof(KeyValuePair.Value)).GetGetMethod(); + + using (Compiler.Local list = ctx.GetLocalWithValue(ExpectedType, valueFrom)) + using (Compiler.Local iter = new Compiler.Local(ctx, enumeratorType)) + using (Compiler.Local token = new Compiler.Local(ctx, typeof(SubItemToken))) + using (Compiler.Local kvp = new Compiler.Local(ctx, itemType)) + { + ctx.LoadAddress(list, ExpectedType); + ctx.EmitCall(getEnumerator, ExpectedType); + ctx.StoreValue(iter); + using (ctx.Using(iter)) + { + Compiler.CodeLabel body = ctx.DefineLabel(), next = ctx.DefineLabel(); + ctx.Branch(next, false); + + ctx.MarkLabel(body); + + ctx.LoadAddress(iter, enumeratorType); + ctx.EmitCall(current, enumeratorType); + + if (itemType != ctx.MapType(typeof(object)) && current.ReturnType == ctx.MapType(typeof(object))) + { + ctx.CastFromObject(itemType); + } + ctx.StoreValue(kvp); + + ctx.LoadValue(fieldNumber); + ctx.LoadValue((int)wireType); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("WriteFieldHeader")); + + ctx.LoadNullRef(); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("StartSubItem")); + ctx.StoreValue(token); + + ctx.LoadAddress(kvp, itemType); + ctx.EmitCall(key, itemType); + ctx.WriteNullCheckedTail(typeof(TKey), keyTail, null); + + ctx.LoadAddress(kvp, itemType); + ctx.EmitCall(value, itemType); + ctx.WriteNullCheckedTail(typeof(TValue), Tail, null); + + ctx.LoadValue(token); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("EndSubItem")); + + ctx.MarkLabel(@next); + ctx.LoadAddress(iter, enumeratorType); + ctx.EmitCall(moveNext, enumeratorType); + ctx.BranchIfTrue(body, false); + } + } + } + protected override void EmitRead(CompilerContext ctx, Local valueFrom) + { + using (Compiler.Local list = AppendToCollection ? ctx.GetLocalWithValue(ExpectedType, valueFrom) + : new Compiler.Local(ctx, typeof(TDictionary))) + using (Compiler.Local token = new Compiler.Local(ctx, typeof(SubItemToken))) + using (Compiler.Local key = new Compiler.Local(ctx, typeof(TKey))) + using (Compiler.Local @value = new Compiler.Local(ctx, typeof(TValue))) + using (Compiler.Local fieldNumber = new Compiler.Local(ctx, ctx.MapType(typeof(int)))) + { + if (!AppendToCollection) + { // always new + ctx.LoadNullRef(); + ctx.StoreValue(list); + } + if (concreteType != null) + { + ctx.LoadValue(list); + Compiler.CodeLabel notNull = ctx.DefineLabel(); + ctx.BranchIfTrue(notNull, true); + ctx.EmitCtor(concreteType); + ctx.StoreValue(list); + ctx.MarkLabel(notNull); + } + + var redoFromStart = ctx.DefineLabel(); + ctx.MarkLabel(redoFromStart); + + // key = default(TKey); value = default(TValue); + if (typeof(TKey) == typeof(string)) + { + ctx.LoadValue(""); + ctx.StoreValue(key); + } + else + { + ctx.InitLocal(typeof(TKey), key); + } + if (typeof(TValue) == typeof(string)) + { + ctx.LoadValue(""); + ctx.StoreValue(value); + } + else + { + ctx.InitLocal(typeof(TValue), @value); + } + + // token = ProtoReader.StartSubItem(reader); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("StartSubItem")); + ctx.StoreValue(token); + + Compiler.CodeLabel @continue = ctx.DefineLabel(), processField = ctx.DefineLabel(); + // while ... + ctx.Branch(@continue, false); + + // switch(fieldNumber) + ctx.MarkLabel(processField); + ctx.LoadValue(fieldNumber); + CodeLabel @default = ctx.DefineLabel(), one = ctx.DefineLabel(), two = ctx.DefineLabel(); + ctx.Switch(new[] { @default, one, two }); // zero based, hence explicit 0 + + // case 0: default: reader.SkipField(); + ctx.MarkLabel(@default); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("SkipField")); + ctx.Branch(@continue, false); + + // case 1: key = ... + ctx.MarkLabel(one); + keyTail.EmitRead(ctx, null); + ctx.StoreValue(key); + ctx.Branch(@continue, false); + + // case 2: value = ... + ctx.MarkLabel(two); + Tail.EmitRead(ctx, Tail.RequiresOldValue ? @value : null); + ctx.StoreValue(value); + + // (fieldNumber = reader.ReadFieldHeader()) > 0 + ctx.MarkLabel(@continue); + ctx.EmitBasicRead("ReadFieldHeader", ctx.MapType(typeof(int))); + ctx.CopyValue(); + ctx.StoreValue(fieldNumber); + ctx.LoadValue(0); + ctx.BranchIfGreater(processField, false); + + // ProtoReader.EndSubItem(token, reader); + ctx.LoadValue(token); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("EndSubItem")); + + // list[key] = value; + ctx.LoadAddress(list, ExpectedType); + ctx.LoadValue(key); + ctx.LoadValue(@value); + ctx.EmitCall(indexerSet); + + // while reader.TryReadFieldReader(fieldNumber) + ctx.LoadReaderWriter(); + ctx.LoadValue(this.fieldNumber); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("TryReadFieldHeader")); + ctx.BranchIfTrue(redoFromStart, false); + + if (ReturnsValue) + { + ctx.LoadValue(list); + } + } + } +#endif + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/MemberSpecifiedDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/MemberSpecifiedDecorator.cs new file mode 100644 index 0000000..3ee80a5 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/MemberSpecifiedDecorator.cs @@ -0,0 +1,76 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; + +namespace ProtoBuf.Serializers +{ + sealed class MemberSpecifiedDecorator : ProtoDecoratorBase + { + public override Type ExpectedType => Tail.ExpectedType; + + public override bool RequiresOldValue => Tail.RequiresOldValue; + + public override bool ReturnsValue => Tail.ReturnsValue; + + private readonly MethodInfo getSpecified, setSpecified; + public MemberSpecifiedDecorator(MethodInfo getSpecified, MethodInfo setSpecified, IProtoSerializer tail) + : base(tail) + { + if (getSpecified == null && setSpecified == null) throw new InvalidOperationException(); + this.getSpecified = getSpecified; + this.setSpecified = setSpecified; + } + + public override void Write(object value, ProtoWriter dest) + { + if (getSpecified == null || (bool)getSpecified.Invoke(value, null)) + { + Tail.Write(value, dest); + } + } + + public override object Read(object value, ProtoReader source) + { + object result = Tail.Read(value, source); + if (setSpecified != null) setSpecified.Invoke(value, new object[] { true }); + return result; + } + +#if FEAT_COMPILER + protected override void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + if (getSpecified == null) + { + Tail.EmitWrite(ctx, valueFrom); + return; + } + using (Compiler.Local loc = ctx.GetLocalWithValue(ExpectedType, valueFrom)) + { + ctx.LoadAddress(loc, ExpectedType); + ctx.EmitCall(getSpecified); + Compiler.CodeLabel done = ctx.DefineLabel(); + ctx.BranchIfFalse(done, false); + Tail.EmitWrite(ctx, loc); + ctx.MarkLabel(done); + } + + } + protected override void EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + if (setSpecified == null) + { + Tail.EmitRead(ctx, valueFrom); + return; + } + using (Compiler.Local loc = ctx.GetLocalWithValue(ExpectedType, valueFrom)) + { + Tail.EmitRead(ctx, loc); + ctx.LoadAddress(loc, ExpectedType); + ctx.LoadValue(1); // true + ctx.EmitCall(setSpecified); + } + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/NetObjectSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/NetObjectSerializer.cs new file mode 100644 index 0000000..c3d685b --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/NetObjectSerializer.cs @@ -0,0 +1,64 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; +using ProtoBuf.Meta; + +namespace ProtoBuf.Serializers +{ + sealed class NetObjectSerializer : IProtoSerializer + { + private readonly int key; + private readonly Type type; + + private readonly BclHelpers.NetObjectOptions options; + + public NetObjectSerializer(TypeModel model, Type type, int key, BclHelpers.NetObjectOptions options) + { + bool dynamicType = (options & BclHelpers.NetObjectOptions.DynamicType) != 0; + this.key = dynamicType ? -1 : key; + this.type = dynamicType ? model.MapType(typeof(object)) : type; + this.options = options; + } + + public Type ExpectedType => type; + + public bool ReturnsValue => true; + + public bool RequiresOldValue => true; + + public object Read(object value, ProtoReader source) + { + return BclHelpers.ReadNetObject(value, source, key, type == typeof(object) ? null : type, options); + } + + public void Write(object value, ProtoWriter dest) + { + BclHelpers.WriteNetObject(value, dest, key, options); + } + +#if FEAT_COMPILER + public void EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.LoadValue(valueFrom); + ctx.CastToObject(type); + ctx.LoadReaderWriter(); + ctx.LoadValue(ctx.MapMetaKeyToCompiledKey(key)); + if (type == ctx.MapType(typeof(object))) ctx.LoadNullRef(); + else ctx.LoadValue(type); + ctx.LoadValue((int)options); + ctx.EmitCall(ctx.MapType(typeof(BclHelpers)).GetMethod("ReadNetObject")); + ctx.CastFromObject(type); + } + public void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.LoadValue(valueFrom); + ctx.CastToObject(type); + ctx.LoadReaderWriter(); + ctx.LoadValue(ctx.MapMetaKeyToCompiledKey(key)); + ctx.LoadValue((int)options); + ctx.EmitCall(ctx.MapType(typeof(BclHelpers)).GetMethod("WriteNetObject")); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/NullDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/NullDecorator.cs new file mode 100644 index 0000000..52db14c --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/NullDecorator.cs @@ -0,0 +1,167 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; + +using ProtoBuf.Meta; + +namespace ProtoBuf.Serializers +{ + sealed class NullDecorator : ProtoDecoratorBase + { + private readonly Type expectedType; + public const int Tag = 1; + public NullDecorator(TypeModel model, IProtoSerializer tail) : base(tail) + { + if (!tail.ReturnsValue) + throw new NotSupportedException("NullDecorator only supports implementations that return values"); + + Type tailType = tail.ExpectedType; + if (Helpers.IsValueType(tailType)) + { + expectedType = model.MapType(typeof(Nullable<>)).MakeGenericType(tailType); + } + else + { + expectedType = tailType; + } + } + + public override Type ExpectedType => expectedType; + + public override bool ReturnsValue => true; + + public override bool RequiresOldValue => true; + +#if FEAT_COMPILER + protected override void EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + using (Compiler.Local oldValue = ctx.GetLocalWithValue(expectedType, valueFrom)) + using (Compiler.Local token = new Compiler.Local(ctx, ctx.MapType(typeof(SubItemToken)))) + using (Compiler.Local field = new Compiler.Local(ctx, ctx.MapType(typeof(int)))) + { + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("StartSubItem")); + ctx.StoreValue(token); + + Compiler.CodeLabel next = ctx.DefineLabel(), processField = ctx.DefineLabel(), end = ctx.DefineLabel(); + + ctx.MarkLabel(next); + + ctx.EmitBasicRead("ReadFieldHeader", ctx.MapType(typeof(int))); + ctx.CopyValue(); + ctx.StoreValue(field); + ctx.LoadValue(Tag); // = 1 - process + ctx.BranchIfEqual(processField, true); + ctx.LoadValue(field); + ctx.LoadValue(1); // < 1 - exit + ctx.BranchIfLess(end, false); + + // default: skip + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("SkipField")); + ctx.Branch(next, true); + + // process + ctx.MarkLabel(processField); + if (Tail.RequiresOldValue) + { + if (Helpers.IsValueType(expectedType)) + { + ctx.LoadAddress(oldValue, expectedType); + ctx.EmitCall(expectedType.GetMethod("GetValueOrDefault", Helpers.EmptyTypes)); + } + else + { + ctx.LoadValue(oldValue); + } + } + Tail.EmitRead(ctx, null); + // note we demanded always returns a value + if (Helpers.IsValueType(expectedType)) + { + ctx.EmitCtor(expectedType, Tail.ExpectedType); // re-nullable it + } + ctx.StoreValue(oldValue); + ctx.Branch(next, false); + + // outro + ctx.MarkLabel(end); + + ctx.LoadValue(token); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("EndSubItem")); + ctx.LoadValue(oldValue); // load the old value + } + } + protected override void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + using (Compiler.Local valOrNull = ctx.GetLocalWithValue(expectedType, valueFrom)) + using (Compiler.Local token = new Compiler.Local(ctx, ctx.MapType(typeof(SubItemToken)))) + { + ctx.LoadNullRef(); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("StartSubItem")); + ctx.StoreValue(token); + + if (Helpers.IsValueType(expectedType)) + { + ctx.LoadAddress(valOrNull, expectedType); + ctx.LoadValue(expectedType.GetProperty("HasValue")); + } + else + { + ctx.LoadValue(valOrNull); + } + Compiler.CodeLabel @end = ctx.DefineLabel(); + ctx.BranchIfFalse(@end, false); + if (Helpers.IsValueType(expectedType)) + { + ctx.LoadAddress(valOrNull, expectedType); + ctx.EmitCall(expectedType.GetMethod("GetValueOrDefault", Helpers.EmptyTypes)); + } + else + { + ctx.LoadValue(valOrNull); + } + Tail.EmitWrite(ctx, null); + + ctx.MarkLabel(@end); + + ctx.LoadValue(token); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("EndSubItem")); + } + } +#endif + + public override object Read(object value, ProtoReader source) + { + SubItemToken tok = ProtoReader.StartSubItem(source); + int field; + while ((field = source.ReadFieldHeader()) > 0) + { + if (field == Tag) + { + value = Tail.Read(value, source); + } + else + { + source.SkipField(); + } + } + ProtoReader.EndSubItem(tok, source); + return value; + } + + public override void Write(object value, ProtoWriter dest) + { + SubItemToken token = ProtoWriter.StartSubItem(null, dest); + if (value != null) + { + Tail.Write(value, dest); + } + ProtoWriter.EndSubItem(token, dest); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ParseableSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ParseableSerializer.cs new file mode 100644 index 0000000..9a4bb07 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ParseableSerializer.cs @@ -0,0 +1,111 @@ +#if !NO_RUNTIME +using System; +using System.Net; +using ProtoBuf.Meta; +using System.Reflection; + +namespace ProtoBuf.Serializers +{ + sealed class ParseableSerializer : IProtoSerializer + { + private readonly MethodInfo parse; + public static ParseableSerializer TryCreate(Type type, TypeModel model) + { + if (type == null) throw new ArgumentNullException("type"); +#if PORTABLE || COREFX || PROFILE259 + MethodInfo method = null; + +#if COREFX || PROFILE259 + foreach (MethodInfo tmp in type.GetTypeInfo().GetDeclaredMethods("Parse")) +#else + foreach (MethodInfo tmp in type.GetMethods(BindingFlags.Public | BindingFlags.Static | BindingFlags.DeclaredOnly)) +#endif + { + ParameterInfo[] p; + if (tmp.Name == "Parse" && tmp.IsPublic && tmp.IsStatic && tmp.DeclaringType == type && (p = tmp.GetParameters()) != null && p.Length == 1 && p[0].ParameterType == typeof(string)) + { + method = tmp; + break; + } + } +#else + MethodInfo method = type.GetMethod("Parse", + BindingFlags.Public | BindingFlags.Static | BindingFlags.DeclaredOnly, + null, new Type[] { model.MapType(typeof(string)) }, null); +#endif + if (method != null && method.ReturnType == type) + { + if (Helpers.IsValueType(type)) + { + MethodInfo toString = GetCustomToString(type); + if (toString == null || toString.ReturnType != model.MapType(typeof(string))) return null; // need custom ToString, fools + } + return new ParseableSerializer(method); + } + return null; + } + private static MethodInfo GetCustomToString(Type type) + { +#if PORTABLE || COREFX || PROFILE259 + MethodInfo method = Helpers.GetInstanceMethod(type, "ToString", Helpers.EmptyTypes); + if (method == null || !method.IsPublic || method.IsStatic || method.DeclaringType != type) return null; + return method; +#else + + return type.GetMethod("ToString", BindingFlags.Public | BindingFlags.Instance | BindingFlags.DeclaredOnly, + null, Helpers.EmptyTypes, null); +#endif + } + + private ParseableSerializer(MethodInfo parse) + { + this.parse = parse; + } + + public Type ExpectedType => parse.DeclaringType; + + bool IProtoSerializer.RequiresOldValue { get { return false; } } + bool IProtoSerializer.ReturnsValue { get { return true; } } + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return parse.Invoke(null, new object[] { source.ReadString() }); + } + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteString(value.ToString(), dest); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + Type type = ExpectedType; + if (Helpers.IsValueType(type)) + { // note that for structs, we've already asserted that a custom ToString + // exists; no need to handle the box/callvirt scenario + + // force it to a variable if needed, so we can take the address + using (Compiler.Local loc = ctx.GetLocalWithValue(type, valueFrom)) + { + ctx.LoadAddress(loc, type); + ctx.EmitCall(GetCustomToString(type)); + } + } + else + { + ctx.EmitCall(ctx.MapType(typeof(object)).GetMethod("ToString")); + } + ctx.EmitBasicWrite("WriteString", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadString", ctx.MapType(typeof(string))); + ctx.EmitCall(parse); + } +#endif + + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/PropertyDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/PropertyDecorator.cs new file mode 100644 index 0000000..8b0a014 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/PropertyDecorator.cs @@ -0,0 +1,167 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; + +using ProtoBuf.Meta; + +namespace ProtoBuf.Serializers +{ + sealed class PropertyDecorator : ProtoDecoratorBase + { + public override Type ExpectedType => forType; + private readonly PropertyInfo property; + private readonly Type forType; + public override bool RequiresOldValue => true; + public override bool ReturnsValue => false; + private readonly bool readOptionsWriteValue; + private readonly MethodInfo shadowSetter; + + public PropertyDecorator(TypeModel model, Type forType, PropertyInfo property, IProtoSerializer tail) : base(tail) + { + Helpers.DebugAssert(forType != null); + Helpers.DebugAssert(property != null); + this.forType = forType; + this.property = property; + SanityCheck(model, property, tail, out readOptionsWriteValue, true, true); + shadowSetter = GetShadowSetter(model, property); + } + + private static void SanityCheck(TypeModel model, PropertyInfo property, IProtoSerializer tail, out bool writeValue, bool nonPublic, bool allowInternal) + { + if (property == null) throw new ArgumentNullException("property"); + + writeValue = tail.ReturnsValue && (GetShadowSetter(model, property) != null || (property.CanWrite && Helpers.GetSetMethod(property, nonPublic, allowInternal) != null)); + if (!property.CanRead || Helpers.GetGetMethod(property, nonPublic, allowInternal) == null) + { + throw new InvalidOperationException("Cannot serialize property without a get accessor"); + } + if (!writeValue && (!tail.RequiresOldValue || Helpers.IsValueType(tail.ExpectedType))) + { // so we can't save the value, and the tail doesn't use it either... not helpful + // or: can't write the value, so the struct value will be lost + throw new InvalidOperationException("Cannot apply changes to property " + property.DeclaringType.FullName + "." + property.Name); + } + } + static MethodInfo GetShadowSetter(TypeModel model, PropertyInfo property) + { +#if COREFX + MethodInfo method = Helpers.GetInstanceMethod(property.DeclaringType.GetTypeInfo(), "Set" + property.Name, new Type[] { property.PropertyType }); +#else + +#if PROFILE259 + Type reflectedType = property.DeclaringType; +#else + Type reflectedType = property.ReflectedType; +#endif + MethodInfo method = Helpers.GetInstanceMethod(reflectedType, "Set" + property.Name, new Type[] { property.PropertyType }); +#endif + if (method == null || !method.IsPublic || method.ReturnType != model.MapType(typeof(void))) return null; + return method; + } + + public override void Write(object value, ProtoWriter dest) + { + Helpers.DebugAssert(value != null); + value = property.GetValue(value, null); + if (value != null) Tail.Write(value, dest); + } + + public override object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value != null); + + object oldVal = Tail.RequiresOldValue ? property.GetValue(value, null) : null; + object newVal = Tail.Read(oldVal, source); + if (readOptionsWriteValue && newVal != null) // if the tail returns a null, intepret that as *no assign* + { + if (shadowSetter == null) + { + property.SetValue(value, newVal, null); + } + else + { + shadowSetter.Invoke(value, new object[] { newVal }); + } + } + return null; + } + +#if FEAT_COMPILER + protected override void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.LoadAddress(valueFrom, ExpectedType); + ctx.LoadValue(property); + ctx.WriteNullCheckedTail(property.PropertyType, Tail, null); + } + + protected override void EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + SanityCheck(ctx.Model, property, Tail, out bool writeValue, ctx.NonPublic, ctx.AllowInternal(property)); + if (Helpers.IsValueType(ExpectedType) && valueFrom == null) + { + throw new InvalidOperationException("Attempt to mutate struct on the head of the stack; changes would be lost"); + } + + using (Compiler.Local loc = ctx.GetLocalWithValue(ExpectedType, valueFrom)) + { + if (Tail.RequiresOldValue) + { + ctx.LoadAddress(loc, ExpectedType); // stack is: old-addr + ctx.LoadValue(property); // stack is: old-value + } + Type propertyType = property.PropertyType; + ctx.ReadNullCheckedTail(propertyType, Tail, null); // stack is [new-value] + + if (writeValue) + { + using (Compiler.Local newVal = new Compiler.Local(ctx, property.PropertyType)) + { + ctx.StoreValue(newVal); // stack is empty + + Compiler.CodeLabel allDone = new Compiler.CodeLabel(); // <=== default structs + if (!Helpers.IsValueType(propertyType)) + { // if the tail returns a null, intepret that as *no assign* + allDone = ctx.DefineLabel(); + ctx.LoadValue(newVal); // stack is: new-value + ctx.BranchIfFalse(@allDone, true); // stack is empty + } + // assign the value + ctx.LoadAddress(loc, ExpectedType); // parent-addr + ctx.LoadValue(newVal); // parent-obj|new-value + if (shadowSetter == null) + { + ctx.StoreValue(property); // empty + } + else + { + ctx.EmitCall(shadowSetter); // empty + } + if (!Helpers.IsValueType(propertyType)) + { + ctx.MarkLabel(allDone); + } + } + + } + else + { // don't want return value; drop it if anything there + // stack is [new-value] + if (Tail.ReturnsValue) { ctx.DiscardValue(); } + } + } + } +#endif + + internal static bool CanWrite(TypeModel model, MemberInfo member) + { + if (member == null) throw new ArgumentNullException(nameof(member)); + + if (member is PropertyInfo prop) + { + return prop.CanWrite || GetShadowSetter(model, prop) != null; + } + + return member is FieldInfo; // fields are always writeable; anything else: JUST SAY NO! + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ProtoDecoratorBase.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ProtoDecoratorBase.cs new file mode 100644 index 0000000..e7f2b34 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ProtoDecoratorBase.cs @@ -0,0 +1,24 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + abstract class ProtoDecoratorBase : IProtoSerializer + { + public abstract Type ExpectedType { get; } + protected readonly IProtoSerializer Tail; + protected ProtoDecoratorBase(IProtoSerializer tail) { this.Tail = tail; } + public abstract bool ReturnsValue { get; } + public abstract bool RequiresOldValue { get; } + public abstract void Write(object value, ProtoWriter dest); + public abstract object Read(object value, ProtoReader source); + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) { EmitWrite(ctx, valueFrom); } + protected abstract void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom); + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) { EmitRead(ctx, valueFrom); } + protected abstract void EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom); +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ReflectedUriDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ReflectedUriDecorator.cs new file mode 100644 index 0000000..44edef0 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/ReflectedUriDecorator.cs @@ -0,0 +1,90 @@ +#if !NO_RUNTIME +#if PORTABLE +using System; +using System.Collections; +using System.Collections.Generic; +using System.Linq; +using System.Reflection; + +namespace ProtoBuf.Serializers +{ + /// + /// Manipulates with uris via reflection rather than strongly typed objects. + /// This is because in PCLs, the Uri type may not match (WinRT uses Internal/Uri, .Net uses System/Uri) + /// + sealed class ReflectedUriDecorator : ProtoDecoratorBase + { + private readonly Type expectedType; + + private readonly PropertyInfo absoluteUriProperty; + + private readonly ConstructorInfo typeConstructor; + + public ReflectedUriDecorator(Type type, ProtoBuf.Meta.TypeModel model, IProtoSerializer tail) : base(tail) + { + expectedType = type; + +#if PROFILE259 + absoluteUriProperty = expectedType.GetRuntimeProperty("AbsoluteUri"); + IEnumerable constructors = expectedType.GetTypeInfo().DeclaredConstructors; + typeConstructor = null; + foreach(ConstructorInfo constructor in constructors) + { + ParameterInfo[] parameters = constructor.GetParameters(); + ParameterInfo parameterFirst = parameters.FirstOrDefault(); + Type stringType = typeof(string); + if (parameterFirst != null && + parameterFirst.ParameterType == stringType) + { + typeConstructor = constructor; + break; + } + } +#else + absoluteUriProperty = expectedType.GetProperty("AbsoluteUri"); + typeConstructor = expectedType.GetConstructor(new Type[] { typeof(string) }); +#endif + } + public override Type ExpectedType { get { return expectedType; } } + public override bool RequiresOldValue { get { return false; } } + public override bool ReturnsValue { get { return true; } } + + public override void Write(object value, ProtoWriter dest) + { + Tail.Write(absoluteUriProperty.GetValue(value, null), dest); + } + public override object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // not expecting incoming + string s = (string)Tail.Read(null, source); + + return s.Length == 0 ? null : typeConstructor.Invoke(new object[] { s }); + } + +#if FEAT_COMPILER + protected override void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.LoadValue(valueFrom); + ctx.LoadValue(absoluteUriProperty); + Tail.EmitWrite(ctx, null); + } + protected override void EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + Tail.EmitRead(ctx, valueFrom); + ctx.CopyValue(); + Compiler.CodeLabel @nonEmpty = ctx.DefineLabel(), @end = ctx.DefineLabel(); + ctx.LoadValue(typeof(string).GetProperty("Length")); + ctx.BranchIfTrue(@nonEmpty, true); + ctx.DiscardValue(); + ctx.LoadNullRef(); + ctx.Branch(@end, true); + ctx.MarkLabel(@nonEmpty); + ctx.EmitCtor(expectedType, ctx.MapType(typeof(string))); + ctx.MarkLabel(@end); + + } +#endif + } +} +#endif +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SByteSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SByteSerializer.cs new file mode 100644 index 0000000..81d233e --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SByteSerializer.cs @@ -0,0 +1,45 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class SByteSerializer : IProtoSerializer + { + static readonly Type expectedType = typeof(sbyte); + + public SByteSerializer(ProtoBuf.Meta.TypeModel model) + { + + } + + public Type ExpectedType => expectedType; + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadSByte(); + } + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteSByte((sbyte)value, dest); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteSByte", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadSByte", ExpectedType); + } +#endif + + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SingleSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SingleSerializer.cs new file mode 100644 index 0000000..c5ade13 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SingleSerializer.cs @@ -0,0 +1,45 @@ +#if !NO_RUNTIME +using System; +using ProtoBuf.Meta; + +namespace ProtoBuf.Serializers +{ + sealed class SingleSerializer : IProtoSerializer + { + static readonly Type expectedType = typeof(float); + + public Type ExpectedType { get { return expectedType; } } + + public SingleSerializer(TypeModel model) + { + } + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadSingle(); + } + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteSingle((float)value, dest); + } + + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteSingle", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadSingle", ExpectedType); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/StringSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/StringSerializer.cs new file mode 100644 index 0000000..399b4bb --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/StringSerializer.cs @@ -0,0 +1,41 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class StringSerializer : IProtoSerializer + { + static readonly Type expectedType = typeof(string); + + public StringSerializer(ProtoBuf.Meta.TypeModel model) + { + } + + public Type ExpectedType => expectedType; + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteString((string)value, dest); + } + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadString(); + } +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteString", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadString", ExpectedType); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SubItemSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SubItemSerializer.cs new file mode 100644 index 0000000..58015aa --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SubItemSerializer.cs @@ -0,0 +1,138 @@ +#if !NO_RUNTIME +using System; +using ProtoBuf.Meta; + +#if FEAT_COMPILER +using System.Reflection.Emit; +#endif + +namespace ProtoBuf.Serializers +{ + sealed class SubItemSerializer : IProtoTypeSerializer + { + bool IProtoTypeSerializer.HasCallbacks(TypeModel.CallbackType callbackType) + { + return ((IProtoTypeSerializer)proxy.Serializer).HasCallbacks(callbackType); + } + + bool IProtoTypeSerializer.CanCreateInstance() + { + return ((IProtoTypeSerializer)proxy.Serializer).CanCreateInstance(); + } + +#if FEAT_COMPILER + void IProtoTypeSerializer.EmitCallback(Compiler.CompilerContext ctx, Compiler.Local valueFrom, TypeModel.CallbackType callbackType) + { + ((IProtoTypeSerializer)proxy.Serializer).EmitCallback(ctx, valueFrom, callbackType); + } + + void IProtoTypeSerializer.EmitCreateInstance(Compiler.CompilerContext ctx) + { + ((IProtoTypeSerializer)proxy.Serializer).EmitCreateInstance(ctx); + } +#endif + + void IProtoTypeSerializer.Callback(object value, TypeModel.CallbackType callbackType, SerializationContext context) + { + ((IProtoTypeSerializer)proxy.Serializer).Callback(value, callbackType, context); + } + + object IProtoTypeSerializer.CreateInstance(ProtoReader source) + { + return ((IProtoTypeSerializer)proxy.Serializer).CreateInstance(source); + } + + private readonly int key; + private readonly Type type; + private readonly ISerializerProxy proxy; + private readonly bool recursionCheck; + public SubItemSerializer(Type type, int key, ISerializerProxy proxy, bool recursionCheck) + { + this.type = type ?? throw new ArgumentNullException(nameof(type)); + this.proxy = proxy ?? throw new ArgumentNullException(nameof(proxy)); + this.key = key; + this.recursionCheck = recursionCheck; + } + + Type IProtoSerializer.ExpectedType => type; + + bool IProtoSerializer.RequiresOldValue => true; + + bool IProtoSerializer.ReturnsValue => true; + + void IProtoSerializer.Write(object value, ProtoWriter dest) + { + if (recursionCheck) + { + ProtoWriter.WriteObject(value, key, dest); + } + else + { + ProtoWriter.WriteRecursionSafeObject(value, key, dest); + } + } + + object IProtoSerializer.Read(object value, ProtoReader source) + { + return ProtoReader.ReadObject(value, key, source); + } + +#if FEAT_COMPILER + bool EmitDedicatedMethod(Compiler.CompilerContext ctx, Compiler.Local valueFrom, bool read) + { + MethodBuilder method = ctx.GetDedicatedMethod(key, read); + if (method == null) return false; + + using (Compiler.Local token = new ProtoBuf.Compiler.Local(ctx, ctx.MapType(typeof(SubItemToken)))) + { + Type rwType = ctx.MapType(read ? typeof(ProtoReader) : typeof(ProtoWriter)); + ctx.LoadValue(valueFrom); + if (!read) // write requires the object for StartSubItem; read doesn't + { // (if recursion-check is disabled [subtypes] then null is fine too) + if (Helpers.IsValueType(type) || !recursionCheck) { ctx.LoadNullRef(); } + else { ctx.CopyValue(); } + } + ctx.LoadReaderWriter(); + ctx.EmitCall(Helpers.GetStaticMethod(rwType, "StartSubItem", + read ? new Type[] { rwType } : new Type[] { ctx.MapType(typeof(object)), rwType })); + ctx.StoreValue(token); + + // note: value already on the stack + ctx.LoadReaderWriter(); + ctx.EmitCall(method); + // handle inheritance (we will be calling the *base* version of things, + // but we expect Read to return the "type" type) + if (read && type != method.ReturnType) ctx.Cast(this.type); + ctx.LoadValue(token); + ctx.LoadReaderWriter(); + ctx.EmitCall(Helpers.GetStaticMethod(rwType, "EndSubItem", new Type[] { ctx.MapType(typeof(SubItemToken)), rwType })); + } + return true; + } + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + if (!EmitDedicatedMethod(ctx, valueFrom, false)) + { + ctx.LoadValue(valueFrom); + if (Helpers.IsValueType(type)) ctx.CastToObject(type); + ctx.LoadValue(ctx.MapMetaKeyToCompiledKey(key)); // re-map for formality, but would expect identical, else dedicated method + ctx.LoadReaderWriter(); + ctx.EmitCall(Helpers.GetStaticMethod(ctx.MapType(typeof(ProtoWriter)), recursionCheck ? "WriteObject" : "WriteRecursionSafeObject", new Type[] { ctx.MapType(typeof(object)), ctx.MapType(typeof(int)), ctx.MapType(typeof(ProtoWriter)) })); + } + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + if (!EmitDedicatedMethod(ctx, valueFrom, true)) + { + ctx.LoadValue(valueFrom); + if (Helpers.IsValueType(type)) ctx.CastToObject(type); + ctx.LoadValue(ctx.MapMetaKeyToCompiledKey(key)); // re-map for formality, but would expect identical, else dedicated method + ctx.LoadReaderWriter(); + ctx.EmitCall(Helpers.GetStaticMethod(ctx.MapType(typeof(ProtoReader)), "ReadObject")); + ctx.CastFromObject(type); + } + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SurrogateSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SurrogateSerializer.cs new file mode 100644 index 0000000..86275eb --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SurrogateSerializer.cs @@ -0,0 +1,157 @@ +#if !NO_RUNTIME +using System; +using ProtoBuf.Meta; +using System.Reflection; + +namespace ProtoBuf.Serializers +{ + sealed class SurrogateSerializer : IProtoTypeSerializer + { + bool IProtoTypeSerializer.HasCallbacks(ProtoBuf.Meta.TypeModel.CallbackType callbackType) { return false; } +#if FEAT_COMPILER + void IProtoTypeSerializer.EmitCallback(Compiler.CompilerContext ctx, Compiler.Local valueFrom, ProtoBuf.Meta.TypeModel.CallbackType callbackType) { } + void IProtoTypeSerializer.EmitCreateInstance(Compiler.CompilerContext ctx) { throw new NotSupportedException(); } +#endif + bool IProtoTypeSerializer.CanCreateInstance() => false; + + object IProtoTypeSerializer.CreateInstance(ProtoReader source) => throw new NotSupportedException(); + + void IProtoTypeSerializer.Callback(object value, ProtoBuf.Meta.TypeModel.CallbackType callbackType, SerializationContext context) { } + + public bool ReturnsValue => false; + + public bool RequiresOldValue => true; + + public Type ExpectedType => forType; + + private readonly Type forType, declaredType; + private readonly MethodInfo toTail, fromTail; + IProtoTypeSerializer rootTail; + + public SurrogateSerializer(TypeModel model, Type forType, Type declaredType, IProtoTypeSerializer rootTail) + { + Helpers.DebugAssert(forType != null, "forType"); + Helpers.DebugAssert(declaredType != null, "declaredType"); + Helpers.DebugAssert(rootTail != null, "rootTail"); + Helpers.DebugAssert(rootTail.RequiresOldValue, "RequiresOldValue"); + Helpers.DebugAssert(!rootTail.ReturnsValue, "ReturnsValue"); + Helpers.DebugAssert(declaredType == rootTail.ExpectedType || Helpers.IsSubclassOf(declaredType, rootTail.ExpectedType)); + this.forType = forType; + this.declaredType = declaredType; + this.rootTail = rootTail; + toTail = GetConversion(model, true); + fromTail = GetConversion(model, false); + } + private static bool HasCast(TypeModel model, Type type, Type from, Type to, out MethodInfo op) + { +#if PROFILE259 + System.Collections.Generic.List list = new System.Collections.Generic.List(); + foreach (var item in type.GetRuntimeMethods()) + { + if (item.IsStatic) list.Add(item); + } + MethodInfo[] found = list.ToArray(); +#else + const BindingFlags flags = BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic; + MethodInfo[] found = type.GetMethods(flags); +#endif + ParameterInfo[] paramTypes; + Type convertAttributeType = null; + for (int i = 0; i < found.Length; i++) + { + MethodInfo m = found[i]; + if (m.ReturnType != to) continue; + paramTypes = m.GetParameters(); + if (paramTypes.Length == 1 && paramTypes[0].ParameterType == from) + { + if (convertAttributeType == null) + { + convertAttributeType = model.MapType(typeof(ProtoConverterAttribute), false); + if (convertAttributeType == null) + { // attribute isn't defined in the source assembly: stop looking + break; + } + } + if (m.IsDefined(convertAttributeType, true)) + { + op = m; + return true; + } + } + } + + for (int i = 0; i < found.Length; i++) + { + MethodInfo m = found[i]; + if ((m.Name != "op_Implicit" && m.Name != "op_Explicit") || m.ReturnType != to) + { + continue; + } + paramTypes = m.GetParameters(); + if (paramTypes.Length == 1 && paramTypes[0].ParameterType == from) + { + op = m; + return true; + } + } + op = null; + return false; + } + + public MethodInfo GetConversion(TypeModel model, bool toTail) + { + Type to = toTail ? declaredType : forType; + Type from = toTail ? forType : declaredType; + MethodInfo op; + if (HasCast(model, declaredType, from, to, out op) || HasCast(model, forType, from, to, out op)) + { + return op; + } + throw new InvalidOperationException("No suitable conversion operator found for surrogate: " + + forType.FullName + " / " + declaredType.FullName); + } + + public void Write(object value, ProtoWriter writer) + { + rootTail.Write(toTail.Invoke(null, new object[] { value }), writer); + } + + public object Read(object value, ProtoReader source) + { + // convert the incoming value + object[] args = { value }; + value = toTail.Invoke(null, args); + + // invoke the tail and convert the outgoing value + args[0] = rootTail.Read(value, source); + return fromTail.Invoke(null, args); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + Helpers.DebugAssert(valueFrom != null); // don't support stack-head for this + using (Compiler.Local converted = new Compiler.Local(ctx, declaredType)) // declare/re-use local + { + ctx.LoadValue(valueFrom); // load primary onto stack + ctx.EmitCall(toTail); // static convert op, primary-to-surrogate + ctx.StoreValue(converted); // store into surrogate local + + rootTail.EmitRead(ctx, converted); // downstream processing against surrogate local + + ctx.LoadValue(converted); // load from surrogate local + ctx.EmitCall(fromTail); // static convert op, surrogate-to-primary + ctx.StoreValue(valueFrom); // store back into primary + } + } + + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.LoadValue(valueFrom); + ctx.EmitCall(toTail); + rootTail.EmitWrite(ctx, null); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SystemTypeSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SystemTypeSerializer.cs new file mode 100644 index 0000000..4b1656d --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/SystemTypeSerializer.cs @@ -0,0 +1,46 @@ +using System; + +#if !NO_RUNTIME + +namespace ProtoBuf.Serializers +{ + sealed class SystemTypeSerializer : IProtoSerializer + { + static readonly Type expectedType = typeof(Type); + + public SystemTypeSerializer(ProtoBuf.Meta.TypeModel model) + { + + } + + public Type ExpectedType => expectedType; + + void IProtoSerializer.Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteType((Type)value, dest); + } + + object IProtoSerializer.Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadType(); + } + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteType", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadType", ExpectedType); + } +#endif + } +} + +#endif diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TagDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TagDecorator.cs new file mode 100644 index 0000000..509b8a0 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TagDecorator.cs @@ -0,0 +1,108 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; + +using ProtoBuf.Meta; + +namespace ProtoBuf.Serializers +{ + sealed class TagDecorator : ProtoDecoratorBase, IProtoTypeSerializer + { + public bool HasCallbacks(TypeModel.CallbackType callbackType) + { + IProtoTypeSerializer pts = Tail as IProtoTypeSerializer; + return pts != null && pts.HasCallbacks(callbackType); + } + + public bool CanCreateInstance() + { + IProtoTypeSerializer pts = Tail as IProtoTypeSerializer; + return pts != null && pts.CanCreateInstance(); + } + + public object CreateInstance(ProtoReader source) + { + return ((IProtoTypeSerializer)Tail).CreateInstance(source); + } + + public void Callback(object value, TypeModel.CallbackType callbackType, SerializationContext context) + { + if (Tail is IProtoTypeSerializer pts) + { + pts.Callback(value, callbackType, context); + } + } + +#if FEAT_COMPILER + public void EmitCallback(Compiler.CompilerContext ctx, Compiler.Local valueFrom, TypeModel.CallbackType callbackType) + { + // we only expect this to be invoked if HasCallbacks returned true, so implicitly Tail + // **must** be of the correct type + ((IProtoTypeSerializer)Tail).EmitCallback(ctx, valueFrom, callbackType); + } + + public void EmitCreateInstance(Compiler.CompilerContext ctx) + { + ((IProtoTypeSerializer)Tail).EmitCreateInstance(ctx); + } +#endif + public override Type ExpectedType => Tail.ExpectedType; + + public TagDecorator(int fieldNumber, WireType wireType, bool strict, IProtoSerializer tail) + : base(tail) + { + this.fieldNumber = fieldNumber; + this.wireType = wireType; + this.strict = strict; + } + + public override bool RequiresOldValue => Tail.RequiresOldValue; + + public override bool ReturnsValue => Tail.ReturnsValue; + + private readonly bool strict; + private readonly int fieldNumber; + private readonly WireType wireType; + + private bool NeedsHint => ((int)wireType & ~7) != 0; + + public override object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(fieldNumber == source.FieldNumber); + if (strict) { source.Assert(wireType); } + else if (NeedsHint) { source.Hint(wireType); } + return Tail.Read(value, source); + } + + public override void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteFieldHeader(fieldNumber, wireType, dest); + Tail.Write(value, dest); + } + + +#if FEAT_COMPILER + protected override void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.LoadValue((int)fieldNumber); + ctx.LoadValue((int)wireType); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("WriteFieldHeader")); + Tail.EmitWrite(ctx, valueFrom); + } + + protected override void EmitRead(ProtoBuf.Compiler.CompilerContext ctx, ProtoBuf.Compiler.Local valueFrom) + { + if (strict || NeedsHint) + { + ctx.LoadReaderWriter(); + ctx.LoadValue((int)wireType); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod(strict ? "Assert" : "Hint")); + } + Tail.EmitRead(ctx, valueFrom); + } +#endif + } + +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TimeSpanSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TimeSpanSerializer.cs new file mode 100644 index 0000000..4c8b828 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TimeSpanSerializer.cs @@ -0,0 +1,63 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class TimeSpanSerializer : IProtoSerializer + { + static readonly Type expectedType = typeof(TimeSpan); + private readonly bool wellKnown; + public TimeSpanSerializer(DataFormat dataFormat, ProtoBuf.Meta.TypeModel model) + { + + wellKnown = dataFormat == DataFormat.WellKnown; + } + public Type ExpectedType => expectedType; + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public object Read(object value, ProtoReader source) + { + if (wellKnown) + { + return BclHelpers.ReadDuration(source); + } + else + { + Helpers.DebugAssert(value == null); // since replaces + return BclHelpers.ReadTimeSpan(source); + } + } + + public void Write(object value, ProtoWriter dest) + { + if (wellKnown) + { + BclHelpers.WriteDuration((TimeSpan)value, dest); + } + else + { + BclHelpers.WriteTimeSpan((TimeSpan)value, dest); + } + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitWrite(ctx.MapType(typeof(BclHelpers)), + wellKnown ? nameof(BclHelpers.WriteDuration) : nameof(BclHelpers.WriteTimeSpan), valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + if (wellKnown) ctx.LoadValue(valueFrom); + ctx.EmitBasicRead(ctx.MapType(typeof(BclHelpers)), + wellKnown ? nameof(BclHelpers.ReadDuration) : nameof(BclHelpers.ReadTimeSpan), + ExpectedType); + } +#endif + + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TupleSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TupleSerializer.cs new file mode 100644 index 0000000..b6f9c69 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TupleSerializer.cs @@ -0,0 +1,339 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; +using ProtoBuf.Meta; + +namespace ProtoBuf.Serializers +{ + sealed class TupleSerializer : IProtoTypeSerializer + { + private readonly MemberInfo[] members; + private readonly ConstructorInfo ctor; + private IProtoSerializer[] tails; + public TupleSerializer(RuntimeTypeModel model, ConstructorInfo ctor, MemberInfo[] members) + { + this.ctor = ctor ?? throw new ArgumentNullException(nameof(ctor)); + this.members = members ?? throw new ArgumentNullException(nameof(members)); + this.tails = new IProtoSerializer[members.Length]; + + ParameterInfo[] parameters = ctor.GetParameters(); + for (int i = 0; i < members.Length; i++) + { + WireType wireType; + Type finalType = parameters[i].ParameterType; + + Type itemType = null, defaultType = null; + + MetaType.ResolveListTypes(model, finalType, ref itemType, ref defaultType); + Type tmp = itemType == null ? finalType : itemType; + + bool asReference = false; + int typeIndex = model.FindOrAddAuto(tmp, false, true, false); + if (typeIndex >= 0) + { + asReference = model[tmp].AsReferenceDefault; + } + IProtoSerializer tail = ValueMember.TryGetCoreSerializer(model, DataFormat.Default, tmp, out wireType, asReference, false, false, true), serializer; + if (tail == null) + { + throw new InvalidOperationException("No serializer defined for type: " + tmp.FullName); + } + + tail = new TagDecorator(i + 1, wireType, false, tail); + if (itemType == null) + { + serializer = tail; + } + else + { + if (finalType.IsArray) + { + serializer = new ArrayDecorator(model, tail, i + 1, false, wireType, finalType, false, false); + } + else + { + serializer = ListDecorator.Create(model, finalType, defaultType, tail, i + 1, false, wireType, true, false, false); + } + } + tails[i] = serializer; + } + } + public bool HasCallbacks(Meta.TypeModel.CallbackType callbackType) + { + return false; + } + +#if FEAT_COMPILER + public void EmitCallback(Compiler.CompilerContext ctx, Compiler.Local valueFrom, Meta.TypeModel.CallbackType callbackType) { } +#endif + public Type ExpectedType => ctor.DeclaringType; + + void IProtoTypeSerializer.Callback(object value, Meta.TypeModel.CallbackType callbackType, SerializationContext context) { } + object IProtoTypeSerializer.CreateInstance(ProtoReader source) { throw new NotSupportedException(); } + private object GetValue(object obj, int index) + { + PropertyInfo prop; + FieldInfo field; + + if ((prop = members[index] as PropertyInfo) != null) + { + if (obj == null) + return Helpers.IsValueType(prop.PropertyType) ? Activator.CreateInstance(prop.PropertyType) : null; + return prop.GetValue(obj, null); + } + else if ((field = members[index] as FieldInfo) != null) + { + if (obj == null) + return Helpers.IsValueType(field.FieldType) ? Activator.CreateInstance(field.FieldType) : null; + return field.GetValue(obj); + } + else + { + throw new InvalidOperationException(); + } + } + + public object Read(object value, ProtoReader source) + { + object[] values = new object[members.Length]; + bool invokeCtor = false; + if (value == null) + { + invokeCtor = true; + } + for (int i = 0; i < values.Length; i++) + values[i] = GetValue(value, i); + int field; + while ((field = source.ReadFieldHeader()) > 0) + { + invokeCtor = true; + if (field <= tails.Length) + { + IProtoSerializer tail = tails[field - 1]; + values[field - 1] = tails[field - 1].Read(tail.RequiresOldValue ? values[field - 1] : null, source); + } + else + { + source.SkipField(); + } + } + return invokeCtor ? ctor.Invoke(values) : value; + } + + public void Write(object value, ProtoWriter dest) + { + for (int i = 0; i < tails.Length; i++) + { + object val = GetValue(value, i); + if (val != null) tails[i].Write(val, dest); + } + } + + public bool RequiresOldValue => true; + + public bool ReturnsValue => false; + + Type GetMemberType(int index) + { + Type result = Helpers.GetMemberType(members[index]); + if (result == null) throw new InvalidOperationException(); + return result; + } + + bool IProtoTypeSerializer.CanCreateInstance() { return false; } + +#if FEAT_COMPILER + public void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + using (Compiler.Local loc = ctx.GetLocalWithValue(ctor.DeclaringType, valueFrom)) + { + for (int i = 0; i < tails.Length; i++) + { + Type type = GetMemberType(i); + ctx.LoadAddress(loc, ExpectedType); + if (members[i] is FieldInfo) + { + ctx.LoadValue((FieldInfo)members[i]); + } + else if (members[i] is PropertyInfo) + { + ctx.LoadValue((PropertyInfo)members[i]); + } + ctx.WriteNullCheckedTail(type, tails[i], null); + } + } + } + + void IProtoTypeSerializer.EmitCreateInstance(Compiler.CompilerContext ctx) { throw new NotSupportedException(); } + + public void EmitRead(Compiler.CompilerContext ctx, Compiler.Local incoming) + { + using (Compiler.Local objValue = ctx.GetLocalWithValue(ExpectedType, incoming)) + { + Compiler.Local[] locals = new Compiler.Local[members.Length]; + try + { + for (int i = 0; i < locals.Length; i++) + { + Type type = GetMemberType(i); + bool store = true; + locals[i] = new Compiler.Local(ctx, type); + if (!Helpers.IsValueType(ExpectedType)) + { + // value-types always read the old value + if (Helpers.IsValueType(type)) + { + switch (Helpers.GetTypeCode(type)) + { + case ProtoTypeCode.Boolean: + case ProtoTypeCode.Byte: + case ProtoTypeCode.Int16: + case ProtoTypeCode.Int32: + case ProtoTypeCode.SByte: + case ProtoTypeCode.UInt16: + case ProtoTypeCode.UInt32: + ctx.LoadValue(0); + break; + case ProtoTypeCode.Int64: + case ProtoTypeCode.UInt64: + ctx.LoadValue(0L); + break; + case ProtoTypeCode.Single: + ctx.LoadValue(0.0F); + break; + case ProtoTypeCode.Double: + ctx.LoadValue(0.0D); + break; + case ProtoTypeCode.Decimal: + ctx.LoadValue(0M); + break; + case ProtoTypeCode.Guid: + ctx.LoadValue(Guid.Empty); + break; + default: + ctx.LoadAddress(locals[i], type); + ctx.EmitCtor(type); + store = false; + break; + } + } + else + { + ctx.LoadNullRef(); + } + if (store) + { + ctx.StoreValue(locals[i]); + } + } + } + + Compiler.CodeLabel skipOld = Helpers.IsValueType(ExpectedType) + ? new Compiler.CodeLabel() + : ctx.DefineLabel(); + if (!Helpers.IsValueType(ExpectedType)) + { + ctx.LoadAddress(objValue, ExpectedType); + ctx.BranchIfFalse(skipOld, false); + } + for (int i = 0; i < members.Length; i++) + { + ctx.LoadAddress(objValue, ExpectedType); + if (members[i] is FieldInfo) + { + ctx.LoadValue((FieldInfo)members[i]); + } + else if (members[i] is PropertyInfo) + { + ctx.LoadValue((PropertyInfo)members[i]); + } + ctx.StoreValue(locals[i]); + } + + if (!Helpers.IsValueType(ExpectedType)) ctx.MarkLabel(skipOld); + + using (Compiler.Local fieldNumber = new Compiler.Local(ctx, ctx.MapType(typeof(int)))) + { + Compiler.CodeLabel @continue = ctx.DefineLabel(), + processField = ctx.DefineLabel(), + notRecognised = ctx.DefineLabel(); + ctx.Branch(@continue, false); + + Compiler.CodeLabel[] handlers = new Compiler.CodeLabel[members.Length]; + for (int i = 0; i < members.Length; i++) + { + handlers[i] = ctx.DefineLabel(); + } + + ctx.MarkLabel(processField); + + ctx.LoadValue(fieldNumber); + ctx.LoadValue(1); + ctx.Subtract(); // jump-table is zero-based + ctx.Switch(handlers); + + // and the default: + ctx.Branch(notRecognised, false); + for (int i = 0; i < handlers.Length; i++) + { + ctx.MarkLabel(handlers[i]); + IProtoSerializer tail = tails[i]; + Compiler.Local oldValIfNeeded = tail.RequiresOldValue ? locals[i] : null; + ctx.ReadNullCheckedTail(locals[i].Type, tail, oldValIfNeeded); + if (tail.ReturnsValue) + { + if (Helpers.IsValueType(locals[i].Type)) + { + ctx.StoreValue(locals[i]); + } + else + { + Compiler.CodeLabel hasValue = ctx.DefineLabel(), allDone = ctx.DefineLabel(); + + ctx.CopyValue(); + ctx.BranchIfTrue(hasValue, true); // interpret null as "don't assign" + ctx.DiscardValue(); + ctx.Branch(allDone, true); + ctx.MarkLabel(hasValue); + ctx.StoreValue(locals[i]); + ctx.MarkLabel(allDone); + } + } + ctx.Branch(@continue, false); + } + + ctx.MarkLabel(notRecognised); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("SkipField")); + + ctx.MarkLabel(@continue); + ctx.EmitBasicRead("ReadFieldHeader", ctx.MapType(typeof(int))); + ctx.CopyValue(); + ctx.StoreValue(fieldNumber); + ctx.LoadValue(0); + ctx.BranchIfGreater(processField, false); + } + for (int i = 0; i < locals.Length; i++) + { + ctx.LoadValue(locals[i]); + } + + ctx.EmitCtor(ctor); + ctx.StoreValue(objValue); + } + finally + { + for (int i = 0; i < locals.Length; i++) + { + if (locals[i] != null) + locals[i].Dispose(); // release for re-use + } + } + } + + } +#endif + } +} + +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TypeSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TypeSerializer.cs new file mode 100644 index 0000000..d851b47 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/TypeSerializer.cs @@ -0,0 +1,798 @@ +#if !NO_RUNTIME +using System; +using ProtoBuf.Meta; +#if FEAT_COMPILER + +#endif + +using System.Reflection; + +namespace ProtoBuf.Serializers +{ + sealed class TypeSerializer : IProtoTypeSerializer + { + public bool HasCallbacks(TypeModel.CallbackType callbackType) + { + if (callbacks != null && callbacks[callbackType] != null) return true; + for (int i = 0; i < serializers.Length; i++) + { + if (serializers[i].ExpectedType != forType && ((IProtoTypeSerializer)serializers[i]).HasCallbacks(callbackType)) return true; + } + return false; + } + private readonly Type forType, constructType; +#if COREFX || PROFILE259 + private readonly TypeInfo typeInfo; +#endif + public Type ExpectedType { get { return forType; } } + private readonly IProtoSerializer[] serializers; + private readonly int[] fieldNumbers; + private readonly bool isRootType, useConstructor, isExtensible, hasConstructor; + private readonly CallbackSet callbacks; + private readonly MethodInfo[] baseCtorCallbacks; + private readonly MethodInfo factory; + public TypeSerializer(TypeModel model, Type forType, int[] fieldNumbers, IProtoSerializer[] serializers, MethodInfo[] baseCtorCallbacks, bool isRootType, bool useConstructor, CallbackSet callbacks, Type constructType, MethodInfo factory) + { + Helpers.DebugAssert(forType != null); + Helpers.DebugAssert(fieldNumbers != null); + Helpers.DebugAssert(serializers != null); + Helpers.DebugAssert(fieldNumbers.Length == serializers.Length); + + Helpers.Sort(fieldNumbers, serializers); + bool hasSubTypes = false; + for (int i = 0; i < fieldNumbers.Length; i++) + { + if (i != 0 && fieldNumbers[i] == fieldNumbers[i - 1]) throw new InvalidOperationException("Duplicate field-number detected; " + + fieldNumbers[i].ToString() + " on: " + forType.FullName); + if (!hasSubTypes && serializers[i].ExpectedType != forType) + { + hasSubTypes = true; + } + } + this.forType = forType; + this.factory = factory; +#if COREFX || PROFILE259 + this.typeInfo = forType.GetTypeInfo(); +#endif + if (constructType == null) + { + constructType = forType; + } + else + { +#if COREFX || PROFILE259 + if (!typeInfo.IsAssignableFrom(constructType.GetTypeInfo())) +#else + if (!forType.IsAssignableFrom(constructType)) +#endif + { + throw new InvalidOperationException(forType.FullName + " cannot be assigned from " + constructType.FullName); + } + } + this.constructType = constructType; + this.serializers = serializers; + this.fieldNumbers = fieldNumbers; + this.callbacks = callbacks; + this.isRootType = isRootType; + this.useConstructor = useConstructor; + + if (baseCtorCallbacks != null && baseCtorCallbacks.Length == 0) baseCtorCallbacks = null; + this.baseCtorCallbacks = baseCtorCallbacks; + + if (Helpers.GetUnderlyingType(forType) != null) + { + throw new ArgumentException("Cannot create a TypeSerializer for nullable types", "forType"); + } + +#if COREFX || PROFILE259 + if (iextensible.IsAssignableFrom(typeInfo)) + { + if (typeInfo.IsValueType || !isRootType || hasSubTypes) +#else + if (model.MapType(iextensible).IsAssignableFrom(forType)) + { + if (forType.IsValueType || !isRootType || hasSubTypes) +#endif + { + throw new NotSupportedException("IExtensible is not supported in structs or classes with inheritance"); + } + isExtensible = true; + } +#if COREFX || PROFILE259 + TypeInfo constructTypeInfo = constructType.GetTypeInfo(); + hasConstructor = !constructTypeInfo.IsAbstract && Helpers.GetConstructor(constructTypeInfo, Helpers.EmptyTypes, true) != null; +#else + hasConstructor = !constructType.IsAbstract && Helpers.GetConstructor(constructType, Helpers.EmptyTypes, true) != null; +#endif + if (constructType != forType && useConstructor && !hasConstructor) + { + throw new ArgumentException("The supplied default implementation cannot be created: " + constructType.FullName, "constructType"); + } + } +#if COREFX || PROFILE259 + private static readonly TypeInfo iextensible = typeof(IExtensible).GetTypeInfo(); +#else + private static readonly System.Type iextensible = typeof(IExtensible); +#endif + + private bool CanHaveInheritance + { + get + { +#if COREFX || PROFILE259 + return (typeInfo.IsClass || typeInfo.IsInterface) && !typeInfo.IsSealed; +#else + return (forType.IsClass || forType.IsInterface) && !forType.IsSealed; +#endif + } + } + + bool IProtoTypeSerializer.CanCreateInstance() { return true; } + + object IProtoTypeSerializer.CreateInstance(ProtoReader source) + { + return CreateInstance(source, false); + } + public void Callback(object value, TypeModel.CallbackType callbackType, SerializationContext context) + { + if (callbacks != null) InvokeCallback(callbacks[callbackType], value, context); + IProtoTypeSerializer ser = (IProtoTypeSerializer)GetMoreSpecificSerializer(value); + if (ser != null) ser.Callback(value, callbackType, context); + } + private IProtoSerializer GetMoreSpecificSerializer(object value) + { + if (!CanHaveInheritance) return null; + Type actualType = value.GetType(); + if (actualType == forType) return null; + + for (int i = 0; i < serializers.Length; i++) + { + IProtoSerializer ser = serializers[i]; + if (ser.ExpectedType != forType && Helpers.IsAssignableFrom(ser.ExpectedType, actualType)) + { + return ser; + } + } + if (actualType == constructType) return null; // needs to be last in case the default concrete type is also a known sub-type + TypeModel.ThrowUnexpectedSubtype(forType, actualType); // might throw (if not a proxy) + return null; + } + + public void Write(object value, ProtoWriter dest) + { + if (isRootType) Callback(value, TypeModel.CallbackType.BeforeSerialize, dest.Context); + // write inheritance first + IProtoSerializer next = GetMoreSpecificSerializer(value); + if (next != null) next.Write(value, dest); + + // write all actual fields + //Helpers.DebugWriteLine(">> Writing fields for " + forType.FullName); + for (int i = 0; i < serializers.Length; i++) + { + IProtoSerializer ser = serializers[i]; + if (ser.ExpectedType == forType) + { + //Helpers.DebugWriteLine(": " + ser.ToString()); + ser.Write(value, dest); + } + } + //Helpers.DebugWriteLine("<< Writing fields for " + forType.FullName); + if (isExtensible) ProtoWriter.AppendExtensionData((IExtensible)value, dest); + if (isRootType) Callback(value, TypeModel.CallbackType.AfterSerialize, dest.Context); + } + + public object Read(object value, ProtoReader source) + { + if (isRootType && value != null) { Callback(value, TypeModel.CallbackType.BeforeDeserialize, source.Context); } + int fieldNumber, lastFieldNumber = 0, lastFieldIndex = 0; + bool fieldHandled; + + //Helpers.DebugWriteLine(">> Reading fields for " + forType.FullName); + while ((fieldNumber = source.ReadFieldHeader()) > 0) + { + fieldHandled = false; + if (fieldNumber < lastFieldNumber) + { + lastFieldNumber = lastFieldIndex = 0; + } + for (int i = lastFieldIndex; i < fieldNumbers.Length; i++) + { + if (fieldNumbers[i] == fieldNumber) + { + IProtoSerializer ser = serializers[i]; + //Helpers.DebugWriteLine(": " + ser.ToString()); + Type serType = ser.ExpectedType; + if (value == null) + { + if (serType == forType) value = CreateInstance(source, true); + } + else + { + if (serType != forType && ((IProtoTypeSerializer)ser).CanCreateInstance() + && serType +#if COREFX || PROFILE259 + .GetTypeInfo() +#endif + .IsSubclassOf(value.GetType())) + { + value = ProtoReader.Merge(source, value, ((IProtoTypeSerializer)ser).CreateInstance(source)); + } + } + + if (ser.ReturnsValue) + { + value = ser.Read(value, source); + } + else + { // pop + ser.Read(value, source); + } + + lastFieldIndex = i; + lastFieldNumber = fieldNumber; + fieldHandled = true; + break; + } + } + if (!fieldHandled) + { + //Helpers.DebugWriteLine(": [" + fieldNumber + "] (unknown)"); + if (value == null) value = CreateInstance(source, true); + if (isExtensible) + { + source.AppendExtensionData((IExtensible)value); + } + else + { + source.SkipField(); + } + } + } + //Helpers.DebugWriteLine("<< Reading fields for " + forType.FullName); + if (value == null) value = CreateInstance(source, true); + if (isRootType) { Callback(value, TypeModel.CallbackType.AfterDeserialize, source.Context); } + return value; + } + + private object InvokeCallback(MethodInfo method, object obj, SerializationContext context) + { + object result = null; + object[] args; + if (method != null) + { // pass in a streaming context if one is needed, else null + bool handled; + ParameterInfo[] parameters = method.GetParameters(); + switch (parameters.Length) + { + case 0: + args = null; + handled = true; + break; + default: + args = new object[parameters.Length]; + handled = true; + for (int i = 0; i < args.Length; i++) + { + object val; + Type paramType = parameters[i].ParameterType; + if (paramType == typeof(SerializationContext)) val = context; + else if (paramType == typeof(System.Type)) val = constructType; +#if PLAT_BINARYFORMATTER + else if (paramType == typeof(System.Runtime.Serialization.StreamingContext)) val = (System.Runtime.Serialization.StreamingContext)context; +#endif + else + { + val = null; + handled = false; + } + args[i] = val; + } + break; + } + if (handled) + { + result = method.Invoke(obj, args); + } + else + { + throw Meta.CallbackSet.CreateInvalidCallbackSignature(method); + } + + } + return result; + } + object CreateInstance(ProtoReader source, bool includeLocalCallback) + { + //Helpers.DebugWriteLine("* creating : " + forType.FullName); + object obj; + if (factory != null) + { + obj = InvokeCallback(factory, null, source.Context); + } + else if (useConstructor) + { + if (!hasConstructor) TypeModel.ThrowCannotCreateInstance(constructType); +#if PROFILE259 + ConstructorInfo constructorInfo = System.Linq.Enumerable.First( + constructType.GetTypeInfo().DeclaredConstructors, c => c.GetParameters().Length == 0); + obj = constructorInfo.Invoke(new object[] {}); + +#else + obj = Activator.CreateInstance(constructType +#if !(CF || PORTABLE || NETSTANDARD1_3 || NETSTANDARD1_4 || UAP) + , nonPublic: true +#endif + ); +#endif + } + else + { + obj = BclHelpers.GetUninitializedObject(constructType); + } + ProtoReader.NoteObject(obj, source); + if (baseCtorCallbacks != null) + { + for (int i = 0; i < baseCtorCallbacks.Length; i++) + { + InvokeCallback(baseCtorCallbacks[i], obj, source.Context); + } + } + if (includeLocalCallback && callbacks != null) InvokeCallback(callbacks.BeforeDeserialize, obj, source.Context); + return obj; + } + + bool IProtoSerializer.RequiresOldValue { get { return true; } } + bool IProtoSerializer.ReturnsValue { get { return false; } } // updates field directly +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + Type expected = ExpectedType; + using (Compiler.Local loc = ctx.GetLocalWithValue(expected, valueFrom)) + { + // pre-callbacks + EmitCallbackIfNeeded(ctx, loc, TypeModel.CallbackType.BeforeSerialize); + + Compiler.CodeLabel startFields = ctx.DefineLabel(); + // inheritance + if (CanHaveInheritance) + { + for (int i = 0; i < serializers.Length; i++) + { + IProtoSerializer ser = serializers[i]; + Type serType = ser.ExpectedType; + if (serType != forType) + { + Compiler.CodeLabel ifMatch = ctx.DefineLabel(), nextTest = ctx.DefineLabel(); + ctx.LoadValue(loc); + ctx.TryCast(serType); + ctx.CopyValue(); + ctx.BranchIfTrue(ifMatch, true); + ctx.DiscardValue(); + ctx.Branch(nextTest, true); + ctx.MarkLabel(ifMatch); + if (Helpers.IsValueType(serType)) + { + ctx.DiscardValue(); + ctx.LoadValue(loc); + ctx.CastFromObject(serType); + } + ser.EmitWrite(ctx, null); + ctx.Branch(startFields, false); + ctx.MarkLabel(nextTest); + } + } + + + if (constructType != null && constructType != forType) + { + using (Compiler.Local actualType = new Compiler.Local(ctx, ctx.MapType(typeof(System.Type)))) + { + // would have jumped to "fields" if an expected sub-type, so two options: + // a: *exactly* that type, b: an *unexpected* type + ctx.LoadValue(loc); + ctx.EmitCall(ctx.MapType(typeof(object)).GetMethod("GetType")); + ctx.CopyValue(); + ctx.StoreValue(actualType); + ctx.LoadValue(forType); + ctx.BranchIfEqual(startFields, true); + + ctx.LoadValue(actualType); + ctx.LoadValue(constructType); + ctx.BranchIfEqual(startFields, true); + } + } + else + { + // would have jumped to "fields" if an expected sub-type, so two options: + // a: *exactly* that type, b: an *unexpected* type + ctx.LoadValue(loc); + ctx.EmitCall(ctx.MapType(typeof(object)).GetMethod("GetType")); + ctx.LoadValue(forType); + ctx.BranchIfEqual(startFields, true); + } + // unexpected, then... note that this *might* be a proxy, which + // is handled by ThrowUnexpectedSubtype + ctx.LoadValue(forType); + ctx.LoadValue(loc); + ctx.EmitCall(ctx.MapType(typeof(object)).GetMethod("GetType")); + ctx.EmitCall(ctx.MapType(typeof(TypeModel)).GetMethod("ThrowUnexpectedSubtype", + BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static)); + + } + // fields + + ctx.MarkLabel(startFields); + for (int i = 0; i < serializers.Length; i++) + { + IProtoSerializer ser = serializers[i]; + if (ser.ExpectedType == forType) ser.EmitWrite(ctx, loc); + } + + // extension data + if (isExtensible) + { + ctx.LoadValue(loc); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoWriter)).GetMethod("AppendExtensionData")); + } + // post-callbacks + EmitCallbackIfNeeded(ctx, loc, TypeModel.CallbackType.AfterSerialize); + } + } + static void EmitInvokeCallback(Compiler.CompilerContext ctx, MethodInfo method, bool copyValue, Type constructType, Type type) + { + if (method != null) + { + if (copyValue) ctx.CopyValue(); // assumes the target is on the stack, and that we want to *retain* it on the stack + ParameterInfo[] parameters = method.GetParameters(); + bool handled = true; + + for (int i = 0; i < parameters.Length; i++) + { + Type parameterType = parameters[i].ParameterType; + if (parameterType == ctx.MapType(typeof(SerializationContext))) + { + ctx.LoadSerializationContext(); + } + else if (parameterType == ctx.MapType(typeof(System.Type))) + { + Type tmp = constructType; + if (tmp == null) tmp = type; // no ?? in some C# profiles + ctx.LoadValue(tmp); + } +#if PLAT_BINARYFORMATTER + else if (parameterType == ctx.MapType(typeof(System.Runtime.Serialization.StreamingContext))) + { + ctx.LoadSerializationContext(); + MethodInfo op = ctx.MapType(typeof(SerializationContext)).GetMethod("op_Implicit", new Type[] { ctx.MapType(typeof(SerializationContext)) }); + if (op != null) + { // it isn't always! (framework versions, etc) + ctx.EmitCall(op); + handled = true; + } + } +#endif + else + { + handled = false; + } + } + if (handled) + { + ctx.EmitCall(method); + if (constructType != null) + { + if (method.ReturnType == ctx.MapType(typeof(object))) + { + ctx.CastFromObject(type); + } + } + } + else + { + throw Meta.CallbackSet.CreateInvalidCallbackSignature(method); + } + } + } + + private void EmitCallbackIfNeeded(Compiler.CompilerContext ctx, Compiler.Local valueFrom, TypeModel.CallbackType callbackType) + { + Helpers.DebugAssert(valueFrom != null); + if (isRootType && ((IProtoTypeSerializer)this).HasCallbacks(callbackType)) + { + ((IProtoTypeSerializer)this).EmitCallback(ctx, valueFrom, callbackType); + } + } + + void IProtoTypeSerializer.EmitCallback(Compiler.CompilerContext ctx, Compiler.Local valueFrom, TypeModel.CallbackType callbackType) + { + bool actuallyHasInheritance = false; + if (CanHaveInheritance) + { + + for (int i = 0; i < serializers.Length; i++) + { + IProtoSerializer ser = serializers[i]; + if (ser.ExpectedType != forType && ((IProtoTypeSerializer)ser).HasCallbacks(callbackType)) + { + actuallyHasInheritance = true; + } + } + } + + Helpers.DebugAssert(((IProtoTypeSerializer)this).HasCallbacks(callbackType), "Shouldn't be calling this if there is nothing to do"); + MethodInfo method = callbacks?[callbackType]; + if (method == null && !actuallyHasInheritance) + { + return; + } + ctx.LoadAddress(valueFrom, ExpectedType); + EmitInvokeCallback(ctx, method, actuallyHasInheritance, null, forType); + + if (actuallyHasInheritance) + { + Compiler.CodeLabel @break = ctx.DefineLabel(); + for (int i = 0; i < serializers.Length; i++) + { + IProtoSerializer ser = serializers[i]; + IProtoTypeSerializer typeser; + Type serType = ser.ExpectedType; + if (serType != forType && + (typeser = (IProtoTypeSerializer)ser).HasCallbacks(callbackType)) + { + Compiler.CodeLabel ifMatch = ctx.DefineLabel(), nextTest = ctx.DefineLabel(); + ctx.CopyValue(); + ctx.TryCast(serType); + ctx.CopyValue(); + ctx.BranchIfTrue(ifMatch, true); + ctx.DiscardValue(); + ctx.Branch(nextTest, false); + ctx.MarkLabel(ifMatch); + typeser.EmitCallback(ctx, null, callbackType); + ctx.Branch(@break, false); + ctx.MarkLabel(nextTest); + } + } + ctx.MarkLabel(@break); + ctx.DiscardValue(); + } + } + + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + Type expected = ExpectedType; + Helpers.DebugAssert(valueFrom != null); + + using (Compiler.Local loc = ctx.GetLocalWithValue(expected, valueFrom)) + using (Compiler.Local fieldNumber = new Compiler.Local(ctx, ctx.MapType(typeof(int)))) + { + // pre-callbacks + if (HasCallbacks(TypeModel.CallbackType.BeforeDeserialize)) + { + if (Helpers.IsValueType(ExpectedType)) + { + EmitCallbackIfNeeded(ctx, loc, TypeModel.CallbackType.BeforeDeserialize); + } + else + { // could be null + Compiler.CodeLabel callbacksDone = ctx.DefineLabel(); + ctx.LoadValue(loc); + ctx.BranchIfFalse(callbacksDone, false); + EmitCallbackIfNeeded(ctx, loc, TypeModel.CallbackType.BeforeDeserialize); + ctx.MarkLabel(callbacksDone); + } + } + + Compiler.CodeLabel @continue = ctx.DefineLabel(), processField = ctx.DefineLabel(); + ctx.Branch(@continue, false); + + ctx.MarkLabel(processField); + foreach (BasicList.Group group in BasicList.GetContiguousGroups(fieldNumbers, serializers)) + { + Compiler.CodeLabel tryNextField = ctx.DefineLabel(); + int groupItemCount = group.Items.Count; + if (groupItemCount == 1) + { + // discreet group; use an equality test + ctx.LoadValue(fieldNumber); + ctx.LoadValue(group.First); + Compiler.CodeLabel processThisField = ctx.DefineLabel(); + ctx.BranchIfEqual(processThisField, true); + ctx.Branch(tryNextField, false); + WriteFieldHandler(ctx, expected, loc, processThisField, @continue, (IProtoSerializer)group.Items[0]); + } + else + { // implement as a jump-table-based switch + ctx.LoadValue(fieldNumber); + ctx.LoadValue(group.First); + ctx.Subtract(); // jump-tables are zero-based + Compiler.CodeLabel[] jmp = new Compiler.CodeLabel[groupItemCount]; + for (int i = 0; i < groupItemCount; i++) + { + jmp[i] = ctx.DefineLabel(); + } + ctx.Switch(jmp); + // write the default... + ctx.Branch(tryNextField, false); + for (int i = 0; i < groupItemCount; i++) + { + WriteFieldHandler(ctx, expected, loc, jmp[i], @continue, (IProtoSerializer)group.Items[i]); + } + } + ctx.MarkLabel(tryNextField); + } + + EmitCreateIfNull(ctx, loc); + ctx.LoadReaderWriter(); + if (isExtensible) + { + ctx.LoadValue(loc); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("AppendExtensionData")); + } + else + { + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("SkipField")); + } + + ctx.MarkLabel(@continue); + ctx.EmitBasicRead("ReadFieldHeader", ctx.MapType(typeof(int))); + ctx.CopyValue(); + ctx.StoreValue(fieldNumber); + ctx.LoadValue(0); + ctx.BranchIfGreater(processField, false); + + EmitCreateIfNull(ctx, loc); + // post-callbacks + EmitCallbackIfNeeded(ctx, loc, TypeModel.CallbackType.AfterDeserialize); + + if (valueFrom != null && !loc.IsSame(valueFrom)) + { + ctx.LoadValue(loc); + ctx.Cast(valueFrom.Type); + ctx.StoreValue(valueFrom); + } + } + } + + private void WriteFieldHandler( + Compiler.CompilerContext ctx, Type expected, Compiler.Local loc, + Compiler.CodeLabel handler, Compiler.CodeLabel @continue, IProtoSerializer serializer) + { + ctx.MarkLabel(handler); + Type serType = serializer.ExpectedType; + if (serType == forType) + { + EmitCreateIfNull(ctx, loc); + serializer.EmitRead(ctx, loc); + } + else + { + //RuntimeTypeModel rtm = (RuntimeTypeModel)ctx.Model; + if (((IProtoTypeSerializer)serializer).CanCreateInstance()) + { + Compiler.CodeLabel allDone = ctx.DefineLabel(); + + ctx.LoadValue(loc); + ctx.BranchIfFalse(allDone, false); // null is always ok + + ctx.LoadValue(loc); + ctx.TryCast(serType); + ctx.BranchIfTrue(allDone, false); // not null, but of the correct type + + // otherwise, need to convert it + ctx.LoadReaderWriter(); + ctx.LoadValue(loc); + ((IProtoTypeSerializer)serializer).EmitCreateInstance(ctx); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("Merge")); + ctx.Cast(expected); + ctx.StoreValue(loc); // Merge always returns a value + + // nothing needs doing + ctx.MarkLabel(allDone); + } + + if (Helpers.IsValueType(serType)) + { + Compiler.CodeLabel initValue = ctx.DefineLabel(); + Compiler.CodeLabel hasValue = ctx.DefineLabel(); + using (Compiler.Local emptyValue = new Compiler.Local(ctx, serType)) + { + ctx.LoadValue(loc); + ctx.BranchIfFalse(initValue, false); + + ctx.LoadValue(loc); + ctx.CastFromObject(serType); + ctx.Branch(hasValue, false); + + ctx.MarkLabel(initValue); + ctx.InitLocal(serType, emptyValue); + ctx.LoadValue(emptyValue); + + ctx.MarkLabel(hasValue); + } + } + else + { + ctx.LoadValue(loc); + ctx.Cast(serType); + } + + serializer.EmitRead(ctx, null); + + } + + if (serializer.ReturnsValue) + { // update the variable + if (Helpers.IsValueType(serType)) + { + // but box it first in case of value type + ctx.CastToObject(serType); + } + ctx.StoreValue(loc); + } + ctx.Branch(@continue, false); // "continue" + } + + void IProtoTypeSerializer.EmitCreateInstance(Compiler.CompilerContext ctx) + { + // different ways of creating a new instance + bool callNoteObject = true; + if (factory != null) + { + EmitInvokeCallback(ctx, factory, false, constructType, forType); + } + else if (!useConstructor) + { // DataContractSerializer style + ctx.LoadValue(constructType); + ctx.EmitCall(ctx.MapType(typeof(BclHelpers)).GetMethod("GetUninitializedObject")); + ctx.Cast(forType); + } + else if (Helpers.IsClass(constructType) && hasConstructor) + { // XmlSerializer style + ctx.EmitCtor(constructType); + } + else + { + ctx.LoadValue(ExpectedType); + ctx.EmitCall(ctx.MapType(typeof(TypeModel)).GetMethod("ThrowCannotCreateInstance", + BindingFlags.Static | BindingFlags.Public)); + ctx.LoadNullRef(); + callNoteObject = false; + } + if (callNoteObject) + { + // track root object creation + ctx.CopyValue(); + ctx.LoadReaderWriter(); + ctx.EmitCall(ctx.MapType(typeof(ProtoReader)).GetMethod("NoteObject", + BindingFlags.Static | BindingFlags.Public)); + } + if (baseCtorCallbacks != null) + { + for (int i = 0; i < baseCtorCallbacks.Length; i++) + { + EmitInvokeCallback(ctx, baseCtorCallbacks[i], true, null, forType); + } + } + } + private void EmitCreateIfNull(Compiler.CompilerContext ctx, Compiler.Local storage) + { + Helpers.DebugAssert(storage != null); + if (!Helpers.IsValueType(ExpectedType)) + { + Compiler.CodeLabel afterNullCheck = ctx.DefineLabel(); + ctx.LoadValue(storage); + ctx.BranchIfTrue(afterNullCheck, false); + + ((IProtoTypeSerializer)this).EmitCreateInstance(ctx); + + if (callbacks != null) EmitInvokeCallback(ctx, callbacks.BeforeDeserialize, true, null, forType); + ctx.StoreValue(storage); + ctx.MarkLabel(afterNullCheck); + } + } +#endif + } + +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt16Serializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt16Serializer.cs new file mode 100644 index 0000000..ff9f89b --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt16Serializer.cs @@ -0,0 +1,43 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + class UInt16Serializer : IProtoSerializer + { + static readonly Type expectedType = typeof(ushort); + + public UInt16Serializer(ProtoBuf.Meta.TypeModel model) + { + } + + public virtual Type ExpectedType => expectedType; + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public virtual object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadUInt16(); + } + + public virtual void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteUInt16((ushort)value, dest); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteUInt16", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadUInt16", ctx.MapType(typeof(ushort))); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt32Serializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt32Serializer.cs new file mode 100644 index 0000000..08b4f4b --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt32Serializer.cs @@ -0,0 +1,43 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class UInt32Serializer : IProtoSerializer + { + static readonly Type expectedType = typeof(uint); + + public UInt32Serializer(ProtoBuf.Meta.TypeModel model) + { + + } + + public Type ExpectedType => expectedType; + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadUInt32(); + } + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteUInt32((uint)value, dest); + } +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteUInt32", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadUInt32", ctx.MapType(typeof(uint))); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt64Serializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt64Serializer.cs new file mode 100644 index 0000000..8577edd --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UInt64Serializer.cs @@ -0,0 +1,43 @@ +#if !NO_RUNTIME +using System; + +namespace ProtoBuf.Serializers +{ + sealed class UInt64Serializer : IProtoSerializer + { + static readonly Type expectedType = typeof(ulong); + + public UInt64Serializer(ProtoBuf.Meta.TypeModel model) + { + + } + public Type ExpectedType => expectedType; + + bool IProtoSerializer.RequiresOldValue => false; + + bool IProtoSerializer.ReturnsValue => true; + + public object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // since replaces + return source.ReadUInt64(); + } + + public void Write(object value, ProtoWriter dest) + { + ProtoWriter.WriteUInt64((ulong)value, dest); + } + +#if FEAT_COMPILER + void IProtoSerializer.EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicWrite("WriteUInt64", valueFrom); + } + void IProtoSerializer.EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.EmitBasicRead("ReadUInt64", ExpectedType); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UriDecorator.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UriDecorator.cs new file mode 100644 index 0000000..d34ac2d --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/Serializers/UriDecorator.cs @@ -0,0 +1,62 @@ +#if !NO_RUNTIME +using System; +using System.Reflection; + +#if FEAT_COMPILER +using ProtoBuf.Compiler; +#endif + +namespace ProtoBuf.Serializers +{ + sealed class UriDecorator : ProtoDecoratorBase + { + static readonly Type expectedType = typeof(Uri); + public UriDecorator(ProtoBuf.Meta.TypeModel model, IProtoSerializer tail) : base(tail) + { + + } + + public override Type ExpectedType => expectedType; + + public override bool RequiresOldValue => false; + + public override bool ReturnsValue => true; + + public override void Write(object value, ProtoWriter dest) + { + Tail.Write(((Uri)value).OriginalString, dest); + } + + public override object Read(object value, ProtoReader source) + { + Helpers.DebugAssert(value == null); // not expecting incoming + string s = (string)Tail.Read(null, source); + return s.Length == 0 ? null : new Uri(s, UriKind.RelativeOrAbsolute); + } + +#if FEAT_COMPILER + protected override void EmitWrite(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + ctx.LoadValue(valueFrom); + ctx.LoadValue(typeof(Uri).GetProperty("OriginalString")); + Tail.EmitWrite(ctx, null); + } + protected override void EmitRead(Compiler.CompilerContext ctx, Compiler.Local valueFrom) + { + Tail.EmitRead(ctx, valueFrom); + ctx.CopyValue(); + Compiler.CodeLabel @nonEmpty = ctx.DefineLabel(), @end = ctx.DefineLabel(); + ctx.LoadValue(typeof(string).GetProperty("Length")); + ctx.BranchIfTrue(@nonEmpty, true); + ctx.DiscardValue(); + ctx.LoadNullRef(); + ctx.Branch(@end, true); + ctx.MarkLabel(@nonEmpty); + ctx.LoadValue((int)UriKind.RelativeOrAbsolute); + ctx.EmitCtor(ctx.MapType(typeof(Uri)), ctx.MapType(typeof(string)), ctx.MapType(typeof(UriKind))); + ctx.MarkLabel(@end); + } +#endif + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoBehaviorAttribute.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoBehaviorAttribute.cs new file mode 100644 index 0000000..928207e --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoBehaviorAttribute.cs @@ -0,0 +1,35 @@ +#if FEAT_SERVICEMODEL && PLAT_XMLSERIALIZER +using System; +using System.ServiceModel.Channels; +using System.ServiceModel.Description; +using System.ServiceModel.Dispatcher; + +namespace ProtoBuf.ServiceModel +{ + /// + /// Uses protocol buffer serialization on the specified operation; note that this + /// must be enabled on both the client and server. + /// + [AttributeUsage(AttributeTargets.Method, AllowMultiple = false)] + public sealed class ProtoBehaviorAttribute : Attribute, IOperationBehavior + { + void IOperationBehavior.AddBindingParameters(OperationDescription operationDescription, BindingParameterCollection bindingParameters) + { } + + void IOperationBehavior.ApplyClientBehavior(OperationDescription operationDescription, ClientOperation clientOperation) + { + IOperationBehavior innerBehavior = new ProtoOperationBehavior(operationDescription); + innerBehavior.ApplyClientBehavior(operationDescription, clientOperation); + } + + void IOperationBehavior.ApplyDispatchBehavior(OperationDescription operationDescription, DispatchOperation dispatchOperation) + { + IOperationBehavior innerBehavior = new ProtoOperationBehavior(operationDescription); + innerBehavior.ApplyDispatchBehavior(operationDescription, dispatchOperation); + } + + void IOperationBehavior.Validate(OperationDescription operationDescription) + { } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoBehaviorExtensionElement.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoBehaviorExtensionElement.cs new file mode 100644 index 0000000..56edb79 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoBehaviorExtensionElement.cs @@ -0,0 +1,29 @@ +#if FEAT_SERVICEMODEL && PLAT_XMLSERIALIZER && FEAT_SERVICECONFIGMODEL +using System; +using System.ServiceModel.Configuration; + +namespace ProtoBuf.ServiceModel +{ + /// + /// Configuration element to swap out DatatContractSerilaizer with the XmlProtoSerializer for a given endpoint. + /// + /// + public class ProtoBehaviorExtension : BehaviorExtensionElement + { + /// + /// Creates a new ProtoBehaviorExtension instance. + /// + public ProtoBehaviorExtension() { } + /// + /// Gets the type of behavior. + /// + public override Type BehaviorType => typeof(ProtoEndpointBehavior); + + /// + /// Creates a behavior extension based on the current configuration settings. + /// + /// The behavior extension. + protected override object CreateBehavior() => new ProtoEndpointBehavior(); + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoEndpointBehavior.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoEndpointBehavior.cs new file mode 100644 index 0000000..9bcfb99 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoEndpointBehavior.cs @@ -0,0 +1,82 @@ +#if FEAT_SERVICEMODEL && PLAT_XMLSERIALIZER +using System.ServiceModel.Description; + +namespace ProtoBuf.ServiceModel +{ + /// + /// Behavior to swap out DatatContractSerilaizer with the XmlProtoSerializer for a given endpoint. + /// + /// Add the following to the server and client app.config in the system.serviceModel section: + /// + /// + /// + /// + /// + /// + /// + /// + /// + /// + /// + /// + /// + /// Configure your endpoints to have a behaviorConfiguration as follows: + /// + /// + /// + /// + /// + /// + /// + /// + /// + public class ProtoEndpointBehavior : IEndpointBehavior + { + #region IEndpointBehavior Members + + void IEndpointBehavior.AddBindingParameters(ServiceEndpoint endpoint, System.ServiceModel.Channels.BindingParameterCollection bindingParameters) + { + } + + void IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint endpoint, System.ServiceModel.Dispatcher.ClientRuntime clientRuntime) + { + ReplaceDataContractSerializerOperationBehavior(endpoint); + } + + void IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint endpoint, System.ServiceModel.Dispatcher.EndpointDispatcher endpointDispatcher) + { + ReplaceDataContractSerializerOperationBehavior(endpoint); + } + + void IEndpointBehavior.Validate(ServiceEndpoint endpoint) + { + } + + private static void ReplaceDataContractSerializerOperationBehavior(ServiceEndpoint serviceEndpoint) + { + foreach (OperationDescription operationDescription in serviceEndpoint.Contract.Operations) + { + ReplaceDataContractSerializerOperationBehavior(operationDescription); + } + } + + private static void ReplaceDataContractSerializerOperationBehavior(OperationDescription description) + { + DataContractSerializerOperationBehavior dcsOperationBehavior = description.Behaviors.Find(); + if (dcsOperationBehavior != null) + { + description.Behaviors.Remove(dcsOperationBehavior); + + ProtoOperationBehavior newBehavior = new ProtoOperationBehavior(description); + newBehavior.MaxItemsInObjectGraph = dcsOperationBehavior.MaxItemsInObjectGraph; + description.Behaviors.Add(newBehavior); + } + } + + #endregion + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoOperationBehavior.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoOperationBehavior.cs new file mode 100644 index 0000000..9d5f02c --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/ProtoOperationBehavior.cs @@ -0,0 +1,52 @@ +#if FEAT_SERVICEMODEL && PLAT_XMLSERIALIZER +using System; +using System.Collections.Generic; +using System.Runtime.Serialization; +using System.ServiceModel.Description; +using System.Xml; +using ProtoBuf.Meta; + +namespace ProtoBuf.ServiceModel +{ + /// + /// Describes a WCF operation behaviour that can perform protobuf serialization + /// + public sealed class ProtoOperationBehavior : DataContractSerializerOperationBehavior + { + private TypeModel model; + + /// + /// Create a new ProtoOperationBehavior instance + /// + public ProtoOperationBehavior(OperationDescription operation) : base(operation) + { +#if !NO_RUNTIME + model = RuntimeTypeModel.Default; +#endif + } + + /// + /// The type-model that should be used with this behaviour + /// + public TypeModel Model + { + get { return model; } + set + { + model = value ?? throw new ArgumentNullException(nameof(value)); + } + } + + //public ProtoOperationBehavior(OperationDescription operation, DataContractFormatAttribute dataContractFormat) : base(operation, dataContractFormat) { } + + /// + /// Creates a protobuf serializer if possible (falling back to the default WCF serializer) + /// + public override XmlObjectSerializer CreateSerializer(Type type, XmlDictionaryString name, XmlDictionaryString ns, IList knownTypes) + { + if (model == null) throw new InvalidOperationException("No Model instance has been assigned to the ProtoOperationBehavior"); + return XmlProtoSerializer.TryCreate(model, type) ?? base.CreateSerializer(type, name, ns, knownTypes); + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/XmlProtoSerializer.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/XmlProtoSerializer.cs new file mode 100644 index 0000000..23959ea --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/ServiceModel/XmlProtoSerializer.cs @@ -0,0 +1,208 @@ +#if FEAT_SERVICEMODEL && PLAT_XMLSERIALIZER +using System; +using System.IO; +using System.Runtime.Serialization; +using System.Xml; +using ProtoBuf.Meta; + +namespace ProtoBuf.ServiceModel +{ + /// + /// An xml object serializer that can embed protobuf data in a base-64 hunk (looking like a byte[]) + /// + public sealed class XmlProtoSerializer : XmlObjectSerializer + { + private readonly TypeModel model; + private readonly int key; + private readonly bool isList, isEnum; + private readonly Type type; + internal XmlProtoSerializer(TypeModel model, int key, Type type, bool isList) + { + if (key < 0) throw new ArgumentOutOfRangeException(nameof(key)); + this.model = model ?? throw new ArgumentNullException(nameof(model)); + this.key = key; + this.isList = isList; + this.type = type ?? throw new ArgumentOutOfRangeException(nameof(type)); + this.isEnum = Helpers.IsEnum(type); + } + /// + /// Attempt to create a new serializer for the given model and type + /// + /// A new serializer instance if the type is recognised by the model; null otherwise + public static XmlProtoSerializer TryCreate(TypeModel model, Type type) + { + if (model == null) throw new ArgumentNullException(nameof(model)); + if (type == null) throw new ArgumentNullException(nameof(type)); + + int key = GetKey(model, ref type, out bool isList); + if (key >= 0) + { + return new XmlProtoSerializer(model, key, type, isList); + } + return null; + } + + /// + /// Creates a new serializer for the given model and type + /// + public XmlProtoSerializer(TypeModel model, Type type) + { + if (model == null) throw new ArgumentNullException(nameof(model)); + if (type == null) throw new ArgumentNullException(nameof(type)); + + key = GetKey(model, ref type, out isList); + this.model = model; + this.type = type; + this.isEnum = Helpers.IsEnum(type); + if (key < 0) throw new ArgumentOutOfRangeException(nameof(type), "Type not recognised by the model: " + type.FullName); + } + + static int GetKey(TypeModel model, ref Type type, out bool isList) + { + if (model != null && type != null) + { + int key = model.GetKey(ref type); + if (key >= 0) + { + isList = false; + return key; + } + Type itemType = TypeModel.GetListItemType(model, type); + if (itemType != null) + { + key = model.GetKey(ref itemType); + if (key >= 0) + { + isList = true; + return key; + } + } + } + + isList = false; + return -1; + } + + /// + /// Ends an object in the output + /// + public override void WriteEndObject(XmlDictionaryWriter writer) + { + if (writer == null) throw new ArgumentNullException(nameof(writer)); + writer.WriteEndElement(); + } + + /// + /// Begins an object in the output + /// + public override void WriteStartObject(XmlDictionaryWriter writer, object graph) + { + if (writer == null) throw new ArgumentNullException(nameof(writer)); + writer.WriteStartElement(PROTO_ELEMENT); + } + + private const string PROTO_ELEMENT = "proto"; + + /// + /// Writes the body of an object in the output + /// + public override void WriteObjectContent(XmlDictionaryWriter writer, object graph) + { + if (writer == null) throw new ArgumentNullException(nameof(writer)); + if (graph == null) + { + writer.WriteAttributeString("nil", "true"); + } + else + { + using (MemoryStream ms = new MemoryStream()) + { + if (isList) + { + model.Serialize(ms, graph, null); + } + else + { + using (ProtoWriter protoWriter = ProtoWriter.Create(ms, model, null)) + { + model.Serialize(key, graph, protoWriter); + } + } + byte[] buffer = ms.GetBuffer(); + writer.WriteBase64(buffer, 0, (int)ms.Length); + } + } + } + + /// + /// Indicates whether this is the start of an object we are prepared to handle + /// + public override bool IsStartObject(XmlDictionaryReader reader) + { + if (reader == null) throw new ArgumentNullException(nameof(reader)); + reader.MoveToContent(); + return reader.NodeType == XmlNodeType.Element && reader.Name == PROTO_ELEMENT; + } + + /// + /// Reads the body of an object + /// + public override object ReadObject(XmlDictionaryReader reader, bool verifyObjectName) + { + if (reader == null) throw new ArgumentNullException(nameof(reader)); + reader.MoveToContent(); + bool isSelfClosed = reader.IsEmptyElement, isNil = reader.GetAttribute("nil") == "true"; + reader.ReadStartElement(PROTO_ELEMENT); + + // explicitly null + if (isNil) + { + if (!isSelfClosed) reader.ReadEndElement(); + return null; + } + if (isSelfClosed) // no real content + { + if (isList || isEnum) + { + return model.Deserialize(Stream.Null, null, type, null); + } + ProtoReader protoReader = null; + try + { + protoReader = ProtoReader.Create(Stream.Null, model, null, ProtoReader.TO_EOF); + return model.Deserialize(key, null, protoReader); + } + finally + { + ProtoReader.Recycle(protoReader); + } + } + + object result; + Helpers.DebugAssert(reader.CanReadBinaryContent, "CanReadBinaryContent"); + using (MemoryStream ms = new MemoryStream(reader.ReadContentAsBase64())) + { + if (isList || isEnum) + { + result = model.Deserialize(ms, null, type, null); + } + else + { + ProtoReader protoReader = null; + try + { + protoReader = ProtoReader.Create(ms, model, null, ProtoReader.TO_EOF); + result = model.Deserialize(key, null, protoReader); + } + finally + { + ProtoReader.Recycle(protoReader); + } + } + } + reader.ReadEndElement(); + return result; + } + } +} +#endif \ No newline at end of file diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/SubItemToken.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/SubItemToken.cs new file mode 100644 index 0000000..51f4a24 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/SubItemToken.cs @@ -0,0 +1,16 @@ + +using System; + +namespace ProtoBuf +{ + /// + /// Used to hold particulars relating to nested objects. This is opaque to the caller - simply + /// give back the token you are given at the end of an object. + /// + public readonly struct SubItemToken + { + internal readonly long value64; + internal SubItemToken(int value) => value64 = value; + internal SubItemToken(long value) => value64 = value; + } +} diff --git a/FantasyNetTest/NBC/Plugins/Protobuf-net/WireType.cs b/FantasyNetTest/NBC/Plugins/Protobuf-net/WireType.cs new file mode 100644 index 0000000..ab4fa20 --- /dev/null +++ b/FantasyNetTest/NBC/Plugins/Protobuf-net/WireType.cs @@ -0,0 +1,50 @@ +namespace ProtoBuf +{ + /// + /// Indicates the encoding used to represent an individual value in a protobuf stream + /// + public enum WireType + { + /// + /// Represents an error condition + /// + None = -1, + + /// + /// Base-128 variant-length encoding + /// + Variant = 0, + + /// + /// Fixed-length 8-byte encoding + /// + Fixed64 = 1, + + /// + /// Length-variant-prefixed encoding + /// + String = 2, + + /// + /// Indicates the start of a group + /// + StartGroup = 3, + + /// + /// Indicates the end of a group + /// + EndGroup = 4, + + /// + /// Fixed-length 4-byte encoding + /// 10 + Fixed32 = 5, + + /// + /// This is not a formal wire-type in the "protocol buffers" spec, but + /// denotes a variant integer that should be interpreted using + /// zig-zag semantics (so -ve numbers aren't a significant overhead) + /// + SignedVariant = WireType.Variant | (1 << 3), + } +} diff --git a/FantasyNetTest/NBC/SessionHelper.cs b/FantasyNetTest/NBC/SessionHelper.cs new file mode 100644 index 0000000..0031220 --- /dev/null +++ b/FantasyNetTest/NBC/SessionHelper.cs @@ -0,0 +1,27 @@ +using NBC.Network; + +namespace NBC; + +public static class SessionHelper +{ + /// + /// 创建一个网络会话 + /// + /// + /// 远程服务器地址 + /// 当连接成功执行的委托，可为空 + /// 当连接超时或失败执行的委托，可为空 + /// 当连接断开执行的委托，可为空 + /// + public static Session CreateSession(Scene scene, string address, Action onConnectComplete, Action onConnectFail, + Action onConnectDisconnect) + { + return scene.Connect( + address, + NetworkProtocolType.KCP, + onConnectComplete, + onConnectFail, + onConnectDisconnect, + false, 5000); + } +} \ No newline at end of file diff --git a/FantasyNetTest/Network.zip b/FantasyNetTest/Network.zip new file mode 100644 index 0000000000000000000000000000000000000000..95eccaf814fce2983bb8c965f635693847ef99d6 GIT binary patch literal 251267 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%0Ah0DsT#w*flMz1M59@x8mk6P4TowZ!BmDc@6 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

      {xo=UFe6KQNjkUXwz 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 + /// The main entry point for the application. + /// + [STAThread] + static void Main() + { + // To customize application configuration such as set high DPI settings or default font, + // see https://aka.ms/applicationconfiguration. + ApplicationConfiguration.Initialize(); + Application.Run(new Form1()); + } +} \ No newline at end of file diff --git a/FantasyNetTest/TestProtocol.cs b/FantasyNetTest/TestProtocol.cs new file mode 100644 index 0000000..3f8a119 --- /dev/null +++ b/FantasyNetTest/TestProtocol.cs @@ -0,0 +1,26 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using System.Text; +using System.Threading.Tasks; + +namespace FantasyNetTest +{ + public class TestProtocol + { + public int Type { get; set; } + public long Id { get; set; } + public string Name { get; set; } + public bool IsArt { get; set; } + + public uint Target { get; set; } + + public float Price { get; set; } + + public byte by { get; set; } + + public double dou { get; set; } + + public short sh { get; set; } + } +} diff --git a/FantasyNetTest/UnityEngine/Mathf.cs b/FantasyNetTest/UnityEngine/Mathf.cs new file mode 100644 index 0000000..7d8dc6e --- /dev/null +++ b/FantasyNetTest/UnityEngine/Mathf.cs @@ -0,0 +1,6 @@ +namespace UnityEngine; + +public class Mathf +{ + public static float Ceil(float f) => (float) Math.Ceiling((double) f); +} \ No newline at end of file diff --git a/FantasyNetTest/UnityEngine/Time.cs b/FantasyNetTest/UnityEngine/Time.cs new file mode 100644 index 0000000..f9c2ae6 --- /dev/null +++ b/FantasyNetTest/UnityEngine/Time.cs @@ -0,0 +1,18 @@ +namespace UnityEngine; + +public static class Time +{ + private static DateTime _startTime; + + static Time() + { + _startTime = DateTime.Now; + } + + public static float time => (float)(DateTime.Now - _startTime).TotalSeconds; + + public static void Tick() + { + + } +} \ No newline at end of file diff --git a/FantasyNetTest/Utils/CoderLoader.cs b/FantasyNetTest/Utils/CoderLoader.cs new file mode 100644 index 0000000..ef8a5ad --- /dev/null +++ b/FantasyNetTest/Utils/CoderLoader.cs @@ -0,0 +1,122 @@ +using System.Reflection; +using NBC.Network.Interface; +using NBC.Serialize; + +namespace FantasyNetTest; + +public static class CoderLoader +{ + private static List _types = new List(); + + private static List _requestTypes = new List(); + + public static List RequestTypes => _requestTypes.ToList(); + + public static void Load() + { + var reqTpe = typeof(IRequest); + var types = GetAllDerivedTypes(typeof(AMessage)); + _requestTypes.Clear(); + foreach (var type in types) + { + // 精确判断：直接实现的接口（不包括继承的接口） + var interfaces = type.GetInterfaces(); + if (interfaces.Contains(reqTpe) && !type.IsAbstract) + { + _requestTypes.Add(type); + } + } + + _types.AddRange(types); + } + + public static List GetAllDerivedTypes(Type baseType) + { + var derivedTypes = new List(); + + // 获取当前应用程序域中所有已加载的程序集 + var assemblies = AppDomain.CurrentDomain.GetAssemblies(); + + foreach (var assembly in assemblies) + { + try + { + // 获取程序集中所有类型 + var types = assembly.GetTypes() + .Where(t => t != baseType && baseType.IsAssignableFrom(t) && !t.IsAbstract); + + derivedTypes.AddRange(types); + } + catch (ReflectionTypeLoadException ex) + { + // 处理部分类型加载失败的情况 + var loadedTypes = ex.Types.Where(t => t != null); + var types = loadedTypes + .Where(t => t != baseType && baseType.IsAssignableFrom(t) && !t.IsAbstract); + + derivedTypes.AddRange(types); + } + } + + return derivedTypes; + } + + public static Type? GetTypeByName(string name) + { + foreach (var type in _types) + { + if (type.Name == name) + { + return type; + } + } + + return null; + } + + public static void SetPropertyValue(this object self, string name, object? value) + { + if (self == null || value == null) return; + var propertyUsername = self.GetType() + .GetProperty(name, BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance); + + if (propertyUsername != null && propertyUsername.CanWrite) + { + propertyUsername.SetValue(self, value); + } + } + + public static object? GetFieldValue(this object obj, string fieldName) + { + Type type = obj.GetType(); + FieldInfo? field = type.GetField(fieldName); // 默认只查找公共实例字段 + + if (field == null) + { + throw new ArgumentException($"字段 '{fieldName}' 未找到"); + } + + return field.GetValue(obj); + } + + public static object? GetPropertyValue(this object obj, string fieldName) + { + Type type = obj.GetType(); + var ps = type.GetProperties(); + foreach (var propertyInfo in ps) + { + if (propertyInfo.Name == fieldName) + { + + } + } + PropertyInfo? field = type.GetProperty(fieldName); // 默认只查找公共实例字段 + + if (field == null) + { + throw new ArgumentException($"属性 '{fieldName}' 未找到"); + } + + return field.GetValue(obj); + } +} \ No newline at end of file diff --git a/FantasyNetTest/Utils/NamespaceHelper.cs b/FantasyNetTest/Utils/NamespaceHelper.cs new file mode 100644 index 0000000..507fe90 --- /dev/null +++ b/FantasyNetTest/Utils/NamespaceHelper.cs @@ -0,0 +1,44 @@ +namespace FantasyNetTest; + +using System; +using System.Collections.Generic; +using System.Linq; +using System.Reflection; + +public static class NamespaceHelper +{ + public static IEnumerable GetAllNamespaces(Assembly assembly) + { + return assembly.GetTypes() + .Select(t => t.Namespace) + .Where(n => n != null) + .Distinct(); + } + + public static IEnumerable GetAllReferencedNamespaces() + { + var namespaces = new HashSet(); + var assemblies = AppDomain.CurrentDomain.GetAssemblies(); + + foreach (var assembly in assemblies) + { + try + { + foreach (var type in assembly.GetTypes()) + { + if (!string.IsNullOrEmpty(type.Namespace)) + { + namespaces.Add(type.Namespace); + } + } + } + catch (ReflectionTypeLoadException) + { + // 忽略无法加载类型的程序集 + continue; + } + } + + return namespaces; + } +} \ No newline at end of file diff --git a/global.json b/global.json new file mode 100644 index 0000000..2ddda36 --- /dev/null +++ b/global.json @@ -0,0 +1,7 @@ +{ + "sdk": { + "version": "8.0.0", + "rollForward": "latestMinor", + "allowPrerelease": false + } +} \ No newline at end of file