准确编译obe的cvs源程序

**************************************************
*** 准确编译 obe 的 cvs源程序                      ***
**************************************************

##################################################
### 从cvs上下载的obe源程序
##################################################
1、cvs工具可以使用wincvs/TortoiseCVS

2、下载方法(转贴)
--------------------------------------------------
界面方式： 
 认证方式:pserver
 路径:/cvsroot/obe
 主机地址:cvs.sourceforge.net
 用户名:anonymous
 anonymous@cvs.sourceforge.net:/cvsroot/obe
 登陆,密码为空,检出模块为 .(注意:一个点,表示下载当前目录下的所有东西)
 
命令方式:
$cvs -d:pserver:anonymous@cvs.sf.net:/cvsroot/obe login 
$cvs -d:pserver:anonymous@cvs.sf.net:/cvsroot/obe checkout .
--------------------------------------------------

##################################################
### 准备准确的obe properties文件
##################################################
在编译obe之前，首先需要准确配置obe所使用的AS环境和database环境，所有的这些配置模
板可以在obe文件夹的custom子文件夹中找到，如文件linux-mysql-jboss-3.2.3.properties
即为使用jboss作为AS,使MySQL数据库的配置模板。我们只需要根据自己的实际环境修改这个
文件即可。如我所配置的环境是jboss3.2.3+mysql+obe,其中jboss安装目录为D:/cvs_down/obe/jboss-3.2.3,
mysql的驱动程序为D:/cvs_down/obe/lib/mysql-connector-java-3.1.7-bin.jar,那么我的
.properties文件就如下所示：
--------------------------------------------------------------------------------
# Example settings for a Linux/MySQL-4.0/JBoss-3.2.3+ build.
# Copy mysql-ds.xml to $JBOSS_HOME/server/default/deploy
# Copy mysql-connector-java-3.0.8-stable-bin.jar to $JBOSS_HOME/server/default/lib

dist.zip=true
dist.tar=false
dist.tar.gz=false
dist.tar.bz2=false

# A convenience for defining the as.* properties.
as.dir=D:/cvs_down/obe/jboss-3.2.3(###as的安装目录,注意把windows的'/'替换为'/'###)

# The name of the directory containing the app. server's start & stop commands.
#as.bin=${as.dir}/bin

# The name of the app. server's client jar file.
as.client.jar=${as.dir}/client/jbossall-client.jar

# The command to start the app. server (assumed to be in ${as.bin}).
as.start=run.bat(###windows下启动as时是bat文件哦###)

# The command to stop the app. server (assumed to be in ${as.bin}).
as.stop=shutdown.bat --shutdown

# The URL under which Cactus runs the internal server tests.
cactus.contextURL=http://localhost:8080/obeserver-tests

# Path to the driver for use by the dbsetup task.
jdbc.classpath=D:/cvs_down/obe/lib/mysql-connector-java-3.1.7-bin.jar

# JDBC driver class to use.
jdbc.driver=com.mysql.jdbc.Driver

# JDBC URL for database.(###注意修改为你自己的数据库名、用户名、密码###)
jdbc.url=jdbc:mysql://localhost:3306/obe

# Database user id.
db.user=obe

# Database password.
db.password=obe

# Database schema.
db.type=mysql

# The class name of the JNDI initial context factory.
java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory

# The JAAS login configuration to use.
java.security.auth.login.config=${as.dir}/client/auth.conf

# The OBE client protocol to use in JUnit tests.
obe.client.protocol=rmi

# The URL of the app. server for RMI connections.
obe.server.host=jnp://localhost:1099

# The user ID under which JUnit tests connect to the app. server.
obe.client.principal=system

# The password under which JUnit tests connect to the app. server.
obe.client.credentials=password

# Required by JBossCMP.
xdoclet.jboss.typemapping=mySQL

# The JNDI name of the DataSource to use (defined in mysql-ds.xml).
xdoclet.jboss.datasource=java:/MySQLDS

# The JNDI name of the DataSource to use (this example matches the WebLogic-7.0 demo).
xdoclet.weblogic.datasource=examples-dataSource-demoXAPool

# The JNDI name of the JMS connection factory to use (this example matches the JBoss default).
xdoclet.jboss.ConnectionFactory=java:/ConnectionFactory

# The JNDI name of the JMS connection factory to use (this example matches the WebLogic-7.0 demo).
xdoclet.weblogic.ConnectionFactory=ConnectionFactory

# The JNDI name of the JavaMail Session to use (this example matches the JBoss default).
xdoclet.jboss.mail=java:/Mail

# The JNDI name of the JavaMail Session to use (WebLogic does not provide a default).
#xdoclet.weblogic.mail=

#weblogic.home=/usr/local/bea/weblogic81/server
weblogic.home=

#deploy.lib.dir=/home/adrian/obe/build/lib
#deploy.tests.war=${staging.j2ee.lib}/obeserver-tests.war
deploy.app.dir=${as.dir}/server/default/deploy
#deploy.app.ear=${as.dir}/server/default/deploy/obeserver.ear
--------------------------------------------------------------------------------
准备好上面说到的文件后，保存为.properties,存放在obe的根目录准备开始编译。

##################################################
### 编译obe源程序
##################################################
obe源程序的编译、部署分以下三个步骤：
1、利用prepare命令和上面的.properties文件生成本地化的local.properties文件，如下操作：
在命令行下进入到obe的根目录，执行如下命令prepare windows-mysql-jboss-3.2.3.properties

2、利用ant工具编译obe源程序。
在obe根目录下执行ant命令后，ant根据build.xml指定的规则编译obe程序，在编译过程中提示如下
错误信息：
--------------------------------------------------------------------------------
compile:
    [mkdir] Created dir: E:/Asir_CVS/obe/build/obe/obeengine/classes
    [javac] Compiling 209 source files to E:/Asir_CVS/obe/build/obe/obeengine/cl
asses
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:54: package org.exolab.castor.mapping does not exist
    [javac] import org.exolab.castor.mapping.Mapping;
    [javac]                                  ^
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:55: package org.exolab.castor.xml does not exist
    [javac] import org.exolab.castor.xml.MarshalListener;
    [javac]                              ^
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:56: package org.exolab.castor.xml does not exist
    [javac] import org.exolab.castor.xml.Marshaller;
    [javac]                              ^
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:57: package org.exolab.castor.xml does not exist
    [javac] import org.exolab.castor.xml.UnmarshalListener;
    [javac]                              ^
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:58: package org.exolab.castor.xml does not exist
    [javac] import org.exolab.castor.xml.Unmarshaller;
    [javac]                              ^
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:78: cannot resolve symbol
    [javac] symbol  : class Mapping
    [javac] location: class org.obe.engine.repository.AbstractRepository
    [javac]     private static final Mapping _mapping;
    [javac]                          ^
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:86: cannot resolve symbol
    [javac] symbol  : class Mapping
    [javac] location: class org.obe.engine.repository.AbstractRepository
    [javac]         _mapping = new Mapping(AbstractRepository.class.getClassLoad
er());
    [javac]                        ^
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:161: cannot resolve symbol
    [javac] symbol  : class Unmarshaller
    [javac] location: class org.obe.engine.repository.AbstractRepository
    [javac]                 Unmarshaller unmarshaller = new Unmarshaller(
    [javac]                                                 ^
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:164: cannot resolve symbol
    [javac] symbol  : class UnmarshalListener
    [javac] location: class org.obe.engine.repository.AbstractRepository
    [javac]                     unmarshaller.setUnmarshalListener(new UnmarshalL
istener() {
    [javac]                                                           ^
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:252: cannot resolve symbol
    [javac] symbol  : class Marshaller
    [javac] location: class org.obe.engine.repository.AbstractRepository
    [javac]             Marshaller marshaller = new Marshaller(writer);
    [javac]             ^
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:252: cannot resolve symbol
    [javac] symbol  : class Marshaller
    [javac] location: class org.obe.engine.repository.AbstractRepository
    [javac]             Marshaller marshaller = new Marshaller(writer);
    [javac]                                         ^
    [javac] E:/Asir_CVS/obe/obe/obeengine/src/org/obe/engine/repository/Abstract
Repository.java:255: cannot resolve symbol
    [javac] symbol  : class MarshalListener
    [javac] location: class org.obe.engine.repository.AbstractRepository
    [javac]                 marshaller.setMarshalListener(new MarshalListener()
{
    [javac]                                                   ^
    [javac] Note: E:/Asir_CVS/obe/obe/obeengine/src/org/obe/convert/ConverterReg
istry.java uses or overrides a deprecated API.
    [javac] Note: Recompile with -deprecation for details.
    [javac] 13 errors

BUILD FAILED
file:E:/Asir_CVS/obe/obe/obeengine/build.xml:140: Compile failed; see the compil
er error output for details.

Total time: 38 seconds
--------------------------------------------------------------------------------
为什么cvs上面的代码在编译是会提示错误呢?这正是本文要解决的问题。

在错误的开始处可以看到这样的提示“package org.exolab.castor.mapping does not exist”,
这也就是说我们编译的时候有某些jar包没有在classpath中，那么到底是那个jar包呢？

通过google可以知道，我们所缺少的是castor这个jar包（Castor是ExoLab Group下面的一个
开放源代码的项目，它主要实现的是O/R映射功能。它主要API和数据接口为：JDO-like, SQL,
OQL, JDBC, LDAP, XML, DSML。它支持分布式目录事务处理和时间；提供处理XML、Directory、
XADirectory的类库，提供从XML到JAVA类的转换机制。其中最重要的就是其XML映射机制和其
独创的Castor JDO的机制了）；但是在obe源码的lib目录下明明有一个castor-0.9.5.3-xml.jar
的文件存在啊，那为什么还会出错呢？

上面我们提到了通过prepare windows-mysql-jboss-3.2.3.properties命令来生成适合自己环境
的local.properties文件，那么这个local.properties文件是否真的适合我们自己的环境呢？

打开local.properties文件，搜索castor关键字，我们会发现这样一行：
--------------------------------------------------------------------------------
castor.jar=castor-0.9.9-xml.jar
--------------------------------------------------------------------------------
而obe源码的lib目录下的castor包是castor-0.9.5.3-xml.jar,很明显，问题就是jar包的版本
不对引起的，可以在http://www.castor.org/下载castor-0.9.9-xml.jar文件，放到obe源码的
lib目录下即可。

OK,重新输入ant命令进行编译，编译成功！

3、把obe程序部署到AS服务器上
在命令行输入ant deploy后，ant会自动把生成的obeserver.ear文件部署到AS上。

希望本文能给大家一点帮助，少走一些弯路，谢谢......

另外，我还有个问题，就是obeserver.ear部署到AS上以后，启动AS(jboss)后总是提示部署这个
文件错误。如果那位有这方面的资料，请回复。