|
@@ -1,11 +1,15 @@
|
|
|
package cn.nosum.wx.cp.api;
|
|
|
|
|
|
+import cn.nosum.http.entity.UploadRequest;
|
|
|
import cn.nosum.wx.common.entity.result.WxMediaUploadResult;
|
|
|
import cn.nosum.wx.common.error.WxErrorException;
|
|
|
|
|
|
import java.io.File;
|
|
|
-import java.io.IOException;
|
|
|
+
|
|
|
+import cn.nosum.wx.common.api.WxConsts;
|
|
|
+
|
|
|
import java.io.InputStream;
|
|
|
+import java.io.OutputStream;
|
|
|
|
|
|
/**
|
|
|
* 媒体管理接口.
|
|
@@ -16,6 +20,20 @@ public interface WxCpMediaService {
|
|
|
|
|
|
/**
|
|
|
* <pre>
|
|
|
+ * 上传图片.
|
|
|
+ * 上传图片得到图片URL,该URL永久有效
|
|
|
+ * 返回的图片URL,仅能用于图文消息(mpnews)正文中的图片展示;若用于非企业微信域名下的页面,图片将被屏蔽。
|
|
|
+ * 每个企业每天最多可上传100张图片
|
|
|
+ * 接口url格式:https://qyapi.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
|
|
|
+ * </pre>
|
|
|
+ *
|
|
|
+ * @param uploadRequest 上传文件对象封装
|
|
|
+ * @return 返回图片url
|
|
|
+ */
|
|
|
+ String uploadImg(UploadRequest uploadRequest) throws WxErrorException;
|
|
|
+
|
|
|
+ /**
|
|
|
+ * <pre>
|
|
|
* 上传多媒体文件.
|
|
|
* 上传的多媒体文件有格式和大小限制,如下:
|
|
|
* 图片(image): 1M,支持JPG格式
|
|
@@ -25,20 +43,10 @@ public interface WxCpMediaService {
|
|
|
* 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=上传下载多媒体文件
|
|
|
* </pre>
|
|
|
*
|
|
|
- * @param mediaType 媒体类型, 请看{@link cn.nosum.wx.common.api.WxConsts}
|
|
|
- * @param fileType 文件类型,请看{@link cn.nosum.wx.common.api.WxConsts}
|
|
|
+ * @param mediaType 媒体类型, 请看{@link WxConsts}
|
|
|
* @param inputStream 输入流,需要调用方控制关闭该输入流
|
|
|
*/
|
|
|
- WxMediaUploadResult upload(String mediaType, String fileType, InputStream inputStream);
|
|
|
-
|
|
|
- /**
|
|
|
- * 上传多媒体文件.
|
|
|
- *
|
|
|
- * @param mediaType 媒体类型
|
|
|
- * @param file 文件对象
|
|
|
- * @see #upload(String, String, InputStream)
|
|
|
- */
|
|
|
- WxMediaUploadResult upload(String mediaType, File file);
|
|
|
+ WxMediaUploadResult upload(String mediaType, UploadRequest inputStream) throws WxErrorException;
|
|
|
|
|
|
/**
|
|
|
* <pre>
|
|
@@ -48,9 +56,10 @@ public interface WxCpMediaService {
|
|
|
* </pre>
|
|
|
*
|
|
|
* @param mediaId 媒体id
|
|
|
- * @return 保存到本地的临时文件
|
|
|
+ * @return 文件流
|
|
|
+ * @throws WxErrorException 企业微信接口调用异常
|
|
|
*/
|
|
|
- File download(String mediaId);
|
|
|
+ OutputStream download(String mediaId) throws WxErrorException;
|
|
|
|
|
|
/**
|
|
|
* <pre>
|
|
@@ -65,19 +74,7 @@ public interface WxCpMediaService {
|
|
|
* @param mediaId 媒体id
|
|
|
* @return 保存到本地的临时文件
|
|
|
*/
|
|
|
- File getJssdkFile(String mediaId);
|
|
|
+ OutputStream getJssdkFile(String mediaId) throws WxErrorException;
|
|
|
+
|
|
|
|
|
|
- /**
|
|
|
- * <pre>
|
|
|
- * 上传图片.
|
|
|
- * 上传图片得到图片URL,该URL永久有效
|
|
|
- * 返回的图片URL,仅能用于图文消息(mpnews)正文中的图片展示;若用于非企业微信域名下的页面,图片将被屏蔽。
|
|
|
- * 每个企业每天最多可上传100张图片
|
|
|
- * 接口url格式:https://qyapi.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
|
|
|
- * </pre>
|
|
|
- *
|
|
|
- * @param file 上传的文件对象
|
|
|
- * @return 返回图片url
|
|
|
- */
|
|
|
- String uploadImg(File file);
|
|
|
}
|