3.3.2. 내장 된 PropertyEditor구현

Spring은 Object 과 String간의 변환 PropertyEditor개념을 사용하여 수행합니다. 객체 자체와 다른 방식으로 프로퍼티를 표현하는 것이 편리 할 수 ​​있습니다. 예를 들어, Date 는 사람이 읽을 수있는 방식으로 ( String같이 '2007-14-09') 나타낼 수 있지만, 사람이 읽을 수있는 형식을 원래 날짜로 다시 변환 할 수 있습니다 (또는 더 나은 방법으로 사람이 읽을 수있는 어떤 형식도 다시 Date개체 로 변환 할 수 있습니다 ). 이 동작은 java.beans.PropertyEditor유형의 사용자 정의 편집기를 등록하여 수행 할 수 있습니다. BeanWrapper나 이전 챕터에서 얘기했던 대안적인 특정 IoC 컨테이너에 커스텀 에디터를 등록하면 어떻게 프로퍼티를 원하는 타입으로 변환하는 지 알려준다. 자세한 내용은java.beans오라클 패키지 의 자바 스크립트의 javadoc을PropertyEditor 참조하십시오 .

Spring에서 속성 편집이 사용되는 몇 가지 예 :

• PropertyEditor를 사용해서 빈에 프로퍼티를 설정한다. XML 파일에 선언한 어떤 빈의 프로퍼티 값으로 java.lang.String을 사용했을 때 스프링은 (해당 프로퍼티의 setter가 Class-parameter를 가지고 있다면)파라미터를 Class 객체로 처리하려고 ClassEditor를 사용할 것이다.

• 스프링 MVC 프레임워크에서 HTTP 요청 파라미터의 파싱은CommandController의 모든 하위클래스에 수동으로 연결할 수 있는 모든 종류의 PropertyEditor를 사용해서 이뤄진다.

Spring은 삶을 쉽게 만들어 주는 여러 가지 내장 된 PropertyEditor구현을 가지고있다. 그들은 모두 org.springframework.beans.propertyeditors 패키지에 들어 있습니다. 대부분의 경우 (다음 표에 표시된대로 모두는 아님) 기본적으로에 BeanWrapperImpl의해 등록됩니다. 속성 편집기를 어떤 방식으로 구성 할 수있는 곳에서는 자신 만의 변형을 등록하여 기본 변형을 재정의 할 수 있습니다. 다음 테이블은 PropertyEditorSpring이 제공 하는 다양한 구현을 설명 합니다.

표 12. 기본 제공
PropertyEditor
class	설명
ByteArrayPropertyEditor	바이트 배열 용 편집기. 문자열을 해당 바이트 표현으로 변환합니다. BeanWrapperImpl에 의해 기본적으로 등록됩니다.
ClassEditor	클래스를 나타내는 문자열을 실제의 클래스에 해석하거나, 그 역의 경우도 해석합니다. (클래스로 파싱하거나 그 반대로 파싱) 클래스가 발견되지 않으면, IllegalArgumentException가 throw됩니다. 기본적으로 BeanWrapperImpl에 의해 등록됩니다.
CustomBooleanEditor	Boolean속성에 대한 사용자 정의 가능한 속성 편집기. BeanWrapperImpl의 기본값으로 등록되었지만 사용자 정의 편집기로 사용자 정의 인스턴스를 등록하여 재정의 할 수 있습니다.
CustomCollectionEditor	모든 소스 Collection를 지정된 대상 Collection유형으로 변환하는 콜렉션의 특성 편집기 .
CustomDateEditor	java.util.Date사용자 정의 속성 편집기, DateFormat사용자 정의 지원. 기본적으로 등록되지 않았습니다. 필요에 따라 적절한 형식으로 사용자 등록해야합니다.
CustomNumberEditor	Integer, Long, Float, 또는 Double와 같은 Number타입의 서브 클래스를 위한 사용자 정의 속성 편집기. 기본적으로 등록 BeanWrapperImpl되었지만 사용자 정의 편집기로 사용자 정의 인스턴스를 등록하여 재정의 할 수 있습니다.
FileEditor	문자열을 java.io.File객체로 해석 합니다. 기본적으로 BeanWrapperImpl에 의해 등록됩니다.
InputStreamEditor	InputStream 속성이 직접 문자열로 설정할 수 있도록 문자열을 가지고 InputStream을 생성하는 (중간 편도 속성 편집기 ResourceEditor및 Resource 에 의해 생성 할 수 있습니다 ) 단방향 프로퍼티 에디터이다. 기본 사용법은 InputStream귀하를 위해 닫히지 않습니다 . 기본적으로 BeanWrapperImpl에 의해 등록됩니다.
LocaleEditor	문자열을 Locale객체로 또는 그 반대로 해석 할 수 있습니다 (문자열 형식은메소드 [country][variant]와 동일 함 ). 기본적으로에 의해 등록됩니다 .toString()LocaleBeanWrapperImpl
PatternEditor	문자열을 java.util.regex.Pattern객체로 또는 그 반대로 해석 할 수 있습니다.
PropertiesEditor	문자열 ( java.util.Properties클래스 의 javadoc에 정의 된 형식으로 포맷 됨 )을 Properties객체 로 변환 할 수 있습니다. 기본적으로 BeanWrapperImpl에 의해 등록됩니다.
StringTrimmerEditor	문자열을 다듬는 속성 편집기. 선택적으로 빈 문자열을 null값 으로 변환 할 수 있습니다 . 기본적으로 등록되지 않음 - 사용자가 등록해야합니다.
URLEditor	URL의 문자열 표현을 실제 URL객체로 해석 할 수 있습니다. 기본적으로 BeanWrapperImpl에 의해 등록됩니다.

Spring은 java.beans.PropertyEditorManager을 사용하여 필요한 속성 편집기의 검색 경로를 설정합니다. 검색 경로도 sun.bean.editors포함하여, Font, Color및 대부분의 기본 유형과 같은 유형의 PropertyEditor구현을 포함합니다.

또한 표준 JavaBeans 인프라 스트럭처 PropertyEditor는 처리하는 클래스와 동일한 패키지에 있고 Editor 와 함께 해당 클래스와 동일한 이름을 추가 하면 클래스를 명시 적으로 등록 할 필요없이 자동으로 검색 합니다 . 예를 들어, 다음과 같은 클래스 및 패키지 구조를 가질 수 있습니다. 이는 SomethingEditor클래스가 인식되어 PropertyEditorfor Something유형화 된 특성 으로 사용되기 에 충분합니다.

com
  chank
    pop
      Someting
      SomethingEditor // Something 클래스의 PropertyEditor

당신은 또한 표준 사용할 수 있습니다 BeanInfo(어느 정도 설명뿐만 아니라 여기에 자바 빈즈 메커니즘을 여기에 ). 다음 예제에서는 BeanInfo메커니즘을 사용하여 하나 이상의 PropertyEditor인스턴스를 연관된 클래스의 속성 으로 명시 적으로 등록합니다 .

com
  chacnk
    pop
      Something
      SomethingBeanInfo // Something 클래스의 BeanInfo

참조 된 SomethingBeanInfo클래스 의 다음 Java 소스 코드는 a CustomNumberEditor를 클래스 의 age속성 과 연결합니다 Something.

public class SomethingBeanInfo extends SimpleBeanInfo {

    public PropertyDescriptor[] getPropertyDescriptors() {
        try {
            final PropertyEditor numberPE = new CustomNumberEditor(Integer.class, true);
            PropertyDescriptor ageDescriptor = new PropertyDescriptor("age", Something.class) {
                public PropertyEditor createPropertyEditor(Object bean) {
                    return numberPE;
                };
            };
            return new PropertyDescriptor[] { ageDescriptor };
        }
        catch (IntrospectionException ex) {
            throw new Error(ex.toString());
        }
    }
}

추가 사용자 지정 PropertyEditor구현 등록

빈 속성을 문자열 값으로 설정할 때 Spring IoC 컨테이너는 표준 자바 빈즈 PropertyEditor구현을 사용 하여 이러한 문자열을 속성의 복합 유형으로 변환한다. Spring은 많은 커스텀 PropertyEditor구현 (예를 들어 문자열로 표현 된 클래스 이름을 Class객체 로 변환)을 미리 등록한다 . 또한 Java의 표준 JavaBeans PropertyEditor검색 메커니즘을 사용하면 PropertyEditor 클래스의 이름을 적절하게 지정하고 지원 클래스를 제공하는 패키지와 동일한 패키지에 배치하여 자동으로 찾을 수 있습니다.

다른 관례를 등록 할 필요가있는 경우에 PropertyEditors, 몇몇 기계 장치는 유효하다. 일반적으로 편리하지 않거나 권장되지 않는 가장 수동적 인 방법 은 참조 가 있다고 가정 registerCustomEditor()하고 ConfigurableBeanFactory인터페이스 의 메소드 를 사용하는 것입니다 BeanFactory. 또 다른 (약간 더 편리한) 메커니즘은 호출 된 특별한 bean factory post-processor를 사용하는 것 CustomEditorConfigurer입니다. 빈 factory 후 처리기를 BeanFactory구현 과 함께 사용할 수 있지만 CustomEditorConfigurer중첩 된 속성 설정이 있으므로 ApplicationContext다른 bean과 비슷한 방식으로 배포 할 수 있으며 자동으로 감지 할 수있는 위치 와 함께 사용하는 것이 좋습니다. 적용된.

모든 bean 팩토리와 어플리케이션 컨텍스트는 사용법 a BeanWrapper를 통해 속성 변환을 처리 하는 다수의 내장 된 속성 편집기를 자동으로 사용합니다 . 표준 속성은 BeanWrapper 레지스터가 이전 섹션에 나열되어 있는 것을 편집합니다 . 또한 ApplicationContexts특정 응용 프로그램 컨텍스트 유형에 적합한 방식으로 리소스 조회를 처리하는 추가 편집기를 재정의하거나 추가하십시오.

표준 JavaBeans PropertyEditor인스턴스는 문자열로 표현 된 속성 값을 속성의 실제 복합 유형으로 변환하는 데 사용됩니다. 당신이 사용할 수있는 CustomEditorConfigurer편리 추가에 대한 지원을 추가하려면, 빈 공장 포스트 프로세서를 PropertyEditor에 인스턴스 ApplicationContext.

호출 된 사용자 클래스 ExoticType와 호출 된 다른 클래스 를 정의하는 다음 예제를 고려해보십시오.이 클래스 는 속성으로 설정 DependsOnExoticType해야 ExoticType합니다.

package example;

public class ExoticType {

    private String name;

    public ExoticType(String name) {
        this.name = name;
    }
}

public class DependsOnExoticType {

    private ExoticType type;

    public void setType(ExoticType type) {
        this.type = type;
    }
}

일이 제대로 설정되면 type 속성을 문자열 PropertyEditor로 지정하여 실제 ExoticType인스턴스 로 변환 할 수 있기를 원합니다 . 다음 bean 정의는이 관계를 설정하는 방법을 보여줍니다.

<bean id="sample" class="example.DependsOnExoticType">
    <property name="type" value="aNameForExoticType"/>
</bean>

PropertyEditor구현은 다음과 유사 할 수 :

// converts string representation to ExoticType object
package example;

public class ExoticTypeEditor extends PropertyEditorSupport {

    public void setAsText(String text) {
        setValue(new ExoticType(text.toUpperCase()));
    }
}

마지막으로, 다음 예는 사용하는 방법을 보여줍니다 CustomEditorConfigurer새로운 등록 PropertyEditor와ApplicationContext다음 필요에 따라 사용할 수 있습니다 어떤을 :

<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer">
    <property name="customEditors">
        <map>
            <entry key="example.ExoticType" value="example.ExoticTypeEditor"/>
        </map>
    </property>
</bean>

사용 PropertyEditorRegistrar

Spring 컨테이너에 속성 에디터를 등록하는 또 다른 메커니즘은 a PropertyEditorRegistrar. 이 인터페이스는 여러 가지 상황에서 동일한 속성 편집기 집합을 사용해야하는 경우 특히 유용합니다. 해당하는 등록 기관을 작성하고 각각의 경우에 다시 사용할 수 있습니다. PropertyEditorRegistrar인스턴스 PropertyEditorRegistry는 스프링 BeanWrapper(and DataBinder)에 의해 구현 된 인터페이스라는 인터페이스와 함께 작동 합니다. PropertyEditorRegistrar인스턴스는 특히 여기에CustomEditorConfigurer 설명 된 속성 과 함께 사용할 때 편리 합니다 . 이 방식 으로 에 추가 된 인스턴스 는 다음과 쉽게 공유 할 수 있습니다.setPropertyEditorRegistrars(..)PropertyEditorRegistrarCustomEditorConfigurerDataBinder스프링 MVC 컨트롤러. 또한 맞춤 편집기에서 동기화가 필요하지 않습니다.PropertyEditorRegistrar 는 PropertyEditor 각 빈 생성 시도에 대해 신선한 인스턴스 를 생성 할 것으로 예상됩니다 .

다음 예제는 사용자 고유의 PropertyEditorRegistrar구현 을 만드는 방법을 보여줍니다 .

package com.foo.editors.spring;

public final class CustomPropertyEditorRegistrar implements PropertyEditorRegistrar {

    public void registerCustomEditors(PropertyEditorRegistry registry) {

        // it is expected that new PropertyEditor instances are created
        registry.registerCustomEditor(ExoticType.class, new ExoticTypeEditor());

        // you could register as many custom property editors as are required here...
    }
}

org.springframework.beans.support.ResourceEditorRegistrar예제를 참조하십시오.PropertyEditorRegistrar 구현에 . registerCustomEditors(..)메서드 구현시 각 속성 편집기의 새 인스턴스를 만드는 방법에 유의하십시오.

다음 예는 CustomEditorConfigurer우리의 인스턴스 를 구성하고 인스턴스를 삽입하는 방법을 보여줍니다 CustomPropertyEditorRegistrar.

<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer">
    <property name="propertyEditorRegistrars">
        <list>
            <ref bean="customPropertyEditorRegistrar"/>
        </list>
    </property>
</bean>

<bean id="customPropertyEditorRegistrar"
    class="com.foo.editors.spring.CustomPropertyEditorRegistrar"/>

마지막으로 (그리고 사용 당신의 사람들을 위해이 장의 초점에서 출발의 비트에 Spring의 MVC 웹 프레임 워크를 ) 사용하여 PropertyEditorRegistrars데이터 바인딩과 함께 Controllers(같은 것은 SimpleFormController) 매우 편리 할 수 있습니다. 다음 예제에서는 메서드 PropertyEditorRegistrar구현시에를 initBinder(..)사용합니다.

public final class RegisterUserController extends SimpleFormController {

    private final PropertyEditorRegistrar customPropertyEditorRegistrar;

    public RegisterUserController(PropertyEditorRegistrar propertyEditorRegistrar) {
        this.customPropertyEditorRegistrar = propertyEditorRegistrar;
    }

    protected void initBinder(HttpServletRequest request,
            ServletRequestDataBinder binder) throws Exception {
        this.customPropertyEditorRegistrar.registerCustomEditors(binder);
    }

    // other methods to do with registering a User
}

이 스타일의 PropertyEditor등록은 간결한 코드 ( initBinder(..)한 줄만 구현 됨)로 이어질 수 있으며 공통 PropertyEditor 등록 코드를 클래스에 캡슐화 한 다음 Controllers필요한 만큼 공유 할 수 있습니다.