2010年3月24日

  由于项目需要部署在Linux上,而又使用到Apache James作邮件服务器,因此总结了一下在Linux上部署Apache James的步骤,写得比较凌乱。

在Linux上部署Apache James

前提工作:

1)由于Apache James邮件服务需要用到1024以下的端口,因此请用root用户登录进行部署。

2)需要先安装JDK1.5或以上版本,部署前请确保您的JDK环境变量如JAVA_HOME等已经设置好。

3)James 启动时,其SMTP 服务默认在 25 端口启动,POP3 服务默认在 110 端口启动, NNTP 服务默认在 119 端口启动, 请确保这些端口未被占用。Linux下查过这些端口是否被占用的命令是:lsof -i:端口号,例如:

[root@nhslj-app ~]# lsof -i:25

COMMAND   PID USER   FD   TYPE DEVICE SIZE NODE NAME

sendmail 3268 root    4u  IPv4   8650       TCP nhslj-app:smtp (LISTEN)

这表示25端口正在被sendmail服务占用。

关闭SendMail服务:

一般RedHat的系统安装时都会默认安装了sendmail邮件服务,因此在部署Apache James时,需要把sendmail关闭。可以通过以下方法来关闭sendmail,以防止系统重启时又自动启动sendmail服务。

1)用chkconfig --list sendmail命令查看sendmail的情况:

[root@susun177 ~]# chkconfig --list sendmail

sendmail        0:关闭  1:关闭  2:启用  3:关闭  4:启用  5:启用  6:关闭

2)通过chkconfig sendmail off命令来关闭sendmail的启动:

[root@susun177 ~]# chkconfig sendmail off

3)这时再用chkconfig --list sendmail命令可以查看到sendmail的所有启动级别都已经关闭了:

[root@susun177 ~]# chkconfig --list sendmail

sendmail        0:关闭  1:关闭  2:关闭  3:关闭  4:关闭  5:关闭  6:关闭

这样,即使重新启动Linux系统,sendmail服务也不会自动启动了。

前期工作做完了,接下来就是部署Apache  James了。

1)解压Apache James包(apache-james-2.3.2.tar.gz):

[root@susun177 local]# tar zxvf apache-james-2.3.2.tar.gz

解压后,会多了一个目录james-2.3.2

2)进入james-2.3.2/bin目录,运行run.sh,生成james的配置文件config.xml:

[root@susun177 bin]# sh run.sh

run.sh: line 37: /usr/local/james-2.3.2/bin/phoenix.sh: 权限不够

权限不够(估计是解压后run.sh文件没有赋予执行权限),可以执行以下命令:

[root@susun177 bin]# chmod +x run.sh phoenix.sh

然后再次运行run.sh命令:

[root@susun177 bin]# sh run.sh

Using PHOENIX_HOME:   /usr/local/james-2.3.2

Using PHOENIX_TMPDIR: /usr/local/james-2.3.2/temp

Using JAVA_HOME:      /usr/java/jdk1.5.0

Running Phoenix:

Phoenix 4.2

James Mail Server 2.3.2

Remote Manager Service started plain:4555

POP3 Service started plain:110

SMTP Service started plain:25

NNTP Service started plain:119

FetchMail Disabled

说明James启动成功。

3)按Ctrl + C退出James,编辑config.xml文件。生成的config.xml放置在../james-2.3.2/apps/james/SAR- INF目录下。关于James的config.xml的修改,网上很多资料,请自行查阅。在这里,只写关键的修改:

A)找到<servernames autodetect="true" autodetectIP="true"> 设成        

         autodetect="false" autodetectIP="false"

         autodetct设为true会自动侦测你的主机名,设成false会用你指定的server name。

         autodetectIP设为true会为你的servername加上ip。

B)设置servername 将默认的为localhost改成你的server名字 如king.cn:

<servername>king.cn</servername>

然后修改Linux的hosts主机设置文件:

[root@susun177 SAR-INF]# vi /etc/hosts

在打开的文件添加一行,然后保存:

192.168.1.177           king.cn   king

注意:第一个为IP地址  第二个为主机域名  第三个为主机名称

提示:名字后面应该要加上.com或者.cn这样163等邮件服务器才不会拒绝的。

C)注释掉

         <mailet match="RemoteAddrNotInNetwork=127.0.0.1" class="ToProcessor>

             <processor> relay-denied </processor>

             <notice>550 - Requested action not taken: relaying denied</notice>

         </mailet>

D)配置DNS Server,先通过netstat命令查看dns配置

[root@susun177 SAR-INF]# netstat -rn

Kernel IP routing table

Destination     Gateway         Genmask         Flags   MSS Window  irtt Iface

192.168.1.0     0.0.0.0         255.255.255.0   U         0 0          0 eth0

169.254.0.0     0.0.0.0         255.255.0.0     U         0 0          0 eth0

找到<dnsserver>,在<servers>里最前面添加一行: <server>192.168.1.0</server> ,                同时设置autodiscover为false。

   <dnsserver>

      <servers>

         <!--Enter ip address of your DNS server, one IP address per server -->

         <!-- element. -->

         <!--

          <server>127.0.0.1</server>

         -->

           <server>10.168.0.10</server>         

      </servers>

      <!-- Change autodiscover to false if you would like to turn off autodiscovery -->

      <!-- and set the DNS servers manually in the <servers> section -->

      <autodiscover>false</autodiscover>

      <authoritative>false</authoritative>

      <!-- Maximum number of entries to maintain in the DNS cache -->

      <maxcachesize>50000</maxcachesize>

   </dnsserver>

E)修改James数据库连接字符串:

      <data-source name="maildb" class="org.apache.james.util.dbcp.JdbcDataSource">

         <driver>oracle.jdbc.driver.OracleDriver</driver>

         <dburl>jdbc:oracle:thin:@192.168.1.17:1521:hello</dburl>

         <user>hello</user>

         <password>kitty</password>

         <keep-alive>select 1 from dual</keep-alive>

         <testOnBorrow>true</testOnBorrow>

         <testOnReturn>true</testOnReturn>

         <max>50</max>

      </data-source>

以上用的是oracle数据库,如果是其他数据库,则需要修改为对应的数据库连接驱动,以及数据库用户信息。

注意:一定要记得配置<keep-alive>,该参数的意思是,在使用连接池的连接之前,是否需要验证该连接是否有效。之前,我没有设置该参数,结果总是出现收不到邮件的问题。

4)优化一下James内存,在../james-2.3.2/bi/phoenix.sh加入:

# Set Heap Size 2007-0818,fix OutOfMemory bug while transporting big mail

PHOENIX_JVM_OPTS="$PHOENIX_JVM_OPTS -Xms128M -Xmx512M -XX:PermSize=64M -XX:MaxPermSize=128M"

修改../james-2.3.2/conf/wrapper.conf的jvm配置,设置初始内存128M,最大内存512M

                   # Initial Java Heap Size (in MB)

                   #wrapper.java.initmemory=16

                   wrapper.java.initmemory=128

        

                   # Maximum Java Heap Size (in MB)

                   #wrapper.java.maxmemory=64

                   wrapper.java.maxmemory=512

5) 复制数据库驱动到../james-2.3.2/lib目录下,我用的是oracle数据库,驱动包为:ojdbc14.jar

6)重启Apache James服务。

7)最后,进入邮件系统全局管理,将系统的域名改为上述的server name。

8)如无意外一切OK。

posted @ 2011-03-24 20:35 别昨非 阅读(4955) | 评论 (0)编辑 收藏
 
  1. Map<String,String> map = new HashMap<String,String>();  
  2. for(Map.Entry<String, String> entry : map.entrySet()){  
  3.     String value = entry.getValue();  
  4.     String key = entry.getKey();  
  5. }
posted @ 2011-03-24 11:08 别昨非 阅读(337) | 评论 (0)编辑 收藏
 

PHP数据类型转换

PHP的数据类型转换属于强制转换,允许转换的PHP数据类型有:

•(int)、(integer):转换成整形
•(float)、(double)、(real):转换成浮点型
•(string):转换成字符串
•(bool)、(boolean):转换成布尔类型
•(array):转换成数组
•(object):转换成对象
PHP数据类型有三种转换方式:

•在要转换的变量之前加上用括号括起来的目标类型
•使用3个具体类型的转换函数,intval()、floatval()、strval()
•使用通用类型转换函数settype(mixed var,string type)
 第一种转换方式: (int)  (bool)  (float)  (string)  (array) (object)

 
1.<?php   
2.$num1=3.14;   
3.$num2=(int)$num1;   
4.var_dump($num1); //输出float(3.14)   
5.var_dump($num2); //输出int(3)   
6.?>  
第二种转换方式:  intval()  floatval()  strval()

 
1.<?php   
2.$str="123.9abc";   
3.$int=intval($str);     //转换后数值:123   
4.$float=floatval($str); //转换后数值:123.9   
5.$str=strval($float);   //转换后字符串:"123.9"    
6.?>  
第三种转换方式:  settype();

 
1.<?php   
2.$num4=12.8;   
3.$flg=settype($num4,"int");   
4.var_dump($flg);  //输出bool(true)   
5.var_dump($num4); //输出int(12)   
6.?> 

posted @ 2010-03-31 20:25 别昨非 阅读(70465) | 评论 (3)编辑 收藏
 
  1. $(document).ready(function(){    
  2.   
  3. /* 设置默认属性 */    
  4. $.validator.setDefaults({    
  5.   submitHandler: function(form) { form.submit(); }    
  6. });    
  7. // 中文字两个字节    
  8. jQuery.validator.addMethod("byteRangeLength", function(value, element, param) {    
  9.   var length = value.length;    
  10.   for(var i = 0; i < value.length; i++){    
  11.    if(value.charCodeAt(i) > 127){    
  12.     length++;    
  13.    }    
  14.   }    
  15.   return this.optional(element) || ( length >= param[0] && length <= param[1] );    
  16. }, "请确保输入的值在3-15个字节之间(一个中文字算2个字节)");    
  17.   
  18. /* 追加自定义验证方法 */    
  19. // 身份证号码验证    
  20. jQuery.validator.addMethod("isIdCardNo", function(value, element) {    
  21.   return this.optional(element) || isIdCardNo(value);    
  22. }, "请正确输入您的身份证号码");    
  23.   
  24. // 字符验证    
  25. jQuery.validator.addMethod("userName", function(value, element) {    
  26.   return this.optional(element) || /^[\u0391-\uFFE5\w]+$/.test(value);    
  27. }, "用户名只能包括中文字、英文字母、数字和下划线");    
  28.   
  29. // 手机号码验证    
  30. jQuery.validator.addMethod("isMobile", function(value, element) {    
  31.   var length = value.length;    
  32.   return this.optional(element) || (length == 11 && /^(((13[0-9]{1})|(15[0-9]{1}))+\d{8})$/.test(value));    
  33. }, "请正确填写您的手机号码");    
  34.   
  35. // 电话号码验证    
  36. jQuery.validator.addMethod("isPhone", function(value, element) {    
  37.   var tel = /^(\d{3,4}-?)?\d{7,9}$/g;    
  38.   return this.optional(element) || (tel.test(value));    
  39. }, "请正确填写您的电话号码");    
  40.   
  41. // 邮政编码验证    
  42. jQuery.validator.addMethod("isZipCode", function(value, element) {    
  43.   var tel = /^[0-9]{6}$/;    
  44.   return this.optional(element) || (tel.test(value));    
  45. }, "请正确填写您的邮政编码");    
  46. $(regFrom).validate({    
  47. /* 设置验证规则 */    
  48.   rules: {    
  49.    userName: {    
  50.     required: true,    
  51.     userName: true,    
  52.     byteRangeLength: [3,15]    
  53.    },    
  54.    password: {    
  55.     required: true,    
  56.     minLength: 5    
  57.    },    
  58.    repassword: {    
  59.     required: true,    
  60.     minLength: 5,    
  61.     equalTo: "#password"    
  62.    },    
  63.    question: {    
  64.     required: true    
  65.    },    
  66.    answer: {    
  67.     required: true    
  68.    },    
  69.    realName: {    
  70.     required: true    
  71.    },    
  72.    cardNumber: {    
  73.     isIdCardNo: true    
  74.    },    
  75.    mobilePhone: {    
  76.     isMobile: true    
  77.    },    
  78.    phone: {    
  79.     isPhone: true    
  80.    },    
  81.    email: {    
  82.     required: true,    
  83.     email: true    
  84.    },    
  85.    zipCode: {    
  86.     isZipCode:true    
  87.    }    
  88.   },    
  89. /* 设置错误信息 */    
  90.   messages: {    
  91.    userName: {    
  92.     required: "请填写用户名",    
  93.     byteRangeLength: "用户名必须在3-15个字符之间(一个中文字算2个字符)"    
  94.    },    
  95.    password: {    
  96.     required: "请填写密码",    
  97.     minlength: jQuery.format("输入{0}.")    
  98.    },    
  99.    repassword: {    
  100.     required: "请填写确认密码",    
  101.     equalTo: "两次密码输入不相同"    
  102.    },    
  103.    question: {    
  104.     required: "请填写您的密码提示问题"    
  105.    },    
  106.    answer: {    
  107.     required: "请填写您的密码提示答案"    
  108.    },    
  109.    realName: {    
  110.     required: "请填写您的真实姓名"    
  111.    },    
  112.    email: {    
  113.     required: "请输入一个Email地址",    
  114.     email: "请输入一个有效的Email地址"    
  115.    }    
  116.   },    
  117. /* 错误信息的显示位置 */    
  118.   errorPlacement: function(error, element) {    
  119.    error.appendTo( element.parent() );    
  120.   },    
  121. /* 验证通过时的处理 */    
  122.   success: function(label) {    
  123.    // set   as text for IE    
  124.    label.html(" ").addClass("checked");    
  125.   },    
  126. /* 获得焦点时不验证 */    
  127.   focusInvalid: false,    
  128.   onkeyup: false    
  129. });    
  130.   
  131. // 输入框获得焦点时,样式设置    
  132. $('input').focus(function(){    
  133.   if($(this).is(":text") || $(this).is(":password"))    
  134.    $(this).addClass('focus');    
  135.   if ($(this).hasClass('have_tooltip')) {    
  136.    $(this).parent().parent().removeClass('field_normal').addClass('field_focus');    
  137.   }    
  138. });    
  139.   
  140. // 输入框失去焦点时,样式设置    
  141. $('input').blur(function() {    
  142.   $(this).removeClass('focus');    
  143.   if ($(this).hasClass('have_tooltip')) {    
  144.    $(this).parent().parent().removeClass('field_focus').addClass('field_normal');    
  145.   }    
  146. });    
  147. });   
posted @ 2010-03-31 15:27 别昨非 阅读(874) | 评论 (0)编辑 收藏
 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<title>jQuery validation plug-in - main demo</title>

<link rel="stylesheet" type="text/css" media="screen" href="css/screen.css" />

<script src="../lib/jquery.js" type="text/javascript"></script>
<script src="../jquery.validate.js" type="text/javascript"></script>

<script type="text/javascript">
$.validator.setDefaults({
 submitHandler: function() { alert("submitted!"); }
});

$().ready(function() {
 // validate the comment form when it is submitted
 $("#commentForm").validate();
 
 // validate signup form on keyup and submit
 $("#signupForm").validate({
  rules: {
   firstname: "required",
   lastname: "required",
   username: {
    required: true,
    minlength: 2
   },
   password: {
    required: true,
    minlength: 5
   },
   confirm_password: {
    required: true,
    minlength: 5,
    equalTo: "#password"
   },
   email: {
    required: true,
    email: true
   },
   topic: {
    required: "#newsletter:checked",
    minlength: 2
   },
   agree: "required"
  },
  messages: {
   firstname: "Please enter your firstname",
   lastname: "Please enter your lastname",
   username: {
    required: "Please enter a username",
    minlength: "Your username must consist of at least 2 characters"
   },
   password: {
    required: "Please provide a password",
    minlength: "Your password must be at least 5 characters long"
   },
   confirm_password: {
    required: "Please provide a password",
    minlength: "Your password must be at least 5 characters long",
    equalTo: "Please enter the same password as above"
   },
   email: "Please enter a valid email address",
   agree: "Please accept our policy"
  }
 });
 
 // propose username by combining first- and lastname
 $("#username").focus(function() {
  var firstname = $("#firstname").val();
  var lastname = $("#lastname").val();
  if(firstname && lastname && !this.value) {
   this.value = firstname + "." + lastname;
  }
 });
 
 //code to hide topic selection, disable for demo
 var newsletter = $("#newsletter");
 // newsletter topics are optional, hide at first
 var inital = newsletter.is(":checked");
 var topics = $("#newsletter_topics")[inital ? "removeClass" : "addClass"]("gray");
 var topicInputs = topics.find("input").attr("disabled", !inital);
 // show when newsletter is checked
 newsletter.click(function() {
  topics[this.checked ? "removeClass" : "addClass"]("gray");
  topicInputs.attr("disabled", !this.checked);
 });
});
</script>

<style type="text/css">
#commentForm { width: 500px; }
#commentForm label { width: 250px; }
#commentForm label.error, #commentForm input.submit { margin-left: 253px; }
#signupForm { width: 670px; }
#signupForm label.error {
 margin-left: 10px;
 width: auto;
 display: inline;
}
#newsletter_topics label.error {
 display: none;
 margin-left: 103px;
}
</style>

</head>
<body>

<h1 id="banner"><a href="http://bassistance.de/jquery-plugins/jquery-plugin-validation/">jQuery Validation Plugin</a> Demo</h1>
<div id="main">

<p>Default submitHandler is set to display an alert into of submitting the form</p>

<form class="cmxform" id="commentForm" method="get" action="">
 <fieldset>
  <legend>Please provide your name, email address (won't be published) and a comment</legend>
  <p>
   <label for="cname">Name (required, at least 2 characters)</label>
   <input id="cname" name="name" class="required" minlength="2" />
  <p>
   <label for="cemail">E-Mail (required)</label>
   <input id="cemail" name="email" class="required email" />
  </p>
  <p>
   <label for="curl">URL (optional)</label>
   <input id="curl" name="url" class="url" value="" />
  </p>
  <p>
   <label for="ccomment">Your comment (required)</label>
   <textarea id="ccomment" name="comment" class="required"></textarea>
  </p>
  <p>
   <input class="submit" type="submit" value="Submit"/>
  </p>
 </fieldset>
</form>

<form class="cmxform" id="signupForm" method="get" action="">
 <fieldset>
  <legend>Validating a complete form</legend>
  <p>
   <label for="firstname">Firstname</label>
   <input id="firstname" name="firstname" />
  </p>
  <p>
   <label for="lastname">Lastname</label>
   <input id="lastname" name="lastname" />
  </p>
  <p>
   <label for="username">Username</label>
   <input id="username" name="username" />
  </p>
  <p>
   <label for="password">Password</label>
   <input id="password" name="password" type="password" />
  </p>
  <p>
   <label for="confirm_password">Confirm password</label>
   <input id="confirm_password" name="confirm_password" type="password" />
  </p>
  <p>
   <label for="email">Email</label>
   <input id="email" name="email" />
  </p>
  <p>
   <label for="agree">Please agree to our policy</label>
   <input type="checkbox" class="checkbox" id="agree" name="agree" />
  </p>
  <p>
   <label for="newsletter">I'd like to receive the newsletter</label>
   <input type="checkbox" class="checkbox" id="newsletter" name="newsletter" />
  </p>
  <fieldset id="newsletter_topics">
   <legend>Topics (select at least two) - note: would be hidden when newsletter isn't selected, but is visible here for the demo</legend>
   <label for="topic_marketflash">
    <input type="checkbox" id="topic_marketflash" value="marketflash" name="topic" />
    Marketflash
   </label>
   <label for="topic_fuzz">
    <input type="checkbox" id="topic_fuzz" value="fuzz" name="topic" />
    Latest fuzz
   </label>
   <label for="topic_digester">
    <input type="checkbox" id="topic_digester" value="digester" name="topic" />
    Mailing list digester
   </label>
   <label for="topic" class="error">Please select at least two topics you'd like to receive.</label>
  </fieldset>
  <p>
   <input class="submit" type="submit" value="Submit"/>
  </p>
 </fieldset>
</form>

<h3>Syntetic examples</h3>
<ul>
 <li><a href="errorcontainer-demo.html">Error message containers in action</a></li>
 <li><a href="custom-messages-metadata-demo.html">Custom Messages as Metadata</a></li>
 <li><a href="radio-checkbox-select-demo.html">Radio and checkbox buttons and selects</a></li>
 <li><a href="ajaxSubmit-intergration-demo.html">Integration with Form Plugin (AJAX submit)</a></li>
 <li><a href="custom-methods-demo.html">Custom methods and message display.</a></li>
 <li><a href="dynamic-totals.html">Dynamic forms</a></li>
 <li><a href="themerollered.html">Forms styled with jQuery UI Themeroller</a></li>
</ul>
<h3>Real-world examples</h3>
<ul>
 <li><a href="milk/">Remember The Milk signup form</a></li>
 <li><a href="marketo/">Marketo signup form</a></li>
 <li><a href="multipart/">Buy and Sell a House multipart form</a></li>
 <li><a href="captcha/">Remote captcha validation</a></li>
</ul>

<h3>Testsuite</h3>
<ul>
 <li><a href="../test/">Validation Testsuite</a></li>
</ul> 

</div>

<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</script>
<script type="text/javascript">
_uacct = "UA-2623402-1";
urchinTracker();
</script>
</body>
</html>

posted @ 2010-03-31 15:27 别昨非 阅读(3484) | 评论 (3)编辑 收藏
 

Table
Table用来定义entity主表的name,catalog,schema等属性。
元数据属性说明:
· name: 表名
· catalog: 对应关系数据库中的catalog
· schema:对应关系数据库中的schema
· UniqueConstraints:定义一个UniqueConstraint数组,指定需要建唯一约束的列
        
@Entity
@Table(name="CUST")
public class Customer { ... }
  
SecondaryTable
一个entity class可以映射到多表,SecondaryTable用来定义单个从表的名字,主键名字等属性。
元数据属性说明:
· name: 表名
· catalog: 对应关系数据库中的catalog
· schema:对应关系数据库中的schema
· pkJoin: 定义一个PrimaryKeyJoinColumn数组,指定从表的主键列
· UniqueConstraints:定义一个UniqueConstraint数组,指定需要建唯一约束的列
下面的代码说明Customer类映射到两个表,主表名是CUSTOMER,从表名是CUST_DETAIL,从表的主键列和主表的主键列类型相同,列名为CUST_ID。
        
@Entity
@Table(name="CUSTOMER")
@SecondaryTable(name="CUST_DETAIL",pkJoin=@PrimaryKeyJoinColumn(name="CUST_ID"))
public class Customer { ... }

SecondaryTables
当一个entity class映射到一个主表和多个从表时,用SecondaryTables来定义各个从表的属性。
元数据属性说明:
· value: 定义一个SecondaryTable数组,指定每个从表的属性。
        
@Table(name = "CUSTOMER")
@SecondaryTables( value = {
@SecondaryTable(name = "CUST_NAME", pkJoin = { @PrimaryKeyJoinColumn(name = "STMO_ID", referencedColumnName = "id") }),
@SecondaryTable(name = "CUST_ADDRESS", pkJoin = { @PrimaryKeyJoinColumn(name = "STMO_ID", referencedColumnName = "id") }) })
public class Customer {}

UniqueConstraint
UniqueConstraint定义在Table或SecondaryTable元数据里,用来指定建表时需要建唯一约束的列。
元数据属性说明:
· columnNames:定义一个字符串数组,指定要建唯一约束的列名。
        
@Entity
@Table(name="EMPLOYEE",
uniqueConstraints={@UniqueConstraint(columnNames={"EMP_ID", "EMP_NAME"})}
)
public class Employee { ... }

Column
Column元数据定义了映射到数据库的列的所有属性:列名,是否唯一,是否允许为空,是否允许更新等。
元数据属性说明:
· name:列名。
· unique: 是否唯一
· nullable: 是否允许为空
· insertable: 是否允许插入
· updatable: 是否允许更新
· columnDefinition: 定义建表时创建此列的DDL
· secondaryTable: 从表名。如果此列不建在主表上(默认建在主表),该属性定义该列所在从表的名字。
        
public class Person {
@Column(name = "PERSONNAME", unique = true, nullable = false, updatable = true)
private String name;
@Column(name = "PHOTO", columnDefinition = "BLOB NOT NULL", secondaryTable="PER_PHOTO")
private byte[] picture;

JoinColumn
如果在entity class的field上定义了关系(one2one或one2many等),我们通过JoinColumn来定义关系的属性。JoinColumn的大部分属性和Column类似。
元数据属性说明:
· name:列名。
· referencedColumnName:该列指向列的列名(建表时该列作为外键列指向关系另一端的指定列)
· unique: 是否唯一
· nullable: 是否允许为空
· insertable: 是否允许插入
· updatable: 是否允许更新
· columnDefinition: 定义建表时创建此列的DDL
· secondaryTable: 从表名。如果此列不建在主表上(默认建在主表),该属性定义该列所在从表的名字。
下面的代码说明Custom和Order是一对一关系。在Order对应的映射表建一个名为CUST_ID的列,该列作为外键指向Custom对应表中名为ID的列。
        
public class Custom {
@OneToOne
@JoinColumn(
name="CUST_ID", referencedColumnName="ID", unique=true, nullable=true, updatable=true)
public Order getOrder() {
return order;
}

JoinColumns
如果在entity class的field上定义了关系(one2one或one2many等),并且关系存在多个JoinColumn,用JoinColumns定义多个JoinColumn的属性。
元数据属性说明:
· value: 定义JoinColumn数组,指定每个JoinColumn的属性。
下面的代码说明Custom和Order是一对一关系。在Order对应的映射表建两列,一列名为CUST_ID,该列作为外键指向Custom对应表中名为ID的列,另一列名为CUST_NAME,该列作为外键指向Custom对应表中名为NAME的列。
        
public class Custom {
@OneToOne
@JoinColumns({
@JoinColumn(name="CUST_ID", referencedColumnName="ID"),
@JoinColumn(name="CUST_NAME", referencedColumnName="NAME")
})
public Order getOrder() {
return order;
}

Id
声明当前field为映射表中的主键列。id值的获取方式有五种:TABLE, SEQUENCE, IDENTITY, AUTO, NONE。Oracle和DB2支持SEQUENCE,SQL Server和Sybase支持IDENTITY,mysql支持AUTO。所有的数据库都可以指定为AUTO,我们会根据不同数据库做转换。NONE (默认)需要用户自己指定Id的值。元数据属性说明:
· generate():主键值的获取类型
· generator():TableGenerator的名字(当generate=GeneratorType.TABLE才需要指定该属性)
下面的代码声明Task的主键列id是自动增长的。(Oracle和DB2从默认的SEQUENCE取值,SQL Server和Sybase该列建成IDENTITY,mysql该列建成auto increment。)
        
@Entity
@Table(name = "OTASK")
public class Task {
@Id(generate = GeneratorType.AUTO)
public Integer getId() {
return id;
}
}

IdClass
当entity class使用复合主键时,需要定义一个类作为id class。id class必须符合以下要求:类必须声明为public,并提供一个声明为public的空构造函数。必须实现Serializable接,覆写 equals()和hashCode()方法。entity class的所有id field在id class都要定义,且类型一样。
元数据属性说明:
· value: id class的类名
   public class EmployeePK implements Java.io.Serializable{
       String empName;
       Integer empAge;

       public EmployeePK(){}
       public boolean equals(Object obj){ ......}
       public int hashCode(){......}
    }

    @IdClass(value=com.acme.EmployeePK.class)
    @Entity(access=FIELD)
    public class Employee {
        @Id String empName;
        @Id Integer empAge;
    }
    
     
MapKey
在一对多,多对多关系中,我们可以用Map来保存集合对象。默认用主键值做key,如果使用复合主键,则用id class的实例做key,如果指定了name属性,就用指定的field的值做key。
元数据属性说明:
· name: 用来做key的field名字
下面的代码说明Person和Book之间是一对多关系。Person的books字段是Map类型,用Book的isbn字段的值作为Map的key。
        

@Table(name = "PERSON")
public class Person {
@OneToMany(targetEntity = Book.class, cascade = CascadeType.ALL, mappedBy = "person")
@MapKey(name = "isbn")
private Map books = new HashMap();
}


OrderBy
在一对多,多对多关系中,有时我们希望从数据库加载出来的集合对象是按一定方式排序的,这可以通过OrderBy来实现,默认是按对象的主键升序排列。
元数据属性说明:
· value: 字符串类型,指定排序方式。格式为"fieldName1 [ASC|DESC],fieldName2 [ASC|DESC],......",排序类型可以不指定,默认是ASC。
下面的代码说明Person和Book之间是一对多关系。集合books按照Book的isbn升序,name降序排列。
        

@Table(name = "MAPKEY_PERSON")
public class Person {
@OneToMany(targetEntity = Book.class, cascade = CascadeType.ALL, mappedBy = "person")
@OrderBy(name = "isbn ASC, name DESC")
private List books = new ArrayList();
}


PrimaryKeyJoinColumn
在三种情况下会用到PrimaryKeyJoinColumn。
· 继承。
· entity class映射到一个或多个从表。从表根据主表的主键列(列名为referencedColumnName值的列),建立一个类型一样的主键列,列名由name属性定义。
· one2one关系,关系维护端的主键作为外键指向关系被维护端的主键,不再新建一个外键列。
元数据属性说明:
· name:列名。
· referencedColumnName:该列引用列的列名
· columnDefinition: 定义建表时创建此列的DDL
下面的代码说明Customer映射到两个表,主表CUSTOMER,从表CUST_DETAIL,从表需要建立主键列CUST_ID,该列和主表的主键列id除了列名不同,其他定义一样。
          @Entity
@Table(name="CUSTOMER")
@SecondaryTable(name="CUST_DETAIL",pkJoin=@PrimaryKeyJoinColumn(name="CUST_ID",referencedColumnName="id"))
public class Customer {
@Id(generate = GeneratorType.AUTO)
public Integer getId() {
return id;
}
}

下面的代码说明Employee和EmployeeInfo是一对一关系,Employee的主键列id作为外键指向EmployeeInfo的主键列INFO_ID。
        
@Table(name = "Employee")
public class Employee {
@OneToOne
@PrimaryKeyJoinColumn(name = "id", referencedColumnName="INFO_ID")
EmployeeInfo info;
}

PrimaryKeyJoinColumns
如果entity class使用了复合主键,指定单个PrimaryKeyJoinColumn不能满足要求时,可以用PrimaryKeyJoinColumns来定义多个PrimaryKeyJoinColumn。
元数据属性说明:
· value: 一个PrimaryKeyJoinColumn数组,包含所有PrimaryKeyJoinColumn。
下面的代码说明了Employee和EmployeeInfo是一对一关系。他们都使用复合主键,建表时需要在Employee表建立一个外键,从Employee的主键列id,name指向EmployeeInfo的主键列INFO_ID和INFO_NAME.
        
@Entity
@IdClass(EmpPK.class)
@Table(name = "EMPLOYEE")
public class Employee {
private int id;
private String name;
private String address;
@OneToOne(cascade = CascadeType.ALL)
@PrimaryKeyJoinColumns({
@PrimaryKeyJoinColumn(name="id", referencedColumnName="INFO_ID"),
@PrimaryKeyJoinColumn(name="name" , referencedColumnName="INFO_NAME")})
EmployeeInfo info;
}
@Entity
@IdClass(EmpPK.class)
@Table(name = "EMPLOYEE_INFO")
public class EmployeeInfo {
@Id
@Column(name = "INFO_ID")
private int id;
@Id
@Column(name = "INFO_NAME")
private String name;
}

Transient
Transient用来注释entity的属性,指定的这些属性不会被持久化,也不会为这些属性建表。
        
@Transient
private String name;

Version
Version指定实体类在乐观事务中的version属性。在实体类重新由EntityManager管理并且加入到乐观事务中时,保证完整性。每一个类只能有一个属性被指定为version,version属性应该映射到实体类的主表上。
下面的代码说明versionNum属性作为这个类的version,映射到数据库中主表的列名是OPTLOCK。
        
@Version
@Column("OPTLOCK")
protected int getVersionNum() { return versionNum; }

Lob
Lob指定一个属性作为数据库支持的大对象类型在数据库中存储。使用LobType这个枚举来定义Lob是二进制类型还是字符类型。
LobType枚举类型说明:
· BLOB 二进制大对象,Byte[]或者Serializable的类型可以指定为BLOB。
· CLOB 字符型大对象,char[]、Character[]或String类型可以指定为CLOB。
元数据属性说明:
· fetch: 定义这个字段是lazy loaded还是eagerly fetched。数据类型是FetchType枚举,默认为LAZY,即lazy loaded.
· type: 定义这个字段在数据库中的JDBC数据类型。数据类型是LobType枚举,默认为BLOB。
下面的代码定义了一个BLOB类型的属性和一个CLOB类型的属性。
        
@Lob
@Column(name="PHOTO" columnDefinition="BLOB NOT NULL")
protected JPEGImage picture;
@Lob(fetch=EAGER, type=CLOB)
@Column(name="REPORT")
protected String report;

JoinTable
JoinTable在many-to-many关系的所有者一边定义。如果没有定义JoinTable,使用JoinTable的默认值。
元数据属性说明:
· table:这个join table的Table定义。
· joinColumns:定义指向所有者主表的外键列,数据类型是JoinColumn数组。
· inverseJoinColumns:定义指向非所有者主表的外键列,数据类型是JoinColumn数组。
下面的代码定义了一个连接表CUST和PHONE的join table。join table的表名是CUST_PHONE,包含两个外键,一个外键是CUST_ID,指向表CUST的主键ID,另一个外键是PHONE_ID,指向表PHONE的主键ID。
        
@JoinTable(
table=@Table(name=CUST_PHONE),
joinColumns=@JoinColumn(name="CUST_ID", referencedColumnName="ID"),
inverseJoinColumns=@JoinColumn(name="PHONE_ID", referencedColumnName="ID")
)

TableGenerator
TableGenerator定义一个主键值生成器,在Id这个元数据的generate=TABLE时,generator属性中可以使用生成器的名字。生成器可以在类、方法或者属性上定义。
生成器是为多个实体类提供连续的ID值的表,每一行为一个类提供ID值,ID值通常是整数。
元数据属性说明:
· name:生成器的唯一名字,可以被Id元数据使用。
· table:生成器用来存储id值的Table定义。
· pkColumnName:生成器表的主键名称。
· valueColumnName:生成器表的ID值的列名称。
· pkColumnValue:生成器表中的一行数据的主键值。
· initialValue:id值的初始值。
· allocationSize:id值的增量。
下面的代码定义了两个生成器empGen和addressGen,生成器的表是ID_GEN。
        
@Entity public class Employee {
...
@TableGenerator(name="empGen",
table=@Table(name="ID_GEN"),
pkColumnName="GEN_KEY",
valueColumnName="GEN_VALUE",
pkColumnValue="EMP_ID",
allocationSize=1)
@Id(generate=TABLE, generator="empGen")
public int id;
...
}
@Entity public class Address {
...
@TableGenerator(name="addressGen",
table=@Table(name="ID_GEN"),
pkColumnValue="ADDR_ID")
@Id(generate=TABLE, generator="addressGen")
public int id;
...
}

SequenceGenerator
SequenceGenerator定义一个主键值生成器,在Id这个元数据的generator属性中可以使用生成器的名字。生成器可以在类、方法或者属性上定义。生成器是数据库支持的sequence对象。
元数据属性说明:
· name:生成器的唯一名字,可以被Id元数据使用。
· sequenceName:数据库中,sequence对象的名称。如果不指定,会使用提供商指定的默认名称。
· initialValue:id值的初始值。
· allocationSize:id值的增量。
下面的代码定义了一个使用提供商默认名称的sequence生成器。
        
@SequenceGenerator(name="EMP_SEQ", allocationSize=25)

DiscriminatorColumn
DiscriminatorColumn定义在使用SINGLE_TABLE或JOINED继承策略的表中区别不继承层次的列。
元数据属性说明:
· name:column的名字。默认值为TYPE。
· columnDefinition:生成DDL的sql片断。
· length:String类型的column的长度,其他类型使用默认值10。
下面的代码定义了一个列名为DISC,长度为20的String类型的区别列。
        
@Entity
@Table(name="CUST")
@Inheritance(strategy=SINGLE_TABLE,
discriminatorType=STRING,
discriminatorValue="CUSTOMER")
@DiscriminatorColumn(name="DISC", length=20)
public class Customer { ... }

 

posted @ 2010-03-24 21:07 别昨非 阅读(277) | 评论 (0)编辑 收藏