BDB-JE的PrimaryIndex翻译

PrimaryIndex

PrimaryIndex是为了一个实体类和它的主关键字，PrimaryIndex是线程安全的。

PrimaryIndex里存放的是封装好的由key type(PK)和entity type(E)组装的map对象

1.  @Entity通常被用来定义一个实体类

     @PrimaryKey通常被用来定义一个主关键字

例如：

java 代码

1. @Entity  
2.  class Employee {   
3.   
4.      @PrimaryKey  
5.      long id;   
6.   
7.      String name;   
8.   
9.      Employee(long id, String name) {   
10.          this.id = id;   
11.          this.name = name;   
12.      }   
13.   
14.      private Employee() {} // For bindings   
15.  }  

2.通过EntityStore.getPrimaryIndex 可以获得的给定的实体类的PrimaryIndex 对象，该方法有2个参数：主关键字类型和实体类型

如：

java 代码

1. EntityStore store = new EntityStore(...);   
2.   
3.  PrimaryIndex primaryIndex =   
4.      store.getPrimaryIndex(Long.class, Employee.class);  

 注：这里主关键字是long基本数据类型，而getPrimayIndex里的第一个参数是Long.class.也就是说当一个基本数据类型被使用时，它对应的包装类型被用来作为getPrimaryIndex  的参数。

 

3.PrimaryIndex 提供一个基本的存储和访问实体的方法，PrimaryIndex 的put(E)的方法被用来做为插入一个实体或更新一个实体.  如果主关键字不存在就是insert，返回null，如果主关键存在就是update,并且返回更新前旧的实体对象。

如：

java 代码

1. Employee oldEntity;   
2.  oldEntity = primaryIndex.put(new Employee(1, "Jane Smith"));    // Inserts an entity   
3.  assert oldEntity == null;   
4.  oldEntity = primaryIndex.put(new Employee(2, "Joan Smith"));    // Inserts an entity   
5.  assert oldEntity == null;   
6.  oldEntity = primaryIndex.put(new Employee(2, "Joan M. Smith")); // Updates an entity   
7.  assert oldEntity != null;  

putNoReturn(E) 用法一样，唯一不同的是没有返回值

putNoOverwrite(E)  返回ture或false,当insert时会返回true,当被插入的实体已经存在就会返回false.并且不会执行update,也就是说不会执行任何action

如：

java 代码

1. boolean inserted;   
2.  inserted = primaryIndex.putNoOverwrite(new Employee(1, "Jane Smith"));    // Inserts an entity   
3.  assert inserted;   
4.  inserted = primaryIndex.putNoOverwrite(new Employee(2, "Joan Smith"));    // Inserts an entity   
5.  assert inserted;   
6.  inserted = primaryIndex.putNoOverwrite(new Employee(2, "Joan M. Smith")); // No action was taken!   
7.  assert !inserted;  

 

4.主关键字是唯一的，如果不想自己指定主关键的值，则可以通过PrimaryKey.sequence()来定义，主要的话，主关键字的值会自动按顺序分配一个整形值，从1开始。

如：

java 代码

1. @Entity  
2. class Employee {   
3.   
4.     @PrimaryKey(sequence="ID")   
5.     long id;   
6.   
7.     String name;   
8.   
9.     Employee(String name) {   
10.         this.name = name;   
11.     }   
12.   
13.     private Employee() {} // For bindings   
14. }  

Sequence被指定的名字为ID,这个名字可以随意。如果多个实体类的Sequence的名字相同的话，这个Sequence将被共享。

当insert时，实体类的主关键字的key将被分配一个Sequence 的一个Integer值，如：

java 代码

1. Employee employee;   
2.  employee = new Employee("Jane Smith");   
3.  primaryIndex.putNoReturn(employee);    // Inserts an entity   
4.  assert employee.id == 1;   
5.  employee = new Employee("Joan Smith");   
6.  primaryIndex.putNoReturn(employee);    // Inserts an entity   
7.  assert employee.id == 2;