D OracleAS Portal Provider Test Suite

The OracleAS Portal Provider Test Suite performs sanity, performance, and unit tests on a Web provider without an installation of OracleAS Portal or Internet access from the provider machine. There are two types of utilities that are available to the user in the test suite.

Provider Test Page
Test Harness

You can download the OracleAS Portal Provider Test Suite from the Oracle Application Server Portal Developer Kit (PDK) page on OTN:

http://www.oracle.com/technology/products/ias/portal/pdk.html

Click Download the JPDK Test Suite.

D.1 Provider Test Page

The provider test page provides a basic sanity test for the provider. It contains a list of portlets, servlet initialization arguments, and the version numbers of the ptlshare and pdkjava libraries. The provider test page is the simplest utility available for testing any Web provider. You access the test page by a URL after deploying the enterprise application or Web application on OC4J. You test the Web provider by accessing this URL from a browser:

http://server:port/application_name/providers/provider_name

For example, the PDK-Java comes with a sample application and portlets. The application is encapsulated in a WAR file, which in turn is encapsulated in an EAR file. When you deploy it, OC4J extracts the files and creates a directory structure with the sample portlets under:

ORACLE_HOME/j2ee/home/applications/jpdk

To view the test page for this provider, you would use this URL:

http://server:port/jpdk/providers/sample

When you access the test page, the SOAP servlet validates the XML provider definition, provider.xml, ensuring that the corresponding provider is well formed. This validation is useful for debugging deployment issues with your provider before attempting to register it with a OracleAS Portal. If you successfully deploy your Web application on OC4J, you receive a success message on the test page.

You can turn the test page on and off by using the JNDI variable oracle/portal/provider/provider_name/showTestPage to true or false. Once a provider is tested and in service you might want to restrict access to the test page. For more information about retrieving and setting JNDI variables, refer to Section 7.1.4, "Using JNDI Variables".

D.2 Test Harness

The test harness is a command line utility for unit- and performance-testing your providers without accessing an OracleAS Portal instance. The test harness sends HTTP requests to the target Web provider and records the responses for further analysis. The responses are logged into an XML file. Performance statistics are logged into another file for analysis.

The test harness provides considerable flexibility:

You create your own test definition. Based on the information in the test definition, the harness sends requests to the provider. The test definition file is in XML format and lists request instances to send to the target Web provider.
The information returned by the provider is stored in a standard XML file, which makes it easier to understand and analyze.
You can perform load testing of the Web provider.

D.2.1 Test Definition File

The test definition file is an XML file that lists the request instances for a particular test. You can optionally subdivide the request instances into request groups within the test definition file. You can include the details of the request instances in the test definition file or refer to a request library XML file that defines the instance details.

In addition to the request instances, the test definition file also includes information about the host and port of the target Web provider and any pre-processors to which it needs to be sent. A pre-processor enables you to include application-specific logic in the request instances at runtime in the test harness. For example, a pre-processor might check the validity of XML in the SOAP messages being sent to the target Web provider. The test harness provides three built-in pre-processors:

OracleAS Portal pre-processor
Validation-based caching pre-processor
HMAC (Hashed Message Authentication Checksum) pre-processor

The following sample test definition file illustrates the format and content of the file:

<xml version="1.0" encoding="ISO-8859-1">
<testDefinition version="0.1">
<testDefinition>
 <defaultHost>machine.name.com</defaultHost>
 <defaultPort>80</defaultPort>
 <defaultPath>/jpdk/providers/sample</defaultPath>
 <property name="portletId" value="1"/>
 <preProcessorDefinitions>
   <preProcessor
       class="oracle.webdb.testharness.preprocessor.PortalPreProcessor">
     <name>portal</name>
   </preProcessor>
   <preProcessor class="oracle.webdb.testharness.preprocessor.HMACPreProcessor">
     <name>hmac</name>
     <sharedKey>1234567890aBcDeFgHiJ</sharedKey>
   </preProcessor>
 </preProcessorDefinitions>
 <requestGroup id="register">
   <description>Carries out necessary registrations</description>
   <cycles>1</cycles>
   <threads>1</threads> -- increase the number to load test the Web provider.
   <requestInstance id="register_provider">
     <libraryId>ptl902</libraryId>
     <definitionId>registerProvider</definitionId>
     <runs>1</runs>
   </requestInstance>
   <requestInstance id="register_portlet">
     <libraryId>ptl902</libraryId>
     <definitionId>registerPortlet</definitionId>
     <runs>1</runs>
   </requestInstance>
 </requestGroup>
 <requestGroup id="show">
   <description>Carries out work necessary to show the portlet</description>
    ...
    ...
 </requestGroup>
    ...
</testDefinition>

D.2.2 runTest Command

The runTest command invokes the test harness with the specified options using the specified test definition.

runTest options test_definition

Table D-1 describes the command options for runTest.

Table D-1 runTest Options

Option	Description
-n testname	Assigns the specified name to this run. Defaults to a date-time name.
-g groupId	Is a comma separated list of the identifiers of the request groups in the test definition file to be run for this test. To run all groups, specify `--all-groups`.
-p perfLogFile	Is the name of the performance log file. Defaults to the test name. To disable performance testing, use `--no-perf`.
-l resLogFile	Is the name of the response log file. Defaults to the test name.
-v resLogLevel	Is the level of response logging (MIN \| HEADERS \| ALL). Default is ALL.
-c csvFile	Is the name of the response data CSV file. Default is to not generate it.
-s ctlFile	Is the name of the response data ctl file. Default is to not generate it.
--no-perf	Switches off all logging of performance data.
--all-groups	Runs all groups in the test definition.
-verbose	Produces verbose informational logging.

D.2.3 Running a Test with Test Harness

In order to test Web providers using the test harness, do the following:

Extract the pdktestharness.zip file to a convenient location. This will create a directory called pdktest to which all the test harness files are extracted.
Set an environment variable called PDKTEST_HOME to point to the location created in the previous step. For example, if you extracted to your D drive, you would now have a directory called D:\pdktest. Set the value of PDKTEST_HOME, to D:\pdktest. The Test Harness provides executable scripts in the bin directory.
Create a test definition file similar to the one in Section D.2.1, "Test Definition File".
Invoke the runTest command as described in Section D.2.2, "runTest Command".