For Tips to use specific Component Libraries see
Converting from JSP to facelets
- Backup everything
- Download and Install facelets
- For each .jsp file:
- rename file xxx.jsp to xxx.xhtml
- insert the xhtml doctype tag at the very top
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- add namespaces to the root level xml element
<f:view xmlns="http://www.w3.org/1999/xhtml" xmlns:ui="http://java.sun.com/jsf/facelets">or
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:ui="http://java.sun.com/jsf/facelets">
- remove jsp directives, change
<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h"%> <%@ taglib uri="http://java.sun.com/jsf/core" prefix="f"%>
xmlns:h="http://java.sun.com/jsf/html" xmlns:f="http://java.sun.com/jsf/core"after the other xmlns: attributes in 3.c. above
- add the xmlns: of any other jsf libs (tomahawk, tobago, htmlib, ...) to the end, after C.d above
- for each jsf lib you add, you must put the corresponding taglib.xml file under .../WEB-INF/
- convert other jsp tags, e.g.
<% /* my comment */ %>becomes
<!-- my comment -->
Note that you will probably want to use the following instead of <!-- my comment --> as standard html comments are stripped by default and treated as literal text block components if re-enabled.
- change all xml entities to numerical form, e.g.
This should get you to the point where your application works as facelets. From there, you can start using the facelets features.