MaterialComponent (wechat middleware 0.6-RELEASE API)

java.lang.Object
- cn.zkdcloud.core.MaterialComponent

所有已实现的接口:: Component

public class MaterialComponent
extends Object
implements Component

素材管理

版本:: 2017/8/31
作者:: zk

字段概要

字段
限定符和类型	字段和说明
`static String`	`COUNT_PERSISTENT_MATERIAL` 获取各种永久素材个数(GET)
`static String`	`DELETE_PERSISTENT_MATERIAL` 删除永久素材(POST)
`static String`	`DOWNLOAD_PERSISTENT_MATERIAL` 下载永久素材(POST 图片，语音，缩略图，视频，图文消息)
`static String`	`DOWNLOAD_TEMP_MATERIAL` 下载临时的素材(GET 图片，语音，缩略图,视频等)
`static String`	`LIST_PERSISTENT_MATERIAL` 获取永久素材列表(POST)
`static MaterialComponent`	`materialComponent`
`static String`	`UPDATE_PERSISTENT_NEWS_MATERIAL` 修改永久图文素材(POST)
`static String`	`UPLOAD_IMG_URL` 上传永久图片获取其URL(POST,FROM)
`static String`	`UPLOAD_PERSISTENT_MATERIAL` 新增其他类型永久素材通过POST表单来调用接口，表单id为media，包含需要上传的素材内容，有filename、filelength、content-type等信息请注意：图片素材将进入公众平台官网素材管理模块中的默认分组。
`static String`	`UPLOAD_PERSISTENT_NEWS` 新增永久图文素材(POST)
`static String`	`UPLOAD_TEMP_MATERIAL` 上传临时素材(POST,FROM)

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`String`	`countPersistentMaterial()` 统计永久素材总数
`boolean`	`deletePersistentMaterial(String media_id)` 删除指定永久素材
`File`	`downloadPersistentMaterial(String media_id, String filePath)` 下载永久素材(不包括视频，图文)
`File`	`downloadPersistentMaterial(String media_id, String fileDirPath, String suffix)` 下载永久素材(不包括视频，图文)
`List<MaterialArticle>`	`downloadPersistentNews(String media_id)` 下载永久图文素材
`String`	`downloadPersistentVideo(String media_id)` 获取永久视频素材的url
`File`	`downloadTempMaterial(String media_id, String filePath)` 下载临时素材(不包括视频)
`File`	`downloadTempMaterial(String media_id, String fileDirPath, String suffix)` 下载临时素材(不包括视频)
`String`	`downloadVideo(String media_id)` 下载临时素材视频url
`static MaterialComponent`	`getInstance()` 获取material实例
`Map<String,List<MaterialArticle>>`	`getListNewsPersistentMaterial(Integer offset, Integer count)` 获取图文素材列表
`List<Material>`	`getListPersistentMaterial(MaterialType type, Integer offset, Integer count)` 获取其它素材列表
`void`	`init()`
`boolean`	`updateNewsPersistentMaterial(String media_id, Integer index, MaterialArticle article)` 更新某个图文永久素材
`String`	`uploadPersistentImage(File file)` 上传图片获取URL(注意返回的是url不是media_id,所以其不占素材库5000个限制)
`String`	`uploadPersistentMaterial(File file, MaterialType type, String title, String introduction)` 上传其他永久素材
`String`	`uploadPersistentMaterial(List<MaterialArticle> articles)` 上传永久图文素材
`String`	`uploadPersistentMaterial(String articles)` 上传永久图文素材
`String`	`uploadTempMaterial(File file, MaterialType type)` 上传临时素材(image,video,thumb,voice保存3天)

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - materialComponent
```
public static MaterialComponent materialComponent
```
  - UPLOAD_TEMP_MATERIAL
```
public static String UPLOAD_TEMP_MATERIAL
```
    上传临时素材(POST,FROM)
  - UPLOAD_PERSISTENT_NEWS
```
public static String UPLOAD_PERSISTENT_NEWS
```
    新增永久图文素材(POST)
  - UPLOAD_IMG_URL
```
public static String UPLOAD_IMG_URL
```
    上传永久图片获取其URL(POST,FROM)
  - UPLOAD_PERSISTENT_MATERIAL
```
public static String UPLOAD_PERSISTENT_MATERIAL
```
    新增其他类型永久素材通过POST表单来调用接口，表单id为media，包含需要上传的素材内容，有filename、filelength、content-type等信息请注意：图片素材将进入公众平台官网素材管理模块中的默认分组。意思是说也能从这里上传永久图片素材,至于占不占素材库，就不知道了，可能占
  - DOWNLOAD_TEMP_MATERIAL
```
public static String DOWNLOAD_TEMP_MATERIAL
```
    下载临时的素材(GET 图片，语音，缩略图,视频等)
  - DOWNLOAD_PERSISTENT_MATERIAL
```
public static String DOWNLOAD_PERSISTENT_MATERIAL
```
    下载永久素材(POST 图片，语音，缩略图，视频，图文消息)
  - COUNT_PERSISTENT_MATERIAL
```
public static String COUNT_PERSISTENT_MATERIAL
```
    获取各种永久素材个数(GET)
  - LIST_PERSISTENT_MATERIAL
```
public static String LIST_PERSISTENT_MATERIAL
```
    获取永久素材列表(POST)
  - UPDATE_PERSISTENT_NEWS_MATERIAL
```
public static String UPDATE_PERSISTENT_NEWS_MATERIAL
```
    修改永久图文素材(POST)
  - DELETE_PERSISTENT_MATERIAL
```
public static String DELETE_PERSISTENT_MATERIAL
```
    删除永久素材(POST)
- 方法详细资料
  - init
```
public void init()
```
    指定者:
    
    init 在接口中 Component
  - uploadTempMaterial
```
public String uploadTempMaterial(File file,
                                 MaterialType type)
```
    上传临时素材(image,video,thumb,voice保存3天)
    
    参数:
    
    file - file material
    
    type - 素材类型
    
    返回:
    
    media_id
  - uploadPersistentMaterial
```
public String uploadPersistentMaterial(List<MaterialArticle> articles)
```
    上传永久图文素材
    
    参数:
    
    articles - articles
    
    返回:
    
    media_id
  - uploadPersistentMaterial
```
public String uploadPersistentMaterial(String articles)
```
    上传永久图文素材
    
    参数:
    
    articles - articles 图文json
    
    返回:
    
    media_id
  - uploadPersistentImage
```
public String uploadPersistentImage(File file)
```
    上传图片获取URL(注意返回的是url不是media_id,所以其不占素材库5000个限制)
    
    参数:
    
    file - img(jpg/png)
    
    返回:
    
    image's url
  - uploadPersistentMaterial
```
public String uploadPersistentMaterial(File file,
                                       MaterialType type,
                                       String title,
                                       String introduction)
```
    上传其他永久素材
    
    参数:
    
    file - file material
    
    返回:
    
    media_id and url { "media_id":MEDIA_ID, "url":URL }
  - downloadVideo
```
public String downloadVideo(String media_id)
```
    下载临时素材视频url
    
    参数:
    
    media_id - media_id
    
    返回:
    
    video url
  - downloadTempMaterial
```
public File downloadTempMaterial(String media_id,
                                 String filePath)
```
    下载临时素材(不包括视频)
    
    参数:
    
    media_id - media_id
    
    filePath - filePath(带文件名+文件格式)
    
    返回:
    
    file
  - downloadTempMaterial
```
public File downloadTempMaterial(String media_id,
                                 String fileDirPath,
                                 String suffix)
```
    下载临时素材(不包括视频)
    
    参数:
    
    media_id - media_id
    
    fileDirPath - 下载文件夹路i纪念馆
    
    suffix - 后缀名
    
    返回:
  - downloadPersistentNews
```
public List<MaterialArticle> downloadPersistentNews(String media_id)
```
    下载永久图文素材
    
    参数:
    
    media_id - media_id
    
    返回:
    
    List
  - downloadPersistentVideo
```
public String downloadPersistentVideo(String media_id)
```
    获取永久视频素材的url
    
    参数:
    
    media_id - media_id
    
    返回:
    
    video download url
  - downloadPersistentMaterial
```
public File downloadPersistentMaterial(String media_id,
                                       String filePath)
```
    下载永久素材(不包括视频，图文)
    
    参数:
    
    media_id - media_id
    
    filePath - filePath(带文件名+文件格式)
    
    返回:
    
    file
  - downloadPersistentMaterial
```
public File downloadPersistentMaterial(String media_id,
                                       String fileDirPath,
                                       String suffix)
```
    下载永久素材(不包括视频，图文)
    
    参数:
    
    media_id - media_id
    
    fileDirPath - 下载文件夹路径
    
    suffix - 后缀名
    
    返回:
  - countPersistentMaterial
```
public String countPersistentMaterial()
```
    统计永久素材总数
    
    返回:
    
    countJson { "voice_count":COUNT, 语音 "video_count":COUNT, 视频 "image_count":COUNT, 照片 "news_count":COUNT 图文 }
  - getListNewsPersistentMaterial
```
public Map<String,List<MaterialArticle>> getListNewsPersistentMaterial(Integer offset,
                                                                       Integer count)
```
    获取图文素材列表
    
    参数:
    
    offset - 从全部素材的该偏移位置开始返回，0表示从第一个素材返回
    
    count - 返回素材的数量，取值在1到20之间
    
    返回:
  - getListPersistentMaterial
```
public List<Material> getListPersistentMaterial(MaterialType type,
                                                Integer offset,
                                                Integer count)
```
    获取其它素材列表
    
    参数:
    
    type - type
    
    offset - 从全部素材的该偏移位置开始返回，0表示从第一个素材返回
    
    count - 返回素材的数量，取值在1到20之间
    
    返回:
    
    list
  - updateNewsPersistentMaterial
```
public boolean updateNewsPersistentMaterial(String media_id,
                                            Integer index,
                                            MaterialArticle article)
```
    更新某个图文永久素材
    
    参数:
    
    media_id - meida_id
    
    index - 要更新的文章在图文消息中的位置（多图文消息时，此字段才有意义），第一篇为0
    
    article - 新图文素材内容
    
    返回:
    
    is or not success
  - deletePersistentMaterial
```
public boolean deletePersistentMaterial(String media_id)
```
    删除指定永久素材
    
    参数:
    
    media_id - media_id
    
    返回:
    
    is or not success
  - getInstance
```
public static MaterialComponent getInstance()
```
    获取material实例
    
    返回:
    
    materialComponentBean

类 MaterialComponent

字段概要

方法概要

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

字段详细资料

materialComponent

UPLOAD_TEMP_MATERIAL

UPLOAD_PERSISTENT_NEWS

UPLOAD_IMG_URL

UPLOAD_PERSISTENT_MATERIAL

DOWNLOAD_TEMP_MATERIAL

DOWNLOAD_PERSISTENT_MATERIAL

COUNT_PERSISTENT_MATERIAL

LIST_PERSISTENT_MATERIAL

UPDATE_PERSISTENT_NEWS_MATERIAL

DELETE_PERSISTENT_MATERIAL

方法详细资料

init

uploadTempMaterial

uploadPersistentMaterial

uploadPersistentMaterial

uploadPersistentImage

uploadPersistentMaterial

downloadVideo

downloadTempMaterial

downloadTempMaterial

downloadPersistentNews

downloadPersistentVideo

downloadPersistentMaterial

downloadPersistentMaterial

countPersistentMaterial

getListNewsPersistentMaterial

getListPersistentMaterial

updateNewsPersistentMaterial

deletePersistentMaterial

getInstance