Skip to main content

Using a non-managed bean with an XPage

For a long time, every time I wanted to create a controller or model bean, I wrote it and then added it to my managed beans in faces-config. But this can create a very bloated faces config, particularly when these beans are only used by a single XPage. Then I learned about dataContext.

A dataContext can be created for any container all the way up to the xp:view element, which allows for great flexibility. It works like this:

<xp:this.dataContexts>
  <xp:dataContext var="beanVar">
    <xp:this.value><![CDATA[${javascript:
      var unid = param.get("unid");
      var notice:package.Notice = new package.Notice(unid);
      return notice;}]]></xp:this.value>
  </xp:dataContext>
</xp:this.dataContexts>

This bean can then be bound to controls like so:
<xp:text id="name" value="#{beanVar.name}"></xp:text>

If the bean returns a collection, this can be used as a data source for a repeat control like so:
<xp:repeat id="repeatItems" value="#{beanVar.itemList}" var="item" rows="50">
  <div class="row>
    <xp:text id="itemName" value="#{item.name}">
    <xp:text id="itemQty" value="#{item.quantity}">
  </div>
</xp:repeat>

So it works just like a managed bean except it is declared in the XPage instead of faces-config. This has the added benefit of making it clearer where the bean variable name is coming from when you are looking at the XPage in the future.

Comments

Popular posts from this blog

Pass data between XPages and existing LS scripts

I'm working on modernizing a fairly hefty application with a lot of existing script libraries which we want to leverage within the XPages environment. Here is a technique that works very well. First, create an in-memory document in SSJS. We can set any input values needed for the back end. Then we pass that document to a LS Agent which can work it's magic using the values set in SSJS and use the same document to return values back to the XPage. Here is how it works in detail:

Rows per page selection: Part 1

I was asked to create a control that would allow users to select the number of rows per page in a view/repeat control (the application uses both). It seemed simple at first, but I ran into a few issues that I thought I'd share the solutions to. First, lets start at the beginning. I went through the relevant design elements and set row="#{viewScope.tableRows}" , and I created an xp:comboBox with value="#{viewScope.tableRows}" and added items for 20, 30, 50, and 100, and I assigned it an onChange event handler that did a partial execution and partial refresh of a div containing the combo box, pager and the table. Then I started fixing all the problems. Problem 1: The combobox value was a string, but the rows parameter requires an integer. This was causing IllegalArgumentException / java.lang.String incompatible with java.lang.Integer. I added a NumberConverter, but this only slightly changed the exception message to java.lang.Long incompatible with java.lang....

Quick tip: Convert a number to String in EL

I just had a need to do this and a Google search didn't immediately turn up a solution. So I thought for a couple of minutes and came up with this: value="0#{numberVar}" This takes advantage of the way Java auto-converts objects to strings when doing a concatenation. So if your number is 13, Java EL turns this into new String("0"+13), which becomes "013". You can then strip off the leading zero or just parse the string back into a number.