在Eclipse中使用Hibernate插件(二)

生成代码
　　这可能是你一直在等待的部分。我们能用这个插件来做什么？好，马上就开始。为Hibernate影射文档提供一个新的菜单条目。
　　右击（如果是单键鼠标，在按住Control键的同时点鼠标键)一个影射文档，菜单条目中会显示几个和Hibernate相关的选择（如图17所示），其中有一个和synchronize有关，这是一个手工方法，可以让Hibernate Synchronizer产生和该影射文档相对应的数据访问对象。

图17 Synchronizer插件为影射文档提供的几个菜单项

　　Add Mapping Reference 选项也很有用，当你单击该项时，会把相应的影射文件增加到Hibernate配置文件中，表明该文件是影射文档，因此你不需要在源代码中增加任何信息要求相应的影射文件进行设置。现在让我们看看选取Synchronize Files后的结果。
　　事情开始变得有趣，出现了两个子包，一个是“base”的DAO，Hibernate Synchronizer所有，可以在任何时候重写，一个是继承那些DAO类的商业对象，不会被覆盖，也就给了我们一个机会，可以在其中加入商业逻辑（具体如图18中所示）。

图18 同步后的DAO，图中显示的是我们可以编辑的子类

  和Hibernate的代码生成工具相比，用该插件生成了更多的类。这是优点，也可能是一些潜在的缺点，将在Trade-Offs 部分进行讨论。你可以在工程配置文件中选取要生成的类和它们所在的包的结构。我可以证明这点，但现在的发行版有个bug ,，无法访问Mac OS X上的配置界面。针对该bug的一个补丁已经做好了，但仍没有发布。
　　基于Hibernate Synchronizer网页上的例子，和以下这个类一起，用那些新的数据访问对象来试着把一些数据放入数据库中。看起来和标准的Hibernate代码生成工具生成的版本（在Hibernate: A Developer's Notebook一书的39-40页）很相似，甚至更简单一些。因为Hibernate Synchronizer生成的类为你的每个数据库操作都创建和提交一个新事务，因此在与此类似的简单情况下，你不需要自己来设置事务（当然，如果你需要把一组操作作为一个单独事务，有很多方法可以做到这点）这里是新版本的代码。

package com.oreilly.hh;

import java.sql.Time;
import java.util.Date;
import net.sf.hibernate.HibernateException;
import com.oreilly.hh.dao.TrackDAO;
import com.oreilly.hh.dao._RootDAO;

/**
 * Try creating some data using the Hibernate Synchronizer approach.
 */
public class CreateTest2 {

    public static void main(String[] args) throws HibernateException {
        // Load the configuration file
        _RootDAO.initialize();
        
        // Create some sample data
        TrackDAO dao = new TrackDAO();
        Track track = new Track("Russian Trance", "vol2/album610/track02.mp3",
            Time.valueOf("00:03:30"), new Date(), (short)0);
        dao.save(track);
        
        track = new Track("Video Killed the Radio Star",
            "vol2/album611/track12.mp3", Time.valueOf("00:03:49"), new Date(),
            (short)0);
        dao.save(track);
        
        // We don't even need a track variable, of course:
        dao.save(new Track("Gravity's Angel", "/vol2/album175/track03.mp3",
            Time.valueOf("00:06:06"), new Date(), (short)0));
    }
}

　　当我写这个的时候，有Eclipse在手边真是太好了 ，我已经忘了当写书中例子的时候多么想念智能代码完成功能，有另外几件事情JDT也发挥了作用。
   为了在Eclipse中运行这个简单的程序，需要设置一个新的运行配置。用CreateTest2.java作为当前文件，选择运行（Run ）-> 运行...（Run...）。然后单击新建(New)，因为该类有一个main() 方法，Eclipse推断出要运行该工程的当前类。Eclipse为新的运行配置取的名字，CreateTest2，很合适。屏幕窗口看起来如图19中所示，单击运行来在数据库中创建一些数据。

图19 准备在Eclipse中运行创建数据的测试程序

　　如果你确实按照上边说的来做，你会发现第一次的尝试运行失败。Hibernate抱怨配置文件中连一个映射文件都没有参考，为了运行程序，至少需要一个这样的文件。这也是为什么XMLBuddy在图16底部用黄色下划线发出警告。可以很容易修改该错误，你只要在包资源浏览器（Package Explorer）中的Track.hbm.xml这个影射文档上单击右键，在Hibernate Synchronizer子菜单中选取Add Mapping Reference(如图17中所示)，这样XMLBuddy就不会再抱怨XML文件有错误，程序也可以继续向前。不幸的是，没有向前推进我们所愿的那样远，下一个问题又出来了。Eclipse中显示的下一个错误是“不能在JNDI中找到JTA UserTransaction initial context”。不止我一个人犯这种错误，因为在a forum thread中有这样的讨论，而且到目前为止仍然没有找到一个解决方法。
　　既然我知道不需要使用JTA，我倒是很想知道为什么Hibernate竟然会使用JTA？打开Hibernate配置文件，如图16所示，看看是不是 Hibernate Synchronizer在其中加入了可疑的内容。看了配置文件后，可以确定，有一些行看起来是罪魁祸首：

 <property name="hibernate.transaction.factory_class"> 
       net.sf.hibernate.transaction.JTATransactionFactory 
 </property> 
 <property name="jta.UserTransaction"> 
       java:comp/UserTransaction 
 </property> 

　　一旦把那些行变成注释后，再次运行程序。这次，也就是第三次运行成功。我在自己计算机上运行没有一点错误，数据已经保存到数据库中。运行 ant db 这个target（在Developer's Notebook一书的第一章有相应的解释）可以把表中所有的数据显示出来（不可否认，这也许有点简单），如图20中所示。如果你跟着这篇文章中顺序来做的，而不是跟着书中步骤一步一步来的，你需要先运行ant schema来创建数据库中的表，或是删除以前试验留下的数据。

图20 在Eclipse中运行Ant

　　你可以在Eclipse内运行Ant的target，方法是用右键单击包资源浏览器（Package Explorer）中的build.xml 文件，选择菜单中的运行Ant(Run Ant)，然后在弹出对话框中选择你要运行的target，如图21所示。这个功能很cool。

图21 在Eclipse中运行Ant

　　查询数据相当简单、直白，即使Hibernate Synchronizer产生了很多辅助方法来使用指定查询，我认为这些没有什么用处，都是运行查询，然后返回包含结果的列表，而不是返回一个Query 对象，让你直接使用该对象。这使你不能使用任何Query提供的、方便的、类型安全（type-safe）的参数设置方法，因为这个，我打算让 _RootDAO对象提供一个Session对象，可以用“老式”的方法来使用Hibernate。公平来说，我认为如果编辑Hibernate Synchronizer 用来生成代码所使用的模板，就可以生成想要的任何方法，如果有一个项目，要用到该插件，可以肯定我会试着这么做。
　　实际上，进一步考虑，当你得到一个活动的Session时，你只能使用Query，而这些DAO对象已经提供为相应功能最佳的实现。如果你和我在例子中使用查询的方法一样，那就需要你自己来实现session管理。你能够把session管理内嵌于你自己所写的那一半DAO中，这样可以给你提供两方面的好处。(译者注：和有base的java POJO对象一样，对于DAO，该插件也生成一对类，一个base DAO给该插件用，一个是继承该base DAO的自定义DAO，你可以在其中添加商业逻辑)。这也是Hibernate Synchronizer把类分隔开来如此有用的另一个原因。对该插件的远见在下边做了一点研究
　　不管怎么说，下边是我第一次使用的代码，和书中48-49页上的代码功能基本一致:

package com.oreilly.hh;

import java.sql.Time;
import java.util.ListIterator;

import net.sf.hibernate.HibernateException;
import net.sf.hibernate.Query;
import net.sf.hibernate.Session;

import com.oreilly.hh.dao.TrackDAO;
import com.oreilly.hh.dao._RootDAO;

/**
 * Use Hibernate Synchronizer's DAOs to run a query
 */
public class QueryTest3 {

    public static void main(String[] args) throws HibernateException {
        // Load the configuration file and get a session
        _RootDAO.initialize();
        Session session = _RootDAO.createSession();

        try {
            // Print the tracks that will fit in five minutes
            Query query = session.getNamedQuery(
                TrackDAO.QUERY_COM_OREILLY_HH_TRACKS_NO_LONGER_THAN);
            query.setTime("length", Time.valueOf("00:05:00"));
            for (ListIterator iter = query.list().listIterator() ;
                 iter.hasNext() ; ) {
                Track aTrack = (Track)iter.next();
                System.out.println("Track: /"" + aTrack.getTitle() +
                                   "/", " + aTrack.getPlayTime());
            }
        } finally {
            // No matter what, close the session
            session.close();
        }
    }
}

　　TrackDAO为我们提供了一个很好的功能：静态常数，使用这个功能，可以用来进行指定查询（named query），这就消除了由于输入问题而导致运行时错误的任何机会。我欣赏这个功能。为该测试类设定运行配置，然后运行，输出结果正和我想的一样，如图 22所示。

图22 Eclipse控制台窗口显示的查询结果

　　如上所述，这个类运行后，借助于Hibernate Synchronizer提供的模型，我想到有一个更好的方法可以实现这个功能。把查询放到TrackDAO中去，这里才是查询方法真正属于的地方，指定查询（named query）是和该DAO关联的映射文件的一个功能。

package com.oreilly.hh.dao;

import java.sql.Time;
import java.util.List;

import net.sf.hibernate.HibernateException;
import net.sf.hibernate.Query;
import net.sf.hibernate.Session;

import com.oreilly.hh.base.BaseTrackDAO;

/**
 * This class has been automatically generated by Hibernate Synchronizer.
 * For more information or documentation, visit The Hibernate Synchronizer page
 * at http://www.binamics.com/hibernatesync or contact Joe Hudson at joe@binamics.com.
 *
 * This is the object class that relates to the TRACK table.
 * Any customizations belong here.
 */
public class TrackDAO extends BaseTrackDAO {

    // Return the tracks that fit within a particular length of time
    public static List getTracksNoLongerThan(Time time)
        throws HibernateException
    {
        Session session = _RootDAO.createSession();
        try {
            // Print the tracks that will fit in five minutes
            Query query = session.getNamedQuery(
                QUERY_COM_OREILLY_HH_TRACKS_NO_LONGER_THAN);
            query.setTime("length", time);
            return query.list();
        } finally {
            // No matter what, close the session
            session.close();
        }
    }
} 

　　以上代码，看起来更好(nice)、更为清晰(clean)，QueryTest3中的main()方法更是得到了大大简化

    public static void main(String[] args) throws HibernateException {
        // Load the configuration file and get a session
        _RootDAO.initialize();

        // Print the tracks that fit in five minutes
        List tracks = TrackDAO.getTracksNoLongerThan(Time.valueOf("00:05:00"));
        for (ListIterator iter = tracks.listIterator() ;
             iter.hasNext() ; ) {
            Track aTrack = (Track)iter.next();
            System.out.println("Track: /"" + aTrack.getTitle() +
                               "/", " + aTrack.getPlayTime());
        }
    }

　　很清楚，这是在Hibernate Synchronizer中用到指定查询（named query）时所应采取的方法。很快测试一下就可以证实以上的代码输出同样的结果，而且这里的代码更好。