Re: [xwiki-devs] [GSOC]how to convert html to xwiki syntax

Hi Ludovic, 2008/6/6 Ludovic Dubost &lt;ludovic(a)xwiki.org&gt;rg>: The web service 'protocol' used by JODConverter 2.2 is documented at http://www.artofsolving.com/node/15 It's like that because it seemed the simplest solution for the purpose of sending a document and getting back a converted one. I guess proper REST would involve (doing a PUT rather than a POST and) storing the file somewhere and give it a URI so it can be retrieved at any later point. It's something I consider beyond the scope of the converter service, something more appropriate for a full document management system. But of course I'm open to suggestions. Same thing for authentication, I don't think it's the responsibility of the converter service to provide it, people can add it on top of JODConverter by configuring HTTP basic auth in their front-end Apache server, or adding a <security-constraint> in web.xml, or Spring Security, etc. - Are you handling a conversion queue ? JODConverter 2.2 uses standard Java synchronisation to serialise access to OOo, because OOo multi-threading is unreliable, so only one conversion is performed at a time. JODConverter 3.0 uses Java 5 concurrency to provide more flexibility, e.g. specifying lock timeouts, and also let you run multiple OOo processes to increase scalability. - How do you handle OO not coming back from the conversion or crashing ? JODConverter 2.2 doesn't deal with that case at all, the service will just become unavailable until you manually restart OOo. That's the strong case for JODConverter 3.0 - http://jodconverter.wiki.sourceforge.net/v3.0 Nope. As mentioned my philosophy is that the converter should only concern itself with doing conversions. But again I'm open to discussion. Cheers Mirko