RAMADDA Developer Notes

RAMADDA User Guide

15.7 RAMADDA Developer Notes

Forms should be placed with a a 2 column table. The labels should be right bold and right aligned. You can use some HtmlUtil methods to help:

        sb.append(HtmlUtil.formTable());
        sb.append(HtmlUtil.formEntry("Subject:",
                                     HtmlUtil.input(ARG_SUBJECT, subject,
                                         HtmlUtil.SIZE_40)));
        sb.append(HtmlUtil.formEntryTop("Comment:",
                                        HtmlUtil.textArea(ARG_COMMENT,
                                            comment, 5, 40)));
        sb.append(HtmlUtil.formTableClose());

The formTable just creates a table with a certain padding. the formEntry method takes a label and some content. Note: if the content is tall (e.g., a text area) then use formEntryTop - this does a valign="top" in the table row so that the label is aligned at the top, not in the center.

When the repository receives a call that makes some change to the state (e.g., a form post for adding or changing a new entry) it should always redirect to some other URL after processing the request. That way if the user goes back or does a reload in the browser it doesn't apply the change again.
You can add on an ARG_MESS url argument to show some response. e.g:
```
                return new Result(HtmlUtil.url(URL_ENTRY_SHOW, ARG_ID,
                        entry.getId(), ARG_MESSAGE,
                        "Some message here"));
```

When you want to show some message or warning to the user (e.g., from the AG_MESSAGE above) use the Repository.note or Repository.warning methods:

        if (request.exists(ARG_MESSAGE)) {
            sb.append(getRepository().note(request.getUnsafeString(ARG_MESSAGE, "")));
        }

or:

            sb.append(getRepository().warning("Some error"));