blob: 2a890a5b411ff9d1374773857c6e41a3bf3c47e4 [file] [log] [blame]
/*
* 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.wicket.util;
import org.apache.wicket.util.string.PrependingStringBuffer;
/**
* Encodes long values into the specified alphabet. Encoding is useful when long values need to be
* represented in their string form and shorter values are preferred; by using alphabets of length
* greater than ten shorter values can be obtained. For example, to encode values into their
* hexadecimal representations the {@code 0123456789ABCDEF-} can be used. Long values can be
* shortened even further by using longer alphabets. The last character in the alphabet is used as
* the negative sign.
*
* @author igor
*/
public class LongEncoder
{
/**
* default alphabet that should be safe to use in most circumstances, while still providing good
* shortening of long values
*/
public static final String DEFAULT = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
private LongEncoder()
{
}
/**
* Encodes the value into the default alphabet: {@value #DEFAULT}
*
* @param value
* @return encoded value
*/
public static String encode(final long value)
{
return encode(value, DEFAULT);
}
/**
* Decodes value using the default alphabet: {@value #DEFAULT}
*
* @param value
* @return decoded value
*/
public static long decode(final String value)
{
return decode(value, DEFAULT);
}
/**
* Encodes value into the specified alphabet
*
* @param value
* @param alphabet
* @return encoded value
*/
public static String encode(long value, final String alphabet)
{
final int len = alphabet.length() - 1;
PrependingStringBuffer buff = new PrependingStringBuffer();
final boolean negative = value < 0;
if (negative)
{
value = -value;
}
do
{
int mod = (int)(value % len);
buff.prepend(alphabet.charAt(mod));
value = value / len;
}
while (value > 0);
if (negative)
{
buff.prepend(alphabet.charAt(len));
}
return buff.toString();
}
/**
* Decodes value using the specified alphabet
*
* @param value
* @param alphabet
* @return decoded value
*/
public static long decode(final String value, final String alphabet)
{
final int factor = alphabet.length() - 1;
final boolean negative = alphabet.charAt(factor) == value.charAt(0);
long num = 0;
for (int i = (negative) ? 1 : 0, len = value.length(); i < len; i++)
{
num = num * factor + alphabet.indexOf(value.charAt(i));
}
if (negative)
{
num = -num;
}
return num;
}
}