@openui5/sap.ui.core 1.136.4 → 1.139.0

package/src/sap/ui/core/routing/async/TargetCache.js

@@ -1,196 +0,0 @@
-/*!
- * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
- * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
- */
-sap.ui.define([
-	"sap/ui/core/mvc/View",
-	"sap/ui/core/Component",
-	"sap/ui/core/routing/HashChanger"
-], function(View, Component, HashChanger) {
-	"use strict";
-
-	/**
-	 * Provide methods for sap.ui.core.routing.TargetCache in async mode
-	 * @private
-	 * @since 1.58
-	 */
-	return {
-
-		/**
-		 * Determines the object with the given <code>oOptions</code>, <code>sType</code> and <code>oTargetCreateInfo</code>
-		 *
-		 * @param {object} oOptions The options of the desired object
-		 * @param {string} sType The type of the desired object, e.g. 'View', 'Component', etc.
-		 * @param {object} oTargetCreateInfo The object which contains extra information for the creation of the target
-		 * @param {boolean} [bSynchronousCreate] When <code>true</code> the <code>View._create</code> is used for creating
-		 *  the view instance synchronously. In all other cases the asynchronous <code>View.create</code> factory is used.
-		 * @returns {Promise | object} The desired object, if the object already exists in the cache, if not the promise is returned
-		 * @private
-		 * @ui5-transform-hint replace-param bSynchronousCreate false
-		 */
-		_getObjectWithGlobalId : function (oOptions, sType, oTargetCreateInfo, bSynchronousCreate, bNoCreate) {
-			var that = this,
-				vPromiseOrObject,
-				sName,
-				oInstanceCache,
-				oOwnerComponent = this._oComponent,
-				aWrittenIds = [];
-
-			oTargetCreateInfo = oTargetCreateInfo || {};
-
-			function fnCreateObjectAsync() {
-				/**
-				 * @ui5-transform-hint replace-local false
-				 */
-				const bLegacyCreate = !oOptions.async || bSynchronousCreate;
-
-				switch (sType) {
-					case "View":
-						oOptions.viewName = oOptions.name;
-						delete oOptions.name;
-						if (bLegacyCreate) {
-							return View._create(oOptions);
-						} else {
-							return View.create(oOptions);
-						}
-					case "Component":
-						oOptions.settings = oOptions.settings || {};
-
-						// forward info, if parent component expects title propagation
-						oOptions.settings._propagateTitle = oTargetCreateInfo.propagateTitle;
-
-						// create the RouterHashChanger for the component which is going to be created
-						var oRouterHashChanger = that._createRouterHashChanger(oTargetCreateInfo.prefix);
-						if (oRouterHashChanger) {
-							// put the RouterHashChanger as a private property to the Component constructor
-							oOptions.settings._routerHashChanger = oRouterHashChanger;
-						}
-
-						if (oOptions.usage) {
-							return oOwnerComponent.createComponent(oOptions);
-						} else {
-							return Component.create(oOptions);
-						}
-					default:
-						// do nothing
-				}
-			}
-
-			function afterLoaded(oObject) {
-				if (that._oCache) { // the TargetCache may already be destroyed
-					aWrittenIds.forEach(function(sId) {
-						oInstanceCache[sId] = oObject;
-					});
-
-					if (oTargetCreateInfo.afterCreate) {
-						oTargetCreateInfo.afterCreate(oObject);
-					}
-
-					that.fireCreated({
-						object: oObject,
-						type: sType,
-						options: oOptions
-					});
-				}
-
-				return oObject;
-			}
-
-			if (oOptions.async === undefined) {
-				oOptions.async = true;
-			}
-
-			sName = oOptions.usage || oOptions.name;
-			this._checkName(sName, sType);
-
-			oInstanceCache = this._oCache[sType.toLowerCase()][sName];
-
-			vPromiseOrObject = oInstanceCache && oInstanceCache[oOptions.id];
-
-			if (bNoCreate || vPromiseOrObject) {
-				return vPromiseOrObject;
-			}
-
-			if (oOwnerComponent) {
-				vPromiseOrObject = oOwnerComponent.runAsOwner(fnCreateObjectAsync);
-
-				if (vPromiseOrObject instanceof Promise) {
-					oOwnerComponent.registerForDestroy(vPromiseOrObject);
-				}
-			} else {
-				vPromiseOrObject = fnCreateObjectAsync();
-			}
-
-			if (vPromiseOrObject instanceof Promise) {
-				vPromiseOrObject = vPromiseOrObject.then(afterLoaded);
-			} else {
-				vPromiseOrObject.loaded().then(afterLoaded);
-			}
-
-			if (!oInstanceCache) {
-				oInstanceCache = this._oCache[sType.toLowerCase()][sName] = {};
-				// save the object also to the undefined key if this is the first object created for its class
-				oInstanceCache[undefined] = vPromiseOrObject;
-				aWrittenIds.push(undefined);
-			}
-
-			if (oOptions.id !== undefined) {
-				oInstanceCache[oOptions.id] = vPromiseOrObject;
-				aWrittenIds.push(oOptions.id);
-			}
-
-			return vPromiseOrObject;
-		},
-
-		/**
-		 * Determines the view with the given <code>oOptions</code>
-		 *
-		 * @param {object} oOptions The options of the desired object
-		 * @param {boolean} [bSynchronousCreate] When <code>true</code> the <code>View._create</code> is used for creating
-		 *  the view instance synchronously. In all other cases the asynchronous <code>View.create</code> factory is used.
-		 * @returns {Promise | object} The desired object, if the object already exists in the cache, if not the promise is returned
-		 * @private
-		 * @ui5-transform-hint replace-param bSynchronousCreate false
-		 */
-		_getViewWithGlobalId : function (oOptions, bSynchronousCreate, bNoCreate) {
-			if (oOptions && !oOptions.name) {
-				oOptions.name = oOptions.viewName;
-			}
-			return this._getObjectWithGlobalId(oOptions, "View", undefined, bSynchronousCreate, bNoCreate);
-		},
-
-		/**
-		 * Determines the component with the given <code>oOptions</code> and <code>oTargetCreateInfo</code>
-		 *
-		 * @param {object} oOptions The options of the desired object
-		 * @param {object} oTargetCreateInfo The object which contains extra information for the creation of the target
-		 * @returns {Promise | object} The desired object, if the object already exists in the cache, if not the promise is returned
-		 * @private
-		 */
-		_getComponentWithGlobalId : function(oOptions, oTargetCreateInfo, bNoCreate) {
-			return this._getObjectWithGlobalId(oOptions, "Component", oTargetCreateInfo, bNoCreate);
-		},
-
-		/**
-		 * Creates a new hash changer for the nested component
-		 *
-		 * @param {string} [sPrefix] The prefix of the target
-		 * @returns {sap.ui.core.routing.HashChanger} The created sub hash changer, if creation was not possible the hash changer of the current component is returned
-		 * @private
-		 */
-		_createRouterHashChanger: function(sPrefix) {
-			var oRouterHashChanger;
-
-			var oRouter = this._oComponent && this._oComponent.getRouter();
-			if (oRouter) {
-				oRouterHashChanger = oRouter.getHashChanger();
-				if (oRouterHashChanger && sPrefix) {
-					oRouterHashChanger = oRouterHashChanger.createSubHashChanger(sPrefix);
-				}
-			}
-			// default to the root RouterHashChanger
-			return oRouterHashChanger || HashChanger.getInstance().createRouterHashChanger();
-		}
-	};
-});

package/src/sap/ui/core/routing/async/Targets.js

@@ -1,130 +0,0 @@
-/*!
- * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
- * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
- */
-sap.ui.define(["sap/base/future"], function(future) {
-	"use strict";
-
-	/**
-	 * Provide methods for sap.ui.core.routing.Targets in async mode
-	 * @private
-	 * @since 1.33
-	 */
-	return {
-		/**
-		 * Creates a view and puts it in an aggregation of the specified control.
-		 *
-		 * @param {string|string[]|object|object[]} vTargets the key of the target as specified in the {@link #constructor}. To display multiple targets you may also pass an array of keys. If the target(s) represents a sap.ui.core.UIComponent, a prefix for its Router is needed. You can set this parameter with an object which has the 'name' property set with the key of the target and the 'prefix' property set with the prefix for the UIComponent's router. To display multiple component targets, you man also pass an array of objects.
-		 * @param {object} [vData] an object that will be passed to the display event in the data property. If the target has parents, the data will also be passed to them.
-		 * @param {string} [sTitleTarget] the name of the target from which the title option is taken for firing the {@link sap.ui.core.routing.Targets#event:titleChanged titleChanged} event
-		 * @private
-		 * @returns {Promise} resolving with {{name: *, view: *, control: *}|undefined} for every vTargets, object for single, array for multiple
-		 */
-		display : function (vTargets, vData, sTitleTarget) {
-			var oSequencePromise = Promise.resolve();
-			return this._display(vTargets, vData, sTitleTarget, oSequencePromise);
-		},
-
-		/**
-		 * Hook to distinguish between the router and an application calling this
-		 *
-		 * @param {string|string[]|object|object[]} vTargets targets or single target to be displayed
-		 * @param {object} vData  an object that will be passed to the display event in the data property. If the
-				target has parents, the data will also be passed to them.
-		 * @param {string} sTitleTarget the name of the target from which the title option is taken for firing the {@link sap.ui.core.routing.Targets#event:titleChanged titleChanged} event
-		 * @param {Promise} oSequencePromise the promise for chaining
-		 * @return {Promise} resolving with {{name: *, view: *, control: *}|undefined} for every vTargets, object for single, array for multiple
-		 *
-		 * @private
-		 */
-		_display : function (vTargets, vData, sTitleTarget, oSequencePromise) {
-			var that = this,
-				aViewInfos = [];
-
-			if (!Array.isArray(vTargets)) {
-				vTargets = [vTargets];
-			}
-
-			this._attachTitleChanged(vTargets, sTitleTarget);
-
-			return this._alignTargetsInfo(vTargets).reduce(function(oPromise, oTargetInfo) {
-				var oTargetCreateInfo = {
-					prefix: oTargetInfo.prefix,
-					propagateTitle: oTargetInfo.propagateTitle || false,
-					ignoreInitialHash: oTargetInfo.ignoreInitialHash,
-					placeholder: oTargetInfo.placeholder,
-					repeatedRoute: oTargetInfo.repeatedRoute,
-					routeRelevant: oTargetInfo.routeRelevant || false
-				};
-
-				// gather view infos while processing Promise chain
-				return that._displaySingleTarget(oTargetInfo, vData, oPromise, oTargetCreateInfo).then(function(oViewInfo) {
-					oViewInfo = oViewInfo || {};
-					oViewInfo.targetInfo = oTargetInfo;
-					aViewInfos.push(oViewInfo);
-				});
-			}, oSequencePromise).then(function() {
-				return aViewInfos;
-			});
-		},
-
-		/**
-		 * Adds a target to the route's config
-		 * @param {object} oTargetInfo the object containing information about the single target
-		 * @private
-		 */
-		_addDynamicTargetToRoute : function(oTargetInfo) {
-			if (this._oRouter) {
-				var sRouteToConnect = this._oRouter._getLastMatchedRouteName();
-				var oRoute, bSameTargetFound;
-
-				if (sRouteToConnect) {
-					oRoute = this._oRouter.getRoute(sRouteToConnect);
-
-					if (oRoute && oRoute._oConfig && oRoute._oConfig.target) {
-						bSameTargetFound = this._alignTargetsInfo(oRoute._oConfig.target).some(function(oCompareTargetInfo) {
-							return oCompareTargetInfo.name === oTargetInfo.name;
-						});
-
-						if (!bSameTargetFound) {
-							oRoute._oConfig.dynamicTarget = oRoute._oConfig.dynamicTarget || [];
-							oRoute._oConfig.dynamicTarget.push(oTargetInfo);
-						}
-					}
-				}
-			}
-		},
-
-		/**
-		 * Displays a single target
-		 *
-		 * @param {object} oTargetInfo the object containing information (e.g. name) about the single target
-		 * @param {any} vData an object that will be passed to the display event in the data property.
-		 * @param {Promise} oSequencePromise the promise which for chaining
-		 * @param {object} [oTargetCreateInfo] the object which contains extra information for the creation of the target
-		 * @param {function} [oTargetCreateInfo.afterCreate] the function which is called after a target View/Component is instantiated
-		 * @param {string} [oTargetCreateInfo.prefix] the prefix which will be used by the RouterHashChanger of the target
-		 * @returns {Promise} Resolves with {name: *, view: *, control: *} if the target can be successfully displayed otherwise it rejects with error information
-		 * @private
-		 */
-		_displaySingleTarget : function (oTargetInfo, vData, oSequencePromise, oTargetCreateInfo) {
-			var sName = oTargetInfo.name,
-				oTarget = this.getTarget(sName);
-
-			if (oTarget !== undefined) {
-				if (oTargetInfo.routeRelevant) {
-					this._addDynamicTargetToRoute(oTargetInfo);
-				}
-				return oTarget._display(vData, oSequencePromise, oTargetCreateInfo);
-			} else {
-				var sErrorMessage = `${this}: The target with the name "${sName}" does not exist!`;
-				future.errorThrows(sErrorMessage);
-				return Promise.resolve({
-					name: sName,
-					error: sErrorMessage
-				});
-			}
-		}
-	};
-});