de.caluga.morphium

Class Morphium

java.lang.Object

de.caluga.morphium.Morphium

public class Morphium
extends Object

This is the single access point for accessing MongoDB. This should

Author:

stephan

Constructor Summary

Constructors

Constructor and Description
Morphium()
Morphium(MorphiumConfig cfg) init the MongoDbLayer.

Method Summary

Methods

Modifier and Type	Method and Description
void	addListener(MorphiumStorageListener lst)
void	addProfilingListener(ProfilingListener l)
void	addShutdownListener(ShutdownListener l)
<T,R> List<R>	aggregate(Aggregator<T,R> a)
void	clearCachefor(Class<?> cls) Erase cache entries for the given type. is being called after every store depending on cache settings!
void	clearCollection(Class<?> cls) issues a remove command - no lifecycle methods calles, no drop, keeps all indexec this way
void	clearCollection(Class<?> cls, String colName) issues a remove command - no lifecycle methods calles, no drop, keeps all indexec this way But uses sepcified collection name instead deriving name from class
void	clearCollectionOneByOne(Class<?> cls) clears every single object in collection - reads ALL objects to do so this way Lifecycle methods can be called!
void	close()
<T> void	convertToCapped(Class<T> c, int size, AsyncOperationCallback<T> cb) converts the given type to capped collection in Mongo, even if no @capped is defined!
<T> void	convertToCapped(String coll, int size, AsyncOperationCallback<T> cb)
<T,R> Aggregator<T,R>	createAggregator(Class<? extends T> type, Class<? extends R> resultType)
String	createCamelCase(String n)
List<Map<String,Object>>	createIndexMapFrom(String[] fldStr)
<T> T	createLazyLoadedEntity(Class<? extends T> cls, Object id)
<T> MongoField<T>	createMongoField()
<T> T	createPartiallyUpdateableEntity(T o) create a proxy object, implementing the ParitallyUpdateable Interface these objects will be updated in mongo by only changing altered fields Attention: the field name if determined by the setter name for now.
<T> Query<T>	createQueryFor(Class<? extends T> type)
void	dec(Object toDec, String field, double amount) decreasing a value of a given object calles inc(toDec,field,-amount);
void	dec(Query<?> query, Enum field, double amount)
void	dec(Query<?> query, Enum field, double amount, boolean insertIfNotExist, boolean multiple)
void	dec(Query<?> query, String field, double amount)
void	dec(Query<?> query, String field, double amount, boolean insertIfNotExist, boolean multiple)
<T> void	delete(List<T> lst, AsyncOperationCallback<T> callback)
void	delete(Object o) deletes a single object from morphium backend.
void	delete(Object o, String collection)
<T> void	delete(Query<T> o)
<T> void	delete(Query<T> o, AsyncOperationCallback<T> callback)
<T> void	delete(T lo, AsyncOperationCallback<T> callback)
<T> void	delete(T lo, String collection, AsyncOperationCallback<T> callback)
<T> T	deReference(T obj) de-references the given object of type T.
void	disableAsyncWritesForThread()
void	disableAutoValuesForThread()
void	disableReadCacheForThread()
void	disableWriteBufferForThread()
List<Object>	distinct(Enum key, Class c)
List<Object>	distinct(Enum key, Query q) returns a distinct list of values of the given collection Attention: these values are not unmarshalled, you might get MongoDBObjects
List<Object>	distinct(String key, Class cls)
List<Object>	distinct(String key, Query q) returns a distinct list of values of the given collection Attention: these values are not unmarshalled, you might get MongoDBObjects
void	dropCollection(Class<?> cls)
<T> void	dropCollection(Class<T> cls, AsyncOperationCallback<T> callback)
<T> void	dropCollection(Class<T> cls, String collection, AsyncOperationCallback<T> callback)
void	enableAsyncWritesForThread()
void	enableAutoValuesForThread()
void	enableReadCacheForThread()
void	enableWriteBufferForThread()
<T> void	ensureCapped(Class<T> c) automatically convert the collection for the given type to a capped collection only works if @Capped annotation is given for type
<T> void	ensureCapped(Class<T> c, AsyncOperationCallback<T> callback)
void	ensureIndex(Class<?> cls, Enum... fldStr)
void	ensureIndex(Class<?> cls, Map<String,Object> index)
void	ensureIndex(Class<?> cls, String... fldStr)
void	ensureIndex(Class<?> cls, String collection, Map<String,Object> index)
void	ensureIndex(Class<?> cls, String collection, Map<String,Object> index, Map<String,Object> options)
<T> void	ensureIndex(Class<T> cls, AsyncOperationCallback<T> callback, Enum... fldStr) ensureIndex(CachedObject.class,"counter","-value"); ensureIndex(CachedObject.class,"counter:2d","-value); Similar to sorting
<T> void	ensureIndex(Class<T> cls, AsyncOperationCallback<T> callback, String... fldStr)
<T> void	ensureIndex(Class<T> cls, Map<String,Object> index, AsyncOperationCallback<T> callback)
<T> void	ensureIndex(Class<T> cls, String collection, AsyncOperationCallback<T> callback, Enum... fldStr)
<T> void	ensureIndex(Class<T> cls, String collection, AsyncOperationCallback<T> callback, String... fldStr)
<T> void	ensureIndex(Class<T> cls, String collection, Map<String,Object> index, AsyncOperationCallback<T> callback)
<T> void	ensureIndex(Class<T> cls, String collection, Map<String,Object> index, Map<String,Object> options, AsyncOperationCallback<T> callback)
<T> void	ensureIndicesFor(Class<T> type) can be called for autmatic index ensurance.
<T> void	ensureIndicesFor(Class<T> type, AsyncOperationCallback<T> callback)
<T> void	ensureIndicesFor(Class<T> type, String onCollection)
<T> void	ensureIndicesFor(Class<T> type, String onCollection, AsyncOperationCallback<T> callback)
<T> List<T>	find(Query<T> q)
<T> List<T>	findByField(Class<? extends T> cls, Enum fld, Object val)
<T> List<T>	findByField(Class<? extends T> cls, String fld, Object val)
<T> T	findById(Class<? extends T> type, Object id)
<T> List<T>	findByTemplate(T template, String... fields) search for objects similar to template concerning all given fields.
void	firePostDropEvent(Class cls)
<T> void	firePostLoad(List<T> loaded)
void	firePostLoadEvent(Object o) will be called by query after unmarshalling
<T> void	firePostRemove(List<T> toRemove)
void	firePostRemoveEvent(Object o)
void	firePostRemoveEvent(Query q)
<T> void	firePostStore(Map<T,Boolean> isNew)
void	firePostStoreEvent(Object o, boolean isNew)
void	firePostUpdateEvent(Class cls, MorphiumStorageListener.UpdateTypes t)
void	firePreDropEvent(Class cls)
<T> void	firePreRemove(List<T> lst)
void	firePreRemove(Object o)
void	firePreRemoveEvent(Query q)
void	firePreStoreEvent(Map<Object,Boolean> isNew)
void	firePreStoreEvent(Object o, boolean isNew)
void	firePreUpdateEvent(Class cls, MorphiumStorageListener.UpdateTypes t)
void	fireProfilingReadEvent(Query q, long time, ReadAccessType t)
void	fireProfilingWriteEvent(Class type, Object data, long time, boolean isNew, WriteAccessType wt)
void	flush()
AnnotationAndReflectionHelper	getARHelper()
int	getAsyncWriterBufferCount()
int	getBufferedWriterBufferCount()
MorphiumCache	getCache()
MorphiumConfig	getConfig()
ReplicaSetStatus	getCurrentRSState()
com.mongodb.DB	getDatabase()
Object	getId(Object o)
ObjectMapper	getMapper()
Integer	getMaxBsonSize()
Integer	getMaxMessageSize()
Integer	getMaxWriteBatchSize()
com.mongodb.Mongo	getMongo()
Map<String,Double>	getStatistics()
Map<StatisticKeys,StatisticValue>	getStats()
int	getWriteBufferCount()
com.mongodb.WriteConcern	getWriteConcernForClass(Class<?> cls)
int	getWriterBufferCount()
MorphiumWriter	getWriterForClass(Class<?> cls)
com.mongodb.DBObject	group(Query q, Map<String,Object> initial, String jsReduce, String jsFinalize, String... keys)
void	handleNetworkError(int i, Throwable e)
void	inc(Object toSet, String field, double i)
void	inc(Query<?> query, Enum field, double amount)
void	inc(Query<?> query, Enum field, double amount, boolean insertIfNotExist, boolean multiple)
void	inc(Query<?> query, String field, double amount)
void	inc(Query<?> query, String name, double amount, boolean insertIfNotExist, boolean multiple)
<T> void	inc(Query<T> query, Map<String,Double> toUptad, boolean insertIfNotExist, boolean multiple, AsyncOperationCallback<T> callback)
<T> void	inc(Query<T> query, String name, double amount, boolean insertIfNotExist, boolean multiple, AsyncOperationCallback<T> callback)
void	inc(StatisticKeys k)
<T> void	inc(T toSet, String field, double i, AsyncOperationCallback<T> callback)
<T> void	inc(T toSet, String collection, String field, double i, AsyncOperationCallback<T> callback)
boolean	isAsyncWritesEnabledForThread()
boolean	isAutoValuesEnabledForThread()
boolean	isReadCacheEnabledForThread()
boolean	isReplicaSet()
boolean	isWriteBufferEnabledForThread()
void	pull(Query<?> query, Enum field, Object value)
void	pull(Query<?> query, Enum field, Object value, boolean insertIfNotExist, boolean multiple)
void	pull(Query<?> query, String field, Object value)
<T> void	pull(Query<T> query, String field, Object value, boolean insertIfNotExist, boolean multiple)
<T> void	pull(Query<T> query, String field, Object value, boolean insertIfNotExist, boolean multiple, AsyncOperationCallback<T> callback) Asynchronous call to pulll
void	pullAll(Query<?> query, Enum field, List<Object> value, boolean insertIfNotExist, boolean multiple)
void	pullAll(Query<?> query, String field, List<Object> value, boolean insertIfNotExist, boolean multiple)
<T> void	pullAll(Query<T> query, String field, List<?> value, boolean insertIfNotExist, boolean multiple, AsyncOperationCallback<T> callback)
void	push(Query<?> query, Enum field, Object value)
void	push(Query<?> query, Enum field, Object value, boolean insertIfNotExist, boolean multiple)
void	push(Query<?> query, String field, Object value)
<T> void	push(Query<T> query, String field, Object value, boolean insertIfNotExist, boolean multiple)
<T> void	push(Query<T> query, String field, Object value, boolean insertIfNotExist, boolean multiple, AsyncOperationCallback<T> callback) asynchronous call to callback
void	pushAll(Query<?> query, Enum field, List<Object> value, boolean insertIfNotExist, boolean multiple)
void	pushAll(Query<?> query, String field, List<?> value, boolean insertIfNotExist, boolean multiple)
<T> void	pushAll(Query<T> query, String field, List<?> value, boolean insertIfNotExist, boolean multiple, AsyncOperationCallback<T> callback)
<T> void	pushPull(boolean push, Query<T> query, String field, Object value, boolean insertIfNotExist, boolean multiple, AsyncOperationCallback<T> callback)
<T> void	pushPullAll(boolean push, Query<T> query, String field, List<?> value, boolean insertIfNotExist, boolean multiple, AsyncOperationCallback<T> callback)
<T> List<T>	readAll(Class<? extends T> cls) return a list of all elements stored in morphium for this type
void	readMaximums()
void	removeListener(MorphiumStorageListener lst)
void	removeProfilingListener(ProfilingListener l)
void	removeShutdownListener(ShutdownListener l)
<T> T	reread(T o) careful this actually changes the parameter o!
<T> T	reread(T o, String collection)
void	resetStatistics()
void	set(Object toSet, Enum field, Object value)
void	set(Object toSet, String field, Object value) setting a value in an existing mongo collection entry - no reading necessary.
void	set(Query<?> query, Map<String,Object> map, boolean insertIfNotExist, boolean multiple)
<T> void	set(Query<T> query, Enum field, Object val)
<T> void	set(Query<T> query, Enum field, Object val, AsyncOperationCallback<T> callback)
<T> void	set(Query<T> query, Map<String,Object> map, boolean insertIfNotExist, boolean multiple, AsyncOperationCallback<T> callback)
<T> void	set(Query<T> query, String field, Object val)
<T> void	set(Query<T> query, String field, Object val, AsyncOperationCallback<T> callback)
<T> void	set(Query<T> query, String field, Object val, boolean insertIfNotExist, boolean multiple) will change an entry in mongodb-collection corresponding to given class object if query is too complex, upsert might not work!
<T> void	set(Query<T> query, String field, Object val, boolean insertIfNotExist, boolean multiple, AsyncOperationCallback<T> callback)
<T> void	set(T toSet, Enum field, Object value, AsyncOperationCallback<T> callback)
<T> void	set(T toSet, String field, Object value, AsyncOperationCallback<T> callback)
<T> void	set(T toSet, String field, Object value, boolean insertIfNotExists, boolean multiple, AsyncOperationCallback<T> callback)
<T> void	set(T toSet, String collection, String field, Object value, boolean insertIfNotExists, boolean multiple, AsyncOperationCallback<T> callback)
void	setConfig(MorphiumConfig cfg)
void	setEnum(Query<?> query, Map<Enum,Object> values, boolean insertIfNotExist, boolean multiple)
com.mongodb.DBObject	simplifyQueryObject(com.mongodb.DBObject q)
<T> void	store(List<T> lst, AsyncOperationCallback<T> callback)
<T> void	store(List<T> lst, String collectionName, AsyncOperationCallback<T> callback)
<T> void	store(T o) Stores a single Object.
<T> void	store(T o, AsyncOperationCallback<T> callback)
<T> void	store(T o, String collection, AsyncOperationCallback<T> callback)
<T> void	storeBuffered(T lst)
<T> void	storeBuffered(T lst, AsyncOperationCallback<T> callback)
<T> void	storeBuffered(T lst, String collection, AsyncOperationCallback<T> callback)
<T> void	storeList(List<T> lst) sorts elements in this list, whether to store in background or directly.
<T> void	storeList(List<T> lst, AsyncOperationCallback<T> callback)
<T> void	storeList(List<T> lst, String collection) stores all elements of this list to the given collection
<T> void	storeList(List<T> lst, String collection, AsyncOperationCallback<T> callback)
<T> void	storeNoCache(T lst)
<T> void	storeNoCache(T o, AsyncOperationCallback<T> callback)
<T> void	storeNoCache(T o, String collection)
<T> void	storeNoCache(T o, String collection, AsyncOperationCallback<T> callback)
String	toJsonString(Object o)
<T> void	unset(T toSet, Enum field)
<T> void	unset(T toSet, String field)
<T> void	unset(T toSet, String field, AsyncOperationCallback<T> callback)
<T> void	unset(T toSet, String collection, String field, AsyncOperationCallback<T> callback)
<T> void	unsetQ(Query<T> q, AsyncOperationCallback<T> cb, boolean multiple, String... field)
<T> void	unsetQ(Query<T> q, AsyncOperationCallback<T> cb, Enum... field)
<T> void	unsetQ(Query<T> q, AsyncOperationCallback<T> cb, String... field)
<T> void	unsetQ(Query<T> q, boolean multiple, AsyncOperationCallback<T> cb, Enum... field)
<T> void	unsetQ(Query<T> q, boolean multiple, Enum... field)
<T> void	unsetQ(Query<T> q, boolean multiple, String... field)
<T> void	unsetQ(Query<T> q, Enum... field)
<T> void	unsetQ(Query<T> q, String... field)
void	updateUsingFields(Object ent, String... fields) updating an enty in DB without sending the whole entity only transfers the fields to be changed / set
<T> void	updateUsingFields(T ent, AsyncOperationCallback<T> callback, String... fields)
<T> void	updateUsingFields(T ent, String collection, AsyncOperationCallback<T> callback, String... fields)
int	writeBufferCount()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Morphium

public Morphium()

Morphium

public Morphium(MorphiumConfig cfg)

init the MongoDbLayer. Uses Morphium-Configuration Object for Configuration. Needs to be set before use or RuntimeException is thrown! us used for de-referencing and automatical save of referenced entities all logging is done in INFO level

See Also:

MorphiumConfig

Method Detail

getConfig

public MorphiumConfig getConfig()

setConfig

public void setConfig(MorphiumConfig cfg)

getMaxBsonSize

public Integer getMaxBsonSize()

getMaxMessageSize

public Integer getMaxMessageSize()

getMaxWriteBatchSize

public Integer getMaxWriteBatchSize()

getCache

public MorphiumCache getCache()

addListener

public void addListener(MorphiumStorageListener lst)

removeListener

public void removeListener(MorphiumStorageListener lst)

getMongo

public com.mongodb.Mongo getMongo()

getDatabase

public com.mongodb.DB getDatabase()

findByTemplate

public <T> List<T> findByTemplate(T template,
                         String... fields)

search for objects similar to template concerning all given fields. If no fields are specified, all NON Null-Fields are taken into account if specified, field might also be null

Type Parameters:

T - - type

Parameters:

template - - what to search for

fields - - fields to use for searching

Returns:

result of search

unset

public <T> void unset(T toSet,
             Enum field)

unset

public <T> void unset(T toSet,
             String field)

unset

public <T> void unset(T toSet,
             String field,
             AsyncOperationCallback<T> callback)

unset

public <T> void unset(T toSet,
             String collection,
             String field,
             AsyncOperationCallback<T> callback)

unsetQ

public <T> void unsetQ(Query<T> q,
              String... field)

unsetQ

public <T> void unsetQ(Query<T> q,
              boolean multiple,
              String... field)

unsetQ

public <T> void unsetQ(Query<T> q,
              Enum... field)

unsetQ

public <T> void unsetQ(Query<T> q,
              boolean multiple,
              Enum... field)

unsetQ

public <T> void unsetQ(Query<T> q,
              AsyncOperationCallback<T> cb,
              String... field)

unsetQ

public <T> void unsetQ(Query<T> q,
              AsyncOperationCallback<T> cb,
              boolean multiple,
              String... field)

unsetQ

public <T> void unsetQ(Query<T> q,
              AsyncOperationCallback<T> cb,
              Enum... field)

unsetQ

public <T> void unsetQ(Query<T> q,
              boolean multiple,
              AsyncOperationCallback<T> cb,
              Enum... field)

ensureIndicesFor

public <T> void ensureIndicesFor(Class<T> type)

can be called for autmatic index ensurance. Attention: might cause heavy load on mongo will be called automatically if a new collection is created

Parameters:

type - type to ensure indices for

ensureIndicesFor

public <T> void ensureIndicesFor(Class<T> type,
                        String onCollection)

ensureIndicesFor

public <T> void ensureIndicesFor(Class<T> type,
                        AsyncOperationCallback<T> callback)

ensureIndicesFor

public <T> void ensureIndicesFor(Class<T> type,
                        String onCollection,
                        AsyncOperationCallback<T> callback)

convertToCapped

public <T> void convertToCapped(Class<T> c,
                       int size,
                       AsyncOperationCallback<T> cb)

converts the given type to capped collection in Mongo, even if no @capped is defined! Warning: depending on size this might take some time!

Type Parameters:

T -

Parameters:

c -

size -

cb -

convertToCapped

public <T> void convertToCapped(String coll,
                       int size,
                       AsyncOperationCallback<T> cb)

ensureCapped

public <T> void ensureCapped(Class<T> c)

automatically convert the collection for the given type to a capped collection only works if @Capped annotation is given for type

Parameters:

c - - type

ensureCapped

public <T> void ensureCapped(Class<T> c,
                    AsyncOperationCallback<T> callback)

simplifyQueryObject

public com.mongodb.DBObject simplifyQueryObject(com.mongodb.DBObject q)

set

public <T> void set(Query<T> query,
           Enum field,
           Object val)

set

public <T> void set(Query<T> query,
           Enum field,
           Object val,
           AsyncOperationCallback<T> callback)

set

public <T> void set(Query<T> query,
           String field,
           Object val)

set

public <T> void set(Query<T> query,
           String field,
           Object val,
           AsyncOperationCallback<T> callback)

setEnum

public void setEnum(Query<?> query,
           Map<Enum,Object> values,
           boolean insertIfNotExist,
           boolean multiple)

push

public void push(Query<?> query,
        Enum field,
        Object value)

pull

public void pull(Query<?> query,
        Enum field,
        Object value)

push

public void push(Query<?> query,
        String field,
        Object value)

pull

public void pull(Query<?> query,
        String field,
        Object value)

push

public void push(Query<?> query,
        Enum field,
        Object value,
        boolean insertIfNotExist,
        boolean multiple)

pull

public void pull(Query<?> query,
        Enum field,
        Object value,
        boolean insertIfNotExist,
        boolean multiple)

pushAll

public void pushAll(Query<?> query,
           Enum field,
           List<Object> value,
           boolean insertIfNotExist,
           boolean multiple)

pullAll

public void pullAll(Query<?> query,
           Enum field,
           List<Object> value,
           boolean insertIfNotExist,
           boolean multiple)

push

public <T> void push(Query<T> query,
            String field,
            Object value,
            boolean insertIfNotExist,
            boolean multiple)

push

public <T> void push(Query<T> query,
            String field,
            Object value,
            boolean insertIfNotExist,
            boolean multiple,
            AsyncOperationCallback<T> callback)

asynchronous call to callback

Type Parameters:

T - - the type

Parameters:

query - - the query

field - - field to push values to

value - - value to push

insertIfNotExist - - insert object, if it does not exist

multiple - - more than one

callback - - will be called, when operation succeeds - synchronous call, if null

pull

public <T> void pull(Query<T> query,
            String field,
            Object value,
            boolean insertIfNotExist,
            boolean multiple)

pull

public <T> void pull(Query<T> query,
            String field,
            Object value,
            boolean insertIfNotExist,
            boolean multiple,
            AsyncOperationCallback<T> callback)

Asynchronous call to pulll

Type Parameters:

T - - type

Parameters:

query - - query

field - - field to pull

value - - value to pull from field

insertIfNotExist - - insert document unless it exists

multiple - - more than one

callback - -callback to call when operation succeeds - synchronous call, if null

pushAll

public void pushAll(Query<?> query,
           String field,
           List<?> value,
           boolean insertIfNotExist,
           boolean multiple)

pushAll

public <T> void pushAll(Query<T> query,
               String field,
               List<?> value,
               boolean insertIfNotExist,
               boolean multiple,
               AsyncOperationCallback<T> callback)

pullAll

public void pullAll(Query<?> query,
           String field,
           List<Object> value,
           boolean insertIfNotExist,
           boolean multiple)

set

public <T> void set(Query<T> query,
           String field,
           Object val,
           boolean insertIfNotExist,
           boolean multiple)

will change an entry in mongodb-collection corresponding to given class object if query is too complex, upsert might not work! Upsert should consist of single and-queries, which will be used to generate the object to create, unless it already exists. look at Mongodb-query documentation as well

Parameters:

query - - query to specify which objects should be set

field - - field to set

val - - value to set

insertIfNotExist - - insert, if it does not exist (query needs to be simple!)

multiple - - update several documents, if false, only first hit will be updated

set

public <T> void set(Query<T> query,
           String field,
           Object val,
           boolean insertIfNotExist,
           boolean multiple,
           AsyncOperationCallback<T> callback)

set

public void set(Query<?> query,
       Map<String,Object> map,
       boolean insertIfNotExist,
       boolean multiple)

set

public <T> void set(Query<T> query,
           Map<String,Object> map,
           boolean insertIfNotExist,
           boolean multiple,
           AsyncOperationCallback<T> callback)

dec

public void dec(Query<?> query,
       Enum field,
       double amount,
       boolean insertIfNotExist,
       boolean multiple)

dec

public void dec(Query<?> query,
       String field,
       double amount,
       boolean insertIfNotExist,
       boolean multiple)

dec

public void dec(Query<?> query,
       String field,
       double amount)

dec

public void dec(Query<?> query,
       Enum field,
       double amount)

inc

public void inc(Query<?> query,
       String field,
       double amount)

inc

public void inc(Query<?> query,
       Enum field,
       double amount)

inc

public void inc(Query<?> query,
       Enum field,
       double amount,
       boolean insertIfNotExist,
       boolean multiple)

inc

public <T> void inc(Query<T> query,
           Map<String,Double> toUptad,
           boolean insertIfNotExist,
           boolean multiple,
           AsyncOperationCallback<T> callback)

inc

public void inc(Query<?> query,
       String name,
       double amount,
       boolean insertIfNotExist,
       boolean multiple)

inc

public <T> void inc(Query<T> query,
           String name,
           double amount,
           boolean insertIfNotExist,
           boolean multiple,
           AsyncOperationCallback<T> callback)

set

public <T> void set(T toSet,
           Enum field,
           Object value,
           AsyncOperationCallback<T> callback)

set

public void set(Object toSet,
       Enum field,
       Object value)

set

public void set(Object toSet,
       String field,
       Object value)

setting a value in an existing mongo collection entry - no reading necessary. Object is altered in place db.collection.update({"_id":toSet.id},{$set:{field:value}} attention: this alteres the given object toSet in a similar way

Parameters:

toSet: - object to set the value in (or better - the corresponding entry in mongo)

field: - the field to change

value: - the value to set

set

public <T> void set(T toSet,
           String field,
           Object value,
           boolean insertIfNotExists,
           boolean multiple,
           AsyncOperationCallback<T> callback)

set

public <T> void set(T toSet,
           String collection,
           String field,
           Object value,
           boolean insertIfNotExists,
           boolean multiple,
           AsyncOperationCallback<T> callback)

set

public <T> void set(T toSet,
           String field,
           Object value,
           AsyncOperationCallback<T> callback)

getWriterForClass

public MorphiumWriter getWriterForClass(Class<?> cls)

dec

public void dec(Object toDec,
       String field,
       double amount)

decreasing a value of a given object calles inc(toDec,field,-amount);

inc

public void inc(Object toSet,
       String field,
       double i)

inc

public <T> void inc(T toSet,
           String field,
           double i,
           AsyncOperationCallback<T> callback)

inc

public <T> void inc(T toSet,
           String collection,
           String field,
           double i,
           AsyncOperationCallback<T> callback)

delete

public <T> void delete(List<T> lst,
              AsyncOperationCallback<T> callback)

inc

public void inc(StatisticKeys k)

toJsonString

public String toJsonString(Object o)

updateUsingFields

public void updateUsingFields(Object ent,
                     String... fields)

updating an enty in DB without sending the whole entity only transfers the fields to be changed / set

Parameters:

ent - - entity to update

fields - - fields to use

updateUsingFields

public <T> void updateUsingFields(T ent,
                         AsyncOperationCallback<T> callback,
                         String... fields)

updateUsingFields

public <T> void updateUsingFields(T ent,
                         String collection,
                         AsyncOperationCallback<T> callback,
                         String... fields)

getMapper

public ObjectMapper getMapper()

getARHelper

public AnnotationAndReflectionHelper getARHelper()

reread

public <T> T reread(T o)

careful this actually changes the parameter o!

Type Parameters:

T - - tpye of the object

Parameters:

o - - object to read

Returns:

- entity

reread

public <T> T reread(T o,
           String collection)

firePreStoreEvent

public void firePreStoreEvent(Object o,
                     boolean isNew)

firePostStoreEvent

public void firePostStoreEvent(Object o,
                      boolean isNew)

firePreDropEvent

public void firePreDropEvent(Class cls)

firePostStore

public <T> void firePostStore(Map<T,Boolean> isNew)

firePostRemove

public <T> void firePostRemove(List<T> toRemove)

firePostLoad

public <T> void firePostLoad(List<T> loaded)

firePreStoreEvent

public void firePreStoreEvent(Map<Object,Boolean> isNew)

firePreRemove

public <T> void firePreRemove(List<T> lst)

firePreRemove

public void firePreRemove(Object o)

firePostDropEvent

public void firePostDropEvent(Class cls)

firePostUpdateEvent

public void firePostUpdateEvent(Class cls,
                       MorphiumStorageListener.UpdateTypes t)

firePreUpdateEvent

public void firePreUpdateEvent(Class cls,
                      MorphiumStorageListener.UpdateTypes t)

firePostRemoveEvent

public void firePostRemoveEvent(Object o)

firePostRemoveEvent

public void firePostRemoveEvent(Query q)

firePreRemoveEvent

public void firePreRemoveEvent(Query q)

deReference

public <T> T deReference(T obj)

de-references the given object of type T. If itself or any of its members is a Proxy (PartiallyUpdateableProxy or LazyDeReferencingProxy), it'll be removed and replaced by the real objet. This is not recursive, only the members here are de-referenced

Type Parameters:

T - - type

Parameters:

obj - - the object to replact

Returns:

the dereferenced object

firePostLoadEvent

public void firePostLoadEvent(Object o)

will be called by query after unmarshalling

Parameters:

o - - entitiy

getCurrentRSState

public ReplicaSetStatus getCurrentRSState()

isReplicaSet

public boolean isReplicaSet()

handleNetworkError

public void handleNetworkError(int i,
                      Throwable e)

getWriteConcernForClass

public com.mongodb.WriteConcern getWriteConcernForClass(Class<?> cls)

addProfilingListener

public void addProfilingListener(ProfilingListener l)

removeProfilingListener

public void removeProfilingListener(ProfilingListener l)

fireProfilingWriteEvent

public void fireProfilingWriteEvent(Class type,
                           Object data,
                           long time,
                           boolean isNew,
                           WriteAccessType wt)

fireProfilingReadEvent

public void fireProfilingReadEvent(Query q,
                          long time,
                          ReadAccessType t)

clearCollection

public void clearCollection(Class<?> cls)

issues a remove command - no lifecycle methods calles, no drop, keeps all indexec this way

Parameters:

cls - - class

clearCollection

public void clearCollection(Class<?> cls,
                   String colName)

issues a remove command - no lifecycle methods calles, no drop, keeps all indexec this way But uses sepcified collection name instead deriving name from class

Parameters:

cls - - class

colName - - CollectionName

clearCollectionOneByOne

public void clearCollectionOneByOne(Class<?> cls)

clears every single object in collection - reads ALL objects to do so this way Lifecycle methods can be called!

Parameters:

cls - -class

readAll

public <T> List<T> readAll(Class<? extends T> cls)

return a list of all elements stored in morphium for this type

Type Parameters:

T - - Type

Parameters:

cls - - type to search for, needs to be an Property

Returns:

- list of all elements stored

createQueryFor

public <T> Query<T> createQueryFor(Class<? extends T> type)

find

public <T> List<T> find(Query<T> q)

distinct

public List<Object> distinct(Enum key,
                    Class c)

distinct

public List<Object> distinct(Enum key,
                    Query q)

returns a distinct list of values of the given collection Attention: these values are not unmarshalled, you might get MongoDBObjects

distinct

public List<Object> distinct(String key,
                    Query q)

returns a distinct list of values of the given collection Attention: these values are not unmarshalled, you might get MongoDBObjects

distinct

public List<Object> distinct(String key,
                    Class cls)

group

public com.mongodb.DBObject group(Query q,
                         Map<String,Object> initial,
                         String jsReduce,
                         String jsFinalize,
                         String... keys)

findById

public <T> T findById(Class<? extends T> type,
             Object id)

findByField

public <T> List<T> findByField(Class<? extends T> cls,
                      String fld,
                      Object val)

findByField

public <T> List<T> findByField(Class<? extends T> cls,
                      Enum fld,
                      Object val)

clearCachefor

public void clearCachefor(Class<?> cls)

Erase cache entries for the given type. is being called after every store depending on cache settings!

Parameters:

cls - - class

storeNoCache

public <T> void storeNoCache(T lst)

storeNoCache

public <T> void storeNoCache(T o,
                    AsyncOperationCallback<T> callback)

storeNoCache

public <T> void storeNoCache(T o,
                    String collection)

storeNoCache

public <T> void storeNoCache(T o,
                    String collection,
                    AsyncOperationCallback<T> callback)

storeBuffered

public <T> void storeBuffered(T lst)

storeBuffered

public <T> void storeBuffered(T lst,
                     AsyncOperationCallback<T> callback)

storeBuffered

public <T> void storeBuffered(T lst,
                     String collection,
                     AsyncOperationCallback<T> callback)

flush

public void flush()

getId

public Object getId(Object o)

dropCollection

public <T> void dropCollection(Class<T> cls,
                      AsyncOperationCallback<T> callback)

dropCollection

public <T> void dropCollection(Class<T> cls,
                      String collection,
                      AsyncOperationCallback<T> callback)

dropCollection

public void dropCollection(Class<?> cls)

ensureIndex

public <T> void ensureIndex(Class<T> cls,
                   Map<String,Object> index,
                   AsyncOperationCallback<T> callback)

ensureIndex

public <T> void ensureIndex(Class<T> cls,
                   String collection,
                   Map<String,Object> index,
                   Map<String,Object> options,
                   AsyncOperationCallback<T> callback)

ensureIndex

public <T> void ensureIndex(Class<T> cls,
                   String collection,
                   Map<String,Object> index,
                   AsyncOperationCallback<T> callback)

writeBufferCount

public int writeBufferCount()

store

public <T> void store(List<T> lst,
             String collectionName,
             AsyncOperationCallback<T> callback)

ensureIndex

public void ensureIndex(Class<?> cls,
               Map<String,Object> index)

ensureIndex

public void ensureIndex(Class<?> cls,
               String collection,
               Map<String,Object> index,
               Map<String,Object> options)

ensureIndex

public void ensureIndex(Class<?> cls,
               String collection,
               Map<String,Object> index)

ensureIndex

public <T> void ensureIndex(Class<T> cls,
                   AsyncOperationCallback<T> callback,
                   Enum... fldStr)

ensureIndex(CachedObject.class,"counter","-value"); ensureIndex(CachedObject.class,"counter:2d","-value); Similar to sorting

Parameters:

cls - - class

fldStr - - fields

ensureIndex

public <T> void ensureIndex(Class<T> cls,
                   String collection,
                   AsyncOperationCallback<T> callback,
                   Enum... fldStr)

ensureIndex

public <T> void ensureIndex(Class<T> cls,
                   AsyncOperationCallback<T> callback,
                   String... fldStr)

ensureIndex

public <T> void ensureIndex(Class<T> cls,
                   String collection,
                   AsyncOperationCallback<T> callback,
                   String... fldStr)

createIndexMapFrom

public List<Map<String,Object>> createIndexMapFrom(String[] fldStr)

ensureIndex

public void ensureIndex(Class<?> cls,
               String... fldStr)

ensureIndex

public void ensureIndex(Class<?> cls,
               Enum... fldStr)

store

public <T> void store(T o)

Stores a single Object. Clears the corresponding cache

Parameters:

o - - Object to store

store

public <T> void store(T o,
             AsyncOperationCallback<T> callback)

store

public <T> void store(T o,
             String collection,
             AsyncOperationCallback<T> callback)

store

public <T> void store(List<T> lst,
             AsyncOperationCallback<T> callback)

storeList

public <T> void storeList(List<T> lst,
                 String collection)

stores all elements of this list to the given collection

Type Parameters:

T - - type of entity

Parameters:

lst - - list of objects to store

collection - - collection name to use

storeList

public <T> void storeList(List<T> lst,
                 String collection,
                 AsyncOperationCallback<T> callback)

readMaximums

public void readMaximums()

storeList

public <T> void storeList(List<T> lst)

sorts elements in this list, whether to store in background or directly.

Type Parameters:

T -

Parameters:

lst - - all objects are sorted whether to store in BG or direclty. All objects are stored in their corresponding collection

storeList

public <T> void storeList(List<T> lst,
                 AsyncOperationCallback<T> callback)

delete

public <T> void delete(Query<T> o)

delete

public <T> void delete(Query<T> o,
              AsyncOperationCallback<T> callback)

pushPull

public <T> void pushPull(boolean push,
                Query<T> query,
                String field,
                Object value,
                boolean insertIfNotExist,
                boolean multiple,
                AsyncOperationCallback<T> callback)

pushPullAll

public <T> void pushPullAll(boolean push,
                   Query<T> query,
                   String field,
                   List<?> value,
                   boolean insertIfNotExist,
                   boolean multiple,
                   AsyncOperationCallback<T> callback)

pullAll

public <T> void pullAll(Query<T> query,
               String field,
               List<?> value,
               boolean insertIfNotExist,
               boolean multiple,
               AsyncOperationCallback<T> callback)

delete

public void delete(Object o)

deletes a single object from morphium backend. Clears cache

Parameters:

o - - entity

delete

public void delete(Object o,
          String collection)

delete

public <T> void delete(T lo,
              AsyncOperationCallback<T> callback)

delete

public <T> void delete(T lo,
              String collection,
              AsyncOperationCallback<T> callback)

getStatistics

public Map<String,Double> getStatistics()

resetStatistics

public void resetStatistics()

getStats

public Map<StatisticKeys,StatisticValue> getStats()

addShutdownListener

public void addShutdownListener(ShutdownListener l)

removeShutdownListener

public void removeShutdownListener(ShutdownListener l)

close

public void close()

createCamelCase

public String createCamelCase(String n)

createAggregator

public <T,R> Aggregator<T,R> createAggregator(Class<? extends T> type,
                                     Class<? extends R> resultType)

aggregate

public <T,R> List<R> aggregate(Aggregator<T,R> a)

createPartiallyUpdateableEntity

public <T> T createPartiallyUpdateableEntity(T o)

create a proxy object, implementing the ParitallyUpdateable Interface these objects will be updated in mongo by only changing altered fields Attention: the field name if determined by the setter name for now. That means, it does not honor the @Property-Annotation!!! To make sure, you take the correct field - use the UpdatingField-Annotation for the setters!

Type Parameters:

T - - type

Parameters:

o - - entity

Returns:

Type

createLazyLoadedEntity

public <T> T createLazyLoadedEntity(Class<? extends T> cls,
                           Object id)

createMongoField

public <T> MongoField<T> createMongoField()

getWriteBufferCount

public int getWriteBufferCount()

getBufferedWriterBufferCount

public int getBufferedWriterBufferCount()

getAsyncWriterBufferCount

public int getAsyncWriterBufferCount()

getWriterBufferCount

public int getWriterBufferCount()

disableAutoValuesForThread

public void disableAutoValuesForThread()

enableAutoValuesForThread

public void enableAutoValuesForThread()

isAutoValuesEnabledForThread

public boolean isAutoValuesEnabledForThread()

disableReadCacheForThread

public void disableReadCacheForThread()

enableReadCacheForThread

public void enableReadCacheForThread()

isReadCacheEnabledForThread

public boolean isReadCacheEnabledForThread()

disableWriteBufferForThread

public void disableWriteBufferForThread()

enableWriteBufferForThread

public void enableWriteBufferForThread()

isWriteBufferEnabledForThread

public boolean isWriteBufferEnabledForThread()

disableAsyncWritesForThread

public void disableAsyncWritesForThread()

enableAsyncWritesForThread

public void enableAsyncWritesForThread()

isAsyncWritesEnabledForThread

public boolean isAsyncWritesEnabledForThread()