| /* |
| * 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.db.metadata; |
| |
| import org.apache.iotdb.db.conf.IoTDBConstant; |
| import org.apache.iotdb.db.exception.metadata.IllegalPathException; |
| import org.apache.iotdb.db.utils.TestOnly; |
| import org.apache.iotdb.tsfile.common.constant.TsFileConstant; |
| import org.apache.iotdb.tsfile.read.common.Path; |
| |
| import org.slf4j.Logger; |
| import org.slf4j.LoggerFactory; |
| |
| import java.util.ArrayList; |
| import java.util.Arrays; |
| import java.util.Collections; |
| import java.util.List; |
| |
| /** |
| * A prefix path, suffix path or fullPath generated from SQL. Usually used in the IoTDB server |
| * module |
| */ |
| public class PartialPath extends Path implements Comparable<Path> { |
| |
| private static final Logger logger = LoggerFactory.getLogger(PartialPath.class); |
| |
| protected String[] nodes; |
| // alias of measurement, null pointer cannot be serialized in thrift so empty string is instead |
| protected String measurementAlias = ""; |
| // alias of time series used in SELECT AS |
| protected String tsAlias = ""; |
| |
| /** |
| * Construct the PartialPath using a String, will split the given String into String[] E.g., path |
| * = "root.sg.\"d.1\".\"s.1\"" nodes = {"root", "sg", "\"d.1\"", "\"s.1\""} |
| * |
| * @param path a full String of a time series path |
| * @throws IllegalPathException |
| */ |
| public PartialPath(String path) throws IllegalPathException { |
| this.nodes = MetaUtils.splitPathToDetachedPath(path); |
| this.fullPath = path; |
| } |
| |
| public PartialPath(String device, String measurement) throws IllegalPathException { |
| this.fullPath = device + TsFileConstant.PATH_SEPARATOR + measurement; |
| this.nodes = MetaUtils.splitPathToDetachedPath(fullPath); |
| } |
| |
| /** @param partialNodes nodes of a time series path */ |
| public PartialPath(String[] partialNodes) { |
| nodes = partialNodes; |
| } |
| |
| /** |
| * @param path path |
| * @param needSplit needSplit is basically false, whether need to be split to device and |
| * measurement, doesn't support escape character yet. |
| */ |
| public PartialPath(String path, boolean needSplit) { |
| super(path, needSplit); |
| } |
| |
| /** |
| * it will return a new partial path |
| * |
| * @param partialPath the path you want to concat |
| * @return new partial path |
| */ |
| public PartialPath concatPath(PartialPath partialPath) { |
| int len = nodes.length; |
| String[] newNodes = Arrays.copyOf(nodes, nodes.length + partialPath.nodes.length); |
| System.arraycopy(partialPath.nodes, 0, newNodes, len, partialPath.nodes.length); |
| return new PartialPath(newNodes); |
| } |
| |
| /** |
| * It will change nodes in this partial path |
| * |
| * @param otherNodes nodes |
| */ |
| void concatPath(String[] otherNodes) { |
| int len = nodes.length; |
| this.nodes = Arrays.copyOf(nodes, nodes.length + otherNodes.length); |
| System.arraycopy(otherNodes, 0, nodes, len, otherNodes.length); |
| fullPath = String.join(TsFileConstant.PATH_SEPARATOR, nodes); |
| } |
| |
| public PartialPath concatNode(String node) { |
| String[] newPathNodes = Arrays.copyOf(nodes, nodes.length + 1); |
| newPathNodes[newPathNodes.length - 1] = node; |
| return new PartialPath(newPathNodes); |
| } |
| |
| public String[] getNodes() { |
| return nodes; |
| } |
| |
| public int getNodeLength() { |
| return nodes.length; |
| } |
| |
| public String getTailNode() { |
| if (nodes.length <= 0) { |
| return ""; |
| } |
| return nodes[nodes.length - 1]; |
| } |
| |
| /** |
| * Construct a new PartialPath by resetting the prefix nodes to prefixPath |
| * |
| * @param prefixPath the prefix path used to replace current nodes |
| * @return A new PartialPath with altered prefix |
| */ |
| public PartialPath alterPrefixPath(PartialPath prefixPath) { |
| String[] newNodes = Arrays.copyOf(nodes, Math.max(nodes.length, prefixPath.getNodeLength())); |
| System.arraycopy(prefixPath.getNodes(), 0, newNodes, 0, prefixPath.getNodeLength()); |
| return new PartialPath(newNodes); |
| } |
| |
| /** |
| * Test if this PartialPath matches a full path. rPath is supposed to be a full timeseries path |
| * without wildcards. e.g. "root.sg.device.*" matches path "root.sg.device.s1" whereas it does not |
| * match "root.sg.device" and "root.sg.vehicle.s1" |
| * |
| * @param rPath a plain full path of a timeseries |
| * @return true if a successful match, otherwise return false |
| */ |
| public boolean matchFullPath(PartialPath rPath) { |
| String[] rNodes = rPath.getNodes(); |
| if (rNodes.length < nodes.length) { |
| return false; |
| } |
| for (int i = 0; i < nodes.length; i++) { |
| if (!nodes[i].equals(IoTDBConstant.PATH_WILDCARD) && !nodes[i].equals(rNodes[i])) { |
| return false; |
| } |
| } |
| return true; |
| } |
| |
| @Override |
| public String getFullPath() { |
| if (fullPath != null) { |
| return fullPath; |
| } else { |
| StringBuilder s = new StringBuilder(nodes[0]); |
| for (int i = 1; i < nodes.length; i++) { |
| s.append(TsFileConstant.PATH_SEPARATOR).append(nodes[i]); |
| } |
| fullPath = s.toString(); |
| return fullPath; |
| } |
| } |
| |
| @Override |
| public boolean equals(Object obj) { |
| if (!(obj instanceof PartialPath)) { |
| return false; |
| } |
| String[] otherNodes = ((PartialPath) obj).getNodes(); |
| if (this.nodes.length != otherNodes.length) { |
| return false; |
| } else { |
| for (int i = 0; i < this.nodes.length; i++) { |
| if (!nodes[i].equals(otherNodes[i])) { |
| return false; |
| } |
| } |
| } |
| return true; |
| } |
| |
| @Override |
| public boolean equals(String obj) { |
| return this.getFullPath().equals(obj); |
| } |
| |
| @Override |
| public int hashCode() { |
| return this.getFullPath().hashCode(); |
| } |
| |
| @Override |
| public String getMeasurement() { |
| return nodes[nodes.length - 1]; |
| } |
| |
| public String getFirstNode() { |
| return nodes[0]; |
| } |
| |
| @Override |
| public String getDevice() { |
| if (device != null) { |
| return device; |
| } else { |
| if (nodes.length == 1) { |
| return ""; |
| } |
| StringBuilder s = new StringBuilder(nodes[0]); |
| for (int i = 1; i < nodes.length - 1; i++) { |
| s.append(TsFileConstant.PATH_SEPARATOR); |
| s.append(nodes[i]); |
| } |
| device = s.toString(); |
| return device; |
| } |
| } |
| |
| public String getMeasurementAlias() { |
| return measurementAlias; |
| } |
| |
| public void setMeasurementAlias(String measurementAlias) { |
| this.measurementAlias = measurementAlias; |
| } |
| |
| public boolean isMeasurementAliasExists() { |
| return measurementAlias != null && !measurementAlias.isEmpty(); |
| } |
| |
| public String getTsAlias() { |
| return tsAlias; |
| } |
| |
| public void setTsAlias(String tsAlias) { |
| this.tsAlias = tsAlias; |
| } |
| |
| public boolean isTsAliasExists() { |
| return tsAlias != null && !tsAlias.isEmpty(); |
| } |
| |
| @Override |
| public String getFullPathWithAlias() { |
| return getDevice() + IoTDBConstant.PATH_SEPARATOR + measurementAlias; |
| } |
| |
| @Override |
| public int compareTo(Path path) { |
| PartialPath partialPath = (PartialPath) path; |
| return this.getFullPath().compareTo(partialPath.getFullPath()); |
| } |
| |
| public boolean startsWith(String[] otherNodes) { |
| for (int i = 0; i < otherNodes.length; i++) { |
| if (!nodes[i].equals(otherNodes[i])) { |
| return false; |
| } |
| } |
| return true; |
| } |
| |
| @Override |
| public String toString() { |
| return getFullPath(); |
| } |
| |
| public PartialPath getDevicePath() { |
| return new PartialPath(Arrays.copyOf(nodes, nodes.length - 1)); |
| } |
| |
| @TestOnly |
| public Path toTSFilePath() { |
| return new Path(getDevice(), getMeasurement()); |
| } |
| |
| public static List<String> toStringList(List<PartialPath> pathList) { |
| List<String> ret = new ArrayList<>(); |
| for (PartialPath path : pathList) { |
| ret.add(path.getFullPath()); |
| } |
| return ret; |
| } |
| |
| /** |
| * Convert a list of Strings to a list of PartialPaths, ignoring all illegal paths |
| * |
| * @param pathList |
| * @return |
| */ |
| public static List<PartialPath> fromStringList(List<String> pathList) { |
| if (pathList == null || pathList.isEmpty()) { |
| return Collections.emptyList(); |
| } |
| |
| List<PartialPath> ret = new ArrayList<>(); |
| for (String s : pathList) { |
| try { |
| ret.add(new PartialPath(s)); |
| } catch (IllegalPathException e) { |
| logger.warn("Encountered an illegal path {}", s); |
| } |
| } |
| return ret; |
| } |
| } |