As people talk about an 1.0 release about The Jakarta Commons Daemon project I have tried to think hard about the Daemon api as it is exposed in the public interfaces in org.apache.commons.daemon.
I believe that now is the right time to reform the API since it seems like no one(*) is using it right now. (I base this on the fact that in addition to implementing the Daemon interface, your daemon currently needs to have an undocumented init(String[]) method. This breaks the Demo daemons included in the projects).
I am using it. So I am -1 in removing it.
Since there is little documentation and no implementation explaining most of the complexity of the API and no one on this list have answered to my queries about it I propse that we remove all but the basic functionality exercised by the tomcat Bootstrap class. If anyone wants to take repsonsiblity over the extended functionality, they can re-add it to the API later on, as that would be an backward compatible change.
Removing complex things because you do not understand them is not a very nice behaviour.
- Remove the DaemonListener. The daemon listener is undocumented and unreferenced. If anyone want to listen to daemons control events in the future, please feel free to add it document it and write sample code that uses it.
- Remove the DaemonPermission as the current Daemon invoker implementation doesn't use it.
- Remove all the fail() methods in DaemonController that doesn't take an Exception as an argument, as the new Exception constructors that takes an embedded Throwable maked it possible to create generic Exceptions that combine another Trhowable with a message.
That's all the obvious removals IMHO. I'm working on documentation for everything that isn't mentioned above.
Please submit me a copy. I am also working on the documentation.
cheers /noa
*) Without the patch at http://nagoya.apache.org/bugzilla/show_bug.cgi?id=23242 you need an undocumented init(String[]) method in your Daemon class to make it start up at all. The fact that his seems to have been unnoticed for some months makes me quite confident that tomcat is the only code using the commons-daemon code.
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
