
     Time zone web services

The code in this folder demonstrates a very simple "web service".

Here is a diagram of a web browser communicating with a web server that
is executing a web application for the browser and the web application
is communicating with a web service. The "web service" is in fact just
another web application running on a web server but it is not a general
purpose web server. The web server for the web service only responds to
requests made for the web service program.


 browser.exe                    server.exe            java.exe                   server.exe            java.exe
 +---------+                   +---------+   pipe   +----------+                +---------+   pipe   +----------+
 |         |       http        | port    |--------->| stdin    |     http       | port    |--------->| stdin    |
 |         |<=================>| 8080    |<---------| stdout   |<==============>| 9090    |<---------| stdout   |
 |         |   tcp connection  |         |<---------| stderr   | tcp connection |         |<---------| stderr   |
 |         |                   |         |   pipe   |          |                |         |   pipe   |          |
 +---------+                   +---------+          +----------+                +---------+          +----------+
      |                                  \          /                                     \          /
      |                                   \        /                                       \        /
      |                                    \      /                                         \      /
   +-----+                                 +------+                                         +------+
   |     |                                 |      |                                         |      |
   |     |                                 |      |                                         |      |
   +-----+                                 +------+                                         +------+
    local                                   local                                            local
    file                                    file                                             file
    system                                  system                                           system


To run the web services in this folder, you need to compile and run
the web server that is in the directory above the web service package
folder.

The package folder of a web service program must be in the root
folder of the web server that runs the services.

The folder that holds the web server and the web service programs
can be anywhere on your computer or even on any computer connected
to the network.

The web server is configured to run on port 9090 and its root
folder name defaults to public_services.

   TimeZoneWebServices
   |   httpserver.properties
   |   HttpServer_v1x.class
   |   HttpServer_v1x.java
   |
   +---public_services
       +---TimeZoneWebService
           |   TimeZoneService.class
           |   TimeZoneService.java
           |
       +---TimeZoneWebService_v3
           |  TimeZoneList.class
           |  TimeZoneList.java
           |  TimeZoneService.class
           |  TimeZoneService.java
           |
