Oracle® Application Server 10g (9.0.4) Multimedia Tag Library for JSP

Date: 02-Feb-2004

Demo: "Online Webinar" Demo

Table of Contents

Overview

This demo illustrates the key features of Oracle® Application Server 10g Multimedia Tag Library for JSP.  This demo primarily illustrates how to apply different tags that are supported by Oracle AS 10g Multimedia Tag Library for JSP. Multimedia Tag Library provides media retrieval tags, which JSP developers can use to generate complete HTML multimedia tags or create multimedia retrieval URLs for inclusion in the customized use of an HTML multimedia tag. Multimedia Tag Library provides media upload tags, which facilitate the development of multimedia applications that upload media data into the database. Primarily this demo illustrates the usage of the following media retrieval and media upload tags:

  • Media Retrieval Tags
    • embedImage
    • embedAudio
    • embedVideo

  • Media Upload Tags
    • uploadFormData
    • storeMedia
    • uploadFile

This demo is about an Online Webinar application where the user can view different web seminars online. Besides this, there is an Admin module using which the Administrator can upload web seminars into the database.

Software Requirements

Following are the software required for deploying and running this application:

  • Oracle Application Server 10g(9.0.4 or later) is installed, available from OTN.
  •  
  • Sun's JDK 1.4.x is installed, available here.
  • Oracle 9idatabase(release 9.2.0.1 or later) which has support for Oracle interMedia, available here.
  • ANT tool for building the Enterprise ARchive (EAR) file which can be downloaded from Jakarta Apache. This component is required for automatic building and deploying of this demo application.
  • Multimedia Tag library for JSP, available here.

Notations

  • <IAS_HOME> - The directory where Oracle Application Server 10g is installed. For example if Oracle Application Server 10g is installed in c:\midtier then <IAS_HOME> would be c:\midtier.
  • <J2EE_HOME> - The directory where the oc4j.jar file exists within <IAS_HOME>. This is typically 2 directories under <IAS_HOME>. For example, if you installedOracle Application Server 10g to c:\midtier then <J2EE_HOME> would be c:\midtier\j2ee\home.
  • <JAVA_HOME> - The directory where the JDK is installed. For example if JDK is installed in c:\jdk1.4 then the <JAVA_HOME> would be c:\jdk1.4
  • <SAMPLE_HOME> - The directory where the Online Webinar application sources are extracted from zip file . For example if the zip file is extracted in c:\ then the <SAMPLE_HOME> would be c:\MultimediaDemoApp

Introduction

Oracle® Application Server 10g Multimedia Tag Library for JSP is one of the key new feature of OC4J 10g release.

Extracting the Source Code

On extracting the MultimediaDemoApp.zip file, all the files are extracted into a MultimediaDemoApp folder.

Click here to view the directory structure and description of sample files.

The sources in the directory structure will be used to build and deploy the demo application. Upon deploying the demo application (instructions given below), you will find a detailed explanation of the demo along with access to all the source code.

Prerequisites for running the Demo application

Before running the demo make sure of the following:

1. Oracle Application Server 10g(9.0.4 or later) is installed correctly.

2. The contents of the ZIP file when extracted should have the directory structure as mentioned here .

3. To create the database objects required for the application, execute the creation.sql existing under <SAMPLE_HOME>/sql directory in SCOTT schema. You can do this by executing the following command in SQL*Plus :
sqlplus>
@<SAMPLE_HOME>/sql/creation.sql

4. Installing the Oracle Application Server 10g Multimedia Tag Library for JSP

a. Download the Multimedia Tag Library for JSP (ordjsptag.zip) as mentioned in the Software Requirements section above. Unzip the downloaded ordjsptag.zip file. On unzipping, ordjsptag.jar file is extracted.

b. Copy the ordjsptag.jar extracted in the above step to <J2EE_HOME>/jsp/lib/taglib directory.

Automatic Building and Deploying of the Demo application

This is an installation for automatic building and deploying of the demo application into Oracle Application Server 10g using the 'ANT' utility.

STEP 1.

Edit the file <SAMPLE_HOME>/common.xml in your favorite XML editor. Change the entries marked in bold according to your system settings:


<property name="IAS_HOME" value="/home/midtier"/>
<property name="JAVA_HOME" value="${env.JAVA_HOME}"/>
<property name="SAMPLE_HOME" value="/home/MultimediaDemoApp"/>

<property name="DB_HOST" value="incq222b.idc.oracle.com"/>
<property name="DB_PORT" value="1521"/>
<property name="DB_SID" value="ora9204"/>
<property name="DB_USER" value="scott"/>
<property name="DB_PASSWD" value="tiger"/>


where,

<IAS_HOME> Folder where Oracle Application Server 10g is installed
<JAVA_HOME> The directory where the JDK is installed.
<SAMPLE_HOME> The directory where the Online Webinar application sources are extracted from zip file
<DB_HOST> The hostname of the machine where Oracle database where database objects for the demo are created is running.
<DB_PORT> It is the port on the host machine where the database listener is listening to .
<DB_SID> It is the SID of the database.
<DB_USER> It is the database schema where the database objects are created.
<DB_PASSWD> It is the password for the database schema where the database objects are created.

STEP 2.

a. Please start the Oracle® Application Server 10g instance before proceeding to the step 2(b).

b. To create the EAR file and deploy the demo application, go to the directory <SAMPLE_HOME> on command prompt and type

> ant
STEP 3.
To run the sample application, open your favorite browser and access the following URL
http://<host_name>:<port>/multimediatagdemo
where,
<host_name>
Name of the machine where Oracle Application Server 10g is running. If the server is running on the local machine, then even localhost would suffice.
<port>
Port on which the Oracle Application Server 10g listens to HTTP requests. By default, this value is 7777.

Now, you are ready to run the demo application. For more information on using the sample application, please refer to the section on Running the Application.

Running the Demo application

Review the index page to understand the demo, how it works and how the new features listed in the Introduction section of this document are put to use.

There is a file named build.xml provided in the <SAMPLE_HOME> directory. This file can be used for re-creating an EAR file after any modifications to the sources is made.

Note: Sample multimedia data that is uploaded for the Seminar Category/Event in the demo is also available for download. For this, please download the sample multimedia data from here.

Description of Demo application Files

The directory structure of the deliverable MultimediaDemoApp.zip is as shown below.

Directory Files Description
<SAMPLE_HOME>/docs Install.html This file.
<SAMPLE_HOME>/etc A set of 'xml' files These are the configuration files for the demo
<SAMPLE_HOME>/images A set of 'gif' and 'jpg' files These are the image files used in the demo
<SAMPLE_HOME>/jsps JSP files used in the demo Description about each of the JSPs can be found in http://host_name:port/multimediatagdemo when the application is deployed.
index.html This file provides information on the JSP multimedia tag usage.
<SAMPLE_HOME>/SQL creation.sql This SQL creates the required database objects
<SAMPLE_HOME>/stylesheets A set of 'css' files These are the stylesheets that are used in the demo
<SAMPLE_HOME>/classes ViewSrc.class This class is used to display the source code when the application is deployed

<SAMPLE_HOME>

build.xml, common.xml These files contain the 'xml' scripts that is used by 'ANT' utility to build and deploy the demo into Oracle AS 10g

Please enter your comments about this sample in the OTN Sample Code Discussion Forum.
E-mail this page
Printer View Printer View
Oracle Is The Information Company About Oracle | Oracle RSS Feeds | Careers | Contact Us | Site Maps | Legal Notices | Terms of Use | Privacy