Skip to main content

Killing SSJS - Passing a parameter using Expression Language - Part 1

Expression Language is a powerful and useful tool, but it doesn't handle parameterized methods (other than Map.get(Object) and DataObject.getValue(Object)). That means if you need to do anything more complicated than simple data retrieval, you have to jump through some hoops. I'm going help you get started here.

I've posted this code before, but here is one simple trick:

public class BaseDataModel implements DataObject, Serializable {
    private static final long serialVersionUID = 1L;

    private Map<Object, Object> values;

    public Class<?> getType(Object key) {
        Object o = getValue(key);
        return o == null ? null : o.getClass();
    }

    public final Object getValue(Object key) {
        try {
            return customGetter(key);
        }
        catch (NoSuchMethodException e) {
            return getMapValue(key);
        }
    }

    protected Object customGetter(Object keyObj) throws NoSuchMethodException {
        if (keyObj instanceof String) {
            String key = (String) keyObj;
            if (key.startsWith("isReadOnly") && key.length() > "isReadOnly".length()) {
                String property = key.substring("isReadOnly".length());
                property = property.substring(0, 1).toLowerCase() + property.substring(1);
                }
                return isReadOnly(property);
            }
        }
        throw new NoSuchMethodException();
    }

    public final void setValue(Object key, Object value) {
        if (isReadOnly(key)) return;
        try {
            customSetter(key, value);
        }
        catch (NoSuchMethodException e) {
            setMapValue(key, value);
        }
    }

    protected void customSetter(Object key, Object value) throws NoSuchMethodException {
        throw new NoSuchMethodException();
    }

    public boolean isReadOnly(Object key) {
        return false;
    }

    protected Map<Object, Object> getValues() {
        if (values == null) {
            values = new HashMap<Object, Object>();
        }
        return values;
    }

    public final Object getMapValue(Object key) {
        return getValues().get(key);
    }

    public final void setMapValue(Object key, Object value) {
        getValues().put(key, value);
    }

    private Set<Object> getKeys() {
        return this.getValues() == null ? null : this.getValues().keySet();
    }
}


This allows you to use an EL expresssion like "#{bean.isReadOnlyFirstName}". This is extendable so you can extend the customGetter() to support prefixes like hasPermissionEdit or getRelatedData. The customGetter intercepts the getValue method and if any patterns are matched, it supplies the result, otherwise the value from the Map is returned. I have been using this for great effect for months since I worked it out.

However, there are some big limitations to this technique:

1) You can't compute any part of the expression. You can't really use this technique in a custom control where you have to use a passed value. You can't really do something like #{getNameFromDoc(DocumentId)}. Caveat: There is a hack I've seen that allows you to do something like ${javascript:'#{isReadOnly'+compositeData.fieldName+'}'"}, but now we're using SSJS to compute EL and that seems to make things worse rather than better.

2) You can't use a hierarchical EL expression like {bean.getFullName.getUserDirectory.getFolderMyDocuments}.

In Part 2: a better solution.

Comments

Popular posts from this blog

XPages Application Framework (Part 1?)

Note: I changed projects and priorities after my last POI article, resulting in a long hiatus. I anticipate using that framework on my current project and will likely refine and complete my related article series. For the past several months, I've been fortunate enough to lead a project overhaul from traditional Domino Webapp to XPages. I had a few goals in mind, but the top three were integrating Bootstrap, embracing MVC principles, and eliminating all SSJS . I imagine the motivation for Bootstrap integration is self-explanatory. There is an OpenNTF project out there called Bootstrap4XPages. I didn't use that for a number of reasons - the main being a policy in the current environment. But you may ask yourself (if you didn't follow that link), why so much hatred for SSJS? I have a litany of reasons. It impacts readability of the XPage source; it hurts maintainability when logic is scattered across dozens of XPages, custom controls, and script libraries; it mixes log...

Killing SSJS - Passing a parameter using Expression Language - Part 2

In part 1, I showed how you can expand the DataObject implementation to allow you to pass a parameter to a method and return the result. It's not a perfectly elegant solution, and it has some limitations, but it's a very solid technique and not at all difficult to implement or maintain. But I kept running into roadblocks. What if I have to compute part of the expression? What if I have to get a value based on another parameterized getter? You can't compute part of an EL expression in your EL. So after some research and experimentation, I created the GetMap. This isn't a new concept - it was developed for JSF 1.1 (which is what XPages is built on) but the rest of the world has moved on to JSF 2.0 and so some of these older techniques can be a little tricky to unearth since this hasn't been an issue in the JSF world for years.

Rows per page selection: Part 2

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. Problem 2: When the page refreshed, the combobox value always reverted back to the default It turns out that the Integer value stored in the viewScope doesn't get run through the converter back to a string before being compared to options. I needed a way to calculate the option values so that they would be Integers. This is also not the first time I've run into issues where I need a value to be of a different type, and I see questions like this on StackOverflow from time to time. I attempted a few minor things before I realized I needed to break out my old stand-by, the GetMap . The GetMap is just a fake Map implementation that takes the key and transforms it or uses it to look up some other value. In this case, we are doing the f...