com.qiniu.storage.Region Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of qiniu-java-sdk Show documentation
Show all versions of qiniu-java-sdk Show documentation
Qiniu Cloud Storage SDK for Java
// codebeat:disable[TOO_MANY_FUNCTIONS]
package com.qiniu.storage;
import com.qiniu.common.QiniuException;
import com.qiniu.util.StringUtils;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
public class Region implements Cloneable {
// 有效时间戳，过了有效期，region会无效，此处只在取时缓存判断； -1 为无限期
private long timestamp = -1;
// 区域名称：z0 华东 z1 华北 z2 华南 na0 北美 as0 东南亚
private String region = "z0";
/*
* 源站直传，加速上传，源站下载 使用各个机房对应的域名
*/
private List srcUpHosts;
private List accUpHosts;
private String iovipHost;
private String ioSrcHost;
/*
* 资源管理，资源列表，资源处理类域名
* 默认的这组域名是国内国外共用域名，无论海外国内都可以访问
* 只有在无法自动查询到机房对应具体域名情况下，使用这组域名
*/
private String rsHost = "rs.qbox.me";
private String rsfHost = "rsf.qbox.me";
private String apiHost = "api.qiniuapi.com";
private List ucHosts = Arrays.asList(Configuration.defaultUcHosts);
Region() {
}
Region(long timestamp, String region, List srcUpHosts, List accUpHosts, String iovipHost,
String ioSrcHost, String rsHost, String rsfHost, String apiHost, String ucHost) {
this.timestamp = timestamp;
this.region = region;
this.srcUpHosts = srcUpHosts;
this.accUpHosts = accUpHosts;
this.iovipHost = iovipHost;
this.ioSrcHost = ioSrcHost;
this.rsHost = rsHost;
this.rsfHost = rsfHost;
this.apiHost = apiHost;
if (!StringUtils.isNullOrEmpty(ucHost)) {
List hosts = new ArrayList<>();
hosts.add(ucHost);
this.ucHosts = hosts;
}
}
/**
* 华东机房相关域名
* 废弃，使用 {@link Region#createWithRegionId} 替换，regionId：z0
*
* @return 区域信息
*/
@Deprecated
public static Region region0() {
return new Builder().
region("z0").
srcUpHost("up.qiniup.com").
accUpHost("upload.qiniup.com").
iovipHost("iovip.qbox.me").
rsHost("rs.qbox.me").
rsfHost("rsf.qbox.me").
apiHost("api.qiniuapi.com").
build();
}
/**
* 华东机房相关域名
* 废弃，使用 {@link Region#createWithRegionId} 替换，regionId：z0
*
* @return 区域信息
*/
@Deprecated
public static Region huadong() {
return region0();
}
/**
* 华东浙江 2 机房相关域名
* 废弃，使用 {@link Region#createWithRegionId} 替换，regionId：cn-east-2
*
* @return 区域信息
*/
@Deprecated
public static Region regionCnEast2() {
return new Builder().
region("cn-east-2").
srcUpHost("up-cn-east-2.qiniup.com").
accUpHost("upload-cn-east-2.qiniup.com").
iovipHost("iovip-cn-east-2.qiniuio.com").
rsHost("rs-cn-east-2.qiniuapi.com").
rsfHost("rsf-cn-east-2.qiniuapi.com").
apiHost("api-cn-east-2.qiniuapi.com").
build();
}
/**
* 华东浙江 2 机房相关域名
* 废弃，使用 {@link Region#createWithRegionId} 替换，regionId：cn-east-2
*
* @return 区域信息
*/
@Deprecated
public static Region huadongZheJiang2() {
return regionCnEast2();
}
/**
* 华东机房内网上传相关域名
*
* @return 区域信息
*/
public static Region qvmRegion0() {
return new Builder().
region("z0").
srcUpHost("free-qvm-z0-xs.qiniup.com").
accUpHost("free-qvm-z0-xs.qiniup.com").
iovipHost("iovip.qbox.me").
rsHost("rs.qbox.me").
rsfHost("rsf.qbox.me").
apiHost("api.qiniu.com").
build();
}
/**
* 华东机房内网上传相关域名
*
* @return 区域信息
*/
public static Region qvmHuadong() {
return qvmRegion0();
}
/**
* 华北机房相关域名
* 废弃，使用 {@link Region#createWithRegionId} 替换，regionId：z1
*
* @return 区域信息
*/
@Deprecated
public static Region region1() {
return new Builder().
region("z1").
srcUpHost("up-z1.qiniup.com").
accUpHost("upload-z1.qiniup.com").
iovipHost("iovip-z1.qbox.me").
rsHost("rs-z1.qbox.me").
rsfHost("rsf-z1.qbox.me").
apiHost("api-z1.qiniuapi.com").
build();
}
/**
* 华北机房相关域名
* 废弃，使用 {@link Region#createWithRegionId} 替换，regionId：z1
*
* @return 区域信息
*/
@Deprecated
public static Region huabei() {
return region1();
}
/**
* 华北机房内网上传相关域名
*
* @return 区域信息
*/
public static Region qvmRegion1() {
return new Builder().
region("z1").
srcUpHost("free-qvm-z1-zz.qiniup.com").
accUpHost("free-qvm-z1-zz.qiniup.com").
iovipHost("iovip-z1.qbox.me").
rsHost("rs-z1.qbox.me").
rsfHost("rsf-z1.qbox.me").
apiHost("api-z1.qiniu.com").
build();
}
/**
* 华北机房内网上传相关域名
*
* @return 区域信息
*/
public static Region qvmHuabei() {
return qvmRegion1();
}
/**
* 华南机房相关域名
* 废弃，使用 {@link Region#createWithRegionId} 替换，regionId：z2
*
* @return 区域信息
*/
@Deprecated
public static Region region2() {
return new Builder().
region("z2").
srcUpHost("up-z2.qiniup.com").
accUpHost("upload-z2.qiniup.com").
iovipHost("iovip-z2.qbox.me").
rsHost("rs-z2.qbox.me").
rsfHost("rsf-z2.qbox.me").
apiHost("api-z2.qiniuapi.com").
build();
}
/**
* 华南机房相关域名
* 废弃，使用 {@link Region#createWithRegionId} 替换，regionId：z2
*
* @return 区域信息
*/
@Deprecated
public static Region huanan() {
return region2();
}
/**
* 北美机房相关域名
* 废弃，使用 {@link Region#createWithRegionId} 替换，regionId：na0
*
* @return 区域信息
*/
@Deprecated
public static Region regionNa0() {
return new Builder().
region("na0").
srcUpHost("up-na0.qiniup.com").
accUpHost("upload-na0.qiniup.com").
iovipHost("iovip-na0.qbox.me").
rsHost("rs-na0.qbox.me").
rsfHost("rsf-na0.qbox.me").
apiHost("api-na0.qiniuapi.com").
build();
}
/**
* 北美机房相关域名
* 废弃，使用 {@link Region#createWithRegionId} 替换，regionId：na0
*
* @return 区域信息
*/
@Deprecated
public static Region beimei() {
return regionNa0();
}
/**
* 新加坡相关域名
* 废弃，使用 {@link Region#createWithRegionId} 替换，regionId：as0
*
* @return 区域信息
*/
@Deprecated
public static Region regionAs0() {
return new Builder().
region("as0").
srcUpHost("up-as0.qiniup.com").
accUpHost("upload-as0.qiniup.com").
iovipHost("iovip-as0.qbox.me").
rsHost("rs-as0.qbox.me").
rsfHost("rsf-as0.qbox.me").
apiHost("api-as0.qiniuapi.com").
build();
}
/**
* Region 构造方法
* regionId 参考链接：
*
* @param regionId 根据区域 ID 创建 Region
* @return Region 实例
*/
public static Region createWithRegionId(String regionId) {
if (regionId == null || regionId.isEmpty()) {
return null;
}
if (regionId.equals("z0")) {
return Region.region0();
}
return new Builder()
.region(regionId)
.srcUpHost("up-" + regionId + ".qiniup.com")
.accUpHost("upload-" + regionId + ".qiniup.com")
.iovipHost("iovip-" + regionId + ".qiniuio.com")
.rsHost("rs-" + regionId + ".qiniuapi.com")
.rsfHost("rsf-" + regionId + ".qiniuapi.com")
.apiHost("api-" + regionId + ".qiniuapi.com")
.build();
}
/**
* 新加坡机房相关域名
*
* @return 区域信息
*/
public static Region xinjiapo() {
return regionAs0();
}
/*
* 自动根据AccessKey和Bucket来判断所在机房，并获取相关的域名
* 空间所在的对应机房可以在空间创建的时候选择，或者创建完毕之后，从后台查看
*/
public static Region autoRegion() {
return autoRegion("https://uc.qbox.me");
}
/*
* 自动根据AccessKey和Bucket来判断所在机房，并获取相关的域名
* 空间所在的对应机房可以在空间创建的时候选择，或者创建完毕之后，从后台查看
*/
public static Region autoRegion(String... ucServers) {
return new Builder().autoRegion(ucServers);
}
boolean switchRegion(RegionReqInfo regionReqInfo) {
return false;
}
String getRegion(RegionReqInfo regionReqInfo) {
return this.region;
}
Region getCurrentRegion(RegionReqInfo regionReqInfo) {
return this;
}
List getSrcUpHost(RegionReqInfo regionReqInfo) throws QiniuException {
return this.srcUpHosts;
}
List getAccUpHost(RegionReqInfo regionReqInfo) throws QiniuException {
return this.accUpHosts;
}
String getIovipHost(RegionReqInfo regionReqInfo) throws QiniuException {
return iovipHost;
}
String getIoSrcHost(RegionReqInfo regionReqInfo) throws QiniuException {
return ioSrcHost;
}
String getRsHost(RegionReqInfo regionReqInfo) throws QiniuException {
return rsHost;
}
String getRsfHost(RegionReqInfo regionReqInfo) throws QiniuException {
return rsfHost;
}
String getApiHost(RegionReqInfo regionReqInfo) throws QiniuException {
return apiHost;
}
String getUcHost(RegionReqInfo regionReqInfo) throws QiniuException {
if (ucHosts == null || ucHosts.isEmpty()) {
return "";
}
return ucHosts.get(0);
}
List getUcHosts(RegionReqInfo regionReqInfo) throws QiniuException {
return ucHosts;
}
boolean isValid() {
if (timestamp < 0) {
return true;
} else {
return System.currentTimeMillis() < timestamp * 1000;
}
}
public Object clone() {
Region newRegion = new Region();
newRegion.timestamp = timestamp;
newRegion.region = region;
newRegion.srcUpHosts = srcUpHosts;
newRegion.accUpHosts = accUpHosts;
newRegion.iovipHost = iovipHost;
newRegion.ioSrcHost = ioSrcHost;
newRegion.rsHost = rsHost;
newRegion.rsfHost = rsfHost;
newRegion.apiHost = apiHost;
newRegion.ucHosts = ucHosts;
return newRegion;
}
/**
* 域名构造器
*/
public static class Builder {
protected Region region;
public Builder() {
init();
}
public Builder(Region originRegion) {
init();
region.region = originRegion.region;
region.srcUpHosts = originRegion.srcUpHosts;
region.accUpHosts = originRegion.accUpHosts;
region.iovipHost = originRegion.iovipHost;
region.ioSrcHost = originRegion.ioSrcHost;
region.rsHost = originRegion.rsHost;
region.rsfHost = originRegion.rsfHost;
region.apiHost = originRegion.apiHost;
}
protected void init() {
region = new Region();
}
public Builder region(String region) {
this.region.region = region;
return this;
}
public Builder srcUpHost(String... srcUpHosts) {
this.region.srcUpHosts = Arrays.asList(srcUpHosts);
return this;
}
public Builder accUpHost(String... accUpHosts) {
this.region.accUpHosts = Arrays.asList(accUpHosts);
return this;
}
public Builder iovipHost(String iovipHost) {
this.region.iovipHost = iovipHost;
return this;
}
public Builder ioSrcHost(String ioSrcHost) {
this.region.ioSrcHost = ioSrcHost;
return this;
}
public Builder rsHost(String rsHost) {
this.region.rsHost = rsHost;
return this;
}
public Builder rsfHost(String rsfHost) {
this.region.rsfHost = rsfHost;
return this;
}
public Builder apiHost(String apiHost) {
this.region.apiHost = apiHost;
return this;
}
public Builder ucHost(String... ucHosts) {
if (ucHosts.length > 0) {
this.region.ucHosts = Arrays.asList(ucHosts);
}
return this;
}
/**
* 自动选择,其它参数设置无效
*
* @param ucServers uc host
* @return 区域信息
*/
public Region autoRegion(String... ucServers) {
return new AutoRegion(ucServers);
}
/**
* 自动选择,其它参数设置无效
*
* @param retryMax 单个域名最大重试次数
* @param retryInterval 重试间隔，单位：毫秒
* @param hostFreezeDuration 冻结时间，单位：毫秒；域名请求失败会被冻结，冻结后域名在冻结时间内不会被使用
* @param ucServers uc host
* @return 区域信息
**/
public Region autoRegion(int retryMax, int retryInterval, int hostFreezeDuration, String... ucServers) {
return new AutoRegion(retryMax, retryInterval, hostFreezeDuration, ucServers);
}
/**
* 返回构建好的Region对象
*
* @return 区域信息
*/
public Region build() {
return region;
}
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy