tutorial.html

是一个中文的Hibernate库文档

            </p></div><div class="sect2" lang="zh-cn"><div class="titlepage"><div><div><h3 class="title"><a name="tutorial-firstapp-mapping"></a>2.2.2.&nbsp;
		&#26144;&#23556;&#25991;&#20214;
		</h3></div></div><div></div></div><p>
		  Hibernate&#38656;&#35201;&#30693;&#36947;&#24590;&#26679;&#21435;&#21152;&#36733;&#65288;load&#65289;&#21644;&#23384;&#20648;&#65288;store&#65289;&#25105;&#20204;&#30340;&#25345;&#20037;&#21270;&#31867;&#30340;&#23545;&#35937;&#12290;&#36825;&#37324;&#27491;&#26159;Hibernate&#26144;&#23556;&#25991;&#20214;&#65288;mapping file&#65289;&#21457;&#25381;&#20316;&#29992;&#30340;&#22320;&#26041;&#12290;
		  &#26144;&#23556;&#25991;&#20214;&#21578;&#35785;Hibernate&#23427;&#24212;&#35813;&#35775;&#38382;&#25968;&#25454;&#24211;&#37324;&#38754;&#30340;&#21738;&#20010;&#34920;&#65288;table&#65289;&#21644;&#24212;&#35813;&#20351;&#29992;&#34920;&#37324;&#38754;&#30340;&#21738;&#20123;&#23383;&#27573;&#65288;column&#65289;&#12290;

            </p><p>
		&#19968;&#20010;&#26144;&#23556;&#25991;&#20214;&#30340;&#22522;&#26412;&#32467;&#26500;&#30475;&#36215;&#26469;&#20687;&#36825;&#26679;&#65306;
            </p><pre class="programlisting">&lt;?xml version="1.0"?&gt;
&lt;!DOCTYPE hibernate-mapping PUBLIC
        "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
        "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"&gt;

&lt;hibernate-mapping&gt;
[...]
&lt;/hibernate-mapping&gt;</pre><p>
		  &#27880;&#24847;Hibernate&#30340;DTD&#26159;&#38750;&#24120;&#22797;&#26434;&#30340;&#12290;
  		&#20320;&#21487;&#20197;&#22312;&#20320;&#30340;&#32534;&#36753;&#22120;&#25110;&#32773;IDE&#37324;&#38754;&#20351;&#29992;&#23427;&#26469;&#33258;&#21160;&#25552;&#31034;&#24182;&#23436;&#25104;&#65288;auto-completion&#65289;&#37027;&#20123;&#29992;&#26469;&#26144;&#23556;&#30340;XML&#20803;&#32032;&#65288;element&#65289;&#21644;&#23646;&#24615;&#65288;attribute&#65289;&#12290;
		  &#20320;&#20063;&#21487;&#20197;&#29992;&#20320;&#30340;&#25991;&#26412;&#32534;&#36753;&#22120;&#25171;&#24320;DTD&#65293;&#36825;&#26159;&#26368;&#31616;&#21333;&#30340;&#26041;&#24335;&#26469;&#27983;&#35272;&#25152;&#26377;&#20803;&#32032;&#21644;&#21442;&#25968;&#65292;&#26597;&#30475;&#23427;&#20204;&#30340;&#32570;&#30465;&#20540;&#20197;&#21450;&#23427;&#20204;&#30340;&#27880;&#37322;&#65292;&#20197;&#24471;&#21040;&#19968;&#20010;&#25972;&#20307;&#30340;&#27010;&#35266;&#12290;
		&#21516;&#26102;&#20063;&#35201;&#27880;&#24847;Hibernate&#19981;&#20250;&#20174;web&#19978;&#38754;&#33719;&#21462;DTD&#25991;&#20214;&#65292;&#34429;&#28982;XML&#37324;&#38754;&#30340;URL&#20063;&#35768;&#20250;&#24314;&#35758;&#23427;&#36825;&#26679;&#20570;&#65292;&#20294;&#26159;Hibernate&#20250;&#39318;&#20808;&#26597;&#30475;&#20320;&#30340;&#31243;&#24207;&#30340;classpath&#12290;
		DTD&#25991;&#20214;&#34987;&#21253;&#25324;&#22312;<tt class="literal">hibernate3.jar</tt>&#65292;&#21516;&#26102;&#20063;&#22312;Hibernate&#20998;&#21457;&#29256;&#30340;<tt class="literal">src/</tt>&#36335;&#24452;&#19979;&#12290;
            </p><p>
		   &#22312;&#20197;&#21518;&#30340;&#20363;&#23376;&#37324;&#38754;&#65292;&#25105;&#20204;&#23558;&#36890;&#36807;&#30465;&#30053;DTD&#30340;&#22768;&#26126;&#26469;&#32553;&#30701;&#20195;&#30721;&#38271;&#24230;&#12290;&#20294;&#26159;&#26174;&#28982;&#65292;&#22312;&#23454;&#38469;&#30340;&#31243;&#24207;&#20013;&#65292;DTD&#22768;&#26126;&#26159;&#24517;&#39035;&#30340;&#12290;
            </p><p>
                &#22312;&#20004;&#20010;<tt class="literal">hibernate-mapping</tt>&#26631;&#31614;&#65288;tag&#65289;&#20013;&#38388;, &#25105;&#20204;&#21253;&#21547;&#20102;&#19968;&#20010;
                <tt class="literal">class</tt>&#20803;&#32032;&#65288;element)&#12290;&#25152;&#26377;&#30340;&#25345;&#20037;&#24615;&#23454;&#20307;&#31867;&#65288;persistent entity classes&#65289;(&#20877;&#27425;&#22768;&#26126;&#65292;
		&#36825;&#37324;&#20063;&#21253;&#25324;&#37027;&#20123;&#20381;&#36182;&#31867;&#65292;&#23601;&#26159;&#37027;&#20123;&#27425;&#35201;&#30340;&#23454;&#20307;)&#37117;&#38656;&#35201;&#19968;&#20010;&#36825;&#26679;&#30340;&#26144;&#23556;&#65292;&#26469;&#26144;&#23556;&#21040;&#25105;&#20204;&#30340;SQL database&#12290;

            </p><pre class="programlisting">&lt;hibernate-mapping&gt;

    &lt;class name="Event" table="EVENTS"&gt;

    &lt;/class&gt;

&lt;/hibernate-mapping&gt;</pre><p>
		 &#25105;&#20204;&#21040;&#29616;&#22312;&#20026;&#27490;&#20570;&#30340;&#19968;&#20999;&#26159;&#21578;&#35785;Hibernate&#24590;&#26679;&#20174;&#25968;&#25454;&#24211;&#34920;&#65288;table&#65289;<tt class="literal">EVENTS</tt>&#37324;&#25345;&#20037;&#21270;&#21644;
		&#21152;&#36733;<tt class="literal">Event</tt>&#31867;&#30340;&#23545;&#35937;&#65292;&#27599;&#20010;&#23454;&#20363;&#23545;&#24212;&#25968;&#25454;&#24211;&#37324;&#38754;&#30340;&#19968;&#34892;&#12290;&#29616;&#22312;&#25105;&#20204;&#23558;&#32487;&#32493;&#35752;&#35770;&#26377;&#20851;&#21807;&#19968;&#26631;&#35782;&#23646;&#24615;&#65288;unique identifier property&#65289;&#30340;&#26144;&#23556;&#12290;
		&#21478;&#22806;&#65292;&#25105;&#20204;&#19981;&#24076;&#26395;&#21435;&#32771;&#34385;&#24590;&#26679;&#20135;&#29983;&#36825;&#20010;&#26631;&#35782;&#23646;&#24615;&#65292;&#25105;&#20204;&#23558;&#37197;&#32622;Hibernate&#30340;&#26631;&#35782;&#31526;&#29983;&#25104;&#31574;&#30053;&#65288;identifier generation strategy&#65289;&#26469;&#20135;&#29983;&#20195;&#29992;&#20027;&#38190;&#12290;

            </p><pre class="programlisting">&lt;hibernate-mapping&gt;

    &lt;class name="Event" table="EVENTS"&gt;
        &lt;id name="id" column="EVENT_ID"&gt;
            &lt;generator class="increment"/&gt;
        &lt;/id&gt;
    &lt;/class&gt;

&lt;/hibernate-mapping&gt;</pre><p>
                <tt class="literal">id</tt>&#20803;&#32032;&#26159;&#26631;&#35782;&#23646;&#24615;&#65288;identifer property&#65289;&#30340;&#22768;&#26126;&#65292;
                <tt class="literal">name="id"</tt> &#22768;&#26126;&#20102;Java&#23646;&#24615;&#65288;property&#65289;&#30340;&#21517;&#23383; &#65293; 
                Hibernate&#23558;&#20351;&#29992;<tt class="literal">getId()</tt>&#21644;<tt class="literal">setId()</tt>&#26469;&#35775;&#38382;&#23427;&#12290;
		  &#23383;&#27573;&#21442;&#25968;&#65288;column attribute&#65289;&#21017;&#21578;&#35785;Hibernate&#25105;&#20204;&#20351;&#29992;<tt class="literal">EVENTS</tt>&#34920;&#30340;&#21738;&#20010;&#23383;&#27573;&#20316;&#20026;&#20027;&#38190;&#12290;
		 &#23884;&#22871;&#30340;<tt class="literal">generator</tt>&#20803;&#32032;&#25351;&#23450;&#20102;&#26631;&#35782;&#31526;&#30340;&#29983;&#25104;&#31574;&#30053;
                &#65293; &#22312;&#36825;&#37324;&#25105;&#20204;&#20351;&#29992;<tt class="literal">increment</tt>&#65292;&#36825;&#20010;&#26159;&#38750;&#24120;&#31616;&#21333;&#30340;&#22312;&#20869;&#23384;&#20013;&#30452;&#25509;&#29983;&#25104;&#25968;&#23383;&#30340;&#26041;&#27861;&#65292;&#22810;&#25968;&#29992;&#20110;&#27979;&#35797;&#65288;&#25110;&#25945;&#31243;&#65289;&#20013;&#12290;
		Hibernate&#21516;&#26102;&#20063;&#25903;&#25345;&#20351;&#29992;&#25968;&#25454;&#24211;&#29983;&#25104;&#65288;database generated&#65289;&#65292;&#20840;&#23616;&#21807;&#19968;&#24615;&#65288;globally unique&#65289;&#21644;&#24212;&#29992;&#31243;&#24207;&#25351;&#23450;&#65288;application assigned&#65289;
		&#65288;&#25110;&#32773;&#20320;&#33258;&#24049;&#20026;&#20219;&#20309;&#24050;&#26377;&#31574;&#30053;&#25152;&#20889;&#30340;&#25193;&#23637;&#65289;
		&#36825;&#20123;&#26041;&#24335;&#26469;&#29983;&#25104;&#26631;&#35782;&#31526;&#12290;
            </p><p>
		&#26368;&#21518;&#25105;&#20204;&#36824;&#24517;&#39035;&#22312;&#26144;&#23556;&#25991;&#20214;&#37324;&#38754;&#21253;&#25324;&#38656;&#35201;&#25345;&#20037;&#21270;&#23646;&#24615;&#30340;&#22768;&#26126;&#12290;&#32570;&#30465;&#30340;&#24773;&#20917;&#19979;&#65292;&#31867;&#37324;&#38754;&#30340;&#23646;&#24615;&#37117;&#34987;&#35270;&#20026;&#38750;&#25345;&#20037;&#21270;&#30340;&#65306;

            </p><pre class="programlisting">
&lt;hibernate-mapping&gt;

    &lt;class name="Event" table="EVENTS"&gt;
        &lt;id name="id" column="EVENT_ID"&gt;
            &lt;generator class="increment"/&gt;
        &lt;/id&gt;
        &lt;property name="date" type="timestamp" column="EVENT_DATE"/&gt;
        &lt;property name="title"/&gt;
    &lt;/class&gt;

&lt;/hibernate-mapping&gt;</pre><p>
		&#21644;<tt class="literal">id</tt>&#20803;&#32032;&#31867;&#20284;&#65292;<tt class="literal">property</tt>&#20803;&#32032;&#30340;<tt class="literal">name</tt>&#21442;&#25968;
             	&#21578;&#35785;Hibernate&#20351;&#29992;&#21738;&#20010;getter&#21644;setter&#26041;&#27861;&#12290;

            </p><p>
		  &#20026;&#20160;&#20040;<tt class="literal">date</tt>&#23646;&#24615;&#30340;&#26144;&#23556;&#21253;&#25324;<tt class="literal">column</tt>&#21442;&#25968;&#65292;&#20294;&#26159;<tt class="literal">title</tt>&#21364;&#27809;&#26377;&#65311;
		 &#24403;&#27809;&#26377;&#35774;&#23450;<tt class="literal">column</tt>&#21442;&#25968;&#30340;&#26102;&#20505;&#65292;Hibernate&#32570;&#30465;&#20351;&#29992;&#23646;&#24615;&#21517;&#20316;&#20026;&#23383;&#27573;&#65288;column&#65289;&#21517;&#12290;&#23545;&#20110;<tt class="literal">title</tt>&#65292;&#36825;&#26679;&#24037;&#20316;&#24471;&#24456;&#22909;&#12290;
		&#28982;&#32780;&#65292;<tt class="literal">date</tt>&#22312;&#22810;&#25968;&#30340;&#25968;&#25454;&#24211;&#37324;&#65292;&#26159;&#19968;&#20010;&#20445;&#30041;&#20851;&#38190;&#23383;&#65292;&#25152;&#20197;&#25105;&#20204;&#26368;&#22909;&#25226;&#23427;&#26144;&#23556;&#25104;&#21478;&#22806;&#19968;&#20010;&#21517;&#23383;&#12290;

            </p><p>
		  &#19979;&#19968;&#20214;&#26377;&#36259;&#30340;&#20107;&#24773;&#26159;<tt class="literal">title</tt>&#23646;&#24615;&#32570;&#23569;&#19968;&#20010;<tt class="literal">type</tt>&#21442;&#25968;&#12290;
		  &#25105;&#20204;&#22768;&#26126;&#24182;&#20351;&#29992;&#22312;&#26144;&#23556;&#25991;&#20214;&#37324;&#38754;&#30340;type&#65292;&#24182;&#19981;&#20687;&#25105;&#20204;&#20551;&#24819;&#30340;&#37027;&#26679;&#65292;&#26159;Java data type&#65292;
		  &#21516;&#26102;&#20063;&#19981;&#26159;SQL database type&#12290;&#36825;&#20123;&#31867;&#22411;&#34987;&#31216;&#20316;<span class="emphasis"><em>Hibernate mapping types</em></span>&#65292;
		  &#23427;&#20204;&#25226;&#25968;&#25454;&#31867;&#22411;&#20174;Java&#36716;&#25442;&#21040;SQL data types&#12290;&#22914;&#26524;&#26144;&#23556;&#30340;&#21442;&#25968;&#27809;&#26377;&#35774;&#32622;&#30340;&#35805;&#65292;Hibernate&#20063;&#23558;&#23581;&#35797;&#21435;&#30830;&#23450;&#27491;&#30830;&#30340;&#31867;&#22411;&#36716;&#25442;&#21644;&#23427;&#30340;&#26144;&#23556;&#31867;&#22411;&#12290;
		  &#22312;&#26576;&#20123;&#24773;&#20917;&#19979;&#36825;&#20010;&#33258;&#21160;&#26816;&#27979;&#65288;&#22312;Java class&#19978;&#20351;&#29992;&#21453;&#23556;&#26426;&#21046;&#65289;&#19981;&#20250;&#20135;&#29983;&#20320;&#25152;&#26399;&#24453;&#25110;&#32773;
		&#38656;&#35201;&#30340;&#32570;&#30465;&#20540;&#12290;&#36825;&#37324;&#26377;&#20010;&#20363;&#23376;&#26159;&#20851;&#20110;<tt class="literal">date</tt>&#23646;&#24615;&#12290;Hibernate&#26080;&#27861;&#30693;&#36947;&#36825;&#20010;&#23646;&#24615;&#24212;&#35813;&#34987;&#26144;&#23556;&#25104;&#19979;&#38754;&#36825;&#20123;&#31867;&#22411;&#20013;&#30340;&#21738;&#19968;&#20010;&#65306;
		SQL <tt class="literal">date</tt>&#65292;<tt class="literal">timestamp</tt>&#65292;<tt class="literal">time</tt>&#12290;
		&#25105;&#20204;&#36890;&#36807;&#22768;&#26126;&#23646;&#24615;&#26144;&#23556;<tt class="literal">timestamp</tt>&#26469;&#34920;&#31034;&#25105;&#20204;&#24076;&#26395;&#20445;&#23384;&#25152;&#26377;&#30340;&#20851;&#20110;&#26085;&#26399;&#21644;&#26102;&#38388;&#30340;&#20449;&#24687;&#12290;
            </p><p>
		 &#36825;&#20010;&#26144;&#23556;&#25991;&#20214;&#65288;mapping file&#65289;&#24212;&#35813;&#34987;&#20445;&#23384;&#20026;<tt class="literal">Event.hbm.xml</tt>&#65292;&#21644;&#25105;&#20204;&#30340;<tt class="literal">Event</tt>Java
		&#28304;&#25991;&#20214;&#25918;&#22312;&#21516;&#19968;&#20010;&#30446;&#24405;&#19979;&#12290;&#26144;&#23556;&#25991;&#20214;&#30340;&#21517;&#23383;&#21487;&#20197;&#26159;&#20219;&#24847;&#30340;&#65292;&#28982;&#32780;<tt class="literal">hbm.xml</tt>&#24050;&#32463;&#25104;&#20026;Hibernate&#24320;&#21457;&#32773;&#31038;&#21306;&#30340;&#20064;&#24815;&#24615;&#32422;&#23450;&#12290;
		&#29616;&#22312;&#30446;&#24405;&#24212;&#35813;&#30475;&#36215;&#26469;&#20687;&#36825;&#26679;&#65306;
            </p><pre class="programlisting">.
+lib
  &lt;Hibernate and third-party libraries&gt;
+src
  Event.java
  Event.hbm.xml</pre><p>
			&#25105;&#20204;&#32487;&#32493;&#36827;&#34892;Hibernate&#30340;&#20027;&#35201;&#37197;&#32622;&#12290;
             </p></div><div class="sect2" lang="zh-cn"><div class="titlepage"><div><div><h3 class="title"><a name="tutorial-firstapp-configuration"></a>2.2.3.&nbsp;
		Hibernate&#37197;&#32622;
		</h3></div></div><div></div></div><p>
		  &#25105;&#20204;&#29616;&#22312;&#24050;&#32463;&#26377;&#20102;&#19968;&#20010;&#25345;&#20037;&#21270;&#31867;&#21644;&#23427;&#30340;&#26144;&#23556;&#25991;&#20214;&#65292;&#26159;&#26102;&#20505;&#37197;&#32622;Hibernate&#20102;&#12290;&#22312;&#25105;&#20204;&#20570;&#36825;&#20010;&#20043;&#21069;&#65292;&#25105;&#20204;&#38656;&#35201;&#19968;&#20010;&#25968;&#25454;&#24211;&#12290;
		  HSQL DB&#65292;&#19968;&#20010;java-based&#20869;&#23884;&#24335;SQL&#25968;&#25454;&#24211;&#65288;in-memory SQL Database&#65289;&#65292;&#21487;&#20197;&#20174;HSQL DB&#30340;&#32593;&#31449;&#19978;&#19979;&#36733;&#12290;
		&#23454;&#38469;&#19978;&#65292;&#20320;&#20165;&#20165;&#38656;&#35201;&#19979;&#36733;/lib/&#30446;&#24405;&#20013;&#30340;<tt class="literal">hsqldb.jar</tt>&#12290;&#25226;&#36825;&#20010;&#25991;&#20214;&#25918;&#22312;&#24320;&#21457;&#25991;&#20214;&#22841;&#30340;<tt class="literal">lib/</tt>&#30446;&#24405;&#37324;&#38754;&#12290;
		
            </p><p>
		&#22312;&#24320;&#21457;&#30446;&#24405;&#19979;&#38754;&#21019;&#24314;&#19968;&#20010;&#21483;&#20570;<tt class="literal">data</tt>&#30340;&#30446;&#24405; &#65293; &#36825;&#20010;&#26159;HSQL DB&#23384;&#20648;&#23427;&#30340;&#25968;&#25454;&#25991;&#20214;&#30340;&#22320;&#26041;&#12290;

            </p><p>
		   Hibernate&#26159;&#20320;&#30340;&#31243;&#24207;&#37324;&#36830;&#25509;&#25968;&#25454;&#24211;&#30340;&#37027;&#20010;&#24212;&#29992;&#23618;&#65292;&#25152;&#20197;&#23427;&#38656;&#35201;&#36830;&#25509;&#29992;&#30340;&#20449;&#24687;&#12290;&#36830;&#25509;&#65288;connection&#65289;&#26159;&#36890;&#36807;&#19968;&#20010;&#20063;&#30001;&#25105;&#20204;&#37197;&#32622;&#30340;JDBC&#36830;&#25509;&#27744;&#65288;connection pool&#65289;&#12290;
		   Hibernate&#30340;&#20998;&#21457;&#29256;&#37324;&#38754;&#21253;&#25324;&#20102;&#19968;&#20123;open source&#30340;&#36830;&#25509;&#27744;&#65292;&#20294;&#26159;&#25105;&#20204;&#24050;&#32463;&#20915;&#23450;&#22312;&#36825;&#20010;&#25945;&#31243;&#37324;&#38754;&#20351;&#29992;&#20869;&#23884;&#24335;&#36830;&#25509;&#27744;&#12290;
		&#22914;&#26524;&#20320;&#24076;&#26395;&#20351;&#29992;&#19968;&#20010;&#20135;&#21697;&#32423;&#30340;&#31532;&#19977;&#26041;&#36830;&#25509;&#27744;&#36719;&#20214;&#65292;&#20320;&#24517;&#39035;&#25335;&#36125;&#25152;&#38656;&#30340;&#24211;&#25991;&#20214;&#21435;&#20320;&#30340;classpath&#24182;&#20351;&#29992;&#19981;&#21516;&#30340;&#36830;&#25509;&#27744;&#35774;&#32622;&#12290;
            </p><p>
		&#20026;&#20102;&#37197;&#32622;Hibernate&#65292;&#25105;&#20204;&#21487;&#20197;&#20351;&#29992;&#19968;&#20010;&#31616;&#21333;&#30340;<tt class="literal">hibernate.properties</tt>&#25991;&#20214;&#65292;
		&#25110;&#32773;&#19968;&#20010;&#31245;&#24494;&#22797;&#26434;&#30340;<tt class="literal">hibernate.cfg.xml</tt>&#65292;&#29978;&#33267;&#21487;&#20197;&#23436;&#20840;&#20351;&#29992;&#31243;&#24207;&#26469;&#37197;&#32622;Hibernate&#12290;
		&#22810;&#25968;&#29992;&#25143;&#21916;&#27426;&#20351;&#29992;XML&#37197;&#32622;&#25991;&#20214;&#65306;
            </p><pre class="programlisting">&lt;?xml version='1.0' encoding='utf-8'?&gt;
&lt;!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD 3.0//EN"