Viewing Code Changes Using the Migration Viewer Tool

The Migration Viewer provide with this release provides quick, easy access to information about API changes in WebLogic Portal 7.0. With the viewer, you can easily see how many of the changes affect your implementation, and how much work will be involved in your migration efforts.The viewer is shown in Figure  A-1.

Figure A-1 Migration Viewer Tool

 

Note: This information contained in the Migration Viewer is also provided in an HTML file (migrinfo.html).

The Migration Viewer includes the following key features:

• A GUI environment for easier scanning of changes.

• Visual cues about types of changes (italics for deprecation, red for removal).

• Icons indicating packages, classes, fields, and methods.

• A find feature allowing you to search for a keyword in packages, classes, fields, and methods; in names and in comments.

 

---

Migration Viewer Files

The zip file contains the following files:

• <PORTAL_HOME>/migration/lib/migration_viewer.jar: the required class files and images

• <PORTAL_HOME>/migration/bin/viewer.bat: a Windows batch script for starting the viewer

• <PORTAL_HOME>/migration/bin/viewer.sh: a UNIX sh script for starting the viewer

 

---

Using the Migration Viewer

You can perform two main types of tasks in the viewer:

• Use the main GUI window to view information about the listed packages, classes, fields, and methods

• Use the Find window to search for specific keywords

Viewing Information in the Main Window

To view information in the Main Window, take the following steps:

1. Start the Migration viewer, as follows:

   Windows: <PORTAL_HOME>\migration\bin\viewer.bat

   UNIX: <PORTAL_HOME>/migration/bin/viewer.sh (UNIX) file.

   The Viewer should appear as shown in Figure  A-2:

   Figure A-2 Migration Viewer Tool—Initial View

   
    

2. In the left panel, click the Key icon next to "Migrate from 4.0 to 7.0". The packages for this migration appear in the left panel, and information about the selected item appears in the right panel.

3. Expand the icons and select the packages, classes, fields, and methods you want information about, as shown in Figure  A-3.

   Figure A-3 Migration Viewer Tool—Subsequent View After Selecting

   
    

Legend for cues in the left panel:

• Red text indicates a removed item.

• Italicized text indicates a deprecated item.

• A key icon indicates a package.

• A boxes icon indicates a class.

• An M icon indicates a method.

• An f icon indicates a field.

Searching by Keyword in the Find Window

If you want to find a particular keyword anywhere in the API change descriptions, use the Find function.

1. From the Migration Viewer Find menu, choose Find.

   The Find window appears, as shown in Figure  A-4.

   Figure A-4 Migration Viewer Tool—Finding, Step 1

   
    

2. Type the keyword in the Find field.

3. Unmark any types or locations where you do not want to search for the keyword.

4. Click Search; the results will appear in the Results window, as shown in Listing  A-5.

   Figure A-5 Migration Viewer Tool—Finding, Step 2

   
    

5. Double-click any item in the Results window; the item is displayed in the main Migration Viewer window.