V2NIMMessageVideoAttachmentBuilder.java

浏览该文件的文档.

package com.netease.nimlib.sdk.v2.message.attachment.builder;

import com.netease.nimlib.sdk.v2.message.attachment.V2NIMMessageVideoAttachment;
import com.netease.nimlib.sdk.v2.storage.V2NIMStorageSceneConfig;
import com.netease.nimlib.v2.message.impl.attachment.V2NIMMessageVideoAttachmentImpl;

/**
 * 视频消息附件构建器类
 * 用于构建视频消息附件对象
 */
public final class V2NIMMessageVideoAttachmentBuilder {

    /**
     * 文件路径
     */
    private String path;
    /**
     * 文件显示名称
     */
    private String name;
    /**
     * 文件大小
     */
    private long   size;
    /**
     * 文件存储场景名
     * 默认为{@link com.netease.nimlib.sdk.v2.storage.V2NIMStorageSceneConfig#DEFAULT_IM}的getSceneName()值
     */
    private String sceneName = V2NIMStorageSceneConfig.DEFAULT_IM.getSceneName();
    /**
     * 文件MD5
     */
    private String md5;
    /**
     * 文件上传服务器路径
     */
    private String url;
    /**
     * 文件后缀名
     */
    private String ext;
    /**
     * 视频宽度
     */
    private int    width;
    /**
     * 视频高度
     */
    private int    height;
    /**
     * 视频时长
     */
    private int    duration;

    /**
     * 私有构造函数
     */
    private V2NIMMessageVideoAttachmentBuilder() {
    }

    /**
     * 创建一个新的视频消息附件构建器实例
     * @return 新的视频消息附件构建器实例
     */
    public static V2NIMMessageVideoAttachmentBuilder builder() {
        return new V2NIMMessageVideoAttachmentBuilder();
    }

    /**
     * 设置文件路径
     * @param path 文件路径
     * @return 当前构建器实例
     */
    public V2NIMMessageVideoAttachmentBuilder withPath(String path) {
        this.path = path;
        return this;
    }

    /**
     * 设置文件显示名称
     * @param name 文件显示名称
     * @return 当前构建器实例
     */
    public V2NIMMessageVideoAttachmentBuilder withName(String name) {
        this.name = name;
        return this;
    }

    /**
     * 设置文件大小，如果小于0，则不设置
     * @param size 文件大小
     * @return 当前构建器实例
     */
    public V2NIMMessageVideoAttachmentBuilder withSize(long size) {
        if (size >= 0) {
            this.size = size;
        }
        return this;
    }

    /**
     * 设置文件存储场景名，默认为{@link com.netease.nimlib.sdk.v2.storage.V2NIMStorageSceneConfig#DEFAULT_IM}的getSceneName()值
     * @param sceneName 存储场景名
     * @return 当前构建器实例
     */
    public V2NIMMessageVideoAttachmentBuilder withSceneName(String sceneName) {
        this.sceneName = sceneName;
        return this;
    }

    /**
     * 设置文件MD5
     * @param md5 文件MD5
     * @return 当前构建器实例
     */
    public V2NIMMessageVideoAttachmentBuilder withMd5(String md5) {
        this.md5 = md5;
        return this;
    }

    /**
     * 设置文件上传服务器路径
     * @param url 文件上传服务器路径
     * @return 当前构建器实例
     */
    public V2NIMMessageVideoAttachmentBuilder withUrl(String url) {
        this.url = url;
        return this;
    }

    /**
     * 设置文件后缀名
     * @param ext 文件后缀名
     * @return 当前构建器实例
     */
    public V2NIMMessageVideoAttachmentBuilder withExt(String ext) {
        this.ext = ext;
        return this;
    }

    /**
     * 设置视频宽度，如果小于0，则不设置
     * @param width 视频宽度
     * @return 当前构建器实例
     */
    public V2NIMMessageVideoAttachmentBuilder withWidth(int width) {
        if(width >= 0){
            this.width = width;
        }
        return this;
    }

    /**
     * 设置视频高度，如果小于0，则不设置
     * @param height 视频高度
     * @return 当前构建器实例
     */
    public V2NIMMessageVideoAttachmentBuilder withHeight(int height) {
        if(height >= 0){
            this.height = height;
        }
        return this;
    }

    /**
     * 设置视频时长，如果小于0，则不设置
     * @param duration 视频时长
     * @return 当前构建器实例
     */
    public V2NIMMessageVideoAttachmentBuilder withDuration(int duration) {
        if(duration >= 0){
            this.duration = duration;
        }
        return this;
    }

    /**
     * 构建视频消息附件对象
     * @return 构建的视频消息附件对象
     */
    public V2NIMMessageVideoAttachment build() {
        return new V2NIMMessageVideoAttachmentImpl(path, size, md5, url, ext, name, sceneName, null, duration, width, height);
    }
}