Java设计模式(七)Decorate装饰器模式

一、场景描述

(一)问题

系统中最初使用Crystal Report(水晶报表)工具生成报表,并将报表发送给客户端查看,此时定义一CrystalReport工具类即可完成水晶报表的生成工作。

Java设计模式(七)Decorate装饰器模式

后续报表工具增加SSRS报表(SQL Server Report Service),此时可定义SSRSReport工具类完成SSRS报表的生成工作;

并定义Report接口,重构两报表工具类实现Report接口,客户端通过接口统一调用。

Java设计模式(七)Decorate装饰器模式

需求接着变更,报表工具需要在发送给客户端(以PDF格式)的同时,可导出一份Word可编辑版本。对此可定义CrystalReportPDF和CrystalReportWord、SSRSReportPDF、SSRSReportWord四个工具类实现相应的功能。

需求继续变更,报表工具需要在发送给客户端(以Word格式或PDF格式)的同时,可将报表存储到文件服务器(File System)上。对此可定义CrystalReportPDF、CrystalReportPDF2FS、CrystalReportWord、CrystalReportWord2FS……。

需求仍然在变更,报表工具增加了Fine Report(帆软报表),要求在输出的同时,存储到FTP服务器上、邮件发送给指定用户,输出格式需要Excel……

(二)解决方案

针对此场景,之前的办法很痛苦(通过定义类实现接口),此时可应用装饰器模式。

报表工具一共有三种,即Crystal Report、SSRS和Fine Report,因此可定义三个类实现Report接口。

导出为Word版本、导出为Excel版本、存储到文件系统、存储到FTP服务器上、邮件发送用户等可理解为报表工具的装饰。

因此可以定义各种ReportGenerator的装饰类,用于给报表工具类(三种中具体的某一种)添加装饰(可以添加多种装饰,并可多次添加)。

据此定义装饰类父类ReportGenerator,使其持有Report接口对象,并实现Report接口,至此则可对持有的对象添加装饰,并最终将装饰好的方法发布出去。

接着为不同类型的装饰器定义类,继承父类ReportGenerator,例如定义ExportWordReport类,使其可输出Word格式报告,定义StorageReport2FTP类,使其将报表存储到FTP服务器。

Java设计模式(七)Decorate装饰器模式

调用端,可创建某类型的报表(三种报表服务中的一种),并调用不同的装饰器类组合,实现动态扩展类功能,例如调用ExportWordReport、ExportExcelReport和StorageReport2FTP,则实现将报表输出为Word和Excel,并存储到FTP服务器。

另外,假设有一装饰功能,发送报告生成通知给用户,发送方式有Email、短信、APP通知等,由于发送时需要对消息进行处理,因此可定义一公用的生成消息装饰类,此时装饰类可定义父子类不断继承。

Java设计模式(七)Decorate装饰器模式

装饰器的优点是动态的扩展了类功能(相比定义具体的类去实现接口),将装饰功能抽象为装饰类,减少了实现类的数量,降低了复杂度,也更符合对象的自然情况(个人认为区分装饰类与子类的方法是,装饰可以加也可以不加,可以加一个也可以重复添加,而子类则有且仅有一个;比如吃饭时,面条、馒头、米饭作为主食,一般人是选择其中一种,则可实现为子类,而西红柿炒鸡蛋、黄瓜炒木耳等炒菜可以添加两份或三份,甚至可以要两份西红柿炒鸡蛋,因此炒菜可以作为装饰类)。

装饰器的缺点是由于装饰的层数可以不等,因此在排查问题等方面较复杂,好比一堵墙上添了N层墙纸、刷了N多涂料,现在墙上裂了缝到底是哪里出了问题就有点难排查了。

二、示例代码

接口:

package lims.designpatterndemo.decoratedemo;

public interface Report {
    public String generateReport();
}

Crystal Report报表工具类:

package lims.designpatterndemo.decoratedemo;

public class CrystalReport implements Report {

    @Override
    public String generateReport() { 
        return "Generate Report using Crystal Report!";
    }

}

SSRS报表工具类:

package lims.designpatterndemo.decoratedemo;

public class SSRSReport implements Report {

    @Override
    public String generateReport() { 
        return "Generate Report using Sql Server Report Service!";
    } 
}

Fine Report报表工具类:

package lims.designpatterndemo.decoratedemo;

public class FineReport implements Report {

    @Override
    public String generateReport() { 
        return "Generate Report using Fine Report!";
    }
    
}

装饰类父类:

package lims.designpatterndemo.decoratedemo;

public class ReportGenerator implements Report {
    //持有接口
    private Report report;
    public ReportGenerator(Report report){
        this.report = report;
    }
    
    @Override
    public String generateReport() { 
        return report.generateReport();
    }
    
}

输出Word报告装饰类:

package lims.designpatterndemo.decoratedemo;

public class ExportWordReport extends ReportGenerator{
    public ExportWordReport(Report report) {
        super(report); 
    }
    public String generateReport() { 
        return super.generateReport() + " Export to Word Format!";
    }
}

输出Excel报告装饰类:

package lims.designpatterndemo.decoratedemo;

public class ExportExcelReport extends ReportGenerator{
    public ExportExcelReport(Report report) {
        super(report); 
    }
    public String generateReport() { 
        return super.generateReport() + " Export to Excel Format!";
    }
}

存储报告到FTP服务器装饰类:

package lims.designpatterndemo.decoratedemo;

public class StorageReport2FTP extends ReportGenerator{
    public StorageReport2FTP(Report report) {
        super(report); 
    }
    public String generateReport() { 
        return super.generateReport() + " Storage Report to FTP Server!";
    }
}

动态调用:

package lims.designpatterndemo.decoratedemo;

public class DecorateDemo {
    public static void main(String args[]){
        Report report = new CrystalReport();  
        report = new ExportWordReport(report);
        report = new ExportExcelReport(report);
        report = new StorageReport2FTP(report); 
        System.out.println(report.generateReport());
    } 
}

输出结果:

Generate Report using Crystal Report! Export to Word Format! Export to Excel Format! Storage Report to FTP Server!

发送通知消息装饰类:

package lims.designpatterndemo.decoratedemo;

public class SendReport extends ReportGenerator {

    public SendReport(Report report) {
        super(report); 
    }
    
    public String generateReport() { 
        return super.generateReport() + " Send Report!";
    }
}

发送消息到Email装饰类:

package lims.designpatterndemo.decoratedemo;

public class SendReport2Email extends SendReport {

    public SendReport2Email(Report report) {
        super(report); 
    }
    
    public String generateReport() { 
        return super.generateReport() + " send to Email!";
    }
}

调用测试:

package lims.designpatterndemo.decoratedemo;

public class DecorateDemo {
    public static void main(String args[]){
        Report report = new CrystalReport();  
        report = new ExportWordReport(report);
        report = new ExportExcelReport(report);
        report = new StorageReport2FTP(report); 
        report = new SendReport2Email(report);  
        System.out.println(report.generateReport());
    } 
}

输出结果:

Generate Report using Crystal Report! Export to Word Format! Export to Excel Format! Storage Report to FTP Server! Send Report! send to Email!

相关推荐