除了常见的jsp视图外,还有pdf,excel等。不管哪种视图,都会实现SpringMvc定义的视图接口View。这篇文章就讲讲怎么使用Pdf视图----AbstractPdfView。

AbstractPdfView属于非逻辑视图,不需要任何的视图解析器(ViewResolver)去定位。它是一个抽象类,有一个抽象方法需要我们去实现。

    /**
	 * 通过数据模型自定义创建pdf文档
	 * @param model 数据模型
	 * @param document 代表一个pdf文档
	 * @param writer pdf写入器
	 * @param request HttpServletRequest请求对象
	 * @param response HttpServletResponse响应对象
	 */
	protected abstract void buildPdfDocument(Map<String, Object> model, Document document, PdfWriter writer,
			HttpServletRequest request, HttpServletResponse response) throws Exception;

我们首先创建一个Spring Boot工程,这里的orm使用Mybatis,数据源使用Druid,为了能够使用pdf,我们需要加pom.xml中相关的依赖,下面贴出完整的pom文件

    <dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-aop</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
		<dependency>
			<groupId>org.mybatis.spring.boot</groupId>
			<artifactId>mybatis-spring-boot-starter</artifactId>
			<version>1.3.2</version>
		</dependency>

		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<scope>runtime</scope>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-tomcat</artifactId>
			<scope>provided</scope>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
		<!-- pdf相关的jar -->
		<dependency>
			<groupId>org.xhtmlrenderer</groupId>
			<artifactId>core-renderer</artifactId>
			<version>R8</version>
		</dependency>
		<dependency>
			<groupId>com.itextpdf</groupId>
			<artifactId>itextpdf</artifactId>
			<version>5.5.12</version>
		</dependency>
		<dependency>
			<groupId>com.alibaba</groupId>
			<artifactId>druid</artifactId>
			<version>1.1.6</version>
		</dependency>
	</dependencies>

继承了AbstractPdfView后,就得实现它的抽象方法,从而完成导出的逻辑,而每个控制器可能都有不同的导出逻辑,所以为了适应不同控制器的自定义导出,先定义一个导出接口。

import java.util.Map;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import com.lowagie.text.Document;
import com.lowagie.text.pdf.PdfWriter;

/**
 * 定义一个导出的接口,方便每个控制器实现自己的导出逻辑
 * @author liu
 */
public interface PdfExportService {
	
	/**
	 * 导出的方法
	 * @param model 数据模型
	 * @param document 代表一个pdf文档
	 * @param writer pdf写入器
	 * @param request HttpServletRequest请求对象
	 * @param response HttpServletResponse响应对象
	 */
	public void make(Map<String, Object> model, Document document, PdfWriter writer, 
			HttpServletRequest request, HttpServletResponse response);
}

注意这里导的是com.lowagie.text包下的类。

有了这个接口后,各个控制器只需要实现这个接口,就能自定义导出pdf的逻辑。

接着就是继承AbstractPdfView,通过它调度PdfExportService 的make方法就可以让控制器去实现自定义的导出逻辑。

/**
 * 继承AbstractPdfView类,实现抽象方法buildPdfDocument
 * @author liu
 */
public class PdfView extends AbstractPdfView {
	
	private PdfExportService pdfExportService = null;
	
	/**
	 * 创建对象时载入导出服务接口
	 * @param pdfExportService
	 */
	public PdfView(PdfExportService pdfExportService) {
		this.pdfExportService = pdfExportService;
	}

	/**
	 * 调用接口实现导出
	 */
	@Override
	protected void buildPdfDocument(Map<String, Object> model, Document document, PdfWriter writer,
			HttpServletRequest request, HttpServletResponse response) throws Exception {
		
		// 调用导出服务接口类
		pdfExportService.make(model, document, writer, request, response);
	}

}

这里可以看到,在创建自定义pdf视图时,需要自定义一个导出服务接口(PdfExportService ),通过实现这个接口,每个控制器都可以自定义其导出的逻辑。

完成了上面的工作,接下来就是正常的SSM结合。首先在Spring Boot的配置文件中进行配置

# 数据库配置
jdbc.driver = com.mysql.jdbc.Driver
jdbc.url = jdbc:mysql://localhost:3306/springboot?characterEncoding=utf-8
jdbc.username = root
jdbc.password = 1311664842

# mybatis 配置文件的路径
mybatis_config_file = /mybatis/mybatis-config.xml
# 映射文件的路径
mapper_path = /mapper/**.xml
# 实体类的路径
entity_package = com.codeliu.entity

# 日志配置
logging.level.root = DEBUG
logging.level.org.springframework = DDEBUG
logging.level.org.mybatis = DEBUG

可以看到进行了数据源的配置,还有mybatis的一些配置。

接下来就是在指定路径下创建mybatis全局配置文件,创建实体类和创建映射文件,还有service层,这些就不写了,最重要的就是控制层,在写控制层之前,先写两个配置类,配置数据源和sqlSessionFactory。

/**
 * 配置数据源
 * @author liu
 */
@Configuration
// 扫描dao层
@MapperScan(value = "com.codeliu.dao")
public class DataSourceConfig {
	
	@Value(value = "${jdbc.driver}")
	private String jdbcDriver;
	
	@Value(value = "${jdbc.url}")
	private String jdbcUrl;
	
	@Value(value = "${jdbc.username}")
	private String jdbcUsername;
	
	@Value(value = "${jdbc.password}")
	private String jdbcPassword;
	
	@Bean(value = "dataSource")
	public DruidDataSource getDataSource() {
		DruidDataSource dataSource = new DruidDataSource();
		dataSource.setDriverClassName(jdbcDriver);
		dataSource.setUrl(jdbcUrl);
		dataSource.setUsername(jdbcUsername);
		dataSource.setPassword(jdbcPassword);
		return dataSource;
	}
}
/**
 * SqlSessionFactory配置
 * @author liu
 */
@Configuration
public class SqlSessionFactoryConfig {

	// mybatis配置文件的路径
	@Value(value = "${mybatis_config_file}")
	private String mybatisConfigPath;
	
	// mybatis映射文件的路径
	@Value(value = "${mapper_path}")
	private String mapperPath;
	
	// 实体包的路径
	@Value(value = "${entity_package}")
	private String entityPath;
	
	@Autowired
	private DataSource dataSource;
	
	@Bean(value = "sqlSessionFactory")
	public SqlSessionFactoryBean getSqlSessionFactoryBean() throws IOException {
		SqlSessionFactoryBean sqlSessionFactory = new SqlSessionFactoryBean();
		
		// mybatis配置文件的路径
		sqlSessionFactory.setConfigLocation(new ClassPathResource(mybatisConfigPath));
		
		PathMatchingResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
		String packageSearchPath = PathMatchingResourcePatternResolver.CLASSPATH_ALL_URL_PREFIX + mapperPath;
		// 指定映射文件的路径
		sqlSessionFactory.setMapperLocations(resolver.getResources(packageSearchPath));
		// 配置数据源
		sqlSessionFactory.setDataSource(dataSource);
		// 配置实体包的扫描路径
		sqlSessionFactory.setTypeAliasesPackage(entityPath);
		return sqlSessionFactory;
	}
}

注意加上了@Configuration注解,表示这是一个配置类。这样Spring Boot启动的时候,就会进行相关的初始化。

现在可以来进行controller的编写。

@Controller
@RequestMapping("/man")
public class ManController {
	
	@Autowired
	private ManService manService;
	
	/**
	 * 导出接口
	 * @return
	 */
	@GetMapping("/export/pdf")
	public ModelAndView exportPdf() {
		List<Man> manList = manService.getManList();
		// 定义pdf视图
		View view = new PdfView(exportService());
		ModelAndView mv = new ModelAndView();
		// 设置视图
		mv.setView(view);
		// 加入数据模型
		mv.addObject("manList", manList);
		return mv;
	}
	
	
	/**
	 * 导出pdf自定义,每个控制器可以实现自己的导出逻辑
	 * @return
	 */
	@SuppressWarnings("unchecked")
	public PdfExportService exportService() {
		// 使用Lambda表达式
		return(model, document, writer, request, response)-> {
			try {
				// A4纸张
				document.setPageSize(PageSize.A4);
				// 标题
				document.addTitle("用户信息");
				// 换行
				document.add(new Chunk("\n"));
				// 表格,3列
				PdfPTable table = new PdfPTable(3);
				// 单元格
				PdfPCell cell = null;
				// 字体,定义为蓝色加粗
				Font f8 = new Font();
				f8.setColor(Color.BLUE);
				f8.setStyle(Font.BOLD);
				// 标题
				cell = new PdfPCell(new Paragraph("id", f8));
				// 居中对齐
				cell.setHorizontalAlignment(1);
				// 将单元格加入表格
				table.addCell(cell);
				
				// 标题
				cell = new PdfPCell(new Paragraph("age", f8));
				// 居中对齐
				cell.setHorizontalAlignment(1);
				// 将单元格加入表格
				table.addCell(cell);
				
				// 标题
				cell = new PdfPCell(new Paragraph("name", f8));
				// 居中对齐
				cell.setHorizontalAlignment(1);
				// 将单元格加入表格
				table.addCell(cell);
				
				// 获取数据模型中的manList
				List<Man> manList = (List<Man>)model.get("manList");
				for(Man man:manList) {
					document.add(new Chunk("\n"));
					cell = new PdfPCell(new Paragraph(man.getId() + ""));
					// 居中对齐
					cell.setHorizontalAlignment(1);
					table.addCell(cell);
					cell = new PdfPCell(new Paragraph(man.getAge() + ""));
					// 居中对齐
					cell.setHorizontalAlignment(1);
					table.addCell(cell);
					cell = new PdfPCell(new Paragraph(man.getName()));
					// 居中对齐
					cell.setHorizontalAlignment(1);
					table.addCell(cell);
				}
				// 文档中加入表格
				document.add(table);
			} catch(DocumentException e) {
				e.printStackTrace();
			}
		};
	}
}

可以看到我们先通过数据库查询出数据,然后放入模型和视图(ModelAndView)中,然后设置pdf视图(PdfView)。而定义PdfView时,使用Lambda表达式实现了导出服务接口,这样就可以很方便的让每一个控制器自定义样式和数据。导出pdf文件的逻辑在exportService方法中。

启动Spring Boot文件后,输入url,显示下面的结果
Spring Boot导出Pdf文件_JavaWeb


Spring Boot导出Pdf文件_导出pdf文件_02