使用Epublib解析EPub文件

Epublib是一个用于处理epub文件的java类库，可以对epub文件进行读写处理；而且提供了一个阅读器，可以直接运行（java -jar 方式），并可以打开epub类型的文件进行阅读；（引用官方网页的一句话：Epublib is a java library for managing epub files. It’s capable of reading and writing epub files programmatically.）

 

Epublib 主页：http://www.siegmann.nl/epublib

Epub viewer的地址：https://github.com/downloads/psiegman/epublib/epublib-viewer-latest.jar

在线API：http://www.siegmann.nl/static/epublib/apidocs/

 

 

容易遇到的问题：在epublib的网页上并没有提到epublib所依赖的jar，那么在创建epub文件的时候，就会报如下异常：

 

 

Exception in thread "main" java.lang.NoClassDefFoundError: org/xmlpull/v1/XmlPullParserFactory
	at nl.siegmann.epublib.epub.EpubProcessorSupport.createXmlSerializer(EpubProcessorSupport.java:80)
	at nl.siegmann.epublib.epub.EpubProcessorSupport.createXmlSerializer(EpubProcessorSupport.java:74)
	at nl.siegmann.epublib.epub.NCXDocument.createNCXResource(NCXDocument.java:181)
	at nl.siegmann.epublib.epub.NCXDocument.createNCXResource(NCXDocument.java:177)
	at nl.siegmann.epublib.epub.EpubWriter.initTOCResource(EpubWriter.java:67)
	at nl.siegmann.epublib.epub.EpubWriter.write(EpubWriter.java:51)
	at org.lazyboy.work.document.EPubUtil.createNewFile(EPubUtil.java:124)
	at org.lazyboy.work.document.EPubUtil.main(EPubUtil.java:144)
Caused by: java.lang.ClassNotFoundException: org.xmlpull.v1.XmlPullParserFactory
	at java.net.URLClassLoader$1.run(URLClassLoader.java:202)
	at java.security.AccessController.doPrivileged(Native Method)
	at java.net.URLClassLoader.findClass(URLClassLoader.java:190)
	at java.lang.ClassLoader.loadClass(ClassLoader.java:307)
	at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:301)
	at java.lang.ClassLoader.loadClass(ClassLoader.java:248)
	... 8 more

 

 

根据提示：org.xmlpull.v1.XmlPullParserFactory类没有找到，那么就去找合适的jar吧·····你会发现有很多jar里包含了这个类，但是如果不巧你添加了jar包之后，虽然没有了这个异常，但是你会遇到另一个空指针的异常，如下所示：

 

 

Exception in thread "main" java.lang.NullPointerException
	at org.xmlpull.mxp1_serializer.MXSerializer.startDocument(MXSerializer.java:379)
	at nl.siegmann.epublib.epub.PackageDocumentWriter.write(PackageDocumentWriter.java:38)
	at nl.siegmann.epublib.epub.EpubWriter.writePackageDocument(EpubWriter.java:112)
	at nl.siegmann.epublib.epub.EpubWriter.write(EpubWriter.java:53)
	at org.lazyboy.work.document.EPubUtil.createNewFile(EPubUtil.java:124)
	at org.lazyboy.work.document.EPubUtil.main(EPubUtil.java:144)

 

 

那就是你加错jar包了，经过多次试验后，发现应该加入一个kxml2的jar包，其maven坐标如下：

 

 

	<dependency>
		<groupId>kxml2</groupId>
		<artifactId>kxml2</artifactId>
		<version>2.2.2</version>
	</dependency>

 

 本人需要做的操作是：读取一个epub文件，取出需要的chapter，生成一个新的epub文件，或者根据比例对源epub文件进行裁剪；在此过程中遇到了问题，在blog上记录一下