扩展bboss ioc语法实现自定义的ioc依赖注入功能

阅读更多

bboss ioc配置语法简洁而严谨，提供了强大的依赖注入功能，而且开发人员可以任意为ioc元素property增加扩展属性，从而实现自定义的ioc依赖注入功能。业界其他ioc框架自定义扩展ioc语法，可能需要编写xsd描述文件，bboss ioc很容易扩展且不需要编写xsd文件，本文举例说明如何实现bboss中的自定义ioc依赖注入功能。

实现这个功能需要三个步骤：
1.定义好ioc依赖注入插件，插件必须实现接口：
org.frameworkset.spi.assemble.plugin.IocPlugin

public interface IocPlugin {
	/**
	 * 返回扩展ioc机制生成的对象实例
	 * @param object 输入的ioc元素对象,类型范围为：Pro,ProMap,ProList,ProArray,ProSet
	 * @param callcontext ioc依赖注入上下文，用来提供对循环依赖注入支持的
	 * @return
	 */
	public R ioc(T object, CallContext callcontext);

}

   
2.利用写好的插件编写ioc xml文件
3.定义一个加载写好的ioc xml文件的ioc容器并获取通过自定义ioc机制定义的组件

接下来举例说明上述三个步骤，这个示例的功能很简单：定义了几个excel导入模板，通过ioc语法来描述这些模板结构信息，然后通过ioc依赖注入插件来将这些excel模板信息解析成一个Map对象，然后利用模板信息实现一个通用的excel导入功能。

第一步 编写ioc注入插件以及依赖的excel模板结构po对象
ioc注入插件-ExcelIOCPlugin 接口方法接收一个ProMap结构，其中包含了excel导入模板map数据结构，这些信息通过ioc xml语法描述

package org.frameworkset.spi.assemble.plugin;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Set;

import org.frameworkset.spi.CallContext;
import org.frameworkset.spi.assemble.Pro;
import org.frameworkset.spi.assemble.ProList;
import org.frameworkset.spi.assemble.ProMap;

public class ExcelIOCPlugin implements IocPlugin>{

	@Override
	public Map ioc(ProMap promap, CallContext callcontext) {
		Map excelTemplates = new HashMap();
        Set> entries = promap.entrySet();
        Iterator> it = entries.iterator();
        while (it.hasNext()) {
            Map.Entry e = it.next();
            String name = e.getKey();
            Pro pro = e.getValue();
            String templatepath = pro.getStringExtendAttribute("templatepath");

            ExcelTemplate template = new ExcelTemplate();
            template.setName(name);
            template.setStarrow(pro.getIntExtendAttribute("statrow", 1));
            template.setEndrow(pro.getIntExtendAttribute("endrow", -1));
            template.setTemplatepath(templatepath);
            excelTemplates.put(name, template);

            if(!name.equals("exceltemplatefile4"))//根据ioc元数据手动构建execl模板的单元格信息
            {
	            List cellList = new ArrayList();
	            ProList templateCellList = pro.getList();
	
	            for (int i = 0; i < templateCellList.size(); i++) {
	
	                Pro cellPro = (Pro) templateCellList.get(i);
	
	                ExcelCell cellBean = new ExcelCell();
	                cellBean.setCellpostion(cellPro.getIntExtendAttribute("cellpostion"));
	                cellBean.setJavaFiledName(cellPro.getStringExtendAttribute("javaFiledName"));
	                cellBean.setCelltype(cellPro.getStringExtendAttribute("celltype"));
	                cellList.add(cellBean);
	            }
	            template.setCells(cellList);
            }
            else//利用bboss ioc原生功能自动构建execl模板的单元格信息
            {
            	 @SuppressWarnings("unchecked")
				List cellList = (List) pro.getBeanObject(callcontext);
 	             template.setCells(cellList);
            }
        }
        return excelTemplates;
	}

}

ExcelTemplate模板信息类-包含了execl的数据起始行和数据结束行以及单元格信息列表等

package org.frameworkset.spi.assemble.plugin;

import java.util.List;

public class ExcelTemplate {
	String name;

    String templatepath;

    int starrow;

    int endrow = -1;

    List cells;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getTemplatepath() {
        return templatepath;
    }

    public void setTemplatepath(String templatepath) {
        this.templatepath = templatepath;
    }

    public int getStarrow() {
        return starrow;
    }

    public void setStarrow(int starrow) {
        this.starrow = starrow;
    }

    public int getEndrow() {
        return endrow;
    }

    public void setEndrow(int endrow) {
        this.endrow = endrow;
    }

    public List getCells() {
        return cells;
    }

    public void setCells(List cells) {
        this.cells = cells;
    }
}

excel单元格对象-包含单元格位置、单元格数据类型、单元格对应的java值对象属性名称

package org.frameworkset.spi.assemble.plugin;

public class ExcelCell {
	private int cellpostion;

	private String javaFiledName;

	private String celltype;

    public int getCellpostion() {
        return cellpostion;
    }

    public void setCellpostion(int cellpostion) {
        this.cellpostion = cellpostion;
    }

    

    public String getCelltype() {
        return celltype;
    }

    public void setCelltype(String celltype) {
        this.celltype = celltype;
    }

	public String getJavaFiledName() {
		return javaFiledName;
	}

	public void setJavaFiledName(String javaFiledName) {
		this.javaFiledName = javaFiledName;
	}
}

第二步 定义ioc xml文件-excelFieldInfo.xml
excelFieldInfo.xml存放在包路径org/frameworkset/spi/assemble/plugin下面，内容为：

内容说明：
组件excelMapping配置了ioc依赖注入插件：
iocplugin="org.frameworkset.spi.assemble.plugin.ExcelIOCPlugin"
通过插件ExcelIOCPlugin会将excelMapping转换为一个Map对象，这个对象会被注入给业务组件POIExcelService的excelTemplates属性。
POIExcelService组件的实现类如下：

package org.frameworkset.spi.assemble.plugin;

import java.io.IOException;
import java.io.InputStream;
import java.util.List;
import java.util.Map;
/**
 * 本实例演示ioc注入插件的使用方法，通过ioc注入插件来扩展ioc依赖注入功能，实现自己的ioc依赖注入功能
 * @author yinbp
 *
 */
public class POIExcelService {
	/**
	 * 存储各种execl模板信息，模板的映射信息全部都设置在ioc配置文件中
	 */
	 private Map excelTemplates;
	 
    /**
     * 根据传入的excel流，将其中的数据根据对应的excel模板信息类将数据解析出来，形成beanType对象记录列表返回
     * 
     * @param file
     * @return
     * @throws IOException
     */
    public  List parseHSSFMapList(InputStream in,Class beanType,String templatename) throws IOException 
    {
         ExcelTemplate template = excelTemplates.get(templatename);//获取excel模板
         //根据模板，从excel输入流in对象中获取excel文件中包含的所有记录形成一个List的集合并返回：
         List datas = .....;
    	return datas ;
    }
}

第三步 验证功能-编写和执行测试用例

package org.frameworkset.spi.assemble.plugin;

import java.io.IOException;

import org.frameworkset.spi.BaseApplicationContext;
import org.frameworkset.spi.DefaultApplicationContext;
import org.junit.Test;

public class TestIocPlugin {
	@Test
	public void testiocplugin() throws IOException
	{
		  BaseApplicationContext excelMapping = DefaultApplicationContext.getApplicationContext("org/frameworkset/spi/assemble/plugin/excelFieldInfo.xml");//定义ioc容器
		  POIExcelService serice = excelMapping.getTBeanObject("POIExcelService", POIExcelService.class);//获取业务组件，ioc容器会通过ioc插件解析excelMapping组件元素并返回一个Map类型对象
		  List datas = serice.parseHSSFMapList(in, dataClass,"exceltemplatefile1");//执行业务方法
		  
	}

}

相关测试用例源码github获取地址：
https://github.com/bbossgroups/bbossgroups-3.5/tree/master/bboss-core/test/org/frameworkset/spi/assemble/plugin