Hi Jun On Tue, May 17, 2011 at 9:16 AM, Jun Han <[email protected]> wrote: > Dear all, > > Regarding REST API for XWiki, > Source codes are in > xwiki-trunk/xwiki-platform/xwiki-platform-core/xwiki-platform-rest. > Test codes are in > xwiki-trunk/xwiki-enterprise/xwiki-enterprise-test/xwiki-enterprise-test-rest. > I hope I am looking at the correct places. > Correct.
> XWiki-5820 is related to adding an endpoint for providing a rendered > version of the page. > Does REST API need to invoke xwiki-rendering library in order to render > the html content? > There are several getRenderedContent() methods in the Document class... It should be enough to call them. > The current implementation will return various resources, (e.g., pages, > tags, attachments), and produce XML responses in most cases. > In XWiki-5820, only page resources will be rendered, right? > > A straight-forward way may be to add additional end point (getPage and > getPageInHTML), and they will be invoked according to different Accept > http headers. > > It would be great that an example can be given to show the expected > input and output. > Actually this is a good question... The original purpose of this resource was to provide a rendered version of a page (typically in HTML). Now, provided that we render in HTML, how this HTML should be returned? If we render with the complete skin we would end up with the same content already available from http://.../xwiki/bin/view/Space/Page So the idea was to return the "bare HTML" that could be emdedded in other contexts. For the input we can consider Accept headers and media parameters (already handled by the backend) Thanks, Fabio > Best regards > Jun Han > _______________________________________________ > devs mailing list > [email protected] > http://lists.xwiki.org/mailman/listinfo/devs > _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
