总结的Javadoc转换chm帮助文档的四种方法

JAVADOC：自动生成你的程序开发文档当初学习编程序的时候，就从来没有想过要给自己写的那几个程序编写一份完整的文档，所有的注释都仅仅是为了自己当时能够想起这段代码到底是干什么的，没有人想过这些代码的升级、共享问题。

但是，开始做商业软件之后，一切都变了，尤其是大型的团队开发项目中。

大家也许注意到了，java的API文档总是紧紧跟随着JSDK的版本的提高而保持着最新的状态。

试想一下，手工维护这么复杂的文档可能吗？当然不可能，这一切都是javadoc这个小程序的功劳（当然也有java类库作者们做程序注释的一份功劳）。

API文档就是用它根据最新的源代码自动生成的，一切都是这么容易——只需要你把本来就要写的注释写得更规范一些，再稍微详细一些。

然而，大家似乎好像根本就没有意识到它的存在，很少有人会用它来为自己的程序生成文档。

不知道，你现在是否对它有了兴趣？好吧，下面我们就开始这个令人轻松的自动文档生成之旅。

【如何插入注释】javadoc为你生成代码不是凭空来的，也不是它会自动分析你的代码——每个人都有自己的代码风格，如果要进行分析翻译恐怕还是机器码更容易生成百倍。

它的分析机制依赖于你按照规范为你的代码添加应有而足够的注释。

只有你老老实实写注释，才有可能把以前需要做双份的工作一次做了。

Javadoc工具可以从下列对象中提取出信息：· 包。

· 公共类。

· 公共接口。

· 公共或者受保护的方法。

· 公共或者受保护的变量/常数。

针对每一种特性，你都应该提供一条注释。

每一条注释都要以/**打头，以*/结尾。

在每条/** …… */文档注释可包括任意格式的文字。

它的第一个句子应该是一个总结性的语句，javadoc会自动把它提出来制作总结页。

当然，这里你完全可以使用一些HTML的记号，例如<I>表示斜体；...表示等宽的“打印机”字体；<B>表示粗体；甚至用包括一副图象等等。

1.1Java CHM格式的API帮助文档的制作详解1、*.chm格式的帮助Visual Studio 6.0和Windows 98的帮助文件风格，和以前的版本大不一样，这种被微软称为下一代的在线帮助（next－generation online help）形式，是一种编译过的HTML文件，后缀是.CHM。

它不仅制作容易，而且支持超文本的全部语法特征，换句话说，只要是你能在主页上制作出来的效果，几乎都可以在这种形式的帮助文件中体现出来。

原来的软件大多数采用扩展名为HLP的帮助文件（WinHelp ），但随着互联网的发展，这种格式的帮助文件已经难以适应软件在线帮助的需要，以及更加人性化更加简单易于查看的需要，因此一种全新的帮助文件系统HTML Help由微软率先在Windows98中使用了。

由于它是一个经过压缩的网页集合，不但减小了文件的体积，更利于用户从INTERNET上下载，并且还支持HTML、Ac－tiveX、Java、JScript、Visual Basic Scripting 和多种图像格式(.jpeg、.gif 和.png 等)，因此很快受到广大软件作者和软件用户的欢迎。

2、Microsoft HTML Help Workshop制作这种形式的帮助文件，需要使用Microsoft HTML Help Workshop编译你已经写好的超文本文件。

它完全安装后只有4.6M，包括两组工具集：HTML Help Workshop和HTML Help Image Editor。

后者在网页制作中常用到图形文件的编辑和修改。

要建立CHM帮助文件必须先将我们所有想要让其出现在帮助文件中的内容做成相对独立的网页文件（即HTML文件），这些工作可以在HTML Help Workshop中完成，也可以应用其他网页编辑器（如FontPage或HotDog）来制作。

3、帮助文件中所要用到的各个文件：（1）.hhp文件：这是最常用的一类文件，它实际上是“HTML Help project”的缩写，表示HTML帮助文件项目，它是生成CHM文件最直接用到的一类文件，只需要有一个hhp文件就可以根据它来编译相应的CHM文件。

idea javadoc文档的生成方法【最新版3篇】目录（篇1）1.介绍 Javadoc2.Javadoc 的生成方法3.生成 Javadoc 文档的步骤4.常见问题与解决方法5.结论正文（篇1）一、介绍 JavadocJavadoc 是 Java 开发中的一种文档生成工具，它可以从 Java 源代码中提取类、方法、成员变量等注释信息，并生成 HTML 格式的文档。

Javadoc 生成的文档通常被用于项目的 API 文档、开发者文档等。

二、Javadoc 的生成方法Javadoc 的生成方法主要有两种：1.命令行生成通过在命令行中执行 Javadoc 命令，可以直接生成 HTML 文档。

这种方法可以灵活地控制生成的文档内容，但需要对 Javadoc 命令行参数有一定了解。

2.集成开发环境（IDE）生成在 Eclipse、IntelliJ IDEA 等集成开发环境中，可以通过插件或内置功能生成 Javadoc 文档。

这种方法操作简单，但可能受限于 IDE 的功能。

三、生成 Javadoc 文档的步骤1.编写 Java 源代码并添加注释在编写 Java 代码时，需要为类、方法、成员变量等添加适当的注释。

这些注释将在生成的 Javadoc 文档中展示。

2.准备 Javadoc 生成工具根据所选的生成方法，准备相应的 Javadoc 生成工具。

- 命令行生成：确保已安装 Javadoc 工具，并了解相关命令行参数。

- 集成开发环境生成：安装相应的插件或启用 IDE 内置功能。

3.生成 Javadoc 文档根据所选的生成方法，执行 Javadoc 生成命令。

在命令行生成中，需要在命令行中执行 Javadoc 命令；在集成开发环境生成中，可通过 IDE 的相关功能生成文档。

4.查看生成的 Javadoc 文档文档生成完成后，可以查看生成的 Javadoc 文档。

通常情况下，文档会生成在指定的输出目录中。

四、常见问题与解决方法1.缺少注释在生成 Javadoc 文档时，可能会发现某些类、方法、成员变量没有注释。

HTML Help Workshop是Microsoft推出的免费的chm编译器，“汉化新世纪”提供了汉化版下载，不过该版本附带了广告插件。

如果您不介意的话笔者建议您到Microsoft页面下载，毕竟Microsoft是chm文件的鼻祖。

目前，Microsoft提供的版本是绿色版的，将下载的文件解压到一个目录，点击文件夹中的Setup.exe 安装即可使用。

除了主程序，还有一个叫做“HTML Help Image Editor”图像编辑器。

首先来认识一下界面：制作chm文件首先需要html文件，如果您手头没有html文件，那么请及时制作。

1.建立"Project"其次，是在HTML Help Workshop中建立一个“project”。

制作步骤如下：▪“File”→“New”→“Project”▪“下一步”→填写“Project”的存放名称和路径▪“下一步”→“下一步”→完成以上步骤生成一个*.hhp文件，这个就是要编译的主文件。

其结果如下：上图中，在"change project options"可以设置chm的默认显示首页，标题，语言，允许全文搜索(“Compile full-text search information”)以及合并chm。

注意：•“add/remove topic files”用来需要编译的HTML文件；•“add/modify windows definitions”用来定义CHM文件的窗口显示（按钮，位置，窗口大小以及工具栏包含的按钮）和内容等。

请跳转到“搜索框”一节查看具体内容。

•“help API information”是连接应用程序的API接口，具体内容请参阅：这里2. 编辑“目录”在建立“project”后，下一步是设置“contents”（目录）。

点击“contents” 按钮，我们就跳转到了目录编辑框。

首次使用“Contents”时，程序会自动帮您创建一个“Contents” （目录），您只需要按默认设置即可。

Java⽂档注释⽤法+JavaDoc的使⽤说明简介⽂档注释负责描述类、接⼝、⽅法、构造器、成员属性。

可以被JDK提供的⼯具 javadoc 所解析，⾃动⽣成⼀套以⽹页⽂件形式体现该程序说明⽂档的注释。

注意：⽂档注释必须写在类、接⼝、⽅法、构造器、成员字段前⾯，写在其他位置⽆效。

写在类上⾯的JavaDoc写在类上的⽂档标注⼀般分为三段：第⼀段：概要描述，通常⽤⼀句或者⼀段话简要描述该类的作⽤，以英⽂句号作为结束第⼆段：详细描述，通常⽤⼀段或者多段话来详细描述该类的作⽤，⼀般每段话都以英⽂句号作为结束第三段：⽂档标注，⽤于标注作者、创建时间、参阅类等信息第⼀段：概要描述单⾏⽰例：package org.springframework.jdbc.core;/*** Simple adapter for {@link PreparedStatementSetter} that applies a given array of arguments.**/public class ArgumentPreparedStatementSetter implements PreparedStatementSetter, ParameterDisposer {}多⾏⽰例：package ng;/*** The {@code Long} class wraps a value of the primitive type {@code* long} in an object. An object of type {@code Long} contains a* single field whose type is {@code long}.** <p> In addition, this class provides several methods for converting* a {@code long} to a {@code String} and a {@code String} to a {@code* long}, as well as other constants and methods useful when dealing* with a {@code long}.** <p>Implementation note: The implementations of the "bit twiddling"* methods (such as {@link #highestOneBit(long) highestOneBit} and* {@link #numberOfTrailingZeros(long) numberOfTrailingZeros}) are* based on material from Henry S. Warren, Jr.'s <i>Hacker's* Delight</i>, (Addison Wesley, 2002).** @author Lee Boynton* @author Arthur van Hoff* @author Josh Bloch* @author Joseph D. Darcy* @since JDK1.0*/public final class Long extends Number implements Comparable<Long> {}在注释中出现以@开头的东东被称之为Javadoc⽂档标记，是JDK定义好的如@author、@version、@since、@see、@link、@code、@param、@return、@exception、@throws等。

Java帮助⽂档的制作和使⽤⼀般我们写⼀些⼤型项⽬时，会有多⼈分⼯合作负责写不同的类。

1.其中包含main⽅法的类叫做测试类 测试类的作⽤：创建其他类的对象，并调⽤其他类的功能。

2.包含了详细步骤的⽅法都放在⼀个类中，这个类叫做功能类 功能类的作⽤：⽤来存放相关功能的操作。

⼤家分⼯合作的时候，别⼈给我们的⽂件⼀般都会是class⽂件，⽽不是java⽂件。

因为class⽂件是看不到源代码的，这样⼀来，你根本不知道别⼈的功能类⾥的源代码是怎么写的。

为了更好的使⽤别⼈的class⽂件，⼀般会制作⼀个说明书，⽤于讲解功能类中各个⽅法的使⽤步骤。

如何制作⼀个说明书？1.写⼀个功能类2.对这个类中的⽅法加⼊⽂档注释3.⽤⼯具解析⽂档注释(javadoc⼯具) ⼯具使⽤格式：javadoc -d ⽬录 -auther -version 功能类名.java 注释⽂档的书写格式：第⼀⾏开头使⽤/**，最后⼀⾏使⽤*/，中间每⼀⾏开头使⽤* /** * * */ 注意事项：1.功能类需要⽤public修饰，否则没有权限访问； 2.有参数的⽅法必须使⽤"@param ⽅法名"来注释； 3.有返回值的⽅法必须使⽤"@return"来注释。

使⽤说明书：找到上⾯⽬录所在位置，使⽤浏览器打开index.html⽂件。

使⽤帮助⽂档： 标准的帮助⽂档⼀般都是chm格式，具体使⽤步骤如下： 1.直接打开chm格式的帮助⽂档。

2.点击“显⽰”，打到“索引”，看到输⼊框。

3.输⼊要查找的名字，⽐如Scanner。

4.看包的名称：如果是ng包下的类就不需要导⼊，其他的包均需要导⼊。

Scanner类是java.util包下的类，需要导⼊：java.util.Scanner。

5.看类的解释和说明，还有类的使⽤版本，不同的jdk版本能使⽤的类不同。

6.看类的结构： 成员变量 字段摘要 构造⽅法 构造⽅法摘要 成员⽅法 ⽅法摘要 7.学习构造⽅法 A.有构造⽅法，就创建对象 B.没有构造⽅法，成员可能都是静态的 8.看成员⽅法 A.左边 是否静态：如果静态，可以通过类名调⽤ 返回值类型：返回什么，就⽤什么接收 B.右边 看⽅法名：⽅法名称不要写错 参数列表：⼈家要什么参数，就给什么；⼈家要⼏个参数，你就给⼏个。

Javadoc文档生成方式1. 什么是Javadoc文档Javadoc文档是一种用于描述Java代码的文档标记语言。

它能够从代码中提取注释并生成可读性强的HTML格式文档，以帮助开发人员更好地理解和使用代码。

Javadoc文档通常包含类、方法、字段等的详细描述，包括功能、参数、返回值、异常等信息。

2. Javadoc文档的重要性Javadoc文档是Java开发中必不可少的一部分，具有以下几个重要作用：•提供代码的使用说明：Javadoc文档能够清晰地描述代码的功能和使用方法，方便其他开发人员快速了解和使用代码。

•促进团队协作：Javadoc文档可以作为团队协作的重要工具，通过统一的文档格式和规范，促进团队成员之间的沟通和协作。

•提高代码的可读性：Javadoc文档能够将代码的关键信息提取出来，并以易于阅读的方式展示出来，提高代码的可读性和可维护性。

•方便代码维护和重构：Javadoc文档中包含了代码的详细描述和设计意图，能够帮助开发人员更好地理解代码，从而方便代码的维护和重构。

3. Javadoc文档生成方式3.1 使用命令行工具生成Javadoc文档可以通过命令行工具生成，具体步骤如下：1.打开命令行终端，进入代码所在的目录。

2.使用以下命令生成Javadoc文档：javadoc -d <output-directory> <source-files>–-d指定生成的文档输出目录。

–<output-directory>为生成的文档输出目录的路径。

–<source-files>为需要生成文档的源代码文件或目录。

3.等待命令执行完成，生成的Javadoc文档将保存在指定的输出目录中。

3.2 使用集成开发环境（IDE）生成大多数集成开发环境（IDE）都提供了生成Javadoc文档的功能，具体步骤如下（以Eclipse为例）：1.打开Eclipse，进入项目。

Javadoc转换chm帮助文档的四种方法总结V1.0目录关键词 (1)前言 (1)预处理 (1)第一种：使用jd2chm来生成chm帮助文档 (4)使用原版jd2chm_exe_03转换成chm (4)生成英文版本如下 (4)生成中文版本如下 (5)使用网上高手改进的版本jd2chm_0.34转换成chm (7)生成英文版本如下 (7)生成中文版本如下 (8)第二种：使用javadoc2chm来生成chm帮助文档 (11)生成英文版本如下 (11)生成中文版本如下 (12)第三种：使用javadoc2help来生成chm帮助文档 (18)生成英文版本如下 (18)生成中文版本如下 (18)第四种：使用google code里面的javadoc2chm项目构建 (20)生成英文版本如下 (20)生成中文版本如下 (22)总结 (23)李顺利[2010年1月6日]关键词Javadoc chm 转换jd2chm javadoc2chm javadoc2help Javadoc2chm 中文乱码李顺利前言朋友，当您在一个项目完成后，是不是需要把你的源码打包并且把注释打成Javadoc交给客户，Eclipse或者MyEclipse自动打成的Javadoc文档都是基于网页格式的，打开是很方便，不过真的用的时候，搜索每个方法或者什么的就很麻烦了，而chm帮助文档格式不但文件小，查阅都很方便，所以网上就出现了很多把Javadoc转换为chm格式的帮助文档的软件/工具或者方法。

自己最近需要真的需要这个方面的需求，查阅了网上很多方法，发现很多都是写的很不详细，对于我这种刚接触的很是不清楚，经过我的学习和理解，现提供从网上总结的Javadoc 转换chm帮助文档的四种方法，详细提供各个转换的步骤供大家学习，并且提供英文版本和中文版本Javadoc转换过程中出现的问题，特别是中文的时候出现的乱码现象，也提供一些解决方案。

Javadoc转换成chm帮助文档笔记汇总前言：哥们姐们儿们，当我们完成代码的编写是不是都希望写一个完美的帮助文档方便使用，相信大家也都查阅过一些Javadoc转换成chm帮助文档的资料，在操作过程中也一定遇到了种种问题，本人最近就纠结于生成文档时出现的种种问题，但是经过各种尝试与努力最终迎刃而解，现将自己遇到的问题、解决办法和本人的一些浅见与大家一同分享，希望可以对大家有所帮助。

前期准备：在转换之前需要安装HTML Help Workshop。

正文：一、如何使用jd2chm来生成chm帮助文档首先，需要先生成index.html文件。

在项目名称上右键----Export----Java----Javadoc----next到现在会出现下图：在Configure的地方找到jdk下javadoc.exe的目录即可，在Select types forwhich javadoc will be generated下选择想生成api的工程，下面的Destination 选择生成api之后存放的目录，接着Next，会进入下面页面：在这个页面选择默认即可，点击Next,根据项目字符编码，在框框里设置字符集，，在JRE source compatibility 中选择jdk的版本，Finish---yes to all。

接下来就到了要紧的地方，因为在我要生成的api当中涉及到对目录层次、图标、项目名称的修改等操作，所以我需要生成*.hhp,*.hhk,*.hhc文件，这时就需要用较高版本的jd2chm.exe，在这里我用的是jd2chm_0.34版本的。

双击0.34版本的jd2chm,此时会出现如下页面：将存放index.html的路径写在上图中的位置，因为这个位置不让粘贴，可以将index.html文件拖到这个位置，再将index.html删掉就是我们要的路径，回车，就到了下图的位置，我们需要写入chm 的file name以及chm 的window title，下面的选项都选择y就可以了，尤其最后一个最重要，选择y在我们设置的路径下会出现一个about.html文件。

HTML Help WorkShop制作chm帮助文档一位做共享软件做得很成功的同行说过：“一个好的共享软件，首先操作要简单容易上手，其次一定附带一个详尽的帮助手册。

”可见，对于一个软件来说，帮助文件的重要性。

不过大部分程序人员（包括我）都忽略了帮助文件的重要性，都认为自己做的软件相当简单，一看就会，殊不知我们是一个连底层都了解的开发人员。

前段时间本人做了一个图片处理软件，免费给一些同学和朋友使用，很多人的反馈是不知道怎么用，于是本人花时间做了一个帮助手册，得到了很多好的反馈，本人准备在结合他们的反馈意见之后发布一个Realease版本。

在使用的过程中，我使用了微软提供的HTML Help WorkShop这个软件，可惜是英文的，为了方便广大对英语不是很熟悉的朋友，本人写了一份制作图解，希望对大家有帮助。

图1 HTML Help WorkShop运行界面图2 新建一个工程图3 是否从WinHelp项目转换图4设置项目文件的保存位置图5 如果已经制作了hhc、hhk和htm文件，可以勾选上面的相应项图6 新建帮助文件工程向导结束图7 新建工程向导结束之后的界面图8 contens选项卡图9 添加一个内容页图10 指定内容页的位置图11 选取内容页图12 填写标题（对比图9）图13 Index选项卡图14 添加Index向导第一步图15 添加Index向导第二步图16 填写完成之后的状况图17 指定chm文件的起始页图18 编译生成chm文件说明：在制作过程中用到了.hhp、.hhk和.hhc三种文件，它们的作用分别如下：.hhp：保存项目文件配置的有关内容，如便以后生成chm的语言以及打开chm的起始页；.hhk：保存关键词索引目录的内容，其实是一个html文件，可以用记事本等打开查看和编辑。

.hhc：保存内容页的配置。

其实是一个html文件，可以用记事本等打开查看和编辑。

通过记事本查看上面文件的内容之后，如果我们以网页的标题作为索引关键词，我们会发现.hhk和. hhc，这样可以直接copy，省去很多步骤。

java字符转码的三种⽅法总结及实例java字符转码:三种⽅法转码成功的前提:解码后⽆乱码转码流程:⽂件(gbk)-->解码-->编码--->⽂件(utf-8)注:如有问题请留⾔下⾯具体的实例⽅法⼀:ng.String//⽤于解码的构造器:String(byte[] bytes, int offset, int length, String charsetName)String(byte[] bytes, String charsetName)⽤于编码的⽅法:byte[] getBytes(String charsetName) //使⽤指定字符集进⾏编码byte[] getBytes() //使⽤系统默认字符集进⾏编码public void convertionString() throws UnsupportedEncodingException{String s = "清⼭";byte[] b = s.getBytes("gbk");//编码String sa = new String(b, "gbk");//解码:⽤什么字符集编码就⽤什么字符集解码System.out.println(sa);b = sa.getBytes("utf-8");//编码sa = new String(b, "utf-8");//解码System.err.println(sa);}⽅法⼆:java.io.InputStreamReader/OutputStreamWriter:桥转换package com.qingshan.io;import java.io.FileInputStream;import java.io.FileOutputStream;import java.io.IOException;import java.io.InputStream;import java.io.InputStreamReader;import java.io.OutputStream;import java.io.OutputStreamWriter;import java.io.UnsupportedEncodingException;/*** <pre>* 使⽤java.io桥转换:对⽂件进⾏转码* </pre>* <hr Color="green" ></hr>* 2012 Qingshan Group 版权所有* <hr Color="green" ></hr>* @author thetopofqingshan* @version 1.0.0* @since JDK 1.5* @date 2012-4-28*/public class CharsetConvertion {private FileInputStream fis;// ⽂件输⼊流:读取⽂件中内容private InputStream is;private InputStreamReader isr;private OutputStream os;private OutputStreamWriter osw;//写⼊private char[] ch = new char[1024];public void convertionFile() throws IOException{is = new FileInputStream("C:/项⽬进度跟踪.txt");//⽂件读取isr = new InputStreamReader(is, "gbk");//解码os = new FileOutputStream("C:/项⽬进度跟踪_utf-8.txt");//⽂件输出osw = new OutputStreamWriter(os, "utf-8");//开始编码char[] c = new char[1024];//缓冲int length = 0;while(true){length = isr.read(c);if(length == -1){break;}System.out.println(new String(c, 0, length));osw.write(c, 0, length);osw.flush();}}public void convertionString() throws UnsupportedEncodingException{String s = "清⼭集团";byte[] b = s.getBytes("gbk");//编码String sa = new String(b, "gbk");//解码:⽤什么字符集编码就⽤什么字符集解码 System.out.println(sa);b = sa.getBytes("utf-8");//编码sa = new String(b, "utf-8");//解码System.err.println(sa);}/*** <pre>* 关闭所有流* </pre>**/public void close(){if(isr != null){try {isr.close();} catch (IOException e) {e.printStackTrace();}}if(is != null){try {is.close();} catch (IOException e) {// TODO Auto-generated catch blocke.printStackTrace();}}if(osw != null){try {osw.close();} catch (IOException e) {// TODO Auto-generated catch blocke.printStackTrace();}}if(os != null){try {os.close();} catch (IOException e) {// TODO Auto-generated catch blocke.printStackTrace();}}}/*** <pre>* ⽤io读取⽂件内容* </pre>** @throws IOException* 读取过程中发⽣错误**/* <pre>** </pre>* @param path* @param charset* @throws IOException**/public void read(String path, String charset) throws IOException {fis = new FileInputStream(path);isr = new InputStreamReader(fis, charset);while (fis.available() > 0) {int length = isr.read(ch);System.out.println(new String(ch));}}public static void main(String[] args) {try {CharsetConvertion cc = new CharsetConvertion();cc.convertionFile();cc.convertionString();cc.close();} catch (IOException e) {e.printStackTrace();}}}⽅法三:java.nio.Charsetpackage com.qingshan.nio;import java.io.FileInputStream;import java.io.FileOutputStream;import java.io.IOException;import java.io.InputStreamReader;import java.nio.ByteBuffer;import java.nio.CharBuffer;import java.nio.channels.FileChannel;import java.nio.charset.Charset;import java.nio.charset.CharsetDecoder;import java.nio.charset.CharsetEncoder;/*** <pre>* 使⽤nio中的Charset转换字符:整个流程是⽂件读取-->byte-->解码(正确)-->编码--->byte-->写⼊⽂件 * </pre>* <hr Color="green" >* </hr>* 2012 Qingshan Group 版权所有* <hr Color="green" >* </hr>** @author thetopofqingshan* @version 1.0.0* @since JDK 1.5* @date 2012-4-27*/public class CharsetConvertion {private FileInputStream fis;// ⽂件输⼊流:读取⽂件中内容private FileChannel in;// ⽂件通道:双向,流从中⽽过private FileChannel out;// ⽂件通道:双向,流从中⽽过private FileOutputStream fos;// ⽂件输出流:向⽂件中写⼊内容private ByteBuffer b = ByteBuffer.allocate(1024 * 3);// 设置缓存区的⼤⼩private Charset inSet;// 解码字符集private Charset outSet;// 编码字符集private CharsetDecoder de;// 解码器private CharsetEncoder en;// 编码器private CharBuffer convertion;// 中间的字符数据private ByteBuffer temp = ByteBuffer.allocate(1024 * 3);// 设置缓存区的⼤⼩:临时private byte[] by = new byte[1024];private InputStreamReader isr;private char[] ch = new char[1024];** </pre>** @param src* @param dest* @throws IOException**/public void convertionFile_nio(String src, String dest) throws IOException {fis = new FileInputStream(src);in = fis.getChannel();fos = new FileOutputStream(dest);out = fos.getChannel();inSet = Charset.forName("gbk");outSet = Charset.forName("utf-8");de = inSet.newDecoder();en = outSet.newEncoder();while (fis.available() > 0) {b.clear();// 清除标记in.read(b); // 将⽂件内容读⼊到缓冲区内:将标记位置从0-b.capacity(),// 读取完毕标记在0-b.capacity()之间b.flip();// 调节标记,下次读取从该位置读起convertion = de.decode(b);// 开始编码temp.clear();// 清除标记temp = en.encode(convertion);b.flip(); // 将标记移到缓冲区的开始,并保存其中所有的数据:将标记移到开始0 out.write(temp); // 将缓冲区内的内容写⼊⽂件中:从标记处开始取出数据}}/*** <pre>* 测试转码是否成功, 指定字符集读取⽂件* </pre>** @param src* 被复制⽂件全路径* @param charset 解码字符集** @throws IOException 读取过程中的发⽣的异常**/public void read(String path, String charset) throws IOException {fis = new FileInputStream(path);isr = new InputStreamReader(fis, charset);while (fis.available() > 0) {int length = isr.read(ch);System.out.println(new String(ch));}}/*** <pre>* 关闭所有流或通道* </pre>**/public void close() {try {if (in != null) {in.close();}} catch (IOException e) {e.printStackTrace();}try {if (out != null) {out.close();}} catch (IOException e) {e.printStackTrace();if (fis != null) {fis.close();}} catch (IOException e) {e.printStackTrace();}try {if (fos != null) {fos.close();}} catch (IOException e) {e.printStackTrace();}}public static void main(String[] args) {CharsetConvertion n = new CharsetConvertion();try {n.convertionFile_nio("C:/项⽬进度跟踪.txt", "C:/nio_write.txt"); // n.read("C:/nio_write.txt", "utf-8");// 正确// n.read("C:/nio_write.txt", "gbk");//乱码} catch (IOException e) {e.printStackTrace();} finally {n.close();}}}感谢阅读，希望能帮助到⼤家，谢谢⼤家对本站的⽀持！。

Java 将Word转为PDF/Html/图片/XPS/SVG（基于Spire.Cloud.SDK for Java）Spire.Cloud.SDK for Java API提供了ConverApi接口支持将Word文档转换为多种文档格式，包括将Word转为PDF、Html、位图Bitmap（JPEG/BMP/ PNG）、矢量图Vectorgraph（支持WMF/SVG）、XPS、PostScript、PCL、dotx、dotm、docm、odt、wordxml、wordml、doc、docx、rtf、epub等等。

下面将详细介绍如何来实现转换。

步骤一、导入jar文件创建Maven项目程序，通过maven仓库下载导入。

以IDEA为例，新建Maven项目，在pom.xml文件中配置maven仓库路径，并指定spire.cloud.sdk的依赖，如下：<repositories><repository><id>com.e-iceblue</id><name>cloud</name><url>/repository/maven-public/</url></repository></repositories><dependencies><dependency><groupId> cloud </groupId><artifactId>spire.cloud.sdk</artifactId><version>3.5.0</version></dependency><dependency><groupId> com.google.code.gson</groupId><artifactId>gson</artifactId><version>2.8.1</version></dependency><dependency><groupId> com.squareup.okhttp</groupId><artifactId>logging-interceptor</artifactId><version>2.7.5</version></dependency><dependency><groupId> com.squareup.okhttp </groupId><artifactId>okhttp</artifactId><version>2.7.5</version></dependency><dependency><groupId> com.squareup.okio </groupId><artifactId>okio</artifactId><version>1.6.0</version></dependency><dependency><groupId> io.gsonfire</groupId><artifactId>gson-fire</artifactId><version>1.8.0</version></dependency><dependency><groupId>io.swagger</groupId><artifactId>swagger-annotations</artifactId><version>1.5.18</version></dependency><dependency><groupId> org.threeten </groupId><artifactId>threetenbp</artifactId><version>1.3.5</version></dependency></dependencies>完成配置后，点击“Import Changes” 即可导入所有需要的jar文件。

Java 将Word转为PDF、PNG、SVG、RTF、XPS、TXT、XML同一文档在不同的编译或阅读环境中，需要使用特定的文档格式来打开，通常需要通过转换文档格式的方式来实现。

下面将介绍在Java程序中如何来转换Word 文档为其他几种常见文档格式，如PDF、图片png、svg、xps、rtf、txt、xml等。

使用工具：Free Spire.Doc for Java（免费版）Jar文件下载及导入：方法1：通过官网下载jar文件包，并解压。

解压后，将lib文件夹下的Spire.Doc.jar 文件导入到java程序。

方法2：可通过maven仓库安装导入到程序。

Java代码示例import com.spire.doc.*;import com.spire.doc.documents.ImageType;import javax.imageio.ImageIO;import java.awt.image.BufferedImage;import java.io.File;import java.io.IOException;public class WordToPng {public static void main(String[]args) throws IOException {//加载测试文档Document doc = new Document("test.docx");//将文档指定页保存为Png格式的图片BufferedImage image = doc.saveToImages( 0, ImageType.Bitmap);File file = new File("ToPNG.png");ImageIO.write(image, "PNG", file);//将Word转为PDFdoc.saveToFile("Word转PDF.pdf", FileFormat.PDF);//将Word保存为SVG格式doc.saveToFile("ToSVG.svg",FileFormat.SVG);//将Word保存为RTF格式doc.saveToFile("ToRTF.rtf",FileFormat.Rtf);//将Word保存为XPS格式doc.saveToFile("ToXPS.xps",FileFormat.XPS);//将Word保存为XML格式doc.saveToFile("ToXML.xml",FileFormat.Xml);//将Word保存为TXT格式doc.saveToFile("ToTXT.txt",FileFormat.Txt);}}文档转换效果：（本文完）。

Word转CHM方法Word转CHM方法软件能自动转化文档结构为目录结构。

这就是DOC2CHM，在这里可以下载到/down/856624/newzyl是**版的。

使用起来也很简单，打开程序DOC2CHM_cracked.exe，选择要生成的Word文件，然后一直NEXT下去，最后ConVert就可以生成了。

顺便也收集了一下CHM的相关资料，可以做为自己编写转化软件的依据。

HTMLHELP WORKSHOP 简易教程摘自中文电子报业 Windows 98的帮助文件与Windows 95的比有较大的改变，它使用一种基于HTML文件特征的帮助文件，用Internet Explo rer显示帮助内容，支持HTML、ActiveX、Java、脚本（Java脚本和VB 脚本）以及HTML图像格式（.JPE G、GIF、PNG），它的图标也变了，后缀名为chm，Win dows 98称之为Compiled HTML Help F ile。

为了叙述方便，下面就称之为chm文件。

典型的Wind ows 98规范的帮助文件（.chm文件）的窗口和Windo ws 98资源管理器差不多，左侧是目录、索引和搜索这三个功能项，通过选项卡切换；右侧是HTML文件的显示部分，改变了原来帮助文件目录窗口和主题窗口分离的情况。

由于HTML文件具有多媒体表现力，因此chm文件的内容不再局限于文字和静态图像，在其中可以插入GIF动画，也可以利用浏览器的插件在文档中播放声音文件、动画影片、或其它格式的多媒体内容。

加入URL地址可与因特网联系在一起，这样chm文件就不局限于包装好的内容了，它是微软公司的下一代联机帮助系统。

同时，chm文件的核心是充分利用HTML文件的表现能力，对分散的HTML文件作整体的包装，这也是目前在Web网页以外利用HTML文件的一个趋势。

如果你用这个方式制作学习教程、电子图书和杂志，或为用户提供产品目录和宣传材料，比已经流行的PDF文件更简洁和方便。

javadoc导出成word⽂档更新说明： 2021-10-14 增加⽂字说明，增加注意事项说明刚刚上次弄完了⼀个坑爹的任务，这次我领导⼜给我⼀个让⼈脑⽠⼦疼的任务了。

基本上客户他在验收我们系统的时候，都会要求我们编写相关的⽂档，这次也不例外。

只是这次的客户要求我们给出接⼝⽂档。

不仅是要整个controller的rest接⼝⽂档，还要给出service层的接⼝，连⼯具类都要有。

这不是在为难我胖虎么。

想我⾟⾟苦苦给全部controller⽅法都加上了swagger注解，想我⾟⾟苦苦把整个项⽬全部⽅法都加上了完美的javadoc注释，想我关键代码都留了逻辑注释，为什么还要我给你弄个word⽂档。

抱怨归抱怨，该⼲的活还是要⼲的，谁让这该死的钱真⾹。

但是要怎么弄呢？这是个很严重的问题，毕竟我的项⽬⽅法没⼀千都有⼀百，总不能⼀个个给他Ctrl C + Ctrl V吧，那我的弄到何年何⽉。

swagger的我可以找⼯具导出成word⽂档，可是service层的呢？我的⼯具类呢？有没有现成的⼯具呢？问下度娘，~~~~~~~~~成功摸鱼半天，毫⽆收获那能不能像上次那样⽤正则⾃⼰搞呢？试⼀哈 ~~~~~~~~~~~~~ 成功摸鱼半天，失败了，有些代码的⽂档注释太坑爹了，⽅法内⽤⽂档注释，搞事情吧，怎么还有部分前⾯的*号都没了。

idea不是可以导出javadoc⽂档么？能不能导出word呢？试⼀哈 ~~~~~~~~~~~~成功摸鱼半天，毫⽆办法，不过我找到了⼀个神奇的⽅法com.sun.tools.javadoc.Main.execute(initAgrs); 有没有觉得很眼熟，没错，这就是jdk⾃⼰的javadoc⼯具。

先让我们来膜拜下前辈的⽂章：原理其实很简单，javadoc 这个jdk的 tools.jar 中的包的类已经帮我们解析好了java⽂件，我们需要做的仅仅是重写⼀个Doclet，然后在它⾥⾯处理下javadoc给我弄好的RootDoc就⾏，剩下就只剩操作RootDoc它了。

将WORD文档转换成CHM帮助文档的办法
将WORD文档转换成CHM帮助文档的办法
从筋疲力尽，到举手之劳！当您已经拥有一份WORD格式的文档时，如何让它转变成体积更小、速度更快、层次分明、简便易读的CHM文档呢？
【以前，也许您不得不这样做】：
1、将Word存为一个html文档；
2、使用CHM制作工具编译生成的html文件为CHM文档；
问题：生成的帮助没有层次，不便于阅读和检索；
解决：
1、为整修文档中的每个章节生成不同的html文档，可能多达几十甚至数百个html文件；
2、使用CHM制作工具打开每个html文档并挂接到相应层次上；
3、使用CHM制作工具编译CHM文档。

问题：
1、层次混乱：生成的html中自动编号丢失或重排；
2、工作量大：精力高度集中，稍稍疏忽将致使工作重做；
3、周期漫长：一个300页的Word帮助文件，分解、挂接工作大概需要一周的时间；
4、维护困难：要同时维护WORD格式和CHM格式两份文档，容易造成不统一。

解决：很难。

【现在，Word2CHM Assistant令您只需】：
1、使用本软件打开Word文档，点击生成按钮，生成hhp目标工程文档；
2、使用Microsoft HTML Help WorkShop等CHM制作工具编译生成的hhp文档。

Word2CHM Assistant优势：
智能：本软件一次可以同时处理多个帮助文件并分别生成hhp工程文件，层次自动生成，
支持多级层次；
快速：制作一个300页的Word文档大约只需要10分钟（在PIII733/256M内存环境下）；
方便：用户只需维护一份Word格式的文档，随时可以快速生成美观实用的CHM文档。

java 如何对文件转码
Java中对文件进行转码的常见方式是通过字节流和字符流进行操作。

具体步骤如下：
使用FileInputStream 或者FileReader 类打开源文件，并创建一个输入流对象。

使用FileOutputStream 或者FileWriter 类打开目标文件，并创建一个输出流对象。

根据需要使用指定的字符编码创建一个InputStreamReader 对象，将输入流对象包装起来。

根据需要使用指定的字符编码创建一个OutputStreamWriter 对象，将输出流对象包装起来。

通过读取输入流对象中的数据，并将其使用指定的字符编码转换成字符串。

使用输出流对象将转换后的字符串按照指定的字符编码写入目标文件。

下面是一个示例代码，演示了如何将一个文本文件从UTF-8 编码转换为GBK 编码：
请注意，示例代码中的路径需要根据实际情况进行修改。

同时，请确保源文件和目标文件是存在且可读写的。