Agent

代理模式：将函数调用转化为配置模式

#关于Agent

Agent 是专门针对构造函数或单例的代理模式包装策略，支持 ie6 +。

它根据传入的构造函数与初始化参数，得到其实例instance，并返回一个代理函数。

代理函数接受一个对象options作为参数，针对options对象的每一个属性prop， 代理函数的处理规则如下：

1、如果instance[prop]不是一个函数，则有：

instance[prop] = options[prop]

2、如果instance[prop]是一个函数，则分三种情形：

2.1、options[prop]为非数组：

instance[prop](options[prop])

2.2、options[prop]为数组：

2.2.1、数组的长度大于等于2，且数据类型相同，则视为多次调用

for (var i = 0, len = options[prop].length; i < len; i += 1) {
    instance[prop][isArray(options[prop][i]) ? 'apply' : 'call'](instance, options[prop][i])
}

2.2.2、数组长度小于2，或者大于2却不是相同数据类型，则为普通调用

instance[prop].apply(instance, options[prop])

注意：也可以将多个options打包成数组，传入代理函数，将在内部遍历调用

了解javascript中的原型继承的人都知道，instance[prop]可以是原型对象中的方法

#API介绍

Anget支持amd与cmd以及commonJs模块规范，如果三者都无，则作为全局变量agent。

如果window.$$为undefined，Angent将赋值给它，占用两个全局变量

test.html中包含了Agnet的大多数用法，如下：

(function() {


        //test jQuery
        //$$ 或 agent 返回代理函数
        //第一个参数为构造函数或单例对象
        //第二或之后的参数，为构造函数的参数
        //如要代理 $('.item')，形式如下

        var $item = $$($, '.item')

        //下面这种形式也可以，上面为快捷方式
/*        var $item = $('.item')
        $item = $$($item)*/


        var items_settings = {

            prepend: '测试代理jQuery实例，调用text、css以及animate方法',
            //数组形式，长度大于1， 为同一数据类型，即视为多次调用
            append: ['<div>多次调用</div>', '<div>多次调用</div>', '<div>多次调用</div>', '<div>多次调用</div>'],

            css: {
                'color': '#f00'
            },

            animate: {
                'line-height': '30px'
            }

        }

        $item(items_settings)

        $item([
            {append: '多个options形式<br>'},
            {append: '多个options形式<br>'},
            {append: '多个options形式<br>'},
            {append: '多个options形式<br>'},
            {append: '多个options形式<br>'},
            ])


        //test seajs

        //seajs 是单例，可以直接用代理函数覆盖它

        seajs = $$(seajs)

        var seajs_settings = {
            //相当于调用 seajs.config()
            config: {
                alias: {
                    'test': './test-seajs'
                }
            },
            //相当于调用 seajs.use
            use: ['test', function(data) {

                setTimeout(function() {
                    $item({
                        append: data
                    })
                }, 1000)

            }]
        }

        seajs(seajs_settings)

        //可以通过以下方式返回 agent 所代理的实例对象
/*        console.log(seajs)
        seajs = seajs()
        console.log(seajs)*/

        //test 自定义构造函数

        function Person(name, age) {
            this.name = name
            this.age = age
        }

        Person.prototype = {
            say: function(words) {

                console.log(words || this.name)
            },
            sing: function(song) {
                console.log('singing ' + song)
            },
            grow: function(age) {
                this.age = age || this.age
                console.log('My age now is ' + this.age)
            }
        }

        var person = $$(Person, 'Jade', '24')

        person({

            say: '我不会被say，因为下面有个say覆盖了我',

            sing: ['月亮代表我的心', '歌曲1', '歌曲2', '歌曲3', '歌曲4', '歌曲5'],

            grow: 25,

            //添加新属性
            job: 'FE',

            //添加新方法
            jump: function(high) {
                console.log('跳了' + high + '米')
            },

            //如果现有的或原型上的属性为函数，不会覆盖
            //只会调用，并将新的值作为参数传入
            say: function() {
                'say函数已经存在，我将被作为参数传入，在控制台被输出'
            }
        })

        //不管传参与否，代理函数每次都返回其所带里的实例
        //随时可以通过赋值，找回实例，并按照以前的风格使用
        console.log(person())


        //test dom对象

        var btn = $$(document.getElementById('btn'))

        btn({

            onclick: function() {
                console.log('测试原生DOM对象')
            },

            style: {
                background: '#f00',
                width: '200px'
            },

            title: '一个普通title'

        })

        btn.alias.parse('style:stl; alt: name;')

        btn({
            stl: {
                color:'#000'
            },
            name: 'test'
        })


        //test alias 别名
        var $btn = $$(jQuery, '#btn')

        $btn.alias.parse($btn().attr('js'))

        $btn({
            word: 'test alias',
            sibling: '<p>btn的兄弟元素</p>',
            style: {
                color:'green',
                background: '#eaeaea'
            }
        })

        console.dir($btn)


    }())