If you would like to be in control of the DOM instance on your own because you want to load a specific xml instance or saving the DOM to an external persistency source (db, file system, ...), you need to create a JAXFront DOM (hold a reference to it), visualize and serialize it as an XHTML stream in your own servlet method.
The full exampled described as follow can be download from the JAXFront product home page:
To see an example demo servlet embedding JAXFront see the java class: com.jaxfront.example.servlet.MyCustomerServlet
Within your servlet service method, define a URL paramter which indicates the creation of a JAXFront web form (e.q. action=create).
public void service(HttpServletRequest request, HttpServletResponse response) throws javax.servlet.ServletException, java.io.IOException {
if (JAXFrontServletAdapter.doesConcern(request)) {
JAXFrontServletAdapter.getInstance().handle(request, response);
} else {
String action = request.getParameter("action");
if (action != null && action.equals("create")) {
createDOM(request, response);
} else {
super.doPost(request, response);
}
}
}
Your servlet needs to do the following steps after it has been recognized a JAXFront web form request:
-
-
- Create a JAXFront DOMHandler based on an XML schema, XML instance and XUI
- Create an ActionController for controlling the DOM actions (save, validate, ...)
- Call the JAXFront HTML API to build the XHTML form stream
-
The following example method called createDOM() creates a new JAXFront web form based on the po.xsd, po.xml and po.xui. The URL param "id" is been used to identify a xml instance. In this simple example it just points to a file stored in the servlet context.
private void createDOM(HttpServletRequest request, HttpServletResponse response) {
StringBuffer formContentXHML = new StringBuffer();
String id = request.getParameter("id"); // use this id to resolve xsd or an xml instance as an example
String xsd = JAXFrontServletAdapter.getRealPath(getServletContext(), "examples/purchaseOrder/po.xsd");
String xml = id;
String xui = JAXFrontServletAdapter.getRealPath(getServletContext(), "examples/purchaseOrder/po.xui");
String key = xsd + "_" + xml + "_" + xui;
String cachedFormID = (String) request.getSession().getAttribute(key);
if (cachedFormID != null) {
formContentXHML.append(API.getForm(request, cachedFormID));
}
else {
DOMHandler domHandler = new DefaultDOMHandler(null, null, request, xsd, xml, xui, null);
DOMActionController actionController = new MyOwnDOMActionController();
String formID = API.buildForm(formContentXHML, request, domHandler, actionController);
request.getSession().setAttribute(key, formID);
}
try {
response.getWriter().write(formContentXHML.toString());
} catch (IOException e) {
}
}
To better understand the full html Java API class, see the online javadoc:
http://www.jaxfront.com/javadoc/html-api/
http://www.jaxfront.com/javadoc/html-api/