Contructor/Destructor
GWENHYWFAR_API GWEN_HTTP_SESSION *	GWEN_HttpSession_new (const char url, const char defaultProto, int defaultPort)

GWENHYWFAR_API GWEN_HTTP_SESSION *	GWEN_HttpSession_fromSocketPassive (GWEN_SOCKET sk, const char proto, int port)

GWENHYWFAR_API void	GWEN_HttpSession_Attach (GWEN_HTTP_SESSION *sess)

GWENHYWFAR_API void	GWEN_HttpSession_free (GWEN_HTTP_SESSION *sess)

HTTP Setup Functions
Functions of this groups should be called before GWEN_HttpSession_Init because the information conveyed via these functions is needed upon initialisation.
GWENHYWFAR_API uint32_t	GWEN_HttpSession_GetFlags (const GWEN_HTTP_SESSION *sess)

GWENHYWFAR_API void	GWEN_HttpSession_SetFlags (GWEN_HTTP_SESSION *sess, uint32_t fl)

GWENHYWFAR_API void	GWEN_HttpSession_AddFlags (GWEN_HTTP_SESSION *sess, uint32_t fl)

GWENHYWFAR_API void	GWEN_HttpSession_SubFlags (GWEN_HTTP_SESSION *sess, uint32_t fl)

GWENHYWFAR_API const char *	GWEN_HttpSession_GetHttpUserAgent (const GWEN_HTTP_SESSION *sess)

GWENHYWFAR_API void	GWEN_HttpSession_SetHttpUserAgent (GWEN_HTTP_SESSION sess, const char s)

GWENHYWFAR_API const char *	GWEN_HttpSession_GetHttpContentType (const GWEN_HTTP_SESSION *sess)

GWENHYWFAR_API void	GWEN_HttpSession_SetHttpContentType (GWEN_HTTP_SESSION sess, const char s)

GWENHYWFAR_API int	GWEN_HttpSession_GetHttpVMajor (const GWEN_HTTP_SESSION *sess)

GWENHYWFAR_API void	GWEN_HttpSession_SetHttpVMajor (GWEN_HTTP_SESSION *sess, int i)

GWENHYWFAR_API int	GWEN_HttpSession_GetHttpVMinor (const GWEN_HTTP_SESSION *sess)

GWENHYWFAR_API void	GWEN_HttpSession_SetHttpVMinor (GWEN_HTTP_SESSION *sess, int i)

Initialisation and Deinitialisation
GWENHYWFAR_API int	GWEN_HttpSession_Init (GWEN_HTTP_SESSION *sess)

GWENHYWFAR_API int	GWEN_HttpSession_Fini (GWEN_HTTP_SESSION *sess)

Sending and Receiving
GWENHYWFAR_API int	GWEN_HttpSession_SendPacket (GWEN_HTTP_SESSION sess, const char httpCommand, const uint8_t *buf, uint32_t blen)

GWENHYWFAR_API int	GWEN_HttpSession_RecvPacket (GWEN_HTTP_SESSION sess, GWEN_BUFFER buf)

GWENHYWFAR_API int	GWEN_HttpSession_RecvPacketToFile (GWEN_HTTP_SESSION sess, const char fname)

GWENHYWFAR_API int	GWEN_HttpSession_ConnectionTest (GWEN_HTTP_SESSION *sess)

SyncIO Initialisation
After creating a connection layer (consisting of a chain of GWEN_SYNCIO's) this callback is called. AqBanking uses it to set the TLS-cert-checking callback for the TLS syncio part (GWEN_SyncIo_Tls_SetCheckCertFn), so whenever a TLS connection is established and a certificate received, that function is called.
typedef int GWENHYWFAR_CB(*	GWEN_HTTPSESSION_INITSYNCIO_FN) (GWEN_HTTP_SESSION sess, GWEN_SYNCIO sio)

GWENHYWFAR_API GWEN_HTTPSESSION_INITSYNCIO_FN	GWEN_HttpSession_SetInitSyncIoFn (GWEN_HTTP_SESSION *sess, GWEN_HTTPSESSION_INITSYNCIO_FN f)

Detailed Description

This module provides support for exchanging a HTTP(s) request.

Typedef Documentation

◆ GWEN_HTTPSESSION_INITSYNCIO_FN

typedef int GWENHYWFAR_CB(* GWEN_HTTPSESSION_INITSYNCIO_FN) (GWEN_HTTP_SESSION *sess, GWEN_SYNCIO *sio)

Definition at line 217 of file httpsession.h.

Function Documentation

◆ GWEN_HttpSession_AddFlags()

GWENHYWFAR_API void GWEN_HttpSession_AddFlags	(	GWEN_HTTP_SESSION *	sess,
		uint32_t	fl
	)

Definition at line 161 of file httpsession.c.

◆ GWEN_HttpSession_Attach()

GWENHYWFAR_API void GWEN_HttpSession_Attach ( GWEN_HTTP_SESSION * sess )

Definition at line 99 of file httpsession.c.

◆ GWEN_HttpSession_ConnectionTest()

GWENHYWFAR_API int GWEN_HttpSession_ConnectionTest ( GWEN_HTTP_SESSION * sess )

Test-connect to the server. This function can be used to retrieve the SSL certificate from a server as the cert exchange is part of the establishing of a connection. This function connects to the server and immediately disconnects.

Definition at line 705 of file httpsession.c.

References DBG_INFO, DBG_NOTICE, GWEN_ERROR_SSL, GWEN_Gui_ProgressLog(), GWEN_LOGDOMAIN, GWEN_LoggerLevel_Error, GWEN_LoggerLevel_Notice, GWEN_SyncIo_Connect(), GWEN_SyncIo_Disconnect(), and I18N.

Here is the call graph for this function:

◆ GWEN_HttpSession_Fini()

GWENHYWFAR_API int GWEN_HttpSession_Fini ( GWEN_HTTP_SESSION * sess )

Definition at line 352 of file httpsession.c.

References GWEN_SyncIo_Disconnect(), GWEN_SyncIo_free(), and NULL.

Here is the call graph for this function:

◆ GWEN_HttpSession_free()

GWENHYWFAR_API void GWEN_HttpSession_free ( GWEN_HTTP_SESSION * sess )

Definition at line 108 of file httpsession.c.

References GWEN_FREE_OBJECT, GWEN_INHERIT_FINI, and GWEN_SyncIo_free().

Referenced by GWEN_HttpSession_fromSocketPassive().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GWEN_HttpSession_fromSocketPassive()

GWENHYWFAR_API GWEN_HTTP_SESSION* GWEN_HttpSession_fromSocketPassive	(	GWEN_SOCKET *	sk,
		const char *	proto,
		int	port
	)

Create a server HTTP session using the given socket.

The caller is responsible for freeing the object returned (if any).

Returns: session object (NULL on error)

Parameters

sk	socket (received via GWEN_Socket_Accept), taken over
proto	protocol used by this server session (either "http" or "https")
port	port used by this server session (in ost cases 80 for HTTP, 443 for HTTPS)

Definition at line 59 of file httpsession.c.

References DBG_ERROR, GWEN_Gui_ExtendSyncIo(), GWEN_HTTP_SESSION_FLAGS_PASSIVE, GWEN_HttpSession_free(), GWEN_INHERIT_INIT, GWEN_LOGDOMAIN, GWEN_NEW_OBJECT, GWEN_SyncIo_AddFlags(), GWEN_SYNCIO_FLAGS_PASSIVE, GWEN_SyncIo_GetBaseIo(), GWEN_SyncIo_Socket_TakeOver(), and NULL.

Here is the call graph for this function:

◆ GWEN_HttpSession_GetFlags()

GWENHYWFAR_API uint32_t GWEN_HttpSession_GetFlags ( const GWEN_HTTP_SESSION * sess )

Definition at line 141 of file httpsession.c.

◆ GWEN_HttpSession_GetHttpContentType()

GWENHYWFAR_API const char* GWEN_HttpSession_GetHttpContentType ( const GWEN_HTTP_SESSION * sess )

Definition at line 205 of file httpsession.c.

◆ GWEN_HttpSession_GetHttpUserAgent()

GWENHYWFAR_API const char* GWEN_HttpSession_GetHttpUserAgent ( const GWEN_HTTP_SESSION * sess )

Definition at line 181 of file httpsession.c.

◆ GWEN_HttpSession_GetHttpVMajor()

GWENHYWFAR_API int GWEN_HttpSession_GetHttpVMajor ( const GWEN_HTTP_SESSION * sess )

Definition at line 229 of file httpsession.c.

◆ GWEN_HttpSession_GetHttpVMinor()

GWENHYWFAR_API int GWEN_HttpSession_GetHttpVMinor ( const GWEN_HTTP_SESSION * sess )

Definition at line 249 of file httpsession.c.

◆ GWEN_HttpSession_Init()

GWENHYWFAR_API int GWEN_HttpSession_Init ( GWEN_HTTP_SESSION * sess )

◆ GWEN_HttpSession_new()

GWENHYWFAR_API GWEN_HTTP_SESSION* GWEN_HttpSession_new	(	const char *	url,
		const char *	defaultProto,
		int	defaultPort
	)

Create a client HTTP session (i.e. used to connect to a server).

The caller is responsible for freeing the object returned (if any).

Returns: session object (NULL on error)

Parameters

url	URL of the server to connect to later
defaultProto	default protocol if not specified by the given url (e.g. "https")
defaultPort	default TCP port if not specified by the given url

Definition at line 40 of file httpsession.c.

References GWEN_INHERIT_INIT, and GWEN_NEW_OBJECT.

◆ GWEN_HttpSession_RecvPacket()

GWENHYWFAR_API int GWEN_HttpSession_RecvPacket	(	GWEN_HTTP_SESSION *	sess,
		GWEN_BUFFER *	buf
	)

This function receives a response packet from the server and closes the connection. It expects the connection to be established by GWEN_HttpSession_SendPacket().

Definition at line 528 of file httpsession.c.

References DBG_INFO, GWEN_Buffer_Crop(), GWEN_Buffer_GetPos(), GWEN_Gui_ProgressLog(), GWEN_HttpSession__RecvPacket(), GWEN_LOGDOMAIN, GWEN_LoggerLevel_Debug, GWEN_SyncIo_Disconnect(), and I18N.

Here is the call graph for this function:

◆ GWEN_HttpSession_RecvPacketToFile()

GWENHYWFAR_API int GWEN_HttpSession_RecvPacketToFile	(	GWEN_HTTP_SESSION *	sess,
		const char *	fname
	)

Definition at line 625 of file httpsession.c.

References DBG_INFO, GWEN_Gui_ProgressLog(), GWEN_HttpSession__RecvPacketToSio(), GWEN_LOGDOMAIN, GWEN_LoggerLevel_Debug, GWEN_SyncIo_AddFlags(), GWEN_SyncIo_Connect(), GWEN_SyncIo_Disconnect(), GWEN_SyncIo_File_CreationMode_CreateAlways, GWEN_SYNCIO_FILE_FLAGS_GREAD, GWEN_SYNCIO_FILE_FLAGS_GWRITE, GWEN_SYNCIO_FILE_FLAGS_READ, GWEN_SYNCIO_FILE_FLAGS_UREAD, GWEN_SYNCIO_FILE_FLAGS_UWRITE, GWEN_SYNCIO_FILE_FLAGS_WRITE, GWEN_SyncIo_File_new(), GWEN_SyncIo_Flush(), GWEN_SyncIo_free(), and I18N.

Here is the call graph for this function:

◆ GWEN_HttpSession_SendPacket()

GWENHYWFAR_API int GWEN_HttpSession_SendPacket	(	GWEN_HTTP_SESSION *	sess,
		const char *	httpCommand,
		const uint8_t *	buf,
		uint32_t	blen
	)

This function connects to the server and then sends the given message. The buffer given as argument to this function must only contain the raw data (i.e. the HTTP body, no header).

Parameters

sess	http session object
httpCommand	HTTP command to send (e.g. "GET", "POST")
buf	pointer to the http body data to send
blen	size of the http body data to send (might be 0)

Definition at line 368 of file httpsession.c.

References DBG_INFO, DBG_NOTICE, GWEN_DB_FLAGS_OVERWRITE_VARS, GWEN_DB_SetCharValue(), GWEN_DB_SetIntValue(), GWEN_ERROR_SSL, GWEN_Gui_ProgressLog(), GWEN_Gui_ProgressLog2(), GWEN_LOGDOMAIN, GWEN_LoggerLevel_Debug, GWEN_LoggerLevel_Error, GWEN_SyncIo_Connect(), GWEN_SyncIo_Disconnect(), GWEN_SyncIo_Http_GetDbCommandOut(), GWEN_SyncIo_Http_GetDbHeaderOut(), GWEN_SyncIo_WriteForced(), and I18N.

Here is the call graph for this function:

◆ GWEN_HttpSession_SetFlags()

GWENHYWFAR_API void GWEN_HttpSession_SetFlags	(	GWEN_HTTP_SESSION *	sess,
		uint32_t	fl
	)

Definition at line 151 of file httpsession.c.

◆ GWEN_HttpSession_SetHttpContentType()

GWENHYWFAR_API void GWEN_HttpSession_SetHttpContentType	(	GWEN_HTTP_SESSION *	sess,
		const char *	s
	)

Definition at line 215 of file httpsession.c.

References NULL.

◆ GWEN_HttpSession_SetHttpUserAgent()

GWENHYWFAR_API void GWEN_HttpSession_SetHttpUserAgent	(	GWEN_HTTP_SESSION *	sess,
		const char *	s
	)

Definition at line 191 of file httpsession.c.

References NULL.

◆ GWEN_HttpSession_SetHttpVMajor()

GWENHYWFAR_API void GWEN_HttpSession_SetHttpVMajor	(	GWEN_HTTP_SESSION *	sess,
		int	i
	)

Definition at line 239 of file httpsession.c.

◆ GWEN_HttpSession_SetHttpVMinor()

GWENHYWFAR_API void GWEN_HttpSession_SetHttpVMinor	(	GWEN_HTTP_SESSION *	sess,
		int	i
	)

Definition at line 259 of file httpsession.c.

◆ GWEN_HttpSession_SetInitSyncIoFn()

GWENHYWFAR_API GWEN_HTTPSESSION_INITSYNCIO_FN GWEN_HttpSession_SetInitSyncIoFn	(	GWEN_HTTP_SESSION *	sess,
		GWEN_HTTPSESSION_INITSYNCIO_FN	f
	)

Definition at line 129 of file httpsession.c.

◆ GWEN_HttpSession_SubFlags()

GWENHYWFAR_API void GWEN_HttpSession_SubFlags	(	GWEN_HTTP_SESSION *	sess,
		uint32_t	fl
	)

Definition at line 171 of file httpsession.c.

Contructor/Destructor

HTTP Setup Functions

Initialisation and Deinitialisation

Sending and Receiving

SyncIO Initialisation

Detailed Description

Typedef Documentation

◆ GWEN_HTTPSESSION_INITSYNCIO_FN

Function Documentation

◆ GWEN_HttpSession_AddFlags()

◆ GWEN_HttpSession_Attach()

◆ GWEN_HttpSession_ConnectionTest()

◆ GWEN_HttpSession_Fini()

◆ GWEN_HttpSession_free()

◆ GWEN_HttpSession_fromSocketPassive()

◆ GWEN_HttpSession_GetFlags()

◆ GWEN_HttpSession_GetHttpContentType()

◆ GWEN_HttpSession_GetHttpUserAgent()

◆ GWEN_HttpSession_GetHttpVMajor()

◆ GWEN_HttpSession_GetHttpVMinor()

◆ GWEN_HttpSession_Init()

◆ GWEN_HttpSession_new()

◆ GWEN_HttpSession_RecvPacket()

◆ GWEN_HttpSession_RecvPacketToFile()

◆ GWEN_HttpSession_SendPacket()

◆ GWEN_HttpSession_SetFlags()

◆ GWEN_HttpSession_SetHttpContentType()

◆ GWEN_HttpSession_SetHttpUserAgent()

◆ GWEN_HttpSession_SetHttpVMajor()

◆ GWEN_HttpSession_SetHttpVMinor()

◆ GWEN_HttpSession_SetInitSyncIoFn()

◆ GWEN_HttpSession_SubFlags()