{"id":594,"date":"2012-04-01T13:27:43","date_gmt":"2012-04-01T11:27:43","guid":{"rendered":"http:\/\/hasselba.ch\/blog\/?p=594"},"modified":"2012-04-01T13:37:23","modified_gmt":"2012-04-01T11:37:23","slug":"objectdatasource-kleines-how-to","status":"publish","type":"post","link":"https:\/\/hasselba.ch\/blog\/?p=594","title":{"rendered":"ObjectDataSource: Kleines „How To“"},"content":{"rendered":"

Mit der Extension Library bzw. dem Upgrade Pack 1 ist f\u00fcr XPages eine neue Datasource-Komponente hinzugekommen, die ObjectDataSource<\/em>. Diese Datasource kann wie die Standard-Datasources f\u00fcr View und Dokument ebenfalls an den verschiedensten Elementen einer XPage angehangen werden, d.h. sowohl an die UIViewRoot<\/em> der XPage, als auch in Custom Controls, Repeat Controls oder sonstigen Elementen, die eine DataSource verwenden.<\/p>\n

Grundlegend gilt f\u00fcr ObjectDataSources<\/em>, das sie beliebige Java-Objekte beinhalten k\u00f6nnen, solange die Objekte selbst serialisierbar<\/a> sind, also das Interface java.io.Serializable <\/a>implementieren. Hier ein einfaches Beispiel eines Java-Objektes:<\/p>\n

package ch.hasselba.extlib.demo;\r\n\r\nimport java.io.Serializable;\r\n\r\npublic class ObjectDataDemo implements Serializable {\r\n\r\n\u00a0\u00a0 \u00a0long timeStamp;\r\n\r\n\u00a0\u00a0 \u00a0public ObjectDataDemo(){\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0this.update();\r\n\u00a0\u00a0 \u00a0}\r\n\r\n\u00a0\u00a0 \u00a0public void update(){\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0this.timeStamp = java.lang.System.currentTimeMillis();\r\n\u00a0\u00a0 \u00a0}\r\n\r\n\u00a0\u00a0 \u00a0public long getTimeStamp() {\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0return timeStamp;\r\n\u00a0\u00a0 \u00a0}\r\n\r\n}<\/pre>\n
Die Java-Klasse ist einfach aufgebaut und liefert den Zeitstempel zur\u00fcck, der beim letzten Aufruf der update()<\/em>-Methode gesetzt wurde. Um die Klasse in der XPage verwenden zu k\u00f6nnen, muss sie nur in einem Source-Folder bereitgestellt sein, der dem Build-Path hinzugef\u00fcgt wurde bzw. die Klasse im neuen „JavaCode“-Ordner\u00a0 abgelegt sein – eine Modifikation der faces-config.xml<\/em> ist nicht n\u00f6tig.<\/p>\n
Mittels der createObject<\/em>-Eigenschaft der ObjectDataSource<\/em> wird die XPage dazu veranlasst, eine Instanz der Klasse anzulegen, womit das instanzierte Objekte der ObjectDataSource<\/em> geh\u00f6rt; um die Stabilit\u00e4t einer Applikation nicht zu gef\u00e4hrden und unerwartete Ergebnisse zu provozieren, sollten die Objekte daher nicht<\/span> anderweitig gespeichert werden (z.B. in Managed Beans o.\u00e4.).<\/p>\n
<xp:this.data>\r\n\u00a0\u00a0 <xe:objectData var=\"objectData1\" scope=\"view\"\r\n\u00a0\u00a0\u00a0\u00a0\u00a0 createObject<\/strong>=\"#{javascript:\r\n         new ch.hasselba.extlib.demo.ObjectDataDemo();}\">\r\n\u00a0\u00a0 <\/xe:objectData>\r\n<\/xp:this.data><\/pre>\n
Eine ObjectDataSource<\/em> hat neben dem zu verwendenden scope<\/em> auch noch die Eigenschaft var<\/em>, die (wie bei den anderen Datasources auch) den programmatischen Namen darstellt, mit dem die DataSource referenziert werden kann. In diesem Fall ist das Objekt und alle Eigenschaften\/Methoden des Objektes \u00fcber objectData1<\/em> zu erreichen:<\/p>\n
<xp:label id=\"label1\"\r\n   value=\"#{javascript:objectData1.getTimeStamp()<\/strong>}\" \/><\/pre>\n
Da z.B. ein Partial Refresh die Datasources nicht jedesmal neuberechnet, muss ein eventuell ben\u00f6tigter Update-Mechanismus selbst implementiert werden. In diesem Beispiel dient daf\u00fcr die Methode update()<\/em>, die im Backend aufgerufen werden kann:<\/p>\n
<xp:button value=\"Label\" id=\"button1\">\r\n\u00a0\u00a0 <xp:eventHandler event=\"onclick\" submit=\"true\"\r\n      refreshMode=\"partial\" refreshId=\"label1\">\r\n\u00a0\u00a0\u00a0\u00a0\u00a0 <xp:this.action>\r\n         <![CDATA[#{javascript:objectData1.update()<\/strong>}]]>\r\n      <\/xp:this.action>\r\n\u00a0\u00a0 <\/xp:eventHandler>\r\n<\/xp:button><\/pre>\n
[Button ruft die Update-Funktion auf, label1 wird refresht und neuer Zeitstempel angezeigt]<\/em><\/p>\n
Die ObjectDataSources<\/em> besitzen eine weitere Eigenschaft namens saveObject<\/em>. Diese Eigenschaft ist optional und nur erforderlich, wenn man beabsichtigt, auf ein Speichern der DataSources reagieren zu wollen (um z.B. Daten ins Backend zu speichern, o.\u00e4.).<\/p>\n
Achtung:<\/strong><\/p>\n
Einige Methodennamen d\u00fcrfen in der Java-Klasse nicht verwendet werden, da dies sonst zu Problemen mit der bestehenden Architektur kommen kann. Namen wie save<\/em>() oder load<\/em>() sind zu vermeiden!<\/p>\n","protected":false},"excerpt":{"rendered":"
Mit der Extension Library bzw. dem Upgrade Pack 1 ist f\u00fcr XPages eine neue Datasource-Komponente hinzugekommen, die ObjectDataSource. Diese Datasource kann wie die Standard-Datasources f\u00fcr View und Dokument ebenfalls an den verschiedensten Elementen einer XPage angehangen werden, d.h. sowohl an … 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":[36,89,26,76,74],"tags":[33,7,37,91,31,86,5,3],"class_list":["post-594","post","type-post","status-publish","format-standard","hentry","category-extlib","category-java","category-jsf","category-ssjs","category-xpages","tag-8-5-3","tag-domino","tag-extension-library","tag-extlib","tag-java","tag-jsf","tag-ssjs","tag-xpages"],"_links":{"self":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/594","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=594"}],"version-history":[{"count":7,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/594\/revisions"}],"predecessor-version":[{"id":600,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/594\/revisions\/600"}],"wp:attachment":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=594"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=594"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=594"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}