Converters in xPages is a powerful feature. One can use predefined converter such as DateTime or Number converter, but how about a custom converter? It can be accomplished simply using a CustomConverter and SSJS.
But how about something even more complex?
Let’s say, we need to have a NotesName converter, such as Names field in Notes client. We want all values in this field to be converted to an abbreviated form of NotesName.
First of all, we need to create a new java object. Let’s call it NamesConverter.
Note: Can be used Code\Java on Domino 8.5.3 and higher, or simply use a Designer Eclipse View, called Navigator to write your object to your custom path. Don’t forget to add this path to a Build Path of your Eclipse Project.
Your converter object must implement a javax.faces.convert.Converter interface, which brings us two methods: getAsObject and getAsString. Both of them must be implemented. See the full implementation of our java converter:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 |
package converters;
import java.util.ArrayList;
import javax.faces.component.UIComponent;
import javax.faces.context.FacesContext;
import javax.faces.convert.Converter;
import lotus.domino.Name;
import lotus.domino.NotesException;
import com.ibm.xsp.model.domino.DominoUtils;
public class NamesConverter implements Converter {
private Name createName(String name) {
Name n = null;
try {
n = DominoUtils.getCurrentSession().createName(name);
} catch (NotesException e) {
e.printStackTrace();
}
return n;
}
public Object getAsObject(FacesContext context, UIComponent component, String value) {
String[] names = value.split(",");
Name name = null;
ArrayList tmpNames = new ArrayList();
for (int i = 0; i <= names.length - 1; i++) {
name = this.createName(names[i].trim());
try {
tmpNames.add(name.getAbbreviated());
} catch (NotesException e) {
e.printStackTrace();
}
}
return tmpNames.toString().replace("[", "").replace("]", "");
}
public String getAsString(FacesContext context, UIComponent component, Object value) {
String[] names = value.toString().split(",");
Name name = null;
ArrayList tmpNames = new ArrayList();
for (int i = 0; i <= names.length - 1; i++) {
name = this.createName(names[i].trim());
try {
tmpNames.add(name.getAbbreviated());
} catch (NotesException e) {
e.printStackTrace();
}
}
return tmpNames.toString().replace("[", "").replace("]", "");
}
} |
Your new converter needs to be registered in faces-config.xml file:
Note: This file is located in Eclipse project (again Window\Show Eclipse Views\Navigator) right down: WebContent\WEB-INF\faces-config.xml.
|
1 2 3 4 |
<converter>
<converter-id>nameConverter</converter-id>
<converter-class>converters.NameConverter</converter-class>
</converter> |
At last, one can then use this registered converter in an xPage, in a very simple way:
|
1 2 3 4 5 |
<xp:inputText id="userName" style="width:300px">
<xp:this.converter>
<xp:converter converterId="nameConverter" />
</xp:this.converter>
</xp:inputText> |
And that is all. We have a highly scalable way how to implement converters in the backend java code. Why using SSJS, then? 
Komentování je uzavřeno.