HPSocket.Net 5.8.1-beta1

HPSocket.Net

Overview

the C# SDK for HP-Socket

.Net Framework Supported

• .Net Framework 2.0+
• .Net Core 2.0+
• .Net 5.0

Platform supported

• Windows 7+ x86/x64
• Linux kernel 2.6.32+ x86/x64
• mac OS 10.12+ x64
• Raspberry Pi 4B

About macOS

HPSocket.Net now supports development using.net core2.0 +inosx 10.12 +

Libhpsocket4c.dylib in Nuget package is compiled from HP-Socket-for-macOS

Components List

Basic Components

Basic component is the original component provided by HP-Socket. For related usage, please refer to HP-Socket Doc

TCP

• ITcpServer
• ITcpAgent
• ITcpClient
• ITcpPullServer
• ITcpPullAgent
• ITcpPullClient
• ITcpPackServer
• ITcpPackAgent
• ITcpPacClient

UDP

• IUdpServer
• IUdpClient
• IUdpCast
• IUdpArqServer
• IUdpArqClient
• IUdpNode

SSL

• ISslServer
• ISslAgent
• ISslClient
• ISslPullServer
• ISslPullAgent
• ISslPullClient
• ISslPackServer
• ISslPackAgent
• ISslPackClient

HTTP

• IHttpServer
• IHttpsServer
• IHttpAgent
• IHttpsAgent
• IHttpClient
• IHttpsClient
• IHttpSyncClient
• IHttpsSyncClient

ThreadPool

• ThreadPool

Extended components

• ITcpPortForwarding
• IHttpEasyServer
• IHttpsEasyServer
• IHttpEasyAgent
• IHttpsEasyAgent
• IHttpEasyClient
• IHttpsEasyClient
• IWebSocketServer
• IWebSocketAgent

HPSocket.Net provides a TCP port forwarding component ITcpPortForwarding, 10 lines of code can complete TCP port forwarding.

HPSocket.Net currently provides 6 Easy components and 2 WebSocket components for easier processing of http / https / ws data packets. The basic http components provided by HP-Socket need to implement the data packets themselves. Complete acquisition, Easy component has done these processing, http / https Easy component is bound to the following events, when the event arrives, you can get the complete data packet.

• OnEasyChunkData Complete packet event for http CHUNK message
• OnEasyMessageData Complete packet event for http GET or POST message
• OnEasyWebSocketMessageData Complete packet event for WebSocket message

WebSocket can also use the following two components directly

• IWebSocketServer WebSocket Server
• IWebSocketAgent WebSocket Client (Unlike other Agent components, the WebSocket Agent component does not support connecting to different WebSocket Servers, which means that all connections of the IWebSocketAgent component can only connect to the same server)

Instructions

1. For the use of most components, please refer to the project in the demo directory.
2. In addition to the Pack series model, the Agent series components provided by HPSocket.Net (including the ITcpPortForwarding component) support to setting HTTP or Socks5 proxy, which can be set in the manner ofList<IProxy>. Multiple proxies can be set at the same time, which will be used randomly, and can be mixed with HTTP and Socks5 proxy at the same time. For the usage method, refer to the demo of each Agent component.

Easy component event binding example

IHttpEasyServer

// Create HttpEasyServer instance
using(IHttpEasyServer httpServer = new HttpEasyServer())
{
    // ... other settings

    // Binding OnEasyMessageData event
    httpServer.OnEasyMessageData += (sender, id, data) => 
    {
        // The data parameter is a complete packet each time
        // ... Process data

        return HttpParseResult.Ok;
    };
}

IHttpEasyAgent

// Create HttpEasyAgent instance
using(IHttpEasyAgent httpAgent = new HttpEasyAgent())
{
    // ... other settings

    // Binding OnEasyMessageData event
    httpAgent.OnEasyMessageData += (sender, id, data) => 
    {
        // The data parameter is a complete packet each time
        // ... Process data

        return HttpParseResult.Ok;
    };
}

IHttpEasyClient

// Create HttpEasyClient instance
using(IHttpEasyClient httpClient = new HttpEasyClient())
{
    // ... other settings

    // Binding OnEasyMessageData event
    httpClient.OnEasyMessageData += (sender, data) => 
    {
        // The data parameter is a complete packet each time
        // ... Process data

        return HttpParseResult.Ok;
    };
}