Finding and Running Level C

   

Both Level A and Level C of the Island Hopper News sample are included on the MSDN library CD. You can run Setup for either version at any time.

The installation process for Level C installs all the source code onto your local drive, as well as working versions of both the Windows and Web clients. The source code is located in Program Files\IslandHopper\ScenarioC\Source, if you accept the installation defaults. The Source folder contains the three folders in the following list.

Source code for the server components for Level C, most of which are written in Visual Basic, is in the Server_Components folder; source for the Windows client is in the VBClient folder. Source code for the Web client is in the Web folder.

Within the Server_Components folder, each business and data access component has its own folder, as described in the following table.

Folder Contents
bus_AdC Source code for the bus_AdC component, which handles the browsing and placing of ads within the application.
bus_CustomerC Source code for the bus_CustomerC component, which handles the creation, deletion, and modification of customer records.
bus_InvoiceC Source code for the bus_InvoiceC component, which handles invoices. Bus_InvoiceC is written using Visual C++.
bus_PaymentC Source code for the bus_PaymentC component, which handles payments.
CompatibleDLLs Compiled versions of the components used in the application. These components are gathered together into one directory for purposes of binary version compatibility.
db_AdC Source code for the db_AdC component, which handles updates and queries to the Advertisements table in the database.
db_CategoryC Source code for the db_CategoryC component, which handles updates and queries to the Categories table in the database.
db_CustomerC Source code for the db_CustomerC component, which handles updates and queries to the Customers table in the database.
db_CustomerPasswordC Source code for the db_CustomerPasswordC component, which handles updates and queries to the CustomerPasswords table in the database.
db_InvoiceC Source code for the db_InvoiceC component, which handles updates and queries to the Invoice table in the database.
db_PaymentC Source code for the db_PaymentC component, which handles updates and queries to the Payment table in the database. Db_PaymentC is written using Visual C++.
db_ProductC Source code for the db_ProductC component, which handles updates and queries to the Products table in the database.
DLLs Compiled versions of the components used in the application.

Note that all of the Visual Basic projects for the components in Level C have the Binary Compatibility option set in the project's properties. The Binary Compatibility option ensures that when you recompile a component, its CLSID stays constant — fixed to be that of the DLL in the CompatibleDLLs folder. The DLLs in the CompatibleDLLs folder are simply slightly older versions of the DLLs generated when you build any of the components in Level C.

Globals Global code for the application.
Interfaces Source code for the COM interfaces used in the application.
util_TakeANumber Source code for the TakeANumber utility, which assigns unique IDs when necessary.
util_WordCount Source code for the WordCount utility, which calculates the price of an ad based on the number of words in the ad. WordCount is written using Visual C++.

To start the Windows client

  1. Start SQL Server, if necessary.

  2. Click Start.

  3. Point to Programs.

  4. Point to Island Hopper.

  5. Click Island Hopper C.

For More Information   See Level C Walk-Through — Windows in this chapter for a description of both user flow and processing flow of the Windows version of the sample.

To start the Web client

  1. Start Microsoft® Internet Explorer 4.0 or higher.

  2. Point the browser at the islandhopperc directory in your local Web root. For example, http://MyMachine/islandhopperc.

For More Information   See Level C Walk-Through — Web in this chapter for a description of both user flow and processing flow of the Web version of the sample.