{"id":1028,"date":"2012-10-24T13:43:16","date_gmt":"2012-10-24T11:43:16","guid":{"rendered":"http:\/\/hasselba.ch\/blog\/?p=1028"},"modified":"2012-10-24T16:49:54","modified_gmt":"2012-10-24T14:49:54","slug":"quick-n-dirty-use-your-own-factory-classes-in-xpages2-the-virtualpagetransformer","status":"publish","type":"post","link":"https:\/\/hasselba.ch\/blog\/?p=1028","title":{"rendered":"Quick-n-Dirty: Use your own Factory classes in XPages (2) – The VirtualPageTransformer"},"content":{"rendered":"

While playing a little bit with core XPages functionality I found the interesting VirtualPageTransformer<\/em> interface. With this interface it is possible to implement „virtual“ XPages, and this allows to do something which can be described like an url mapping (the $$OpenDominoDocument.xsp<\/em> url for example was implemented this way).<\/p>\n

To do create your own transformations you have to do the following:<\/p>\n

1. Read the first article about using Factory classes<\/a> in XPages and create the required \/WEB_INF\/com.ibm.xsp.factories.properties<\/em> file in your database<\/p>\n

2. In this file add a new entry for the page transformer class to use:<\/p>\n

PageTransformer=ch.hasselba.factory.PageTransformer<\/pre>\n
You can choose every key name you want for the factory. The class will be identified from the XPages runtime by the implemented interface com.ibm.xsp.page.VirtualPageTransformer<\/em>.<\/p>\n
3. Create a java class which implements this interface:<\/p>\n
package ch.hasselba.factory;\r\n\r\nimport com.ibm.xsp.page.VirtualPageTransformer;\r\nimport com.ibm.xsp.FacesExceptionEx;\r\nimport javax.faces.context.FacesContext;\r\n\r\npublic class PageTransformer implements VirtualPageTransformer {\r\n\r\n\u00a0\u00a0 \u00a0public boolean isVirtualPage(FacesContext fc, String pStr) {\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0return (pStr.indexOf(\"$$VirtualPage$$\") > (-1));\r\n\u00a0\u00a0 \u00a0}\r\n\r\n\u00a0\u00a0 \u00a0public String transformPageName(FacesContext fc, String pStr) {\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0try {\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0return \"\/Test.xsp\";\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0} catch (Exception e) {\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0throw new FacesExceptionEx(\"Error! \" + e.getMessage());\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0}\r\n\u00a0\u00a0 \u00a0}\r\n}<\/pre>\n
This adds the „virtual“ page handler „$$VirtualPage$$<\/em>“ to your database.<\/p>\n
This means that every request to your\u00a0 database is checked if the keyword is contained in the url. For this test, the method isVirtualPage<\/em> is called with the current url as parameter. If this method returns true, the method transformPageName<\/em> is called; this method must return a string which identifies the XPage to use. In this case, it is the XPage „Test.xsp<\/em>“<\/p>\n
If you open this URL…<\/p>\n
http:\/\/localhost\/Factories.nsf\/$$VirtualPage$$.xsp\/blahblahblah\/blubb\/blubb\/?etc=etc<\/pre>\n
… the XPage „Test.xsp“ is rendered instead.<\/p>\n
\"\"<\/p>\n
You can add as much VirtualPageTransformers you want to a database.<\/p>\n
P.S.\u00a0Keep in mind that this article has been posted in the \u201cQuick-n-Dirty<\/strong>\u201d category.<\/p>\n","protected":false},"excerpt":{"rendered":"
While playing a little bit with core XPages functionality I found the interesting VirtualPageTransformer interface. With this interface it is possible to implement „virtual“ XPages, and this allows to do something which can be described like an url mapping (the … Weiterlesen →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[89,26,74],"tags":[33,7,31,32,3],"class_list":["post-1028","post","type-post","status-publish","format-standard","hentry","category-java","category-jsf","category-xpages","tag-8-5-3","tag-domino","tag-java","tag-tipp","tag-xpages"],"_links":{"self":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/1028","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1028"}],"version-history":[{"count":6,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/1028\/revisions"}],"predecessor-version":[{"id":1035,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/1028\/revisions\/1035"}],"wp:attachment":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1028"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1028"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1028"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}