8 Business Components for Java (BC4J)

This chapter discusses the following topics:

Section 8.1, "General Issues and Workarounds"

8.1 General Issues and Workarounds

This section describes general issues and their workarounds for Business Components for Java.

• Section 8.1.1, "Deploying UIX Applications from Oracle9i JDeveloper Release 9.0.2"

• Section 8.1.2, "Error Instantiating Servlet 'XSQL'"

8.1.1 Deploying UIX Applications from Oracle9i JDeveloper Release 9.0.2

The simplest way to deploy applications to Oracle9iAS Release 9.0.3 is to use Oracle9i JDeveloper release 9.0.3. See the JDeveloper release 9.0.3 documentation for more information.

However, if you do not have access to Oracle9i JDeveloper release 9.0.3, you can still deploy from release 9.0.2, although you will have to use the following steps after deployment:

1. Delete the application_directory/cabo directory.

2. Unzip ORACLE_HOME/jlib/uix2-install.zip into application_directory.

In addition, if the application is a UIX JSP application (as opposed to a uiXML application), perform the following steps:

1. Delete application_directory/WEB-INF/lib/uixtags.jar.

2. Copy ORACLE_HOME/jlib/uix2.jar into application_directory/WEB-INF/lib/.

3. Open application_directory/WEB-INF/web.xml in a text editor.

4. Find the string uixtags.jar and replace it with uix2.jar.

8.1.2 Error Instantiating Servlet 'XSQL'

If you get the error:

Servlet error: Error instantiating servlet 'XSQL'

you need to add XSQL libraries to your classpath:

1. Open ORACLE_HOME/j2eehome/config/application.xml in a text editor.

2. Find the last library element.

3. Add the following elements after that element:

   <library path="ORACLE_HOME/lib/oraclexsql.jar" />
   

   <library path="ORACLE_HOME/lib/xsqlserializers.jar" />