More Control Edit (Using BeanEditor) (1)

BeanEditForm is a component that combines 3 other components: BeanEditor, Form, and Errors.
When we need more control we can do the same: instead of using BeanEditForm we can combine those 3 components and add others if needed.
Here we have added a "Refresh" link.
References: BeanEditor, Form, Errors, BeanEditForm.tml, beaneditor package, Hidden.


The source for IPersonFinderServiceLocal, IPersonManagerServiceLocal, and @EJB is shown in the Session Beans and @EJB examples.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "">
<!-- We need a doctype to allow us to use special characters like &nbsp; 
     We use a "strict" DTD to make IE follow the alignment rules. -->
<html xmlns:t="" xmlns:p="tapestry:parameter">
<body class="container">
    <h3>More Control Edit (Using BeanEditor) (1)</h3>
    BeanEditForm is a component that combines 3 other components: BeanEditor, Form, and Errors.<br/>
    When we need more control we can do the same: instead of using BeanEditForm we can combine those 3 components and add others if needed.<br/>
    Here we have added a "Refresh" link.
    <div class="eg">
        <t:form t:id="personform">
            <t:errors globalOnly="true"/>
            <div class="t-beaneditor">
                <t:if test="person">
                    <t:beaneditor t:id="person" object="person">
                        <!-- If optimistic locking is not needed then comment out this next bit. It works because Hidden fields are part of the submit. -->
                            <t:hidden value="person.version"/>
                    <div class="t-beaneditor-row">
                        <t:submit value="Save"/>&nbsp;
                        <t:eventlink event="refresh" class="btn btn-default">Refresh</t:eventlink>&nbsp;
                <t:if test="!person">
                    <div class="alert alert-danger">Person ${personId} does not exist.</div>

    <a href="">BeanEditor</a>, 
    <a href="">Form</a>, 
    <a href="">Errors</a>, 
    <a href="">
    <a href="">beaneditor package</a>, 
    <a href="">Hidden</a>.<br/><br/>

    <t:pagelink page="Index">Home</t:pagelink><br/><br/>
    The source for IPersonFinderServiceLocal, IPersonManagerServiceLocal, and @EJB is shown in the Session Beans and @EJB examples.<br/><br/>

        <t:sourcecodetab src="/web/src/main/java/jumpstart/web/pages/examples/input/MoreControlEdit1.tml"/>
        <t:sourcecodetab src="/web/src/main/java/jumpstart/web/pages/examples/input/"/>
        <t:sourcecodetab src="/web/src/main/resources/META-INF/assets/css/examples/plain.css"/>
        <t:sourcecodetab src="/business/src/main/java/jumpstart/business/domain/person/"/>
        <t:sourcecodetab src="/business/src/main/java/jumpstart/business/domain/person/"/>

package jumpstart.web.pages.examples.input;

import javax.ejb.EJB;

import jumpstart.util.ExceptionUtil;

import org.apache.tapestry5.annotations.Import;
import org.apache.tapestry5.annotations.InjectComponent;
import org.apache.tapestry5.annotations.InjectPage;
import org.apache.tapestry5.annotations.Property;
import org.apache.tapestry5.corelib.components.Form;

@Import(stylesheet = "css/examples/plain.css")
public class MoreControlEdit1 {

    // The activation context

    private Long personId;

    // Screen fields

    private Person person;

    // Other pages

    private MoreControlEdit2 page2;

    // Generally useful bits and pieces

    private Form form;

    private IPersonFinderServiceLocal personFinderService;

    private IPersonManagerServiceLocal personManagerService;

    // The code

    // onActivate() is called by Tapestry to pass in the activation context from the URL.

    void onActivate(Long personId) {
        this.personId = personId;

    // onPassivate() is called by Tapestry to get the activation context to put in the URL.

    Long onPassivate() {
        return personId;

    // Form bubbles up the PREPARE_FOR_RENDER event during form render.

    void onPrepareForRender() {

        // If fresh start, make sure there's a Person object available.

        if (form.isValid()) {
            person = findPerson(personId);
            // Handle null person in the template (with an If component).


    // Form bubbles up the PREPARE_FOR_SUBMIT event during form submission.

    void onPrepareForSubmit() {

        // Get Person object for the form fields to overlay.
        person = findPerson(personId);

        if (person == null) {
            form.recordError("Person has been deleted by another process.");
            // Instantiate an empty person to avoid NPE in the form.
            person = new Person();

    void onValidateFromPersonForm() {

        if (person.getFirstName() != null && person.getFirstName().equals("Acme")) {
            form.recordError("First Name must not be Acme.");

        if (personId == 2 && !person.getFirstName().equals("Mary")) {
            form.recordError("First Name for this person must be Mary.");

        if (form.getHasErrors()) {
            // We get here only if a server-side validator detected an error.

        try {
        catch (Exception e) {
            // Display the cause. In a real system we would try harder to get a user-friendly message.

    Object onSuccess() {
        return page2;

    void onRefresh() {
        // By doing nothing the page will be displayed afresh.

    private Person findPerson(Long personId) {
        // Ask business service to find Person
        Person person = personFinderService.findPerson(personId);

        if (person == null && personId < 4) {
            throw new IllegalStateException("Database data has not been set up!");

        // Handle null person in the template (with an If component).

        return person;

.eg {
                margin: 20px 0;
                padding: 14px;
                border: 1px solid #ddd;
                border-radius: 6px;
                -webkit-border-radius: 6px;
                -mox-border-radius: 6px;


import java.util.Date;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.EnumType;
import javax.persistence.Enumerated;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.PrePersist;
import javax.persistence.PreUpdate;
import javax.persistence.Temporal;
import javax.persistence.TemporalType;
import javax.persistence.Version;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;

 * The Person entity.
public class Person implements Serializable {

    @GeneratedValue(strategy = GenerationType.AUTO)
    @Column(nullable = false)
    private Long id;

    @Column(nullable = false)
    private Integer version;

    @Column(length = 10, nullable = false)
    @Size(max = 10)
    private String firstName;

    @Column(length = 10, nullable = false)
    @Size(max = 10)
    private String lastName;
    private Regions region;

    private Date startDate;

    public String toString() {
        final String DIVIDER = ", ";
        StringBuilder buf = new StringBuilder();
        buf.append(this.getClass().getSimpleName() + ": ");
        buf.append("id=" + id + DIVIDER);
        buf.append("version=" + version + DIVIDER);
        buf.append("firstName=" + firstName + DIVIDER);
        buf.append("lastName=" + lastName + DIVIDER);
        buf.append("region=" + region + DIVIDER);
        buf.append("startDate=" + startDate);
        return buf.toString();

    // Default constructor is required by JPA.
    public Person() {

    public Person(String firstName, String lastName, Regions region, Date startDate) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.region = region;
        this.startDate = startDate;

    // The need for an equals() method is discussed at
    public boolean equals(Object obj) {
        return (obj == this) || (obj instanceof Person) && id != null && id.equals(((Person) obj).getId());

    // The need for a hashCode() method is discussed at

    public int hashCode() {
        return id == null ? super.hashCode() : id.hashCode();

    public void validate() throws ValidationException {


    public Long getId() {
        return id;

    public Integer getVersion() {
        return version;

    public void setVersion(Integer version) {
        this.version = version;

    public String getFirstName() {
        return firstName;

    public void setFirstName(String firstName) {
        this.firstName = firstName;

    public String getLastName() {
        return lastName;

    public void setLastName(String lastName) {
        this.lastName = lastName;

    public Regions getRegion() {
        return region;

    public void setRegion(Regions region) {
        this.region = region;

    public Date getStartDate() {
        return startDate;

    public void setStartDate(Date startDate) {
        this.startDate = startDate;



public enum Regions {