Examples of com.sleepycat.persist.EntityStore

com.sleepycat.persist.EntityStore
A store for managing persistent entity objects.
{@code EntityStore} objects are thread-safe. Multiple threads may safelycall the methods of a shared {@code EntityStore} object.
See the {@link package summary example} for an example of using an {@code EntityStore}.

Before creating an EntityStore you must create an {@link Environment} object using the Berkeley DB engine API. The environment maycontain any number of entity stores and their associated databases, as well as other databases not associated with an entity store.

An entity store is based on an {@link EntityModel}: a data model which defines persistent classes (entity classes), primary keys, secondary keys, and relationships between entities. A primary index is created for each entity class. An associated secondary index is created for each secondary key. The {@link Entity}, {@link PrimaryKey} and {@link SecondaryKey} annotations may be used to define entities and keys.
To use an EntityStore, first obtain {@link PrimaryIndex} and{@link SecondaryIndex} objects by calling {@link #getPrimaryIndex getPrimaryIndex} and {@link #getSecondaryIndex getSecondaryIndex}. Then use these indices to store and access entity records by key.

Although not normally needed, you can also use the entity store along with the {@link com.sleepycat.je Base API}. Methods in the {@link PrimaryIndex} and {@link SecondaryIndex} classes may be used to obtaindatabases and bindings. The databases may be used directly for accessing entity records. The bindings should be called explicitly to translate between {@link com.sleepycat.je.DatabaseEntry} objects and entity modelobjects.

Each primary and secondary index is associated internally with a {@link Database}. With any of the above mentioned use cases, methods are provided that may be used for database performance tuning. The {@link #setPrimaryConfig setPrimaryConfig} and {@link #setSecondaryConfig setSecondaryConfig} methods may be called anytime before a database isopened via {@link #getPrimaryIndex getPrimaryIndex} or {@link #getSecondaryIndex getSecondaryIndex}. The {@link #setSequenceConfig setSequenceConfig} method may be called anytime before {@link #getSequence getSequence} is called or {@link #getPrimaryIndex getPrimaryIndex} is calledfor a primary index associated with that sequence.

Database Names

The database names of primary and secondary indices are designed to be unique within the environment and identifiable for debugging and use with tools such as {@link com.sleepycat.je.util.DbDump} and {@link com.sleepycat.je.util.DbLoad}.

The syntax of a primary index database name is:
```
   persist#STORE_NAME#ENTITY_CLASS
```
Where STORE_NAME is the name parameter passed to {@link #EntityStore EntityStore} and ENTITY_CLASS is name of the class passed to {@link #getPrimaryIndex getPrimaryIndex}.

The syntax of a secondary index database name is:
```
   persist#STORE_NAME#ENTITY_CLASS#KEY_NAME
```
Where KEY_NAME is the secondary key name passed to {@link #getSecondaryIndex getSecondaryIndex}.

Although you should never have to construct these names manually, understanding their syntax is useful for several reasons:
- Exception messages sometimes contain the database name, from which you can identify the entity class and secondary key.
- If you create other databases in the same environment that are not part of an EntityStore, to avoid naming conflicts the other database names should not begin with "persist#".
- If you are using {@link com.sleepycat.je.util.DbDump} or {@link com.sleepycat.je.util.DbLoad} to perform a backup or copy databases betweenenvironments, knowing the database names can be useful. Normally you will dump or load all database names starting with "persist#STORE_NAME#".
If you are copying all databases in a store as mentioned in the last point above, there is one further consideration. There are two internal databases that must be kept with the other databases in the store in order for the store to be used. These contain the data formats and sequences for the store:
```
   persist#STORE_NAME#com.sleepycat.persist.formats
```
```
   persist#STORE_NAME#com.sleepycat.persist.sequences
```
These databases must normally be included with copies of other databases in the store. They should not be modified by the application.

For example, the following code snippet removes all databases for a given store in a single transaction.
```
 Environment env = ... EntityStore store = ... Transaction txn = env.beginTransaction(null, null); String prefix = "persist#" + store.getStoreName() + "#"; for (String dbName : env.getDatabaseNames()) { if (dbName.startsWith(prefix)) { env.removeDatabase(txn, dbName); } } txn.commit();
```
@author Mark Hayes


        /* Open a transactional entity store. */
        StoreConfig storeConfig = new StoreConfig();
        storeConfig.setAllowCreate(true);
        storeConfig.setTransactional(true);
        store = new EntityStore(env, "PersonStore", storeConfig);


        /* Initialize the data access object. */
        dao = new PersonAccessor(store);
    }

View Full Code Here

            // Open the environment
            myEnv = new Environment(new File(myEnvPath),    // Env home
                                    myEnvConfig);


            // Open the store
            myStore = new EntityStore(myEnv, storeName, myStoreConfig);


            // Set the DatabaseConfig object, so that the underlying
            // database is configured for uncommitted reads.
            myStore.setPrimaryConfig(PayloadDataEntity.class, myDbConfig);
        } catch (FileNotFoundException fnfe) {

View Full Code Here


        StoreConfig config = new StoreConfig();
        config.setAllowCreate(envConfig.getAllowCreate());
        config.setTransactional(envConfig.getTransactional());


        store = new EntityStore(env, "test", config);


        primary = store.getPrimaryIndex(Integer.class, MyEntity.class);
        oneToOne =
            store.getSecondaryIndex(primary, Integer.class, "oneToOne");
        manyToOne =

View Full Code Here


        /* Open a transactional entity store. */
        StoreConfig storeConfig = new StoreConfig();
        storeConfig.setAllowCreate(true);
        storeConfig.setTransactional(true);
        store = new EntityStore(env, "TestStore", storeConfig);
    }

View Full Code Here

        /* Open a transactional entity store. */
        System.out.println("-> Creating a BDB database");
        StoreConfig storeConfig = new StoreConfig();
        storeConfig.setAllowCreate(true);
        storeConfig.setTransactional(true);
        store = new EntityStore(env, "ExampleStore", storeConfig);


        eventByTime = store.getPrimaryIndex(Date.class, Event.class);
        eventByPrice = store.getSecondaryIndex(eventByTime,
                                               Integer.class,
                                               "price");

View Full Code Here

        envConfig.setAllowCreate(true);
        env = new Environment(envHome, envConfig);


        StoreConfig storeConfig = new StoreConfig();
        storeConfig.setAllowCreate(true);
        EntityStore store = new EntityStore(env, "foo", storeConfig);


        PrimaryIndex<String, Employee> employeesById =
            store.getPrimaryIndex(String.class, Employee.class);


        employeesById.put(new Employee("1"));
        employeesById.put(new Manager("2", "a"));
        employeesById.put(new Manager("3", "a"));
        employeesById.put(new Manager("4", "b"));


        Employee e;
        Manager m;


        e = employeesById.get("1");
        assertNotNull(e);
        assertTrue(!(e instanceof Manager));


        /* Ensure DB exists BEFORE calling getSubclassIndex. [#15247] */
        PersistTestUtils.assertDbExists
            (true, env, "foo", Employee.class.getName(), "dept");


        /* Normal use: Subclass index for a key in the subclass. */
        SecondaryIndex<String, String, Manager> managersByDept =
            store.getSubclassIndex
                (employeesById, Manager.class, String.class, "dept");


        m = managersByDept.get("a");
        assertNotNull(m);
        assertEquals("2", m.id);


        m = managersByDept.get("b");
        assertNotNull(m);
        assertEquals("4", m.id);


        EntityCursor<Manager> managers = managersByDept.entities();
        try {
            m = managers.next();
            assertNotNull(m);
            assertEquals("2", m.id);
            m = managers.next();
            assertNotNull(m);
            assertEquals("3", m.id);
            m = managers.next();
            assertNotNull(m);
            assertEquals("4", m.id);
            m = managers.next();
            assertNull(m);
        } finally {
            managers.close();
        }


        /* Getting a subclass index for the entity class is also allowed. */
        store.getSubclassIndex
            (employeesById, Employee.class, String.class, "other");


        /* Getting a subclass index for a base class key is not allowed. */
        try {
            store.getSubclassIndex
                (employeesById, Manager.class, String.class, "other");
            fail();
        } catch (IllegalArgumentException expected) {
        }


        store.close();
        env.close();
        env = null;
    }

View Full Code Here


        StoreConfig config = new StoreConfig();
        config.setAllowCreate(envConfig.getAllowCreate());
        config.setTransactional(envConfig.getTransactional());


        store = new EntityStore(env, "test", config);
    }

View Full Code Here

        envConfig.setAllowCreate(true);
        env = new Environment(envHome, envConfig);


        StoreConfig storeConfig = new StoreConfig();
        storeConfig.setAllowCreate(true);
        EntityStore store = new EntityStore(env, "foo", storeConfig);


        long seq = 0;


        for (int i = 0; i < classes.length; i += 1) {
            Class entityCls = classes[i];
            SequenceEntity entity = (SequenceEntity) entityCls.newInstance();
            Class keyCls = entity.getKeyClass();


            PrimaryIndex<Object,SequenceEntity> index =
                store.getPrimaryIndex(keyCls, entityCls);
            index.putNoReturn(entity);
            seq += 1;
            assertEquals(seq, entity.getKey());


            index.putNoReturn(entity);
            assertEquals(seq, entity.getKey());


            entity.nullifyKey();
            index.putNoReturn(entity);
            seq += 1;
            assertEquals(seq, entity.getKey());
        }


        store.close();
        env.close();
        env = null;
    }

View Full Code Here

      // Changes due to timing issues for Apache Felix OSGi
        // Should have better performance.
        ClassLoader originalClassloader = Thread.currentThread().getContextClassLoader();
        try {
            Thread.currentThread().setContextClassLoader(getClass().getClassLoader());
            return new EntityStore(dbufferEnv, META_DATABASE_NAME, storeConfig);
        } finally {
            Thread.currentThread().setContextClassLoader(originalClassloader);
        }
    }

View Full Code Here

        StoreConfig storeConfig = new StoreConfig();
        storeConfig.setAllowCreate(true);
        storeConfig.setDeferredWrite(true);
        storeConfig.setTransactional(false);


        EntityStore store = new EntityStore(dbufferEnv, dbName, storeConfig);
        openStores.add(store);
        return store;
    }

View Full Code Here

0 1 2

TOP

Related Classes of com.sleepycat.persist.EntityStore

com.google.refine.broker.RefineBrokerImpl

com.googlecode.flaxcrawler.concurrent.BerkleyQueue

com.googlecode.flaxcrawler.frontier.DefaultStatisticsService

com.sleepycat.persist.impl.Store

com.sleepycat.persist.test.EvolveTestBase

com.sleepycat.persist.test.ForeignKeyTest

com.sleepycat.persist.test.IndexTest

com.sleepycat.persist.test.JoinTest

com.sleepycat.persist.test.NegativeTest

com.sleepycat.persist.test.OperationTest

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

Examples of com.sleepycat.persist.EntityStore

Database Names

Related Classes of com.sleepycat.persist.EntityStore