Document Section class
Hi I found that in xwiki core api, there is a class DocumentSection. Is it possible to use it (or am I permitted to use it) directly to create documents. If yes, how should I use it ? Regards Roopesh
Hi Roopesh, This is really weird... The DocumentSection class is indeed inside the com.xpn.xwiki.api package so it means it's a public API that you can use. However, I've checked where it's used and it's only used inside XWikiDocument which is NOT public itself... Thus my conclusion is that the DocumentSection class is wrongly placed in the api package and it should be instead in the com.xpn.xwiki package... I see that the author of it is Nam. Nam, could you please shed some light on this and tell us what we're missing? :) Thanks -Vincent On Apr 18, 2007, at 11:53 AM, roopesh@digitalglue.in wrote:
Hi
I found that in xwiki core api, there is a class DocumentSection. Is it possible to use it (or am I permitted to use it) directly to create documents. If yes, how should I use it ?
Regards Roopesh
Hi Vincent ! Yes, you're right ! The class DocumentSection shouldn't be placed in com.xpn.xwiki.api package because it was only used in XWikiDocument and it's not public itself. So you can refactor to move it to com.xpn.xwiki.api package. But I don't know whether we should move it to xwiki.xpn.xwiki package or xwiki.xpn.xwiki.doc package (I think that xwiki.xpn.xwiki.doc is better) WDYT ? Thanks. -Nam On 4/18/07, Vincent Massol <vincent@massol.net > wrote:
Hi Roopesh,
This is really weird... The DocumentSection class is indeed inside the com.xpn.xwiki.api package so it means it's a public API that you can use. However, I've checked where it's used and it's only used inside XWikiDocument which is NOT public itself...
Thus my conclusion is that the DocumentSection class is wrongly placed in the api package and it should be instead in the com.xpn.xwiki package...
I see that the author of it is Nam.
Nam, could you please shed some light on this and tell us what we're missing? :)
Thanks -Vincent
On Apr 18, 2007, at 11:53 AM, roopesh@digitalglue.in wrote:
Hi
I found that in xwiki core api, there is a class DocumentSection. Is it possible to use it (or am I permitted to use it) directly to create documents. If yes, how should I use it ?
Regards Roopesh
On Apr 19, 2007, at 5:12 AM, Phung Nam wrote:
Hi Vincent !
Yes, you're right !
The class DocumentSection shouldn't be placed in com.xpn.xwiki.api package because it was only used in XWikiDocument and it's not public itself.
So you can refactor to move it to com.xpn.xwiki.api package.
But I don't know whether we should move it to xwiki.xpn.xwiki package or xwiki.xpn.xwiki.doc package (I think that xwiki.xpn.xwiki.doc is better)
yes, *.doc is better -Vincent
WDYT ?
Thanks. -Nam
On 4/18/07, Vincent Massol <vincent@massol.net > wrote: Hi Roopesh,
This is really weird... The DocumentSection class is indeed inside the com.xpn.xwiki.api package so it means it's a public API that you can use. However, I've checked where it's used and it's only used inside XWikiDocument which is NOT public itself...
Thus my conclusion is that the DocumentSection class is wrongly placed in the api package and it should be instead in the com.xpn.xwiki package...
I see that the author of it is Nam.
Nam, could you please shed some light on this and tell us what we're missing? :)
Thanks -Vincent
On Apr 18, 2007, at 11:53 AM, roopesh@digitalglue.in wrote:
Hi
I found that in xwiki core api, there is a class DocumentSection. Is it possible to use it (or am I permitted to use it) directly to create documents. If yes, how should I use it ?
Regards Roopesh
participants (3)
-
Phung Nam -
roopesh＠digitalglue.in -
Vincent Massol