jpa开发.txt

jpa开发

	}
	public void setUser1(Set<User1> users) {
		this.users = users;
	}
	}
   3) Dao
        /**
	 * 1. 项目下新建META-INF/persistence.xml
	 * 2. 启动derby
	 */
	public class User1DAO {
	private static final EntityManagerFactory emf; 
	private static EntityManager em;
	static {
		emf = Persistence.createEntityManagerFactory("aaa"); 
		if (em == null) 
			em = emf.createEntityManager();
	}
	public void queryByUser() {
		User1 user = em.find(User1.class, 1);
		System.out.println(user.getUserid()+"\t"+user.getDuties().size());
	}
	public static void main(String[] args) {
		User1DAO dao = new User1DAO();
		dao.queryByUser();
	}
	}


4. 查询
   ◆Query q= em.createQuery("SELECT t FROM Topic t"); 
   ◆Query q = createNativeQuery(String sqlString) 
   ◆Object getSingleResult()：执行SELECT查询语句，并返回一个结果； 
   ◆List getResultList() ：执行SELECT查询语句，并返回多个结果； 
   ◆Query setParameter(int position, Object value)：通过参数位置号绑定查询语句中的参数，如果查询语句使用了命令参数，则可以使用Query setParameter(String name, Object value)方法绑定命名参数； 
   ◆Query setMaxResults(int maxResult)：设置返回的最大结果数； 
   ◆int executeUpdate()：如果查询语句是新增、删除或更改的语句，通过该方法执行更新操作； 

5. 函数
   字符串操作函数有： 
	◆CONCAT(String, String)：合并字段串； 
	◆LENGTH(String)：求字段串的长度； 
	◆LOCATE(String, String [, start])：查询字段串的函数，第一个参数为需要查询的字段串，看它在出现在第二个参数字符串的哪个位置，start表示从哪个位置开始查找，返回查找到的位置，没有找到返回0。如LOCATE ('b1','a1b1c1',1)返回为3； 
	◆SUBSTRING(String, start, length)：子字段串函数； 
	◆TRIM([[LEADING|TRAILING|BOTH] char) FROM] (String)：将字段串前后的特殊字符去除，可以通过选择决定具体的去除位置和字符； 
	◆LOWER(String)：将字符串转为小写； 
	◆UPPER(String)：将字符串转为大写。 
   数字操作函数有： 
	◆ABS(number)：求绝对值函数； 
	◆MOD(int, int)：求模的函数； 
	◆SQRT(double)：求平方函数； 
	◆SIZE(Collection)：求集合大小函数。
   聚集函数COUNT()，其它几个可用的聚集函数分别为： 
	◆AVG：计算平均值，返回类型为double； 
	◆MAX：计算最大值； 
	◆MIN：计算最小值； 
	◆SUM：计算累加和； 



























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关系，关系维护端的主键作为外键指向关系被维护端的主键，不再新建一个外键列。