快捷導(dǎo)航

通過Spring自定義NamespaceHandler實現(xiàn)命名空間解析(推薦)

更新時間：2021年04月14日 14:44:13 作者：DoBetterEveryDay

這篇文章主要介紹了通過Spring自定義NamespaceHandler實現(xiàn)命名空間解析,本文給大家介紹的非常詳細，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下

spring中在使用xml進行bean配置時，我們經(jīng)常出現(xiàn)<context:annotation-config/>這樣的配置，或是在使用dubbo時，暴露服務(wù)時，使用<dubbo:service interface="xxx" ref="yyy" />，我們知道僅僅通過這些簡單的配置，其實完成了很多工作，那么我們能不能也實現(xiàn)這種功能，僅通過簡單的配置，實現(xiàn)bean定義加載的過程中細節(jié)的隱藏，但完成復(fù)雜的功能呢？
答案是肯定的，方法是我們使用自定義NamespaceHandler進行處理，具體步驟如下：
說明：下面模擬spring bean定義功能，使用我們自定義的方式來實現(xiàn)CustomBean注入到Spring容器中，具體用法如下：

<custom:bean class="com.lcl.spring.beans.CustomBean"></custom:bean>

1、定義Bean

package com.lcl.spring.beans;

public class CustomBean {
    public void sayHi(){
        System.out.println("Hello Custom NamespaceHandler");
    }
}

我們想把這個類通過xml方式注入到spring容器中

2、編寫自定義NamespaceHandler

NamespaceHandler的功能就是解析我們自定義的custom命名空間的，為了方便起見，我們實現(xiàn)NamespaceHandlerSupport，其內(nèi)部通過BeanDefinitionParser對具體的標(biāo)簽進行處理，即對我們定義的<custom:bean/>進行具體處理。

NamespaceHandler實現(xiàn)如下：

package com.lcl.spring.ext;

import org.springframework.beans.factory.xml.NamespaceHandlerSupport;

/**
 * 自定義命名空間解析器
 */
public class CustomNamespaceHandler extends NamespaceHandlerSupport {

    @Override
    public void init() {
        // 在初始化方法中，注入標(biāo)簽解析器，此時我們需要解析<custom:bean/>
        registerBeanDefinitionParser("bean", new CustomBeanDefinitionParser());
        // 注入其他解析器...
    }
}

解析器代碼：

package com.lcl.spring.ext;

import org.springframework.beans.factory.config.BeanDefinition;
import org.springframework.beans.factory.config.BeanDefinitionHolder;
import org.springframework.beans.factory.support.BeanDefinitionReaderUtils;
import org.springframework.beans.factory.xml.BeanDefinitionParser;
import org.springframework.beans.factory.xml.ParserContext;
import org.w3c.dom.Element;

/**
 * 自定義解析器
 */
public class CustomBeanDefinitionParser implements BeanDefinitionParser {

    @Override
    public BeanDefinition parse(Element element, ParserContext parserContext) {
        // 為了演示方便起見，使用BeanDefinitionParserDelegate解析bean definition
        BeanDefinitionHolder beanDefinitionHolder = parserContext.getDelegate().parseBeanDefinitionElement(element);
        // 使用工具類注冊
        BeanDefinitionReaderUtils.registerBeanDefinition(beanDefinitionHolder, parserContext.getRegistry());
        // 或是使用注冊器注冊
        //parserContext.getRegistry().registerBeanDefinition(beanDefinitionHolder.getBeanName(),beanDefinitionHolder.getBeanDefinition());
        return beanDefinitionHolder.getBeanDefinition();
    }
}

特別說明：在解析器中執(zhí)行parse返回BeanDefinition并不會實現(xiàn)被返回的bean定義被自動注冊到spring容器中，需要自己手工的執(zhí)行注冊中，如執(zhí)行上述代碼中的BeanDefinitionReaderUtils.registerBeanDefinition或使用parserContext.getRegistry().registerBeanDefinition

另外為了更方便的處理解析過程，解析器可以實現(xiàn)AbstractSingleBeanDefinitionParser

3、編寫spring.handlers文件

這個是核心的配置文件，定義了具體handler處理器，其實spring內(nèi)部對context、aop、task等命名空間，也是通過此方式進行處理的。
具體內(nèi)容如下：

http\://www.lcl.com/schema/custom=com.lcl.spring.ext.CustomNamespaceHandler

4、編寫XSD文件

為了簡單期間，我直接使用spring-beans-4.3.xsd文件修改，命名為custom-beans-4.3.xsd，放置在resources目錄下

在這里插入圖片描述

注意：需要修改如圖所示部分

5、編寫spring.schemas

http\://www.lcl.com/schema/custom.xsd=custom-beans-4.3.xsd

6、編寫spring配置文件

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:custom="http://www.lcl.com/schema/custom"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
            http://www.lcl.com/schema/custom http://www.lcl.com/schema/custom.xsd">
    <custom:bean class="com.lcl.spring.beans.CustomBean"></custom:bean>
</beans>

使用了我們自定義的<custom:bean/>標(biāo)簽進行定義

7、測試

package com.lcl.spring;

import com.lcl.spring.beans.CustomBean;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class SpringCustomNamespaceHandlerDemo {
    public static void main(String[] args) {
        ClassPathXmlApplicationContext applicationContext = new ClassPathXmlApplicationContext("context.xml");
        CustomBean bean = applicationContext.getBean(CustomBean.class);
        bean.sayHi();
    }
}

輸入結(jié)果如下: