HKDAS应用开发示例

HKDAS应用开发示例
    通过建立不同的工程类型（核格、Java、Maven），查看示例可学习如何基于HKDAS开发rest、rpc和websocket服务。最新教程请查看HKDAS应用开发Demo(from git.hearker.com)
核格工程开发
请参考com/sunsheen/jfids/das/app/demo/DasAppStartupListener.java类。即建立一个核格Web工程的Listener类，使之作为HKDAS的启动入口。
不能互操作方式

• 需要在web容器（Tomcat、Jboss等）中配置环境变量HEARKEN_DAS_HOME为HKDAS的主目录才能启用HKDAS的功能。
• HKDAS主目录为HKDAS安装部署包(下载)压缩文件解压后的目录。

能互操作方式

• 将hearken-das-sdks.jar放入"项目根目录/WebRoot/WEB-INF/lib"目录下。

Java工程开发
HKDAS应用独立开发，可通过eclipse创建Java工程，然后将HKDAS部署包主目录下的lib文件夹下面的common和core两个子目录里面的所有jar包引入该Java工程作为依赖。

• HKDAS主目录为HKDAS安装部署包(下载)压缩文件解压后的目录。通常被赋值给环境变量HEARKEN_DAS_HOME。
• 引入大量的依赖jar包，建议通过eclipse创建自定义用户库来实现。自定义用户库操作说明

Maven工程开发

建立Java的Maven工程或者利用核格5.0版本的Maven功能，引入HKDAS应用开发的依赖库。Maven坐标如下：

 <dependency>
   <groupId>com.sunsheen.jfids.das</groupId>
   <artifactId>hearken-das-sdk</artifactId>
   <version>1.0.0</version>
 </dependency>
查看Maven依赖版本列表，可获取最新依赖版本

注意：需要配置核格私有Maven仓库。详细配置方法请查看。http://git.hearker.com/teach/teach_maven

接口服务开发示例
REST接口开发
请参考com/sunsheen/jfids/das/app/demo/provider/DasAppResource.java类。

• @Bean注解表示将该类加入HKDAS的IOC容器。
• REST接口开发使用相关注解完成。注解使用请参考REST注解说明。

注意：HKDAS的rest接口有一个统一的前缀：api/rest/das。开发者自定义的路径追加在后面组成完整访问路径。

RPC接口开发
请参考com/sunsheen/jfids/das/app/demo/provider/DasAppProvider.java类。

• @Provider注解表示将该类对外发布为服务提供者。@Provider没有值表示给标注的类的所有接口发布分别发布为一个接口服务，如果@Provider注解有值，则只发布对应配置的接口服务。注意：每一个RPC服务，必须有一个接口。

注意：每一个RPC服务，必须有一个接口。

Websocket接口开发
请参考com/sunsheen/jfids/das/app/demo/provider/DasAppWebsocket.java类。

• @ServerEndpoint注解类似于@Path注解，表示访问路径，支持路径参数。
• 在其上标注@Provider注解，可将该websocket类，同时发布为RPC服务，可用于后端主动向前端推送数据。该RPC接口统一对外暴露的接口为系统内置接口：com.sunsheen.jfids.das.core.web.socket.DasWebSocket。
• websocket类需要继承com.sunsheen.jfids.das.core.web.socket.DasWebSocketSample类。可以通过覆盖父类方法达到自定义业务功能的目的。