You can not select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
		
			
		
			
				
					
					
						
							219 lines
						
					
					
						
							6.7 KiB
						
					
					
				
			
		
		
	
	
							219 lines
						
					
					
						
							6.7 KiB
						
					
					
				
 | 
						|
/* | 
						|
* Licensed to the Apache Software Foundation (ASF) under one | 
						|
* or more contributor license agreements.  See the NOTICE file | 
						|
* distributed with this work for additional information | 
						|
* regarding copyright ownership.  The ASF licenses this file | 
						|
* to you under the Apache License, Version 2.0 (the | 
						|
* "License"); you may not use this file except in compliance | 
						|
* with the License.  You may obtain a copy of the License at | 
						|
* | 
						|
*   http://www.apache.org/licenses/LICENSE-2.0 | 
						|
* | 
						|
* Unless required by applicable law or agreed to in writing, | 
						|
* software distributed under the License is distributed on an | 
						|
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | 
						|
* KIND, either express or implied.  See the License for the | 
						|
* specific language governing permissions and limitations | 
						|
* under the License. | 
						|
*/ | 
						|
 | 
						|
var zrUtil = require("zrender/lib/core/util"); | 
						|
 | 
						|
var _clazz = require("./clazz"); | 
						|
 | 
						|
var parseClassType = _clazz.parseClassType; | 
						|
 | 
						|
/* | 
						|
* Licensed to the Apache Software Foundation (ASF) under one | 
						|
* or more contributor license agreements.  See the NOTICE file | 
						|
* distributed with this work for additional information | 
						|
* regarding copyright ownership.  The ASF licenses this file | 
						|
* to you under the Apache License, Version 2.0 (the | 
						|
* "License"); you may not use this file except in compliance | 
						|
* with the License.  You may obtain a copy of the License at | 
						|
* | 
						|
*   http://www.apache.org/licenses/LICENSE-2.0 | 
						|
* | 
						|
* Unless required by applicable law or agreed to in writing, | 
						|
* software distributed under the License is distributed on an | 
						|
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | 
						|
* KIND, either express or implied.  See the License for the | 
						|
* specific language governing permissions and limitations | 
						|
* under the License. | 
						|
*/ | 
						|
var base = 0; | 
						|
/** | 
						|
 * @public | 
						|
 * @param {string} type | 
						|
 * @return {string} | 
						|
 */ | 
						|
 | 
						|
function getUID(type) { | 
						|
  // Considering the case of crossing js context, | 
						|
  // use Math.random to make id as unique as possible. | 
						|
  return [type || '', base++, Math.random().toFixed(5)].join('_'); | 
						|
} | 
						|
/** | 
						|
 * @inner | 
						|
 */ | 
						|
 | 
						|
 | 
						|
function enableSubTypeDefaulter(entity) { | 
						|
  var subTypeDefaulters = {}; | 
						|
 | 
						|
  entity.registerSubTypeDefaulter = function (componentType, defaulter) { | 
						|
    componentType = parseClassType(componentType); | 
						|
    subTypeDefaulters[componentType.main] = defaulter; | 
						|
  }; | 
						|
 | 
						|
  entity.determineSubType = function (componentType, option) { | 
						|
    var type = option.type; | 
						|
 | 
						|
    if (!type) { | 
						|
      var componentTypeMain = parseClassType(componentType).main; | 
						|
 | 
						|
      if (entity.hasSubTypes(componentType) && subTypeDefaulters[componentTypeMain]) { | 
						|
        type = subTypeDefaulters[componentTypeMain](option); | 
						|
      } | 
						|
    } | 
						|
 | 
						|
    return type; | 
						|
  }; | 
						|
 | 
						|
  return entity; | 
						|
} | 
						|
/** | 
						|
 * Topological travel on Activity Network (Activity On Vertices). | 
						|
 * Dependencies is defined in Model.prototype.dependencies, like ['xAxis', 'yAxis']. | 
						|
 * | 
						|
 * If 'xAxis' or 'yAxis' is absent in componentTypeList, just ignore it in topology. | 
						|
 * | 
						|
 * If there is circle dependencey, Error will be thrown. | 
						|
 * | 
						|
 */ | 
						|
 | 
						|
 | 
						|
function enableTopologicalTravel(entity, dependencyGetter) { | 
						|
  /** | 
						|
   * @public | 
						|
   * @param {Array.<string>} targetNameList Target Component type list. | 
						|
   *                                           Can be ['aa', 'bb', 'aa.xx'] | 
						|
   * @param {Array.<string>} fullNameList By which we can build dependency graph. | 
						|
   * @param {Function} callback Params: componentType, dependencies. | 
						|
   * @param {Object} context Scope of callback. | 
						|
   */ | 
						|
  entity.topologicalTravel = function (targetNameList, fullNameList, callback, context) { | 
						|
    if (!targetNameList.length) { | 
						|
      return; | 
						|
    } | 
						|
 | 
						|
    var result = makeDepndencyGraph(fullNameList); | 
						|
    var graph = result.graph; | 
						|
    var stack = result.noEntryList; | 
						|
    var targetNameSet = {}; | 
						|
    zrUtil.each(targetNameList, function (name) { | 
						|
      targetNameSet[name] = true; | 
						|
    }); | 
						|
 | 
						|
    while (stack.length) { | 
						|
      var currComponentType = stack.pop(); | 
						|
      var currVertex = graph[currComponentType]; | 
						|
      var isInTargetNameSet = !!targetNameSet[currComponentType]; | 
						|
 | 
						|
      if (isInTargetNameSet) { | 
						|
        callback.call(context, currComponentType, currVertex.originalDeps.slice()); | 
						|
        delete targetNameSet[currComponentType]; | 
						|
      } | 
						|
 | 
						|
      zrUtil.each(currVertex.successor, isInTargetNameSet ? removeEdgeAndAdd : removeEdge); | 
						|
    } | 
						|
 | 
						|
    zrUtil.each(targetNameSet, function () { | 
						|
      throw new Error('Circle dependency may exists'); | 
						|
    }); | 
						|
 | 
						|
    function removeEdge(succComponentType) { | 
						|
      graph[succComponentType].entryCount--; | 
						|
 | 
						|
      if (graph[succComponentType].entryCount === 0) { | 
						|
        stack.push(succComponentType); | 
						|
      } | 
						|
    } // Consider this case: legend depends on series, and we call | 
						|
    // chart.setOption({series: [...]}), where only series is in option. | 
						|
    // If we do not have 'removeEdgeAndAdd', legendModel.mergeOption will | 
						|
    // not be called, but only sereis.mergeOption is called. Thus legend | 
						|
    // have no chance to update its local record about series (like which | 
						|
    // name of series is available in legend). | 
						|
 | 
						|
 | 
						|
    function removeEdgeAndAdd(succComponentType) { | 
						|
      targetNameSet[succComponentType] = true; | 
						|
      removeEdge(succComponentType); | 
						|
    } | 
						|
  }; | 
						|
  /** | 
						|
   * DepndencyGraph: {Object} | 
						|
   * key: conponentType, | 
						|
   * value: { | 
						|
   *     successor: [conponentTypes...], | 
						|
   *     originalDeps: [conponentTypes...], | 
						|
   *     entryCount: {number} | 
						|
   * } | 
						|
   */ | 
						|
 | 
						|
 | 
						|
  function makeDepndencyGraph(fullNameList) { | 
						|
    var graph = {}; | 
						|
    var noEntryList = []; | 
						|
    zrUtil.each(fullNameList, function (name) { | 
						|
      var thisItem = createDependencyGraphItem(graph, name); | 
						|
      var originalDeps = thisItem.originalDeps = dependencyGetter(name); | 
						|
      var availableDeps = getAvailableDependencies(originalDeps, fullNameList); | 
						|
      thisItem.entryCount = availableDeps.length; | 
						|
 | 
						|
      if (thisItem.entryCount === 0) { | 
						|
        noEntryList.push(name); | 
						|
      } | 
						|
 | 
						|
      zrUtil.each(availableDeps, function (dependentName) { | 
						|
        if (zrUtil.indexOf(thisItem.predecessor, dependentName) < 0) { | 
						|
          thisItem.predecessor.push(dependentName); | 
						|
        } | 
						|
 | 
						|
        var thatItem = createDependencyGraphItem(graph, dependentName); | 
						|
 | 
						|
        if (zrUtil.indexOf(thatItem.successor, dependentName) < 0) { | 
						|
          thatItem.successor.push(name); | 
						|
        } | 
						|
      }); | 
						|
    }); | 
						|
    return { | 
						|
      graph: graph, | 
						|
      noEntryList: noEntryList | 
						|
    }; | 
						|
  } | 
						|
 | 
						|
  function createDependencyGraphItem(graph, name) { | 
						|
    if (!graph[name]) { | 
						|
      graph[name] = { | 
						|
        predecessor: [], | 
						|
        successor: [] | 
						|
      }; | 
						|
    } | 
						|
 | 
						|
    return graph[name]; | 
						|
  } | 
						|
 | 
						|
  function getAvailableDependencies(originalDeps, fullNameList) { | 
						|
    var availableDeps = []; | 
						|
    zrUtil.each(originalDeps, function (dep) { | 
						|
      zrUtil.indexOf(fullNameList, dep) >= 0 && availableDeps.push(dep); | 
						|
    }); | 
						|
    return availableDeps; | 
						|
  } | 
						|
} | 
						|
 | 
						|
exports.getUID = getUID; | 
						|
exports.enableSubTypeDefaulter = enableSubTypeDefaulter; | 
						|
exports.enableTopologicalTravel = enableTopologicalTravel; |