如何运用Java组件itext生成pdf
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了如何运用Java组件itext生成pdf相关的知识,希望对你有一定的参考价值。
如何使用Java组件itext 生成pdf?iText是一个能够快速产生PDF文件的java类库。iText的java类对于那些要产生包含文本,表格,图形的只读文档是很有用的。它的类库尤其与java Servlet有很好的给合。使用iText与PDF能够使你正确的控制Servlet的输出。在企业的信息系统中,报表处理一直占比较重要的作用,Java组件——iText可以非常快速的生成PDF报表。iText是着名的开放源码的站点sourceforge一个项目,是用于生成PDF文档的一个java类库。通过iText不仅可以生成PDF或rtf的文档,而且可以将XML、 html文件转化为PDF文件。通过在服务器端使用Jsp或JavaBean生成PDF报表,客户端采用超级连接显示或下载得到生成的报表,这样就很好的解决了B/S系统的报表处理问题了。
一、iText介绍
iText是着名的开放源码的站点sourceforge一个项目,是用于生成PDF文档的一个java类库。通过iText不仅可以生成PDF或rtf的文档,而且可以将XML、Html文件转化为PDF文件。
iText的安装非常方便,在http://www.lowagie.com/iText/download.html - download 网站上下载iText.jar文件后,只需要在系统的CLASSPATH中加入iText.jar的路径,在程序中就可以使用iText类库了。
二、建立第一个PDF文档
用iText生成PDF文档需要5个步骤:
①建立com.lowagie.text.Document对象的实例。
Document document = new Document();
②建立一个书写器(Writer)与document对象关联,通过书写器(Writer)可以将文档写入到磁盘中。
PDFWriter.getInstance(document, new FileOutputStream("Helloworld.PDF"));
③打开文档。
document.open();
④向文档中添加内容。
document.add(new Paragraph("Hello World"));
⑤关闭文档。
document.close();
通过上面的5个步骤,就能产生一个Helloworld.PDF的文件,文件内容为"Hello World"。
建立com.lowagie.text.Document对象的实例
com.lowagie.text.Document对象的构建函数有三个,分别是:
public Document();
public Document(Rectangle pageSize);
public Document(Rectangle pageSize,
int marginLeft,
int marginRight,
int marginTop,
int marginBottom);
构建函数的参数pageSize是文档页面的大小,对于第一个构建函数,页面的大小为A4,同Document(PageSize.A4)的效果一样;对于第三个构建函数,参数marginLeft、marginRight、marginTop、marginBottom分别为左、右、上、下的页边距。
通过参数pageSize可以设定页面大小、面背景色、以及页面横向/纵向等属性。iText定义了A0-A10、AL、LETTER、 HALFLETTER、_11x17、LEDGER、NOTE、B0-B5、ARCH_A-ARCH_E、FLSA 和FLSE等纸张类型,也可以通过Rectangle pageSize = new Rectangle(144, 720);自定义纸张。通过Rectangle方法rotate()可以将页面设置成横向。
书写器(Writer)对象
一旦文档(document)对象建立好之后,需要建立一个或多个书写器(Writer)对象与之关联。通过书写器(Writer)对象可以将具体文档存盘成需要的格式,如com.lowagie.text.PDF.PDFWriter可以将文档存成PDF文件, com.lowagie.text.html.HtmlWriter可以将文档存成html文件。
设定文档属性
在文档打开之前,可以设定文档的标题、主题、作者、关键字、装订方式、创建者、生产者、创建日期等属性,调用的方法分别是:
public boolean addTitle(String title)
public boolean addSubject(String subject)
public boolean addKeywords(String keywords)
public boolean addAuthor(String author)
public boolean addCreator(String creator)
public boolean addProducer()
public boolean addCreationDate()
public boolean addHeader(String name, String content)
其中方法addHeader对于PDF文档无效,addHeader仅对html文档有效,用于添加文档的头信息。
当新的页面产生之前,可以设定页面的大小、书签、脚注(HeaderFooter)等信息,调用的方法是:
public boolean setPageSize(Rectangle pageSize)
public boolean add(Watermark watermark)
public void removeWatermark()
public void setHeader(HeaderFooter header)
public void resetHeader()
public void setFooter(HeaderFooter footer)
public void resetFooter()
public void resetPageCount()
public void setPageCount(int pageN)
如果要设定第一页的页面属性,这些方法必须在文档打开之前调用。
对于PDF文档,iText还提供了文档的显示属性,通过调用书写器的setViewerPreferences方法可以控制文档打开时Acrobat Reader的显示属性,如是否单页显示、是否全屏显示、是否隐藏状态条等属性。
另外,iText也提供了对PDF文件的安全保护,通过书写器(Writer)的setEncryption方法,可以设定文档的用户口令、只读、可打印等属性。
添加文档内容
所有向文档添加的内容都是以对象为单位的,如Phrase、Paragraph、Table、Graphic对象等。比较常用的是段落(Paragraph)对象,用于向文档中添加一段文字。
三、文本处理
iText中用文本块(Chunk)、短语(Phrase)和段落(paragraph)处理文本。
文本块(Chunk)是处理文本的最小单位,有一串带格式(包括字体、颜色、大小)的字符串组成。如以下代码就是产生一个字体为HELVETICA、大小为10、带下划线的字符串:
Chunk chunk1 = new Chunk("This text is underlined", FontFactory.getFont(FontFactory.HELVETICA, 12, Font.UNDERLINE));
短语(Phrase)由一个或多个文本块(Chunk)组成,短语(Phrase)也可以设定字体,但对于其中以设定过字体的文本块 (Chunk)无效。通过短语(Phrase)成员函数add可以将一个文本块(Chunk)加到短语(Phrase)中,如:phrase6.add(chunk);
段落(paragraph)由一个或多个文本块(Chunk)或短语(Phrase)组成,相当于WORD文档中的段落概念,同样可以设定段落的字体大小、颜色等属性。另外也可以设定段落的首行缩进、对齐方式(左对齐、右对齐、居中对齐)。通过函数setAlignment可以设定段落的对齐方式, setAlignment的参数1为居中对齐、2为右对齐、3为左对齐,默认为左对齐。
四、表格处理
iText中处理表格的类为:com.lowagie.text.Table和com.lowagie.text.PDF.PDFPTable,对于比较简单的表格处理可以用com.lowagie.text.Table,但是如果要处理复杂的表格,这就需要 com.lowagie.text.PDF.PDFPTable进行处理。这里就类com.lowagie.text.Table进行说明。
类com.lowagie.text.Table的构造函数有三个:
①Table (int columns)
②Table(int columns, int rows)
③Table(Properties attributes)
参数columns、rows、attributes分别为表格的列数、行数、表格属性。创建表格时必须指定表格的列数,而对于行数可以不用指定。
建立表格之后,可以设定表格的属性,如:边框宽度、边框颜色、衬距(padding space 即单元格之间的间距)大小等属性。下面通过一个简单的例子说明如何使用表格,代码如下:
1:Table table = new Table(3);
2:table.setBorderWidth(1);
3:table.setBorderColor(new Color(0, 0, 255));
4:table.setPadding(5);
5:table.setSpacing(5);
6:Cell cell = new Cell("header");
7:cell.setHeader(true);
8:cell.setColspan(3);
9:table.addCell(cell);
10:table.endHeaders();
11:cell = new Cell("example cell with colspan 1 and rowspan 2");
12:cell.setRowspan(2);
13:cell.setBorderColor(new Color(255, 0, 0));
14:table.addCell(cell);
15:table.addCell("1.1");
16:table.addCell("2.1");
17:table.addCell("1.2");
18:table.addCell("2.2");
19:table.addCell("cell test1");
20:cell = new Cell("big cell");
21:cell.setRowspan(2);
22:cell.setColspan(2);
23:table.addCell(cell);
24:table.addCell("cell test2");
运行结果如下:
header
example cell with colspan 1 and rowspan 2 1.1 2.1
1.2 2.2
cell test1 big cell
cell test2
代码1-5行用于新建一个表格,如代码所示,建立了一个列数为3的表格,并将边框宽度设为1,颜色为蓝色,衬距为5。
代码6-10行用于设定表格的表头,第7行cell.setHeader(true);是将该单元格作为表头信息显示;第8行 cell.setColspan(3);指定了该单元格占3列;为表格添加表头信息时,要注意的是一旦表头信息添加完了之后,必须调用 endHeaders()方法,如第10行,否则当表格跨页后,表头信息不会再显示。
代码11-14行是向表格中添加一个宽度占一列,长度占二行的单元格。
往表格中添加单元格(cell)时,按自左向右、从上而下的次序添加。如执行完11行代码后,表格的右下方出现2行2列的空白,这是再往表格添加单元格时,先填满这个空白,然后再另起一行,15-24行代码说明了这种添加顺序。
五、图像处理
iText中处理表格的类为com.lowagie.text.Image,目前iText支持的图像格式有:GIF, Jpeg, PNG, wmf等格式,对于不同的图像格式,iText用同样的构造函数自动识别图像格式。通过下面的代码分别获得gif、jpg、png图像的实例。
Image gif = Image.getInstance("vonnegut.gif");
Image jpeg = Image.getInstance("myKids.jpg");
Image png = Image.getInstance("hitchcock.png");
图像的位置
图像的位置主要是指图像在文档中的对齐方式、图像和文本的位置关系。IText中通过函数public void setAlignment(int alignment)进行处理,参数alignment为Image.RIGHT、Image.MIDDLE、Image.LEFT分别指右对齐、居中、左对齐;当参数alignment为Image.TEXTWRAP、Image.UNDERLYING分别指文字绕图形显示、图形作为文字的背景显示。这两种参数可以结合以达到预期的效果,如setAlignment(Image.RIGHT|Image.TEXTWRAP)显示的效果为图像右对齐,文字围绕图像显示。
图像的尺寸和旋转
如果图像在文档中不按原尺寸显示,可以通过下面的函数进行设定:
public void scaleAbsolute(int newWidth, int newHeight)
public void scalePercent(int percent)
public void scalePercent(int percentX, int percentY)
函数public void scaleAbsolute(int newWidth, int newHeight)直接设定显示尺寸;函数public void scalePercent(int percent)设定显示比例,如scalePercent(50)表示显示的大小为原尺寸的50%;而函数scalePercent(int percentX, int percentY)则图像高宽的显示比例。
如果图像需要旋转一定角度之后在文档中显示,可以通过函数public void setRotation(double r)设定,参数r为弧度,如果旋转角度为30度,则参数r= Math.PI / 6。
六、中文处理
默认的iText字体设置不支持中文字体,需要下载远东字体包iTextAsian.jar,否则不能往PDF文档中输出中文字体。通过下面的代码就可以在文档中使用中文了:
BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);
com.lowagie.text.Font FontChinese = new com.lowagie.text.Font(bfChinese, 12, com.lowagie.text.Font.NORMAL);
Paragraph pragraph=new Paragraph("你好", FontChinese); 参考技术A 首先你要New一个类
转 Java操作PDF之iText详细入门
转
Java操作PDF之iText详细入门
iText是著名的开放项目,是用于生成PDF文档的一个java类库。通过iText不仅可以生成PDF或rtf的文档,而且可以将XML、Html文件转化为PDF文件。
http://itextpdf.com/
版本:itextpdf-5.2.1.jar
1、生成一个PDF
2、页面大小,页面背景色,页边空白,Title,Author,Subject,Keywords
3、设置密码
4、添加Page
5、添加水印(背景图)
6、插入Chunk, Phrase, Paragraph, List
7、插入Anchor, Image, Chapter, Section
8、画图
9、设置段落
10、删除Page
11、插入Page
12、排序page
13、目录
14、Header, Footer
15、左右文字
16、幻灯片放映
17、压缩PDF到Zip
18、分割PDF
19、合并PDF
20、Annotation
21、插入一个Table
22、表格嵌套
23、设置表格宽度
24、设置表格前后间隔
25、设置单元格宽度
26、设置单元格高度
27、设置单元格颜色
28、插入图像
29、设置表头
30、分割表格
31、设置单元格留白
32、设置单元格边框
33、PdfPTableEvent
34、PdfPCellEvent
35、PdfPageEventHelper
36、生成Barcode QRCode
37、HTML to PDF
http://itextpdf.com/
版本:itextpdf-5.2.1.jar
1、生成一个PDF
- //Step 1—Create a Document.
- Document document = new Document();
- //Step 2—Get a PdfWriter instance.
- PdfWriter.getInstance(document, new FileOutputStream(FILE_DIR + "createSamplePDF.pdf"));
- //Step 3—Open the Document.
- document.open();
- //Step 4—Add content.
- document.add(new Paragraph("Hello World"));
- //Step 5—Close the Document.
- document.close();
2、页面大小,页面背景色,页边空白,Title,Author,Subject,Keywords
- //页面大小
- Rectangle rect = new Rectangle(PageSize.B5.rotate());
- //页面背景色
- rect.setBackgroundColor(BaseColor.ORANGE);
- Document doc = new Document(rect);
- PdfWriter writer = PdfWriter.getInstance(doc, out);
- //PDF版本(默认1.4)
- writer.setPdfVersion(PdfWriter.PDF_VERSION_1_2);
- //文档属性
- doc.addTitle("[email protected]");
- doc.addAuthor("[email protected]");
- doc.addSubject("[email protected] sample");
- doc.addKeywords("[email protected]");
- doc.addCreator("[email protected]");
- //页边空白
- doc.setMargins(10, 20, 30, 40);
- doc.open();
- doc.add(new Paragraph("Hello World"));
3、设置密码
- PdfWriter writer = PdfWriter.getInstance(doc, out);
- // 设置密码为:"World"
- writer.setEncryption("Hello".getBytes(), "World".getBytes(),
- PdfWriter.ALLOW_SCREENREADERS,
- PdfWriter.STANDARD_ENCRYPTION_128);
- doc.open();
- doc.add(new Paragraph("Hello World"));
4、添加Page
- document.open();
- document.add(new Paragraph("First page"));
- document.add(new Paragraph(Document.getVersion()));
- document.newPage();
- writer.setPageEmpty(false);
- document.newPage();
- document.add(new Paragraph("New page"));
5、添加水印(背景图)
- //图片水印
- PdfReader reader = new PdfReader(FILE_DIR + "setWatermark.pdf");
- PdfStamper stamp = new PdfStamper(reader, new FileOutputStream(FILE_DIR
- + "setWatermark2.pdf"));
- Image img = Image.getInstance("resource/watermark.jpg");
- img.setAbsolutePosition(200, 400);
- PdfContentByte under = stamp.getUnderContent(1);
- under.addImage(img);
- //文字水印
- PdfContentByte over = stamp.getOverContent(2);
- over.beginText();
- BaseFont bf = BaseFont.createFont(BaseFont.HELVETICA, BaseFont.WINANSI,
- BaseFont.EMBEDDED);
- over.setFontAndSize(bf, 18);
- over.setTextMatrix(30, 30);
- over.showTextAligned(Element.ALIGN_LEFT, "DUPLICATE", 230, 430, 45);
- over.endText();
- //背景图
- Image img2 = Image.getInstance("resource/test.jpg");
- img2.setAbsolutePosition(0, 0);
- PdfContentByte under2 = stamp.getUnderContent(3);
- under2.addImage(img2);
- stamp.close();
- reader.close();
6、插入Chunk, Phrase, Paragraph, List
- //Chunk对象: a String, a Font, and some attributes
- document.add(new Chunk("China"));
- document.add(new Chunk(" "));
- Font font = new Font(Font.FontFamily.HELVETICA, 6, Font.BOLD, BaseColor.WHITE);
- Chunk id = new Chunk("chinese", font);
- id.setBackground(BaseColor.BLACK, 1f, 0.5f, 1f, 1.5f);
- id.setTextRise(6);
- document.add(id);
- document.add(Chunk.NEWLINE);
- document.add(new Chunk("Japan"));
- document.add(new Chunk(" "));
- Font font2 = new Font(Font.FontFamily.HELVETICA, 6, Font.BOLD, BaseColor.WHITE);
- Chunk id2 = new Chunk("japanese", font2);
- id2.setBackground(BaseColor.BLACK, 1f, 0.5f, 1f, 1.5f);
- id2.setTextRise(6);
- id2.setUnderline(0.2f, -2f);
- document.add(id2);
- document.add(Chunk.NEWLINE);
- //Phrase对象: a List of Chunks with leading
- document.newPage();
- document.add(new Phrase("Phrase page"));
- Phrase director = new Phrase();
- Chunk name = new Chunk("China");
- name.setUnderline(0.2f, -2f);
- director.add(name);
- director.add(new Chunk(","));
- director.add(new Chunk(" "));
- director.add(new Chunk("chinese"));
- director.setLeading(24);
- document.add(director);
- Phrase director2 = new Phrase();
- Chunk name2 = new Chunk("Japan");
- name2.setUnderline(0.2f, -2f);
- director2.add(name2);
- director2.add(new Chunk(","));
- director2.add(new Chunk(" "));
- director2.add(new Chunk("japanese"));
- director2.setLeading(24);
- document.add(director2);
- //Paragraph对象: a Phrase with extra properties and a newline
- document.newPage();
- document.add(new Paragraph("Paragraph page"));
- Paragraph info = new Paragraph();
- info.add(new Chunk("China "));
- info.add(new Chunk("chinese"));
- info.add(Chunk.NEWLINE);
- info.add(new Phrase("Japan "));
- info.add(new Phrase("japanese"));
- document.add(info);
- //List对象: a sequence of Paragraphs called ListItem
- document.newPage();
- List list = new List(List.ORDERED);
- for (int i = 0; i < 10; i++) {
- ListItem item = new ListItem(String.format("%s: %d movies",
- "country" + (i + 1), (i + 1) * 100), new Font(
- Font.FontFamily.HELVETICA, 6, Font.BOLD, BaseColor.WHITE));
- List movielist = new List(List.ORDERED, List.ALPHABETICAL);
- movielist.setLowercase(List.LOWERCASE);
- for (int j = 0; j < 5; j++) {
- ListItem movieitem = new ListItem("Title" + (j + 1));
- List directorlist = new List(List.UNORDERED);
- for (int k = 0; k < 3; k++) {
- directorlist.add(String.format("%s, %s", "Name1" + (k + 1),
- "Name2" + (k + 1)));
- }
- movieitem.add(directorlist);
- movielist.add(movieitem);
- }
- item.add(movielist);
- list.add(item);
- }
- document.add(list);
7、插入Anchor, Image, Chapter, Section
- //Anchor对象: internal and external links
- Paragraph country = new Paragraph();
- Anchor dest = new Anchor("china", new Font(Font.FontFamily.HELVETICA, 14, Font.BOLD, BaseColor.BLUE));
- dest.setName("CN");
- dest.setReference("http://www.china.com");//external
- country.add(dest);
- country.add(String.format(": %d sites", 10000));
- document.add(country);
- document.newPage();
- Anchor toUS = new Anchor("Go to first page.", new Font(Font.FontFamily.HELVETICA, 14, Font.BOLD, BaseColor.BLUE));
- toUS.setReference("#CN");//internal
- document.add(toUS);
- //Image对象
- document.newPage();
- Image img = Image.getInstance("resource/test.jpg");
- img.setAlignment(Image.LEFT | Image.TEXTWRAP);
- img.setBorder(Image.BOX);
- img.setBorderWidth(10);
- img.setBorderColor(BaseColor.WHITE);
- img.scaleToFit(1000, 72);//大小
- img.setRotationDegrees(-30);//旋转
- document.add(img);
- //Chapter, Section对象(目录)
- document.newPage();
- Paragraph title = new Paragraph("Title");
- Chapter chapter = new Chapter(title, 1);
- title = new Paragraph("Section A");
- Section section = chapter.addSection(title);
- section.setBookmarkTitle("bmk");
- section.setIndentation(30);
- section.setBookmarkOpen(false);
- section.setNumberStyle(
- Section.NUMBERSTYLE_DOTTED_WITHOUT_FINAL_DOT);
- Section subsection = section.addSection(new Paragraph("Sub Section A"));
- subsection.setIndentationLeft(20);
- subsection.setNumberDepth(1);
- document.add(chapter);
8、画图
- //左右箭头
- document.add(new VerticalPositionMark() {
- public void draw(PdfContentByte canvas, float llx, float lly,
- float urx, float ury, float y) {
- canvas.beginText();
- BaseFont bf = null;
- try {
- bf = BaseFont.createFont(BaseFont.ZAPFDINGBATS, "", BaseFont.EMBEDDED);
- } catch (Exception e) {
- e.printStackTrace();
- }
- canvas.setFontAndSize(bf, 12);
- // LEFT
- canvas.showTextAligned(Element.ALIGN_CENTER, String.valueOf((char) 220), llx - 10, y, 0);
- // RIGHT
- canvas.showTextAligned(Element.ALIGN_CENTER, String.valueOf((char) 220), urx + 10, y + 8, 180);
- canvas.endText();
- }
- });
- //直线
- Paragraph p1 = new Paragraph("LEFT");
- p1.add(new Chunk(new LineSeparator()));
- p1.add("R");
- document.add(p1);
- //点线
- Paragraph p2 = new Paragraph("LEFT");
- p2.add(new Chunk(new DottedLineSeparator()));
- p2.add("R");
- document.add(p2);
- //下滑线
- LineSeparator UNDERLINE = new LineSeparator(1, 100, null, Element.ALIGN_CENTER, -2);
- Paragraph p3 = new Paragraph("NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN");
- p3.add(UNDERLINE);
- document.add(p3);
9、设置段落
- Paragraph p = new Paragraph("In the previous example, you added a header and footer with the showTextAligned() method. This example demonstrates that it’s sometimes more interesting to use PdfPTable and writeSelectedRows(). You can define a bottom border for each cell so that the header is underlined. This is the most elegant way to add headers and footers, because the table mechanism allows you to position and align lines, images, and text.");
- //默认
- p.setAlignment(Element.ALIGN_JUSTIFIED);
- document.add(p);
- document.newPage();
- p.setAlignment(Element.ALIGN_JUSTIFIED);
- p.setIndentationLeft(1 * 15f);
- p.setIndentationRight((5 - 1) * 15f);
- document.add(p);
- //居右
- document.newPage();
- p.setAlignment(Element.ALIGN_RIGHT);
- p.setSpacingAfter(15f);
- document.add(p);
- //居左
- document.newPage();
- p.setAlignment(Element.ALIGN_LEFT);
- p.setSpacingBefore(15f);
- document.add(p);
- //居中
- document.newPage();
- p.setAlignment(Element.ALIGN_CENTER);
- p.setSpacingAfter(15f);
- p.setSpacingBefore(15f);
- document.add(p);
10、删除Page
- FileOutputStream out = new FileOutputStream(FILE_DIR + "deletePage.pdf");
- Document document = new Document();
- PdfWriter writer = PdfWriter.getInstance(document, out);
- document.open();
- document.add(new Paragraph("First page"));
- document.add(new Paragraph(Document.getVersion()));
- document.newPage();
- writer.setPageEmpty(false);
- document.newPage();
- document.add(new Paragraph("New page"));
- document.close();
- PdfReader reader = new PdfReader(FILE_DIR + "deletePage.pdf");
- reader.selectPages("1,3");
- PdfStamper stamp = new PdfStamper(reader, new FileOutputStream(FILE_DIR
- + "deletePage2.pdf"));
- stamp.close();
- reader.close();
11、插入Page
- FileOutputStream out = new FileOutputStream(FILE_DIR + "insertPage.pdf");
- Document document = new Document();
- PdfWriter.getInstance(document, out);
- document.open();
- document.add(new Paragraph("1 page"));
- document.newPage();
- document.add(new Paragraph("2 page"));
- document.newPage();
- document.add(new Paragraph("3 page"));
- document.close();
- PdfReader reader = new PdfReader(FILE_DIR + "insertPage.pdf");
- PdfStamper stamp = new PdfStamper(reader, new FileOutputStream(FILE_DIR
- + "insertPage2.pdf"));
- stamp.insertPage(2, reader.getPageSize(1));
- ColumnText ct = new ColumnText(null);
- ct.addElement(new Paragraph(24, new Chunk("INSERT PAGE")));
- ct.setCanvas(stamp.getOverContent(2));
- ct.setSimpleColumn(36, 36, 559, 770);
- stamp.close();
- reader.close();
12、排序page
- PdfWriter writer = PdfWriter.getInstance(doc, out);
- writer.setLinearPageMode();
- doc.open();
- doc.add(new Paragraph("1 page"));
- doc.newPage();
- doc.add(new Paragraph("2 page"));
- doc.newPage();
- doc.add(new Paragraph("3 page"));
- doc.newPage();
- doc.add(new Paragraph("4 page"));
- doc.newPage();
- doc.add(new Paragraph("5 page"));
- int[] order = {4,3,2,1};
- writer.reorderPages(order);
13、目录
- // Code 1
- document.add(new Chunk("Chapter 1").setLocalDestination("1"));
- document.newPage();
- document.add(new Chunk("Chapter 2").setLocalDestination("2"));
- document.add(new Paragraph(new Chunk("Sub 2.1").setLocalDestination("2.1")));
- document.add(new Paragraph(new Chunk("Sub 2.2").setLocalDestination("2.2")));
- document.newPage();
- document.add(new Chunk("Chapter 3").setLocalDestination("3"));
- // Code 2
- PdfContentByte cb = writer.getDirectContent();
- PdfOutline root = cb.getRootOutline();
- // Code 3
- @SuppressWarnings("unused")
- PdfOutline oline1 = new PdfOutline(root, PdfAction.gotoLocalPage("1", false), "Chapter 1");
- PdfOutline oline2 = new PdfOutline(root, PdfAction.gotoLocalPage("2", false), "Chapter 2");
- oline2.setOpen(false);
- @SuppressWarnings("unused")
- PdfOutline oline2_1 = new PdfOutline(oline2, PdfAction.gotoLocalPage("2.1", false), "Sub 2.1");
- @SuppressWarnings("unused")
- PdfOutline oline2_2 = new PdfOutline(oline2, PdfAction.gotoLocalPage("2.2", false), "Sub 2.2");
- @SuppressWarnings("unused")
- PdfOutline oline3 = new PdfOutline(root, PdfAction.gotoLocalPage("3", false), "Chapter 3");
14、Header, Footer
- PdfWriter writer = PdfWriter.getInstance(doc, new FileOutputStream(FILE_DIR + "setHeaderFooter.pdf"));
- writer.setPageEvent(new PdfPageEventHelper() {
- public void onEndPage(PdfWriter writer, Document document) {
- PdfContentByte cb = writer.getDirectContent();
- cb.saveState();
- cb.beginText();
- BaseFont bf = null;
- try {
- bf = BaseFont.createFont(BaseFont.HELVETICA, BaseFont.WINANSI, BaseFont.EMBEDDED);
- } catch (Exception e) {
- e.printStackTrace();
- }
- cb.setFontAndSize(bf, 10);
- //Header
- float x = document.top(-20);
- //左
- cb.showTextAligned(PdfContentByte.ALIGN_LEFT,
- "H-Left",
- document.left(), x, 0);
- //中
- cb.showTextAligned(PdfContentByte.ALIGN_CENTER,
- writer.getPageNumber()+ " page",
- (document.right() + document.left())/2,
- x, 0);
- //右
- cb.showTextAligned(PdfContentByte.ALIGN_RIGHT,
- "H-Right",
- document.right(), x, 0);
- //Footer
- float y = document.bottom(-20);
- //左
- cb.showTextAligned(PdfContentByte.ALIGN_LEFT,
- "F-Left",
- document.left(), y, 0);
- //中
- cb.showTextAligned(PdfContentByte.ALIGN_CENTER,
- writer.getPageNumber()+" page",
- (document.right() + document.left())/2,
- y, 0);
- //右
- cb.showTextAligned(PdfContentByte.ALIGN_RIGHT,
- "F-Right",
- document.right(), y, 0);
- cb.endText();
- cb.restoreState();
- }
- });
- doc.open();
- doc.add(new Paragraph("1 page"));
- doc.newPage();
- doc.add(new Paragraph("2 page"));
- doc.newPage();
- doc.add(new Paragraph("3 page"));
- doc.newPage();
- doc.add(new Paragraph("4 page"));
15、左右文字
- PdfWriter writer = PdfWriter.getInstance(document, out);
- document.open();
- PdfContentByte canvas = writer.getDirectContent();
- Phrase phrase1 = new Phrase("This is a test!left");
- Phrase phrase2 = new Phrase("This is a test!right");
- Phrase phrase3 = new Phrase("This is a test!center");
- ColumnText.showTextAligned(canvas, Element.ALIGN_LEFT, phrase1, 10, 500, 0);
- ColumnText.showTextAligned(canvas, Element.ALIGN_RIGHT, phrase2, 10, 536, 0);
- ColumnText.showTextAligned(canvas, Element.ALIGN_CENTER, phrase3, 10, 572, 0);
16、幻灯片放映
- PdfWriter writer = PdfWriter.getInstance(doc, out);
- writer.setPdfVersion(PdfWriter.VERSION_1_5);
- writer.setViewerPreferences(PdfWriter.PageModeFullScreen);//全屏
- writer.setPageEvent(new PdfPageEventHelper() {
- public void onStartPage(PdfWriter writer, Document document) {
- writer.setTransition(new PdfTransition(PdfTransition.DISSOLVE, 3));
- writer.setDuration(5);//间隔时间
- }
- });
- doc.open();
- doc.add(new Paragraph("1 page"));
- doc.newPage();
- doc.add(new Paragraph("2 page"));
- doc.newPage();
- doc.add(new Paragraph("3 page"));
- doc.newPage();
- doc.add(new Paragraph("4 page"));
- doc.newPage();
- doc.add(new Paragraph("5 page"));
17、压缩PDF到Zip
- ZipOutputStream zip = new ZipOutputStream(new FileOutputStream(FILE_DIR + "zipPDF.zip"));
- for (int i = 1; i <= 3; i++) {
- ZipEntry entry = new ZipEntry("hello_" + i + ".pdf");
- zip.putNextEntry(entry);
- Document document = new Document();
- PdfWriter writer = PdfWriter.getInstance(document, zip);
- writer.setCloseStream(false);
- document.open();
- document.add(new Paragraph("Hello " + i));
- document.close();
- zip.closeEntry();
- }
- zip.close();
18、分割PDF
- FileOutputStream out = new FileOutputStream(FILE_DIR + "splitPDF.pdf");
- Document document = new Document();
- PdfWriter.getInstance(document, out);
- document.open();
- document.add(new Paragraph("1 page"));
- document.newPage();
- document.add(new Paragraph("2 page"));
- document.newPage();
- document.add(new Paragraph("3 page"));
- document.newPage();
- document.add(new Paragraph("4 page"));
- document.close();
- PdfReader reader = new PdfReader(FILE_DIR + "splitPDF.pdf");
- Document dd = new Document();
- PdfWriter writer = PdfWriter.getInstance(dd, new FileOutputStream(FILE_DIR + "splitPDF1.pdf"));
- dd.open();
- PdfContentByte cb = writer.getDirectContent();
- dd.newPage();
- cb.addTemplate(writer.getImportedPage(reader, 1), 0, 0);
- dd.newPage();
- cb.addTemplate(writer.getImportedPage(reader, 2), 0, 0);
- dd.close();
- writer.close();
- Document dd2 = new Document();
- PdfWriter writer2 = PdfWriter.getInstance(dd2, new FileOutputStream(FILE_DIR + "splitPDF2.pdf"));
- dd2.open();
- PdfContentByte cb2 = writer2.getDirectContent();
- dd2.newPage();
- cb2.addTemplate(writer2.getImportedPage(reader, 3), 0, 0);
- dd2.newPage();
- cb2.addTemplate(writer2.getImportedPage(reader, 4), 0, 0);
- dd2.close();
- writer2.close();
19、合并PDF
- PdfReader reader1 = new PdfReader(FILE_DIR + "splitPDF1.pdf");
- PdfReader reader2 = new PdfReader(FILE_DIR + "splitPDF2.pdf");
- FileOutputStream out = new FileOutputStream(FILE_DIR + "mergePDF.pdf");
- Document document = new Document();
- PdfWriter writer = PdfWriter.getInstance(document, out);
- document.open();
- PdfContentByte cb = writer.getDirectContent();
- int totalPages = 0;
- totalPages += reader1.getNumberOfPages();
- totalPages += reader2.getNumberOfPages();
- java.util.List<PdfReader> readers = new ArrayList<PdfReader>();
- readers.add(reader1);
- readers.add(reader2);
- int pageOfCurrentReaderPDF = 0;
- Iterator<PdfReader> iteratorPDFReader = readers.iterator();
- // Loop through the PDF files and add to the output.
- while (iteratorPDFReader.hasNext()) {
- PdfReader pdfReader = iteratorPDFReader.next();
- // Create a new page in the target for each source page.
- while (pageOfCurrentReaderPDF < pdfReader.getNumberOfPages()) {
- document.newPage();
- pageOfCurrentReaderPDF++;
- PdfImportedPage page = writer.getImportedPage(pdfReader, pageOfCurrentReaderPDF);
- cb.addTemplate(page, 0, 0);
- }
- pageOfCurrentReaderPDF = 0;
- }
- out.flush();
- document.close();
- out.close();
20、Annotation
- PdfWriter writer = PdfWriter.getInstance(doc, out);
- writer.setLinearPageMode();
- doc.open();
- doc.add(new Paragraph("1 page"));
- doc.add(new Annotation("Title", "This is a annotation!"));
- doc.newPage();
- doc.add(new Paragraph("2 page"));
- Chunk chunk = new Chunk("\u00a0");
- chunk.setAnnotation(PdfAnnotation.createText(writer, null, "Title", "This is a another annotation!", false, "Comment"));
- doc.add(chunk);
- //添加附件
- doc.newPage();
- doc.add(new Paragraph("3 page"));
- Chunk chunk2 = new Chunk("\u00a0\u00a0");
- PdfAnnotation annotation = PdfAnnotation.createFileAttachment(
- writer, null, "Title", null,
- "resource/test2.jpg",
- "img.jpg");
- annotation.put(PdfName.NAME,
- new PdfString("Paperclip"));
- chunk2.setAnnotation(annotation);
- doc.add(chunk2);
21、插入一个Table
- PdfPTable table = new PdfPTable(3);
- PdfPCell cell;
- cell = new PdfPCell(new Phrase("Cell with colspan 3"));
- cell.setColspan(3);
- table.addCell(cell);
- cell = new PdfPCell(new Phrase("Cell with rowspan 2"));
- cell.setRowspan(2);
- table.addCell(cell);
- table.addCell("row 1; cell 1");
- table.addCell("row 1; cell 2");
- table.addCell("row 2; cell 1");
- table.addCell("row 2; cell 2");
- document.add(table);
22、表格嵌套
- PdfPTable table = new PdfPTable(4);
- //1行2列
- PdfPTable nested1 = new PdfPTable(2);
- nested1.addCell("1.1");
- nested1.addCell("1.2");
- //2行1列
- PdfPTable nested2 = new PdfPTable(1);
- nested2.addCell("2.1");
- nested2.addCell("2.2");
- //将表格插入到指定位置
- for (int k = 0; k < 24; ++k) {
- if (k == 1) {
- table.addCell(nested1);
- } else if (k == 20) {
- table.addCell(nested2);
- } else {
- table.addCell("cell " + k);
- }
- }
- document.add(table);
23、设置表格宽度
- PdfPTable table = new PdfPTable(3);
- PdfPCell cell;
- cell = new PdfPCell(new Phrase("Cell with colspan 3"));
- cell.setColspan(3);
- table.addCell(cell);
- cell = new PdfPCell(new Phrase("Cell with rowspan 2"));
- cell.setRowspan(2);
- table.addCell(cell);
- table.addCell("row 1; cell 1");
- table.addCell("row 1; cell 2");
- table.addCell("row 2; cell 1");
- table.addCell("row 2; cell 2");
- //100%
- table.setWidthPercentage(100);
- document.add(table);
- document.add(new Paragraph("\n\n"));
- //宽度50% 居左
- table.setHorizontalAlignment(Element.ALIGN_LEFT);
- document.add(table);
- document.add(new Paragraph("\n\n"));
- //宽度50% 居中
- table.setHorizontalAlignment(Element.ALIGN_CENTER);
- document.add(table);
- document.add(new Paragraph("\n\n"));
- //宽度50% 居右
- table.setWidthPercentage(50);
- table.setHorizontalAlignment(Element.ALIGN_RIGHT);
- document.add(table);
- document.add(new Paragraph("\n\n"));
- //固定宽度
- table.setTotalWidth(300);
- table.setLockedWidth(true);
- document.add(table);
24、设置表格前后间隔
- PdfPTable table = new PdfPTable(3);
- PdfPCell cell = new PdfPCell(new Paragraph("合并3个单元格",fontZH));
- cell.setColspan(3);
- table.addCell(cell);
- table.addCell("1.1");
- table.addCell("2.1");
- table.addCell("3.1");
- table.addCell("1.2");
- table.addCell("2.2");
- table.addCell("3.2");
- cell = new PdfPCell(new Paragraph("红色边框",fontZH));
- cell.setBorderColor(new BaseColor(255, 0, 0));
- table.addCell(cell);
- cell = new PdfPCell(new Paragraph("合并单2个元格",fontZH));
- cell.setColspan(2);
- cell.setBackgroundColor(new BaseColor(0xC0, 0xC0, 0xC0));
- table.addCell(cell);
- table.setWidthPercentage(50);
- document.add(new Paragraph("追加2个表格",fontZH));
- document.add(table);
- document.add(table);
- document.newPage();
- document.add(new Paragraph("使用‘SpacingBefore‘和‘setSpacingAfter‘",fontZH));
- table.setSpacingBefore(15f);
- document.add(table);
- document.add(table);
- document.add(new Paragraph("这里没有间隔",fontZH));
- table.setSpacingAfter(15f);
25、设置单元格宽度
- //按比例设置单元格宽度
- float[] widths = {0.1f, 0.1f, 0.05f, 0.75f};
- PdfPTable table = new PdfPTable(widths);
- table.addCell("10%");
- table.addCell("10%");
- table.addCell("5%");
- table.addCell("75%");
- table.addCell("aa");
- table.addCell("aa");
- table.addCell("a");
- table.addCell("aaaaaaaaaaaaaaa");
- table.addCell("bb");
- table.addCell("bb");
- table.addCell("b");
- table.addCell("bbbbbbbbbbbbbbb");
- table.addCell("cc");
- table.addCell("cc");
- table.addCell("c");
- table.addCell("ccccccccccccccc");
- document.add(table);
- document.add(new Paragraph("\n\n"));
- //调整比例
- widths[0] = 20f;
- widths[1] = 20f;
- widths[2] = 10f;
- widths[3] = 50f;
- table.setWidths(widths);
- document.add(table);
- //按绝对值设置单元格宽度
- widths[0] = 40f;
- widths[1] = 40f;
- widths[2] = 20f;
- widths[3] = 300f;
- Rectangle r = new Rectangle(PageSize.A4.getRight(72), PageSize.A4.getTop(72));
- table.setWidthPercentage(widths, r);
- document.add(new Paragraph("\n\n"));
- document.add(table);
26、设置单元格高度
- PdfPTable table = new PdfPTable(2);
- PdfPCell cell;
- //折行
- table.addCell(new PdfPCell(new Paragraph("折行", fontZH)));
- cell = new PdfPCell(new Paragraph("blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah"));
- cell.setNoWrap(false);
- table.addCell(cell);
- //不折行
- table.addCell(new PdfPCell(new Paragraph("不折行", fontZH)));
- cell.setNoWrap(true);
- table.addCell(cell);
- //设置高度
- table.addCell(new PdfPCell(new Paragraph("任意高度",fontZH)));
- cell = new PdfPCell(new Paragraph("1. blah blah\n2. blah blah blah\n3. blah blah\n4. blah blah blah\n5. blah blah\n6. blah blah blah\n7. blah blah\n8. blah blah blah"));
- table.addCell(cell);
- //固定高度
- table.addCell(new PdfPCell(new Paragraph("固定高度",fontZH)));
- cell.setFixedHeight(50f);
- table.addCell(cell);
- //最小高度
- table.addCell(new PdfPCell(new Paragraph("最小高度",fontZH)));
- cell = new PdfPCell(new Paragraph("最小高度:50",fontZH));
- cell.setMinimumHeight(50f);
- table.addCell(cell);
- //最后一行拉长到page底部
- table.setExtendLastRow(true);
- table.addCell(new PdfPCell(new Paragraph("拉长最后一行",fontZH)));
- cell = new PdfPCell(new Paragraph("最后一行拉长到page底部",fontZH));
- table.addCell(cell);
- document.add(table);
27、设置单元格颜色
- PdfPTable table = new PdfPTable(4);
- PdfPCell cell;
- cell = new PdfPCell(new Paragraph("颜色测试",fontZH));
- table.addCell(cell);
- //红色背景,无边框
- cell = new PdfPCell(new Paragraph("红色背景,无边框",fontZH));
- cell.setBorder(Rectangle.NO_BORDER);
- cell.setBackgroundColor(BaseColor.RED);
- table.addCell(cell);
- //绿色背景,下边框
- cell = new PdfPCell(new Paragraph("绿色背景,下边框",fontZH));
- cell.setBorder(Rectangle.BOTTOM);
- cell.setBorderColorBottom(BaseColor.MAGENTA);
- cell.setBorderWidthBottom(5f);
- cell.setBackgroundColor(BaseColor.GREEN);
- table.addCell(cell);
- //蓝色背景,上边框
- cell = new PdfPCell(new Paragraph("蓝色背景,上边框",fontZH));
- cell.setBorder(Rectangle.TOP);
- cell.setUseBorderPadding(true);
- cell.setBorderWidthTop(5f);
- cell.setBorderColorTop(BaseColor.CYAN);
- cell.setBackgroundColor(BaseColor.BLUE);
- table.addCell(cell);
- cell = new PdfPCell(new Paragraph("背景灰色度",fontZH));
- table.addCell(cell);
- cell = new PdfPCell(new Paragraph("0.25"));
- cell.setBorder(Rectangle.NO_BORDER);
- cell.setGrayFill(0.25f);
- table.addCell(cell);
- cell = new PdfPCell(new Paragraph("0.5"));
- cell.setBorder(Rectangle.NO_BORDER);
- cell.setGrayFill(0.5f);
- table.addCell(cell);
- cell = new PdfPCell(new Paragraph("0.75"));
- cell.setBorder(Rectangle.NO_BORDER);
- cell.setGrayFill(0.75f);
- table.addCell(cell);
- document.add(table);
28、插入图像
- Image image = Image.getInstance("resource/test2.jpg");
- float[] widths = { 1f, 4f };
- PdfPTable table = new PdfPTable(widths);
- //插入图片
- table.addCell(new PdfPCell(new Paragraph("图片测试", fontZH)));
- table.addCell(image);
- //调整图片大小
- table.addCell("This two");
- table.addCell(new PdfPCell(image, true));
- //不调整
- table.addCell("This three");
- table.addCell(new PdfPCell(image, false));
- document.add(table);
29、设置表头
- String[] bogusData = { "M0065920", "SL", "FR86000P", "PCGOLD",
- "119000", "96 06", "2001-08-13", "4350", "6011648299",
- "FLFLMTGP", "153", "119000.00" };
- int NumColumns = 12;
- // 12
- PdfPTable datatable = new PdfPTable(NumColumns);
- int headerwidths[] = { 9, 4, 8, 10, 8, 11, 9, 7, 9, 10, 4, 10 }; // percentage
- datatable.setWidths(headerwidths);
- datatable.setWidthPercentage(100);
- datatable.getDefaultCell().setPadding(3);
- datatable.getDefaultCell().setBorderWidth(2);
- datatable.getDefaultCell().setHorizontalAlignment(Element.ALIGN_CENTER);
- datatable.addCell("Clock #");
- datatable.addCell("Trans Type");
- datatable.addCell("Cusip");
- datatable.addCell("Long Name");
- datatable.addCell("Quantity");
- datatable.addCell("Fraction Price");
- datatable.addCell("Settle Date");
- datatable.addCell("Portfolio");
- datatable.addCell("ADP Number");
- datatable.addCell("Account ID");
- datatable.addCell("Reg Rep ID");
- datatable.addCell("Amt To Go ");
- datatable.setHeaderRows(1);
- //边框
- datatable.getDefaultCell().setBorderWidth(1);
- //背景色
- for (int i = 1; i < 1000; i++) {
- for (int x = 0; x < NumColumns; x++) {
- datatable.addCell(bogusData[x]);
- }
- }
- document.add(datatable);
30、分割表格
- //横向分割
- PdfContentByte cb = writer.getDirectContent();
- PdfPTable table = new PdfPTable(10);
- for (int k = 1; k <= 100; ++k) {
- table.addCell("The number " + k);
- }
- table.setTotalWidth(400);
- table.writeSelectedRows(0, 5, 0, -1, 5, 700, cb);
- table.writeSelectedRows(5, -1, 0, -1, 210, 700, cb);
31、设置单元格留白
- PdfPTable table = new PdfPTable(2);
- PdfPCell cell;
- Paragraph p = new Paragraph("Quick brown fox jumps over the lazy dog. Quick brown fox jumps over the lazy dog.");
- table.addCell(new PdfPCell(new Paragraph("默认",fontZH)));
- table.addCell(p);
- table.addCell(new PdfPCell(new Paragraph("Padding:10",fontZH)));
- cell = new PdfPCell(p);
- cell.setPadding(10f);
- table.addCell(cell);
- table.addCell(new PdfPCell(new Paragraph("Padding:0",fontZH)));
- cell = new PdfPCell(p);
- cell.setPadding(0f);
- table.addCell(cell);
- table.addCell(new PdfPCell(new Paragraph("上Padding:0 左Padding:20",fontZH)));
- cell = new PdfPCell(p);
- cell.setPaddingTop(0f);
- cell.setPaddingLeft(20f);
- table.addCell(cell);
- document.add(table);
- document.newPage();
- table = new PdfPTable(2);
- table.addCell(new PdfPCell(new Paragraph("没有Leading",fontZH)));
- table.getDefaultCell().setLeading(0f, 0f);
- table.addCell("blah blah\nblah blah blah\nblah blah\nblah blah blah\nblah blah\nblah blah blah\nblah blah\nblah blah blah\n");
- table.getDefaultCell().setLeading(14f, 0f);
- table.addCell(new PdfPCell(new Paragraph("固定Leading:14pt",fontZH)));
- table.addCell("blah blah\nblah blah blah\nblah blah\nblah blah blah\nblah blah\nblah blah blah\nblah blah\nblah blah blah\n");
- table.addCell(new PdfPCell(new Paragraph("相对于字体",fontZH)));
- table.getDefaultCell().setLeading(0f, 1.0f);
- table.addCell("blah blah\nblah blah blah\nblah blah\nblah blah blah\nblah blah\nblah blah blah\nblah blah\nblah blah blah\n");
- document.add(table);
32、设置单元格边框
- //没有边框
- PdfPTable table1 = new PdfPTable(3);
- table1.getDefaultCell().setBorder(PdfPCell.NO_BORDER);
- table1.addCell(new Paragraph("Cell 1"));
- table1.addCell(new Paragraph("Cell 2"));
- table1.addCell(new Paragraph("Cell 3"));
- document.add(table1);
- //边框粗细颜色
- document.newPage();
- Rectangle b1 = new Rectangle(0f, 0f);
- b1.setBorderWidthLeft(6f);
- b1.setBorderWidthBottom(5f);
- b1.setBorderWidthRight(4f);
- b1.setBorderWidthTop(2f);
- b1.setBorderColorLeft(BaseColor.RED);
- b1.setBorderColorBottom(BaseColor.ORANGE);
- b1.setBorderColorRight(BaseColor.YELLOW);
- b1.setBorderColorTop(BaseColor.GREEN);
- PdfPTable table2 = new PdfPTable(1);
- PdfPCell cell = new PdfPCell(new Paragraph("Cell 1"));
- cell.cloneNonPositionParameters(b1);
- table2.addCell(cell);
- document.add(table2);
33、PdfPTableEvent
34、PdfPCellEvent
35、PdfPageEventHelper
36、生成Barcode QRCode
- String myString = "http://www.google.com";
- Barcode128 code128 = new Barcode128();
- code128.setCode(myString.trim());
- code128.setCodeType(Barcode128.CODE128);
- Image code128Image = code128.createImageWithBarcode(cb, null, null);
- code128Image.setAbsolutePosition(10,700);
- code128Image.scalePercent(125);
- doc.add(code128Image);
- BarcodeQRCode qrcode = new BarcodeQRCode(myString.trim(), 1, 1, null);
- Image qrcodeImage = qrcode.getImage();
- qrcodeImage.setAbsolutePosition(10,600);
- qrcodeImage.scalePercent(200);
- doc.add(qrcodeImage);
37、HTML to PDF
- Document document = new Document(PageSize.LETTER);
- PdfWriter.getInstance(document, new FileOutputStream("c://testpdf1.pdf"));
- document.open();
- HTMLWorker htmlWorker = new HTMLWorker(document);
- htmlWorker.parse(new StringReader("<h1>This is a test!</h1>"));
- document.close();
以上是关于如何运用Java组件itext生成pdf的主要内容,如果未能解决你的问题,请参考以下文章