SecondaryIndex
SecondaryIndex是一个实体类和一个次关键字
SecondaryIndex是线程安全的。
SecondaryIndex里存放的是封装好的由secondary key type(SK)和entity type(E)组装的map对象
如果想插入或删除一个实体必须通过PrimaryIndex,不能通过SecondaryIndex
1. @SecondaryKey被用来定义Secondary Key(次关键字)
如:
java 代码
- @Entity
- class Employee {
-
- @PrimaryKey
- long id;
-
- @SecondaryKey(relate=MANY_TO_ONE)
- String department;
-
- String name;
-
- private Employee() {}
- }
2。要想获得SecondaryIndex,必须要先获得PrimaryIndex. 可以通过EntityStore.getSecondaryIndex获得SecondaryIndex.
该方法有三个参数:PrimaryIndex,Secondary key的类型和secondary key的名字 。例如:
java 代码
- EntityStore store = new EntityStore(...);
-
- PrimaryIndex primaryIndex =
- store.getPrimaryIndex(Long.class, Employee.class);
-
- SecondaryIndex secondaryIndex =
- store.getSecondaryIndex(primaryIndex, String.class, "department");
注意:SecondaryIndex 有3个类型参数< SK,PK,E >
,即:< String,Long,Employee >,
但是PrimaryIndex则只有2个参数 < PK,E >
,即: < Long,Employee >
. . 这是因为SecondaryIndex有一个额外的mapping,这个map是从secondary key 定位到 primary key,然后再从primary key 定位到 实体(entity). 例如,有这样一个实体:
ID
Department
Name
1 |
Engineering |
Jane Smith |
PrimaryIndex maps 直接从id定位到实体,也就是说从 关键字1定位到"Jane Smith"实体。
SecondaryIndex map从department定位到id(在这里是从"Engineering"定位到主关键字key 1),然后使用PrimaryIndex的map,从primary key定位到实体。
因为额外的mapping,SecondaryIndex能够提供多于一个mapping.这主要的mapping是从secondary key (SK) 定位到entity(E).也就是从department key直接定位到Employee实体,SecondaryIndex它本身靠实现EntityIndex,来提供这样的mapping.
SecondaryIndex 的keysIndex方法提供from secondary key (SK) to primary key (PK)
subIndex(SK)提供from primary key (PK) to entity (E)。
3.one-to-one关系
one-to-one关系:the secondary key必须是唯一的,换句话说,没有2个实体有同意的secondary key值,如果存储时,已经有相同的key值存在了,会抛出DatabaseException异常。
例如:
java 代码
- @Entity
- class Employee {
-
- @PrimaryKey
- long id;
-
- @SecondaryKey(relate=ONE_TO_ONE)
- String ssn;
-
- String name;
-
- private Employee() {}
- }
-
- SecondaryIndex employeeBySsn =
- store.getSecondaryIndex(primaryIndex, String.class, "ssn");
因为Secondary key是唯一的。它很容易用secondary key去查找实体,如:
- Employee employee = employeeBySsn.get(mySsn);
4.many-to-one
SecondaryKey上设定many-to-one关系
例如:
java 代码
- @Entity
- class Employee {
-
- @PrimaryKey
- long id;
-
- @SecondaryKey(relate=MANY_TO_ONE)
- String department;
-
- String name;
-
- private Employee() {}
- }
-
- SecondaryIndex employeeByDepartment =
- store.getSecondaryIndex(primaryIndex, String.class, "department");
这种情况SecondaryKey不需要是唯一的。
使用subIndex可以很方面的获得属于某个departement的雇员
如:
- EntityIndex subIndex = employeeByDepartment.subIndex(myDept);
- EntityCursor<employee></employee> cursor = subIndex.entities();
- try {
- for (Employee entity : cursor) {
-
- }
- } finally {
- cursor.close();
- }
5。one-to-many
SecondaryKey上设定one-to-many关系
SecondaryKey必须是唯一的。如果存储时,已经有相同的secondarykey存在的话,会抛出DatabaseException 异常
如:
java 代码
- @Entity
- class Employee {
-
- @PrimaryKey
- long id;
-
- @SecondaryKey(relate=ONE_TO_MANY)
- Set<string></string> emailAddresses = new HashSet<string></string>;
-
- String name;
-
- private Employee() {}
- }
-
- SecondaryIndex employeeByEmail =
- store.getSecondaryIndex(primaryIndex, String.class, "emailAddresses");
因为Secondary key是唯一的。它很容易用secondary key去查找实体,如:
java 代码
- Employee employee = employeeByEmail.get(myEmailAddress);
SecondaryKey必须是一个array 或Collection类型。为了访问这个employee的addresses ,直接访问这个collection field.
如:
java 代码
- Employee employee = primaryIndex.get(1);
- employee.emailAddresses.add(myNewEmail);
- primaryIndex.putNoReturn(1, employee);
6.many-to-many
SencondaryKey上设定many-to-many
如:
java 代码
- @Entity
- class Employee {
-
- @PrimaryKey
- long id;
-
- @SecondaryKey(relate=MANY_TO_MANY)
- Set<string></string> organizations = new HashSet<string></string>;
-
- String name;
-
- private Employee() {}
- }
-
- SecondaryIndex employeeByOrganization =
- store.getSecondaryIndex(primaryIndex, String.class, "organizations");
SencondaryKey不需要是唯一的。
可以很方便的通过subIndex获得某个组织(organization)里的雇员(employees)
如:
java 代码
- EntityIndex subIndex = employeeByOrganization.subIndex(myOrg);
- EntityCursor<employee></employee> cursor = subIndex.entities();
- try {
- for (Employee entity : cursor) {
-
- }
- } finally {
- cursor.close();
- }
可以直接访问某个employee的organizations
如:
java 代码
- Employee employee = primaryIndex.get(1);
- employee.organizations.remove(myOldOrg);
- primaryIndex.putNoReturn(1, employee);
分享到:
相关推荐
官方版本,亲测可用
官方版本,亲测可用
标签:apollo-bdb-1.1-javadoc.jar,apollo,bdb,1.1,javadoc,jar包下载,依赖包
Berkeley DB(简称BDB)是Oracle公司开发的一款开源、轻量级、嵌入式数据库系统,广泛应用于需要快速数据存储和检索的应用场景。在18.1.40这个版本中,BDB继续提供了对高性能、低延迟数据管理的支持,尤其适合于内存...
"activemq-store-bdb-1.3.jar.zip"是一个包含"activemq-store-bdb-1.3.jar"和"license.txt"的压缩包。在部署时,我们需要解压这个zip文件,并将jar包添加到ActiveMQ的类路径中。同时,"license.txt"是软件许可协议,...
本篇文章将围绕"activemq-store-bdb-1.5.jar.zip"这个压缩包文件,深入探讨ActiveMQ中基于Berkeley DB(BDB)的存储机制以及其在实际应用中的重要性。 首先,"activemq-store-bdb-1.5.jar"是ActiveMQ的一个存储模块...
本文将重点讨论ActiveMQ的存储机制,特别是基于Berkeley DB(BDB)的存储解决方案——activemq-store-bdb-2.0.jar,以及其在实际应用中的作用。 一、ActiveMQ与BDB存储 ActiveMQ提供了多种存储策略,包括文件系统...
本篇将详细解析`activemq-store-bdb-1.4.jar`,探讨其核心功能和应用场景。 一、ActiveMQ与BDB存储 ActiveMQ的核心功能是接收、存储和转发消息。为了保证消息的可靠性和持久性,ActiveMQ提供了多种存储策略,其中...
而`activemq-store-bdb-2.1.jar`这个文件则是ActiveMQ使用Berkeley DB(简称BDB)作为存储引擎的一个组件。 Berkeley DB是由Oracle公司提供的一个嵌入式数据库系统,常用于需要高性能、高可用性和低延迟的数据存储...
标签:apollo-bdb-1.3.jar,apollo,bdb,1.3,jar包下载,依赖包
本文将详细探讨`activemq-store-bdb-1.2.jar`这个特定版本的组件,以及其在Java环境下的使用和重要性。 一、ActiveMQ 存储机制 ActiveMQ 支持多种存储机制,包括文件系统、JDBC、LevelDB 和 BDB。BDB,全称 ...
标签:apollo-bdb-1.3-javadoc.jar,apollo,bdb,1.3,javadoc,jar包下载,依赖包
标签:apollo-bdb-1.0-sources.jar,apollo,bdb,1.0,sources,jar包下载,依赖包
标签:apollo-bdb-1.3-sources.jar,apollo,bdb,1.3,sources,jar包下载,依赖包
标签:apollo-bdb-1.4-javadoc.jar,apollo,bdb,1.4,javadoc,jar包下载,依赖包
标签:apollo-bdb-1.1-sources.jar,apollo,bdb,1.1,sources,jar包下载,依赖包
标签:apollo-bdb-1.2-sources.jar,apollo,bdb,1.2,sources,jar包下载,依赖包
标签:apollo-bdb-1.5-sources.jar,apollo,bdb,1.5,sources,jar包下载,依赖包
标签:apollo-bdb-1.5-javadoc.jar,apollo,bdb,1.5,javadoc,jar包下载,依赖包
标签:apollo-bdb-1.7-sources.jar,apollo,bdb,1.7,sources,jar包下载,依赖包