eclipse中配置heritrix的过程----heritrix-1.14.4

将heritrix-1.14.4-src和heritrix-1.14.4两个压缩文件解压<?xml:namespace
prefix = o ns ="urn:schemas-microsoft-com:office:office" />
配置过程：
1、新建Java Project工程
在Eclipse中新建一个Java Project工程(注意：一定是Java
Project的工程，不是Web Project工程)，工程名称为Heritrixproject。（名字可随便起）
以我的为例，对应地，工程Heritrixproject在本地磁盘目录D:\eclipse-SDK-3.2.1-win32\workspace下面。
可以在目录D:\eclipse-SDK-3.2.1-win32\workspace\Heritrixproject下面看到：两个工程属性文件.classpath和.project。
2、向新建的Java Project添加Heritrix-1.14.4文件
(1) 将目录E:\Heritrix\heritrix-1.14.4-src\heritrix-1.14.4\src\java\下面的三个目录：org、com、st一起拷贝到新建工程Heritrixproject目录下面(绝对路径为D:\eclipse-SDK-3.2.1-win32\workspace\Heritrixproject)。
(2) 将目录E:\Heritrix\heritrix-1.14.4-src\heritrix-1.14.4\src\conf\下面的：三个目录(包括：modules、profiles、selftest)，以及四个文件(包括：heritrix.properties、jmxremote.password.template、heritrix.cacerts、jndi.properties)一起拷贝到新建的工程Heritrixproject目录下面。
(3) 将目录E:\Heritrix\heritrix-1.14.4-src\heritrix-1.14.4\src\resources\下面的三个文件(包括：arcMetaheaderBody.xsl、README.txt，其中README.txt没有用处是显而易见的)拷贝到新建的工程Heritrixproject目录下。
(4) 将目录E:\Heritrix\heritrix-1.14.4\heritrix-1.14.4\下面的webapps目录拷贝到新建工程Heritrixproject目录下面(绝对路径为D:\eclipse-SDK-3.2.1-win32\workspace\Heritrix-1.14.4)，这里，webapps目录下面有两个WAR包(即admin.war和selftest.war)。
(5)将E:\Heritrix\heritrix-1.14.4\heritrix-1.14.4\下的lib文件夹拷贝到工程下。
3、修改新建的Java Project工程的配置文件
(1) 打开目录D:\eclipse-SDK-3.2.1-win32\workspace\Heritrixproject下面的.classpath文件，可以看到共有下面6行：
<?xml version="1.0"encoding="UTF-8"?>

<classpath>

<classpathentry kind="src" path="src"/>

<classpathentry kind="con"path="org.eclipse.jdt.launching.JRE_CONTAINER"/>

<classpathentry kind="output" path="bin"/>

</classpath>
可以看到，新建Java Project工程之后，src是资源目录，所以在Eclipse开发平台上，在src下面新建的资源目录呈包结构组织。kind属性指定工程中显示的资源目录，path指定了在该path(Eclipse默认为src)下的资源目录都呈包结构组织。
将上面的内容做很大的修改，修改内容如下所示：(注意：这个地方里面的lib下的jar就是拷贝到工程下lib里面的jar。如果你用的最新版本的可能与这个jar文件不一样，这个你就要做相应的修。此时的最新版本为heritrix-1.14.4)
<?xml version="1.0"encoding="UTF-8"?>
<classpath>
<classpathentrypath="" kind="src"/>
<classpathentrypath="org.eclipse.jdt.launching.JRE_CONTAINER"kind="con"/>
<classpathentrypath="lib/ant-1.6.2.jar" kind="lib"/>
<classpathentrypath="lib/bsh-2.0b4.jar" kind="lib"/>
<classpathentrypath="lib/commons-cli-1.0.jar" kind="lib"/>
<classpathentrypath="lib/commons-codec-1.3.jar" kind="lib"/>
<classpathentrypath="lib/commons-collections-3.1.jar" kind="lib"/>
<classpathentrypath="lib/commons-httpclient-3.1.jar" kind="lib"/>
<classpathentrypath="lib/commons-io-1.3.1.jar" kind="lib"/>
<classpathentrypath="lib/commons-lang-2.3.jar" kind="lib"/>
<classpathentrypath="lib/commons-logging-1.0.4.jar" kind="lib"/>
<classpathentrypath="lib/commons-net-2.0.jar" kind="lib"/>
<classpathentrypath="lib/commons-pool-1.3.jar" kind="lib"/>
<classpathentrypath="lib/dnsjava-2.0.3.jar" kind="lib"/>
<classpathentrypath="lib/fastutil-5.0.3-heritrix-subset-1.0.jar"kind="lib"/>
<classpathentrypath="lib/itext-1.2.0.jar" kind="lib"/>
<classpathentrypath="lib/jasper-compiler-tomcat-4.1.30.jar"kind="lib"/>
<classpathentrypath="lib/jasper-runtime-tomcat-4.1.30.jar" kind="lib"/>
<classpathentrypath="lib/javaswf-CVS-SNAPSHOT-1.jar" kind="lib"/>
<classpathentrypath="lib/je-3.3.82.jar" kind="lib"/>
<classpathentrypath="lib/joda-time-1.6.jar" kind="lib"/>
<classpathentrypath="lib/jetty-4.2.23.jar" kind="lib"/>
<classpathentrypath="lib/jets3t-0.5.0.jar" kind="lib"/>
<classpathentrypath="lib/junit-3.8.2.jar" kind="lib"/>
<classpathentrypath="lib/jericho-html-2.6.jar" kind="lib"/>
<classpathentrypath="lib/libidn-0.5.9.jar" kind="lib"/>
<classpathentrypath="lib/mg4j-1.0.1.jar" kind="lib"/>
<classpathentrypath="lib/poi-2.0-RC1-20031102.jar" kind="lib"/>
<classpathentrypath="lib/poi-scratchpad-2.0-RC1-20031102.jar"kind="lib"/>
<classpathentrypath="lib/servlet-tomcat-4.1.30.jar" kind="lib"/>
<classpathentrypath="" kind="output"/>
</classpath>其中：
上面的<classpathentry kind="src"path=""/>中，指定src为""，这表示，只要在该工程的根目录下面建的目录资源都呈现表结构组织；
上面的kind为lib，对应的就是我们拷贝到工程目录下面的lib，path的值就是该lib目录下面的所有的jar文件。
4.配置外部jar包，
切换到eclipse窗口下，刷新下工程。
右键单击工程，选择【Build Path】—>
【Add External Archives】在弹出的窗口中选择添加目录heritrix-1.12.1-src\heritrix-1.12.1\lib。
再次刷新下工程。没有错误提示了。
5、修改heritrix.properties属性文件
打开heritrix.properties属性文件，可以看到默认情况下，Heritrix-1.14.4的属性文件如下所示：
##############################################################################

# H E R I T R I X P R O P E R T I E S

##############################################################################
# Properties with 'heritrix.' or'org.archive.crawler.' prefix get loaded

# into System.properties on startup so available via System.getProperties.
# Version is filled in by the maven.xmlpregoal. It copies here the project

# currentVersion property.

heritrix.version = @VERSION@
# Location of the heritrix jobsdirectory.

heritrix.jobsdir = jobs
# Default commandline startup values.

# Below values are used if unspecified on the command line.

heritrix.cmdline.admin =

heritrix.cmdline.port = 8080

heritrix.cmdline.run = false

heritrix.cmdline.nowui = false

heritrix.cmdline.order =

heritrix.cmdline.jmxserver = false

heritrix.cmdline.jmxserver.port = 8081
上面四行红色标识的代码行，一般来说，需要修改。
第一行，heritrix.version指定了Heritrix的版本号，因为我们测试的是版本号为1.14.4，修改为：
heritrix.version = 1.14.4
第二行，heritrix.jobsdir指定了Heritrix在执行抓取任务时，抓取到的内容存放的目录，默认在工程下面的jobs目录下面。
第三行，heritrix.cmdline.admin指定了登录WebUI时使用的帐号，默认为空，可以自己随意设定，设定需要按照一定的格式(用户名:密码)，我们修改为：
heritrix.cmdline.admin = admin：admin
其中，用户名和密码使用“:”分隔。
第四行，heritrix.cmdline.port指定了运行Heritrix后台程序，监听的WebUI使用的端口号，默认为8080端口，可以设置一个当前没有占用的端口号，比如我们修改为：
heritrix.cmdline.port = 9090
、启动Heritrix后台程序
回到Eclipse平台窗口，找到新建的Java Project工程Heritrixproject中，资源包org.archive.crawler下面的Java类文件Heritrix.java，右键单击Heritrix.java文件，选择【Run
As】—>
【Java Application】选项，便看见Heritrix后台已经启动了，在Eclipse控制台【Console】中可以看到启动过程的详细信息，如下所示：
<?xml:namespace prefix = v ns ="urn:schemas-microsoft-com:vml" />
7、登录WebUI
现在，可以成功登录WebUI，设置抓取任务了。
在浏览器地址栏中键入地址链接 http://localhost:9090，可以看到WebUI登录界面.

可能出现的问题：

1.配置好之后当我们运行Heritrix.java的时候可能编译不通过。这是因为sun包是受保护的包，默认只有sun公司的软件才能使用。myEclipse会报错，把对保护使用waring就可以了。
解决办法：Windows -> Preferences -> Java-> Compiler -> Errors/Warnings-> Deprecated and trstricted API ->Forbidden reference (access rules): -> change to
warning

2.可能出现的异常：......thread-10org.archive.util.ArchiveUtils.<linit>( )TLD list....
解决办法：将/heritrix-1.14.4-src/heritrix-1.14.4/src/resources/org/archive/util
下的文本文档拷贝到heritrix中的org/archive/util下；

3.Exception in thread "StartNextJob"java.lang.NoSuchMethodError:

org.apache.commons.httpclient.HttpState.setCookiesMap(Ljava/util/SortedMap;
解决办法：HttpState在HeritrixX.XX.X.jar和commons-httpclient.XXX.jar里面重复了，在build
path里面把HeritrixX.XX.X.JAR放在commons-httpclient.XXX.jar前面就可以解决这个问题。当然了，开始我根本没有导入HeritrixX.XX.X.jar这个包，会有其他的错误。