2007/12/13, Sergiu Dumitriu <sergiu@xwiki.com>:
Thomas Mortagne wrote:
> Hi all,
>
> I made a tool to easily manage wiki class and wiki class's objets
> bundled in application manager some times ago. Problem is theses tools
> changed since it's creation and new has very wrong names and I would
> like to rename it.
>
> There is two java classes :
>
> - SuperClass : manage wiki class with it's attached
> document/sheet/template (assume the wiki class exist in the wiki we
> working on) and give methods to search, etc. in documents containing
> objects of this class
> - SuperDocument : the default implementation overload Document and
> manage one object of a particular wiki class in its document (to be able
> to save or delete it), this class is generally overloaded to add some
> acces methods like getDocuments() in Application java class.
>
> These tools are also usable from Velocity.
>
> For some examples you can view Application Manager plugin (Application
> and ApplicationClass classes) and Wiki Manager plugin (XWikiServer and
> XWikiServerClass classes).
>
> I propose :
> - SuperClass -> ClassManager
> - SuperDocument -> ObjectDocument (or ObjectManager but i don't like it
> because it does not imply object in a document)
>
+1 for ClassManager and ObjectDocument, but changing public class names
is not a good idea, especially after a major release.
As Application Manager is still in bêta (M2) and this feature really used only by Application Manager and Wiki Manager I would like to make this change before the final release. Another solution would be in place of just rename, move this feature in the core renaming it, this way it just a new Platform tool and Wiki Manager and Application Manager can change their dependencies without broken actual SuperClass for some releases... but it's another subject and I'm not sure it's really needed :)
To make a clearer distinction betwee XWiki concepts and Java classes,
how about XClassManager and XObjectDocument?
+1 for the "X" suffix.
Sergiu
_______________________________________________
devs mailing list
devs@xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs