ZFObjectGlobalInstance.h

Go to the documentation of this file.

#ifndef _ZFI_ZFObjectGlobalInstance_h_
#define _ZFI_ZFObjectGlobalInstance_h_
 
#include "ZFTypeId.h"
#include "ZFMethodDeclare.h"
ZF_NAMESPACE_GLOBAL_BEGIN
 
// ============================================================
// global instance cleaner
extern ZFLIB_ZFCore void ZFObjectGlobalInstanceAdd(
        ZF_IN ZFObject *obj
        , ZF_IN_OPT ZFLevel level = ZFLevelAppNormal
        );
extern ZFLIB_ZFCore void ZFObjectGlobalInstanceRemove(
        ZF_IN ZFObject *obj
        , ZF_IN ZFLevel level
        );
 
// ============================================================
// private
typedef void (*_ZFP_ZFClassSingletonDeleteCallback)(ZF_IN void *instance);
extern ZFLIB_ZFCore void **_ZFP_ZFClassSingletonInstanceRefAccess(ZF_IN const zfstring &sig);
 
zffinal zfclassNotPOD ZFLIB_ZFCore _ZFP_ZFClassSingletonDeleteCallbackHolder {
public:
    _ZFP_ZFClassSingletonDeleteCallback deleteCallback;
    void *instance;
public:
    _ZFP_ZFClassSingletonDeleteCallbackHolder(
            ZF_IN _ZFP_ZFClassSingletonDeleteCallback deleteCallback
            , ZF_IN void *instance
            )
    : deleteCallback(deleteCallback)
    , instance(instance)
    {
    }
    ~_ZFP_ZFClassSingletonDeleteCallbackHolder(void) {
        if(this->deleteCallback && this->instance) {
            this->deleteCallback(this->instance);
        }
    }
};
 
// ============================================================
// singleton for normal class type
#define _ZFP_ZFCLASS_SINGLETON_DECLARE(SetterAccessType, GetterAccessType, \
                                       AccessTypeName, accessMethodName) \
    GetterAccessType: \
 \
        static AccessTypeName *accessMethodName(void); \
    SetterAccessType: \
 \
        static void accessMethodName(ZF_IN AccessTypeName *newInstance); \
    private: \
        static ZFObject *&_ZFP_ClsSIC_##accessMethodName(void); /* ClassSingletonCleaner */ \
        static void _ZFP_ClsSID_##accessMethodName(ZF_IN void *instance); /* ClassSingletonOnDelete */ \
    public:
#define _ZFP_ZFCLASS_SINGLETON_DEFINE(OwnerClass, AccessTypeName, ObjectTypeName, sig, accessMethodName, \
                                      ZFLevel_, \
                                      newAction, retainAction, releaseAction) \
    AccessTypeName *OwnerClass::accessMethodName(void) { \
        static void **holder = _ZFP_ZFClassSingletonInstanceRefAccess(sig); \
        if(*holder == zfnull) { \
            if(ZFFrameworkStateCheck(ZFLevel_) == ZFFrameworkStateNotAvailable) { \
                return zfnull; \
            } \
            AccessTypeName *t = newAction(ObjectTypeName); \
            OwnerClass::accessMethodName(t); \
            releaseAction(t); \
        } \
        return (AccessTypeName *)(*holder); \
    } \
    void OwnerClass::accessMethodName(ZF_IN AccessTypeName *newInstance) { \
        if(ZFFrameworkStateCheck(ZFLevel_) == ZFFrameworkStateNotAvailable) { \
            return; \
        } \
        void **holder = _ZFP_ZFClassSingletonInstanceRefAccess(sig); \
        if(*holder == (void *)newInstance) { \
            return; \
        } \
        ZFCoreMutexLocker(); \
        ZFObject *&cleanerRef = OwnerClass::_ZFP_ClsSIC_##accessMethodName(); \
        zfauto cleanerOld = cleanerRef; \
        cleanerRef = zfnull; \
        AccessTypeName *newInstanceValue = zfnull; \
        if(newInstance != zfnull) { \
            newInstanceValue = retainAction(newInstance); \
            *holder = (void *)newInstanceValue; \
            zfobj<ZFValue> cleanerRefTmp(*holder, OwnerClass::_ZFP_ClsSID_##accessMethodName); \
            cleanerRef = cleanerRefTmp; \
            ZFObjectGlobalInstanceAdd(cleanerRef, ZFLevel_); \
        } \
        if(cleanerOld != zfnull) { \
            ZFObjectGlobalInstanceRemove(cleanerOld, ZFLevel_); \
            *holder = (void *)newInstanceValue; \
        } \
    } \
    ZFObject *&OwnerClass::_ZFP_ClsSIC_##accessMethodName(void) { \
        static ZFObject *_cleaner = zfnull; \
        return _cleaner; \
    } \
    void OwnerClass::_ZFP_ClsSID_##accessMethodName(ZF_IN void *instance) { \
        OwnerClass::_ZFP_ClsSIC_##accessMethodName() = zfnull; \
        void **holder = _ZFP_ZFClassSingletonInstanceRefAccess(sig); \
        *holder = zfnull; \
        releaseAction((AccessTypeName *)instance); \
    }
#define ZFCLASS_SINGLETON_DECLARE(AccessTypeName, accessMethodName) \
    ZFCLASS_SINGLETON_DECLARE_DETAIL(protected, public, AccessTypeName, accessMethodName)

#define ZFCLASS_SINGLETON_DECLARE_DETAIL(SetterAccessType, GetterAccessType, AccessTypeName, accessMethodName) \
    _ZFP_ZFCLASS_SINGLETON_DECLARE(SetterAccessType, GetterAccessType, AccessTypeName, accessMethodName)

#define ZFCLASS_SINGLETON_DEFINE(OwnerClass, accessMethodName) \
    ZFCLASS_SINGLETON_DEFINE_DETAIL(OwnerClass, OwnerClass, OwnerClass, accessMethodName, ZFLevelAppNormal)

#define ZFCLASS_SINGLETON_DEFINE_WITH_LEVEL(OwnerClass, accessMethodName, ZFLevel_) \
    ZFCLASS_SINGLETON_DEFINE_DETAIL(OwnerClass, OwnerClass, OwnerClass, accessMethodName, ZFLevel_)

#define ZFCLASS_SINGLETON_DEFINE_DETAIL(OwnerClass, AccessTypeName, ObjectTypeName, accessMethodName, ZFLevel_) \
    _ZFP_ZFCLASS_SINGLETON_DEFINE(OwnerClass, AccessTypeName, ObjectTypeName, \
                                  zfstr("_ZFP_ZFClass_%s_%s", #AccessTypeName, #accessMethodName), \
                                  accessMethodName, ZFLevel_, \
                                  zfnew, ZFM_EXPAND, zfdelete)
 
// ============================================================
// singleton for ZFObject
#define _ZFP_ZFOBJECT_SINGLETON_DECLARE(SetterAccessType, GetterAccessType, \
                                        AccessTypeName, accessMethodName) \
    GetterAccessType: \
 \
        ZFMETHOD_DECLARE_DETAIL_0( \
            GetterAccessType, ZFMethodTypeStatic, \
            AccessTypeName *, accessMethodName \
            ) \
    SetterAccessType: \
 \
        ZFMETHOD_DECLARE_DETAIL_1( \
            SetterAccessType, ZFMethodTypeStatic, \
            void, accessMethodName \
            , ZFMP_IN(AccessTypeName *, param0) \
            ) \
 \
    private: \
        _ZFP_ZFCLASS_SINGLETON_DECLARE(private, private, \
                                       AccessTypeName, _ZFP_ZFObjectSingleton_##accessMethodName) \
 \
    public:
#define _ZFP_ZFOBJECT_SINGLETON_DEFINE(OwnerClass, \
                                       AccessTypeName, ObjectTypeName, sig, accessMethodName, \
                                       ZFLevel_) \
    _ZFP_ZFCLASS_SINGLETON_DEFINE(OwnerClass, \
                                  AccessTypeName, ObjectTypeName, sig, _ZFP_ZFObjectSingleton_##accessMethodName, \
                                  ZFLevel_, \
                                  zfobjAlloc, zfobjRetain, zfobjRelease) \
    ZFMETHOD_DEFINE_DETAIL_0(OwnerClass, G, \
            AccessTypeName *, accessMethodName \
            ) { \
        return zfself::_ZFP_ZFObjectSingleton_##accessMethodName(); \
    } \
    ZFMETHOD_DEFINE_DETAIL_1(OwnerClass, S, \
            void, accessMethodName \
            , ZFMP_IN(AccessTypeName *, param0) \
            ) { \
        if(ZFFrameworkStateCheck(ZFLevel_) == ZFFrameworkStateNotAvailable) { \
            return; \
        } \
        zfself::_ZFP_ZFObjectSingleton_##accessMethodName(param0); \
    }

#define ZFOBJECT_SINGLETON_DECLARE(AccessTypeName, accessMethodName) \
    ZFOBJECT_SINGLETON_DECLARE_DETAIL(protected, public, AccessTypeName, accessMethodName)

#define ZFOBJECT_SINGLETON_DECLARE_DETAIL(SetterAccessType, GetterAccessType, AccessTypeName, accessMethodName) \
    _ZFP_ZFOBJECT_SINGLETON_DECLARE(SetterAccessType, GetterAccessType, AccessTypeName, accessMethodName)

#define ZFOBJECT_SINGLETON_DEFINE(OwnerClass, accessMethodName) \
    ZFOBJECT_SINGLETON_DEFINE_DETAIL(OwnerClass, OwnerClass, OwnerClass, accessMethodName, ZFLevelAppNormal)

#define ZFOBJECT_SINGLETON_DEFINE_WITH_LEVEL(OwnerClass, accessMethodName, ZFLevel_) \
    ZFOBJECT_SINGLETON_DEFINE_DETAIL(OwnerClass, OwnerClass, OwnerClass, accessMethodName, ZFLevel_)

#define ZFOBJECT_SINGLETON_DEFINE_DETAIL(OwnerClass, \
                                         AccessTypeName, ObjectTypeName, accessMethodName, \
                                         ZFLevel_) \
    _ZFP_ZFOBJECT_SINGLETON_DEFINE(OwnerClass, \
                                   AccessTypeName, ObjectTypeName, \
                                   zfstr("_ZFP_ZFObject_%s_%s_%s", zfself::ClassData()->classNameFull(), #AccessTypeName, #accessMethodName), \
                                   accessMethodName, \
                                   ZFLevel_)
 
ZF_NAMESPACE_GLOBAL_END
#endif // #ifndef _ZFI_ZFObjectGlobalInstance_h_