Hycz's Blog

Life is a game. Why so serious?

2011/06/13 在Eclipse中配置Cassandra

首先,整个过程基本基于下面这篇文章:

原帖地址:http://www.congci.com/item/cassandra-for-eclipse

我们将从svn中下载Cassandra的源代码,完成编译,并执行相应的单元测试。

配置环境

1 安装jdk6,ant。

2 安装Eclipse3.5

3 在Eclipse中安装http://subclipse.tigris.org/update_1.6.x

在Eclipse的菜单选择:Help –> Install New Software

image

接下来,就可以安装subclipse: Add –> 输入名称和地址http://subclipse.tigris.org/update_1.6.x ->勾选所有需要安装的选择

image

最好点击next,安装提示的要求一步一步操作。最后等待subclipse安装完成后重启Eclipse。

下载Cassandra源码

在Eclipse中新建一个svn项目

image

选择:创建新的资源库位置

image

获取svn:https://svn.apache.org/repos/asf/cassandra/tags/cassandra-0.6.2/

image

按照如下选择

image

然后根据提示创建一个Java Project,svn检出操作完成后,我们就可以看到刚刚创建的项目了

image

这样Cassandra的源代码就下载完毕了。

编译Cassandra

假设我们下载的Cassandra源代码的位置在D:\workspace\cassandra-0.6.2,那么我们使用命令行工具在这个目录下执行ant的编译操作。

image

如果编译成功,提示如下:

image

可以看到,执行编译的同时,也生成了thrift,avro和antlr的java源文件。

在Eclipse中编辑Cassandra源码

源代码虽然可以编辑成功,但是我们还是无法利用Cassandra对源代码进行方便的修改。

接下来,要一步一步配置Eclipse,使其可以方便地编辑Cassandra源码。

首先,将D:\workspace\cassandra-0.6.2\lib目录下的所有jar包添加到项目的Build Path中。

image

然后,编辑Src目录的属性,默认的设置为

image

将默认的目录删除,然后添加如下Src目录

image

添加完成之后,目录结构如下

image

按照正常的流程来说,我们对Eclipse的配置就算完成了,可以很方便地在Eclipse中编辑Cassandra源码了。

但是Eclipse还是有一些小Bug可能会影响到正常的功能,比如我遇到的这个情况

image

大家可以看到,GarbageCollectorMXBean其实是jdk中的一个类,但是Eclipse提示找不到定义。处理的办法如下

打开项目的Build Path,先移除JRE System Library

image

然后在将之前移除JRE System Library的添加回来。

image

最后在刷新整个项目,错误提示的问题就解决了。

image

运行单元测试

我们可以将单元测试的代码也添加到Eclipse中。

步骤非常简单:

1 添加JUnit4的jar包

2 添加test目录下的测试代码到Src中。

添加成功后项目的列表如下

image

我们可以直接在test中运行已有的单元测试。

打包发布

当我们完成对Cassandra源码的修改以后,可以将修改后的版本打包发布出来。

使用ant的命令行:ant release

image

执行完毕以后,我们可以在D:\workspace\cassandra-0.6.2\build目录中看到打包后的文件

image

这样,我们就可以使用修改后的Cassandra了。

———————————————————————恶心的分割线————————————————————————

下面是一些我遇到的问题

  1. 之前装了ant(地址:http://apache.etoak.com//ant/binaries/apache-ant-1.8.2-bin.tar.gz),但是没有装svn,所以把整个project下下来之后,ant出错,错误是"Cannot run program "svn":CreateProcess error=2" ,所以还要下个svn,方法见这篇文章https://hycz.wordpress.com/2011/06/13/%E8%BD%ACsvn%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7%E5%AE%89%E8%A3%85%E4%BD%BF%E7%94%A8windows/
  2.  设置Java Build Path中Source目录,0.8.0版本和0.6.2不太一样,不过无论什么版本,源码目录其实已经写在了build.xml中。以下内容摘自0.8.0版本的build.xml中
    <echo file=".classpath"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
    <classpath>
      <classpathentry kind="src" path="src/java"/>
      <classpathentry kind="src" path="src/gen-java"/>
      <classpathentry kind="src" path="interface/thrift/gen-java"/>
      <classpathentry kind="src" path="drivers/java/src"/>
      <classpathentry kind="src" path="drivers/java/test"/>
      <classpathentry kind="src" path="test/unit"/>
      <classpathentry kind="src" path="test/long"/>
      <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
      <classpathentry kind="output" path="build/classes/main"/>
      <classpathentry kind="lib" path="build/classes/thrift"/>
      <classpathentry kind="lib" path="build/test/classes"/>
      <classpathentry kind="lib" path="test/conf"/>
    ]]>
    	</echo>

    这些目录便是需要在Eclipse中设置的

  3. jar的导入问题,(醒目!!下面的可以用,但是有更简单的设置,开发过程中需要用到的jar包都放在cassandra-0.8.0\build\lib\jars中,直接导入即可),除了将lib文件夹下的jar导入,还有一些其他的jar包不在cassandra目录下。我是在命令行中用ant编译之后才进行的jar导入,在用ant编译的过程中,还自动从网上下载了一些jar文件,我的电脑上是在“C:\Users\用户名\.m2\repository”中,详细的列表可以参见cassandra-0.8.0\build文件夹下的build-dependencies.xml,这个应该是在编译之后产生的。不过显然,更加原始的依赖查询是写在了build.xml中。以下内容摘自0.8.0版本的build.xml中
    <!-- Publish artifacts to Maven repositories -->
      <target name="mvn-install"
              depends="maven-declare-dependencies,artifacts,jar,sources-jar,javadoc-jar"
              description="Installs the artifacts in the Maven Local Repository">
    
        <!-- the parent -->
        <install pomFile="${build.dir}/${final.name}-parent.pom"
                 file="${build.dir}/${final.name}-parent.pom"
                 packaging="pom"/>
    
        <!-- the distribution -->
        <install pomFile="${build.dir}/${final.name}-dist.pom"
                 file="${build.dir}/${final.name}-dist.pom"
                 packaging="pom"/>
        <install pomFile="${build.dir}/${final.name}-dist.pom"
                 file="${build.dir}/${final.name}-bin.tar.gz"
                 packaging="tar.gz"
                 classifier="bin"/>
        <install pomFile="${build.dir}/${final.name}-dist.pom"
                 file="${build.dir}/${final.name}-src.tar.gz"
                 packaging="tar.gz"
                 classifier="src"/>
    
        <!-- the cassandra-thrift jar -->
        <install pomFile="${build.dir}/${ant.project.name}-thrift-${version}.pom"
                 file="${build.dir}/${ant.project.name}-thrift-${version}.jar"/>
        <install pomFile="${build.dir}/${ant.project.name}-thrift-${version}.pom"
                 file="${build.dir}/${ant.project.name}-thrift-${version}-sources.jar"
                 classifier="sources"/>
        <install pomFile="${build.dir}/${ant.project.name}-thrift-${version}.pom"
                 file="${build.dir}/${ant.project.name}-thrift-${version}-javadoc.jar"
                 classifier="javadoc"/>
    
        <!-- the cassandra-all jar -->
        <install pomFile="${build.dir}/${final.name}.pom"
                 file="${build.dir}/${final.name}.jar"/>
        <install pomFile="${build.dir}/${final.name}.pom"
                 file="${build.dir}/${final.name}-sources.jar"
                 classifier="sources"/>
        <install pomFile="${build.dir}/${final.name}.pom"
                 file="${build.dir}/${final.name}-javadoc.jar"
                 classifier="javadoc"/>
    
        <!-- the cassandra-cql jar -->
        <install pomFile="${build.dir}/${ant.project.name}-cql-${cql.driver.version}.pom"
                 file="${build.dir}/${ant.project.name}-cql-${cql.driver.version}.jar"/>
        <install pomFile="${build.dir}/${ant.project.name}-cql-${cql.driver.version}.pom"
                 file="${build.dir}/${ant.project.name}-cql-${cql.driver.version}-sources.jar"
                 classifier="sources"/>
        <install pomFile="${build.dir}/${ant.project.name}-cql-${cql.driver.version}.pom"
                 file="${build.dir}/${ant.project.name}-cql-${cql.driver.version}-javadoc.jar"
                 classifier="javadoc"/>
      </target>
    
      <target name="publish"
              depends="mvn-install"
              if="release"
              description="Publishes the artifacts to the Maven repository">
    
        <!-- the parent -->
        <deploy pomFile="${build.dir}/${final.name}-parent.pom"
                file="${build.dir}/${final.name}-parent.pom"
                packaging="pom"/>
    
        <!-- the distribution -->
        <deploy pomFile="${build.dir}/${final.name}-dist.pom"
                file="${build.dir}/${final.name}-dist.pom"
                packaging="pom"/>
        <deploy pomFile="${build.dir}/${final.name}-dist.pom"
                file="${build.dir}/${final.name}-bin.tar.gz"
                packaging="tar.gz"
                classifier="bin"/>
        <deploy pomFile="${build.dir}/${final.name}-dist.pom"
                file="${build.dir}/${final.name}-src.tar.gz"
                packaging="tar.gz"
                classifier="src"/>
    
        <!-- the cassandra-thrift jar -->
        <deploy pomFile="${build.dir}/${ant.project.name}-thrift-${version}.pom"
                file="${build.dir}/${ant.project.name}-thrift-${version}.jar"/>
        <deploy pomFile="${build.dir}/${ant.project.name}-thrift-${version}.pom"
                file="${build.dir}/${ant.project.name}-thrift-${version}-sources.jar"
                classifier="sources"/>
        <deploy pomFile="${build.dir}/${ant.project.name}-thrift-${version}.pom"
                file="${build.dir}/${ant.project.name}-thrift-${version}-javadoc.jar"
                classifier="javadoc"/>
    
        <!-- the cassandra-all jar -->
        <deploy pomFile="${build.dir}/${final.name}.pom"
                file="${build.dir}/${final.name}.jar"/>
        <deploy pomFile="${build.dir}/${final.name}.pom"
                file="${build.dir}/${final.name}-sources.jar"
                classifier="sources"/>
        <deploy pomFile="${build.dir}/${final.name}.pom"
                file="${build.dir}/${final.name}-javadoc.jar"
                classifier="javadoc"/>
    
        <!-- the cassandra-cql jar -->
        <deploy pomFile="${build.dir}/${ant.project.name}-cql-${cql.driver.version}.pom"
                file="${build.dir}/${ant.project.name}-cql-${cql.driver.version}.jar"/>
        <deploy pomFile="${build.dir}/${ant.project.name}-cql-${cql.driver.version}.pom"
                file="${build.dir}/${ant.project.name}-cql-${cql.driver.version}-sources.jar"
                classifier="sources"/>
        <deploy pomFile="${build.dir}/${ant.project.name}-cql-${cql.driver.version}.pom"
                file="${build.dir}/${ant.project.name}-cql-${cql.driver.version}-javadoc.jar"
                classifier="javadoc"/>
      </target>

    我也是刚刚开始用,估计是编译过程中根据此列表依次检查依赖,如果缺少jar,则从网上下载,下载地址写在了根目录下的build.properties.default文件中,并放在相应的目录中,然后把这些目录名写到build-dependencies.xml中。下载的jar分为两种,一个是源码,一个是编译好的。当我们导入了cassandra-0.8.0\lib下的所有jar之后,会发现还有类找不到,那么这些类就是在这些自动下载的jar中,需要按需要手动在Eclipse中导入。

  4. 待续。。
Advertisements

One response to “2011/06/13 在Eclipse中配置Cassandra

  1. Pingback: 2011/06/14 在Eclipse中配置Cassandra2 « Hycz's Blog

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: