org.apache.iotdb.rpc.RpcUtils Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of service-rpc Show documentation
Show all versions of service-rpc Show documentation
RPC framework for client and server.
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.iotdb.rpc;
import org.apache.iotdb.common.rpc.thrift.TEndPoint;
import org.apache.iotdb.common.rpc.thrift.TSStatus;
import org.apache.iotdb.protocol.influxdb.rpc.thrift.InfluxDBService;
import org.apache.iotdb.protocol.influxdb.rpc.thrift.InfluxTSStatus;
import org.apache.iotdb.service.rpc.thrift.IClientRPCService;
import org.apache.iotdb.service.rpc.thrift.TSExecuteStatementResp;
import org.apache.iotdb.service.rpc.thrift.TSFetchResultsResp;
import java.lang.reflect.Proxy;
import java.text.SimpleDateFormat;
import java.time.Instant;
import java.time.ZoneId;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;
public class RpcUtils {
/** How big should the default read and write buffers be? Defaults to 1KB */
public static final int THRIFT_DEFAULT_BUF_CAPACITY = 1024;
/**
* It is used to prevent the size of the parsing package from being too large and allocating the
* buffer will cause oom. Therefore, the maximum length of the requested memory is limited when
* reading. Thrift max frame size (16384000 bytes by default), we change it to 512MB.
*/
public static final int THRIFT_FRAME_MAX_SIZE = 536870912;
/**
* if resizeIfNecessary is called continuously with a small size for more than
* MAX_BUFFER_OVERSIZE_TIME times, we will shrink the buffer to reclaim space.
*/
public static final int MAX_BUFFER_OVERSIZE_TIME = 5;
public static final long MIN_SHRINK_INTERVAL = 60_000L;
private RpcUtils() {
// util class
}
public static final TSStatus SUCCESS_STATUS =
new TSStatus(TSStatusCode.SUCCESS_STATUS.getStatusCode());
public static IClientRPCService.Iface newSynchronizedClient(IClientRPCService.Iface client) {
return (IClientRPCService.Iface)
Proxy.newProxyInstance(
RpcUtils.class.getClassLoader(),
new Class[] {IClientRPCService.Iface.class},
new SynchronizedHandler(client));
}
public static InfluxDBService.Iface newSynchronizedClient(InfluxDBService.Iface client) {
return (InfluxDBService.Iface)
Proxy.newProxyInstance(
RpcUtils.class.getClassLoader(),
new Class[] {InfluxDBService.Iface.class},
new InfluxDBSynchronizedHandler(client));
}
/**
* verify success.
*
* @param status -status
*/
public static void verifySuccess(TSStatus status) throws StatementExecutionException {
if (status.getCode() == TSStatusCode.MULTIPLE_ERROR.getStatusCode()) {
verifySuccess(status.getSubStatus());
return;
}
if (status.getCode() == TSStatusCode.REDIRECTION_RECOMMEND.getStatusCode()) {
return;
}
if (status.code != TSStatusCode.SUCCESS_STATUS.getStatusCode()) {
throw new StatementExecutionException(status);
}
}
/**
* verify success.
*
* @param status -status
*/
public static void verifySuccess(InfluxTSStatus status) throws StatementExecutionException {
if (status.getCode() == TSStatusCode.REDIRECTION_RECOMMEND.getStatusCode()) {
return;
}
if (status.code != TSStatusCode.SUCCESS_STATUS.getStatusCode()) {
throw new StatementExecutionException(status);
}
}
public static void verifySuccessWithRedirection(TSStatus status)
throws StatementExecutionException, RedirectException {
verifySuccess(status);
if (status.isSetRedirectNode()) {
throw new RedirectException(status.getRedirectNode());
}
}
public static void verifySuccessWithRedirectionForMultiDevices(
TSStatus status, List devices) throws StatementExecutionException, RedirectException {
verifySuccess(status);
if (status.getCode() == TSStatusCode.MULTIPLE_ERROR.getStatusCode()
|| status.getCode() == TSStatusCode.REDIRECTION_RECOMMEND.getStatusCode()) {
Map deviceEndPointMap = new HashMap<>();
List statusSubStatus = status.getSubStatus();
for (int i = 0; i < statusSubStatus.size(); i++) {
TSStatus subStatus = statusSubStatus.get(i);
if (subStatus.isSetRedirectNode()) {
deviceEndPointMap.put(devices.get(i), subStatus.getRedirectNode());
}
}
throw new RedirectException(deviceEndPointMap);
}
}
public static void verifySuccess(List statuses) throws BatchExecutionException {
StringBuilder errMsgs =
new StringBuilder().append(TSStatusCode.MULTIPLE_ERROR.getStatusCode()).append(": ");
for (TSStatus status : statuses) {
if (status.getCode() != TSStatusCode.SUCCESS_STATUS.getStatusCode()
&& status.getCode() != TSStatusCode.REDIRECTION_RECOMMEND.getStatusCode()) {
errMsgs.append(status.getMessage()).append("; ");
}
}
if (errMsgs.length() > 0) {
throw new BatchExecutionException(statuses, errMsgs.toString());
}
}
/** convert from TSStatusCode to TSStatus according to status code and status message */
public static TSStatus getStatus(TSStatusCode tsStatusCode) {
return new TSStatus(tsStatusCode.getStatusCode());
}
public static TSStatus getStatus(List statusList) {
TSStatus status = new TSStatus(TSStatusCode.MULTIPLE_ERROR.getStatusCode());
status.setSubStatus(statusList);
return status;
}
/**
* convert from TSStatusCode to TSStatus, which has message appending with existed status message
*
* @param tsStatusCode status type
* @param message appending message
*/
public static TSStatus getStatus(TSStatusCode tsStatusCode, String message) {
TSStatus status = new TSStatus(tsStatusCode.getStatusCode());
status.setMessage(message);
return status;
}
public static TSStatus getStatus(int code, String message) {
TSStatus status = new TSStatus(code);
status.setMessage(message);
return status;
}
public static InfluxTSStatus getInfluxDBStatus(TSStatusCode tsStatusCode) {
return new InfluxTSStatus(tsStatusCode.getStatusCode());
}
public static InfluxTSStatus getInfluxDBStatus(int code, String message) {
InfluxTSStatus status = new InfluxTSStatus(code);
status.setMessage(message);
return status;
}
public static TSExecuteStatementResp getTSExecuteStatementResp(TSStatusCode tsStatusCode) {
TSStatus status = getStatus(tsStatusCode);
return getTSExecuteStatementResp(status);
}
public static TSExecuteStatementResp getTSExecuteStatementResp(
TSStatusCode tsStatusCode, String message) {
TSStatus status = getStatus(tsStatusCode, message);
return getTSExecuteStatementResp(status);
}
public static TSExecuteStatementResp getTSExecuteStatementResp(TSStatus status) {
TSExecuteStatementResp resp = new TSExecuteStatementResp();
TSStatus tsStatus = new TSStatus(status);
resp.setStatus(tsStatus);
return resp;
}
public static TSFetchResultsResp getTSFetchResultsResp(TSStatusCode tsStatusCode) {
TSStatus status = getStatus(tsStatusCode);
return getTSFetchResultsResp(status);
}
public static TSFetchResultsResp getTSFetchResultsResp(
TSStatusCode tsStatusCode, String appendMessage) {
TSStatus status = getStatus(tsStatusCode, appendMessage);
return getTSFetchResultsResp(status);
}
public static TSFetchResultsResp getTSFetchResultsResp(TSStatus status) {
TSFetchResultsResp resp = new TSFetchResultsResp();
TSStatus tsStatus = new TSStatus(status);
resp.setStatus(tsStatus);
return resp;
}
public static final String DEFAULT_TIME_FORMAT = "default";
public static final String DEFAULT_TIMESTAMP_PRECISION = "ms";
public static String setTimeFormat(String newTimeFormat) {
String timeFormat;
switch (newTimeFormat.trim().toLowerCase()) {
case "long":
case "number":
case DEFAULT_TIME_FORMAT:
case "iso8601":
timeFormat = newTimeFormat.trim().toLowerCase();
break;
default:
// use java default SimpleDateFormat to check whether input time format is legal
// if illegal, it will throw an exception
new SimpleDateFormat(newTimeFormat.trim());
timeFormat = newTimeFormat;
break;
}
return timeFormat;
}
public static String formatDatetime(
String timeFormat, String timePrecision, long timestamp, ZoneId zoneId) {
ZonedDateTime dateTime;
switch (timeFormat) {
case "long":
case "number":
return Long.toString(timestamp);
case DEFAULT_TIME_FORMAT:
case "iso8601":
return parseLongToDateWithPrecision(
DateTimeFormatter.ISO_OFFSET_DATE_TIME, timestamp, zoneId, timePrecision);
default:
dateTime = ZonedDateTime.ofInstant(Instant.ofEpochMilli(timestamp), zoneId);
return dateTime.format(DateTimeFormatter.ofPattern(timeFormat));
}
}
public static String formatDatetimeStr(String datetime, StringBuilder digits) {
if (datetime.contains("+")) {
String timeZoneStr = datetime.substring(datetime.length() - 6);
return datetime.substring(0, datetime.length() - 6) + "." + digits + timeZoneStr;
} else if (datetime.contains("Z")) {
String timeZoneStr = datetime.substring(datetime.length() - 1);
return datetime.substring(0, datetime.length() - 1) + "." + digits + timeZoneStr;
} else {
String timeZoneStr = "";
return datetime + "." + digits + timeZoneStr;
}
}
@SuppressWarnings("squid:S3776") // Suppress high Cognitive Complexity warning
public static String parseLongToDateWithPrecision(
DateTimeFormatter formatter, long timestamp, ZoneId zoneid, String timestampPrecision) {
if ("ms".equals(timestampPrecision)) {
long integerOfDate = timestamp / 1000;
StringBuilder digits = new StringBuilder(Long.toString(timestamp % 1000));
ZonedDateTime dateTime =
ZonedDateTime.ofInstant(Instant.ofEpochSecond(integerOfDate), zoneid);
String datetime = dateTime.format(formatter);
int length = digits.length();
if (length != 3) {
for (int i = 0; i < 3 - length; i++) {
digits.insert(0, "0");
}
}
return formatDatetimeStr(datetime, digits);
} else if ("us".equals(timestampPrecision)) {
long integerOfDate = timestamp / 1000_000;
StringBuilder digits = new StringBuilder(Long.toString(timestamp % 1000_000));
ZonedDateTime dateTime =
ZonedDateTime.ofInstant(Instant.ofEpochSecond(integerOfDate), zoneid);
String datetime = dateTime.format(formatter);
int length = digits.length();
if (length != 6) {
for (int i = 0; i < 6 - length; i++) {
digits.insert(0, "0");
}
}
return formatDatetimeStr(datetime, digits);
} else {
long integerOfDate = timestamp / 1000_000_000L;
StringBuilder digits = new StringBuilder(Long.toString(timestamp % 1000_000_000L));
ZonedDateTime dateTime =
ZonedDateTime.ofInstant(Instant.ofEpochSecond(integerOfDate), zoneid);
String datetime = dateTime.format(formatter);
int length = digits.length();
if (length != 9) {
for (int i = 0; i < 9 - length; i++) {
digits.insert(0, "0");
}
}
return formatDatetimeStr(datetime, digits);
}
}
public static TSStatus squashResponseStatusList(List responseStatusList) {
final List failedStatus =
responseStatusList.stream()
.filter(status -> status.getCode() != TSStatusCode.SUCCESS_STATUS.getStatusCode())
.collect(Collectors.toList());
return failedStatus.isEmpty()
? new TSStatus(TSStatusCode.SUCCESS_STATUS.getStatusCode())
: new TSStatus(TSStatusCode.EXECUTE_STATEMENT_ERROR.getStatusCode())
.setMessage(failedStatus.toString());
}
}