This document tries to summarize steps needed to migrate J2EE modules to Retouche. Migration can be done in waves depending on module dependencies. First visible result of migration in trunk should be enabled J2EE project types. There are some modules that can be enabled later (refactoring, verification...). Problem with incremental rewrite is that you won't be able to test the results until related project is enabled. This may lead us to think about rewrite in the way that we will try to enable all modules under projects and just comment difficult JMI-related parts. That will end with lots of commented code, but working projects and their non-java parts (maked sense mostly for Web project?). It is important to mentioned well-prepared document (not like before JMI migration) about migration to Retouche. It is written and updated by Retouche team members. Please take a look at this document before you even start to think about Retouche. Link is below.

More info about Retouche

Migration guide - important reading for beginning
Retouche Developer FAQ - if you have questions to Retouche team, put them here

Commenting-out some code?

In case you need to disable some code in class, put this line-comment before you actual comment in code:


Enabling of J2EE modules

  • Dependencies
Here is simplified relationship diagram of JMI-dependent J2EE modules.
Columns represent modules that can be refactored at the same time - there is no dependency between them. Image:j2ee_jmi_deps_RetoucheJ2EE.png


See also Webtier migration to Retouche

  • Enabled basic modules (without or with small JMI dependency) enabled:__

cvs -d $NB_CVSROOT diff -ubBN j2ee/metadata/ db/derby/ db/model/ j2ee/ddapi/ j2ee/debug/ j2ee/ejbapi/ j2ee/genericserver/ j2ee/platform/ j2ee/toplinklib/ j2ee/utilities/ j2eeserver/ monitor/ serverplugins/sun/appsrv serverplugins/sun/sunddapi/ serverplugins/jboss4/ serverplugins/weblogic9/ tomcatint/tomcat5/ web/freeform/ web/jspdebug/ web/jspparser/ web/servletjspapi/ web/webapi/ websvc/registry/ websvc/websvcapi/ websvc/websvcddapi/ web/libs/glassfish_logging/ >  j2ee-retouche-phase123_RetoucheJ2EE.diff

  • Affected functionality
  • removed annotation processing
  • Search Class dialog used from wizards/customizer is disabled
  • Method customizer used from 'Add method...' actions is disabled
  • Enabled Web project
  • Enabled j2ee/persistence
  • Affected functionality
  • Entity Class Wizard
  • Session Facades for Entities Wizard
  • Use Entity Manager Action
  • Entities From Database
  • persistence.xml editor
  • Things that don't work
  • Database metadata based code completion for persistence related annotations
  • since there is no model yet, basically everything that requires the dd model to work is not functional at this point.

Status of JMI-depending modules

NoC: Number of Classes using JMI

Phase 1 - basic modules

Module NoC Owner Status
j2ee/metadata 5 madamek done
j2ee/ejbapi 1 madamek done
j2ee/ddapi 4 madamek done
j2ee/utilities 17 madamek
websvc/websvcddapi 1 madamek done
websvc/jaxwsmodel 1 madamek done (with TODOs)
web/core 1 mfukala
done (with TODOs)
websvc/core 1 milan done (with TODOs)
websvc/customization 1 milan done
websvc/jaxrpcsupport 1 milan

The rest of the status is tracked in Java EE team task list

Not logged in. Log in, Register

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2012, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo