Samples

Chapter 1   Director Examples Application

This chapter describes how to configure and run the Director Examples application. It contains the following sections:

• About the Director Examples application

• Configuring the Director Examples application

• Running the Director Examples application

• Viewing the source code for an example

• Viewing the documentation page for an example

About the Director Examples application

The Director Examples application demonstrates many common coding techniques for Director applications. It includes the following examples:

• Components using Web Services

• Framework examples

• Content Management examples

• Personalization examples

The Director Examples application is packaged as a WAR file called DirectorExamples.war. To use the application, you need to add this WAR file to a Director EAR project by using the samples template.

Configuring the Director Examples application

To configure the Director Examples application to run on SilverStream:

1. Start your SilverStream eXtend Application Server with the Autonomy JAR file (autonomyJNI.jar) in the classpath. For example, if you installed Director under c:\Program Files\SilverStream, you could use this command to start the server:

     silverserver +cp:p c:\Progra~1\SilverStream\eXtendDirector\autonomy\autonomyJNI.jar
   

2. Add the Autonomy dynamic library (autonomyJNI.dll) to your environment. To do this, you need to add the directory containing the autonomyJNI.dll file to the PATH environment variable. For example, if you installed Director under c:\Program Files\SilverStream, you would add this entry to the PATH environment variable:

     c:\Program Files\SilverStream\eXtendDirector\autonomy
   

3. Create a new Director database. This database will contain Director application data such as content and user information.

   TIP   Give the data source a name other than DirectorExamples.

4. In eXtend Workbench, create a Director EAR project. Select the default values on all panels—except as indicated below:

   Panel	What to specify
   Template Location	Specify the following template location: %SILVERSTREAM_DIRECTOR_HOME%\templates\Director
   Project Information	Give the project a name other than DirectorExamples. Specify J2EE 1.3 as the J2EE Version for your project.
   Setup Type	Select Custom (not Typical).
   Subsystem Selection	Optionally deselect the following subsystems: Debug PMC RSS Rule WebDAV Workflow These are not required to run the application.
   Namespace Application	Uncheck Yes to removing namespacing. NOTE   This is necessary so that the URL for the Web Service example will be generic.
   Content Management Search Configuration	Make sure that the Enable link to the search service? option is set to Yes.
   Framework Configuration	For Director Framework Datasource, change Director to specify the name of your Director application database: Databases/YourDBName/DataSource For locksmith, specify anonymous (not admin).

5. In eXtend Workbench, select Project>Director EAR>Setup. Select the default values on all panels, except as indicated below:

   Panel	What to specify
   Setup Option	Select Add.
   Template Location	Specify the following template location: %SILVERSTREAM_DIRECTOR_HOME%\samples
   Subsystem Selection	Select DirectorExamples.

6. Select Project>Rebuild All and Archive.

7. Create a deployment plan for the project, using the following settings:

   Setting	What to specify
   Destination server type	SilverStream 4.0.
   jdbc/datasource	The name of your Director application database. The mapping for this resource reference must be the same as YourDBName, as specified in the Director Framework Datasource field in the Framework Configuration panel of the Director EAR Wizard.

8. Create a server profile for deployment. If you're planning to deploy to SilverStream, specify SilverStream 4.0 as the server type.

9. Deploy the EAR to the SilverMaster database (for example, SilverMaster40).

Running the Director Examples application

To run the Director Examples application:

1. Type the following URL in your browser:

     http://localhost/DirectorExamples
   

   The Director Examples home page appears:

   

2. To test a feature, click the link for that feature.

Viewing the source code for an example

To view the source code for a particular example:

1. Click Source in the upper-right corner of the example page.

   The Director Examples application lists the source files for that example.

2. To see a particular source file, click the link for that file.

Viewing the documentation page for an example

To view the documentation page for a particular example:

• Click Docs in the upper-right corner of the example page.

  The Director Examples application displays a page that provides a description of the coding techniques used to implement the example.

Samples

Copyright © 2002, SilverStream Software, LLC, a wholly owned subsidiary of Novell, Inc. All rights reserved.