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 - please document the contract for implementors of j2eemoduleprovider
Summary: please document the contract for implementors of j2eemoduleprovider
Status: NEW
Alias: None
Product: serverplugins
Classification: Unclassified
Component: Infrastructure (show other bugs)
Version: 5.x
Hardware: All All
: P1 blocker (vote)
Assignee: Petr Hejl
URL:
Keywords:
Depends on:
Blocks: 54482 89008
  Show dependency tree
 
Reported: 2006-08-30 09:38 UTC by Milos Kleint
Modified: 2007-08-30 17:34 UTC (History)
1 user (show)

See Also:
Issue Type: TASK
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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