知識庫 / Spring / Spring MVC RSS 訂閱

Male: <form:radiobutton path="sex" value="M"/>
Female: <form:radiobutton path="sex" value="F"/>

典型的使用模式通常涉及多個標籤實例，這些實例具有不同的值綁定到同一個屬性上：

private String sex;

就像 <em >checkboxes</em > 標籤一樣，<em >radiobuttons</em > 標籤也會渲染多個 HTML <em >input</em > 標籤，其中 <em >type=’radio’</em >：

<form:radiobuttons items="${jobItem}" path="job" />

在這種情況下，我們可能希望將可用的選項作為Array、List或Map傳遞，其中包含可用的選項，並存儲在items屬性中：

List<String> jobItem = new ArrayList<String>();
jobItem.add("Full time");
jobItem.add("Part time");

7. select 標籤

此標籤渲染一個 HTML 的 select 元素：

<form:select path="country" items="${countryItems}" />

為了生成我們傳遞到 Array、List 或 Map 中可用的選項，請在 items 屬性中提供一個包含這些選項的列表。 再次強調，我們可以在控制器內部初始化我們的值：

Map<String, String> countryItems = new LinkedHashMap<String, String>();
countryItems.put("US", "United States");
countryItems.put("IT", "Italy");
countryItems.put("UK", "United Kingdom");
countryItems.put("FR", "France");

<select> 標籤也支持使用嵌套的 <option> 和 <options> 標籤。

雖然 <option> 標籤渲染一個 HTML <option> 元素，但 <options> 標籤渲染一個 HTML <option> 元素的列表。

<options> 標籤接受一個包含 items 屬性中可用選項的 Array、List 或 Map，就像 <select> 標籤一樣：

<form:select path="book">
    <form:option value="-" label="--Please Select--"/>
    <form:options items="${books}" />
</form:select>

當我們需要同時選擇多個項目時，我們可以創建一個多選列表框。要渲染這種類型的列表，只需在<select>標籤中添加<em multiple=”true”> 屬性。

<form:select path="fruit" items="${fruit}" multiple="true"/>

這裏，bound屬性是一個數組或一個java.util.Collection：

List<String> fruit;

8. 隱藏標籤 (Hidden Tag)

此標籤會渲染一個 HTML input 標籤，並使用綁定值，設置 type=’hidden’。

<form:hidden path="id" value="12345" />

9. Errors 標籤

字段錯誤消息由與控制器相關的驗證器生成。我們可以使用 Errors 標籤來渲染這些字段錯誤消息：

<form:errors path="name" cssClass="error" />

這段字段會顯示指定在 path屬性中的錯誤。錯誤消息默認渲染在 span標籤內，並將 path值作為 id附加，並可選擇從 cssClass屬性中獲取CSS類，用於對輸出進行樣式設置：

<span id="name.errors" class="error">Name is required!</span>

為了使用不同的元素（而不是默認的 span 標籤）來包含錯誤消息，我們可以通過在 element 屬性中指定所需的元素來實現：

<form:errors path="name" cssClass="error" element="div" />

這段代碼會渲染錯誤消息，並將其包含在 div 元素內：

<div id="name.errors" class="error">Name is required!</div>

除了能夠針對特定輸入元素顯示錯誤之外，我們還可以顯示給定頁面上所有錯誤的完整列表（不考慮字段）。這通過使用通配符 * 實現的：

<form:errors path="*" />

9.1. 驗證器

為了顯示給定字段中的錯誤，我們需要定義一個驗證器：

public class PersonValidator implements Validator {

    @Override
    public boolean supports(Class clazz) {
        return Person.class.isAssignableFrom(clazz);
    }

    @Override
    public void validate(Object obj, Errors errors) {
        ValidationUtils.rejectIfEmptyOrWhitespace(errors, "name", "required.name");
    }
}

在這種情況下，如果字段 name 為空，則驗證器會返回由 從資源包中標識的錯誤消息。

<bean class="org.springframework.context.support.ResourceBundleMessageSource" id="messageSource">
     <property name="basename" value="messages" />
</bean>

@Bean
public MessageSource messageSource() {
    ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
    messageSource.setBasenames("messages");
    return messageSource;
}

required.name = Name is required!

@RequestMapping(value = "/addPerson", method = RequestMethod.POST)
public String submit(
  @ModelAttribute("person") Person person, 
  BindingResult result, 
  ModelMap modelMap) {

    validator.validate(person, result);

    if (result.hasErrors()) {
        return "personForm";
    }
    
    modelMap.addAttribute("person", person);
    return "personView";
}

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>8.0.1.Final</version>
</dependency>

<mvc:annotation-driven/>

@EnableWebMvc
@Configuration
public class ClientWebConfigJava implements WebMvcConfigurer {
    // All web configuration will go here
}

@RequestMapping(value = "/addPerson", method = RequestMethod.POST)
public String submit(
  @Valid @ModelAttribute("person") Person person, 
  BindingResult result, 
  ModelMap modelMap) {
 
    if(result.hasErrors()) {
        return "personForm";
    }
     
    modelMap.addAttribute("person", person);
    return "personView";
}

@NotEmpty
private String password;

NotEmpty.person.password = Password is required!