nuget
Socket user client => Socket server data request & Socket server => Socket user client data response package. (Socket客户端 => Socket服务器所发送的数据请求以及从 Socket服务器 => Socket客户端所返回数据的数据响应包)
RequestStream
01 Syntax
Microsoft.VisualBasic.Parallel.RequestStream
02 Methods
| Name | Overloads | Summary |
|---|---|---|
| .ctor | 5 | Deserialize (当还有剩余数据的时候会将数据进行剪裁) |
| GetUTF8String | 1 | 默认是使用UTF8编码来编码字符串的 |
| GetString | 1 | 按照指定的编码构建出一个字符串值 |
| LoadObject | 2 | json |
| GetRawStream | 1 | 从原始数据流RequestStream.ChunkBuffer之中进行反序列化得到一个嵌套的数据串流对象 |
| CreateProtocol | 1 | 这个函数是使用json序列化参数信息的 |
| CreatePackage | 1 | 服务器端返回数据所使用的，默认使用json序列化，所有的标签为HTTP_RFC.RFC_OK |
| CreatePackage | 1 | 服务器端返回数据所使用的，所有的标签为HTTP_RFC.RFC_OK |
| Serialize | 1 | 执行序列化进行网络之间的数据传输 |
| op_Equality | 1 | 简单的字符串等价 |
| GetIntegers | 1 | |
| GetDoubles | 1 | |
| LoadObject | 2 | |
| GetRawStream | 1 | |
| ToString | 1 | |
| CreateProtocol | 1 | |
| IsAvaliableStream | 1 | |
| WriteBuffer | 1 | |
| SystemProtocol | 1 | |
| op_Inequality | 1 |
03 Properties
| Name | Overloads | Summary |
|---|---|---|
| ProtocolCategory | 1 | This property indicates the protocol processor module for the server object. |
| Protocol | 1 | This property indicates which the specifics protocol processor will be used for the incoming client request. |
| BufferLength | 1 | Buffer length of the protocol request raw stream data RequestStream.ChunkBuffer. |
| ChunkBuffer | 1 | The raw stream data of the details data request or the server response data. |
| FullRead | 1 | verify that the stream data in RequestStream.ChunkBuffer is recieve complete? (RequestStream.ChunkBuffer部分的数据是否完整？) |
| TotalBytes | 1 | 注意：在协议头部之间还存在着一个字节的offset，这个字节的值为255 |
| IsSSLProtocol | 1 | 这个请求数据是一个SSL加密数据（使用用户的私有密匙） |
| IsSSL_PublicToken | 1 | 使用公共密匙 |
| IsPlantText | 1 | 这个数据仅仅是一个文本，没有包含有任何协议头数据 |
| IsSSLHandshaking | 1 | 这个请求数据是否为握手协议 |
| TryGetSystemProtocol | 1 | |
| IsPing | 1 |
04 Fields
| Name | Overloads | Summary |
|---|---|---|
| SYS_PROTOCOL | 2 | 系统里面最基本的基本数据协议 |
05 Members
Parameters
| Name | Type | Description |
|---|---|---|
protocolCategory | Int64 | - |
protocol | Int64 | - |
buffer | Byte() |
#ctor(
Int64, Int64)构建一个无参数的网络协议对象
Parameters
| Name | Type | Description |
|---|---|---|
ProtocolCategory | Int64 | - |
Protocol | Int64 | - |
#ctor(
Int64, Int64, String)The default text encoding is Encoding.UTF8
Parameters
| Name | Type | Description |
|---|---|---|
protocolCategory | Int64 | - |
protocol | Int64 | - |
strData | String | Protocol request argument parameters |
#ctor(
String)其余的协议参数都是值 HTTP_RFC.RFC_OK
Parameters
| Name | Type | Description |
|---|---|---|
data | String | - |
#ctor(Byte())
Deserialize (当还有剩余数据的时候会将数据进行剪裁)
Parameters
| Name | Type | Description |
|---|---|---|
rawStream | Byte() | - |
GetUTF8String
默认是使用UTF8编码来编码字符串的
Returns
这个函数总是返回一个不为空值的字符串
GetString(
Encoding)按照指定的编码构建出一个字符串值
Remarks
20240620
the string may contains may zero byte after the string data, so we needs to trim such zero bytes for avoid the possible string parser error.
Parameters
| Name | Type | Description |
|---|---|---|
encoding | Encoding | - |
Returns
这个函数总是返回一个不为空值的字符串
LoadObject``1(LoadObject(Of ``0))
将数据首先生成字符串，然后根据函数指针handler句柄的描述从字符串之中反序列化加载对象
Type Parameters
| Name | Description |
|---|---|
T |
Parameters
| Name | Type | Description |
|---|---|---|
handler | LoadObject(Of ``0) | - |
LoadObject``1
json
Type Parameters
| Name | Description |
|---|---|
T |
GetRawStream``1
从原始数据流RequestStream.ChunkBuffer之中进行反序列化得到一个嵌套的数据串流对象
Type Parameters
| Name | Description |
|---|---|
TStream |
CreateProtocol``1(
Int64, Int64, ``0)这个函数是使用json序列化参数信息的
Type Parameters
| Name | Description |
|---|---|
T |
Parameters
| Name | Type | Description |
|---|---|---|
category | Int64 | - |
protocol | Int64 | - |
params | ``0 | - |
CreatePackage``1(
``0)服务器端返回数据所使用的，默认使用json序列化，所有的标签为HTTP_RFC.RFC_OK
Type Parameters
| Name | Description |
|---|---|
T |
Parameters
| Name | Type | Description |
|---|---|---|
obj | ``0 | - |
CreatePackage(Byte())
服务器端返回数据所使用的，所有的标签为HTTP_RFC.RFC_OK
Parameters
| Name | Type | Description |
|---|---|---|
pack | Byte() | - |
Serialize(
Stream)执行序列化进行网络之间的数据传输
op_Equality(RequestStream, RequestStream)
简单的字符串等价
Parameters
| Name | Type | Description |
|---|---|---|
a | RequestStream | - |
b | RequestStream | - |
ProtocolCategory
This property indicates the protocol processor module for the server object.
Protocol
This property indicates which the specifics protocol processor will be used for the incoming client request. (协议的头部)
BufferLength
Buffer length of the protocol request raw stream data RequestStream.ChunkBuffer. (协议数据的长度)
ChunkBuffer
The raw stream data of the details data request or the server response data.
Remarks
(协议的具体数据请求)
FullRead
verify that the stream data in RequestStream.ChunkBuffer is recieve complete? (RequestStream.ChunkBuffer部分的数据是否完整？)
TotalBytes
注意：在协议头部之间还存在着一个字节的offset，这个字节的值为255
IsSSLProtocol
这个请求数据是一个SSL加密数据（使用用户的私有密匙）
IsSSL_PublicToken
使用公共密匙
IsPlantText
这个数据仅仅是一个文本，没有包含有任何协议头数据
IsSSLHandshaking
这个请求数据是否为握手协议
SYS_PROTOCOL
系统里面最基本的基本数据协议
SYS_PROTOCOL
TryGetSystemProtocol
IsPing
GetIntegers()
GetDoubles()
LoadObject(
Abstract+LoadObject(Of T))LoadObject()
GetRawStream()
ToString()
CreateProtocol(
Int64, Int64, T)IsAvaliableStream(Byte())
WriteBuffer(
Stream)SystemProtocol(
RequestStream+Protocols, String)op_Inequality(RequestStream, RequestStream)