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


    private void configure(final File storeDirectory) throws InterruptedException {
        // todo: make config persistent? or just rely on je.properties (I guess so)
        PageStoreConfig config = new PageStoreConfig();
        EntityStoreBuilder builder = new EntityStoreBuilder(config);
        EntityStore entityStore = builder.buildEntityStore(storeDirectory, null);
        this.entityStore = entityStore;


        tileSetById = entityStore.getPrimaryIndex(String.class, TileSet.class);
        pageById = entityStore.getPrimaryIndex(Long.class, TilePage.class);
        pageStatsById = entityStore.getPrimaryIndex(Long.class, PageStats.class);
        usedQuotaById = entityStore.getPrimaryIndex(Integer.class, Quota.class);


        pageByKey = entityStore.getSecondaryIndex(pageById, String.class, "page_key");
        pagesByTileSetId = entityStore.getSecondaryIndex(pageById, String.class, "tileset_id_fk");
        tileSetsByLayer = entityStore.getSecondaryIndex(tileSetById, String.class, "layer");
        pageStatsByLRU = entityStore.getSecondaryIndex(pageStatsById, Float.class, "LRU");
        pageStatsByLFU = entityStore.getSecondaryIndex(pageStatsById, Float.class, "LFU");
        usedQuotaByTileSetId = entityStore.getSecondaryIndex(usedQuotaById, String.class,
                "tileset_id");
        pageStatsByPageId = entityStore.getSecondaryIndex(pageStatsById, Long.class,
                "page_stats_by_page_id");


    }

View Full Code Here

        String storeName = "GWC DiskQuota page store";
        StoreConfig config = new StoreConfig();
        config.setAllowCreate(true);
        config.setTransactional(true);
        // config.setDeferredWrite(true);
        EntityStore entityStore = new EntityStore(env, storeName, config);
        return entityStore;
    }

View Full Code Here

        env = new Environment(dataPath, envConfig); 


        StoreConfig storeConfig = new StoreConfig();
        storeConfig.setAllowCreate(true);
        storeConfig.setTransactional(true);
        projectStore = new EntityStore(env, "ProjectsStore", storeConfig);
        lockStore = new EntityStore(env, "LockStore", storeConfig);
        
        projectById = projectStore.getPrimaryIndex(String.class, Project.class);
        lockById = lockStore.getPrimaryIndex(String.class, Lock.class);
        
        locksByProject = lockStore.getSecondaryIndex(lockById, String.class, "pid");

View Full Code Here

            EnvironmentConfig envConfig = new EnvironmentConfig();
            StoreConfig storeConfig = new StoreConfig();


            // Open the environment and entity store
            envmnt = new Environment(envHome, envConfig);
            store = new EntityStore(envmnt, "EntityStore", storeConfig);
        } catch (FileNotFoundException fnfe) {
            System.err.println("setup(): " + fnfe.toString());
            System.exit(-1);
        }
    }

View Full Code Here

        storeConfig.setAllowCreate(true);


        try {
            // Open the environment and entity store
            envmnt = new Environment(envHome, envConfig);
            store = new EntityStore(envmnt, "EntityStore", storeConfig);
        } catch (FileNotFoundException fnfe) {
            System.err.println("setup(): " + fnfe.toString());
            System.exit(-1);
        }
    }

View Full Code Here

        config.setModel(model);
        caseObj.configure(model, config);


        String expectException = caseObj.getStoreOpenException();
        try {
            store = new EntityStore(env, EvolveCase.STORE_NAME, config);
            if (expectException != null) {
                fail("Expected: " + expectException);
            }
        } catch (Exception e) {
            if (expectException != null) {

View Full Code Here


        EntityModel model = new AnnotationModel();
        config.setModel(model);
        caseObj.configure(model, config);


        newStore = new EntityStore(env, "new", config);
    }

View Full Code Here


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


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


        pri1 = store.getPrimaryIndex(String.class, Entity1.class);
        sec1 = store.getSecondaryIndex(pri1, String.class, "sk");
        pri2 = store.getPrimaryIndex(String.class, Entity2.class);
        sec2 = store.getSecondaryIndex

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);
        sec1 = store.getSecondaryIndex(primary, Integer.class, "k1");
        sec2 = store.getSecondaryIndex(primary, Integer.class, "k2");
        sec3 = store.getSecondaryIndex(primary, Integer.class, "k3");

View Full Code Here


    private void open(StoreConfig config)
        throws DatabaseException {


        config.setTransactional(envConfig.getTransactional());
        store = new EntityStore(env, STORE_NAME, config);
    }

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