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上记录一下