Delphi DLL

Debugging with Socket Session Logging

See more Socket/SSL/TLS Examples

Debugging with socket session logging.

The Chilkat Socket component provides properties for keeping a session log making it possible to see the exact bytes received and sent on a TCP/IP or SSL connection. To enable session logging, set the KeepSessionLog property = _TRUE_. The SessionLogEncoding property controls how binary, non-printable bytes are represented in the log. There are two possible settings: Possible values are "esc" and "hex". The default value is "esc".

When set to "hex", the bytes are encoded as a hexidecimalized string. The "esc" encoding is a C-string like encoding, and is more compact than hex if most of the data to be logged is text. Printable us-ascii chars are unmodified. Common "C" control chars are represented as "\r", "\n", "\t", etc. Non-printable and byte values greater than 0x80 are escaped using a backslash and hex encoding: \xHH. Certain printable chars are backslashed: SPACE, double-quote, single-quote, etc.

Delphi DLL

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Socket;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
socket: HCkSocket;
ssl: Boolean;
maxWaitMillisec: Integer;
httpGet: PWideChar;
httpHeader: PWideChar;

begin
success := False;

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

socket := CkSocket_Create();

// Enable session logging:
CkSocket_putKeepSessionLog(socket,True);
CkSocket_putSessionLogEncoding(socket,'esc');

// To demonstrate session logging, we'll connect to an
// HTTP server and download the HTTP response header:
ssl := False;
maxWaitMillisec := 20000;
success := CkSocket_Connect(socket,'www.chilkatsoft.com',80,ssl,maxWaitMillisec);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSocket__lastErrorText(socket));
    Exit;
  end;

// Set maximum timeouts for reading an writing (in millisec)
CkSocket_putMaxReadIdleMs(socket,10000);
CkSocket_putMaxSendIdleMs(socket,10000);

// The socket component includes a BuildHttpGetRequest
// method for convenience. Build a GET and send it to 
// the web server:

httpGet := CkSocket__buildHttpGetRequest(socket,'http://www.chilkatsoft.com/');

// Send it...
success := CkSocket_SendString(socket,httpGet);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSocket__lastErrorText(socket));
    Exit;
  end;

// Read the response up to the first double CRLF:
httpHeader := CkSocket__receiveUntilMatch(socket,#13#10 + #13#10);
if (CkSocket_getLastMethodSuccess(socket) <> True) then
  begin
    Memo1.Lines.Add(CkSocket__lastErrorText(socket));
    Exit;
  end;

// Close the connection with the server
// Wait a max of 20 seconds (20000 millsec)
success := CkSocket_Close(socket,20000);

// Display the session log:
Memo1.Lines.Add(CkSocket__sessionLog(socket));

// Show the HTTP response header:
Memo1.Lines.Add(httpHeader);

CkSocket_Dispose(socket);

end;