org.csource.fastdfs.StorageClient1 Maven / Gradle / Ivy
/**
* Copyright (C) 2008 Happy Fish / YuQing
*
* FastDFS Java Client may be copied only under the terms of the GNU Lesser
* General Public License (LGPL).
* Please visit the FastDFS Home Page http://www.csource.org/ for more detail.
*/
package org.csource.fastdfs;
import org.csource.common.FastdfsException;
import org.csource.common.NameValuePair;
import java.io.IOException;
/**
* Storage client for 1 field file id: combined group name and filename
*
* @author Happy Fish / YuQing
* @version Version 1.21
*/
public class StorageClient1 extends StorageClient {
public static final String SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR = "/";
/**
* constructor
*/
public StorageClient1() {
super();
}
/**
* constructor
*
* @param trackerServer the tracker server, can be null
* @param storageServer the storage server, can be null
*/
public StorageClient1(TrackerServer trackerServer, StorageServer storageServer) {
super(trackerServer, storageServer);
}
public static byte splitFileId(String file_id, String[] results) {
int pos = file_id.indexOf(SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR);
if ((pos <= 0) || (pos == file_id.length() - 1)) {
return ProtoCommon.ERR_NO_EINVAL;
}
results[0] = file_id.substring(0, pos); //group name
results[1] = file_id.substring(pos + 1); //file name
return 0;
}
/**
* upload file to storage server (by file name)
*
* @param local_filename local filename to upload
* @param file_ext_name file ext name, do not include dot(.), null to extract ext name from the local filename
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadFile1(String local_filename, String file_ext_name, NameValuePair[] meta_list)
throws IOException, FastdfsException {
String parts[] = this.uploadFile(local_filename, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload file to storage server (by file name)
*
* @param group_name the group name to upload file to, can be empty
* @param local_filename local filename to upload
* @param file_ext_name file ext name, do not include dot(.), null to extract ext name from the local filename
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadFile1(String group_name,
String local_filename,
String file_ext_name,
NameValuePair[] meta_list) throws IOException, FastdfsException {
String parts[] = this.uploadFile(group_name, local_filename, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload file to storage server (by file buff)
*
* @param file_buff file content/buff
* @param file_ext_name file ext name, do not include dot(.)
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadFile1(byte[] file_buff, String file_ext_name, NameValuePair[] meta_list)
throws IOException, FastdfsException {
String parts[] = this.uploadFile(file_buff, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload file to storage server (by file buff)
*
* @param group_name the group name to upload file to, can be empty
* @param file_buff file content/buff
* @param file_ext_name file ext name, do not include dot(.)
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadFile1(String group_name, byte[] file_buff, String file_ext_name, NameValuePair[] meta_list)
throws IOException, FastdfsException {
String parts[] = this.uploadFile(group_name, file_buff, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload file to storage server (by callback)
*
* @param group_name the group name to upload file to, can be empty
* @param file_size the file size
* @param callback the write data callback object
* @param file_ext_name file ext name, do not include dot(.)
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadFile1(String group_name,
long file_size,
UploadCallback callback,
String file_ext_name,
NameValuePair[] meta_list) throws IOException, FastdfsException {
String parts[] = this.uploadFile(group_name, file_size, callback, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload appender file to storage server (by file name)
*
* @param local_filename local filename to upload
* @param file_ext_name file ext name, do not include dot(.), null to extract ext name from the local filename
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadAppenderFile1(String local_filename, String file_ext_name, NameValuePair[] meta_list)
throws IOException, FastdfsException {
String parts[] = this.uploadAppenderFile(local_filename, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload appender file to storage server (by file name)
*
* @param group_name the group name to upload file to, can be empty
* @param local_filename local filename to upload
* @param file_ext_name file ext name, do not include dot(.), null to extract ext name from the local filename
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadAppenderFile1(String group_name,
String local_filename,
String file_ext_name,
NameValuePair[] meta_list) throws IOException, FastdfsException {
String parts[] = this.uploadAppenderFile(group_name, local_filename, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload appender file to storage server (by file buff)
*
* @param file_buff file content/buff
* @param file_ext_name file ext name, do not include dot(.)
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadAppenderFile1(byte[] file_buff, String file_ext_name, NameValuePair[] meta_list)
throws IOException, FastdfsException {
String parts[] = this.uploadAppenderFile(file_buff, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload appender file to storage server (by file buff)
*
* @param group_name the group name to upload file to, can be empty
* @param file_buff file content/buff
* @param file_ext_name file ext name, do not include dot(.)
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadAppenderFile1(String group_name,
byte[] file_buff,
String file_ext_name,
NameValuePair[] meta_list) throws IOException, FastdfsException {
String parts[] = this.uploadAppenderFile(group_name, file_buff, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload appender file to storage server (by callback)
*
* @param group_name the group name to upload file to, can be empty
* @param file_size the file size
* @param callback the write data callback object
* @param file_ext_name file ext name, do not include dot(.)
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadAppenderFile1(String group_name,
long file_size,
UploadCallback callback,
String file_ext_name,
NameValuePair[] meta_list) throws IOException, FastdfsException {
String parts[] = this.uploadAppenderFile(group_name, file_size, callback, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload file to storage server (by file name, slave file mode)
*
* @param master_file_id the master file id to generate the slave file
* @param prefix_name the prefix name to generate the slave file
* @param local_filename local filename to upload
* @param file_ext_name file ext name, do not include dot(.), null to extract ext name from the local filename
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadFile1(String master_file_id,
String prefix_name,
String local_filename,
String file_ext_name,
NameValuePair[] meta_list) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(master_file_id, parts);
if (this.errno != 0) {
return null;
}
parts = this.uploadFile(parts[0], parts[1], prefix_name, local_filename, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload file to storage server (by file buff, slave file mode)
*
* @param master_file_id the master file id to generate the slave file
* @param prefix_name the prefix name to generate the slave file
* @param file_buff file content/buff
* @param file_ext_name file ext name, do not include dot(.)
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadFile1(String master_file_id,
String prefix_name,
byte[] file_buff,
String file_ext_name,
NameValuePair[] meta_list) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(master_file_id, parts);
if (this.errno != 0) {
return null;
}
parts = this.uploadFile(parts[0], parts[1], prefix_name, file_buff, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload file to storage server (by file buff, slave file mode)
*
* @param master_file_id the master file id to generate the slave file
* @param prefix_name the prefix name to generate the slave file
* @param file_buff file content/buff
* @param offset offset
* @param length length
* @param file_ext_name file ext name, do not include dot(.)
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadFile1(String master_file_id,
String prefix_name,
byte[] file_buff,
int offset,
int length,
String file_ext_name,
NameValuePair[] meta_list) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(master_file_id, parts);
if (this.errno != 0) {
return null;
}
parts = this.uploadFile(parts[0], parts[1], prefix_name, file_buff, offset, length, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* upload file to storage server (by callback)
*
* @param master_file_id the master file id to generate the slave file
* @param prefix_name the prefix name to generate the slave file
* @param file_size the file size
* @param callback the write data callback object
* @param file_ext_name file ext name, do not include dot(.)
* @param meta_list meta info array
* @return file id(including group name and filename) if success,
* return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public String uploadFile1(String master_file_id,
String prefix_name,
long file_size,
UploadCallback callback,
String file_ext_name,
NameValuePair[] meta_list) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(master_file_id, parts);
if (this.errno != 0) {
return null;
}
parts = this.uploadFile(parts[0], parts[1], prefix_name, file_size, callback, file_ext_name, meta_list);
if (parts != null) {
return parts[0] + SPLIT_GROUP_NAME_AND_FILENAME_SEPERATOR + parts[1];
}
else {
return null;
}
}
/**
* append file to storage server (by file name)
*
* @param appender_file_id the appender file id
* @param local_filename local filename to append
* @return 0 for success, != 0 for error (error no)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int appendFile1(String appender_file_id, String local_filename) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(appender_file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.appendFile(parts[0], parts[1], local_filename);
}
/**
* append file to storage server (by file buff)
*
* @param appender_file_id the appender file id
* @param file_buff file content/buff
* @return 0 for success, != 0 for error (error no)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int appendFile1(String appender_file_id, byte[] file_buff) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(appender_file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.appendFile(parts[0], parts[1], file_buff);
}
/**
* append file to storage server (by file buff)
*
* @param appender_file_id the appender file id
* @param file_buff file content/buffer
* @param offset start offset of the buffer
* @param length the length of the buffer to append
* @return 0 for success, != 0 for error (error no)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int appendFile1(String appender_file_id, byte[] file_buff, int offset, int length)
throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(appender_file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.appendFile(parts[0], parts[1], file_buff, offset, length);
}
/**
* append file to storage server (by callback)
*
* @param appender_file_id the appender file id
* @param file_size the file size
* @param callback the write data callback object
* @return 0 for success, != 0 for error (error no)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int appendFile1(String appender_file_id, long file_size, UploadCallback callback)
throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(appender_file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.appendFile(parts[0], parts[1], file_size, callback);
}
/**
* modify appender file to storage server (by file name)
*
* @param appender_file_id the appender file id
* @param file_offset the offset of appender file
* @param local_filename local filename to append
* @return 0 for success, != 0 for error (error no)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int modifyFile1(String appender_file_id, long file_offset, String local_filename)
throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(appender_file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.modifyFile(parts[0], parts[1], file_offset, local_filename);
}
/**
* modify appender file to storage server (by file buff)
*
* @param appender_file_id the appender file id
* @param file_offset the offset of appender file
* @param file_buff file content/buff
* @return 0 for success, != 0 for error (error no)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int modifyFile1(String appender_file_id, long file_offset, byte[] file_buff)
throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(appender_file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.modifyFile(parts[0], parts[1], file_offset, file_buff);
}
/**
* modify appender file to storage server (by file buff)
*
* @param appender_file_id the appender file id
* @param file_offset the offset of appender file
* @param file_buff file content/buff
* @param buffer_offset start offset of the buff
* @param buffer_length the length of buff to modify
* @return 0 for success, != 0 for error (error no)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int modifyFile1(String appender_file_id,
long file_offset,
byte[] file_buff,
int buffer_offset,
int buffer_length) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(appender_file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.modifyFile(parts[0], parts[1], file_offset, file_buff, buffer_offset, buffer_length);
}
/**
* modify appender file to storage server (by callback)
*
* @param appender_file_id the appender file id
* @param file_offset the offset of appender file
* @param modify_size the modify size
* @param callback the write data callback object
* @return 0 for success, != 0 for error (error no)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int modifyFile1(String appender_file_id, long file_offset, long modify_size, UploadCallback callback)
throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(appender_file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.modifyFile(parts[0], parts[1], file_offset, modify_size, callback);
}
/**
* delete file from storage server
*
* @param file_id the file id(including group name and filename)
* @return 0 for success, none zero for fail (error code)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int deleteFile1(String file_id) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.deleteFile(parts[0], parts[1]);
}
/**
* truncate appender file to size 0 from storage server
*
* @param appender_file_id the appender file id
* @return 0 for success, none zero for fail (error code)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int truncateFile1(String appender_file_id) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(appender_file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.truncateFile(parts[0], parts[1]);
}
/**
* truncate appender file from storage server
*
* @param appender_file_id the appender file id
* @param truncated_file_size truncated file size
* @return 0 for success, none zero for fail (error code)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int truncateFile1(String appender_file_id, long truncated_file_size) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(appender_file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.truncateFile(parts[0], parts[1], truncated_file_size);
}
/**
* download file from storage server
*
* @param file_id the file id(including group name and filename)
* @return file content/buffer, return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public byte[] downloadFile1(String file_id) throws IOException, FastdfsException {
final long file_offset = 0;
final long download_bytes = 0;
return this.downloadFile1(file_id, file_offset, download_bytes);
}
/**
* download file from storage server
*
* @param file_id the file id(including group name and filename)
* @param file_offset the start offset of the file
* @param download_bytes download bytes, 0 for remain bytes from offset
* @return file content/buff, return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public byte[] downloadFile1(String file_id, long file_offset, long download_bytes)
throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(file_id, parts);
if (this.errno != 0) {
return null;
}
return this.downloadFile(parts[0], parts[1], file_offset, download_bytes);
}
/**
* download file from storage server
*
* @param file_id the file id(including group name and filename)
* @param local_filename the filename on local
* @return 0 success, return none zero errno if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int downloadFile1(String file_id, String local_filename) throws IOException, FastdfsException {
final long file_offset = 0;
final long download_bytes = 0;
return this.downloadFile1(file_id, file_offset, download_bytes, local_filename);
}
/**
* download file from storage server
*
* @param file_id the file id(including group name and filename)
* @param file_offset the start offset of the file
* @param download_bytes download bytes, 0 for remain bytes from offset
* @param local_filename the filename on local
* @return 0 success, return none zero errno if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int downloadFile1(String file_id, long file_offset, long download_bytes, String local_filename)
throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.downloadFile(parts[0], parts[1], file_offset, download_bytes, local_filename);
}
/**
* download file from storage server
*
* @param file_id the file id(including group name and filename)
* @param callback the callback object, will call callback.recv() when data arrive
* @return 0 success, return none zero errno if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int downloadFile1(String file_id, DownloadCallback callback) throws IOException, FastdfsException {
final long file_offset = 0;
final long download_bytes = 0;
return this.downloadFile1(file_id, file_offset, download_bytes, callback);
}
/**
* download file from storage server
*
* @param file_id the file id(including group name and filename)
* @param file_offset the start offset of the file
* @param download_bytes download bytes, 0 for remain bytes from offset
* @param callback the callback object, will call callback.recv() when data arrive
* @return 0 success, return none zero errno if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int downloadFile1(String file_id, long file_offset, long download_bytes, DownloadCallback callback)
throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.downloadFile(parts[0], parts[1], file_offset, download_bytes, callback);
}
/**
* get all metadata items from storage server
*
* @param file_id the file id(including group name and filename)
* @return meta info array, return null if fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public NameValuePair[] getMetadata1(String file_id) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(file_id, parts);
if (this.errno != 0) {
return null;
}
return this.getMetadata(parts[0], parts[1]);
}
/**
* set metadata items to storage server
*
* @param file_id the file id(including group name and filename)
* @param meta_list meta item array
* @param op_flag flag, can be one of following values:
*
- ProtoCommon.STORAGE_SET_METADATA_FLAG_OVERWRITE: overwrite all old
* metadata items
* - ProtoCommon.STORAGE_SET_METADATA_FLAG_MERGE: merge, insert when
* the metadata item not exist, otherwise update it
* @return 0 for success, !=0 fail (error code)
* @throws IOException ioex
* @throws FastdfsException myex
*/
public int setMetadata1(String file_id, NameValuePair[] meta_list, byte op_flag) throws IOException,
FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(file_id, parts);
if (this.errno != 0) {
return this.errno;
}
return this.setMetadata(parts[0], parts[1], meta_list, op_flag);
}
/**
* get file info from storage server
*
* @param file_id the file id(including group name and filename)
* @return FileInfo object for success, return null for fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public FileInfo queryFileInfo1(String file_id) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(file_id, parts);
if (this.errno != 0) {
return null;
}
return this.queryFileInfo(parts[0], parts[1]);
}
/**
* get file info decoded from filename
*
* @param file_id the file id(including group name and filename)
* @return FileInfo object for success, return null for fail
* @throws IOException ioex
* @throws FastdfsException myex
*/
public FileInfo getFileInfo1(String file_id) throws IOException, FastdfsException {
String[] parts = new String[2];
this.errno = this.splitFileId(file_id, parts);
if (this.errno != 0) {
return null;
}
return this.getFileInfo(parts[0], parts[1]);
}
}