---

THIS IS JUST THE DRAFT!

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:

//TODO: RETOUCHE

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.

Progress

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.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 emononen(MethodCustomizer)	done
websvc/websvcddapi	1	madamek	done
websvc/jaxwsmodel	1	madamek	done (with TODOs)
web/core	1	mfukala rjanman	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

Attachments