一直在忙项目上的事情,更新的有点儿晚了,今天抽空来讲一讲在osgi下通过cxf发布服务,具体可以参看osgi-http组件。
http://git.oschina.net/wyuxiao729/osmp/tree/master/osmp-http?dir=1&filepath=osmp-http&oid=c57f2e1633345a9298a42656cf707505f88edf1e&sha=e09ee23dba8ee3ef0239747604f6f1179eae0168
其实使用在osgi环境下使用cxf发布服务非常简单。cxf已经封装好了jaxws和jaxrs这种原生的ws服务的发布,实现起来也比较简单,定义接口,发布实现就Ok了。在osgi-http本例通过cxf发布了两种方式:restful和ws的服务。
定义接口很简单,代码如下:
接口定义:
/* * Project: OSMP * FileName: IRestPlatformTransport.java * version: V1.0 */ package com.osmp.http.transport; import javax.servlet.http.HttpServletRequest; import javax.ws.rs.core.Response; /** * Description:统一服务接口 REST * @author: wangkaiping * @date: 2016年8月9日 上午9:14:42上午10:51:30 */ public interface IRestPlatformTransport { /** * 获取数据 * @param source 来源 json格式{from:xx} * @param interfaceName 接口名称,对应服务 * @param parameter 接口参数,对应服务参数 * @return */ public Response data(String source,String interfaceName,String parameter,HttpServletRequest request); /** * 获取数据 * @param source 来源 json格式{from:xx} * @param interfaceName 接口名称,对应服务 * @param parameter 接口参数,对应服务参数 * @return */ public Response dataPost(String source,String interfaceName,String parameter,HttpServletRequest request); /** * 提交任务 * @param source 来源 json格式{from:xx} * @param interfaceName 接口名称,对应服务 * @param parameter 接口参数,对应服务参数 * @return */ public Response task(String source,String interfaceName,String parameter); }
接口实现:
/* * Project: OSMP * FileName: RestPlatformTransport.java * version: V1.0 */ package com.osmp.http.transport; import java.util.Map; import javax.servlet.http.HttpServletRequest; import javax.ws.rs.FormParam; import javax.ws.rs.GET; import javax.ws.rs.POST; import javax.ws.rs.Path; import javax.ws.rs.PathParam; import javax.ws.rs.Produces; import javax.ws.rs.QueryParam; import javax.ws.rs.core.Context; import javax.ws.rs.core.HttpHeaders; import javax.ws.rs.core.MediaType; import javax.ws.rs.core.Response; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.InitializingBean; import org.springframework.util.Assert; import com.osmp.http.define.ResponseBody; import com.osmp.http.define.RtCodeConst; import com.osmp.http.service.DataServiceProxy; import com.osmp.http.service.ServiceFactoryManager; import com.osmp.http.tool.ExceptionHandleProvider; import com.osmp.intf.define.config.FrameConst; import com.osmp.intf.define.model.InvocationDefine; import com.osmp.intf.define.model.ServiceContext; import com.osmp.utils.base.JSONUtils; import com.osmp.utils.net.RequestInfoHelper; /** * * Description:统一服务接口REST * @author: wangkaiping * @date: 2016年8月9日 上午9:16:20上午10:51:30 */ public class RestPlatformTransport implements IRestPlatformTransport, InitializingBean { private Logger logger = LoggerFactory.getLogger(RestPlatformTransport.class); @POST @Path(value = "/{svcName}") @Produces(MediaType.APPLICATION_JSON) public Response dataPost(@FormParam(FrameConst.SOURCE_NAME) String source, @PathParam("svcName") String interfaceName, @FormParam(FrameConst.PARAMETER_NAME) String parameter, @Context HttpServletRequest request) { return data(source, interfaceName, parameter, request); } @GET @Path(value = "/{svcName}") @Produces(MediaType.APPLICATION_JSON) public Response data(@QueryParam(FrameConst.SOURCE_NAME) String source, @PathParam("svcName") String interfaceName, @QueryParam(FrameConst.PARAMETER_NAME) String parameter, @Context HttpServletRequest request) { return Response.ok().entity("ok") .header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON + ";charset=UTF-8").build(); } @GET @Path(value = "/task") @Produces(MediaType.APPLICATION_JSON) public Response task(String source, String interfaceName, String parameter) { return null; } }
在这里我们使用jsr注解来定义接口请求类型,接口请求url和接口中mediaType类型
代码里注解
@POST 定义请求的类型
@Path(value="/{svcName}") restful风格请求路径
当然注解也可以写在接口上!
由于这里只是讲解发布restful接口。方法具体实现我已经去掉了,有兴趣的可以去看一下osmp-http里代码。
接下来webservice接口:
/* * Project: OSMP * FileName: ISoapPlatformTransport.java * version: V1.0 */ package com.osmp.http.transport; import javax.jws.WebMethod; import javax.jws.WebParam; import javax.jws.WebService; import com.osmp.http.define.ResponseBody; import com.osmp.intf.define.config.FrameConst; /** * Description:统一服务接口 soap * @author: wangkaiping * @date: 2016年8月9日 上午9:15:42上午10:51:30 */ @WebService(targetNamespace = "osmp.soap") public interface ISoapPlatformTransport { @WebMethod(action = "data", operationName = "data") public ResponseBody data(@WebParam(name=FrameConst.SOURCE_NAME) String source, @WebParam(name=FrameConst.SERVICE_NAME) String interfaceName, @WebParam(name=FrameConst.PARAMETER_NAME) String parameter); }
接口使用jdk原生的 jws注解定义接口的namespace和方法action和 operationName和参数等。具体可以查看jws和soap协议相关资料。
webservice接口实现:
/* * Project: OSMP * FileName: SoapPlatformTransport.java * version: V1.0 */ package com.osmp.http.transport; import java.util.Map; import javax.jws.WebService; import javax.servlet.http.HttpServletRequest; import org.apache.cxf.message.Message; import org.apache.cxf.phase.PhaseInterceptorChain; import org.apache.cxf.transport.http.AbstractHTTPDestination; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.InitializingBean; import org.springframework.util.Assert; import com.osmp.http.define.ResponseBody; import com.osmp.http.define.RtCodeConst; import com.osmp.http.service.DataServiceProxy; import com.osmp.http.service.ServiceFactoryManager; import com.osmp.intf.define.config.FrameConst; import com.osmp.intf.define.model.InvocationDefine; import com.osmp.intf.define.model.ServiceContext; import com.osmp.utils.base.JSONUtils; import com.osmp.utils.net.RequestInfoHelper; /** * * Description:统一服务接口SOAP * @author: wangkaiping * @date: 2016年8月9日 上午9:17:10上午10:51:30 */ @WebService(portName="port",serviceName="data",endpointInterface = "com.osmp.http.transport.ISoapPlatformTransport") public class SoapPlatformTransport implements ISoapPlatformTransport,InitializingBean{ private Logger logger = LoggerFactory.getLogger(RestPlatformTransport.class); private ServiceFactoryManager serviceFactoryManager; public void afterPropertiesSet() throws Exception { Assert.notNull(serviceFactoryManager,"PlatformServiceTransport property dataServiceManager not set.."); } public void setServiceFactoryManager(ServiceFactoryManager serviceFactoryManager) { this.serviceFactoryManager = serviceFactoryManager; } public ResponseBody data(String source, String interfaceName, String parameter) { Message message = PhaseInterceptorChain.getCurrentMessage(); HttpServletRequest request = (HttpServletRequest)message.get(AbstractHTTPDestination.HTTP_REQUEST); String ip = RequestInfoHelper.getRemoteIp(request); System.out.println("requstId:"+request.getAttribute(FrameConst.CLIENT_REQ_ID)); System.out.println("ip:"+ip); ResponseBody res = new ResponseBody(); // 获取对应服务 InvocationDefine define = serviceFactoryManager.getInvocationDefine(interfaceName); if (define == null) { res.setCode(RtCodeConst.ERR_CODE); res.setMessage("未找到服务"); logger.warn("未找到服务..."); return res; } // 接口参数验证 Map<String, String> sourceMap = JSONUtils.jsonString2Map(source); if (sourceMap == null || sourceMap.get(FrameConst.CLIENT_FROM) == null) { res.setCode(RtCodeConst.ERR_CODE); res.setMessage("接口参数非法"); logger.warn("接口参数非法..."); return res; } sourceMap.put(FrameConst.CLIENT_IP, ip); // 调用服务 ServiceContext serviceContext = new ServiceContext(sourceMap, interfaceName, parameter); DataServiceProxy serviceProxy = new DataServiceProxy(define, serviceContext); Object result = serviceProxy.execute(); res.setCode(RtCodeConst.SUCC_CODE); res.setData(result); return res; } }
完成接口定义和实现后。我们可以通过cxf将此接口暴露为服务供外部调用。
可以通过spring的方式或者buleprint的方式。在这里我为兼容使用spring的方式。配置文件如下:
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xmlns:cxf="http://cxf.apache.org/core" xmlns:jaxws="http://cxf.apache.org/jaxws" xmlns:jaxrs="http://cxf.apache.org/jaxrs" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd http://cxf.apache.org/core http://cxf.apache.org/schemas/core.xsd http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd http://cxf.apache.org/jaxrs http://cxf.apache.org/schemas/jaxrs.xsd"> <cxf:bus> <cxf:inInterceptors> <ref bean="requestParser"/> <bean class="org.apache.cxf.interceptor.LoggingInInterceptor"></bean> </cxf:inInterceptors> <cxf:outInterceptors> <bean class="org.apache.cxf.interceptor.LoggingOutInterceptor"></bean> </cxf:outInterceptors> </cxf:bus> <bean id="webserver" class="com.osmp.http.transport.RestPlatformTransport"> </bean> <bean id="soapServer" class="com.osmp.http.transport.SoapPlatformTransport"> </bean> <bean id="objectMapper" class="com.osmp.http.tool.DefaultObjectMapper"></bean> <jaxrs:server id="restServiceContainer" address="/service"> <jaxrs:serviceBeans> <ref bean="webserver" /> </jaxrs:serviceBeans> <jaxrs:providers> <bean class="org.codehaus.jackson.jaxrs.JacksonJsonProvider"> <constructor-arg index="0" ref="objectMapper"></constructor-arg> </bean> </jaxrs:providers> <jaxrs:extensionMappings> <entry key="json" value="application/json" /> </jaxrs:extensionMappings> <jaxrs:languageMappings> <entry key="en" value="en-gb" /> </jaxrs:languageMappings> </jaxrs:server> <jaxws:server id="soapServiceContainer" address="/soap"> <jaxws:serviceBean> <ref bean="soapServer" /> </jaxws:serviceBean> </jaxws:server> </beans>
到此为止,代码部分完成。如果是传统的j2ee的项目。可以直接通过http://ip:port/cxf来访问了。
那么在osgi的环境下我们怎样发布呢,这里其实也很简单,我使用的是servicemix作为容器。其本身已经集成了cxf,我们直接打成bundle部署就ok了,如果是karaf或原生的felix那就比较麻烦点儿,需要先安装cxf-bundle的依赖支持,这里不作说明,大家有空自己去研究!
这里pom需要依赖的jar包为
<dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-bundle</artifactId> </dependency> <dependency> <groupId>org.springframework.osgi</groupId> <artifactId>spring-osgi-core</artifactId> </dependency> <dependency> <groupId>org.osgi</groupId> <artifactId>org.osgi.core</artifactId> </dependency>
使用maven插件构建bundle需要使用 maven-bundle-plgin插件,在这里我们可以定义导入,导出package,bundle内嵌jar包等设置。详细设置见:
http://felix.apache.org/documentation/subprojects/apache-felix-maven-bundle-plugin-bnd.html
完整的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/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>com.osmp.baseweb</groupId> <artifactId>osmp-parent</artifactId> <version>1.0.0</version> </parent> <artifactId>osmp-http</artifactId> <packaging>bundle</packaging> <name>osmp-http</name> <properties> <maven.test.skip>true</maven.test.skip> </properties> <build> <plugins> <plugin> <groupId>org.apache.felix</groupId> <artifactId>maven-bundle-plugin</artifactId> <extensions>true</extensions> <configuration> <instructions> <Bundle-SymbolicName>${project.artifactId}</Bundle-SymbolicName> <DynamicImport-Package>*;resolution:=optional</DynamicImport-Package> <Import-Package>com.osmp.intf.define.config, com.osmp.intf.define.interceptor, com.osmp.intf.define.model, com.osmp.intf.define.factory, com.osmp.intf.define.service, com.osmp.utils.net, com.osmp.utils.base</Import-Package> <Embed-Dependency>jackson-jaxrs,jackson-xc</Embed-Dependency> </instructions> </configuration> </plugin> </plugins> </build> <dependencies> <dependency> <groupId>com.osmp.baseweb</groupId> <artifactId>osmp-intf-define</artifactId> <version>${project.version}</version> </dependency> <dependency> <groupId>com.osmp.baseweb</groupId> <artifactId>osmp-resource</artifactId> <version>${project.version}</version> </dependency> <dependency> <groupId>com.osmp.baseweb</groupId> <artifactId>osmp-tools</artifactId> <version>${project.version}</version> </dependency> <dependency> <groupId>com.osmp.baseweb</groupId> <artifactId>osmp-utils</artifactId> <version>${project.version}</version> </dependency> <dependency> <groupId>com.osmp.baseweb</groupId> <artifactId>osmp-log</artifactId> <version>${project.version}</version> </dependency> <dependency> <groupId>org.springframework.osgi</groupId> <artifactId>spring-osgi-core</artifactId> </dependency> <dependency> <groupId>org.osgi</groupId> <artifactId>org.osgi.core</artifactId> </dependency> <dependency> <groupId>org.codehaus.jackson</groupId> <artifactId>jackson-jaxrs</artifactId> <version>1.9.13</version> </dependency> <dependency> <groupId>org.codehaus.jackson</groupId> <artifactId>jackson-xc</artifactId> <version>1.9.13</version> </dependency> </dependencies> </project>
打出来的jar包是bundle类型。可以跑在osgi环境下。
在servicemix环境访问:http://ip:8181/cxf 可以看到我们定义好的restful接口和soap接口
cxf默认访问根路径是cxf 可以通过servicemix配置修改
快下班了,先写到这儿吧,其实发布一个cxf的restful和soap还是非常简单,网上例子一大把,如果在osgi环境下部署。建议使用karaf或者servicemix。
相关推荐
OSGI原理与最佳实践的完整版,共12章 第1 章OSGi 简介 第2 章OSGi 框架简介 第3 章基于Spring-DM 实现Petstore 第4 章基于Apache CXF 实现分布式Petstore 第5 章构建OSGI Bundle Repositor'y 第6 章OSGi 规范解读 ...
- **cxf-dosgi**:这是Apache CXF项目的一个子项目,专门用于支持OSGi环境下Web服务的开发和部署。它提供了将Web服务封装为OSGi包的能力,并支持这些服务的分发。 #### 三、开发流程 1. **环境搭建**:安装Eclipse...
在部署时,你需要将CXF的依赖库加入到项目的类路径中,并配置相应的服务发布和监听端点。 6. **CXF工具**:CXF提供了一些工具,如WSDL-to-Java(wsdl2java)和Java-to-WSDL(java2wsdl),帮助开发者在WSDL和Java...
其后进入OSGi实战,结合实例讲解如何基于OSGi框架编写模块化、动态化的各种Java应用;最后对OSGi知识进行深入讲解,通过对OSGi规范和实现框架(Equinox、Felix、Spring-DM和Apache CXF)的分析,以及最佳实践的介绍...
3. **Web服务集成**:OSGI可以通过使用如CXF或Apache Felix Web Service等库来创建和消费Web服务。这些库可以帮助你将OSGI服务暴露为Web服务,或者将Web服务的调用封装到OSGI模块中。 4. **SOAP与WSDL**:在例子中...
其后进入OSGi实战,结合实例讲解如何基于OSGi框架编写模块化、动态化的各种Java应用;最后对0SGi知识进行深入讲解,通过对0SGi规范和实现框架(Equinox、Felix、Spring—DM和Apache CXF)的分析,以及最佳实践的介绍,...
最后对OSGi知识进行深入讲解,通过对OSGi规范和实现框架(Equinox、Felix、Spring-DM和Apache CXF)的分析,以及最佳实践的介绍,帮助读者更好地掌握如何使用OSGi。 本书适合希望了解、深入掌握OSGi,以及编写模块化...
3. 使用OSGi服务注册表来发布和查找Web服务,实现服务的动态发现和依赖注入。 4. 考虑服务的安全性和性能,例如使用HTTPS、认证和授权机制,以及优化服务调用的性能。 5. 了解并应用JMS以实现异步处理和解耦,增强...
这个"apache-cxf-2.7.7.zip"压缩包包含了CXF框架的2.7.7版本,这是一个在2013年发布的稳定版本。CXF是Apache软件基金会的项目,它集成了多种Web服务标准,如SOAP、RESTful HTTP、WS-*规范等,为开发者提供了一个全面...
2. **Blueprint**:是Apache CXF项目中的一个子项目,提供了Spring XML配置在OSGi环境下的替代方案,支持动态的服务发现和依赖注入。 3. **Declarative Services (DS)**:OSGi标准的一部分,允许声明式地定义服务...
8. **服务容器集成**:CXF可以轻松地与Spring、OSGi和其他服务容器集成,提供灵活的部署选项。 9. **错误处理和日志记录**:CXF提供了一套完整的错误处理机制,包括异常映射和日志记录,方便开发者调试和排查问题。...
这个项目源自XFire,并在2006年被Apache软件基金会接纳,更名为CXF,CXF代表了"CXF是XML框架"(CXF = "CXF is XML Framework")。Apache CXF 3.1.9 是该框架的一个较新版本,提供了丰富的功能和改进,便于开发者构建...
4. **模块化设计**:CXF由多个模块组成,开发者可以根据项目需求选择使用,如 CXF-DOSGi(用于OSGi环境)、CXF-RTC(实时通信)和CXF-WS-Addressing(Web服务寻址)等。 5. **测试工具**:CXF提供了一些工具,如CXF...
例如,为了在项目中使用CXF,开发者需要将"apache-cxf-2.7.10.jar"添加到项目的类路径中,并根据服务的需求配置CXF的相关组件和服务端点。对于客户端,可以通过CXF生成的客户端代理类或者直接使用JAX-WS API来调用...
其后进入OSGi实战。结合实例讲解如何基于OSGi框架编写模块化、动态化的各种Java应用;最后对0SGi知识进行深入讲解,通过对0SGi规范和实现框架(Equinox、Felix、Spring—DM和Apache CXF)的分析,以及最佳实践的介绍,...
3. **数据绑定**:CXF支持多种数据绑定技术,如JAXB(Java Architecture for XML Binding)用于SOAP服务,以及JAX-RS注解用于RESTful服务。这使得XML文档与Java对象之间的转换变得更加简单。 4. **WSDL第一**:CXF...
Apache CXF 是一个开源的Java框架,用于构建和开发服务导向架构(SOA)和Web服务。这个"CXF2.6.7完整架包"是该框架的一个特定版本,包含所有必要的组件和库,使得开发者能够快速地搭建基于CXF的Web服务应用。 CXF的...
Apache CXF是一个开源的服务框架,它允许开发人员构建和部署SOAP和RESTful Web服务。CXF的名字来源于"CXF = XFire + CXF",XFire是CXF的前身,而CXF则代表了"Client eXtended Framework"。在Apache CXF 2.5.4版本中...
3. **示例**:可能包含一些示例项目,演示如何使用CXF创建和消费Web服务,供初学者参考学习。 4. **readme.txt**:通常会提供版本信息、安装说明、更新日志以及可能存在的已知问题等。 为了开始使用Apache CXF ...