This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 83751

Summary: please document the contract for implementors of j2eemoduleprovider
Product: serverplugins Reporter: Milos Kleint <mkleint>
Component: InfrastructureAssignee: Petr Hejl <phejl>
Status: NEW ---    
Severity: blocker CC: pjiricka
Priority: P1    
Version: 5.x   
Hardware: All   
OS: All   
Issue Type: TASK Exception Reporter:
Bug Depends on:    
Bug Blocks: 54482, 89008    

Description Milos Kleint 2006-08-30 09:38:51 UTC 
this is a follow-up to #82987.

the contract for modules implementing J2eeModuleProvider and related classes is
not clearly documented anywhere.
Specific issues I encountered
1. at some point in time getConfigSupport().ensureConfigurationReady() has to be
called, not clear what is the right time.
2. setServerInstanceID(String severInstanceID) is abstract and needs to be
implemented but is never actually called by the infrastructure
3. it generally seems to be a strange mix of api and spi and it's not clear
where is the line of responsibility between the project module, j2eeserver
infrastructure and the server plugins modules.
Comment 1 Sherold Dev 2006-08-30 10:38:12 UTC 
Changing the issue type to TASK.

I fully agree with the reporter that the API/SPI is not very well designed and
is not easy to use, the lack of documentation makes it even worse. Fixing the
documentation is the least we can do to improve it a little bit.

Setting the TM to DEV and increasing the priority to P1.
Comment 2 Petr Jiricka 2007-06-12 10:35:51 UTC 
Stepan, has any work been done on this with your changes in j2eeserver in NB 6? Thx.
Comment 3 Sherold Dev 2007-06-14 12:15:44 UTC 
Some of the methods were moved from the J2eeModuleProvider to J2eeModule, where they belong, but there is still a lot of
clean up to do. I started a wiki page where j2eeserver API problems like this should be listed. For NB 6.0 I would like
to improve the javadocs at least.
Comment 4 Sherold Dev 2007-06-14 12:28:21 UTC 
here is the link http://wiki.netbeans.org/wiki/view/J2EEServerAPIProblems