Spring自定义标签的实现

首先 简单写下 spring xml解析的过程

 通过一段简单的 调用spring代码开始

public static void main(String[] args) {
		ApplicationContext app = new ClassPathXmlApplicationContext("classpath:/applicationContext.xml");
		User user = (User) app.getBean("user");
		System.out.println(user.toString());
	}
 可以看出,简单使用spring的时候首先是要加载 xml文件,这里就涉及到 xml的解析成Beandifinition的过程,简单说下步骤

 (1)使用classloader加载器加载xml文件,转换成 Resource对象

 (2)经过转码和一系列操作转成 InputSource对象

 (3)经过 xml validate验证,判断头信息是 dtd 还是 xsd ,进而用不同解析器解析

 (4)根据解析器解析最终都会转换成 w3c的Document对象

(5)获取Document的所有子节点,将每一个子节点都转换成Beandifinition对象

(6)在将每一个节点转换成 BeanDifition对象时设计到 是否是自定义节点还是Spring默认节点,有两种不同的解析方法

 那么spring默认节点有哪些: import、alias、bean、beans

对于自定义标签的解析过程和spring默认节点的区别是对于自定义的需要指定xsd和schema的位置,进而找到解析器和

解析类,步骤如下:

 (6.1)通过getNamespaceURI(),获取标签的命名空间uri

  (6.2)加载spring默认指定下的配置文件,META-INF/spring.handlers,这个文件里有namespaceuri与解析

    器的对应关系,比如

 

(6.3)解析标签,返回标签的localName;比如有标签 <lonely:user></lonely:user>,那么先获取到user

(6.4)在解析器中的init方法中找到 指定 localName对应的解析类,比如


(6.5)调用指定localName对应的解析类的parse方法完成标签的解析即可

至此,xml的解析大致过程如上,下面开始实现 自定义标签的解析

自定义标签解析实现步骤如下:

 (1)编写实体类用户xsd文件描述内容

(2)编写xsd文件描述组建内容

(3)创建一个类,实现BeanDefinitionParse接口,用于标签的解析

(4)创建一个类,继承 NamespaceHandlerSupport,用于将组件注册到spring容器中

(5)编写 Spring.handles 和 Spring.schemas文件,默认在工程的 /META-INF/文件夹下

(6)创建测试文件,进行测试

实现

 (1)新建maven项目,pom文件如下

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<groupId>com.lonely</groupId>
	<artifactId>customlabel</artifactId>
	<version>0.0.1-SNAPSHOT</version>


	<properties>
		<spring.version>4.3.12.RELEASE</spring.version>
		<junit.version>4.12</junit.version>
	</properties>

	<dependencies>

		<!-- Spring mvc web依赖 -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-webmvc</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<!-- Spring jdbc 事务控制模块 -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-jdbc</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<!-- Spring aspects 有关切面模块 -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-aspects</artifactId>
			<version>4.3.12.RELEASE</version>
		</dependency>

		<!-- spring test 测试模块 -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-test</artifactId>
			<version>${spring.version}</version>
			<scope>test</scope>
		</dependency>


		<!-- junit -->
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>${junit.version}</version>
			<scope>test</scope>
		</dependency>

	</dependencies>


	<build>
		<plugins>
			<!-- java编译插件 -->
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-compiler-plugin</artifactId>
				<configuration>
					<source>1.8</source>
					<target>1.8</target>
					<encoding>UTF-8</encoding>
				</configuration>
			</plugin>
		</plugins>
	</build>
</project>

 (2)编写User实体类

package com.lonely.model;

public class User {

	private String id;
	private String name;
	private String age;
	private String height;

	@Override
	public String toString() {
		return "User [name=" + name + ", age=" + age + ", height=" + height + "]";
	}

	public String getId() {
		return id;
	}

	public void setId(String id) {
		this.id = id;
	}

	public String getName() {
		return name;
	}

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

	public String getAge() {
		return age;
	}

	public void setAge(String age) {
		this.age = age;
	}

	public String getHeight() {
		return height;
	}

	public void setHeight(String height) {
		this.height = height;
	}

	public User() {
		// TODO Auto-generated constructor stub
	}

}
 (3)编写 lonely.xsd文件,放在resources目录下

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema 
    xmlns="http://jewel.com/schema/jewel" 
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    targetNamespace="http://jewel.com/schema/jewel" 
    elementFormDefault="qualified"
    attributeFormDefault="unqualified">


    <xsd:element name="user">
        <xsd:complexType>
            <xsd:attribute name="id" type="xsd:string"></xsd:attribute>
            <xsd:attribute name="name" type="xsd:string"></xsd:attribute>
            <xsd:attribute name="age" type="xsd:string"></xsd:attribute>
            <xsd:attribute name="height" type="xsd:string"></xsd:attribute>
        </xsd:complexType>
    </xsd:element>
    
</xsd:schema> 
(4) 编写 一个 UserParse类,用来解析标签,继承 AbstractSingleBeanDefinitionParser 类

package com.lonely.parse;

import org.springframework.beans.factory.support.BeanDefinitionBuilder;
import org.springframework.beans.factory.xml.AbstractSingleBeanDefinitionParser;
import org.springframework.util.StringUtils;
import org.w3c.dom.Element;

import com.lonely.model.User;

public class UserParse extends AbstractSingleBeanDefinitionParser {

	@Override
	protected void doParse(Element element, BeanDefinitionBuilder builder) {
		// 从元素中获取内容
		String name = element.getAttribute("name");
		String age = element.getAttribute("age");
		String height = element.getAttribute("height");
		// 将元素放入到 builder中
		if (StringUtils.hasText(name)) {
			builder.addPropertyValue("name", name);
		}
		if (StringUtils.hasText(age)) {
			builder.addPropertyValue("age", age);
		}
		if (StringUtils.hasText(height)) {
			builder.addPropertyValue("height", height);
		}
	}

	/**
	 * 返回元素对应的类
	 */
	@Override
	protected Class<?> getBeanClass(Element element) {
		return User.class;
	}

}
(5)编写一个UserNamespaceHandler类,用于组件的注册

package com.lonely.handlers;

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

import com.lonely.parse.UserParse;

public class UserNamespaceHandler extends NamespaceHandlerSupport {

	@Override
	public void init() {
		registerBeanDefinitionParser("user", new UserParse());
	}
}

(6)编写Spring.handler和Spring.schemas文件,放在 META-INF目录下

Spring.handler

http\://jewel.com/schema/jewel=com.lonely.handlers.UserNamespaceHandler
 Spring.schemas

http\://jewel.com/schema/jewel.xsd=lonely.xsd

(7)编写测试xml, spring-test.xml

<?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:lonely="http://jewel.com/schema/jewel"
	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
	http://jewel.com/schema/jewel http://jewel.com/schema/jewel.xsd">

	<lonely:user id="user" name="dugu" age="24" height="180"></lonely:user>

</beans>

 (8)编写测试类 Test1

package com.lonely.test;

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import com.lonely.model.User;

public class Test1 {

	public static void main(String[] args) {
		ApplicationContext app = new ClassPathXmlApplicationContext("classpath:/spring-test.xml");
		User user = (User) app.getBean("user");
		System.out.println(user.toString());
	}

}
 测试结果如下,可以看出 已经解析了自定义标签,并成功获取




 最后,展示整个项目结构












posted @ 2018-01-23 15:26  风中追风_lonely  阅读(485)  评论(0编辑  收藏  举报