WSO2 ——（3）ESB 源码编译
WSO2 ESB编译真是费劲，编译得花费四五个小时。先是编译4.8.0版本，缺少各种jar包转战到4.7.0版本，最后发现原来是公司网络原因，崩溃。4.7.0版本网上有人已经编译成功，又花了几天时间终于编译完成了。
1 几个概念
1.1 WSO2 ESB
wso2的一个产品，所有的wso2产品都是基于carbon的。Wso2esb是基于Apache Synapse项目的，Apache Synapse是Apache Axis2 项目的一个分支。
A WSO2 Product = Carbon Kernel + Set of features。
1.2 Carbon
Carbon是个基于eclipse equinox的基础整合OSGi框架容器，是一个集成的组件化的平台，在上面可以很方便地开发部署你需要的服务组件，不用担心服务管理，安全和扩展性问题，基于OSGi（java开放服务网关标准）提供更好的模块化和组件化，是一种OSGi兼容的中间件。
1.3 Apache Axis2
Axis框架来自 Apache 开放源代码组织，它是基于JAVA语言的最新的 SOAP 规范的开放源代码实现。有很多流行的开发工具都使用AXIS作为其实现支持Web服务的功能，例如JBuilder以及著名的Eclipse J2EE插件Lomboz。
Web Service是现在最适合实现SOAP的技术，而Axis2是实现Web Service的一种技术框架，是一个全功能的Web服务实现框架，比Axis 1.x 模块化更强、灵活性更高、更有效，这种体系结构可以很容易地插入到其他相关 Web 服务标准和协议（如 WS-Security、WS-Reliable Messaging 等）的实现中。
1.4 OSGi
OSGi(Open Service Gateway Initiative)技术是面向Java的动态模型系统。OSGi服务平台向Java提供服务，这些服务使Java成为软件集成和软件开发的首选环境。OSGi技术提供一种面向服务的架构，能使组件动态地发现对方。OSGi联盟已经开发了像HTTP服务器、配置、日志、安全、用户管理、XML等很多公共功能标准组件接口。
1.5 eclipse equinox
Equinox其实就是OSGi核心标准的完整实现，并且还在这个基础上增加了一些额外的功能（比如为框架增加了命令行和程序执行的入口）。我们能够利用Equinox项目的代码来运行一个实实在在的OSGi框架，框架启动后，可以将开发好的组件放到里面运行。
2 WSO2 目录
2.1 Carbon 目录
Carbon/Orbit
Kernel
platform
l Orbit绑定第三方依赖。wso2不包含的，但一些产品需要的。
l kernel包含产品运行的carbon平台的核心代码。
l platform包含carbon平台的所有产品。
编译源代码时，需先编译orbit，然后kernel，然后platform。
2.2 WSO2 ESB目录
一般WSO2 platform结构如下：
Turning/Build
Components
Dependencies
Features
Parent
platform-integration
patch-releases
Products
Samples
service-stubs
l build：云层stratos2配置用到的。
l components：实际组件源代码所在地。
l dependencies：产品所用的依赖。
l features：产品功能，每个功能可能包含多个组件。
l parent：父依赖。
l platform-integration：
l patch-releases：发布的各个版本产品的依赖。
l products：包含esb4.7.0产品。
l samples：提供的示例。
l Service-stubs：wsdl2 java代码生成的组件，客户端。
3 编译步骤
WSO2 ESB是基于carbon的。carbon是个基于eclipse equinox的基础整合OSGi框架容器。所以，要编译wso2esb，需要先编译carbon，最后再编译esb。
Carbon目录下包含orbit，kernel，platform，需先编译orbit，然后kernel，然后platform。WSO2 ESB4.7.0的源码基于Carbon4.1.0。orbit4.1.0，kernel4.1.0，platform4.1.5。
3.1 svn checkout下列源代码：
Orbit：https://svn.wso2.org/repos/wso2/carbon/orbit/tags/4.1.0/
Kernel：https://svn.wso2.org/repos/wso2/carbon/kernel/tags/4.1.0/
Platform：https://svn.wso2.org/repos/wso2/carbon/platform/tags/4.1.5/
3.2 编译orbit4.1.0
Orbit：G:\wso2\4.7.0srcsoftware\orbit4.1.0> mvn clean install
3.3 编译kernel4.1.0
Kernel：G:\wso2\4.7.0srcsoftware\kernel4.1.0> mvn clean install
3.4 编译platform4.1.5
Platform：G:\wso2\4.7.0srcsoftware\4.1.0> mvn clean install
4 典型问题
4.1 PermGen Space
首次编译kernel和platform都会出现这个问题，如图所示：
修改mvn.bat 设置set MAVEN_OPTS=-Xms768m -Xmx3072m -XX:MaxPermSize=1200m
mvn clean install 重新运行
4.2 Sun的专用API，可能会在未来版本中删除
G:\wso2\4,8.0srcsoftware\turing-chunk04\product-releases\chunk-04>mvn clean install出现下列错误,4.7.0出现同样错误。
G:\wso2\4,8.0srcsoftware\turing-chunk04\dependencies\synapse\2.1.2-wso2v2\modules\securevault 修改pom.xml配置文件，或者改compile版本号2.3.2，上述错误变成警告，编译通过。
<dependency>
<groupId>org.codehaus.plexus</groupId>
<artifactId>plexus-compiler-javac</artifactId>
<version>1.8.1</version>
</dependency>
4.3 编码UTF-8的不可映射字符
上述报错文件中涉及中文，4.7.0同样错误
G:\wso2\4,8.0srcsoftware\turing-chunk04\dependencies\staxon\1.2.0-wso2v2
修改pom.xml文件，添加<encoding>GBK</encoding>
4.4 Failed to execute goal on project ……
编译期间经常会出现类似上述错误，可以从网站手动下载jar包并安装。如http://maven.wso2.org/nexus/content/groups/wso2-public下载hive 的所有jar包，手工安装，重新运行。
然后报错缺少hive-cassandra jar包，上面网址没有该jar包。因为hive jar包目前我们用不上，所以在G:\wso2\4.7.0srcsoftware\4.1.5\components\analytics\org.wso2.carbon.hive.data.source.access\4.1.0 路径下修改pom，去掉所有hive依赖，重新编译即可。
4.5 ReasonPhrase：Forbidden（The ISA Server denied the specified Uniform Resource Location）
公司网络原因，屏蔽了某些网站或端口，使用ForeFront TMG代理。