1 概述
本项目实现通过UDP从终端接收数据,并通过websocket转发到手持设备的示例来演示搭建过程。websocket是基于tomcat来提供功能的,并且websocket没有添加认证策略,仅用于演示。
2 开发环境
IDEA 2017.1.2
tomcat-8.0.43
java8
3 新建项目
按图中所示的步骤新建maven项目:
按图中所示配置GroupId和ArtifactId:
选择maven目录:
点击Next后,在弹出的对话框点击Finish。
生成的项目目录如下:
webapp/WEB-INF/web.xml为java web环境的配置
webapp/index.jsp是默认web页,生成的是hello world。
4 添加pom依赖
该项目使用了spring、websocket及日志模块logback,故添加它们的依赖。
<dependency>
<groupId>javax.websocket</groupId>
<artifactId>javax.websocket-api</artifactId>
<version>1.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>4.3.10.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>4.3.10.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>4.3.10.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-websocket</artifactId>
<version>4.3.10.RELEASE</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.25</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.16.16</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.3</version>
</dependency>
另外还需配置IDEA使用java1.8来编译(默认为java1.5),pom.xml中的build配置如下:
<build>
<finalName>transformer</finalName>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.3.2</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
</build>
5 web.xml配置
项目使用SpringIoC作为容器,于是在web.xml中引入spring的配置
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/spring-config.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
配置ContextLoaderListener的作用是在启动web容器时,自动装配ApplicationContext.xml(即spring-config.xml)的配置信息并初始化spring容器。
注意context-param和listener的顺序,listener在context-param之前IDEA会提示错误。
6 Spring容器配置
WebSocketManager和UDPReceiver需要纳入SpringIoC中在web容器启动时创建,故它们作为java bean配置在spring-config.xml中。
spring-config.xml配置如下:
<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"
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.xsd">
<!-- 配置包扫描 -->
<context:component-scan base-package="com.demo"/>
<!-- 配置java bean -->
<bean id="wsMnager" class="com.demo.WSManager"/>
<bean id="udpReceiver" class="com.demo.UDPReceiver"/>
</beans>
7 编写websocket ServerEndpoint
package com.demo;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.socket.server.standard.SpringConfigurator;
import javax.websocket.OnClose;
import javax.websocket.OnMessage;
import javax.websocket.OnOpen;
import javax.websocket.Session;
import javax.websocket.server.ServerEndpoint;
import java.io.IOException;
import java.nio.ByteBuffer;
/**
* Websocket端点类.
*
* @author 东轩幽客
*
* Created on 2017/10/9.
*/
@Slf4j
@ServerEndpoint(value = "/devMessage", configurator = SpringConfigurator.class)
public class WebSocketNode {
private Session session;
private WebSocketManager manager;
@Autowired
public WebSocketNode(WebSocketManager manager) {
this.manager = manager;
}