74 lines
2.4 KiB
Java
74 lines
2.4 KiB
Java
package org.telegram.telegrambots.meta.api.methods;
|
|
|
|
import com.fasterxml.jackson.annotation.JsonProperty;
|
|
import com.fasterxml.jackson.core.type.TypeReference;
|
|
import lombok.AllArgsConstructor;
|
|
import lombok.Builder;
|
|
import lombok.EqualsAndHashCode;
|
|
import lombok.Getter;
|
|
import lombok.NoArgsConstructor;
|
|
import lombok.NonNull;
|
|
import lombok.Setter;
|
|
import lombok.ToString;
|
|
import org.telegram.telegrambots.meta.api.objects.ApiResponse;
|
|
import org.telegram.telegrambots.meta.api.objects.File;
|
|
import org.telegram.telegrambots.meta.exceptions.TelegramApiRequestException;
|
|
import org.telegram.telegrambots.meta.exceptions.TelegramApiValidationException;
|
|
|
|
import java.io.IOException;
|
|
|
|
/**
|
|
* @author Ruben Bermudez
|
|
* @version 1.0
|
|
* Use this method to get basic info about a file and prepare it for downloading.
|
|
* For the moment, bots can download files of up to 20MB in size.
|
|
* On success, a File object is returned.
|
|
* The file can then be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path>,
|
|
* where <file_path> is taken from the response.
|
|
* It is guaranteed that the link will be valid for at least 1 hour.
|
|
* When the link expires, a new one can be requested by calling getFile again.
|
|
*/
|
|
@EqualsAndHashCode(callSuper = false)
|
|
@Getter
|
|
@Setter
|
|
@ToString
|
|
@NoArgsConstructor
|
|
@AllArgsConstructor
|
|
@Builder
|
|
public class GetFile extends BotApiMethod<File> {
|
|
public static final String PATH = "getFile";
|
|
|
|
private static final String FILEID_FIELD = "file_id";
|
|
|
|
@JsonProperty(FILEID_FIELD)
|
|
@NonNull
|
|
private String fileId; ///< File identifier to get info about
|
|
|
|
@Override
|
|
public void validate() throws TelegramApiValidationException {
|
|
if (fileId == null) {
|
|
throw new TelegramApiValidationException("FileId can't be empty", this);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
public String getMethod() {
|
|
return PATH;
|
|
}
|
|
|
|
@Override
|
|
public File deserializeResponse(String answer) throws TelegramApiRequestException {
|
|
try {
|
|
ApiResponse<File> result = OBJECT_MAPPER.readValue(answer,
|
|
new TypeReference<ApiResponse<File>>(){});
|
|
if (result.getOk()) {
|
|
return result.getResult();
|
|
} else {
|
|
throw new TelegramApiRequestException("Error getting file", result);
|
|
}
|
|
} catch (IOException e) {
|
|
throw new TelegramApiRequestException("Unable to deserialize response", e);
|
|
}
|
|
}
|
|
}
|