338 lines
11 KiB
C
338 lines
11 KiB
C
|
/*
|
|||
|
|
* Copyright: JessMA Open Source (ldcsaa@gmail.com)
|
|||
|
|
*
|
|||
|
|
* Author : Bruce Liang
|
|||
|
|
* Website : https://github.com/ldcsaa
|
|||
|
|
* Project : https://github.com/ldcsaa/HP-Socket
|
|||
|
|
* Blog : http://www.cnblogs.com/ldcsaa
|
|||
|
|
* Wiki : http://www.oschina.net/p/hp-socket
|
|||
|
|
* QQ Group : 44636872, 75375912
|
|||
|
|
*
|
|||
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|||
|
|
* you may not use this file except in compliance with the License.
|
|||
|
|
* You may obtain a copy of the License at
|
|||
|
|
*
|
|||
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|||
|
|
*
|
|||
|
|
* Unless required by applicable law or agreed to in writing, software
|
|||
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|||
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|||
|
|
* See the License for the specific language governing permissions and
|
|||
|
|
* limitations under the License.
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
#pragma once
|
|||
|
|
|
|||
|
|
#include "HPSocket.h"
|
|||
|
|
|
|||
|
|
#ifdef _SSL_SUPPORT
|
|||
|
|
|
|||
|
|
/*****************************************************************************************************************************************************/
|
|||
|
|
/******************************************************************** SSL Exports ********************************************************************/
|
|||
|
|
/*****************************************************************************************************************************************************/
|
|||
|
|
|
|||
|
|
/**************************************************/
|
|||
|
|
/************** HPSocket-SSL 导出函数 **************/
|
|||
|
|
|
|||
|
|
// 创建 SSL ITcpServer 对象
|
|||
|
|
HPSOCKET_API ITcpServer* HP_Create_SSLServer(ITcpServerListener* pListener);
|
|||
|
|
// 创建 SSL ITcpAgent 对象
|
|||
|
|
HPSOCKET_API ITcpAgent* HP_Create_SSLAgent(ITcpAgentListener* pListener);
|
|||
|
|
// 创建 SSL ITcpClient 对象
|
|||
|
|
HPSOCKET_API ITcpClient* HP_Create_SSLClient(ITcpClientListener* pListener);
|
|||
|
|
// 创建 SSL ITcpPullServer 对象
|
|||
|
|
HPSOCKET_API ITcpPullServer* HP_Create_SSLPullServer(ITcpServerListener* pListener);
|
|||
|
|
// 创建 SSL ITcpPullAgent 对象
|
|||
|
|
HPSOCKET_API ITcpPullAgent* HP_Create_SSLPullAgent(ITcpAgentListener* pListener);
|
|||
|
|
// 创建 SSL ITcpPullClient 对象
|
|||
|
|
HPSOCKET_API ITcpPullClient* HP_Create_SSLPullClient(ITcpClientListener* pListener);
|
|||
|
|
// 创建 SSL ITcpPackServer 对象
|
|||
|
|
HPSOCKET_API ITcpPackServer* HP_Create_SSLPackServer(ITcpServerListener* pListener);
|
|||
|
|
// 创建 SSL ITcpPackAgent 对象
|
|||
|
|
HPSOCKET_API ITcpPackAgent* HP_Create_SSLPackAgent(ITcpAgentListener* pListener);
|
|||
|
|
// 创建 SSL ITcpPackClient 对象
|
|||
|
|
HPSOCKET_API ITcpPackClient* HP_Create_SSLPackClient(ITcpClientListener* pListener);
|
|||
|
|
|
|||
|
|
// 销毁 SSL ITcpServer 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_SSLServer(ITcpServer* pServer);
|
|||
|
|
// 销毁 SSL ITcpAgent 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_SSLAgent(ITcpAgent* pAgent);
|
|||
|
|
// 销毁 SSL ITcpClient 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_SSLClient(ITcpClient* pClient);
|
|||
|
|
// 销毁 SSL ITcpPullServer 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_SSLPullServer(ITcpPullServer* pServer);
|
|||
|
|
// 销毁 SSL ITcpPullAgent 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_SSLPullAgent(ITcpPullAgent* pAgent);
|
|||
|
|
// 销毁 SSL ITcpPullClient 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_SSLPullClient(ITcpPullClient* pClient);
|
|||
|
|
// 销毁 SSL ITcpPackServer 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_SSLPackServer(ITcpPackServer* pServer);
|
|||
|
|
// 销毁 SSL ITcpPackAgent 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_SSLPackAgent(ITcpPackAgent* pAgent);
|
|||
|
|
// 销毁 SSL ITcpPackClient 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_SSLPackClient(ITcpPackClient* pClient);
|
|||
|
|
|
|||
|
|
// SSL ITcpServer 对象创建器
|
|||
|
|
struct SSLServer_Creator
|
|||
|
|
{
|
|||
|
|
static ITcpServer* Create(ITcpServerListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_SSLServer(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(ITcpServer* pServer)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_SSLServer(pServer);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// SSL ITcpAgent 对象创建器
|
|||
|
|
struct SSLAgent_Creator
|
|||
|
|
{
|
|||
|
|
static ITcpAgent* Create(ITcpAgentListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_SSLAgent(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(ITcpAgent* pAgent)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_SSLAgent(pAgent);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// SSL ITcpClient 对象创建器
|
|||
|
|
struct SSLClient_Creator
|
|||
|
|
{
|
|||
|
|
static ITcpClient* Create(ITcpClientListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_SSLClient(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(ITcpClient* pClient)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_SSLClient(pClient);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// SSL ITcpPullServer 对象创建器
|
|||
|
|
struct SSLPullServer_Creator
|
|||
|
|
{
|
|||
|
|
static ITcpPullServer* Create(ITcpServerListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_SSLPullServer(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(ITcpPullServer* pServer)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_SSLPullServer(pServer);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// SSL ITcpPullAgent 对象创建器
|
|||
|
|
struct SSLPullAgent_Creator
|
|||
|
|
{
|
|||
|
|
static ITcpPullAgent* Create(ITcpAgentListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_SSLPullAgent(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(ITcpPullAgent* pAgent)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_SSLPullAgent(pAgent);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// SSL ITcpPullClient 对象创建器
|
|||
|
|
struct SSLPullClient_Creator
|
|||
|
|
{
|
|||
|
|
static ITcpPullClient* Create(ITcpClientListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_SSLPullClient(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(ITcpPullClient* pClient)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_SSLPullClient(pClient);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// SSL ITcpPackServer 对象创建器
|
|||
|
|
struct SSLPackServer_Creator
|
|||
|
|
{
|
|||
|
|
static ITcpPackServer* Create(ITcpServerListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_SSLPackServer(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(ITcpPackServer* pServer)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_SSLPackServer(pServer);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// SSL ITcpPackAgent 对象创建器
|
|||
|
|
struct SSLPackAgent_Creator
|
|||
|
|
{
|
|||
|
|
static ITcpPackAgent* Create(ITcpAgentListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_SSLPackAgent(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(ITcpPackAgent* pAgent)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_SSLPackAgent(pAgent);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// SSL ITcpPackClient 对象创建器
|
|||
|
|
struct SSLPackClient_Creator
|
|||
|
|
{
|
|||
|
|
static ITcpPackClient* Create(ITcpClientListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_SSLPackClient(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(ITcpPackClient* pClient)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_SSLPackClient(pClient);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// SSL ITcpServer 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<ITcpServer, ITcpServerListener, SSLServer_Creator> CSSLServerPtr;
|
|||
|
|
// SSL ITcpAgent 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<ITcpAgent, ITcpAgentListener, SSLAgent_Creator> CSSLAgentPtr;
|
|||
|
|
// SSL ITcpClient 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<ITcpClient, ITcpClientListener, SSLClient_Creator> CSSLClientPtr;
|
|||
|
|
// SSL ITcpPullServer 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<ITcpPullServer, ITcpServerListener, SSLPullServer_Creator> CSSLPullServerPtr;
|
|||
|
|
// SSL ITcpPullAgent 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<ITcpPullAgent, ITcpAgentListener, SSLPullAgent_Creator> CSSLPullAgentPtr;
|
|||
|
|
// SSL ITcpPullClient 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<ITcpPullClient, ITcpClientListener, SSLPullClient_Creator> CSSLPullClientPtr;
|
|||
|
|
// SSL ITcpPackServer 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<ITcpPackServer, ITcpServerListener, SSLPackServer_Creator> CSSLPackServerPtr;
|
|||
|
|
// SSL ITcpPackAgent 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<ITcpPackAgent, ITcpAgentListener, SSLPackAgent_Creator> CSSLPackAgentPtr;
|
|||
|
|
// SSL ITcpPackClient 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<ITcpPackClient, ITcpClientListener, SSLPackClient_Creator> CSSLPackClientPtr;
|
|||
|
|
|
|||
|
|
/*****************************************************************************************************************************************************/
|
|||
|
|
/*************************************************************** Global Function Exports *************************************************************/
|
|||
|
|
/*****************************************************************************************************************************************************/
|
|||
|
|
|
|||
|
|
/*
|
|||
|
|
* 名称：SNI 默认回调函数
|
|||
|
|
* 描述：SSL Server 的 SetupSSLContext 方法中如果不指定 SNI 回调函数则使用此 SNI 默认回调函数
|
|||
|
|
*
|
|||
|
|
* 参数： lpszServerName -- 请求域名
|
|||
|
|
* pContext -- SSL Context 对象
|
|||
|
|
*
|
|||
|
|
* 返回值：SNI 主机证书对应的索引
|
|||
|
|
*/
|
|||
|
|
HPSOCKET_API int __HP_CALL HP_SSL_DefaultServerNameCallback(LPCTSTR lpszServerName, PVOID pContext);
|
|||
|
|
|
|||
|
|
/*
|
|||
|
|
* 名称：清理线程局部环境 SSL 资源
|
|||
|
|
* 描述：任何一个操作 SSL 的线程，通信结束时都需要清理线程局部环境 SSL 资源
|
|||
|
|
* 1、主线程和 HP-Socket 工作线程在通信结束时会自动清理线程局部环境 SSL 资源。因此，一般情况下不必手工调用本方法
|
|||
|
|
* 2、特殊情况下，当自定义线程参与 HP-Socket 通信操作并检查到 SSL 内存泄漏时，需在每次通信结束时自定义线程调用本方法
|
|||
|
|
*
|
|||
|
|
* 参数： dwThreadID -- 线程 ID（0：当前线程）
|
|||
|
|
*
|
|||
|
|
* 返回值：无
|
|||
|
|
*/
|
|||
|
|
HPSOCKET_API void HP_SSL_RemoveThreadLocalState(THR_ID dwThreadID);
|
|||
|
|
|
|||
|
|
/*****************************************************************************************************************************************************/
|
|||
|
|
/******************************************************************** HTTPS Exports ******************************************************************/
|
|||
|
|
/*****************************************************************************************************************************************************/
|
|||
|
|
|
|||
|
|
#ifdef _HTTP_SUPPORT
|
|||
|
|
|
|||
|
|
// 创建 IHttpsServer 对象
|
|||
|
|
HPSOCKET_API IHttpServer* HP_Create_HttpsServer(IHttpServerListener* pListener);
|
|||
|
|
// 创建 IHttpsAgent 对象
|
|||
|
|
HPSOCKET_API IHttpAgent* HP_Create_HttpsAgent(IHttpAgentListener* pListener);
|
|||
|
|
// 创建 IHttpsClient 对象
|
|||
|
|
HPSOCKET_API IHttpClient* HP_Create_HttpsClient(IHttpClientListener* pListener);
|
|||
|
|
// 创建 IHttpsSyncClient 对象
|
|||
|
|
HPSOCKET_API IHttpSyncClient* HP_Create_HttpsSyncClient(IHttpClientListener* pListener = nullptr);
|
|||
|
|
|
|||
|
|
// 销毁 IHttpsServer 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_HttpsServer(IHttpServer* pServer);
|
|||
|
|
// 销毁 IHttpsAgent 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_HttpsAgent(IHttpAgent* pAgent);
|
|||
|
|
// 销毁 IHttpsClient 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_HttpsClient(IHttpClient* pClient);
|
|||
|
|
// 销毁 IHttpsSyncClient 对象
|
|||
|
|
HPSOCKET_API void HP_Destroy_HttpsSyncClient(IHttpSyncClient* pClient);
|
|||
|
|
|
|||
|
|
// IHttpsServer 对象创建器
|
|||
|
|
struct HttpsServer_Creator
|
|||
|
|
{
|
|||
|
|
static IHttpServer* Create(IHttpServerListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_HttpsServer(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(IHttpServer* pServer)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_HttpsServer(pServer);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// IHttpsAgent 对象创建器
|
|||
|
|
struct HttpsAgent_Creator
|
|||
|
|
{
|
|||
|
|
static IHttpAgent* Create(IHttpAgentListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_HttpsAgent(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(IHttpAgent* pAgent)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_HttpsAgent(pAgent);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// IHttpsClient 对象创建器
|
|||
|
|
struct HttpsClient_Creator
|
|||
|
|
{
|
|||
|
|
static IHttpClient* Create(IHttpClientListener* pListener)
|
|||
|
|
{
|
|||
|
|
return HP_Create_HttpsClient(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(IHttpClient* pClient)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_HttpsClient(pClient);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// IHttpsSyncClient 对象创建器
|
|||
|
|
struct HttpsSyncClient_Creator
|
|||
|
|
{
|
|||
|
|
static IHttpSyncClient* Create(IHttpClientListener* pListener = nullptr)
|
|||
|
|
{
|
|||
|
|
return HP_Create_HttpsSyncClient(pListener);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
static void Destroy(IHttpSyncClient* pClient)
|
|||
|
|
{
|
|||
|
|
HP_Destroy_HttpsSyncClient(pClient);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// IHttpsServer 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<IHttpServer, IHttpServerListener, HttpsServer_Creator> CHttpsServerPtr;
|
|||
|
|
// IHttpsAgent 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<IHttpAgent, IHttpAgentListener, HttpsAgent_Creator> CHttpsAgentPtr;
|
|||
|
|
// IHttpsClient 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<IHttpClient, IHttpClientListener, HttpsClient_Creator> CHttpsClientPtr;
|
|||
|
|
// IHttpsSyncClient 对象智能指针
|
|||
|
|
typedef CHPObjectPtr<IHttpSyncClient, IHttpClientListener, HttpsSyncClient_Creator> CHttpsSyncClientPtr;
|
|||
|
|
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
#endif
|