com.hazelcast.memory.MemorySize Maven / Gradle / Ivy
/*
* Copyright (c) 2008-2016, Hazelcast, Inc. All Rights Reserved.
*
* Licensed 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 com.hazelcast.memory;
import static com.hazelcast.util.Preconditions.checkNotNull;
/**
* MemorySize represents a memory size with given value and MemoryUnit.
*
* @see com.hazelcast.memory.MemoryUnit
* @since 3.4
*/
public final class MemorySize {
private static final int PRETTY_FORMAT_LIMIT = 10;
private final long value;
private final MemoryUnit unit;
public MemorySize(long value) {
this(value, MemoryUnit.BYTES);
}
public MemorySize(long value, MemoryUnit unit) {
if (value < 0) {
throw new IllegalArgumentException("Memory size cannot be negative! -> " + value);
}
this.value = value;
this.unit = checkNotNull(unit, "MemoryUnit is required!");
}
/**
* Returns value of memory size in its original unit.
*
* @return memory size in its original unit
*/
public long getValue() {
return value;
}
/**
* Returns unit of memory size
*
* @return unit of memory size
*/
public MemoryUnit getUnit() {
return unit;
}
/**
* Returns value of memory size in bytes.
*
* @return memory size in bytes
*/
public long bytes() {
return unit.toBytes(value);
}
/**
* Returns value of memory size in kilo-bytes.
*
* @return memory size in kilo-bytes
*/
public long kiloBytes() {
return unit.toKiloBytes(value);
}
/**
* Returns value of memory size in mega-bytes.
*
* @return memory size in mega-bytes
*/
public long megaBytes() {
return unit.toMegaBytes(value);
}
/**
* Returns value of memory size in giga-bytes.
*
* @return memory size in giga-bytes
*/
public long gigaBytes() {
return unit.toGigaBytes(value);
}
/**
* Parses string representation of a memory size value.
* Value may end with one of suffixes;
*
* - 'k' or 'K' for 'kilo',
* - 'm' or 'M' for 'mega',
* - 'g' or 'G' for 'giga'.
*
*
* Default unit is bytes.
*
* Examples:
* 12345, 12345m, 12345K, 123456G
*/
public static MemorySize parse(String value) {
return parse(value, MemoryUnit.BYTES);
}
/**
* Parses string representation of a memory size value.
* Value may end with one of suffixes;
*
* - 'k' or 'K' for 'kilo',
* - 'm' or 'M' for 'mega',
* - 'g' or 'G' for 'giga'.
*
*
* Uses default unit if value does not contain unit information.
*
* Examples:
* 12345, 12345m, 12345K, 123456G
*/
public static MemorySize parse(String value, MemoryUnit defaultUnit) {
if (value == null || value.length() == 0) {
return new MemorySize(0, MemoryUnit.BYTES);
}
MemoryUnit unit = defaultUnit;
final char last = value.charAt(value.length() - 1);
if (!Character.isDigit(last)) {
value = value.substring(0, value.length() - 1);
switch (last) {
case 'g':
case 'G':
unit = MemoryUnit.GIGABYTES;
break;
case 'm':
case 'M':
unit = MemoryUnit.MEGABYTES;
break;
case 'k':
case 'K':
unit = MemoryUnit.KILOBYTES;
break;
default:
throw new IllegalArgumentException("Could not determine memory unit of " + value + last);
}
}
return new MemorySize(Long.parseLong(value), unit);
}
/**
* Returns a pretty format String representation of this memory size.
*
* @return a pretty format representation of this memory size
*/
public String toPrettyString() {
return toPrettyString(value, unit);
}
@Override
public String toString() {
return value + " " + unit.toString();
}
/**
* Utility method to create a pretty format representation of given value in bytes.
*
* @param size size in bytes
* @return pretty format representation of given value
*/
public static String toPrettyString(long size) {
return toPrettyString(size, MemoryUnit.BYTES);
}
/**
* Utility method to create a pretty format representation of given value in given unit.
*
* @param size memory size
* @param unit memory unit
* @return pretty format representation of given value
*/
public static String toPrettyString(long size, MemoryUnit unit) {
if (unit.toGigaBytes(size) >= PRETTY_FORMAT_LIMIT) {
return unit.toGigaBytes(size) + " GB";
}
if (unit.toMegaBytes(size) >= PRETTY_FORMAT_LIMIT) {
return unit.toMegaBytes(size) + " MB";
}
if (unit.toKiloBytes(size) >= PRETTY_FORMAT_LIMIT) {
return unit.toKiloBytes(size) + " KB";
}
if (size % MemoryUnit.K == 0) {
return unit.toKiloBytes(size) + " KB";
}
return size + " bytes";
}
}