Anybody can build a desktop website within 1 minute!

MyWeb - Programming Interfaces

MyWeb has two programming interfaces: Windows Script interface and Win32 Console Application interface.

Windows Script

With the Windows Script language, JScript and VBScript, you can access almost all the resource of the system, such as files and folders, the shell, the network, as well as resources provided by other applications, such as Micosoft Excel, Word, Access etc.

MyWeb use CScript.exe to run your Script file. CScript.exe is a programm shipped together with Windows. It is a Console programm (or DOS programm). For Windows 9X, it is in the Command folder, For Windows 2000, XP, it is in the System32 folder.

The equivalent of CScript.exe is WScript.exe, which is the Windows version with GUI. For Windows 9X, it is in the Windows folder, For Windows 2000, XP, it is in the System32 folder.

Win32 Console Application

You can use any programming language to produce a Win32 Console Executable File (or DOS programm file). MyWeb starts your programm in an new and independent process.

The Two Parameters

When your program is started, it gets two parameters from MyWeb. The first parameter is an unique ID, for example, 123-456789 the second parameter is the address of the cilent, for example, 123.123.123.123:5678.

Parsing the Requst Header

The HTTP request header from the client's Web browser is stored in a file. The file is in the same directory as your programm. You use the ID passed to your program to get the name of the file. For example, if the ID is 123-456789, then the name of the file is 123-456789.r

Tell MyWeb How You Will Make The Response

After parsing the HTTP request header from the client's Web browser, now you know how you should repsonse the client. You must let MyWeb know that too, so that MyWeb can cooperate with your program. You do this by creating a Control File. The name of the Control File uses the ID too. For example, if the ID is 123-456789, then the name of the Control File is 123-456789.c
The Control File is a text file with 3 characters, for example, 101. Here are the definitions of the three characters, from the first to the third:

• How the response header is created.
  0: Let MyWeb create the header;
  1: Your program will create the response header. The response header must be stored in a file. The file name convention is the same: for example, if the ID is 123-456789, then the name of the response header file is 123-456789.h
  
• How the response body is created.
  0: The Body File is the response body;
  1: The Body File contains the file path of the response body.
  You see, the Body File can not be omitted --- your program must create the Body File, even if it will be zero-sized. And again, the file name convention is still the same: for example, if the ID is 123-456789, then the name of the response body file is 123-456789.b
  
• How MyWeb Should Send the Response Body.
  0: Send it as continous stream. Usually a existing file, the file length is known.
  1: Send it as chunked blocks. Usually dynamically generated content, such as the result of the database query.
  2: Start sending from the end of the Response Body, and send it as chunked blocks. Usually a file that is growing in size, such as multimedia recording.
  Naturally, for 0, the response header contains Cotent-Length: nnnnn, where nnnnn is the length of the response body, and for 1 and 2, the response header contains Transfer-Encoding: chunked

When Connection Droped by Client

When disconnected by the cilent, MyWeb let your programm know it by creating a Stop Flag File. If the ID is 123-456789, then the name of the Stop Flag File is 123-456789.s
If your programm takes a long time creating the response body file, you should check regularly if the Stop Flag File exists, to avoid wasting time.

Explore The Samples

Click here to download the samples. The package contains several JScript files, a Win32 Console executable file and its source file. Control codes are used in the file names. For example, mwext_001.js means this program use "001" as control codes.

Following these steps to install the sample files:

• On the Folder List View of the main window of MyWeb, right click the "Extension" icon, then select "Configure" command on the menu. This will bring out the "MyWeb Extension" dialogue box.
• On the "MyWeb Extension" dialogue box, select the folder where the extension program files will be stored, and check "Enable Extension".
• Open the downloaded zip file and extract all files to the selected folder.