View source for TutWebAppServer Lesson 1 - Hello World

During this lesson, you will learn how to write the simplest website. The website you'll build has only one static page displaying "Hello World".

== Steps ==
<ol>
<li> Create a new VCL forms application.
:: Here in the demo we use a classic GUI application. For a real application, it is likely that you'll create a service application.</li>
<li> Rename the form "TutWebAppServerMainForm"</li>
<li> On the form just created, drop a THttpAppSrv component.</li>
<li> Save the files you have just created. Menu / File / Save all. Use OverbyteIcsTutWebAppServerMain.pas instead of unit1.pas and OverbyteIcsTutWebAppServer.dproj instead of project1.dproj.</li>
<li> Hit F9 to compile and run the projet. You should get no error and a blank form. If you have errors, then it is likely you have ICS incorrectly installed. Terminate the application.</li>
<li> Select the THttpAppSrv you just dropped on a form. Hit F11 to show the oject inspector and set a few property values:
::{| 
| Name || HttpAppSrv1
|- 
| Port || 20080 
|- 
| DocDir || c:\icstutorial\wwwroot 
|- 
| TemplateDir || c:\icstutorial\templates 
|- 
| DefaultDoc || index.html 
|}
</li>
<li> Create the document directory "c:\icstutorial\wwwroot" and the templates directory "c:\icstutorial\templates".</li>
<li> Create our static html page: Menu / File / New / Others / Web document / HTML Page. Just enter the body text "Hello World" and save the file as "c:\icstutorial\wwwroot\index.html"</li>
<li> Add a FormShow event handler to TutWebAppServerMainForm with the code:
<tt>
:: HttpAppSrv1.AddGetAllowedPath('/', afBeginBy);
:: HttpAppSrv1.Start;
</tt>
</li>
<li> Hit CTRL-SHIFT-S to save all.</li>
<li> Hit F9 to compile and run the application. You still get an empty form, but actually you already have a web server running ! Depending on your OS and security settings, you may get a message asking you to block or allow the application. Be sure to allow it.</li>
<li> Now enter the url: "http://127.0.0.1:20080" into your favorite browser. You should get your marvelous "Hello World" static page.</li>
</ol>
<br>
== Summary ==
In this lesson you learned how to build the basic webserver to serve static page. Beside the static pages you need, there are only two Delphi code lines to write.
<br><br>

Next lesson: [[TutWebAppServer Lesson 2 - Hello Today|Hello Today]]<br>
Tutorial presentation: [[TutWebAppServer]]