Merge pull request #1 from ldcsaa/master

.gitattributes

@@ -0,0 +1,65 @@
+###############################################################################
+# Set default behavior to automatically normalize line endings.
+###############################################################################
+* text=auto
+
+###############################################################################
+# Set default behavior for command prompt diff.
+#
+# This is need for earlier builds of msysgit that does not have it on by
+# default for csharp files.
+# Note: This is only used by command line
+###############################################################################
+#*.cs     diff=csharp
+
+###############################################################################
+# Set the merge driver for project and solution files
+#
+# Merging from the command prompt will add diff markers to the files if there
+# are conflicts (Merging from VS is not affected by the settings below, in VS
+# the diff markers are never inserted). Diff markers may cause the following 
+# file extensions to fail to load in VS. An alternative would be to treat
+# these files as binary and thus will always conflict and require user
+# intervention with every merge. To do so, just uncomment the entries below
+###############################################################################
+#*.sln       merge=binary
+#*.csproj    merge=binary
+#*.vbproj    merge=binary
+#*.vcxproj   merge=binary
+#*.vcproj    merge=binary
+#*.dbproj    merge=binary
+#*.fsproj    merge=binary
+#*.lsproj    merge=binary
+#*.wixproj   merge=binary
+#*.modelproj merge=binary
+#*.sqlproj   merge=binary
+#*.wwaproj   merge=binary
+
+###############################################################################
+# behavior for image files
+#
+# image files are treated as binary by default.
+###############################################################################
+#*.jpg   binary
+#*.png   binary
+#*.gif   binary
+
+###############################################################################
+# diff behavior for common document formats
+# 
+# Convert binary document formats to text before diffing them. This feature
+# is only available from the command line. Turn it on by uncommenting the 
+# entries below.
+###############################################################################
+#*.doc   diff=astextplain
+#*.DOC   diff=astextplain
+#*.docx  diff=astextplain
+#*.DOCX  diff=astextplain
+#*.dot   diff=astextplain
+#*.DOT   diff=astextplain
+#*.pdf   diff=astextplain
+#*.PDF   diff=astextplain
+#*.rtf   diff=astextplain
+#*.RTF   diff=astextplain
+
+*.sh text eol=lf

.gitignore

@@ -1,13 +1,53 @@
-# Compiled Object files
+# Compiled Object files
 *.slo
 *.lo
 *.o
+*.pdb
+*.exp
+*.idb
+*.ipdb
+*.iobj
+*.ilk
+*.obj
+*.log
+*.tlog
+*.cki
+*.exe.config
 
 # Compiled Dynamic libraries
-*.so
-*.dylib
+#*.so
+#*.dylib
 
 # Compiled Static libraries
-*.lai
-*.la
-*.a
+#*.lai
+#*.la
+#*.a
+
+# Intermediate directorys
+Static/
+static/
+Debug/
+debug/
+!Windows/Common/Src/Debug/
+!Windows/Common/Src/debug/
+!Windows/Other Languages/C#/HPSocketCS/bin/x86/Debug/
+!Windows/Other Languages/C#/HPSocketCS/bin/x64/Debug/
+Obj/
+obj/
+tlog/
+log/
+readme/
+
+# IDE Internal Files
+*.xml
+*.layout
+*.sdf
+*.VC.db
+*.opendb
+*.aps
+*.swp
+*.suo
+.vs/
+
+# include directory symbolic link files
+Linux/lib/**/*.so.*

Doc/Example.c

@@ -0,0 +1,48 @@
+#include <hpsocket/HPSocket4C.h>
+
+// 5. process network events
+EnHandleResult __HP_CALL OnConnect(HP_Agent pSender, HP_CONNID dwConnID);
+EnHandleResult __HP_CALL OnReceive(HP_Agent pSender, HP_CONNID dwConnID, int iLength);
+EnHandleResult __HP_CALL OnSend(HP_Agent pSender, HP_CONNID dwConnID, const BYTE* pData, int iLength);
+EnHandleResult __HP_CALL OnClose(HP_Agent pSender, HP_CONNID dwConnID, En_HP_SocketOperation enOperation, int iErrorCode);
+EnHandleResult __HP_CALL OnShutdown(HP_Agent pSender);
+
+int main(int argc, char* const argv[])
+{
+	HP_TcpPullAgentListener s_listener;
+	HP_TcpPullAgent s_agent;
+
+	// 1. Create listener object
+	s_listener	= ::Create_HP_TcpPullAgentListener();
+	// 2. Create component object (and binding with listener object)
+	s_agent		= ::Create_HP_TcpPullAgent(s_listener);
+
+	/* Set listener callbacks */
+	::HP_Set_FN_Agent_OnConnect(s_listener, OnConnect);
+	::HP_Set_FN_Agent_OnSend(s_listener, OnSend);
+	::HP_Set_FN_Agent_OnPullReceive(s_listener, OnReceive);
+	::HP_Set_FN_Agent_OnClose(s_listener, OnClose);
+	::HP_Set_FN_Agent_OnShutdown(s_listener, OnShutdown);
+
+	// 3. Start component object
+	if(::HP_Agent_HasStarted(s_agent))
+		exit(1);
+
+	// 4. Connect to dest host
+	::HP_Agent_Connect(s_agent, "remote.host.1", REMOTE_PORT_1, nullptr);
+	::HP_Agent_Connect(s_agent, "remote.host.2", REMOTE_PORT_2, nullptr);
+	::HP_Agent_Connect(s_agent, "remote.host.3", REMOTE_PORT_3, nullptr);
+
+	/* wait for exit */
+	// ... ... 
+
+	// 6. (optional) Stop component object
+	::HP_Agent_Stop(s_agent);
+
+	// 7. Destroy component object
+	::Destroy_HP_TcpPullAgent(s_agent);
+	// 8. Destroy listener object
+	::Destroy_HP_TcpPullAgentListener(s_listener);
+
+	return 0;
+}

Doc/Example.cpp

@@ -0,0 +1,39 @@
+#include <hpsocket/HPSocket.h>
+
+/* Listener Class */
+class CListenerImpl : public CTcpPullServerListener
+{
+
+public:
+	// 5. process network events
+	virtual EnHandleResult OnPrepareListen(ITcpServer* pSender, SOCKET soListen);
+	virtual EnHandleResult OnAccept(ITcpServer* pSender, CONNID dwConnID, UINT_PTR soClient);
+	virtual EnHandleResult OnHandShake(ITcpServer* pSender, CONNID dwConnID);
+	virtual EnHandleResult OnReceive(ITcpServer* pSender, CONNID dwConnID, int iLength);
+	virtual EnHandleResult OnSend(ITcpServer* pSender, CONNID dwConnID, const BYTE* pData, int iLength);
+	virtual EnHandleResult OnClose(ITcpServer* pSender, CONNID dwConnID, EnSocketOperation enOperation, int iErrorCode);
+	virtual EnHandleResult OnShutdown(ITcpServer* pSender);
+};
+
+int main(int argc, char* const argv[])
+{
+	// 1. Create listener object
+	CListenerImpl s_listener;
+	// 2. Create component object (and binding with listener object)
+	CTcpPullServerPtr s_pserver(&s_listener);
+
+	// 3. Start component object
+	if(!s_pserver->Start("0.0.0.0", 5555))
+		exit(1);
+
+	/* wait for exit */
+	// ... ... 
+
+	// 6. (optional) Stop component object
+	s_pserver->Stop();
+
+	return 0;
+
+	// 7. Destroy component object automatically
+	// 8. Destroy listener object automatically
+}