142 lines
4.5 KiB
Markdown
142 lines
4.5 KiB
Markdown
|
||
# FastDFS java client SDK
|
||
|
||
FastDFS Java Client API may be copied only under the terms of the BSD license.
|
||
|
||
## 使用ant从源码构建
|
||
|
||
```
|
||
ant clean package
|
||
```
|
||
|
||
## 使用maven从源码安装
|
||
|
||
```
|
||
mvn clean install
|
||
```
|
||
|
||
## 使用maven从jar文件安装
|
||
```
|
||
mvn install:install-file -DgroupId=org.csource -DartifactId=fastdfs-client-java -Dversion=${version} -Dpackaging=jar -Dfile=fastdfs-client-java-${version}.jar
|
||
```
|
||
|
||
## 在您的maven项目pom.xml中添加依赖
|
||
|
||
```xml
|
||
<dependency>
|
||
<groupId>org.csource</groupId>
|
||
<artifactId>fastdfs-client-java</artifactId>
|
||
<version>1.29-SNAPSHOT</version>
|
||
</dependency>
|
||
```
|
||
|
||
## .conf 配置文件、所在目录、加载优先顺序
|
||
|
||
配置文件名fdfs_client.conf(或使用其它文件名xxx_yyy.conf)
|
||
|
||
文件所在位置可以是项目classpath(或OS文件系统目录比如/opt/):
|
||
/opt/fdfs_client.conf
|
||
C:\Users\James\config\fdfs_client.conf
|
||
|
||
优先按OS文件系统路径读取，没有找到才查找项目classpath，尤其针对linux环境下的相对路径比如：
|
||
fdfs_client.conf
|
||
config/fdfs_client.conf
|
||
|
||
```
|
||
connect_timeout = 2
|
||
network_timeout = 30
|
||
charset = UTF-8
|
||
http.tracker_http_port = 80
|
||
http.anti_steal_token = no
|
||
http.secret_key = FastDFS1234567890
|
||
|
||
tracker_server = 10.0.11.247:22122
|
||
tracker_server = 10.0.11.248:22122
|
||
tracker_server = 10.0.11.249:22122
|
||
|
||
connection_pool.enabled = true
|
||
connection_pool.max_count_per_entry = 500
|
||
connection_pool.max_idle_time = 3600
|
||
connection_pool.max_wait_time_in_ms = 1000
|
||
```
|
||
|
||
注1：tracker_server指向您自己IP地址和端口，1-n个
|
||
注2：除了tracker_server，其它配置项都是可选的
|
||
|
||
|
||
## .properties 配置文件、所在目录、加载优先顺序
|
||
|
||
配置文件名 fastdfs-client.properties(或使用其它文件名 xxx-yyy.properties)
|
||
|
||
文件所在位置可以是项目classpath(或OS文件系统目录比如/opt/):
|
||
/opt/fastdfs-client.properties
|
||
C:\Users\James\config\fastdfs-client.properties
|
||
|
||
优先按OS文件系统路径读取，没有找到才查找项目classpath，尤其针对linux环境下的相对路径比如：
|
||
fastdfs-client.properties
|
||
config/fastdfs-client.properties
|
||
|
||
```
|
||
fastdfs.connect_timeout_in_seconds = 5
|
||
fastdfs.network_timeout_in_seconds = 30
|
||
fastdfs.charset = UTF-8
|
||
fastdfs.http_anti_steal_token = false
|
||
fastdfs.http_secret_key = FastDFS1234567890
|
||
fastdfs.http_tracker_http_port = 80
|
||
|
||
fastdfs.tracker_servers = 10.0.11.201:22122,10.0.11.202:22122,10.0.11.203:22122
|
||
|
||
fastdfs.connection_pool.enabled = true
|
||
fastdfs.connection_pool.max_count_per_entry = 500
|
||
fastdfs.connection_pool.max_idle_time = 3600
|
||
fastdfs.connection_pool.max_wait_time_in_ms = 1000
|
||
```
|
||
|
||
注1：properties 配置文件中属性名跟 conf 配置文件不尽相同，并且统一加前缀"fastdfs."，便于整合到用户项目配置文件
|
||
注2：fastdfs.tracker_servers 配置项不能重复属性名，多个 tracker_server 用逗号","隔开
|
||
注3：除了fastdfs.tracker_servers，其它配置项都是可选的
|
||
|
||
|
||
## 加载配置示例
|
||
|
||
加载原 conf 格式文件配置：
|
||
ClientGlobal.init("fdfs_client.conf");
|
||
ClientGlobal.init("config/fdfs_client.conf");
|
||
ClientGlobal.init("/opt/fdfs_client.conf");
|
||
ClientGlobal.init("C:\\Users\\James\\config\\fdfs_client.conf");
|
||
|
||
加载 properties 格式文件配置：
|
||
ClientGlobal.initByProperties("fastdfs-client.properties");
|
||
ClientGlobal.initByProperties("config/fastdfs-client.properties");
|
||
ClientGlobal.initByProperties("/opt/fastdfs-client.properties");
|
||
ClientGlobal.initByProperties("C:\\Users\\James\\config\\fastdfs-client.properties");
|
||
|
||
加载 Properties 对象配置：
|
||
Properties props = new Properties();
|
||
props.put(ClientGlobal.PROP_KEY_TRACKER_SERVERS, "10.0.11.101:22122,10.0.11.102:22122");
|
||
ClientGlobal.initByProperties(props);
|
||
|
||
加载 trackerServers 字符串配置：
|
||
String trackerServers = "10.0.11.101:22122,10.0.11.102:22122";
|
||
ClientGlobal.initByTrackers(trackerServers);
|
||
|
||
|
||
## 检查加载配置结果：
|
||
|
||
System.out.println("ClientGlobal.configInfo(): " + ClientGlobal.configInfo());
|
||
```
|
||
ClientGlobal.configInfo(): {
|
||
g_connect_timeout(ms) = 5000
|
||
g_network_timeout(ms) = 30000
|
||
g_charset = UTF-8
|
||
g_anti_steal_token = false
|
||
g_secret_key = FastDFS1234567890
|
||
g_tracker_http_port = 80
|
||
g_connection_pool_enabled = true
|
||
g_connection_pool_max_count_per_entry = 500
|
||
g_connection_pool_max_idle_time(ms) = 3600000
|
||
g_connection_pool_max_wait_time_in_ms(ms) = 1000
|
||
trackerServers = 10.0.11.101:22122,10.0.11.102:22122
|
||
}
|
||
```
|