html5/services/amd/index.js

/*
 * 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.
 */

/**
 * @fileOverview
 * A simple implementation of AMD for weex.
 */

/**
 * amd modules (<id, module> pair)
 *  - id : instance id.
 *  - module: {
 *        name: module name
 *        , factory: module's factory function
 *        , cached: cached module,
 *        , deps: module's dependencies, always be [] under most circumstances.
 *      }
 */
const modules = {}

const amdService = {

  // create a amd service.
  create: (id, env, config) => {
    if (!env.framework.match(/Vue/i)) {
      return
    }

    const mod = {}
    modules[id] = mod
    const amdObject = {

      /**
       * define a module.
       * @param  {String} name: module name.
       * @param  {Array} deps: dependencies. Always be empty array.
       * @param  {function} factory: factory function.
       */
      define (name, deps, factory) {
        if (mod[name]) {
          console.warn(`[amdService] already defined module: '${name}'`)
        }
        if (typeof deps === 'function') {
          factory = deps
          deps = []
        }
        mod[name] = { name, factory, cached: false, deps }
      },

      /**
       * require a module.
       * @param  {string} name - module name.
       */
      require (name) {
        const servMod = mod[name]
        if (!servMod) {
          return console.warn(`[amdService] module '${name}' is not defined.`)
        }
        if (servMod.cached) {
          return servMod.cached
        }
        const exports = {}
        const module = { exports }
        const { deps } = servMod
        let ret
        if (deps && deps.length >= 1) {
          /**
           * to support:
           *   define(name, ['foo', 'bar'], function (foo, bar) { ... })
           */
          const args = deps.map(depName => require(depName))
          ret = servMod.factory(...args)
        }
        else {
          ret = servMod.factory(amdObject.require, exports, module)
        }
        servMod.cached = ret || module.exports
        return servMod.cached
      }
    }
    return { instance: amdObject }
  },

  destroy: (id, env) => {
    delete modules[id]
  }
}

export default amdService