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

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

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

public interface IocPlugin<T,R> {
	/**
	 * 返回扩展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<String,ExcelTemplate>对象,然后利用模板信息实现一个通用的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<ProMap,Map<String,ExcelTemplate>>{

	@Override
	public Map<String,ExcelTemplate> ioc(ProMap promap,CallContext callcontext) {
		Map<String,ExcelTemplate> excelTemplates = new HashMap<String,ExcelTemplate>();
        Set<Map.Entry<String,Pro>> entries = promap.entrySet();
        Iterator<Map.Entry<String,Pro>> it = entries.iterator();
        while (it.hasNext()) {
            Map.Entry<String,Pro> 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<ExcelCell> cellList = new ArrayList<ExcelCell>();
	            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<ExcelCell> cellList = (List<ExcelCell>) 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<ExcelCell> 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<ExcelCell> getCells() {
        return cells;
    }

    public void setCells(List<ExcelCell> 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下面,内容为:
<?xml version="1.0" encoding="UTF-8"?>

<properties>
	<property name="excelMapping" iocplugin="org.frameworkset.spi.assemble.plugin.ExcelIOCPlugin">
		<map componentType="bean"> 
			<property name="exceltemplatefile1" templatepath="/usr/local/exceltemplates/file1.xlsx" statrow="1" endrow="1000">
			    <list componentType="bean"> 
					<property cellpostion="1" javaFiledName="companyname" celltype="VARCHAR"/> 
					<property cellpostion="2" javaFiledName="age" celltype="INTEGER"/> 
					<property cellpostion="3" javaFiledName="sex" celltype="VARCHAR"/> 
					<property cellpostion="4" javaFiledName="description" celltype="VARCHAR"/> 
				</list>  
			</property>   
			<property name="exceltemplatefile2" templatepath="/usr/local/exceltemplates/file2.xlsx" statrow="1" endrow="1000">
			    <list componentType="bean"> 
					<property cellpostion="1" javaFiledName="factoryname" celltype="VARCHAR"/> 
					<property cellpostion="2" javaFiledName="createyear" celltype="DATE"/> 
					<property cellpostion="3" javaFiledName="address" celltype="VARCHAR"/> 
					<property cellpostion="4" javaFiledName="worksers" celltype="VARCHAR"/> 
				</list>  
			</property>   
			<property name="exceltemplatefile3" templatepath="/usr/local/exceltemplates/file3.xlsx" statrow="1" endrow="1000">
			    <list componentType="bean"> 
					<property cellpostion="1" javaFiledName="product" celltype="VARCHAR"/> 
					<property cellpostion="2" javaFiledName="totalcount" celltype="INTEGER"/> 
					<property cellpostion="3" javaFiledName="name" celltype="VARCHAR"/> 
					<property cellpostion="4" javaFiledName="description" celltype="VARCHAR"/>
				</list>  
			</property>   
			
			<property name="exceltemplatefile4" templatepath="/usr/local/exceltemplates/file3.xlsx" statrow="1" endrow="1000">
			    <list componentType="bean"> 
					<property class="org.frameworkset.spi.assemble.plugin.ExcelCell" f:cellpostion="1" f:javaFiledName="product" f:celltype="VARCHAR"/> 
					<property class="org.frameworkset.spi.assemble.plugin.ExcelCell" f:cellpostion="2" f:javaFiledName="totalcount" f:celltype="INTEGER"/> 
					<property class="org.frameworkset.spi.assemble.plugin.ExcelCell" f:cellpostion="3" f:javaFiledName="name" f:celltype="VARCHAR"/> 
					<property class="org.frameworkset.spi.assemble.plugin.ExcelCell" f:cellpostion="4" f:javaFiledName="description" f:celltype="VARCHAR"/>
				</list>  
			</property>   
		</map> 
	</property>
	
	<property name="POIExcelService" class="org.frameworkset.spi.assemble.plugin.POIExcelService" f:excelTemplates="attr:excelMapping"/>
	
	
</properties>

内容说明:
组件excelMapping配置了ioc依赖注入插件
iocplugin="org.frameworkset.spi.assemble.plugin.ExcelIOCPlugin"
通过插件ExcelIOCPlugin会将excelMapping转换为一个Map<String,ExcelTemplate>对象,这个对象会被注入给业务组件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<String,ExcelTemplate> excelTemplates;
	 
    /**
     * 根据传入的excel流,将其中的数据根据对应的excel模板信息类将数据解析出来,形成beanType对象记录列表返回
     * 
     * @param file
     * @return
     * @throws IOException
     */
    public <T> List<T> parseHSSFMapList(InputStream in,Class<T> beanType,String templatename) throws IOException 
    {
         ExcelTemplate template = excelTemplates.get(templatename);//获取excel模板
         //根据模板,从excel输入流in对象中获取excel文件中包含的所有记录形成一个List<beanType>的集合并返回:
         List<beanType> 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<String,ExcelTemplate>类型对象
		  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

相关文章

适配器模式将一个类的接口转换成客户期望的另一个接口,使得原本接口不兼容的类可以相互合作。
策略模式定义了一系列算法族,并封装在类中,它们之间可以互相替换,此模式让算法的变化独立于使用算法...
设计模式讲的是如何编写可扩展、可维护、可读的高质量代码,它是针对软件开发中经常遇到的一些设计问题...
模板方法模式在一个方法中定义一个算法的骨架,而将一些步骤延迟到子类中,使得子类可以在不改变算法结...
迭代器模式提供了一种方法,用于遍历集合对象中的元素,而又不暴露其内部的细节。
外观模式又叫门面模式,它提供了一个统一的(高层)接口,用来访问子系统中的一群接口,使得子系统更容...