org.nutz.weixin.util

类 Wxs

java.lang.Object

org.nutz.weixin.util.Wxs

public class Wxs
extends Object

字段概要

字段

限定符和类型	字段和说明
static boolean	DEV_MODE

构造器概要

构造器

构造器和说明
Wxs()

方法概要

限定符和类型	方法和说明
static void	asJson(Writer writer, WxOutMsg msg) 将一个WxOutMsg转为主动信息所需要的Json文本
static String	asJson(WxOutMsg msg)
static void	asXml(Writer writer, WxOutMsg msg) 将一个WxOutMsg转为被动响应所需要的XML文本
static String	asXml(WxOutMsg msg)
static String	cdata(String str)
static boolean	check(String token, String signature, String timestamp, String nonce) 检查signature是否合法
static org.nutz.lang.util.NutMap	checkPayReturn(String xml, String key) 检查一下支付平台返回的 xml，是否签名合法，如果合法，转换成一个 map
static org.nutz.lang.util.NutMap	checkPayReturnMap(org.nutz.lang.util.NutMap map, String key) 检查一下支付平台返回的 xml，是否签名合法，如果合法，转换成一个 map
static WxInMsg	convert(InputStream in)
static <T> T	convert(InputStream in, Class<T> klass) 将一个输入流转为WxInMsg
static WxInMsg	convert(String data)
static <T> T	convert(String data, Class<T> klass)
static File	downloadMedia(String accessToken, String mediaId) 下载媒体文件(放到临时目录中), 返回对应文件
static void	enableDevMode()
static void	fillPayMap(Map<String,Object> map, String key) 为参数集合填充随机数，以及生成签名
static WxOutMsg	fix(WxInMsg in, WxOutMsg out) 根据输入信息,修正发送信息的发送者和接受者
static String	genPaySign(Map<String,Object> map, String key, String signType) 根据提交参数，生成签名
static String	genPaySignMD5(Map<String,Object> map, String key) 默认采用 MD5 方式的签名
static org.nutz.mvc.View	handle(WxHandler wxHandler, javax.servlet.http.HttpServletRequest req, String key) 用一个wxHandler处理对应的用户请求
static WxOutMsg	handle(WxInMsg msg, WxHandler handler) 根据不同的消息类型,调用WxHandler不同的方法
static WxOutMsg	handleEvent(WxInMsg msg, WxHandler handler) 根据msg中Event的类型,调用不同的WxHandler方法
static void	mapField(StringBuilder sb, Class<?> klass, Field field)
static String	pojoClass2MapClass(Class<?> klass)
static WxOutMsg	respImage(String to, String mediaId) 创建一条图片响应
static WxOutMsg	respMusic(String to, String title, String description, String musicURL, String hQMusicUrl, String thumbMediaId) 创建一个音乐响应
static WxOutMsg	respNews(String to, List<WxArticle> articles) 创建一个图文响应
static WxOutMsg	respNews(String to, WxArticle... articles) 创建一个图文响应
static WxOutMsg	respText(String content)
static WxOutMsg	respText(String to, String content) 创建一条文本响应
static WxOutMsg	respVideo(String to, String mediaId, String title, String description) 创建一个视频响应
static WxOutMsg	respVoice(String to, String mediaId) 创建一个语音响应
static String	tag(String key, String val)
static DocumentBuilder	xmls()

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

DEV_MODE

public static boolean DEV_MODE

构造器详细资料

Wxs

public Wxs()

方法详细资料

enableDevMode

public static void enableDevMode()

genPaySign

public static String genPaySign(Map<String,Object> map,
                                String key,
                                String signType)

根据提交参数，生成签名

参数:

map - 要签名的集合

key - 商户秘钥

返回:

签名

另请参阅:

微信商户平台签名算法

genPaySignMD5

public static String genPaySignMD5(Map<String,Object> map,
                                   String key)

默认采用 MD5 方式的签名

另请参阅:

genPaySign(Map, String, String)

fillPayMap

public static void fillPayMap(Map<String,Object> map,
                              String key)

为参数集合填充随机数，以及生成签名

参数:

map - 参数集合

key - 商户秘钥

另请参阅:

genPaySignMD5(Map, String)

checkPayReturn

public static org.nutz.lang.util.NutMap checkPayReturn(String xml,
                                                       String key)

检查一下支付平台返回的 xml，是否签名合法，如果合法，转换成一个 map

参数:

xml - 支付平台返回的 xml

key - 商户秘钥

返回:

合法的 Map

抛出:

"e.wx.sign.invalid"

另请参阅:

checkPayReturnMap(NutMap, String), 支付平台文档

checkPayReturnMap

public static org.nutz.lang.util.NutMap checkPayReturnMap(org.nutz.lang.util.NutMap map,
                                                          String key)

检查一下支付平台返回的 xml，是否签名合法，如果合法，转换成一个 map

参数:

map - 描述支付平台返回的 xml 信息的 Map 对象

key - 商户秘钥

返回:

合法的 Map

抛出:

"e.wx.sign.invalid"

另请参阅:

支付平台文档

convert

public static WxInMsg convert(InputStream in)

convert

public static WxInMsg convert(String data)

convert

public static <T> T convert(String data,
                            Class<T> klass)

convert

public static <T> T convert(InputStream in,
                            Class<T> klass)

将一个输入流转为WxInMsg

check

public static boolean check(String token,
                            String signature,
                            String timestamp,
                            String nonce)

检查signature是否合法

handle

public static WxOutMsg handle(WxInMsg msg,
                              WxHandler handler)

根据不同的消息类型,调用WxHandler不同的方法

handleEvent

public static WxOutMsg handleEvent(WxInMsg msg,
                                   WxHandler handler)

根据msg中Event的类型,调用不同的WxHandler方法

fix

public static WxOutMsg fix(WxInMsg in,
                           WxOutMsg out)

根据输入信息,修正发送信息的发送者和接受者

respText

public static WxOutMsg respText(String to,
                                String content)

创建一条文本响应

respImage

public static WxOutMsg respImage(String to,
                                 String mediaId)

创建一条图片响应

respVoice

public static WxOutMsg respVoice(String to,
                                 String mediaId)

创建一个语音响应

respVideo

public static WxOutMsg respVideo(String to,
                                 String mediaId,
                                 String title,
                                 String description)

创建一个视频响应

respMusic

public static WxOutMsg respMusic(String to,
                                 String title,
                                 String description,
                                 String musicURL,
                                 String hQMusicUrl,
                                 String thumbMediaId)

创建一个音乐响应

respNews

public static WxOutMsg respNews(String to,
                                WxArticle... articles)

创建一个图文响应

respNews

public static WxOutMsg respNews(String to,
                                List<WxArticle> articles)

创建一个图文响应

cdata

public static String cdata(String str)

tag

public static String tag(String key,
                         String val)

asXml

public static String asXml(WxOutMsg msg)

另请参阅:

asXml(Writer, WxOutMsg)

asXml

public static void asXml(Writer writer,
                         WxOutMsg msg)

将一个WxOutMsg转为被动响应所需要的XML文本

参数:

msg - 微信消息输出对象

asJson

public static String asJson(WxOutMsg msg)

另请参阅:

asJson(Writer, WxOutMsg)

asJson

public static void asJson(Writer writer,
                          WxOutMsg msg)

将一个WxOutMsg转为主动信息所需要的Json文本

参数:

msg - 微信消息输出对象

handle

public static org.nutz.mvc.View handle(WxHandler wxHandler,
                                       javax.servlet.http.HttpServletRequest req,
                                       String key)
                                throws IOException

用一个wxHandler处理对应的用户请求

抛出:

IOException

downloadMedia

public static File downloadMedia(String accessToken,
                                 String mediaId)

下载媒体文件(放到临时目录中), 返回对应文件

参数:

accessToken -

mediaId -

respText

public static WxOutMsg respText(String content)

pojoClass2MapClass

public static String pojoClass2MapClass(Class<?> klass)

mapField

public static void mapField(StringBuilder sb,
                            Class<?> klass,
                            Field field)

xmls

public static DocumentBuilder xmls()
                            throws ParserConfigurationException,
                                   SAXException,
                                   IOException

抛出:

ParserConfigurationException

SAXException

IOException