This tutorial shows how property editors are used when XML configuration is used to initialize beans.
When XML configuration is used, setting properties on beans is done by using PropertyEditor implementations. When we use String as the value of a property of some bean that we declare in an XML file, Spring uses an appropriate PropertyEditor to convert String to the target type.
Examples
Use of default PropertyEditors
src/main/resources/spring-config.xml<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="customer" class="com.logicbig.example.XmlConfigExample.Order">
<property name="amount" value="102"/>
<property name="currency" value="USD"/>
</bean>
</beans>
spring-property-editors-used-with-xml-config/src/main/java/com/logicbig/example/XmlConfigExample.javapackage com.logicbig.example;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import java.util.Currency;
public class XmlConfigExample {
public static void main(String[] args) {
ClassPathXmlApplicationContext context =
new ClassPathXmlApplicationContext("spring-config.xml");
Order order = context.getBean(Order.class);
System.out.println(order);
System.out.println("Currency symbol: "+order.getCurrency().getSymbol());
System.out.println("Currency display name: "+order.getCurrency().getDisplayName());
}
static class Order{
private double amount;
private Currency currency;
public double getAmount() {
return amount;
}
public void setAmount(double amount) {
this.amount = amount;
}
public Currency getCurrency() {
return currency;
}
public void setCurrency(Currency currency) {
this.currency = currency;
}
@Override
public String toString() {
return "Order{" +
"amount=" + amount +
", currency=" + currency +
'}';
}
}
}
OutputOrder{amount=102.0, currency=USD}
Currency symbol: $
Currency display name: US Dollar
Using Custom PropertyEditor
src/main/resources/spring-config2.xml<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="customer" class="com.logicbig.example.XmlCustomEditorExample.MyBean">
<property name="price" value="45,678.567"/>
</bean>
<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer">
<property name="propertyEditorRegistrars">
<list>
<bean class="com.logicbig.example.XmlCustomEditorExample.MyCustomEditorRegistrar" />
</list>
</property>
</bean>
</beans>
As seen above, we registered CustomEditorConfigurer as a bean. This allows for convenient registration of custom property editors via it's propertyEditorRegistrars property. In this example our implementation of PropertyEditorRegistrar (MyCustomEditorRegistrar) is going to register CustomNumberEditor with a custom number format.
spring-property-editors-used-with-xml-config/src/main/java/com/logicbig/example/XmlCustomEditorExample.javapackage com.logicbig.example;
import org.springframework.beans.PropertyEditorRegistrar;
import org.springframework.beans.PropertyEditorRegistry;
import org.springframework.beans.propertyeditors.CustomNumberEditor;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import java.text.DecimalFormat;
import java.text.NumberFormat;
public class XmlCustomEditorExample {
public static void main (String[] args) {
ApplicationContext context = new
ClassPathXmlApplicationContext("spring-config2.xml");
MyBean bean = context.getBean(MyBean.class);
System.out.println(bean);
}
public static class MyBean {
private Double price;
public Double getPrice () {
return price;
}
public void setPrice (Double price) {
this.price = price;
}
@Override
public String toString () {
return "MyBean{" + "price=" + price + '}';
}
}
public static class MyCustomEditorRegistrar implements PropertyEditorRegistrar {
@Override
public void registerCustomEditors (PropertyEditorRegistry registry) {
NumberFormat numberFormat = new DecimalFormat("##,###.00");
registry.registerCustomEditor(java.lang.Double.class,
new CustomNumberEditor(java.lang.Double.class,
numberFormat, true));
}
}
}
OutputMyBean{price=45678.567}
Creating a new PropertyEditor
src/main/resources/spring-config3.xml<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="customer" class="com.logicbig.example.XmlNewEditorExample.Customer">
<property name="customerName" value="Steve Thomas"/>
<property name="phone" value="cell | 907-111-2123"/>
</bean>
<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer">
<property name="customEditors">
<map>
<entry key="com.logicbig.example.XmlNewEditorExample$Phone"
value="com.logicbig.example.XmlNewEditorExample$CustomPhoneEditor"/>
</map>
</property>
</bean>
</beans>
package com.logicbig.example;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import java.beans.PropertyEditorSupport;
public class XmlNewEditorExample {
public static void main (String[] args) {
ApplicationContext context = new
ClassPathXmlApplicationContext("spring-config3.xml");
Customer bean = context.getBean(Customer.class);
System.out.println(bean);
}
public static class Customer {
private String customerName;
private Phone phone;
public String getCustomerName () {
return customerName;
}
public void setCustomerName (String customerName) {
this.customerName = customerName;
}
public Phone getPhone () {
return phone;
}
public void setPhone (Phone phone) {
this.phone = phone;
}
@Override
public String toString () {
return "Customer{" +
"customerName='" + customerName + '\'' +
", phone=" + phone +
'}';
}
}
public static class Phone {
private String phoneNumber;
private PhoneType phoneType;
public String getPhoneNumber () {
return phoneNumber;
}
public void setPhoneNumber (String phoneNumber) {
this.phoneNumber = phoneNumber;
}
public PhoneType getPhoneType () {
return phoneType;
}
public void setPhoneType (PhoneType phoneType) {
this.phoneType = phoneType;
}
@Override
public String toString () {
return "Phone{" +
"phoneNumber='" + phoneNumber + '\'' +
", phoneType=" + phoneType +
'}';
}
}
public static enum PhoneType {
LAND,
CELL,
WORK
}
public static class CustomPhoneEditor extends PropertyEditorSupport {
@Override
public void setAsText (String text) throws IllegalArgumentException {
String[] split = text.split("[|]");
if (split.length != 2) {
throw new IllegalArgumentException(
"Phone is not correctly defined. The correct format is " +
"PhoneType|111-111-1111");
}
PhoneType phoneType = PhoneType.valueOf(split[0].trim()
.toUpperCase());
Phone phone = new Phone();
phone.setPhoneType(phoneType);
phone.setPhoneNumber(split[1].trim());
setValue(phone);
}
}
}
OutputCustomer{customerName='Steve Thomas', phone=Phone{phoneNumber='907-111-2123', phoneType=CELL}}
In above example we registered PropertyEditor classes via the CustomEditorConfigurer#customEditors property (as opposed to the last example where we used CustomEditorConfigurer#propertyEditorRegistrars). When using customEditors property, Spring will create fresh instances of the specified editor class for each editing attempt. In case we need control over the instantiation process of PropertyEditors, use a PropertyEditorRegistrar to register them. (last example)
Following example shows creating and registering new editor via CustomEditorConfigurer#propertyEditorRegistrars
src/main/resources/spring-config4.xml<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="customer" class="com.logicbig.example.XmlNewEditorExample.Customer">
<property name="customerName" value="Steve Thomas"/>
<property name="phone" value="cell | 907-111-2123"/>
</bean>
<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer">
<property name="propertyEditorRegistrars">
<list>
<bean class="com.logicbig.example.XmlNewEditorExample2.MyCustomEditorRegistrar" />
</list>
</property>
</bean>
</beans>
package com.logicbig.example;
import org.springframework.beans.PropertyEditorRegistrar;
import org.springframework.beans.PropertyEditorRegistry;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
public class XmlNewEditorExample2 {
public static void main(String[] args) {
ApplicationContext context = new
ClassPathXmlApplicationContext("spring-config4.xml");
XmlNewEditorExample.Customer bean = context.getBean(XmlNewEditorExample.Customer.class);
System.out.println(bean);
}
public static class MyCustomEditorRegistrar implements PropertyEditorRegistrar {
@Override
public void registerCustomEditors(PropertyEditorRegistry propertyEditorRegistry) {
propertyEditorRegistry.registerCustomEditor(
XmlNewEditorExample.Phone.class, "phone", new XmlNewEditorExample.CustomPhoneEditor());
}
}
}
OutputCustomer{customerName='Steve Thomas', phone=Phone{phoneNumber='907-111-2123', phoneType=CELL}}
Example ProjectDependencies and Technologies Used: - spring-context 6.1.2 (Spring Context)
Version Compatibility: 3.2.3.RELEASE - 6.1.2 Version compatibilities of spring-context with this example: Versions in green have been tested.
- JDK 17
- Maven 3.8.1
|
