161 lines
5.6 KiB
Markdown
161 lines
5.6 KiB
Markdown
weixin4j-server
|
|
===============
|
|
|
|
微信回调消息服务器
|
|
----------------
|
|
base on netty.
|
|
|
|
功能列表
|
|
-------
|
|
* `netty服务器`
|
|
|
|
* `消息分发`
|
|
|
|
* `消息拦截`(还需更多测试
|
|
|
|
如何使用
|
|
-------
|
|
###maven依赖(1.1.4,2015-12-10 released)
|
|
|
|
<dependency>
|
|
<groupId>com.foxinmy</groupId>
|
|
<artifactId>weixin4j-server</artifactId>
|
|
<version>1.1.4</version>
|
|
</dependency>
|
|
###编写服务启动类
|
|
明文模式并总是调试输出微信请求信息的服务启动类.
|
|
|
|
public class MessageServerStartup{
|
|
public static void main(String[] args) {
|
|
new WeixinServerBootstrap("token").addHandler(
|
|
DebugMessageHandler.global).startup();
|
|
}
|
|
}
|
|
|
|
密文模式的服务启动类
|
|
|
|
public class MessageServerStartup{
|
|
public static void main(String[] args) {
|
|
new WeixinServerBootstrap("appid/corpid","token","aesKey").addHandler(
|
|
DebugMessageHandler.global).startup();
|
|
}
|
|
}
|
|
|
|
只针对文本消息的服务启动类
|
|
|
|
public class MessageServerStartup{
|
|
public static void main(String[] args) {
|
|
// 针对文本消息回复
|
|
WeixinMessageHandler messageHandler = new MessageHandlerAdapter<TextMessage>() {
|
|
@Override
|
|
public WeixinResponse doHandle0(WeixinRequest request,
|
|
TextMessage message) throws WeixinException {
|
|
return new TextResponse("HelloWorld!");
|
|
}
|
|
};
|
|
// 当消息类型为文本(text)时回复「HelloWorld」, 否则回复调试消息
|
|
new WeixinServerBootstrap(appid, token, aesKey).addHandler(
|
|
messageHandler, DebugMessageHandler.global).startup();
|
|
}
|
|
}
|
|
}
|
|
使用拦截器处理消息请求的启动类
|
|
|
|
public static void main(String[] args) {
|
|
// 拦截所有请求
|
|
WeixinMessageInterceptor interceptor = new MessageInterceptorAdapter() {
|
|
@Override
|
|
public boolean preHandle(ChannelHandlerContext context,
|
|
WeixinRequest request, WeixinResponse response, Object message,
|
|
WeixinMessageHandler handler) throws WeixinException {
|
|
context.write(new TextResponse("所有消息被拦截了！"));
|
|
return false;
|
|
}
|
|
@Override
|
|
public void postHandle(ChannelHandlerContext context,
|
|
WeixinRequest request, WeixinResponse response, WeixinResponse response,
|
|
Object message, WeixinMessageHandler handler)
|
|
throws WeixinException {
|
|
System.err.println("preHandle返回为true,执行handler后");
|
|
}
|
|
@Override
|
|
public void afterCompletion(ChannelHandlerContext context,
|
|
WeixinRequest request, WeixinResponse response, Object message,
|
|
WeixinMessageHandler handler, WeixinException exception)
|
|
throws WeixinException {
|
|
System.err.println("请求处理完毕");
|
|
}
|
|
};
|
|
new WeixinServerBootstrap("token").addInterceptor(interceptor)
|
|
.addHandler(BlankMessageHandler.global).startup();
|
|
}
|
|
|
|
更多内容将会写在wiki里
|
|
|
|
assembly打包(辅助)
|
|
-----------------
|
|
> [assembly](http://maven.apache.org/plugins/maven-assembly-plugin/assembly.html)是maven的一个打包插件,它可以构建一个包含脚本、配置文件以及所有运行时所依赖的元素的完整发布包.
|
|
|
|
1.复制[assembly.xml](./src/main/assembly.xml)和[startup.sh](./src/main/startup.sh)到自己工程的src/main目录下.
|
|
|
|
2.在项目pom.xml中的/bulid/plugins节点新增如下配置
|
|
|
|
<plugin>
|
|
<groupId>org.apache.maven.plugins</groupId>
|
|
<artifactId>maven-assembly-plugin</artifactId>
|
|
<version>2.5.1</version>
|
|
<configuration>
|
|
<descriptors>
|
|
<descriptor>src/main/assembly.xml</descriptor>
|
|
</descriptors>
|
|
<finalName>weixin4j-server</finalName>
|
|
</configuration>
|
|
<executions>
|
|
<execution>
|
|
<id>make-assembly</id>
|
|
<phase>package</phase>
|
|
<goals>
|
|
<goal>single</goal>
|
|
</goals>
|
|
</execution>
|
|
</executions>
|
|
</plugin>
|
|
`descriptor`表示[assembly](./src/main/assembly.xml)文件的位置.
|
|
|
|
`finalName`表示打包(zip)后的文件名,需配合[startup.sh](./src/main/startup.sh)中`APP_HOME`的值使用.
|
|
|
|
3.[startup.sh](./src/main/startup.sh)中`JAVA_HOME`为java运行环境(jre|jdk)的安装根目录,如果与脚本中的值不一致,可使用软连接命令:`ln -s /usr/local/java 实际的目录`.
|
|
|
|
4.[startup.sh](./src/main/startup.sh)中`APP_HOME`为服务的启动目录,相当于运行服务时的classpath目录.
|
|
|
|
5.修改[startup.sh](./src/main/startup.sh)中`APP_MAINCLASS`为上述编写的带main方法的服务启动类的全限定名.
|
|
|
|
6.执行`mvn package`命令后在target目录下得到一个zip的压缩包,在7或者8中选择一种方式启动服务.
|
|
|
|
7.[上传zip包到服务器],解压包到启动目录(`APP_HOME`)的`上一级目录`后运行startup.sh脚本.
|
|
|
|
sh startup.sh start
|
|
|
|
8.ant远程部署
|
|
|
|
> 复制[`deploy.xml`](./deploy.xml)到自己工程的根目录下.
|
|
|
|
> Ant远程部署[`deploy.xml`](./deploy.xml)的正确执行需要[`jsch`](http://www.jcraft.com/jsch/)包的支持,下载jar包将其引入执行Ant命令时的`classpath`中.
|
|
|
|
> 正确填写`zip.name`、`host`、`pwd`、`main.dir`、`sub.dir`五个属性值.
|
|
|
|
> 右键 Run as -> Ant Build
|
|
|
|
相关参考
|
|
-------
|
|
|
|
|
|
|
|
[spring-webmvc:DispatcherServlet](https://github.com/spring-projects/spring-framework/blob/master/spring-webmvc/src/main/java/org/springframework/web/servlet/DispatcherServlet.java)
|
|
|
|
[spring-webmvc:HandlerAdapter](https://github.com/spring-projects/spring-framework/blob/master/spring-webmvc/src/main/java/org/springframework/web/servlet/HandlerAdapter.java)
|
|
|
|
[spring-webmvc:HandlerInterceptor](https://github.com/spring-projects/spring-framework/blob/master/spring-webmvc/src/main/java/org/springframework/web/servlet/HandlerInterceptor.java)
|
|
|
|
[更新LOG](./CHANGE.md)
|
|
---------------------- |