`
ttitfly
  • 浏览: 616182 次
  • 性别: Icon_minigender_1
  • 来自: 杭州
社区版块
存档分类
最新评论

BDB-JE的PrimaryIndex翻译

bdb-je翻译 
阅读更多

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;  

 

 

分享到：
| 利用memcached java client一个简单的应用
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

Magicbox
Global site tag (gtag.js) - Google Analytics