Previous Next vertical dots separating previous/next from contents/index/pdf

Notes About General Issues

The following describes problems you might see after upgrading from version 8.1, but which aren't tied to particular component types or technologies. For upgrade-related issues associated with specific technologies, see the topics listed under Related Topics.

Version 8.1 .workshop Directory Required for Upgrade

Upgrade of a version 8.1 application might fail if the .workshop directory is not present in the application during upgrade. In particular, upgrade of the weblogic-application.xml file might fail if the file references build artifacts in the .workshop directory, but the directory does not exist.

To help ensure successful upgrade, be sure to build your version 8.1 application before upgrading.

Version 8.1 Applications with Dependencies on Third-Party Library JARs Might Result in Version 10.0 Compile Errors

Generally speaking, the upgrade process will present a warning message when a precompiled library must be recompiled to be used in the version 10.0 environment. However, there might be cases when the library should be recompiled but no message is presented. In other words, consider recompiling these libraries when you see compile errors in a project that you can't otherwise account for.

Application Library JAR Files Whose Manifest Has Line Lengths Exceeding 72 Bytes Will Cause Build Errors

Unlike version 8.1, version 10.0 enforces the line length size limit in JAR file manifests when the JAR is used as an application library. Upgraded applications containing JARs with lines exceeding the limit will generate errors at build time. To work around this change, either reduce the size of the lines or remove the manifest from the JAR.

Upgraded Code That Uses Internal APIs from weblogic.jar Will Break in Version 10.0

The use of internal APIs is not supported and the version 10.0 classpath does not (and should not) include weblogic.jar. Public APIs that used to be in weblogic.jar have been moved into wls-api.jar. The workaround for breakage due to the absence of weblogic.jar from the classpath is to rewrite code to use public APIs.

In addition, code that uses third-party APIs is not supported for upgrade to version 10.0.

Upgraded Code May Conflict with New Java 5 and JSP 2.0 Language Features

New language features in Java 5 and the JSP 2.0 expression language (which is used by the Beehive tag libraries) might make it necessary to rewrite portions of upgraded code.

For example, new features reserve words that were not reserved for code written in version 8.1. Workshop for WebLogic upgrade tools do not upgrade the use of these words, so code that uses them will not compile until you rewrite it so that it accounts for the new language features.

In particular, Java 5 adds the enum keyword. For more information, see Enums at the Sun web site.

JSP 2.0 reserved words are listed in Reserved Words Can Not Be Used as Identifiers.

In addition, upgraded code might encounter many changes in the Java APIs. With the addition of generics to the Java language, method signatures that took Object parameters in Java 1.4 have become more strongly typed. This enables Workshop for WebLogic version 10.0 to detect many errors at compile time that would only appear at run time in version 8.1. For example, if you wrote:

String s;
Thing t;

you would see no compilation error in version 8.1, but a ClassCastException would occur at run time. In version 10.0, compareTo(t) will be flagged as an compile time error because String.compareTo() actually expects a String parameter in 10.0, but only requires an Object in 8.1.

As a general rule, debugged code will not contain these types of errors. But when they appear during post-upgrade compilation, you must fix the code before the project will build successfully.

Upgraded Wildcard Import Statements Might Leave Some Types Stranded Without an Import

During the upgrade process, Workshop for WebLogic upgrade tools update package import statements to support the movement of key libraries. In some cases, this might break code that uses a class from the version 8.1 package that is still in that package. For example, upgrade tools will make the following changes:

import com.bea.wlw.netui.util.*;

... would be changed to...

import org.apache.beehive.netui.util.*

This leaves com.bea.wlw.netui.util.TemplateHelper stranded without an import because it is still in the older package. You can easily repair the code by using the Workshop for WebLogic quick fix feature to import required packages. Another, more thorough fix would be to remove wildcards and explicitly import classes in the version 8.1 code before upgrading it.

Version 8.1 Pointbase APIs are Not Supported in Upgraded Code

Version 8.1 includes APIs provided with the Pointbase database. These are not supported in version 10.0.

XML Schemas That Were Valid in Version 8.1 Might Not be Valid in Version 10.0

Version 8.1 of the IDE allowed the use of schemas that were not standards-compliant; version 10.0 does not. As a result, invalid schemas will generate errors during upgrade. Note, however, that while errors will appear in the IDE, the errors should not effect runtime behavior.

If you want to continue using the schemas in their invalid state but don't want errors displayed in the IDE, you can turn off schema validation. If you turn off validation, it will be off for all schemas, even though you may want to have validated. To turn off schema validation:

  1. Click Window > Preferences.
  2. In the Preferences dialog, in the left pane, click Validation.
  3. In the right pane, under Validation, clear the XML Schema Validator check box.
  4. Click OK.

WebLogic Workshop Version 8.1 Domains Can Be Upgraded from Within Version 10.0

When you create a new server as described in Creating a Server Definition for Use Within the IDE, you can upgrade a WebLogic Workshop version 8.1 domain.

  1. In Workshop for WebLogic, click File > New > Server.
  2. In the New Server dialog, under Select the Server Type, choose a new WebLogic Server type. For example, you can choose BEA WebLogic Server v10.0.
  3. Make other settings as needed, then click Next.
  4. In the Domain home box, enter or browse for the WebLogic Workshop domain you want to upgrade.
  5. With the path to a domain in the Domain home box, the dialog will display the following as a link:

    An older version domain is detected. Click here to upgrade it with the Upgrade Wizard.

  6. Click the "older version" link to launch the BEA WebLogic Upgrade Wizard.
  7. Follow the steps in the domain upgrade wizard as described in Procedure for Upgrading a WebLogic Domain.

CLASS Files Copied from a Version 8.1 Project Might Cause Errors After Upgrade

During upgrade from version 8.1, upgrade tools will copy CLASS files from the version 8.1 PROJECT_ROOT/WEB-INF/classes directory (which is intended for CLASS files from artifacts not in the project) to the version 10.0's PROJECT_ROOT/WebContent/WEB_INF/classes directory (the default location for project artifact build output). If your 8.1 project bypasses the default build output locations (such as with an Ant script) to put CLASS files from project artifacts in PROJECT_ROOT/WEB-INF/classes, you might see errors from duplicate CLASS files in the version 10.0 output directory.

To correct this situation, after upgrading delete the contents of the PROJECT_ROOT/WebContent/WEB_INF/classes directory and rebuild the project.

Related Topics

Upgrading Web Services

Upgrading Page Flows

Upgrading Controls

Upgrading Annotations

Upgrading Enterprise JavaBeans


Skip navigation bar   Back to Top