weixin4j-server
===============

微信netty服务
------------

功能列表
-------

* `netty服务器`

* `消息分发`

* `消息拦截`(待测试)

如何使用
-------
编写一个简单的服务启动类

	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","开发者token","加密密钥").addHandler(
					DebugMessageHandler.global).startup();
		}
	}

只针对文本消息的服务启动类

	public class MessageServerStartup{
		public static void main(String[] args) {
			// 需要一个文本消息的handler
			WeixinMessageHandler messageHandler = new WeixinMessageHandler() {
				@Override
				public WeixinResponse doHandle(WeixinRequest request,
						WeixinMessage message) throws WeixinException {
					return new TextResponse("HelloWorld!");
				}
	
				@Override
				public boolean canHandle(WeixinRequest request,
						WeixinMessage message) {
					return message.getMsgType().equals("text");
				}
			};
			// 当消息类型为文本(text)时回复「HelloWorld」, 否则回复调试消息
			new WeixinServerBootstrap("appid","开发者token","加密密钥").addHandler(messageHandler,
					DebugMessageHandler.global).startup();
		}
	}

更多内容将会写在wiki里

assembly打包(辅助)
-----------------
[assembly](http://maven.apache.org/plugins/maven-assembly-plugin/assembly.html)是maven的一个打包插件,它可以创建一个包含脚本、配置文件以及所有运行时所依赖的元素(jar)assembly插件能帮你构建一个完整的发布包.

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>weixin-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 t/usr/local/java 实际的目录`.

4.[startup.sh](./src/main/startup.sh)中`APP_HOME`为服务的启动目录,相当于运行服务时的classpath目录.

5.修改[startup.sh](./src/main/startup.sh)中`APP_MAINCLASS`为上述编写的netty服务启动类的全限定名.

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
 
[更新LOG](./CHANGE.md)
----------------------

相关参考
-------

![消息服务时序图](http://7mj4zs.com1.z0.glb.clouddn.com/weixin4j.png)

[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)