org.apache.bookkeeper.util.StringUtils Maven / Gradle / Ivy
package org.apache.bookkeeper.util;
/*
* 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.
*/
import java.io.IOException;
import org.apache.bookkeeper.proto.BookkeeperProtocol;
/**
* Provided utilites for parsing network addresses, ledger-id from node paths
* etc.
*
*/
public class StringUtils {
// Ledger Node Prefix
public static final String LEDGER_NODE_PREFIX = "L";
// Ledger znode in flatledgermanager layout will be "L" (prefix) +"%010d" (id in 10 digits)
public static final String FLAT_LEDGER_NODE_REGEX = StringUtils.LEDGER_NODE_PREFIX + "\\d{10}";
// top level znode in legacyhierarchicalledgermanger will be just 2 digits
public static final String LEGACYHIERARCHICAL_LEDGER_PARENT_NODE_REGEX = "\\d{2}";
// top level znode in longhierarchicalledgermanger will be just 3 digits
public static final String LONGHIERARCHICAL_LEDGER_PARENT_NODE_REGEX = "\\d{3}";
// top level znode in hierarchicalledgermanger will be just 2 digits
public static final String HIERARCHICAL_LEDGER_PARENT_NODE_REGEX = "\\d{2,3}";
/**
* Formats ledger ID according to ZooKeeper rules.
*
* @param id
* znode id
*/
public static String getZKStringId(long id) {
return String.format("%010d", id);
}
/**
* Formats ledger ID according to ZooKeeper rules.
*
* @param id
* znode id
*/
public static String getZKStringIdForLongHierarchical(long id) {
return String.format("%019d", id);
}
/**
* Get the hierarchical ledger path according to the ledger id.
*
* @param ledgerId
* ledger id
* @return the hierarchical path
*/
public static String getShortHierarchicalLedgerPath(long ledgerId) {
String ledgerIdStr = getZKStringId(ledgerId);
// do 2-4-4 split
StringBuilder sb = new StringBuilder();
sb.append("/")
.append(ledgerIdStr, 0, 2).append("/")
.append(ledgerIdStr, 2, 6).append("/")
.append(LEDGER_NODE_PREFIX)
.append(ledgerIdStr, 6, 10);
return sb.toString();
}
/**
* Get the long hierarchical ledger path according to the ledger id.
*
* @param ledgerId
* ledger id
* @return the long hierarchical path
*/
public static String getLongHierarchicalLedgerPath(long ledgerId) {
String ledgerIdStr = getZKStringIdForLongHierarchical(ledgerId);
// do 3-4-4-4-4 split
StringBuilder sb = new StringBuilder();
sb.append("/")
.append(ledgerIdStr, 0, 3).append("/")
.append(ledgerIdStr, 3, 7).append("/")
.append(ledgerIdStr, 7, 11).append("/")
.append(ledgerIdStr, 11, 15).append("/")
.append(LEDGER_NODE_PREFIX)
.append(ledgerIdStr, 15, 19);
return sb.toString();
}
public static String getHybridHierarchicalLedgerPath(long ledgerId) {
if (ledgerId < Integer.MAX_VALUE) {
return getShortHierarchicalLedgerPath(ledgerId);
}
return getLongHierarchicalLedgerPath(ledgerId);
}
/**
* Parse the hierarchical ledger path to its ledger id.
*
* @param hierarchicalLedgerPath
* @return the ledger id
* @throws IOException
*/
public static long stringToHierarchicalLedgerId(String hierarchicalLedgerPath)
throws IOException {
String[] hierarchicalParts = hierarchicalLedgerPath.split("/");
if (hierarchicalParts.length != 3) {
throw new IOException("it is not a valid hierarchical path name : " + hierarchicalLedgerPath);
}
hierarchicalParts[2] =
hierarchicalParts[2].substring(LEDGER_NODE_PREFIX.length());
return stringToHierarchicalLedgerId(hierarchicalParts);
}
/**
* Parse the long hierarchical ledger path to its ledger id.
*
* @param longHierarchicalLedgerPaths
* @return the ledger id
* @throws IOException
*/
public static long stringToLongHierarchicalLedgerId(String longHierarchicalLedgerPath)
throws IOException {
String[] longHierarchicalParts = longHierarchicalLedgerPath.split("/");
if (longHierarchicalParts.length != 5) {
return stringToHierarchicalLedgerId(longHierarchicalLedgerPath);
}
longHierarchicalParts[4] =
longHierarchicalParts[4].substring(LEDGER_NODE_PREFIX.length());
return stringToHierarchicalLedgerId(longHierarchicalParts);
}
/**
* Get ledger id.
*
* @param levelNodes
* level of the ledger path
* @return ledger id
* @throws IOException
*/
public static long stringToHierarchicalLedgerId(String...levelNodes) throws IOException {
try {
StringBuilder sb = new StringBuilder();
for (String node : levelNodes) {
sb.append(node);
}
return Long.parseLong(sb.toString());
} catch (NumberFormatException e) {
throw new IOException(e);
}
}
/**
* Builds string representation of teh request without extra (i.e. binary) data
*
* @param request
* @return string representation of request
*/
public static String requestToString(Object request) {
if (request instanceof BookkeeperProtocol.Request) {
BookkeeperProtocol.BKPacketHeader header = ((BookkeeperProtocol.Request) request).getHeader();
return String.format("Req(txnId=%d,op=%s,version=%s)",
header.getTxnId(), header.getOperation(),
header.getVersion());
} else {
return request.toString();
}
}
}