Java Language Conversion Assistant 2.0

Welcome to Java Language Conversion Assistant 2.0 (JLCA). The purpose of JLCA is to help you convert your Java-language projects to Visual C# and the .NET Framework. This document discusses the JLCA feature set, system requirements, and known issues in this release.

Features

JLCA 2.0 converts most Java-language constructs, including the following:

• Language: Java-language structures as defined by the Java Language Specification 2.0, as well as Microsoft Java language extensions.
• Classes: Class declarations, inner and anonymous classes, as well as interfaces. Hiding, overriding, and overloading.
• Methods: abstract, static, final, native, virtual, and synchronized methods.
• Forms: WFC forms are converted to Windows Forms. Most AWT components are also converted to Windows Forms.
• Java API usage: This release converts most of the Java APIs associated with JDK 1.1.4, as well as select functionality from later versions of the JDK. It also converts calls to the Windows Foundation Classes. The specific packages covered by this release include the following:

com.ms.activex	com.ms.awt	com.ms.com
com.ms.dll	com.ms.io	com.ms.lang
com.ms.directx	com.ms.dll	com.ms.dxmedia
com.ms.fx	com.ms.io	com.ms.jdbc.odbc
com.ms.lang	com.ms.mtx	com.ms.object
com.ms.ui	com.ms.util	com.ms.wfc.app
com.ms.wfc.ax	com.ms.wfc.core	com.ms.wfc.data
com.ms.wfc.data.adodb	com.ms.wfc.data.dsl	com.ms.wfc.data.rds
com.ms.wfc.data.ui	com.ms.wfc.io	com.ms.wfc.ole32
com.ms.wfc.ui	com.ms.wfc.util	com.ms.wfc.win32
com.ms.win32	java.applet	java.awt
java.awt.datatransfer	java.awt.event	java.awt.image
java.beans	java.io	java.lang
java.lang.reflect	java.math	java.net
java.security	java.sql	java.text
java.text.resources	java.util	javax.servlet
javax.servlet.http	javax.servlet.jsp

• If your project contains references to Java APIs other than those listed above, the statements that use them are copied to Visual C# unchanged.

In addition, this release of JLCA contains the following documentation:

• Conceptual topics for how to convert Java-language code to Visual C#.
• Help for the Java Language Conversion Assistant wizard.
• More than 4500 topics that explain what to do with code that is not converted automatically.

Improvements over JLCA 1.0

This release contains the following improvements over JLCA 1.0:

• Significant performance improvement for larger conversion projects.
• Support for conversion of JavaServer Pages (JSP) and servlets.
• The ability to read all major character-encoding systems.
• Conversion of the Java 1.2 Collections API.
• Improved support for the conversion of applets.
• Fixes to several bugs and omissions in JLCA 1.0.

System Requirements

The following are the system requirements for installation of JLCA 2.0:

Processor	PC with Pentium II-class processor, 450 MHz Recommended: Pentium III-class, 600 MHz
RAM	Windows 2000 Professional: 96 MB Windows 2000 Server: 192 MB Recommended: 128 for Professional, 256 MB for Server Windows XP Professional: 160 MB Windows XP Home: 96 MB Recommended: 192 MB for Professional, 160 MB for Home Windows Server 2003: 192 MB Recommended: 256 MB
Available hard disk space	110 MB
Operating system	Windows 2000, Windows XP, or Windows Server 2003
Display	800x600, 256 colors Recommended: High Color (16-bit)
Mouse	Microsoft mouse or compatible pointing device
Prerequisite software	Microsoft Visual Studio .NET 2003 Professional, Enterprise Developer, Enterprise Architect, or Academic - or - Microsoft Visual C# .NET 2003 Standard with both Visual C# and Java Language Conversion Assistant 1.0 installed

Performance has not been tuned for minimum system configuration. Increasing your RAM above the recommended system configuration improves performance, especially when running multiple applications, working with large projects, or dong enterprise-level development.

Microsoft Windows 2000 Datacenter Server is not a supported operating system.

Installing and Accessing Documentation

Java Language Conversion Assistant documentation must be installed separately from the product. You must install the documentation to access error messages in your converted code.

Once installed, the documentation is accessible from a separate entry in the table of contents below MSDN Library.

To access Help from the table of contents:

• Click Java Language Conversion Assistant at the bottom of the table of contents.

To access Help from your converted code:

• CTR+click the underlined portion of the conversion comment.

Some comments, such as those located in the HTML editor, are not clickable. For these, copy and paste the portion in quotation marks in the Help Search box.

Known Issues

The following issues in this release are not covered in the documentation.

DBCS in project names or virtual roots can create unreadable Csproj.webinfo files

If you specify a project name, VJP file name, or virtual root name which contains double-byte character set (DBCS) characters when converting a Web application, JLCA may generate a corrupted Csproj.webinfo file. This file cannot be read by Visual Studio .NET and will cause errors that prevent the converted application from being opened.

To repair a corrupted Csproj.webinfo file

1. In Visual Studio .NET on the File menu, select Open.
2. Select the corrupted Csproj.webinfo file, and click OK.
3. On the File menu, select Save As.
4. Click the arrow to the right of the Save button, and select Save with Encoding.
5. Click Yes to resave the file.
6. In the Encoding box, select Unicode (UTF-8 with signature) - Codepage 65001, and click OK.

The file can then be read properly.

Creating variables through actions is not supported

JLCA 2.0 does not support the conversion of tag library code that creates new variables through actions. If your code has such statements, they will be copied unchanged into the converted project. This applies to the following classes:

• javax.servlet.jsp.tagext.PageData
• javax.servlet.jsp.tagext.TagAttributeInfo
• javax.servlet.jsp.tagext.TagData
• javax.servlet.jsp.tagext.TagInfo
• javax.servlet.jsp.tagext.TagLibraryinfo
• javax.servlet.jsp.tagext.TagLibraryValidator
• javax.servlet.jsp.tagext.TagVariableInfo
• javax.servlet.jsp.tagext.VariableInfo