MD2File是我以前写的一个开源软件,主要功能是“将markdown语法的文档内容,导出为word,pdf,HTML等的文件;也支持markdown转HTML文本”。
其中,导出为word文档,需要依赖POI,导出pdf需要依赖iText。其中,iText支持4.x版本和5.x版本。这里就涉及到一个问题,我还是举例子说明下。
如果用户只需要一个功能,导出word文档功能。那用户总不能为了这个功能,而引入一个无关的iText包吧。反之也是,用户要导出PDF功能,却需要引入POI包。
但是,一开始我的代码还真是这样,如果不引入,会导致ClassNotFound异常,致使编译不通过,无法使用。
设计上,我是通过一个工厂类,然后根据需要的文件名后缀,来生产不同的文档Builder。代码一开始是这么写的。
- public class BuilderFactory{
- public static Decorator build(String ext) {
- DecoratorBuilder decoratorBuilder;
- if(ext.equalsIgnoreCase("docx")){
- decoratorBuilder = new DocxDecoratorBuilder();
- }else if(ext.equalsIgnoreCase("doc")){
- decoratorBuilder = new DocDecoratorBuilder();
- }else if(ext.equalsIgnoreCase("pdf")){
- if(itextVersion==PDF_ITEXT_5X){
- decoratorBuilder = new PDFDecoratorBuilder5x();
- }else{
- decoratorBuilder = new PDFDecoratorBuilder4x();;
- }
- }else if(ext.equalsIgnoreCase("html") ||ext.equalsIgnoreCase("htm")){
- decoratorBuilder = new HTMLDecoratorBuilder();
- }else{
- throw new RuntimeException("请确认输出的文档为docx,doc,pdf,html的文档格式");
- }
- Decorator decorator = decoratorBuilder.build();
- return decorator;
- }
- }
这么写很大的问题,就是这个BuilderFactory依赖于DocxDecoratorBuilder,DocDecoratorBuilder,PDFDecoratorBuilder5x,PDFDecoratorBuilder4x,HTMLDecoratorBuilder。而这几个Bulder又各自依赖于不同的第三方jar包。假设我没引入POI包,DocxDecoratorBuilder,DocDecoratorBuilder报错,BuilderFactory就编译不通过了。
于是,就导致了我们一开始说到的问题。
如果用户只需要一个功能,导出word文档功能。那用户总不能为了这个功能,而引入一个无关的iText包吧。反之也是,用户要导出PDF功能,却需要引入POI包。
而且,还有个问题,如果用户需要导出的是PDF文档,那我怎么知道用户用的是iText 4.x包还是iText 5.x包?
这时候是用Java的反射机制的好时机!先看改造后的代码:
- public class BuilderFactory{
- private static final int PDF_ITEXT_5X = 5;
- private static final int PDF_ITEXT_4X = 4;
- private static int itextVersion = PDF_ITEXT_4X;
- /**
- * 检查iText的版本
- */
- static{
- String doc5x = "com.itextpdf.text.Document";
- // String doc4x = "com.lowagie.text.Document";
- try {
- Class.forName(doc5x);
- itextVersion = PDF_ITEXT_5X;
- } catch (ClassNotFoundException e) {
- itextVersion = PDF_ITEXT_4X;
- }
- }
- private static DecoratorBuilder initDecoratorBuilder(String className){
- try {
- @SuppressWarnings("rawtypes")
- Class clazz = Class.forName(className);
- return (DecoratorBuilder)clazz.newInstance();
- } catch (InstantiationException e) {
- e.printStackTrace();
- } catch (IllegalAccessException e) {
- e.printStackTrace();
- } catch (ClassNotFoundException e) {
- e.printStackTrace();
- }
- return null;
- }
- private static final String DOC_BUILDER_CLASS_NAME = "net.oschina.md2.export.builder.DocDecoratorBuilder";
- private static final String DOCX_BUILDER_CLASS_NAME = "net.oschina.md2.export.builder.DocxDecoratorBuilder";
- private static final String PDF_4X_BUILDER_CLASS_NAME = "net.oschina.md2.export.builder.PDFDecoratorBuilder4x";
- private static final String PDF_5X_BUILDER_CLASS_NAME = "net.oschina.md2.export.builder.PDFDecoratorBuilder5x";
- private static final String HTML_BUILDER_CLASS_NAME = "net.oschina.md2.export.builder.HTMLDecoratorBuilder";
- public static Decorator build(String ext) {
- DecoratorBuilder decoratorBuilder;
- if(ext.equalsIgnoreCase("docx")){
- decoratorBuilder = initDecoratorBuilder(DOCX_BUILDER_CLASS_NAME);
- }else if(ext.equalsIgnoreCase("doc")){
- decoratorBuilder = initDecoratorBuilder(DOC_BUILDER_CLASS_NAME);
- }else if(ext.equalsIgnoreCase("pdf")){
- if(itextVersion==PDF_ITEXT_5X){
- decoratorBuilder = initDecoratorBuilder(PDF_5X_BUILDER_CLASS_NAME);
- }else{
- decoratorBuilder = initDecoratorBuilder(PDF_4X_BUILDER_CLASS_NAME);
- }
- }else if(ext.equalsIgnoreCase("html") ||ext.equalsIgnoreCase("htm")){
- decoratorBuilder = initDecoratorBuilder(HTML_BUILDER_CLASS_NAME);
- }else{
- throw new RuntimeException("请确认输出的文档为docx,doc,pdf,html的文档格式");
- }
- Decorator decorator = decoratorBuilder.build();
- return decorator;
- }
- }
现在,代码里我们只是先定义了各个Builder实现的包路径,然后通过
Class clazz = Class.forName(className);
(DecoratorBuilder)clazz.newInstance();
来初始化Builder,这样就解决了BuilderFactory依赖过重的问题。用户需要用什么功能,就只需要引入相应的jar包即可。如果用导出HTML功能或者markdown转HTML功能,甚至任何其它包都不需要。
新的代码还使用了个小技巧,来检查用户使用的iText版本问题。代码就是下面这段
- static{
- String doc5x = "com.itextpdf.text.Document";
- // String doc4x = "com.lowagie.text.Document";
- try {
- Class.forName(doc5x);
- itextVersion = PDF_ITEXT_5X;
- } catch (ClassNotFoundException e) {
- itextVersion = PDF_ITEXT_4X;
- }
- }
以上,就是本人在代码开发中,使用反射来减少包依赖的小技巧。希望对看到本文的你有所帮助:-)