支持类库

设置maven的pom文件：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>com.springsource.org.hibernate</artifactId>
    <version>3.2.6.ga</version>
</dependency>
<dependency>
    <groupId>javax.xml.stream</groupId>
    <artifactId>com.springsource.javax.xml.stream</artifactId>
    <version>1.0.1</version>
</dependency>

最新的hibernate是3.3.2.ga，由于slf4j版本需要1.5.2以上，高于当前spring-dm1.1.2环境的1.5.0，另外hibernate 3.3.x新增的特性暂时不用，所以暂时用3.2.6。

设置config.ini文件

在config.ini文件增加以下bundle的启动设置：

com.springsource.antlr.jar@start,com.springsource.javassist.jar@start,com.springsource.org.apache.commons.collections.jar@start,com.springsource.org.dom4j.jar@start,com.springsource.javax.xml.stream.jar@start,com.springsource.org.objectweb.asm.jar@start,com.springsource.org.objectweb.asm.attrs.jar@start,com.springsource.org.hibernate.jar@start

设置MANIFEST.MF文件

增加：

Import-Package: …,org.hibernate;version="[3.2.6.ga,3.2.6.ga]"

不过，直接使用比如eclipse的equinox（或者其他osgi框架的实现）和相关的http service bundle创建动态的webapp还是比较麻烦的，spring-dm提供了对osgi开发的简化。

手工使用spring提供的bundle是可以在比如eclipse环境下创建一个基于osgi的开发环境的，比如spring-dm开发简单的web绑定就是实现一个最简单的webapp的步骤，但是，这个过程开发效率还是比较低的。

借助maven，可以使开发进程进一步提高效率。以下以创建支持eclipse的多模块maven项目中示例为基础进一步演化，集成spring-dm。

为web-demo模块增加log4j的配置文件

创建src/main/resources目录，在该目录下创建log4j.properties文件，内容如下：

log4j.rootCategory=WARN, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout.ConversionPattern=%t %p [%c{2}] – %m%n
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.threshold=TRACE

log4j.logger.org.springframework.osgi=INFO
#log4j.logger.org.springframework=TRACE

为web-demo模块增加osgi清单文件

osgi的清单文件即java的清单文件，只是在该文件中增加osgi自定义的header。在src/main/resources目录下创建META-INF目录，该目录下创建MANIFEST.MF文件，内容为：

Web-ContextPath: web-demo
Bundle-ManifestVersion: 2
Bundle-Name: Simple OSGi War
Bundle-SymbolicName: com.easymorse.marshal.webdemo
Bundle-ClassPath: WEB-INF/classes
Import-Package: javax.servlet;version="2.4.0",
javax.servlet.http;version="2.4.0",
javax.servlet.resources;version="2.0.0",
javax.servlet.jsp;version="2.0.0",
javax.servlet.jsp.jstl.core;version="1.1.2",
javax.servlet.jsp.jstl.fmt;version="1.1.2",
javax.servlet.jsp.jstl.tlv;version="1.1.2",
org.apache.taglibs.standard.resources;version="1.1.2",
org.apache.taglibs.standard.tag.common.core;version="1.1.2",
org.apache.taglibs.standard.tag.rt.core;version="1.1.2",
org.apache.taglibs.standard.tei;version="1.1.2",
org.apache.taglibs.standard.tlv;version="1.1.2"

这个文件很关键，osgi通过该文件识别将来构建的war为bundle。

为web-demo模块增加依赖类库

pom.xml文件中增加如下依赖类库：

    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>servlet-api.osgi</artifactId>
        <version>2.5-SNAPSHOT</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>jsp-api.osgi</artifactId>
        <version>2.0-SNAPSHOT</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>2.5.5</version>
        <scope>provided</scope>
        <exclusions>
            <exclusion>
                <artifactId>commons-logging</artifactId>
                <groupId>commons-logging</groupId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-test</artifactId>
        <version>2.5.5</version>
        <scope>test</scope>
        <exclusions>
            <exclusion>
                <artifactId>commons-logging</artifactId>
                <groupId>commons-logging</groupId>
            </exclusion>
            <exclusion>
                <artifactId>junit</artifactId>
                <groupId>junit</groupId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>spring-osgi-test</artifactId>
        <version>1.1.2</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.junit</groupId>
        <artifactId>com.springsource.junit</artifactId>
        <version>3.8.2</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>mx4j.osgi</artifactId>
        <version>3.0.2-SNAPSHOT</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>net.sourceforge.cglib</groupId>
        <artifactId>com.springsource.net.sf.cglib</artifactId>
        <version>2.1.3</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>jasper.osgi</artifactId>
        <version>5.5.23-SNAPSHOT</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>commons-el.osgi</artifactId>
        <version>1.0-SNAPSHOT</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>jstl.osgi</artifactId>
        <version>1.1.2-SNAPSHOT</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>catalina.osgi</artifactId>
        <version>5.5.23-SNAPSHOT</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>catalina.start.osgi</artifactId>
        <version>1.0.0</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>spring-osgi-web</artifactId>
        <version>1.1.2</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>spring-osgi-web-extender</artifactId>
        <version>1.1.2</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>spring-osgi-extender</artifactId>
        <version>1.1.2</version>
    </dependency>
    <dependency>
        <groupId>org.aopalliance</groupId>
        <artifactId>com.springsource.org.aopalliance</artifactId>
        <version>1.0.0</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>2.5.5</version>
        <scope>provided</scope>
        <exclusions>
            <exclusion>
                <artifactId>aopalliance</artifactId>
                <groupId>aopalliance</groupId>
            </exclusion>
            <exclusion>
                <artifactId>commons-logging</artifactId>
                <groupId>commons-logging</groupId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>2.5.5</version>
        <scope>provided</scope>
        <exclusions>
            <exclusion>
                <artifactId>aopalliance</artifactId>
                <groupId>aopalliance</groupId>
            </exclusion>
            <exclusion>
                <artifactId>commons-logging</artifactId>
                <groupId>commons-logging</groupId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>easymock</groupId>
        <artifactId>easymock</artifactId>
        <version>1.2_Java1.3</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>com.springsource.slf4j.org.apache.commons.logging</artifactId>
        <version>1.5.0</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>com.springsource.slf4j.api</artifactId>
        <version>1.5.0</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>com.springsource.slf4j.log4j</artifactId>
        <version>1.5.0</version>
        <scope>provided</scope>
        <exclusions>
            <exclusion>
                <artifactId>log4j</artifactId>
                <groupId>log4j</groupId>
            </exclusion>
            <exclusion>
                <artifactId>com.springsource.org.apache.log4j</artifactId>
                <groupId>org.apache.log4j</groupId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>log4j.osgi</artifactId>
        <version>1.2.15-SNAPSHOT</version>
        <scope>test</scope>
    </dependency>

为web-demo模块增加构建扩展

在pom.xml文件build节点内部增加：

<extensions>
    <extension>
        <groupId>org.springframework.aws</groupId>
        <artifactId>spring-aws-maven</artifactId>
        <version>1.2.3</version>
    </extension>
</extensions>

spring针对maven的插件，用于通过amazon s3作为仓库的库文件下载。

为web-demo模块增加资源的设置

还是在pom文件的build节点内部：

<resources>
    <resource>
        <directory>src/main/resources</directory>
        <excludes>
            <exclude>META-INF/*</exclude>
        </excludes>
    </resource>
    <resource>
        <directory>src/main/java</directory>
    </resource>
</resources>

作用是设置哪些目录下的是资源文件。

为web-demo模块增加插件支持和配置

在pom文件的plugins节点内部：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <configuration>
        <warSourceExcludes>WEB-INF/lib/*</warSourceExcludes>
        <archive>
            <manifestFile>src/main/resources/META-INF/MANIFEST.MF</manifestFile>
        </archive>
    </configuration>
</plugin>

<plugin>
    <artifactId>maven-clean-plugin</artifactId>
    <configuration>
        <filesets>
            <fileset>
                <directory>META-INF</directory>
                <includes>
                    <include>MANIFEST.MF</include>
                </includes>
                <followSymlinks>false</followSymlinks>
            </fileset>
        </filesets>
    </configuration>
</plugin>

设置的插件为：

1. maven-war-plugin，用于war打包时包含文件的设置；
2. maven-clean-plugin，清除临时文件时的设置。

为web-demo模块增加equinox依赖

这个依赖没有放在上面的dependency中，是因为equinox只是osgi框架的一种，通过profile方式可以灵活更换为其他osgi实现，比如felix。在profiles节点内部：

<profile>
    <id>equinox</id>
    <dependencies>
        <dependency>
            <groupId>org.eclipse.osgi</groupId>
            <artifactId>org.eclipse.osgi</artifactId>
            <version>${equinox.ver}</version>
            <type>jar</type>
            <scope>provided</scope>
        </dependency>
    </dependencies>
    <properties>
        <osgi.test.platform>org.springframework.osgi.test.platform.EquinoxPlatform</osgi.test.platform>
        <log4j.ignoreTCL>true</log4j.ignoreTCL>
    </properties>
</profile>

为web-demo模块配置maven-dependency-plugin

maven-dependency-plugin插件也配置在profile中，这样便于灵活决定是否执行，这个配置将会复制所有项目依赖的jar文件到web-demo/libs目录下。

<profile>
    <id>dependencies</id>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <executions>
                    <execution>
                        <id>copy-dependencies</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>libs</outputDirectory>
                            <excludeTransitive>false</excludeTransitive>
                            <stripVersion>true</stripVersion>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</profile>

增加repository的配置信息

默认maven只使用官方repository，osgi封装成bundle的很多jar需要第三方的repository，加入以下repository可保证所有依赖包都能正常下载使用。

        <repository>
            <id>eclipse-repository</id>
            <name>Eclipse Repository</name>
            <url>http://repo1.maven.org/eclipse/</url>
        </repository>

        <repository>
            <id>com.springsource.repository.bundles.external</id>
            <name>SpringSource Enterprise Bundle Repository – External Bundle Releases</name>
            <url>http://repository.springsource.com/maven/bundles/external</url>
        </repository>

        <repository>
            <id>com.springsource.repository.bundles.release</id>
            <name>SpringSource Enterprise Bundle Repository – SpringSource Bundle Releases</name>
            <url>http://repository.springsource.com/maven/bundles/release</url>
        </repository>

        <repository>
            <id>spring-release</id>
            <name>Spring Portfolio Release Repository</name>
            <url>http://maven.springframework.org/release</url>
        </repository>
        <repository>
            <id>spring-external</id>
            <name>Spring Portfolio External Repository</name>
            <url>http://maven.springframework.org/external</url>
        </repository>
        <repository>
            <id>spring-milestone</id>
            <name>Spring Portfolio Milestone Repository</name>
            <url>http://maven.springframework.org/milestone</url>
        </repository>

        <repository>
            <id>spring-ext</id>
            <name>Spring External Dependencies Repository</name>
            <url>
http://springframework.svn.sourceforge.net/svnroot/springframework/repos/repo-ext/
      </url>
        </repository>

        <!– used when building against Spring snapshots –>
        <repository>
            <id>spring-snapshot</id>
            <name>Spring Portfolio Milestone Repository</name>
            <url>http://maven.springframework.org/snapshot</url>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </repository>

        <repository>
            <id>i21-s3-osgi-repo</id>
            <name>i21 osgi artifacts repo</name>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
            <url>http://maven.springframework.org/osgi</url>
        </repository>

这部分代码应复制到总项目pom.xml的repositories节点下面。各个子模块通过继承可以使用到这些repository。

创建osgi需要的启动文件config.ini

在web-demo项目中创建libs/configuration目录，在该目录下创建config.ini文件：

eclipse.ignoreApp=true
osgi.noShutdown=true
osgi.console=
osgi.clean=true

osgi.bundles=com.springsource.slf4j.api.jar@start,com.springsource.slf4j.org.apache.commons.logging.jar@start,com.springsource.slf4j.log4j.jar,log4j.osgi.jar@start,com.springsource.org.aopalliance.jar@start,com.springsource.net.sf.cglib.jar@start,spring-aop.jar@start,spring-beans.jar@start,spring-context.jar@start,spring-context-support.jar@start,spring-core.jar@start,spring-web.jar@start,spring-webmvc.jar@start,servlet-api.osgi.jar@start,jsp-api.osgi.jar@start,commons-el.osgi.jar@start,jstl.osgi.jar@start,jasper.osgi.jar@start,mx4j.osgi.jar@start,catalina.osgi.jar@start,catalina.start.osgi.jar@start,spring-osgi-core.jar@start,spring-osgi-io.jar@start,spring-osgi-extender.jar@start,spring-osgi-web.jar@start,spring-osgi-web-extender.jar@start,../target/web_demo.war@start,logging-demo.jar

创建日志模块的日志属性文件

在logging-demo项目增加src/main/resources目录，在该目录下创建log4j.properties文件：

log4j.rootCategory=INFO, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout.ConversionPattern=%t %p [%c{2}] – %m%n
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.threshold=TRACE

#log4j.logger.org.springframework.osgi=TRACE
#log4j.logger.org.apache.catalina=INFO

创建日志模块的osgi清单文件

创建src/main/resources/META-INF目录，在该目录下创建MANIFEST.MF文件：

Bundle-ManifestVersion: 2
Bundle-Name: Log4j configuration bundle
Bundle-SymbolicName: com.easymorse.marshal.webdemo.logging.cfg
Fragment-Host: org.springframework.osgi.log4j.osgi

日志模块pom文件的修改

日志模块将打包为jar文件，其中包含清单文件和日志属性文件，需要设置pom文件中的jar打包插件，在pom文件中增加：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <excludes>
                <exclude>META-INF/*</exclude>
            </excludes>
        </resource>
    </resources>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <configuration>
                <archive>
                    <manifestFile>src/main/resources/META-INF/MANIFEST.MF</manifestFile>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>

在web-demo项目中编写web页面供测试

编写一个静态页面index.html：

<html>
<body>
<h2>Hello World!</h2>
<p><%="JSP test success!"%></p>
<p><a href="helloworld">Servlet test</></p>
<p><a href="jstl.jsp">JSTL test</></p>
</body>
</html>

编写一个Servlet：

package com.easymorse.marshal.servlet;

import java.io.IOException;

import javax.servlet.ServletException;
import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class HelloOsgiWorldServlet extends HttpServlet {

    /**
     *
     */
    private static final long serialVersionUID = 1L;

    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        resp.setContentType("text/html");

        ServletOutputStream out = resp.getOutputStream();
        out.println("<html>");
        out.println("<head><title>Hello Osgi World</title></head>");
        out.println("<body>");
        out.println("<h1>Hello OSGi World</h1>");
        out.println("</body></html>");
    }
}

 

在web.xml文件中配置该servlet：

<servlet>
    <servlet-name>HelloOsgiWorldServlet</servlet-name>
    <servlet-class>
        com.easymorse.marshal.servlet.HelloOsgiWorldServlet
    </servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>HelloOsgiWorldServlet</servlet-name>
    <url-pattern>/helloworld</url-pattern>
</servlet-mapping>

编写一个测试jstl的页面jstl.jsp：

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

<c:out value="jstl ok."/>

maven构建

在根项目目录下执行：

mvn install

在web-demo项目目录下执行：

mvn -P dependencies,equinox clean package

启动web项目

在web-demo项目目录下执行：

java -jar libs\org.eclipse.osgi.jar

访问web项目

通过浏览器访问：

http://localhost:8080/web-demo/

接下来

接下来可以：

1. 利用spring-dm提供的osgi测试支持为web-demo做集成测试；
2. 集成其他组件，比如hibernate/JPA等。

源代码下载

通过svn或者web访问：

http://easymorse.googlecode.com/svn/tags/multi-modules-demo_2.0.0/

或者本地下载：

以下说明在eclipse下如何创建多模块的maven项目。

创建总的POM

mvn archetype:create -DgroupId=com.easymorse.marshal -DartifactId=multi-modules-demo

创建一个maven项目，然后修改该项目的pom.xml文件，package类型改为pom：

<packaging>pom</packaging>

并且删除src目录。

创建子模块

在总模块目录下，创建子模块，比如web-demo：

mvn archetype:create -DgroupId=com.easymorse.marshal -DartifactId=web-demo

再创建一个比如日志模块：

mvn archetype:create -DgroupId=com.easymorse.marshal -DartifactId=logging-demo

在总pom的pom.xml文件中已经自动加入：

<modules>
  <module>web-demo</module>
  <module>logging-demo</module>
</modules>

在各子模块的pom.xml文件中也自动加入了：

<parent>

  <artifactId>multi-modules-demo</artifactId>

  <groupId>com.easymorse.marshal</groupId>

  <version>1.0-SNAPSHOT</version>

</parent>

子模块继承了总POM的package，这里需要修改，web-demo模块覆盖为：

<packaging>war</packaging>

logging-demo模块修改为

<packaging>jar</packaging>

对上级模块的特别设置

需要在上级模块中设置java编译的参数，现在eclipse一般都使用比较新的版本，默认jdk是1.6，而maven默认还是1.4。

<plugin>

    <artifactId>maven-compiler-plugin</artifactId>

    <configuration>

        <source>1.6</source>

        <target>1.6</target>

        <encoding>UTF-8</encoding>

    </configuration>

</plugin>

对web子模块的特别设置

web子模块（web-demo）依赖它的日志模块logging-demo。设置pom.xml：

<dependency>

  <groupId>com.easymorse.marshal</groupId>

  <artifactId>logging-demo</artifactId>

  <version>1.0-SNAPSHOT</version>

</dependency>

web子模块在生成eclipse项目时，需要wtp支持，需要设置eclipse插件：

<build>

    <plugins>

        <plugin>

            <groupId>org.apache.maven.plugins</groupId>

            <artifactId>maven-eclipse-plugin</artifactId>

            <configuration>

                <wtpmanifest>true</wtpmanifest>

                <wtpapplicationxml>true</wtpapplicationxml>

                <wtpversion>2.0</wtpversion>

            </configuration>

        </plugin>

    </plugins>

</build>

生成Eclipse项目

在multi-modules-demo项目根目录下：

mvn eclipse:eclipse

然后，通过eclipse的import项目导入，可发现两个项目：

1. logging-demo
2. web-demo

都导入进来。导入可能会出现错误，主要是因为没有设置maven的类路径变量“M2_REPO”，可以设置这个类变量到maven的本地repository陌路即可。

如果要在eclipse中使用m2eclipse，需要使用：

mvn eclipse:m2eclipse

这样就不需要设置M2_REPO类库变量了。

接下来

接下来可以：

1. 通过eclipse配置的tomcat运行web-demo；
2. 通过maven的tomcat或者jetty插件运行web-demo（需要配置pom.xml文件）；
3. 为项目打包便于分发和部署。

源代码的下载

本文源代码见：

http://easymorse.googlecode.com/svn/tags/multi-modules-demo_1.0.0/

或者通过本地下载：

创建项目：

pax-create-project -g com.easymorse.marshal -a spring

进入创建的项目目录，为pax设置导入spring-dm的相关包的仓库：

pax-add-repository -i com.springsource.repository.bundles.external -u http://repository.springsource.com/maven/bundles/external

导入spring-dm指定版本绑定：

pax-import-bundle -g org.springframework.osgi -a spring-osgi-extender -v 1.1.2 — -DimportTransitive -DwidenScope

创建一个osgi服务绑定：

pax-create-bundle -p org.example.service — -Djunit

创建一个spring-dm bean：

pax-create-bundle -p org.example.bean — -Dspring -Djunit

构建，使用了equinox代替了默认的felix：

mvn clean install pax:provision "-Dframework=equinox"

创建为eclipse项目：

mvn clean install pax:eclipse -DdownloadSources

最后，就是通过eclipse导入该项目。

如果以上脚本片段使用有问题，可能是页面中字符“–”被转换为“—”，可参考以下脚本附件：

创建web绑定，在eclipse创建一个web项目，只有一个index.html即可。将项目导出打包为war。复制到hh目录下。

复制依赖的绑定，在这里选用的是jetty，所需的绑定可在spring-osgi的分发包的lib或者dist目录中找到：

• spring-osgi-web-1.1.2.jar
• spring-osgi-web-extender-1.1.2.jar
• servlet-api.osgi-2.5-SNAPSHOT.jar
• jetty-6.1.9.jar
• jetty-util-6.1.9.jar
• jetty.start.osgi-1.0.0.jar
• jetty.web.extender.fragment.osgi-1.0.0.jar

修改config.ini文件，增加如下内容即可：

spring-osgi-web-1.1.2.jar@start,spring-osgi-web-extender-1.1.2.jar@start,servlet-api.osgi-2.5-SNAPSHOT.jar@start,jetty-6.1.9.jar@start,jetty-util-6.1.9.jar@start,jetty.start.osgi-1.0.0.jar@start,jetty.web.extender.fragment.osgi-1.0.0.jar@start,first_web.war@start

注意，war格式可以作为绑定直接使用。

下载该项目：

还是以helloworldService为例。

将dependency目录下的所有jar文件复制到一个单独的文件夹中，比如c:/hh。将target目录下生成的helloworldService-0.0.1-SNAPSHOT.jar也复制到该目录下。

在c:/hh目录下创建configuration目录，并创建config.ini文件，内容如下：

osgi.bundles=com.springsource.net.sf.cglib-2.1.3.jar@start, com.springsource.org.aopalliance-1.0.0.jar@start, com.springsource.org.apache.commons.logging-1.1.1.jar@start, helloworldService-0.0.1-SNAPSHOT.jar@start, org.springframework.aop-2.5.5.A.jar@start, org.springframework.beans-2.5.5.A.jar@start, org.springframework.context-2.5.5.A.jar@start, org.springframework.core-2.5.5.A.jar@start, org.springframework.osgi.core-1.1.2.A.jar@start, org.springframework.osgi.extender-1.1.2.A.jar@start, org.springframework.osgi.io-1.1.2.A.jar@start

即除osgi包（org.eclipse.osgi-3.4.2.R34x_v20080826-1230.jar）以外，其他需要加入equinox osgi中的绑定都需要按照jar文件名@start[,]语法写在osgi.bundles项下。

然后，就可以运行了（在命令行，hh目录下）：

java -jar org.eclipse.osgi-3.4.2.R34x_v20080826-1230.jar -console

效果和在eclipse下控制台差不多。执行ss后：

上述环境的打包下载：

如果在运行期间configuration目录下有错误日志，内容如：

java.lang.IllegalStateException: Unable to acquire application service. Ensure that the org.eclipse.core.runtime bundle is resolved and started (see config.ini).
    at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:74)
    at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:386)
    at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:179)
    at org.eclipse.core.runtime.adaptor.EclipseStarter.main(EclipseStarter.java:150)

 

可在config.ini文件中增加：

eclipse.ignoreApp=true

使用环境

• jdk 1.6.0_07；
• eclipse 3.4；
• maven 2.0.9；
• spring 2.5.5；
• spring dm 1.1.2。

具体步骤

安装m2eclipse

http://m2eclipse.codehaus.org/update/

通过help>software updates…在线安装。

只需安装maven integration即可，不需要安装optional components。

创建maven项目

下面是创建完成的效果，项目名称helloworldService：

转换为plug-in项目

在转换后项目中增加的内容：

第一次运行

第一次运行，通过如下方式：

运行后，控制台可能打印一些异常，类似下面的BundleException：

不过不影响使用，使用ss命令，后面跟项目名称，查看绑定的状态：

虽然是空的项目，但是却表示一个绑定，而且当前处于active状态。

创建新的运行配置

上面的运行，默认带了很多不相干的eclipse绑定，而且有些是不可用的。重新创建一个简化的可用的运行配置并再次运行helloworldService绑定。

然后创建新的osgi framework运行配置：

在对话框更新如下标示内容：

这回运行不再报错了。 可以看到，只有两个绑定，一个是eclipse osgi，另一个是helloworldService。

设置maven，导入对spring的库依赖

在pom.xml文件中增加如下内容，主要是导入对spring相关库的依赖以及为了导入这些库需要的仓库。

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-test</artifactId>
        <version>2.5.5</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>2.5.5</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>2.5.5</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-beans</artifactId>
        <version>2.5.5</version>
        <scope>test</scope>
    </dependency>
</dependencies>
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <configuration>
                <archive>
                    <manifestFile>META-INF/MANIFEST.MF
                    </manifestFile>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>
<pluginRepositories>
    <pluginRepository>
        <id>maven-repo</id>
        <name>maven repo</name>
        <url>http://repo1.maven.org/maven2/
        </url>
    </pluginRepository>
    <pluginRepository>
        <id>agilejava</id>
        <url>http://agilejava.com/maven/</url>
    </pluginRepository>
</pluginRepositories>
<repositories>
    <repository>
        <id>eclipse-repository</id>
        <name>Eclipse Repository</name>
        <url>http://repo1.maven.org/eclipse/
        </url>
    </repository>
    <repository>
        <id>safehaus-repository</id>
        <name>Safehaus Repository</name>
        <url>http://m2.safehaus.org</url>
    </repository>
    <repository>
        <id>spring-ext</id>
        <name>Spring External Dependencies Repository</name>
        <url>
http://springframework.svn.sourceforge.net/svnroot/springframework/repos/repo-ext/
        </url>
    </repository>
    <repository>
        <id>spring-release</id>
        <name>Spring Portfolio Release Repository</name>
        <url> http://s3.amazonaws.com/maven.springframework.org/release</url>
    </repository>
    <repository>
        <id>spring-external</id>
        <name>Spring Portfolio Release Repository</name>
        <url> http://s3.amazonaws.com/maven.springframework.org/external
        </url>
    </repository>
    <repository>
        <id>spring-milestone</id>
        <name>Spring Portfolio Milestone Repository</name>
        <url> http://s3.amazonaws.com/maven.springframework.org/milestone
        </url>
    </repository>
    <repository>
        <id>i21-s3-osgi-repo</id>
        <name>i21 osgi artifacts repo</name>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
        <url> http://s3.amazonaws.com/maven.springframework.org/osgi</url>
    </repository>
</repositories>

 

这一步做完并保存，m2eclipse将自动导入pom.xml文件中声明的导入库：

通过m2eclipse执行maven的install

和通过命令行执行：

mvn install

效果相同，使用m2eclipse执行：

编写POJI和POJO

编写一个HelloWorldService接口：

package com.easymorse.marshal;

public interface HelloWorldService {
    public void sayHello();
}

编写该接口的实现，HelloWorldServiceImpl：

package com.easymorse.marshal;

public class HelloWorldServiceImpl implements HelloWorldService {
    public HelloWorldServiceImpl() {
        System.out.println("————–>new HelloWorldService start");
    }

    @Override
    public void sayHello() {
        System.out.println("Hello!!!!!!!!!!!!!!!!");
    }
}

编写spring的配置文件

一般根据spring推荐的做法，有关业务服务方面的bean放在一个配置文件中，有关osgi的bean放在另外的配置文件中，这样便于管理。

创建目录：

创建helloworldService.xml文件：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">
    <bean id="helloworldService" class=" com.easymorse.marshal.HelloWorldServiceImpl" />
</beans>

创建helloworldService-osgi.xml：

<?xml version="1.0" encoding="UTF-8"?>
<beans:beans xmlns="http://www.springframework.org/schema/osgi"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:beans="http://www.springframework.org/schema/beans"
    xsi:schemaLocation="http://www.springframework.org/schema/osgi
http://www.springframework.org/schema/osgi/spring-osgi.xsd
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
    <service id="helloworldServiceOsgi" ref="helloworldService"
        interface="com.easymorse.marshal.HelloWorldService" />
</beans:beans>

通过spring ide osgi扩展安装目标平台

这里不能使用eclipse内置的平台，而是要使用spring-dm的平台。获取和配置这些的最简单办法就是安装spring ide，并且包括osgi可选项。

安装的网址：

http://dist.springframework.org/snapshot/IDE/nightly

这里使用比较新的每日构建版本，发现spring ide osgi extension目前还没有spring-dm1.1版本的target platform。下面演示是使用spring-dm 1.0.2的target platform，目前测试是可以使用。在plug-in development属性中设置spring-dm 1.0.2作为target platform，并load target：

编辑plug-in的MANIFEST.MF

设置运行时（runtime）标签页中的导出包（exported package）：

修改运行选项

上面运行配置中将target platform去掉了，现在加上：

运行的效果：

可以看出是运行在spring-dm 1.0.2上。

手工设置spring-dm 1.1环境

如果需要用到spring-dm 1.1的新特性，可以手工实现环境搭建，不用预置的target platform。首先pom.xml文件的dependencies部分修改为：

<dependencies>
    <dependency>
        <groupId>org.aopalliance</groupId>
        <artifactId>com.springsource.org.aopalliance
        </artifactId>
        <version>1.0.0</version>
    </dependency>
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>com.springsource.org.apache.commons.logging
        </artifactId>
        <version>1.1.1</version>
    </dependency>
    <dependency>
        <groupId>net.sourceforge.cglib</groupId>
        <artifactId>com.springsource.net.sf.cglib
        </artifactId>
        <version>2.1.3</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>org.springframework.osgi.core
        </artifactId>
        <version>1.1.2.A</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>org.springframework.osgi.io
        </artifactId>
        <version>1.1.2.A</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.osgi</groupId>
        <artifactId>org.springframework.osgi.extender
        </artifactId>
        <version>1.1.2.A</version>
    </dependency>
    <dependency>
        <groupId>org.eclipse.osgi</groupId>
        <artifactId>org.eclipse.osgi</artifactId>
        <version>3.4.2.R34x_v20080826-1230</version>
    </dependency>
</dependencies>

然后执行maven的复制依赖库的插件：

mvn dependency:copy-dependencies

在target/dependency目录下应该复制了所有依赖的绑定jar文件。

导入这些绑定，通过eclipse的import功能：

取消target platform勾选，通过browse找到项目的dependecy目录：

下一步，add all即可，是全部所需的绑定：

完成后，package explorer中增加了其他绑定：

再次运行helloService，可以看到加载spring的日志，其中包括实例化helloService的打印内容：

在osgi控制台执行ss，看到所有绑定的状态：

手工执行的好处是，能够了解每个细节，而且可以去除所有不必要的绑定。

总结一下各个绑定（组件）和子系统之间的依赖关系：

增加跟踪信息 

上面的启动没有留下日志信息，可以利用run选项里面的tracing标签页增加跟踪信息：

运行时可看到如下跟踪日志，比如加载绑定的耗时等：

源代码

http://easymorse.googlecode.com/svn/trunk/osgi/helloworldService/

参考文档

• Eclipse, Maven and Spring DM for OSGi? platform Quick Start，下载见：介绍eclipse、maven和spring dm开发osgi入门的电子书
• Spring Dynamic Modules Reference Guide 1.1.2
• Spring Dynamic Modules 1.1.1 with Eclipse Equinox 3.4
• SpringSource Enterprise Bundle Repository FAQ

http://sourceforge.net/project/showfiles.php?group_id=73357&package_id=227224&release_id=630369

下载with-dependencies.zip的版本。

学习和理解simple-web-app，对使用spring-dm编写web应用作用很大。首先要求安装maven，可参考Maven的安装。另外就是能上网。

在命令行，进入${spring-dm}\src\samples\simple-web-app目录，使用equinox作为osgi框架打包：

mvn -P dependencies,equinox clean package

可能需要较长时间，maven自动下载所需到jar文件。

执行成功后，即可通过osgi框架启动一个web应用：

java -jar war/libs/org.eclipse.osgi.jar

或者也可使用控制台方式（控制台的具体使用见Equinox的简单使用）：

java -jar war/libs/org.eclipse.osgi.jar -console

然后就可以在浏览器访问：

http://localhost:8080/simple-web-app/

这是一个静态页面index.html，访问servlet示例：

http://localhost:8080/simple-web-app/helloWorldServlet

访问一个简单的jsp示例：

http://localhost:8080/simple-web-app/hello-osgi-world.jsp

访问jsp带JSTL的示例：

http://localhost:8080/simple-web-app/jsp-tag-osgi-world.jsp

在osgi中运行web应用最大的问题是有关资源和类的加载；在web应用中没有绑定空间或者导入包的概念。每个web容器有它自己的类加载继承关系，并且类路径的认定可能和osgi空间冲突。spring-dm通过为web容器和osgi空间桥接来解决这个问题，所以加载不再是问题。功能上独特的是，spring-dm的web支持直接和web容器集成，因此war过程对服务器是完全可控的，包括阻塞io和非阻塞io，线程池，规范的支持（servlet2.3,2.4,2.5）等。支持全部web.xml语法而不需要spring-dm自身做任何解析，也支持所有目标容器自定义的配置文件。一句话，所有目标容器支持的，osgi war通过spring-dm都可用。

osgi绑定和war：war特指对web应用打包的jar。每个war可认为是一个osgi绑定，这还需要定义相应的osgi清单条目。绑定并不要求.jar文件结尾，.war一样可作为绑定安装。

支持的web容器

目前，spring-dm支持tomcat5.5/6和jetty 6.1.8+/6.2。web支持兼容jdk1.4。

使用web支持

WAR和web应用的比较：web应用是war的一个实例。

和非war绑定类似，spring-dm web使用扩展器模式监测和安装war。然而，和标准spring-dm扩展器的一个显著不同是，spring-dm只能用于吃法安装和卸载war，因为实际的web应用的创建和线程管理由web容器管理。这也就是说，spring-dm web只控制向web容器部署和从容器删除war；由web容器创建和管理相应的web应用。

使用spring-dm，安装：

• spring-osgi-web.jar – spring-dm web支持；
• spring-osgi-web-extender.jar – spring-dm web扩展器。

绑定检查一起动的osgi war绑定（.war扩展名的绑定）并将他们部署到一个支持的web容器中。默认情况，将使用tomcat，不过可以更换为其他自定义服务器比如jetty。当war绑定已停止，spring-dm将停止并卸载与之相关的web应用。和通常web部署不同，servlet类需要显式的作为osgi类路径导入。

当运行一个web应用，它的web容器可启动和实例化它，不需要spring的在META-INF/spring下的.xml文件或者使用spring-dm清单条目。可简单的绑定你所需文件到war，而后通过你使用的web框架启动spring容器。

在osgi中的war类路径

servlet规范定义了war中一系列规则和位置。以下解释这些规范在osgi环境中的处理。

静态资源

当安装一个war绑定时，对于静态资源，spring-dm只认识绑定空间中可用的，WEB-INF目录下资源只能通过ServletContext访问，对远程访问不可见。另外任何类路径下资源可被该应用程序的代码使用，但对外不可见。

servlet

和通常war部署的一个主要区别是，servlet包需要导入才可对war绑定可用。做到这点，在Import-Package条目中增加如下包：

Import-Package: javax.servlet,javax.servlet.http,javax.servlet.resources

另外，servlet规范定义了war的类路径，基于预置的位置：

• WEB-INF/classes
• WEB-INF/lib/*.jar

而且，每个容器的实现可能提供添加到war类路径的公用类库。因为osgi对war所属类的关联、版本控制、重加载，spring-dm将忽略war预置的位置并总是使用osgi类路径实例。这意味着，war绑定导入的类可使用不在WEB-INF/classes文件夹或者WEB-INF/lib下的jar。这也表明，如果在war osgi类路径不可用的任何类，WEB-INF/classes目录下的该类不被识别。

增加对war预定义位置支持最简单的办法是，将这些加入绑定清单：

Bundle-Classpath: .,WEB-INF/classes,WEB-INF/lib/some.jar,WEB-INF/lib/lib.jar

需要确认的是默认Bundle-Classpath位置（.）要加上，逗号之间没有空格。

注意：目前osgi API没有提供绑定处理前的回调，spring-dm不能提供可靠的自动化这个过程的方式。然而，我们正在寻找合适的解决方法。bnd工具可以在打包期间增加这些条目。

在为嵌入的库创建条目前，需考虑是否可将他们安装为osgi绑定，这样他们可以让其他war共享，并且osgi可进行版本控制，多版本的同一个库，可在同一个vm中很好的共存。

JSP

对于jsp，spring-dm集成了tomcat jasper2引擎，可支持jsp1.2，2.0和2.1。osgi版本的jasper可在spring-dm osgi仓库中找到。不需要为osgi绑定导入jasper类。

标签库

JSP规范允许创建标签库。spring-dm扩展了jsp的约定，标签库可放置在war类路径或者导入包或者最为绑定。

spring-dm自动查找绑定中可用的tld，并使之对jasper引擎可用。tag定义是自动查找的，而标签类则不是，不过，osgi类路径优先。

当处理类库导出的大量标签时，可使用Require-Bundle代替Import-Package导入标签：

Require-Bundle: org.springframework.osgi.jstl.osgi

用上面的清单条目，JSTL所有类，可被war绑定访问。

警告：在大规模使用Require-Bundle前，阅读osgi规范（3.13）深入了解隐含的语义。

配置web扩展器

略。

1. web support (Servlet, JSP, Taglibs) for OSGi applications
2. Spring-MVC integration
3. classpath scanning
4. customization hooks for Spring-DM extender and web extender
5. event notifications for OSGi service importers and application contexts
6. refined OSGi proxy infrastructure
7. ‘greedy-proxy’ functionality for OSGi collections
8. integration with SpringSource Bundle Repository
9. support for custom locations for Spring powered bundles
10. pluggable mechanism for determining service dependencies
11. access to native OSGi ServiceReference for OSGi importers
12. new web sample

原文见：http://forum.springframework.org/showthread.php?t=56895