JavaScript S.O.L.I.D五大原則之單一職責(zé)SRP

2018-07-28 16:43 更新

前言

Bob大叔提出并發(fā)揚(yáng)了S.O.L.I.D五大原則,用來(lái)更好地進(jìn)行面向?qū)ο缶幊?,五大原則分別是:

  1. The Single Responsibility Principle(單一職責(zé)SRP)
  2. The Open/Closed Principle(開(kāi)閉原則OCP)
  3. The Liskov Substitution Principle(里氏替換原則LSP)
  4. The Interface Segregation Principle(接口分離原則ISP)
  5. The Dependency Inversion Principle(依賴反轉(zhuǎn)原則DIP)

五大原則,我相信在博客園已經(jīng)被討論爛了,尤其是C#的實(shí)現(xiàn),但是相對(duì)于JavaScript這種以原型為base的動(dòng)態(tài)類型語(yǔ)言來(lái)說(shuō)還為數(shù)不多,該系列將分5篇文章以JavaScript編程語(yǔ)言為基礎(chǔ)來(lái)展示五大原則的應(yīng)用。 OK,開(kāi)始我們的第一篇:?jiǎn)我宦氊?zé)。

英文原文:http://freshbrewedcode.com/derekgreer/2011/12/08/solid-javascript-single-responsibility-principle/

單一職責(zé)

單一職責(zé)的描述如下:

A class should have only one reason to change
類發(fā)生更改的原因應(yīng)該只有一個(gè)

一個(gè)類(JavaScript下應(yīng)該是一個(gè)對(duì)象)應(yīng)該有一組緊密相關(guān)的行為的意思是什么?遵守單一職責(zé)的好處是可以讓我們很容易地來(lái)維護(hù)這個(gè)對(duì)象,當(dāng)一個(gè)對(duì)象封裝了很多職責(zé)的話,一旦一個(gè)職責(zé)需要修改,勢(shì)必會(huì)影響該對(duì)象想的其它職責(zé)代碼。通過(guò)解耦可以讓每個(gè)職責(zé)工更加有彈性地變化。

不過(guò),我們?nèi)绾沃酪粋€(gè)對(duì)象的多個(gè)行為構(gòu)造多個(gè)職責(zé)還是單個(gè)職責(zé)?我們可以通過(guò)參考Object Design: Roles, Responsibilies, and Collaborations一書(shū)提出的Role Stereotypes概念來(lái)決定,該書(shū)提出了如下Role Stereotypes來(lái)區(qū)分職責(zé):

  1. Information holder – 該對(duì)象設(shè)計(jì)為存儲(chǔ)對(duì)象并提供對(duì)象信息給其它對(duì)象。
  2. Structurer – 該對(duì)象設(shè)計(jì)為維護(hù)對(duì)象和信息之間的關(guān)系
  3. Service provider – 該對(duì)象設(shè)計(jì)為處理工作并提供服務(wù)給其它對(duì)象
  4. Controller – 該對(duì)象設(shè)計(jì)為控制決策一系列負(fù)責(zé)的任務(wù)處理
  5. Coordinator – 該對(duì)象不做任何決策處理工作,只是delegate工作到其它對(duì)象上
  6. Interfacer – 該對(duì)象設(shè)計(jì)為在系統(tǒng)的各個(gè)部分轉(zhuǎn)化信息(或請(qǐng)求)

一旦你知道了這些概念,那就狠容易知道你的代碼到底是多職責(zé)還是單一職責(zé)了。

實(shí)例代碼

該實(shí)例代碼演示的是將商品添加到購(gòu)物車(chē),代碼非常糟糕,代碼如下:

function Product(id, description) {
    this.getId = function () {
        return id;
    };
    this.getDescription = function () {
        return description;
    };
}

function Cart(eventAggregator) {
    var items = [];

    this.addItem = function (item) {
        items.push(item);
    };
}

(function () {
    var products = [new Product(1, "Star Wars Lego Ship"),
            new Product(2, "Barbie Doll"),
            new Product(3, "Remote Control Airplane")],
cart = new Cart();

    function addToCart() {
        var productId = $(this).attr('id');
        var product = $.grep(products, function (x) {
            return x.getId() == productId;
        })[0];
        cart.addItem(product);

        var newItem = $('<li></li>').html(product.getDescription()).attr('id-cart', product.getId()).appendTo("#cart");
    }

    products.forEach(function (product) {
        var newItem = $('<li></li>').html(product.getDescription())
                                    .attr('id', product.getId())
                                    .dblclick(addToCart)
                                    .appendTo("#products");
    });
})();

該代碼聲明了2個(gè)function分別用來(lái)描述product和cart,而匿名函數(shù)的職責(zé)是更新屏幕和用戶交互,這還不是一個(gè)很復(fù)雜的例子,但匿名函數(shù)里卻包含了很多不相關(guān)的職責(zé),讓我們來(lái)看看到底有多少職責(zé):

  1. 首先,有product的集合的聲明
  2. 其次,有一個(gè)將product集合綁定到#product元素的代碼,而且還附件了一個(gè)添加到購(gòu)物車(chē)的事件處理
  3. 第三,有Cart購(gòu)物車(chē)的展示功能
  4. 第四,有添加product item到購(gòu)物車(chē)并顯示的功能

重構(gòu)代碼

讓我們來(lái)分解一下,以便代碼各自存放到各自的對(duì)象里,為此,我們參考了martinfowler的事件聚合(Event Aggregator)理論在處理代碼以便各對(duì)象之間進(jìn)行通信。

首先我們先來(lái)實(shí)現(xiàn)事件聚合的功能,該功能分為2部分,1個(gè)是Event,用于Handler回調(diào)的代碼,1個(gè)是EventAggregator用來(lái)訂閱和發(fā)布Event,代碼如下:

        function Event(name) {
            var handlers = [];

            this.getName = function () {
                return name;
            };

            this.addHandler = function (handler) {
                handlers.push(handler);
            };

            this.removeHandler = function (handler) {
                for (var i = 0; i < handlers.length; i++) {
                    if (handlers[i] == handler) {
                        handlers.splice(i, 1);
                        break;
                    }
                }
            };

            this.fire = function (eventArgs) {
                handlers.forEach(function (h) {
                    h(eventArgs);
                });
            };
        }

        function EventAggregator() {
            var events = [];

            function getEvent(eventName) {
                return $.grep(events, function (event) {
                    return event.getName() === eventName;
                })[0];
            }

            this.publish = function (eventName, eventArgs) {
                var event = getEvent(eventName);

                if (!event) {
                    event = new Event(eventName);
                    events.push(event);
                }
                event.fire(eventArgs);
            };

            this.subscribe = function (eventName, handler) {
                var event = getEvent(eventName);

                if (!event) {
                    event = new Event(eventName);
                    events.push(event);
                }

                event.addHandler(handler);
            };
        }

然后,我們來(lái)聲明Product對(duì)象,代碼如下:

function Product(id, description) {
    this.getId = function () {
        return id;
    };
    this.getDescription = function () {
        return description;
    };
}

接著來(lái)聲明Cart對(duì)象,該對(duì)象的addItem的function里我們要觸發(fā)發(fā)布一個(gè)事件itemAdded,然后將item作為參數(shù)傳進(jìn)去。

function Cart(eventAggregator) {
    var items = [];

    this.addItem = function (item) {
        items.push(item);
        eventAggregator.publish("itemAdded", item);
    };
}

CartController主要是接受cart對(duì)象和事件聚合器,通過(guò)訂閱itemAdded來(lái)增加一個(gè)li元素節(jié)點(diǎn),通過(guò)訂閱productSelected事件來(lái)添加product。

function CartController(cart, eventAggregator) {
    eventAggregator.subscribe("itemAdded", function (eventArgs) {
        var newItem = $('<li></li>').html(eventArgs.getDescription()).attr('id-cart', eventArgs.getId()).appendTo("#cart");
    });

    eventAggregator.subscribe("productSelected", function (eventArgs) {
        cart.addItem(eventArgs.product);
    });
}

Repository的目的是為了獲取數(shù)據(jù)(可以從ajax里獲?。缓蟊┞秅et數(shù)據(jù)的方法。

function ProductRepository() {
    var products = [new Product(1, "Star Wars Lego Ship"),
            new Product(2, "Barbie Doll"),
            new Product(3, "Remote Control Airplane")];

    this.getProducts = function () {
        return products;
    }
}

ProductController里定義了一個(gè)onProductSelect方法,主要是發(fā)布觸發(fā)productSelected事件,forEach主要是用于綁定數(shù)據(jù)到產(chǎn)品列表上,代碼如下:

function ProductController(eventAggregator, productRepository) {
    var products = productRepository.getProducts();

    function onProductSelected() {
        var productId = $(this).attr('id');
        var product = $.grep(products, function (x) {
            return x.getId() == productId;
        })[0];
        eventAggregator.publish("productSelected", {
            product: product
        });
    }

    products.forEach(function (product) {
        var newItem = $('<li></li>').html(product.getDescription())
                                    .attr('id', product.getId())
                                    .dblclick(onProductSelected)
                                    .appendTo("#products");
    });
}

最后聲明匿名函數(shù)(需要確保HTML都加載完了才能執(zhí)行這段代碼,比如放在jQuery的ready方法里):

(function () {
    var eventAggregator = new EventAggregator(),
cart = new Cart(eventAggregator),
cartController = new CartController(cart, eventAggregator),
productRepository = new ProductRepository(),
productController = new ProductController(eventAggregator, productRepository);
})();

可以看到匿名函數(shù)的代碼減少了很多,主要是一個(gè)對(duì)象的實(shí)例化代碼,代碼里我們介紹了Controller的概念,他接受信息然后傳遞到action,我們也介紹了Repository的概念,主要是用來(lái)處理product的展示,重構(gòu)的結(jié)果就是寫(xiě)了一大堆的對(duì)象聲明,但是好處是每個(gè)對(duì)象有了自己明確的職責(zé),該展示數(shù)據(jù)的展示數(shù)據(jù),改處理集合的處理集合,這樣耦合度就非常低了。

最終代碼
        function Event(name) {
            var handlers = [];

            this.getName = function () {
                return name;
            };

            this.addHandler = function (handler) {
                handlers.push(handler);
            };

            this.removeHandler = function (handler) {
                for (var i = 0; i < handlers.length; i++) {
                    if (handlers[i] == handler) {
                        handlers.splice(i, 1);
                        break;
                    }
                }
            };

            this.fire = function (eventArgs) {
                handlers.forEach(function (h) {
                    h(eventArgs);
                });
            };
        }

        function EventAggregator() {
            var events = [];

            function getEvent(eventName) {
                return $.grep(events, function (event) {
                    return event.getName() === eventName;
                })[0];
            }

            this.publish = function (eventName, eventArgs) {
                var event = getEvent(eventName);

                if (!event) {
                    event = new Event(eventName);
                    events.push(event);
                }
                event.fire(eventArgs);
            };

            this.subscribe = function (eventName, handler) {
                var event = getEvent(eventName);

                if (!event) {
                    event = new Event(eventName);
                    events.push(event);
                }

                event.addHandler(handler);
            };
        }

        function Product(id, description) {
            this.getId = function () {
                return id;
            };
            this.getDescription = function () {
                return description;
            };
        }

        function Cart(eventAggregator) {
            var items = [];

            this.addItem = function (item) {
                items.push(item);
                eventAggregator.publish("itemAdded", item);
            };
        }

        function CartController(cart, eventAggregator) {
            eventAggregator.subscribe("itemAdded", function (eventArgs) {
                var newItem = $('<li></li>').html(eventArgs.getDescription()).attr('id-cart', eventArgs.getId()).appendTo("#cart");
            });

            eventAggregator.subscribe("productSelected", function (eventArgs) {
                cart.addItem(eventArgs.product);
            });
        }

        function ProductRepository() {
            var products = [new Product(1, "Star Wars Lego Ship"),
            new Product(2, "Barbie Doll"),
            new Product(3, "Remote Control Airplane")];

            this.getProducts = function () {
                return products;
            }
        }

        function ProductController(eventAggregator, productRepository) {
            var products = productRepository.getProducts();

            function onProductSelected() {
                var productId = $(this).attr('id');
                var product = $.grep(products, function (x) {
                    return x.getId() == productId;
                })[0];
                eventAggregator.publish("productSelected", {
                    product: product
                });
            }

            products.forEach(function (product) {
                var newItem = $('<li></li>').html(product.getDescription())
                                    .attr('id', product.getId())
                                    .dblclick(onProductSelected)
                                    .appendTo("#products");
            });
        }

        (function () {
            var eventAggregator = new EventAggregator(),
                cart = new Cart(eventAggregator),
                cartController = new CartController(cart, eventAggregator),
                productRepository = new ProductRepository(),
                productController = new ProductController(eventAggregator, productRepository);
        })();

總結(jié)

看到這個(gè)重構(gòu)結(jié)果,有博友可能要問(wèn)了,真的有必要做這么復(fù)雜么?我只能說(shuō):要不要這么做取決于你項(xiàng)目的情況。

如果你的項(xiàng)目是個(gè)是個(gè)非常小的項(xiàng)目,代碼也不是很多,那其實(shí)是沒(méi)有必要重構(gòu)得這么復(fù)雜,但如果你的項(xiàng)目是個(gè)很復(fù)雜的大型項(xiàng)目,或者你的小項(xiàng)目將來(lái)可能增長(zhǎng)得很快的話,那就在前期就得考慮SRP原則進(jìn)行職責(zé)分離了,這樣才有利于以后的維護(hù)。


以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)