Android端Dropbox文件上传及获取已上传文件URL问题

Hey there! I’ve worked with Dropbox SDK 3.0.6 quite a bit, so I can walk you through exactly how to get a file’s URL right after a successful upload. There are two common approaches depending on whether you need a temporary preview link or a permanent shared link—let’s break them down:

1. 获取临时预览链接（短期使用） #

This generates a temporary link valid for around 4 hours. It doesn’t require sharing the file publicly, making it great for short-lived use cases like immediate in-app previews.

After uploading, you’ll get a FileMetadata object from the upload call. Use that to fetch the temporary link:

// 假设你已经完成上传并拿到了FileMetadata实例
FileMetadata uploadedFile = ...; // 你的上传结果对象
DbxClientV2 dbxClient = ...; // 初始化好的Dropbox客户端

try {
    // 调用getTemporaryLink方法获取临时链接
    TemporaryLink tempLink = dbxClient.files().getTemporaryLink(uploadedFile.getPathLower());
    String fileUrl = tempLink.getLink();
    
    // 这里就可以把fileUrl用于你的后续业务逻辑了
    System.out.println("临时预览链接: " + fileUrl);
} catch (DbxException e) {
    // 处理可能的异常（比如权限不足、文件不存在等）
    e.printStackTrace();
}

2. 创建永久共享链接（长期使用） #

If you need a URL that stays valid indefinitely (or until you revoke it), you’ll want to create a shared link. Note that if a shared link already exists for the file, the SDK will throw an error—so we’ll include logic to handle that case too.

FileMetadata uploadedFile = ...;
DbxClientV2 dbxClient = ...;

try {
    // 创建共享链接（默认公开访问，可通过SharedLinkSettings自定义权限）
    SharedLinkMetadata sharedLink = dbxClient.files().createSharedLinkWithSettings(uploadedFile.getPathLower());
    String permanentUrl = sharedLink.getUrl();
    
    // 可选：把默认的预览链接转换成直接下载链接
    String directDownloadUrl = permanentUrl.replace("?dl=0", "?dl=1");
    
    System.out.println("永久共享链接: " + permanentUrl);
    System.out.println("直接下载链接: " + directDownloadUrl);
} catch (DbxException e) {
    // 捕获"链接已存在"的异常，尝试获取已有的共享链接
    if (e instanceof DbxApiException) {
        DbxApiException apiException = (DbxApiException) e;
        if (apiException.getError().getPath().isPresent()) {
            try {
                List<SharedLinkMetadata> existingLinks = dbxClient.files()
                        .listSharedLinks(uploadedFile.getPathLower())
                        .getLinks();
                
                if (!existingLinks.isEmpty()) {
                    String existingUrl = existingLinks.get(0).getUrl();
                    System.out.println("已存在的共享链接: " + existingUrl);
                }
            } catch (DbxException ex) {
                ex.printStackTrace();
            }
        }
    } else {
        e.printStackTrace();
    }
}

关键注意事项 #

• 权限配置: 确保你的Dropbox应用拥有files.content.write和files.content.read权限（在Dropbox开发者控制台的权限设置里开启）。
• 链接权限: 如果你需要限制共享链接的访问（比如设置密码、到期时间），可以通过SharedLinkSettings对象自定义，比如：

  SharedLinkSettings settings = new SharedLinkSettings()
          .withRequestedVisibility(RequestedVisibility.PUBLIC)
          .withExpires(new Date(System.currentTimeMillis() + 7 * 24 * 60 * 60 * 1000)); // 7天后过期
  SharedLinkMetadata sharedLink = dbxClient.files().createSharedLinkWithSettings(uploadedFile.getPathLower(), settings);
  

内容的提问来源于stack exchange，提问作者Nilesh Prajapati