@sapui5/sap.ushell 1.115.1 → 1.116.0

package/src/main/js/sap/ushell/components/applicationIntegration/application/BlueBoxHandler.js

@@ -1,7 +1,7 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 /**
  * @fileOverview handle all the resources for the different applications.
- * @version 1.115.1
+ * @version 1.116.0
  */
 sap.ui.define([
     "sap/ushell/components/applicationIntegration/application/BlueBoxesCache",
@@ -23,154 +23,9 @@ sap.ui.define([
     "use strict";
 
     function BlueBoxHandler () {
-        var that = this,
-            AppLifeCycle,
-            oCustomCapabilitiesHandlers = {
-                isStateful: {
-                    handler: function (appCapabilities, oContainer) {
-                        if (appCapabilities && (appCapabilities.enabled === true || appCapabilities === true)) {
-                            return true;
-                        }
-
-                        return false;
-                    }
-                },
-                isGUI: {
-                    handler: function (appCapabilities, oContainer) {
-                        if (appCapabilities && appCapabilities.protocol === "GUI") {
-                            return true;
-                        }
-
-                        return false;
-                    }
-                },
-                isGUIStateful: {
-                    handler: function (appCapabilities, oContainer) {
-                        return that.isCapUT(oContainer, "isGUI") && that.isCapUT(oContainer, "isStateful");
-                    }
-                },
-                isFLP: {
-                    handler: function (appCapabilities, oContainer) {
-                        return !that.isCapUT(oContainer, "isGUI") && that.isCapUT(oContainer, "isStateful");
-                    }
-                }
-            },
+        var AppLifeCycle,
             oBlueBoxContainer = {},
-            oSupportedTypes = {},
-            oHandlers = {
-                setup: function (oTarget, sStorageKey) {
-                },
-
-                //we dont know the app Id we pass te hole url, in the Storage we manage it using sCacheId (this is for the keep alive)
-                create: function (oInnerControl, sUrl, sStorageKey, oTarget, bNavigationInSameStatefullContainer) {
-                    var oDeferred = new jQuery.Deferred(),
-                        oFLPParams,
-                        oPostParams;
-
-                    function callPostMessage () {
-                        if (oFLPParams) {
-                            oFLPParams["sap-flp-url"] = sap.ushell.Container.getFLPUrl(true);
-                            oFLPParams["system-alias"] = oInnerControl.getSystemAlias();
-                            oPostParams["sap-flp-params"] = oFLPParams;
-                        }
-
-                        Core.getEventBus().publish("launchpad", "appOpening", oTarget);
-                        Application.postMessageToIframeApp(
-                            oInnerControl, "sap.ushell.services.appLifeCycle", "create", oPostParams, true)
-                            .then(function (oResult) {
-                                oBlueBoxContainer[oInnerControl].currentAppTarget = oTarget;
-                                sap.ushell.Container.getServiceAsync("AppLifeCycle").then(function (oAppLifeCycleService) {
-                                    if (bNavigationInSameStatefullContainer === true) {
-                                        oAppLifeCycleService.prepareCurrentAppObject("URL", undefined, false, oInnerControl);
-                                    }
-                                    Core.getEventBus().publish("sap.ushell", "appOpened", oTarget);
-                                    oDeferred.resolve(oResult && oResult.body && oResult.body.result);
-                                });
-                            });
-                    }
-
-                    sUrl = ApplicationContainer.prototype._checkNwbcUrlAdjustment(oInnerControl, oTarget.applicationType, sUrl);
-                    oPostParams = {
-                        sCacheId: sStorageKey,
-                        sUrl: sUrl,
-                        sHash: hasher.getHash()
-                    };
-                    if (sUrl.indexOf("sap-iframe-hint=GUI") > 0 || sUrl.indexOf("sap-iframe-hint=WDA") > 0 || sUrl.indexOf("sap-iframe-hint=WCF") > 0) {
-                        var aInfoArray = [];
-                        var aKeysArray = ApplicationContainer.prototype._getParamKeys(sUrl, aInfoArray);
-
-                        if (aKeysArray.length > 0) {
-                            sap.ushell.Container.getServiceAsync("CrossApplicationNavigation").then(function (oCANService) {
-                                oCANService.getAppStateData(aKeysArray).then(function (aDataArray) {
-                                    oFLPParams = {};
-                                    aInfoArray.forEach(function (item, index) {
-                                        if (aDataArray[index][0]) {
-                                            oFLPParams[item] = aDataArray[index][0];
-                                        }
-                                    });
-                                    callPostMessage();
-                                }, function () {
-                                    callPostMessage();
-                                });
-                            });
-                        } else {
-                            oFLPParams = {};
-                            callPostMessage();
-                        }
-                    } else {
-                        callPostMessage();
-                    }
-
-                    return oDeferred.promise();
-                },
-                destroy: function (oInnerControl, sStorageKey) {
-                    var oPromise;
-
-                    sap.ushell.Container.setAsyncDirtyStateProvider(undefined);
-                    oPromise = Application.postMessageToIframeApp(oInnerControl, "sap.ushell.services.appLifeCycle", "destroy", {
-                        sCacheId: sStorageKey
-                    }, true);
-
-                    oPromise.then(function () {
-                        Core.getEventBus().publish("sap.ushell", "appClosed", oBlueBoxContainer[oInnerControl].currentAppTarget);
-                        oBlueBoxContainer[oInnerControl].currentAppTarget = undefined;
-                    });
-                    return oPromise;
-                },
-                store: function (oInnerControl, sStorageKey) {
-                    var oPromise;
-
-                    sap.ushell.Container.setAsyncDirtyStateProvider(undefined);
-                    oPromise = Application.postMessageToIframeApp(oInnerControl, "sap.ushell.services.appLifeCycle", "store", {
-                        sCacheId: sStorageKey
-                    }, true);
-
-                    oPromise.then(function () {
-                        Core.getEventBus().publish("sap.ushell", "appClosed", oBlueBoxContainer[oInnerControl].currentAppTarget);
-                        oBlueBoxContainer[oInnerControl].currentAppTarget = undefined;
-                    });
-                    return oPromise;
-                },
-                restore: function (oInnerControl, sStorageKey, oTarget, bNavigationInSameStatefullContainer) {
-                    return new Promise(function (fnResolve) {
-                        Core.getEventBus().publish("launchpad", "appOpening", oTarget);
-                        Application.postMessageToIframeApp(oInnerControl, "sap.ushell.services.appLifeCycle", "restore", {
-                            sCacheId: sStorageKey,
-                            sUrl: oTarget.url,
-                            sHash: hasher.getHash()
-                        }, true).then(function () {
-                            oBlueBoxContainer[oInnerControl].currentAppTarget = oTarget;
-                            sap.ushell.Container.getServiceAsync("AppLifeCycle").then(function (oAppLifeCycleService) {
-                                if (bNavigationInSameStatefullContainer === true) {
-                                    oAppLifeCycleService.prepareCurrentAppObject("URL", undefined, false, oInnerControl);
-                                }
-                                Core.getEventBus().publish("sap.ushell", "appOpened", oTarget);
-                                fnResolve();
-                            });
-                        });
-                    });
-                }
-            },
+            oGuiV1BlueBoxContainer = {},
             oBasicStatefulContainerCapabilities = [
                 {
                     service: "sap.ushell.services.appLifeCycle",
@@ -181,32 +36,142 @@ sap.ui.define([
                 }
             ];
 
-        //API:
-        //
-        //LRU(limit)
-        //  Initialize LRU cache with default limit being 10 items
-        this.init = function (oSetup, inConfig, inAppLifeCycle) {
+        this.init = function (inAppLifeCycle) {
+            oBlueBoxContainer = {};
+            oGuiV1BlueBoxContainer = {};
+            AppLifeCycle = inAppLifeCycle;
             BlueBoxesCache.init();
             Application.init(this);
-            AppLifeCycle = inAppLifeCycle;
+        };
+
+        this.statefulCreateApp = function (oInnerControl, sUrl, sStorageKey, oTarget, bNavigationInSameStatefullContainer) {
+            var oDeferred = new jQuery.Deferred(),
+                oFLPParams,
+                oPostParams;
+
+            function callPostMessage () {
+                if (oFLPParams) {
+                    oFLPParams["sap-flp-url"] = sap.ushell.Container.getFLPUrl(true);
+                    oFLPParams["system-alias"] = oInnerControl.getSystemAlias();
+                    oPostParams["sap-flp-params"] = oFLPParams;
+                }
+
+                oInnerControl.setProperty("currentAppUrl", sUrl, true);
+                oInnerControl.setProperty("currentAppId", sStorageKey, true);
+                oInnerControl.setProperty("currentAppTargetResolution", oTarget, true);
+                Core.getEventBus().publish("launchpad", "appOpening", oTarget);
+                Application.postMessageToIframeApp(
+                    oInnerControl, "sap.ushell.services.appLifeCycle", "create", oPostParams, true)
+                    .then(function (oResult) {
+                        sap.ushell.Container.getServiceAsync("AppLifeCycle").then(function (oAppLifeCycleService) {
+                            if (bNavigationInSameStatefullContainer === true) {
+                                oAppLifeCycleService.prepareCurrentAppObject("URL", undefined, false, oInnerControl);
+                            }
+                            Core.getEventBus().publish("sap.ushell", "appOpened", oTarget);
+                            oDeferred.resolve(oResult && oResult.body && oResult.body.result);
+                        });
+                    });
+            }
 
-            if (inConfig) {
-                deepExtend(oSupportedTypes, inConfig.supportedTypes);
+            sUrl = ApplicationContainer.prototype._checkNwbcUrlAdjustment(oInnerControl, oTarget.applicationType, sUrl);
+            oPostParams = {
+                sCacheId: sStorageKey,
+                sUrl: sUrl,
+                sHash: hasher.getHash()
+            };
+            if (sUrl.indexOf("sap-iframe-hint=GUI") > 0 || sUrl.indexOf("sap-iframe-hint=WDA") > 0 || sUrl.indexOf("sap-iframe-hint=WCF") > 0) {
+                var aInfoArray = [];
+                var aKeysArray = ApplicationContainer.prototype._getParamKeys(sUrl, aInfoArray);
+
+                if (aKeysArray.length > 0) {
+                    sap.ushell.Container.getServiceAsync("CrossApplicationNavigation").then(function (oCANService) {
+                        oCANService.getAppStateData(aKeysArray).then(function (aDataArray) {
+                            oFLPParams = {};
+                            aInfoArray.forEach(function (item, index) {
+                                if (aDataArray[index][0]) {
+                                    oFLPParams[item] = aDataArray[index][0];
+                                }
+                            });
+                            callPostMessage();
+                        }, function () {
+                            callPostMessage();
+                        });
+                    });
+                } else {
+                    oFLPParams = {};
+                    callPostMessage();
+                }
+            } else {
+                callPostMessage();
             }
+
+            return oDeferred.promise();
         };
 
-        this.isStatefulContainerSupported = function (oBlueBox) {
-            var bIsSupported =
-                this.isCapabilitySupported(oBlueBox, "sap.ushell.services.appLifeCycle", "create") &&
-                this.isCapabilitySupported(oBlueBox, "sap.ushell.services.appLifeCycle", "destroy");
+        this.statefulDestroyApp = function (oInnerControl, sStorageKey) {
+            var oPromise,
+                oAppTarget;
+
+            oInnerControl.setProperty("currentAppUrl", "", true);
+            oInnerControl.setProperty("currentAppId", "", true);
+            oAppTarget = oInnerControl.getCurrentAppTargetResolution();
+            oInnerControl.setProperty("currentAppTargetResolution", undefined, true);
+            sap.ushell.Container.setAsyncDirtyStateProvider(undefined);
+            oPromise = Application.postMessageToIframeApp(oInnerControl, "sap.ushell.services.appLifeCycle", "destroy", {
+                sCacheId: sStorageKey
+            }, true);
+
+            oPromise.then(function () {
+                Core.getEventBus().publish("sap.ushell", "appClosed", oAppTarget);
+            });
+            return oPromise;
+        };
 
-            return bIsSupported;
+        this.statefulStoreKeepAliveApp = function (oInnerControl, sStorageKey) {
+            var oPromise,
+                oAppTarget;
+
+            oInnerControl.setProperty("currentAppUrl", "", true);
+            oInnerControl.setProperty("currentAppId", "", true);
+            oAppTarget = oInnerControl.getCurrentAppTargetResolution();
+            oInnerControl.setProperty("currentAppTargetResolution", undefined, true);
+            sap.ushell.Container.setAsyncDirtyStateProvider(undefined);
+            oPromise = Application.postMessageToIframeApp(oInnerControl, "sap.ushell.services.appLifeCycle", "store", {
+                sCacheId: sStorageKey
+            }, true);
+
+            oPromise.then(function () {
+                Core.getEventBus().publish("sap.ushell", "appClosed", oAppTarget);
+            });
+            return oPromise;
+        };
+
+        this.statefulRestoreKeepAliveApp = function (oInnerControl, sUrl, sStorageKey, oTarget, bNavigationInSameStatefullContainer) {
+            return new Promise(function (fnResolve) {
+                oInnerControl.setProperty("currentAppUrl", sUrl, true);
+                oInnerControl.setProperty("currentAppId", sStorageKey, true);
+                oInnerControl.setProperty("currentAppTargetResolution", oTarget, true);
+                Core.getEventBus().publish("launchpad", "appOpening", oTarget);
+                Application.postMessageToIframeApp(oInnerControl, "sap.ushell.services.appLifeCycle", "restore", {
+                    sCacheId: sStorageKey,
+                    sUrl: oTarget.url,
+                    sHash: hasher.getHash()
+                }, true).then(function () {
+                    sap.ushell.Container.getServiceAsync("AppLifeCycle").then(function (oAppLifeCycleService) {
+                        if (bNavigationInSameStatefullContainer === true) {
+                            oAppLifeCycleService.prepareCurrentAppObject("URL", undefined, false, oInnerControl);
+                        }
+                        Core.getEventBus().publish("sap.ushell", "appOpened", oTarget);
+                        fnResolve();
+                    });
+                });
+            });
         };
 
-        this.isKeepAliveSupported = function (oBlueBox) {
+        this.isStatefulContainerSupported = function (oBlueBox) {
             var bIsSupported =
-                this.isCapabilitySupported(oBlueBox, "sap.ushell.services.appLifeCycle", "store") &&
-                this.isCapabilitySupported(oBlueBox, "sap.ushell.services.appLifeCycle", "restore");
+                this.isCapabilitySupported(oBlueBox, "sap.ushell.services.appLifeCycle", "create") &&
+                this.isCapabilitySupported(oBlueBox, "sap.ushell.services.appLifeCycle", "destroy");
 
             return bIsSupported;
         };
@@ -223,13 +188,9 @@ sap.ui.define([
             this.setCapabilities(oContainer, aCaps);
         };
 
-        this.getCapabilities = function (oBlueBox) {
-            return oBlueBoxContainer[oBlueBox].oCapMap;
-        };
-
         this.isCapabilitySupported = function (oBlueBox, sServiceName, sInterface) {
             if (oBlueBoxContainer[oBlueBox] && oBlueBoxContainer[oBlueBox].oCapMap && oBlueBoxContainer[oBlueBox].oCapMap[sServiceName]) {
-                    return !!oBlueBoxContainer[oBlueBox].oCapMap[sServiceName][sInterface];
+                return !!oBlueBoxContainer[oBlueBox].oCapMap[sServiceName][sInterface];
             }
 
             return false;
@@ -269,10 +230,21 @@ sap.ui.define([
 
         };
 
-        this.removeCapabilities = function (oBlueBox) {
+        this.removeCapabilities = function (oBlueBox, oCapabilities) {
             if (oBlueBoxContainer[oBlueBox]) {
-                oBlueBoxContainer[oBlueBox].oCapMap = {};
-                oBlueBox.setIsStateful(false);
+                if (!oCapabilities) {
+                    oBlueBoxContainer[oBlueBox].oCapMap = {};
+                    oBlueBox.setIsStateful(false);
+                } else {
+                    oCapabilities.forEach(function (oCap) {
+                        if (oBlueBoxContainer[oBlueBox].oCapMap.hasOwnProperty(oCap.service)) {
+                            delete oBlueBoxContainer[oBlueBox].oCapMap[oCap.service][oCap.action];
+                            if (oCap.service === "sap.ushell.services.appLifeCycle" && oCap.action === "create") {
+                                oBlueBox.setIsStateful(false);
+                            }
+                        }
+                    });
+                }
             }
         };
 
@@ -288,7 +260,6 @@ sap.ui.define([
             oBlueBoxContainer[oBlueBox] = {
                 BlueBox: oBlueBox
             };
-
         };
 
         this.setAppCapabilities = function (oBlueBox, oTarget) {
@@ -296,7 +267,6 @@ sap.ui.define([
                 this.initBlueBoxBD(oBlueBox);
             }
 
-            oBlueBoxContainer[oBlueBox].currentAppTarget = oTarget;
             oBlueBoxContainer[oBlueBox].appCapabilities = oTarget.appCapabilities;
             if (oTarget.appCapabilities && oTarget.appCapabilities.statefulContainer === true) {
                 this.setCapabilities(oBlueBox, oBasicStatefulContainerCapabilities);
@@ -313,37 +283,6 @@ sap.ui.define([
             }
         };
 
-        this.isCapByTarget = function (oTarget, attr) {
-            // check if we have custom handling for this attribute
-            if (oTarget.appCapabilities === undefined) {
-                return false;
-            }
-
-            if (oCustomCapabilitiesHandlers[attr] && oTarget && oTarget.appCapabilities) {
-                return oCustomCapabilitiesHandlers[attr].handler(oTarget.appCapabilities);
-            }
-            // get the attribute value from the appCapabilities
-            // if not define return false
-            return oTarget.appCapabilities[attr] || false;
-        };
-
-        this.isCapUT = function (oBlueBox, attr) {
-            // check if we have custom handling for this attribute
-            var oBBInstance = oBlueBoxContainer[oBlueBox];
-
-            // check if we have custom handling for this attribute
-            if (oBBInstance === undefined || oBBInstance.appCapabilities === undefined) {
-                return false;
-            }
-
-            if (oCustomCapabilitiesHandlers[attr] && oBBInstance) {
-                return oCustomCapabilitiesHandlers[attr].handler(oBBInstance.appCapabilities, oBlueBox);
-            }
-            // get the attribute value from the appCapabilities
-            // if not define return false
-            return oBBInstance.appCapabilities[attr] || false;
-        };
-
         this.setStorageKey = function (oBlueBox, setStorageKey) {
             if (!oBlueBoxContainer[oBlueBox]) {
                 this.initBlueBoxBD(oBlueBox);
@@ -359,10 +298,6 @@ sap.ui.define([
             return oBlueBoxContainer[oBlueBox].sStorageKey;
         };
 
-        this.getHandler = function () {
-            return oHandlers;
-        };
-
         this._getBlueBoxCacheKey = function (sUrl) {
             return BlueBoxesCache.getBlueBoxCacheKeyValues(sUrl).sKey;
         };
@@ -381,13 +316,6 @@ sap.ui.define([
             });
         };
 
-        this.openApp = function (sAppId) {
-            AppLifeCycle.postMessageToIframeApp("sap.ushell.services.appLifeCycle", "create", {
-                appId: sAppId,
-                sHash: hasher.getHash()
-            });
-        };
-
         this.storeApp = function (sAppId) {
             AppLifeCycle.postMessageToIframeApp("sap.ushell.services.appLifeCycle", "store", {
                 appId: sAppId,
@@ -405,6 +333,10 @@ sap.ui.define([
         //delete(sUrl)
         //  delete a single entry from the cols start cache
         this.delete = function (sUrl) {
+            var oContainer = BlueBoxesCache.get(sUrl);
+            if (oBlueBoxContainer[oContainer]) {
+                delete oBlueBoxContainer[oContainer];
+            }
             BlueBoxesCache.remove(sUrl);
         };
 
@@ -425,6 +357,154 @@ sap.ui.define([
         this.set = function (sUrl, oIframe) {
             BlueBoxesCache.add(sUrl, oIframe);
         };
+
+        //TODO - when this function should return false>
+        this.findFreeContainerForNewKeepAliveApp = function (sUrl) {
+            return undefined;
+            // if (window.QUnit === undefined) {
+            //     return undefined;
+            // }
+            //
+            // var sTmpUrl = sUrl.replaceAll("sap-keep-alive", "sap-temp");
+            // var oContainerDetailsFromPool = BlueBoxesCache.get(sTmpUrl, true);
+            // if (oContainerDetailsFromPool) {
+            //     oBlueBoxContainer[oContainerDetailsFromPool.BlueBox] = oContainerDetailsFromPool;
+            //     BlueBoxesCache.add(sUrl, oContainerDetailsFromPool.BlueBox);
+            //     oContainerDetailsFromPool.BlueBox.setProperty("currentAppUrl", "", true);
+            //     oContainerDetailsFromPool.BlueBox.setProperty("isFetchedFromCache", true, true);
+            //     return oContainerDetailsFromPool.BlueBox;
+            // }
+            //
+            // var oContainerToUse = BlueBoxesCache.get(sTmpUrl);
+            // if (oContainerToUse) {
+            //     BlueBoxesCache.remove(sTmpUrl);
+            //     BlueBoxesCache.add(sUrl, oContainerToUse);
+            //     oContainerToUse.setProperty("currentAppUrl", "", true);
+            //     oContainerToUse.setProperty("isFetchedFromCache", true, true);
+            // }
+            //
+            // return oContainerToUse;
+        };
+
+        this.returnUnusedKeepAliveContainer = function (oAppContainer) {
+            return false;
+            // //currently enabled only for qunits
+            // if (window.QUnit === undefined) {
+            //     return false;
+            // }
+            //
+            // if (this.isOldVersionOfLegacyApp()) {
+            //     return true;
+            // }
+            //
+            // this.setCapabilities(oAppContainer, [
+            //     {
+            //         service: "sap.ushell.services.appLifeCycle",
+            //         action: "create"
+            //     },
+            //     {
+            //         service: "sap.ushell.services.appLifeCycle",
+            //         action: "destroy"
+            //     }]);
+            // if (oBlueBoxContainer[oAppContainer].appCapabilities.hasOwnProperty("statefulContainer")) {
+            //     oBlueBoxContainer[oAppContainer].appCapabilities.statefulContainer = true;
+            // }
+            //
+            // var sUrl = oAppContainer.getCurrentAppUrl();
+            // var sKey = BlueBoxesCache.getBlueBoxCacheKeyValues(sUrl.replaceAll("sap-keep-alive", "sap-temp")).sKey;
+            // var oHostMainContainer = BlueBoxesCache.get(sKey);
+            // if (oHostMainContainer) {
+            //     //If we're here, it means that there's already a stateful container Iframe and we need to push
+            //     //this oAppContainer to the keep alive pull container.
+            //     var oDetails = oBlueBoxContainer[oAppContainer];
+            //     BlueBoxesCache.add(sUrl.replaceAll("sap-keep-alive", "sap-temp"), oAppContainer, oDetails);
+            //     this.delete(sUrl);
+            // } else {
+            //     //If we're - it means that there's NOT a stateful container Iframe and we need to convert
+            //     //this oAppContainer to be the stateful container Iframe.
+            //
+            //     //Before storing, first delete the entry from oCacheStorage only
+            //     BlueBoxesCache.remove(sUrl);
+            //     //Now, store it as a stateful container entry
+            //     BlueBoxesCache.add(sUrl.replaceAll("sap-keep-alive", "sap-temp"), oAppContainer);
+            // }
+            // oAppContainer.setProperty("currentAppUrl", "", true);
+            // oAppContainer.setProperty("isFetchedFromCache", false, true);
+            //
+            // return true;
+        };
+
+        this.changeAppContainerToKeepAlive = function (oAppContainer) {
+        };
+
+        this.isOldVersionOfLegacyApp = function () {
+            return false;
+        };
+
+        this.isWebGuiV1StatefulContainer = function (sUrl) {
+            var sKey;
+
+            if (sUrl) {
+                sKey = this._getBlueBoxCacheKey(sUrl);
+                return (oGuiV1BlueBoxContainer[sKey] !== undefined);
+            }
+            return false;
+        };
+
+        this.getWebGuiV1StatefulContainer = function (sUrl) {
+            var sKey;
+
+            if (sUrl) {
+                sKey = this._getBlueBoxCacheKey(sUrl);
+                return oGuiV1BlueBoxContainer[sKey];
+            }
+            return undefined;
+        };
+
+        this.setWebGuiV1StatefulContainer = function (oApplicationContainer) {
+            var sUrl = oApplicationContainer.getUrl(),
+                sKey;
+
+            if (sUrl) {
+                sKey = this._getBlueBoxCacheKey(sUrl);
+                oGuiV1BlueBoxContainer[sKey] = oApplicationContainer;
+            }
+        };
+
+        this.removeWebGuiV1StatefulContainer = function (oApplicationContainer) {
+            var sUrl = oApplicationContainer.getUrl(),
+                sKey;
+
+            if (sUrl) {
+                sKey = this._getBlueBoxCacheKey(sUrl);
+                delete oGuiV1BlueBoxContainer[sKey];
+            }
+        };
+
+        /**
+         * Finds and returns all existing application containers.
+         *
+         * @param {object} oGuiV1BlueBoxContainer
+         *  All stateful application containers
+         *
+         * @return {array}
+         *  An array containing all the application container objects.
+         */
+        this.getWebGuiV1AllApplicationContainers = function () {
+            return Object.keys(oGuiV1BlueBoxContainer).map(function (sKey) {
+                return oGuiV1BlueBoxContainer[sKey];
+            }).filter(function (oApplicationContainer) {
+                return !!oApplicationContainer;
+            });
+        };
+
+        this._getStorageForDebug = function () {
+            return {
+                oBlueBoxContainer: oBlueBoxContainer,
+                oGuiV1BlueBoxContainer: oGuiV1BlueBoxContainer,
+                oBlueBoxesCache: BlueBoxesCache._getStorageForDebug()
+            };
+        };
     }
 
     return new BlueBoxHandler();