《Spring实战》第四版 第四章4.3.3 处理通知中的参数 节 ——源码实现及笔记

本博客谨记载个人在Spring学习中遇到的问题和体会，如有错误，恳请大家指教&

 

一 介绍

本博客内容为本人学习《Spring实战》(第四版) 4.3.3节，做的笔记及源码实现。因为第二章装配Bean没有深入掌握，加上书籍附带源码包中沒有第四章相关代码，所以此处我遭遇一些障碍，通过重新学习第二章，最后实现了此节阐述的内容。

二 笔记

自动装配（autowiring） ： Spring自动满足bean之间的依赖。
测试代码中有一个CompactDisc类型的属性，并且这个属性带有@Autowired注解， 以便于将CompactDiscbean注入到测试代码之中（具体见代码注释）；

@Configuration注解表明这个类是一个配置类， 该类应该包含在Spring应用上下文中如何创建bean的细节；

@Bean注解会告诉Spring这个方法将会返回一个对象， 该对象要注册为Spring应用上下文中的bean。 方法体中包含了最终产生bean实例的逻辑；

TrackCounter类，它是通知playTrack()方法的一个切面。
切点表达式中的args(trackNumber)限定符。 它表明传递给playTrack()方法的int类型参数也会传递到通知中去。 参数的名称trackNumber也与切点方法签名中的参数相匹配。
切点定义中的参数与切点方法中的参数名称是一样的， 这样就完成了从命名切点到通知方法的参数转移。

三 代码实现

总览

因为书中采用Java代码显式装配Bean形式，所以实现代码保持一致。

pom.xml

关键以下两个是与aspectj相关的包,用来支持切面编程的

aspectjrt包是aspectj的runtime包

aspectjweaver是aspectj的织入包

<?xml version="1.0" encoding="UTF-8"?>
<project
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
	xmlns="http://maven.apache.org/POM/4.0.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<modelVersion>4.0.0</modelVersion>
	<groupId>com.company.root</groupId>
	<artifactId>stereo-autoconfig</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<inceptionYear>2014</inceptionYear>
	<licenses>
		<license>
			<name>The Apache Software License, Version 2.0</name>
			<url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
			<distribution>repo</distribution>
		</license>
	</licenses>
	<dependencies>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-context</artifactId>
			<version>4.0.7.RELEASE</version>
			<scope>compile</scope>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-test</artifactId>
			<version>4.0.7.RELEASE</version>
			<scope>test</scope>
		</dependency>
		<dependency>
			<groupId>com.github.stefanbirkner</groupId>
			<artifactId>system-rules</artifactId>
			<version>1.5.0</version>
			<scope>test</scope>
		</dependency>

		<dependency>
			<groupId>org.aspectj</groupId>
			<artifactId>aspectjrt</artifactId>
			<version>1.6.11</version>
		</dependency>

		<dependency>
			<groupId>org.aspectj</groupId>
			<artifactId>aspectjweaver</artifactId>
			<version>1.6.11</version>
		</dependency>
	</dependencies>
</project>

CompactDisc.java

package soundsystem;

public interface CompactDisc {
	void play();

	void playTrack(int trackNumber);
}

BlankDisc.java

package soundsystem;

import java.util.List;

public class BlankDisc implements CompactDisc {

	private String title;
	private String artist;
	private List<String> tracks;

	public BlankDisc(String title, String artist) {
		this.title = title;
		this.artist = artist;
	}

	public void setTracks(List<String> tracks) {
		this.tracks = tracks;
	}

	public void play() {
		System.out.println("Playing " + title + " by " + artist);
	}

	public void playTrack(int trackNumber) {
		System.out.println("trackNumber =" + trackNumber);
	}
}

TrackCounter.java

package soundsystem;

import java.util.HashMap;
import java.util.Map;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.aspectj.lang.annotation.Pointcut;

/**
 * 使用参数化的通知来记录磁道播放的次数
 */
@Aspect
public class TrackCounter {

	private Map<Integer, Integer> trackCounts = new HashMap<Integer, Integer>();

	// 通知playTrack()方法
	// args(trackNumber)限定符, 它表明传递给playTrack()方法的int类型参数也会传递到通知中去
	@Pointcut("execution(* soundsystem.CompactDisc.playTrack(int))" + "&& args(trackNumber)")
	public void trackPlayed(int trackNumber) {
	}

	// 在播放前，为该磁道计数
	@Before("trackPlayed(trackNumber)")
	public void countTrack(int trackNumber) {
		int currentCount = getPlayCount(trackNumber);
		trackCounts.put(trackNumber, currentCount + 1);
	}

	public int getPlayCount(int trackNumber) {
		return trackCounts.containsKey(trackNumber) ? trackCounts.get(trackNumber) : 0;
	}
}

TrackCounterConfig.java 

此处需理解@Bean

package soundsystem;

import java.util.ArrayList;
import java.util.List;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.EnableAspectJAutoProxy;

@Configuration
@EnableAspectJAutoProxy
public class TrackCounterConfig {
	@Bean
	public CompactDisc sgtPeppers() {
		String title = "Sgt. Pepper's Lonely Hearts Club Band";
		String artist = "The Beatles";
		BlankDisc cd = new BlankDisc(title, artist);
		
		List<String> tracks = new ArrayList<String>();
		tracks.add("Sgt");
		tracks.add("With");
		tracks.add("Lucy");
		tracks.add("Getting");
		tracks.add("Fixing");

		cd.setTracks(tracks);
		return cd;
	}

	@Bean
	public TrackCounter trackCounter() {
		return new TrackCounter();
	}
}

TrackCounterTest.java

此处需理解@Autowired在Test中的用法，还需理解assertEquals(2, counter.getPlayCount(2))，第一个参数是你猜测的值，第二个参数是trackCounts的HashMap中key为2的磁道对应的播放次数。

package soundsystem;

import static org.junit.Assert.assertEquals;
import org.junit.Rule;
import org.junit.Test;
import org.junit.contrib.java.lang.system.StandardOutputStreamLog;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes = TrackCounterConfig.class)
public class TrackCounterTest {
	@Rule
	public final StandardOutputStreamLog log = new StandardOutputStreamLog();

	@Autowired
	private CompactDisc cd;
	@Autowired
	// TrackCounter类型的属性，带有@Autowired，以便于将TrackCounter bean注入到测试代码的counter成员变量之中
	private TrackCounter counter;

	@Test
	public void testTrackCounter() {
		// 播放一些磁道
		cd.playTrack(1);
		cd.playTrack(2);
		cd.playTrack(2);
		// 断言期望的数量
		assertEquals(1, counter.getPlayCount(1));
		assertEquals(2, counter.getPlayCount(2));
	}
}

結果展示：