《SOA思想、技术与系统集成应用详解》读书笔记四-《SOA核心技术及应用》Apache Tuscany sca安装及与eclipse结合

我们在该系列读书笔记上篇了解了SCA的组成与思想，那如何实现SCA呢？最为常用的开源项目是Apache Tuscany SCA。它共分为三部分：SCA的开源实现，实现服务的整合；SDO的开源实现，实现数据的整合；DAS数据访问服务，提供SDO到关系数据库的接口服务。而且分别提供了java和C++的实现。

Apache Tuscany SCA如何使用呢？如何用它来搭建项目呢？在eclipse中如何与Tuscany结合呢？这些是我们要进一步使用Tuscany，深入了解SCA规范的前提！相信我，网上资源虽然很丰富，但是笔者阅遍各种写法，均没有试验成功！这也是因为Tuscany正在完善，相关工具及软件包都在改进中。直接入主题，开始Tuscany的体验。

1. 安装Maven2。

解压缩，配置环境变量，将maven目录加入到path中。至于mavne2是干什么的，如何使用，哪里下载？见

http://blog.csdn.net/whuqin/archive/2010/07/02/5709551.aspx和http://blog.csdn.net/whuqin/archive/2010/07/16/5740452.aspx。笔者使用的是apache maven-2.0.9版。

2. 下载Tuscany SCA源码，用maven进行构建。

Apache Tuscany SCA下载地址http://tuscany.apache.org/sca-java-2x-releases.html，笔者下载的是Tuscany SCA java 2.0 M5版。在cmd下进入tuscany sca源代码目录D:/Program File/tuscany-sca-2.0-M5-src，输入命令mvn，下面maven就开始自动下载相关文件、构建Tuscany项目。耐心等待，下载一个长时间没反应时，按ctrl+c结束后，重新输入mvn继续Down!

3. maven与eclipse的结合。

笔者使用的eclipse是Galileo-3.5版。首先，告诉eclipse maven的中央仓库的位置-maven项目所依赖的包存储位置，一般都在C:/Documents and Settings/username/.m2下。在cmd下，输入命令:

mvn -Declipse.workspace=E:/JEE eclipse:add-maven-repo

workspace为eclipse的工作目录。

其次，输入命令：

mvn archetype:create -DgroupId=test -DartifactId=mvnTest

就会在当前目录下，构建项目mvnTest。进入mvnTest项目目录，输入命令：

mvn eclipse:eclipse

那么项目mvnTest将会转变成eclipse项目，你会发现在mvnTest目录下生成了.project和.classpath文件。经常用eclipse就会知道这些eclipse项目特有的。下面就可以打开eclipse，当然了工作目录一定是命令mvn -Declipse.workspace所指定的目录E:/JEE。在eclipse菜单里选择File-import-general-existing projects into workspace，选择mvnTest项目，点击finish完成。之后就可以在eclipse对maven项目mvnTest进行开发了。无图无真相，eclipse下maven项目结构如图：



如果项目需要更多的依赖包，可以在pom.xml中增加包依赖，然后运行命令mvn eclipse:eclipse，在eclipse中刷新项目即可引入新包了。如若嫌麻烦可使用插件m2eclipse或mavenIDE。

4. 创建Tuscany SCA项目的maven原型。

maven原型(archetype)是用于构建项目的模板。即以后用maven创建tuscany sca项目时，结构就会和我们定义的原型完全一致。

4.1 cmd下输入命令

mvn archetype:create
-DgroupId=org.apache.maven.archetype
-DartifactId=maven-archetype-tuscany-sca
-DarchetypeArtifactId=maven-archetype-archetype

按照步骤3将项目maven-archetype-tuscany-sca导入eclipse。如下图：



其中，archetype.xml为maven项目原型的描述文件。

4.2 在src/main/java/resources/archetype-resources/src/main/java下，新建文件夹resources，并在其下新建文件App.composite(SCA的模块定义文件)。代码如下:

App.composite-

<?xml version="1.0" encoding="UTF-8"?>
<composite xmlns="http://www.osoa.org/xmlns/sca/1.0" name="App">
<component name="AppComponent">
<implementation.java class="${package}.App"/>
</component>
</composite>

修改原型描述文件archetype.xml为下：

<archetype>
<id>maven-archetype-tuscany-sca</id>
<sources>
<source>src/main/java/App.java</source>
</sources>
<resources>
<resource>src/main/resources/App.composite</resource>
</resources>
<testSources>
<source>src/test/java/AppTest.java</source>
</testSources>
</archetype>

修改项目对象模型文件/src/main/resources/archetype-resources/pom.xml如下:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion>
<groupId>${groupId}</groupId>
<artifactId>${artifactId}</artifactId>
<packaging>jar</packaging>
<version>${version}</version>
<name>${artifactId}</name>
<url>http://maven.apache.org</url>
<repositories>
<repository>
<id>apache.incubator</id>
<url>http://people.apache.org/repo/m2-incubating-repository</url>
</repository>
</repositories>
<dependencies>

<dependency>
<groupId>org.apache.tuscany.sca</groupId>
<artifactId>tuscany-host-embedded</artifactId>
<version>1.0-incubating</version>
</dependency>
<dependency>
<groupId>org.apache.tuscany.sca</groupId>
<artifactId>tuscany-implementation-java-runtime</artifactId>
<version>1.0-incubating</version>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>org.apache.tuscany.sca</groupId>
<artifactId>tuscany-sca-api</artifactId>
<version>2.0-M5</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>

<build>
<finalName>${artifactId}</finalName>
<pluginManagement>
<plugins>
<plugin>
<groupId>org.apache.tuscany.maven.plugins</groupId>
<artifactId>maven-tuscany-plugin</artifactId>
<version>2.0-M5</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.0.2</version>
<configuration>
<source>1.5</source>
<target>1.5</target>
</configuration>
</plugin>
</plugins>
</pluginManagement>
</build>
</project>

修改主java文件src/main/resources/archetype-resources/src/main/java/App.java如下：

package ${package};
/**
* Hello Tuscany!
*
*/
public class App
{
public String tuscany(){
return "Hello Tuscany";
}
}

修改java测试文件src/main/resources/archetype-resources/src/test/java/AppTest.java如下：

package ${package};
import static org.junit.Assert.*;
import org.apache.tuscany.sca.host.embedded.SCADomain;
import org.junit.Test;
/**
* Unit test for simple App.
*/
public class AppTest
{
/**
* Rigourous Test :-)
*/
@Test public void testTuscany()
{
SCADomain scaDomain = SCADomain.newInstance("App.composite");
IApp app=scaDomain.getService(IApp.class,"AppComponent");
assertNotNull(app);
assertNotNull(app.tuscany());
scaDomain.close();
}

public interface IApp
{
public String tuscany();
};
}

其中${package}为包名，用maven创建项目时，会被groupId代替。到此tuscany sca项目原型修改完毕，结构如下图：



4.3 在cmd下进入maven-archetype-tuscany-sca项目目录，输入命令mvn install。该原型项目就会被打包成jar形式存入maven的中央仓库。jar包名为:maven-archetype-tuscany-sca-1.0-SNAPSHOT.jar。

至此tuscany sca项目原型已经创建完了，以后在创建tuscany sca项目时，只需要在cmd下输入命令如下：

mvn archetype:create
-DarchetypeArtifactId=maven-archetype-tuscany-sca
-DarchetypeVersion=1.0-SNAPSHOT
-DgroupId={你要创建项目的包名，如org.apache}
-DartifactId={项目名}

然后将项目导入到eclipse下即可。

Tuscany sca java项目的创建及与eclipse的结合介绍完毕。下面我们就可以创建SCA项目，深入理解SCA规范了。