| Oracle® Real-Time Decisions Platform Developer's Guide Version 3.0.0.1 Part Number E13854-02 |
|
|
View PDF |
| Oracle® Real-Time Decisions Platform Developer's Guide Version 3.0.0.1 Part Number E13854-02 |
|
|
View PDF |
A convenient way to integrate a Web application with a deployed Inline Service is to use the JSP client integration tags. JSP allows you to generate interactive Web pages that use embedded Java. The JSP tags provided are based on the Java Smart Client discussed in the previous chapter.
There is negligible overhead when using the JSP tags. In addition, the tags incorporate automatic reuse of Smart Clients for same session to enhance performance. When a Java Smart Client is created using the JSP tag, a check is performed to see if a client already exists with the same name and properties and has not been closed. If it does, it automatically reuses that client; if not it will create a new one.
For full information about the JSP Smart Client tags, see the Decision Studio online help.
This chapter contains the following topics:
You must perform the following tasks first before you can work with the JSP client integration tags:
Install a Java Development Kit (JDK), with the JAVA_HOME environment variable set to its location. To obtain a JDK, go to the Sun Microsystems Web site at http://java.sun.com/products.
Install the Oracle RTD files and deploy Oracle RTD to an application server. See Oracle Real-Time Decisions Installation and Administration Guide for full information.
The Java Smart Client example works with the sample CrossSell Inline Service. Because of this, you must first populate the Oracle RTD Database with the CrossSell example data, then deploy the CrossSell Inline Service using Decision Studio.
See Oracle Real-Time Decisions Installation and Administration Guide for information about populating the Oracle RTD Database with the CrossSell example data. See Part III, "Decision Studio Reference" for information about deploying Inline Services.
Start Real-Time Decision Server. For more information, see Oracle Real-Time Decisions Installation and Administration Guide.
In general, integration using the Java Smart Client includes the following steps:
Prepare a properties file.
Use an Invoke or AsyncInvoke tag to create a request to the server.
Gather and parse any response information from Advisors.
Close the connection.
A working example of using the Smart Client JSP tags for integration can be found at RTD_HOME\client\Client Examples\JSP Client Example\example.jsp.
Note:
If your Real-Time Decision Server port is not 8080, you must edit the client properties information before deploying the JSP Smart Client example, as follows:Open RTD_HOME\client\Client Examples\JSP Client Example\sdclient-test.war with WinZip or WinRAR.
In sdclient-test.war, open client\sdclient.properties.
Search for the entry:
HTTP1.url = http://localhost:8080
Change the URL localhost:8080 to match the host and port of the Real-Time Decision Server that you are using.
Save the file back into sdclient-test.war.
For this example, the CrossSell Inline Service has been integrated to a simple command-line application to demonstrate how to use the Smart Client for integration. You need to deploy the JSP Smart Client example to your application server, as described in the following sections.
This section contains the following topics:
Section 8.3.1, "Deploying the JSP Smart Client Example to OC4J"
Section 8.3.2, "Deploying the JSP Smart Client Example to WebSphere"
Section 8.3.3, "Deploying the JSP Smart Client Example to WebLogic"
To deploy the JSP Smart Client example to OC4J:
Log in to the Application Server Control as the oc4jadmin user. You can access the Application Server Control at http://oc4j_host:port/em. For the standalone version of OC4J, the port number is typically 8888.
On the OC4J home page, click the Applications tab.
If you are using OC4J as part of Oracle Application Server, first click home under the Groups heading, then proceed to the Applications tab.
Click Deploy. On the Deploy: Select Archive page, under the Archive heading, browse to specify the archive location RTD_HOME/client/Client Examples/JSP Client Example/sdclient-test.war. Then, click Next.
On the Deploy: Application Attributes page, enter JSPClientExample for Application Name, then choose rtd-web-site for Bind Web Module to Site. Then, click Next.
On the Deploy: Deployment Settings page, click Deploy.
To access the application, open a Web browser and go to:
http://ocj4_host:port/sdclient-test/example.jsp
A Web page appears that simulates a service call, as shown in Figure 8-1.
Figure 8-1 JSP Smart Client Example: Enter Customer ID
Enter a customer ID (such as 5) and click OK. A response page appears, displaying an offer and an option to end the call, as shown in Figure 8-2.
Figure 8-2 JSP Smart Client Example: Displayed Offer
Click the offer link, or click End this call.
To deploy the JSP Smart Client example to WebSphere:
Access the Integrated Solutions Console at the URL http://websphere_host:port/ibm/console. At the login prompt, enter the administrator user name and password. On Windows, you can also access the Integrated Solutions Console through Start > Programs.
In the tree on the left, expand Applications, then choose Enterprise Applications.
Click Install.
In the Path to the new application section, enter or browse to the path RTD_HOME/client/Client Examples/JSP Client Example/sdclient-test.war.
For Context root, enter sdclient-test.
Click Next, then click Next again, then click Next again.
Click Finish, then click Save.
On the Enterprise Applications page, select the sdclient-test application and click Start.
To access the application, open a Web browser and go to:
http://websphere_host:port/sdclient-test/example.jsp
A Web page appears that simulates a service call, as shown in Figure 8-3.
Figure 8-3 JSP Smart Client Example: Enter Customer ID
Enter a customer ID (such as 5) and click OK. A response page appears, displaying an offer and an option to end the call, as shown in Figure 8-4
Figure 8-4 JSP Smart Client Example: Displayed Offer
Click the offer link, or click End this call.
To deploy the JSP Smart Client example to WebLogic:
Access the WebLogic Server Administration Console for your Oracle RTD domain at the URL http://weblogic_host:port/console. At the login prompt, enter the administrator user name and password. On Windows, you can also access the WebLogic Server Administration Console through Start > Programs > BEA Products > User Projects > domain_name > Admin Server Console.
In the tree on the left, click Deployments.
Click Install. You may need to click Lock & Edit first to enable the Install button.
Go to RTD_HOME/client/Client Examples and select JSP Client Example, then click Next.
Select Install this deployment as an application, then click Next.
On the Optional Settings page, enter JSPClientExample for Name. Then, click Next.
Review your settings and click Finish.
Click Save, then click Activate Changes.
Start the application by selecting JSPClientExample application in the Deployments table, then clicking Start > Servicing all Requests. When prompted, click Yes. The application is now running.
To access the application, open a Web browser and go to:
http://weblogic_host:port/sdclient-test/example.jsp
A Web page appears that simulates a service call, as shown in Figure 8-5.
Figure 8-5 JSP Smart Client Example: Enter Customer ID
Enter a customer ID (such as 5) and click OK. A response page appears, displaying an offer and an option to end the call, as shown in Figure 8-6.
Figure 8-6 JSP Smart Client Example: Displayed Offer
Click the offer link, or click End this call.
|
 Copyright © 2009, 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|
