绯色av一区,国产精品国产三级国产aⅴ入口,国产精品第一第二

polygoncell — Sun, 03 Aug 2008 19:48:00 GMT

本文紧接使用重构�U�除丑陋的if else代码�Q?�Q?/a>

上篇文章谈到如何能够��d��把这个switch也移除掉呢？很简单，我们只需要在getSystemStatePerformer()�Ҏ��被调用之前先创徏所�? performer匿名�cȝ��实例�Q�然后在该方法被调用时直接返回对应的实力�?如何具体实现呢？用Map�Q?��L��代码�Q?br />

package de.jingge.refactoring;

import static de.jingge.refactoring.SystemState.*;

import java.awt.Image;

import java.awt.image.BufferedImage;

import java.lang.reflect.Method;

import java.util.Collections;

import java.util.HashMap;

import java.util.Map;

/**

*

* @author gejing@gmail.com

*/

public class SystemStatePerformerFactory {

private static SystemStatePerformerFactory INSTANCE = new SystemStatePerformerFactory();



    private Map<SystemState, SystemStatePerformer> performers;

    private SystemStatePerformerFactory() {

}

    public static SystemStatePerformerFactory getInstance() {

        return INSTANCE;

    }



    private synchronized Map<SystemState, SystemStatePerformer> getPerformers()

            throws Exception {

        if (performers == null) {

            performers = new HashMap<SystemState, SystemStatePerformer>();

            // call all @FactoryMethod using reflection

            for (Method m : getClass().getDeclaredMethods()) {

                if (m.getAnnotation(FactoryMethod.class) != null) {

                    SystemStatePerformer p = (SystemStatePerformer) m.invoke(

                            this, new Object[]{});

                    performers.put(p.getState(), p);

                }

            }

            // make it readonly

            performers = Collections.unmodifiableMap(performers);

        }

        return performers;

    }

    public SystemStatePerformer getSystemStatePerformer(SystemState state) throws Exception{

        return getPerformers().get(state);

    }

@FactoryMethod

    private SystemStatePerformer createLoggedInPerformer() {

        return new SystemStatePerformer(LOGGEDIN, getImage("loggedin.gif")) {

            @Override

            public void perform() {

                // do something after logging in is successful,

                // for example: show welcome dialog, open the last edit document, etc.

            }

        };

    }

@FactoryMethod

    private SystemStatePerformer createLoggedOutPerformer() {

        return new SystemStatePerformer(LOGGEDOUT, getImage("loggedout.gif")) {

            @Override

            public void perform() {

                // do something after logging out is successful,

                // for example: free used resource, dispose GUI components, etc.            }

            }

        };

    }

@FactoryMethod

    private SystemStatePerformer createIdlePerformer() {

        return new SystemStatePerformer(IDLE, getImage("idle.gif")) {

            @Override

            public void perform() {

                // do something after the user is idle,

                // for example: save the application state temporarily, lock the application, etc.

            }

        };

    }

    private Image getImage(String string) {

        return new BufferedImage(10, 10, BufferedImage.TYPE_4BYTE_ABGR);

    }

}

从代码中可以看出�Q�当getPerformers�Q�）�Ҏ��被第一�ơ调用时�Q�我们会为每一个performer匿名�c�d��Z��个实例，�q�且��它们纳入Map的管理之中，以后每次调用的时候，直接从Map里面提取对应某个状态的performer��可以了�Q?switch可以舍弃了�? @FactoryMethod�q�个注释是我自己写的�Q��用它主要是�ؓ了避免每�ơ新增加一个create***Performer�Q�）�Ҏ��后，都必��M��? getSystemStatePerformer�Q�）�?br />
@FactoryMethod的代码如下：

package de.jingge.refactoring;

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.METHOD})

public @interface FactoryMethod {

}

到这里整个重构已�l�结束了�Q?我们已经��if else, switch完全从代码里剔除了�?

读过Refactoring to Patterns�q�本书的朋友可能会觉得，�q�里所作的一些和书中�W�七章最后一节Replace Conditional Dispatcher with Command完全一栗��? Well�Q�第一眼看上去��实很像�Q�但是看完我写的所有代码后�Q�再仔细想一惻I��两者还是有区别的（Refactoring to Patterns�q�本书写的非常好�Q�对此书�Q�我可以说是�׃��释手�Q�还曄��写过一��书评。事实上�Q�我�q�篇文章正式��Z��q�本书的�Q�：

1. Factory + annonymous�c�而不是每一个状态一个具体的实体�c�R�?/span>

�q�样处理问题�Q?�cȝ��数量大大减少�Q�类兌��的复杂程度也大大减少�Q�维护�v来很方便�?/span>

2. performer�q�不单单是一个command�Q�它拥有状态，�q�且可以处理更多的逻辑�?/span>

全文完�?br />

polygoncell 2008-08-04 03:48 发表评论

polygoncell — Sun, 03 Aug 2008 19:08:00 GMT

本文紧接使用重构�U�除丑陋的if else代码�Q?�Q?/a>

OK, 到目前�ؓ止，所有的逻辑代码已经从SystemManager重构��C��SystemStatePerformer。下一步应该��l�重构SystemManager�Q?��SystemState替换为performer�Q?/span>

1�Q?使用IDE的重构功能，��变量SystemState改�ؓSystemStatePerformer

2. 在updateState()�Ҏ��中调用SystemStatePerformerFactory

3. 在测试代码里面，调用manager.statePerformer.getState()

重构后的代码如下�Q?br />

package de.jingge.refactoring;

import static de.jingge.refactoring.SystemState.*;

public class SystemManager {

    SystemStatePerformer statePerformer;

    public void login() {

        // call service#login()

        updateState(LOGGEDIN);

    }

    public void logout() {

        // call service#logout()

        updateState(LOGGEDOUT);

    }

    public void idle() {

        // call some other services

        updateState(IDLE);

    }

    public void updateState(SystemState state) {

        this.statePerformer = SystemStatePerformerFactory.getInstance()

                getSystemStatePerformer(state);

        statePerformer.perform();

    }

}

可以看到if else已经消失了�?br id="nyha6" />

��试代码也要做相应修改：

package de.jingge.refactoring;

import org.junit.AfterClass;

import org.junit.BeforeClass;

import org.junit.Test;

import static org.junit.Assert.*;

import static de.jingge.refactoring.SystemState.*;

public class SystemManagerTest {

    private static SystemManager manager;

    @BeforeClass
    public static void setUpClass() throws Exception {

        manager = new SystemManager();

        // add some service mock objects

    }

    @AfterClass
    public static void tearDownClass() throws Exception {

    }

    @Test
    public void login() {

        manager.login();

        assertEquals(manager.statePerformer.getState(), LOGGEDIN);

    }

    @Test
    public void logout() {

        manager.logout();

        assertEquals(manager.statePerformer.getState(), LOGGEDOUT);

    }

    @Test
    public void idle() {

        manager.idle();

        assertEquals(manager.statePerformer.getState(), IDLE);

    }

}

到这里重构已�l�差不多完成了，代码已经更加面向对象了。这里还有一个小问题�Q�在factory里面�q�有一个switch�Q�这个和if else其实是没有本质区别的�Q�也��是说if else�q�没有被完全�U�除掉�?br id="khlv2" />

那么如何能够��d��把这个switch也移除掉呢？很简单，我们只需要在getSystemStatePerformer()�Ҏ��被调用之前先创徏所�? performer匿名�cȝ��实例�Q�然后在该方法被调用时直接返回对应的实力�?那么具体如何实现呢，��L��下一��文�?/span>使用重构�U�除丑陋的if else代码�Q?�Q?/a>�?br />

polygoncell 2008-08-04 03:08 发表评论

polygoncell — Sun, 03 Aug 2008 18:54:00 GMT

本文紧接使用重构�U�除丑陋的if else代码�Q?�Q?/a>

�U�除if else

首先仔细观察一下updateState()�Ҏ��Q�我们会发现�Q�导致该�Ҏ��内存在大量if else的原因是它的参数仅仅是一个enum。由于enum本��n�q�不含有��M��逻辑代码�Q�因此导致处理enum的方法需要��用if else来分析enum然后调用相应的逻辑。明白了�q�个道理之后�Q�重构的方向��明了了。简单的��_��我们需要要��方法参数由enum替换成一个更加强壮的�? 象类�Q�每一个��承该�cȝ��子类��具体负责处理一个enum实例�Q�之后再��updateState�Q�）�Ҏ��中相应的逻辑代码转移到这些子�c�M��。这样处理之后，令�h讨厌的if else��׃��消失了�?br id="w9yc4" />

我们��这个替换enum的抽象类命名为SystemStatePerformer�Q�代码如下：

package de.jingge.refactoring;

import java.awt.Image;

public abstract class SystemStatePerformer {

    private final SystemState state;

    private Image image;

    public SystemStatePerformer(SystemState state, Image image) {

        this.state = state;

        this.image = image;

    }

    public SystemState getState() {

        return state;

    }

    public Image getImage() {

        return image;

    }

    public abstract void perform();

}

从代码中可以看出�Q�每一个performer都含义有一个SystemState�Q�这个SystemState属性，��只能通过构徏器映��方式射入一个performer的对象实例。换句话说SystemState只是一个只��d��性，而且每一个performer实体�c�都只负责处理一个enum的实例（下面马上会解释如何实�? 的）。这里��用的Image作�ؓ一个例子，它表�C�用��L��每一个状态都可以使用一个图标来表示。performer()�Ҏ��负责处理具体的逻辑。这�? SystemStatePerformer的实体子�c�d��以引用�Q何类型的对象�Q�然后在perform�Q�）�Ҏ��里面�q�行调用�?

�? 一步就是编写SystemStatePerformer的实体子�c�R��我首先惛_��的是为每一个enum实例�~�写一个实际的子类�Q�理��Z��来说是没问题的，但是 �q�样做必��ȝ��写一大堆的子�c�，不便于管理。所以我军_��使用Factory + annonymous classes来构建具体的实体子类�Q�让Factory来管理所有的实体子类�?/span> 代码如下�Q?br id="xwuj0" />

�? 代码中可以看刎ͼ�针对每一个enum状态都有一个创建performer的方法，该方法返回一个匿名类。逻辑代码��会被�{�U�至个匿名类�? perform()�Ҏ��之内。整个Factory只有一个公开的方法：getSystemStatePerformer(SystemState)�Q�SystemManager可以调用�q�个�Ҏ��来获得相应的 Performer实例�?br id="lvu95" />

�? �q�篇文章中，我希望专属于if else的问题。对于其他设计方面的问题�Q�我采取的态度是能省略��q��略。实际开发中�Q�还有有很多问题需要处理，例如�Q��用static�Ҏ��会导致系�l�的�? ��试性下降，在实际开发中应该��量避免�Q�解册��c�问题的�Ҏ��之一是��用DI框架�Q�例如Google Guice�?/span>

下一��文�?a id="Editor_Results_rprSelectionList_ctl01_LinkTitle" class="titlelink" href="../archive/2008/08/04/219785.html">使用重构�U�除丑陋的if else代码�Q?�Q?/a>�l�箋讲解�?br />

polygoncell 2008-08-04 02:54 发表评论

polygoncell — Sun, 03 Aug 2008 18:45:00 GMT

本文紧接使用重构�U�除丑陋的if else代码�Q?�Q?/a>�?br />
使用Enum替换int帔R��

�q�一步比较简单，先创��Z��个enum�c�：

package de.jingge.refactoring;

public enum SystemState {

    LOGGEDIN,

    LOGGEDOUT,

    IDLE;

}

然后开始重构SystemManager, 使用SystemState代替SystemManager里的int状态：

   1. ��d�� import static de.jingge.refactoring.SystemState.*;
   2. 删除所有的integer帔R��
   3. ��变量state的类型改为SystemState.

代码如下�Q?br />

package de.jingge.refactoring;

import static de.jingge.refactoring.SystemState.*;

public class SystemManager {

    SystemState state;

    public void login() {
        // call service#login()
        updateState(LOGGEDIN);
    }

    public void logout() {
        // call service#logout()
        updateState(LOGGEDOUT);
    }

    public void idle() {
        // call some other services
        updateState(IDLE);
    }

    public void updateState(SystemState state) {
        if (state == LOGGEDIN) {
            // do something after logging in is successful,
            // for example: show welcome dialog, open the last edit document, etc.
        } else if (state == LOGGEDOUT) {
            // do something after logging out is successful,
            // for example: free used resource, dispose GUI components, etc.
        } else if (state == IDLE) {
            // do something after the user is idle,
            // for example: save the application state temporarily, lock the application, etc.
        } else {
            throw new IllegalArgumentException("unknown state");
        }
        this.state = state;
    }
}

然后重构��试�c?

1. ��d��import static de.jingge.refactoring.SystemState.*;
2. 删除所有常量前引用的SystemManager.

package de.jingge.refactoring;

import org.junit.AfterClass;
import org.junit.BeforeClass;
import org.junit.Test;
import static org.junit.Assert.*;
import static de.jingge.refactoring.SystemState.*;

public class SystemManagerTest {

    private static SystemManager manager;

    @BeforeClass
    public static void setUpClass() throws Exception {
        manager = new SystemManager();
        // add some service mock objects
    }

    @AfterClass
    public static void tearDownClass() throws Exception {
    }

    @Test
    public void login() {
        manager.login();
        assertEquals(manager.state, LOGGEDIN);
    }

    @Test
    public void logout() {
        manager.logout();
        assertEquals(manager.state, LOGGEDOUT);
    }

    @Test
    public void idle() {
        manager.idle();
        assertEquals(manager.state, IDLE);
    }
}

�q�行�q�个��试�c?>通过

下一��文�?a id="Editor_Results_rprSelectionList_ctl01_LinkTitle" class="titlelink" href="../archive/2008/08/04/219784.html">使用重构�U�除丑陋的if else代码�Q?�Q?/a>开始处理if else hell

polygoncell 2008-08-04 02:45 发表评论

polygoncell — Sun, 03 Aug 2008 18:36:00 GMT

我们知道因�ؓ�~�程语言的限�Ӟ��历史遗留下来的系�l��L��有很多的毛病�Q�不够面向对象，��其是很多系�l�滥用if else。我曄��见过一个项目，大家基本上就是写一个方法，然后在里面if else套if esle得嵌套了好几层，隄��׃��必说了，�q�种代码�Ҏ��没法维护�?br id="i7km" />
今天我就使用从实际项目中提炼出来的例子来讲解一下如何将�q�类代码变得更加面向对象 - 重构成模式�ƈ且添加测试代码，

先来看一个丑陋的�c�：

package de.jingge.refactoring;

public class SystemManager {

    public static final int LOGGEDIN = 0;

    public static final int LOGGEDOUT = 1;

    public static final int IDLE = 2;

    int state;

    public void login() {

        // call service#login()

        updateState(LOGGEDIN);

    }



    public void logout() {

        // call service#logout()

        updateState(LOGGEDOUT);

    }



    public void idle() {

        // call some other services

        updateState(IDLE);

    }

    public void updateState(int state) {

        if (state == LOGGEDIN) {

            // do something after logging in is successful,

            // for example: show welcome dialog, open the last edit document, etc.

        } else if (state == LOGGEDOUT) {

            // do something after logging out is successful,

            // for example: free used resource, dispose GUI components, etc.

        } else if (state == IDLE) {

            // do something after the user is idle,

            // for example: save the application state temporarily, lock the application, etc.

        } else {

            throw new IllegalArgumentException("unknown state");

        }

        this.state = state;

    }

}

�q�里我们展示了一�?SystemManager�Q�它负责处理用户在系�l�中的状态：��d��Q�logged in�Q�，��d��Q�logged out�Q?以及�I�闲�Q�idle�Q�。从代码中可以看刎ͼ��q�个�cȝ��了int来定义状态�ƈ且因此导致了updatteState�Q�）�Ҏ��里面出现大量if else。从目前看来�q�些if else是无法避免的�Q�应��个类需要针对不同的状态作出反应。随着状态的增加�Q�if else的数量也会��l�增加。这个解��x��案显然很差�?br id="i7km87" />
那么怎么��h��能让�q�个�c�L��加地面向对象呢？

在处理面向对象之前，我们首先要编写一个测试类�Q�这也是处理�q�类历史遗留下来代码所必需做的�W�一步，只有在测试代码的保护下，我们才能攑ֿ�大胆地进行重构�?br id="i7km91" />
初步的测试代码如下：

package de.jingge.refactoring;

import org.junit.AfterClass;
import org.junit.BeforeClass;
import org.junit.Test;
import static org.junit.Assert.*;

public class SystemManagerTest {
    private static SystemManager manager;

    @BeforeClass
    public static void setUpClass() throws Exception {
        manager = new SystemManager();
        // add some service mock objects
    }

    @AfterClass
    public static void tearDownClass() throws Exception {

    }

    @Test
    public void login() {

        manager.login();

        assertEquals(manager.state, SystemManager.LOGGEDIN);

    }

    @Test
    public void logout() {

        manager.logout();

        assertEquals(manager.state, SystemManager.LOGGEDOUT);

    }

    @Test
    public void idle() {

        manager.idle();

        assertEquals(manager.state, SystemManager.IDLE);

    }

}

�q�行��试代码->通过�?br id="i7km171" />
在下一��文章我们将正式开始重构。地址�Q?a title="使用重构�U�除丑陋的if else代码�Q?�Q? target="_blank" href="http://www.aygfsteel.com/polygoncell/archive/2008/08/04/219781.html">使用重构�U�除丑陋的if else代码�Q?�Q?/a>

polygoncell 2008-08-04 02:36 发表评论

书评�Q?Refactoring to Pattern

polygoncell — Tue, 29 Jul 2008 11:17:00 GMT

陆陆�l�箋又看了一些技术书�Q�加上最�q�工作�Q务繁重，实在没时间写技术类的博文，计划断断�l�箋写一些书的阅读评论。今天先写一本，

最�q�阅�ȝ��书�ƈ不都是最新的�Q�因��Z��书的��是需要花旉��反复研读�Q�仔�l�思考的�Q�例如关于设计模式的书�?br id="tt2t" />
Refactoring to Patterns��是�q�样一本书�Q�一本相�Ҏ��说不��太新的书，一本关于设计模式的书，一本让��Z��新开始思考模式的书。我本�h强烈推�D大家阅读�?br id="x6op" />
�q�本书刚出来的时候，我就一直想好好静下心来��M��读，无奈工作忙碌�Q�一直没有找到机会。而且说实话，自己对设计模式也已经��淫数蝲�Q�大部分模式都已�l�在�? 际项目中历练�q�，不说炉火�U�青�Q�也��得上是熟能生��y。虽然知道这是一本好书，但是心里依然会泛起阵阉|��漪：just another design pattern book�Q�给我一天时��_��我就能把它拿下。没惛_��从开始读到现在已�l?个多月了�Q�现在依然会抽时间出来翻看某个章节，然后�l�合实际问题仔细思考一番。说�? 话，设计模式真的是个好东西，是前辈经验的�U�篏�Q�但是当我们熟练掌握了各�U�模式之后，��׃��遇到两个瓉��性质的问题：

1. 如何��各�c�L��式融汇诏通。感觉就像是武侠里面的如何将�ȝ��二脉打通，功夫再好�Q��Q督二脉不通也非高手，不同的模式相互作用会产生不同的结果，不同的模式组合会产生不同的结构，或相互补充相互促�q�，或互相媄响互相抵制。如何选择�Q�是个难题�?br id="ifwv" />
2. 如何避免�q�度设计。模式用熟的朋友可能会有�q�种感觉�Q�编�E�的时候会不知不觉中��用模式进行开发，模式再好�Q�泛滥��用，�q�犹不及。好像武功一般，招式�J�多�Q�固然耍�v来好看，但是高手最后的境界往往是无招胜有招�Q�只要能目的辑ֈ��p��了�?br id="i:83" />
�W�一个问题由于模式之间的�l�合千变万化�Q�而且很多需要结合实际问题进行考虑�Q�大家只能是在实际项目开发中慢慢体会�Q�慢慢积累经验。或许再�q�几�q�会有某个�h或者某些�h把这些经验收集整理，�~�排��Z��?br id="p99i" />
今天主要惌��说第二个问题�Q�过度设计�?Refactoring to Patterns�q�本书就是帮助我们尽量避免过度设计的�Q�这也是我推荐大家看�q�本书的初衷�?br id="jar4" />
事实上，�q�本书完全可以看成是极限�~�程�p�d��里面的一部巨头著作，其他的重要著作包括TDD�Q�Refactoring�Q�和continuous integration�Q�合��h��应该�U�CؓXP四大金刚�?br id="f4g2" />
使用XP开发强调keep it simple�Q�在�~�码的时候首先用最��单的办法实现功能(当然最好是��试驱动,我会在评��Z��面一本书是��l�谈��试驱动�Q�，然后在测试代码的保护下对初��? 码进行大刀阔斧地重构，�q�时候这些代码自然最好能够重构成设计模式�Q�因为针�Ҏ��些特定的问题�Q�模式基本上是最佌��x��案。这个时候就大家��需要了解如何将现有的代码重构成为标准的设计模式代码�Q�说的严重点�Q�这一步关�p�d��整个代码的质量，直至引申到真个项目的质量。这本书��针对这个关键步骤进行了讲解�Q�是所有采用XP�Ҏ��的开发团队的必修课之一�?br id="w11_" />

至于书的内容我就��量��单概括一下：本书基本上覆盖了重构��目中会遇到的大部分问题�Q��ƈ且针对这些问题提供了实例讲解和具体的解决�Ҏ��。这些方案不单单�? 用于使用TDD开发的��目�Q�它们更适用于那些希望通过重构改善现有代码质量的项目。当�Ӟ��重构前，千万别尝试避开�~�写��试代码�Q�要牢记�Q�没有测试代码保护，最好不要对代码做大手术。书中的很多例子都值得大家��d��以后�l�合自己的实际项目仔�l�思考一番。我个�h很喜�Ƣ第7章，已经在项目中采用了书中提到的很多解决�Ҏ��Q��ƈ且对于某些实际例子，开始尝试优化书中的�Ҏ��Q�希望以后能够抽出时间来写一��详�l�的博文�?

polygoncell 2008-07-29 19:17 发表评论

Swing通用数据验证模块

polygoncell — Tue, 29 Jul 2008 10:27:00 GMT

�q�段旉��真是忙得要死�Q�一斚w��要开发公叔R��目的�pȝ��框架�Q�要��项目分成不同的子项目，�~�写核心代码�Q�另一斚w��要将极限�~�程�Q�XP�Q�引入团队开发，部��v各类 XP需要的服务例如subversion啦，ant+ivy啦，Hudson啦等�{�。顺便说句题外话�Q�ubuntu�q�真是不是一般的好用�Q�徏议有能力的全部�{到ubuntu上去开发�?

我目前开发的�q�个框架的客��L��是具肥的客户端，也就是Swing客户端了。Swing应用相对于Web应用有很多优势，因�ؓ它更肥。数据验证就�? 其中一个。当然现在的Web应用通过使用Ajax也要比以前强很多了，但是�q�是避免不了在验证数据时向服务段发出��h��Q�至��你无法避免验证�l�果从Web�? 务器传输到用��h��览器上这�D�过�E�。而Swing�q�类肥客��L��可以实现完全在本地对数据�q�行验证�Q�甚臛_��以断�|��l�工作（�q�也是Web应用目前在研发的一�? 重要��N��Q��?

前段旉��开发出了一个可以应用于所有Swing应用的通用数据验证模块�Q�发现它在项目中使用后，对于普通的数据验证,�E�序员几乎不需要编码，效率提高了不��，��写了一��博文拿出来和大家分享。原文是用英文写的，在这里：http://polygoncell.blogspot.com/2008/07/validation-module-for-swing-application.html。英文好的朋友可以直接去那里看�?

�~�写�q�个模块使用了很多不同的开源框架和�c�d��Q�其中很重要的一个就是JXLayer。文章写完后�Q�我��p��去邀请JXLayer的作者Alexp来指点一下，然后��在我的文章后面开始了一�D�讨论，挺有意思的�Q�他不愧为是Swing team里面的牛人啊�Q�厉宛_��Q�呵��c�?

ok�Q�回��C��天这��文章的正题。今天的主要目的是将我的英文博文��译成中文（自己的文章，我就不逐字逐句��译了，意思到了就行了�Q�可能还会随兴展开一番讨论）在这里展�C�给大家�Q�与大家分��n开发经验，希望大家能够从中��L��Q�也希望能够以文会友�Q�广交朋友。废话少��_��切入正题�?

数据验证�Q�Validation�Q�一直是软�g开发中非常重要的一环，有了它，你的�pȝ��会让客户感到更加友善�Q�同时你的系�l�也得到了一定程度的�? 护。一般来��_��数据验证既可以在客户端也可以在服务端。默认的JSF数据验证��是在服务端�Q�数据只能在被提交以后才能够被验证，然后把错误信息传递回用户的浏览器。后来大规模使用Ajax后，基本可以实现对修改的数据“��x��”验证�Q�注意这里是个打了引��L��x��Q�数据事实上�q�是要在��览器和服务端之间进行传递的�Q�只不过Ajax��这�U�传递改为隐式了而已�Q�理��Z��q�没有真正实玎ͼ�断网�Q�即旉��证。而在Swing应用上就能够达成�q�种愿望�?

事实上，开发Swing应用�Ӟ��数据验证一直比较棘手，需要手工编码的地方太多�Q�效率不高。后来出了JGoodies Validation �l�合JGoodies binding后，好了一些。这个JGoodies Validation既可以实现model层面的验证，也可以实现Bean层面的验证，但是多年使用下来�Q�发现其实它比较适用于中��项目，而且要编写的�? 码其实一点不比自己手动编写的��?

JGoodies��行了一�D�|��间后�Q�sun开始推��q��bean�l�定�Ҏ��Q�beansbinding�Q�JSR 295�Q�，我个人感觉要比JGoodies binding好用�Q�JGoodies的作者Karsten也在专家�l�里�Q�这个�h我以前和他一起共事过�Q�我的msn space里面�q�有跟他的合影，�l�对是Swing界的牛�h�Q�。这个beansbinding也提供数据验证，但是它的�q�个数据验证只是在target被改动后�Q�数据被同步回source之前才会起作用，使用��h��局限性比较大�Q�而且�~�码量也不小�?

�׃��目前�l�大部分��目是基于POJO的，Hibernate validator已经提供了一个很好的数据验证框架�Q�我们完全没必要再重复发明轮子，我们应该努力站在巨�h的肩膀上，�q�样我们才能站得更高�Q�看得更�q��? 于是我考虑�l�合beansbinding和Hibernate Validator开发数据验证。还有一个重要的问题�Q�那��是数据错误的时候，需要在用户界面上展�C�相应的信息�Q�例如Error icon和错误提�C�，�q�部分我考虑使用JXLayer�?

你可以在如下链接中找到相��x��架的具体信息�Q?

1. Hibernate Validator�Q?http://www.hibernate.org/hib_docs/validator/reference/en/html_single/
2. Beansbinding: https://beansbinding.dev.java.net/
3. JXlayer: http://weblogs.java.net/blog/alexfromsun/

阅读�q�篇文章�Q�不需要你熟悉�q�些�c�d��Q�不�q�了解这些类库能够帮助你更好地理解这��文章�?

我的�q�个通用模块是参考JXLayer里面的一个demo�c�TextValidationDemo的，�q�个JXlayer是由Alexander Potochkin开发的�Q�我很喜�Ƣ，使用��h��很顺手，强烈推荐使用�?

下面开始介�l�代码。首先是建立一个java��目�Q�对于这个小��目�Q�我使用netbeans。这里说句题外话�Q�中型和大型的Swing应用�Q�徏议最好还是不要��用netbeans的GUI Builder�Q�一斚w��它生成的代码��烂，另一斚w��很难��试。目前市面上有很多好用的layout的框�Ӟ��例如 JGoodies form和MigLayout�Q�开发效率绝对不比netbeans的GUI builder差，你还不需要面对��o人头疼的机器成的代码�?

��目创徏好后�Q�加入类库：

然后写一个persistence bean:

package de.jingge.domain;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import org.hibernate.validator.Length;
import org.hibernate.validator.NotEmpty;

@Entity
public class Country extends AbstractBean {

private static final long serialVersionUID = 5341382564159667599L;
public static final String PROPERTYNAME_NAME = "name";
public static final String PROPERTYNAME_CODE = "code";
private String name;
private String code;
private Long id;

public Country() {
}

public Country(String code, String name) {
    super();
    setCode(code);
    setName(name);
}

@Id
@GeneratedValue(strategy = GenerationType.AUTO)
public Long getId() {
    return id;
}

public void setId(Long id) {
    this.id = id;
}

@NotEmpty
public String getName() {
    return name;
}

public void setName(String name) {
    firePropertyChange(PROPERTYNAME_NAME, this.name, this.name = name);
}

@Length(min=2, max= 2, message="Code length must be 2")
@NotEmpty
public String getCode() {
    return code;
}

public void setCode(String code) {
    firePropertyChange(PROPERTYNAME_CODE, this.code, this.code = code);
}
}

�q�里我�ؓ了强调可以在Swing客户端直接��用和验证persistence bean�Q�故意写了一个persistence bean�Q�实际应用中�Q�这个类只需要是一个pojo��p��了�?

�q�个Country�c�M��表一个国�Ӟ��它有两个属性，code和name�Q�我�l�他们分别加上个各自的验证限制。code不能为空�Q�且必须正好是两�? 字符�Q�例如CN�Q�DE�Q�US。name不能为空。这些annotaion均出自Hibernate Validator。那个父�c�AbstractBean��SwingX�c�d��Q�我们的Country�cȝ��承了它之后就可以支持property change event了�?

ok, 下面可以开始编写这个模块的核心代码了。前面说�q�，我会使用JXlayer。��用它的好处是�Q�所有JXlayer的painting event都会被�{到UI�c�L��Q�我们只需要编写一个集成Hibernate Validator的UI�c�d��可以了，我称�q�个�c�MؓHibernateValidationUI�Q�代码如下：

package de.jingge.view;

import java.awt.Graphics2D;
import java.awt.image.BufferedImage;

import javax.swing.BorderFactory;
import javax.swing.JComponent;
import javax.swing.text.JTextComponent;

import org.hibernate.validator.ClassValidator;
import org.hibernate.validator.InvalidValue;
import org.jdesktop.beansbinding.ELProperty;
import org.jdesktop.beansbinding.PropertyStateEvent;
import org.jdesktop.beansbinding.PropertyStateListener;
import org.jdesktop.jxlayer.JXLayer;
import org.jdesktop.jxlayer.plaf.AbstractLayerUI;

/**
* Header:
* Description: A layerUI which will validate the referenced property value of
* the object each time when the paint() method is called.

* The value of the given object property will be observed.
* Note: This UI works only with {@link JXLayer}. Any change of the property
* will force repainting the UI. The work process looks like: property changed ->
* jxlayer will be repainted -> the paint() method of this UI will be called.
* The logic of validation will be handled by the Hibernate validator
* framework.
*
*/
public class HibernateValidationUI extends AbstractLayerUI<jTextComponent> {

private Object object;
private String propertyName;
private ClassValidator validator;
private ELProperty elProperty;
private PropertyStateListener propertyChangeHandler;

public HibernateValidationUI(Object obj, String propertyName) {
    this.object = obj;
    this.propertyName = propertyName;
    propertyChangeHandler = new PropertyChangeHandler();
    validator = new ClassValidator(obj.getClass());

    elProperty = ELProperty.create("${" + propertyName + "}");
}

public void installUI(JComponent c) {
    super.installUI(c);
    elProperty.addPropertyStateListener(object, propertyChangeHandler);
}

public void uninstallUI(JComponent c) {
    super.uninstallUI(c);
    elProperty.removePropertyStateListener(object, propertyChangeHandler);
}

protected void paintLayer(Graphics2D g2, JXLayer<jTextComponent> l) {
    super.paintLayer(g2, l);
    InvalidValue[] validationMessages = validator.getInvalidValues(object,
            propertyName);
    if (validationMessages.length > 0) {
        BufferedImage image = Java2DIconFactory.createErrorIcon();
        g2.drawImage(image, l.getWidth() - image.getWidth() - 1,
                l.getHeight() - 8, null);
        l.getView().setToolTipText(validationMessages[0].getMessage());

        return;
    }
    l.getView().setToolTipText(null);
}

boolean isValid() {
    return validator.getInvalidValues(object, propertyName).length == 0;
}

class PropertyChangeHandler implements PropertyStateListener {

    @Override
    public void propertyStateChanged(PropertyStateEvent pse) {
        setDirty(true);
    }
}
}

�q�个HibernateValidationUI�c�d��有一个构建器�Q�它接收两个参数�Q�一个是source object�Q�也��是我们要修改的那个Bean�cȝ��实例�Q�另外一个是�q�个bean的一个属性，�q�个HibernateValidationUI��p��责验证这个属性�?

在installUI()�Ҏ��中，我们启动对属性变化的观察�c�，而在uninstallUI()�Ҏ��里面�Q�我们需要卸载这个观察类�?

当给定对象的属性值发生变化时�Q�PropertyChangeHandler的propertyStateChanged�Q�）�Ҏ��׃��被调用，�q? 个功能是通过elProperty和PropertzChangeHandler相结合来实现的。在propertyStateChangeed()�Ҏ�� 里UI�cȝ��Ҏ��setDirty()会被调用�Q�该�Ҏ��的调用会��D��UI�cȝ��状态变化，�q�而引�?re)painting�Q�之后经�q�一�p�d��的方法调用传递，paintLayer(Graphics2D g2, JXLayer l)�q�个�Ҏ��会被调用，�q�个�Ҏ��要做的就是我们这个数据验证模块的核心功能�Q?

1. 调用Hibernate Validator验证该属性�?
2. 如果数据不正��，则在GUI上显�C�Z��个error icon�Q��ƈ且将错误信息作�ؓtooltip展示�l�用戗��?

在第二点里面产生了一个问题，谢谢Alexp�Ҏ��的指炏V��Swing team里面有一些规定，其中之一��是�Q�在paint()�Ҏ��里面最好不要改变Component的状态，而setTooltip()�Ҏ��会改变 component的状态，因此需要在paint()�Ҏ��之外调用。我目前使用下来�Q�还没有发现什么严重的错误�Q�决定暂时不改了�Q�回头有旉��在将�q�个代码 ��L��一下�?

�c�M��用到的Java2DIconFactory代码如下�Q?

package de.jingge.view;

import java.awt.Color;
import java.awt.Graphics2D;
import java.awt.RenderingHints;
import java.awt.image.BufferedImage;

public class Java2DIconFactory {

public static BufferedImage createErrorIcon() {
    return createErrorIcon(7, 8);
}

public static BufferedImage createErrorIcon(int width, int height) {
    BufferedImage icon = new BufferedImage(width, height,
            BufferedImage.TYPE_INT_ARGB);
    Graphics2D g2 = (Graphics2D) icon.getGraphics();
    g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
            RenderingHints.VALUE_ANTIALIAS_ON);
    g2.setRenderingHint(RenderingHints.KEY_STROKE_CONTROL,
            RenderingHints.VALUE_STROKE_PURE);
    g2.setColor(Color.RED);
    g2.fillRect(0, 0, width, height);
    g2.setColor(Color.WHITE);
    g2.drawLine(0, 0, width, height);
    g2.drawLine(0, height, width, 0);
    g2.dispose();
    return icon;
}
}

没什么太多好解释的，��是使用Java 2D��M��个Error icon�?

接着�Q�我们需要编写一个Factory�c�，构徏一个JTextField�Q�尽量把复杂技术封装�v来，�q�样�E�序员开发�v来可以提高效率，代码如下�Q?

package de.jingge.view;

import javax.swing.JTextField;
import javax.swing.text.JTextComponent;
import org.jdesktop.beansbinding.AutoBinding;
import org.jdesktop.beansbinding.BeanProperty;
import org.jdesktop.beansbinding.BindingGroup;
import org.jdesktop.beansbinding.Bindings;
import org.jdesktop.beansbinding.ELProperty;
import org.jdesktop.jxlayer.JXLayer;
import static org.jdesktop.beansbinding.AutoBinding.UpdateStrategy.*;

public class GuiComponentFactory {

public static JXLayer<jTextComponent> createTextField(
        BindingGroup bindingGroup, Object sourceObject,
        String sourceProperty) {
    JTextField field = new JTextField();
    AutoBinding binding = Bindings.createAutoBinding(READ_WRITE,
            sourceObject, ELProperty.create("${" + sourceProperty + "}"),
            field, BeanProperty.create("text"));
    bindingGroup.addBinding(binding);
    bindingGroup.bind();
    return new JXLayer<jTextComponent>(field, new HibernateValidationUI(
            sourceObject, sourceProperty));
}
}

createTextField()�Ҏ��主要��给定对象属性的��g��JTextField的text�l�定�Q�然后将JTextField�U�_��? JXLayer的管理之下。这样一来，一旦用户在JTextField里面修改数据�Q�这个改变就会同步到该对象属性上�Q�然后就引发了前面描�q�的一�p�d��? 辑，最�l�改变的数据��׃��被Hiberante Validator加以验证�?

最后，我们可以�~�写一个Demo application来看看效果如何，代码如下�Q?

package de.jingge.main;

import de.jingge.domain.Country;
import java.awt.BorderLayout;
import java.awt.Dimension;
import java.awt.Toolkit;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.UIManager;
import javax.swing.UnsupportedLookAndFeelException;
import javax.swing.text.JTextComponent;
import net.miginfocom.swing.MigLayout;
import org.jdesktop.beansbinding.BindingGroup;
import org.jdesktop.jxlayer.JXLayer;
import static de.jingge.view.GuiComponentFactory.*;

public class ValidationApplicaton {

private BindingGroup bg;
private Country country;
private JXLayer<jTextComponent> codeField;
private JXLayer<jTextComponent> nameField;

/**
* @param args the command line arguments
*/
public static void main(String[] args) {
    try {
        UIManager.setLookAndFeel(
                "com.sun.java.swing.plaf.nimbus.NimbusLookAndFeel");
    } catch (UnsupportedLookAndFeelException ex) {
        System.err.println(
                "Nimbus L&F does not support. Default L&F will be used.");
    } catch (ClassNotFoundException e) {
        // TODO Auto-generated catch block
        e.printStackTrace();
    } catch (InstantiationException e) {
        // TODO Auto-generated catch block
        e.printStackTrace();
    } catch (IllegalAccessException e) {
        // TODO Auto-generated catch block
        e.printStackTrace();
    }
    ValidationApplicaton app = new ValidationApplicaton();
    JFrame frame = new JFrame("Demo Validation Application");
    frame.setPreferredSize(new Dimension(360, 150));
    frame.getContentPane().add(app.buildPanel(), BorderLayout.CENTER);
    frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
    setCenter(frame);
    frame.setVisible(true);
    frame.pack();

}

private static void setCenter(JFrame frame) {
    Toolkit toolkit = Toolkit.getDefaultToolkit();
    Dimension screenSize = toolkit.getScreenSize();

    // Calculate the frame location
    int x = (screenSize.width - (int) frame.getPreferredSize().getWidth()) / 2;
    int y = (screenSize.height - (int) frame.getPreferredSize().getHeight()) / 2;

    // Set the new frame location
    frame.setLocation(x, y);
}

public ValidationApplicaton() {
    country = new Country();
    bg = new BindingGroup();
}

private JPanel buildPanel() {

    codeField = createTextField(bg, country, Country.PROPERTYNAME_CODE);
    nameField = createTextField(bg, country, Country.PROPERTYNAME_NAME);
    JPanel panel = new JPanel(new MigLayout("",
            "[50px, right]10[200px:250px:300px]", "[center]"));
    panel.add(new JLabel("Code:"), "cell 0 0");
    panel.add(codeField, "cell 1 0, w 200px:250px:300px");
    panel.add(new JLabel("Name:"), "cell 0 1");
    panel.add(nameField, "cell 1 1, w 200px:250px:300px");
    return panel;
}
}

�q�个�c�L��较简单了�Q�我��单解释一下：

在main()�Ҏ��里面�Q�我们创��Z��一个JFrame�Q�然后放入一个JPanel

setCenter()�Ҏ��负责��窗口至于屏�q�的正中间�?

在构建器里面�Q�我们创��Z��Country和BindingGroup的对象实例�?

在buildPanel()�Ҏ��里面�Q�我们��用MigLayout构徏了一个Panel�Q�其中codeField和nameField对应各自的对象属性。更多关于MigLayout的信息看�q�里�Q?a target="_blank">http://www.miglayout.com/。这也是一个例子，大家可以看到使用MigLayout开发Swing真的是非常方�ѝ�?

从这个Demo里面也可以看出，�~�写好pojo后，�E�序员只需要调用createTextField(bg, country, Country.PROPERTYNAME_CODE); ��可以创��Z��个支持数据验证的JTextField�Q�编码量已经可以说是最大限度的降低了�?

�q�行�E�序�Q�你会看刎ͼ�

�q�个code和name的数据都不合法，用户看到了error icon�?

��鼠标移到Text field上，你会看到�Q?

填好合法数据后，Error icon��׃��见了�Q?

�ȝ��Q?

使用�q�个通用数据验证模块有很多好处：

1. 如果��目使用ORM�Q�例如Hibernate�Q�这个方案应该是解决数据验证的最好方案之一�?
2. 对于普通的数据验证�Q�例如非�I�，email�Q�长度等�{�，�E�序员根本不需要编码，只要在POJO上��用相应的Hibernate Validator annotation��可以了�?
3. 对于复杂的数据验证，Hibernate Validator提供了很好的扩展机制�Q�只要写一个annotation外加一个Validator��可以了。Swing应用�q�边仍然不需要编写�Q何代码�?

�l�g��所�q�ͼ�可以看出通过使用�q�个通用数据验证模块�Q�开发效率会提高很多�?

polygoncell 2008-07-29 18:27 发表评论

customer enum

polygoncell — Fri, 28 Mar 2008 16:58:00 GMT

在上一��博客里�Q�我�~�写了一个UserType�Q�实��C��持久化自定义的enum�c�，其实那个例子中存在两个缺炏V��这两个�~�点是关于如何正��用enum以及generic的，她们已经和hibernate userType无关了，因此另�v一个主题讨论�?br />
在上一��博客中�Q�我的enum是这么写的：

public enum Status implements DescriptionID {

    ACTIVATED(5, "This object is activated"),
    DEACTIVATED(9, "This object is deactivated");

    private Integer id;
    private String description;
    private static List<Status> list;

    static {
        list = new ArrayList<Status>(2);
        list.add(ACTIVATED);
        list.add(DEACTIVATED);
    }

    private Status(int statusNr, String description) {
        this.id = statusNr;
        this.description = description;
    }

    public String getDescription() {

        return this.description;
    }

    public Integer getId() {
        return id;
    }

    public static List<Status> getAll() {
        return list;
    }

    public static Status findById(Integer id) {
        for (Status status : getAll()) {
            if (id == status.getId()) {
                return status;
            }
        }
        return null;
    }

}

其中两个static�Ҏ��是�ؓ了方便��用�?br />
�~�点一�Q?br />
所有的enum实例必须手动�U�_��list集合中�?br />
解决�Ҏ��Q?

解决�Ҏ��非常��单，是用Class�c�L��供的�Ҏ��getEnumConstants()�Q?代码如下�Q?br />

    public static List<Status> getAll() {
        return Arrays.asList(Status.class.getEnumConstants());
    }

我个人比较讨厌数�l�，因此�q�里�Ҏ��数�l��{换成List。如果你们不介意使用数组的话�Q�getAll�Q�）�Ҏ��完全可以省略�?br />
�~�点二：

findById(Integer id) �Ҏ��名�ƈ不脓切，叫getEnumById(Integer id)会更好些。另外一模一��L��Ҏ��必须在每一个enum�c�M��重复�~�写�Q�如果某个地斚w��要改动，那就需要改动所有相关的enum�c�，�q�是一个很明显的bad smell�?br />
解决�Ҏ��Q?br />
�~�写一个util�c�，��逻辑转移到util�c�M��Q�getEnumById(Integer id)�Ҏ��调用util�c�M��的相��x��法，代码如下�Q?br />

    public static Status getEnumById(Integer id) {
        return EnumUtils.getEnum(Status.class, id);
    }

public class EnumUtils {

    public static <I extends DescriptionID> I getEnum(Class<I> type, int id) {
        I[] types = type.getEnumConstants();
        for (I t : types) {
            if (t.getId() == id)
                return t;
        }
        return null;
    }
}

�q�里getEnum(Class type, int id)�Ҏ��利用Java 5的新�Ҏ��generic,利用�l�定的Class和enum id�Q�返回对应的enum实例。这样处理好处很明显�Q�获取enum实例的逻辑代码只存在与util�c�M��Q�日后修改十分方�ѝ�?br />
相关内容请参�?span style="color: #000000;">我写�?a target="_blank" title="《Hibernate 3和Java Persistence API �E�序开发从入门到精通�? >《Hibernate 3和Java Persistence API �E�序开发从入门到精通�?/a>一书�?/span>

polygoncell 2008-03-29 00:58 发表评论

Hibernate user type

polygoncell — Fri, 21 Mar 2008 12:14:00 GMT
前段旉��写了本书@Embeddable�?/tt>@Embedded��可以解决问题了�Q�只有嵌入对象方式无法满��求时�Q�或者是Hibernate默认的持久化方式无法满��要求�Ӟ��才应该考虑UserType。��M��C��一个原则，不到��q��水尽�Q�不要轻易��用UserType。还有一个要慎重考虑使用UserType的原因是�Q�一旦采用了UserType�Q�你的项目就��q��了JPA�Q�而直接和Hibernate耦合在一起了�?br />
扩展UserType主要分�ؓ两种�Q?br />

immutable

mutable

今天我先举个immutable的例子�?br />
Java 5提出了一个新的enum�c�，JPA提供的标准方法是保存enum的name或者是ordinal。这�U�默认方式能够满��x��开发的��目�Q�但是对于一些老项目翻新�ƈ不一定适用。下面我们来看一个例子：

public class Status {

    public static final int ACTIVATED = 5;
    public static final int DEACTIVATED = 6;
}

�q�个是在java5之前常用的常量定义方法，老项目数据库里面已经保存了很多的5�?的。现在要把Status改写成enum�Q�而且不希望修�Ҏ��据库中已有的数据�Q�怎么做？�W�一反应�Q�status enum可以�q�么写：

public enum Status {
        ACTIVATED,
        DEACTIVATED;
}

持久化enum的name属性是肯定不用考虑了，ordinal属性呢�Q�这里要保存的可�?�?�Q�而Status enum只有两个实体�Q�他们的ordinal只是0�?。而且��目中还会有其他很多�c�M��的常量类需要改写成enum�Q�JPA的默认方式无法完成�Q务，�q�时候可以开始考虑使用UserType了�?br />
先定义一个接口，�q�样可以使用一个UserType支持所有类似的enum�Q?br />

public interface DescriptionID {

    String getDescription();

    int getId();
}

然后改写Status enum:

public enum Status implements DescriptionID {

    ACTIVATED(5, "This object is activated"),
    DEACTIVATED(9, "This object is deactivated");

    private Integer id;
    private String description;
    private static List<Status> list;

    static {
        list = new ArrayList<Status>(2);
        list.add(ACTIVATED);
        list.add(DEACTIVATED);
    }

    private Status(int statusNr, String description) {
        this.id = statusNr;
        this.description = description;
    }

    public String getDescription() {

        return this.description;
    }

    public Integer getId() {
        return id;
    }

    public static List<Status> getAll() {
        return list;
    }

    public static Status findById(Integer id) {
        for (Status status : getAll()) {
            if (id == status.getId()) {
                return status;
            }
        }
        return null;
    }

}

注意�q�里每个enum都必��L��两个static�Ҏ��Q�这些方法名必须在所有的enum中保持一致。List�Q�）�Ҏ��是�ؓ了方便获取所有的Status帔R��Q�例如在用户界面通过ComboBox展示�Q�findById()�Ҏ��是�ؓ了通过�l�定Id获得对应的Enum实例。其中findById()�Ҏ��参数一定要是Integer�Q�原因后面会讲到�?br />
下面�~�写DescriptionIDUserType�Q?br />

public class DescriptionIDUserType implements UserType, ParameterizedType {

    private Class enumClass;

    public void setParameterValues(Properties parameters) {
        try {
            enumClass = ReflectHelper.classForName(parameters.getProperty("class"));
        } catch (ClassNotFoundException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }

    }

    public Object assemble(Serializable cached, Object arg1)
            throws HibernateException {

        return cached;
    }

    /*
     * (non-Javadoc)
     *
     * @see org.hibernate.usertype.UserType#deepCopy(java.lang.Object)
     */
    public Object deepCopy(Object value) throws HibernateException {
        // TODO Auto-generated method stub
        return value;
    }

    /*
     * (non-Javadoc)
     *
     * @see org.hibernate.usertype.UserType#disassemble(java.lang.Object)
     */
    public Serializable disassemble(Object value) throws HibernateException {
        // TODO Auto-generated method stub
        return (Serializable) value;
    }

    /*
     * (non-Javadoc)
     *
     * @see org.hibernate.usertype.UserType#equals(java.lang.Object,
     *      java.lang.Object)
     */
    public boolean equals(Object id1, Object id2) throws HibernateException {
        if (id1 == id2) {
            return true;
        }
        if (id1 == null || id2 == null) {
            return false;
        }

        final DescriptionID did1 = (DescriptionID) id1;
        final DescriptionID did2 = (DescriptionID) id2;

        return did1.getId() == did2.getId()
                && StringUtils.equals(did1.getDescription(), did2
                        .getDescription());
    }

    /*
     * (non-Javadoc)
     *
     * @see org.hibernate.usertype.UserType#hashCode(java.lang.Object)
     */
    public int hashCode(Object value) throws HibernateException {
        // TODO Auto-generated method stub
        return value.hashCode();
    }

    /*
     * (non-Javadoc)
     *
     * @see org.hibernate.usertype.UserType#isMutable()
     */
    public boolean isMutable() {
        // TODO Auto-generated method stub
        return false;
    }

    /*
     * (non-Javadoc)
     *
     * @see org.hibernate.usertype.UserType#nullSafeGet(java.sql.ResultSet,
     *      java.lang.String[], java.lang.Object)
     */
    public Object nullSafeGet(ResultSet resultSet, String[] names, Object owner)
            throws HibernateException, SQLException {
        try {
            int id = resultSet.getInt(names[0]);
            if (resultSet.wasNull()) {
                return null;
            }
            return enumClass.getMethod("findById", new Class[] { Integer.class })
                    .invoke(null, id);
        } catch (IllegalArgumentException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (SecurityException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (IllegalAccessException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (InvocationTargetException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (NoSuchMethodException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
        return null;
    }

    /*
     * (non-Javadoc)
     *
     * @see org.hibernate.usertype.UserType#nullSafeSet(java.sql.PreparedStatement,
     *      java.lang.Object, int)
     */
    public void nullSafeSet(PreparedStatement statement, Object value, int index)
            throws HibernateException, SQLException {
        if (value == null) {
            statement.setNull(index, Hibernate.INTEGER.sqlType());
        } else {
            DescriptionID dID = (DescriptionID) value;
            statement.setInt(index, dID.getId());
        }
    }

    /*
     * (non-Javadoc)
     *
     * @see org.hibernate.usertype.UserType#replace(java.lang.Object,
     *      java.lang.Object, java.lang.Object)
     */
    public Object replace(Object original, Object arg1, Object arg2)
            throws HibernateException {
        // TODO Auto-generated method stub
        return original;
    }

    /*
     * (non-Javadoc)
     *
     * @see org.hibernate.usertype.UserType#returnedClass()
     */
    public Class returnedClass() {
        return DescriptionID.class;
    }

    /*
     * (non-Javadoc)
     *
     * @see org.hibernate.usertype.UserType#sqlTypes()
     */
    public int[] sqlTypes() {
        return new int[]{Hibernate.INTEGER.sqlType()};
    }

}

我们的这个UserType是要支持实现DescriptionID的各�U�不同的enum�Q�而enum是没法��承的。所以我们需要用��L��出具体的参数�Q�以�q�一步确定到底是哪个enum�c�R��这也就��D��了，我们的这个类需要实�?/span>ParameterizedType接口�?/span>

�׃��enum�c�L��w�是immutable的，所以这个UserType的实现类相对比较��单，主要的两个方法是nullSafeGet�?/span>nullSafeSet。在nullSaftGet中我们��用Java Reflection�q�借助用户�l�出的enum�c�d��数直接调用该enum�cȝ��findById�Q�）�Ҏ��Q�这��h��们就可以使用数据库中的integer扑ֈ�对应的enum实例。注意，�׃��使用了Java Reflection,所以findById()�Ҏ��参数必须是Integer而非int�?在nullSafeSet中，我们则通过DescriptionID接口直接获取enum实例的id属性，�q�且��它保存到数据库中去�?br />
最后看看怎么使用�q�个UserType�Q?br />

@TypeDefs({@TypeDef(name = "status", typeClass = DescriptionIDUserType.class,
                    parameters = {@Parameter(name = "class", value = "com.yourpackage.Status")})})
@Entity
public class SomeObject {

    private Integer objectId;
    private Status status;

    @Id
    @GeneratedValue(strategy=GenerationType.AUTO)
    public Integer getObjectId() {
        return objectId;
    }

    public void setObjectId(Integer objectId) {
        this.objectId = objectId;
    }

    @Type(type = "status")
    public Status getStatus() {
        return status;
    }

    public void setStatus(Status status) {
        this.status = status;
    }
}

其中值得讲讲的就是定义Type时��用的parameter,"class"参数是我们自己定义的�Q�该参数�?span style="color: #000000;">DescriptionIDUserType提供了具体的enum�c�R��前面已�l�讲�q�了�Q?span style="color: #000000;">DescriptionIDUserType��是在运行时态利用这个参数自定义enum与数据库之间的持久化逻辑�?br />
使用�q�个UserType之后�Q�我们就可以在确保数据库数据不变的情况下�Q�成功地��类型不保险的常量类改写成enum�Q�而且�q�个UserType支持所有实��C��DescriptionID接口的enum�c�R�?br />
�c�M��的情冉|��友们可以自由发挥了�?br />
关于Annotation和Usertype的相关知识请参考我写的 polygoncell 2008-03-21 20:14 发表评论