de.erichseifert.vectorgraphics2d.util.DataUtils Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of VectorGraphics2D Show documentation
A library for adding vector export to Java(R) Graphics2D.
The newest version!
/*
 * VectorGraphics2D: Vector export for Java(R) Graphics2D
 *
 * (C) Copyright 2010-2017 Erich Seifert ,
 * Michael Seifert 
 *
 * This file is part of VectorGraphics2D.
 *
 * VectorGraphics2D is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * VectorGraphics2D is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with VectorGraphics2D.  If not, see .
 */
package de.erichseifert.vectorgraphics2d.util;

import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.text.DecimalFormat;
import java.text.DecimalFormatSymbols;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.regex.Pattern;

/**
 * Abstract class that contains utility functions for working with data
 * collections like maps or lists.
 */
public abstract class DataUtils {
	/** Standard pattern to format numbers */
	private static final DecimalFormat DOUBLE_FORMAT =
			new DecimalFormat("0", DecimalFormatSymbols.getInstance(Locale.ENGLISH));
	private static final DecimalFormat FLOAT_FORMAT =
			new DecimalFormat("0", DecimalFormatSymbols.getInstance(Locale.ENGLISH));

	static {
		DOUBLE_FORMAT.setMaximumFractionDigits(15);
		FLOAT_FORMAT.setMaximumFractionDigits(6);
	}

	/**
	 * Default constructor that prevents creation of class.
	 */
	DataUtils() {
		throw new UnsupportedOperationException();
	}

	/**
	 * Creates a mapping from two arrays, one with keys, one with values.
	 * @param  Data type of the keys.
	 * @param  Data type of the values.
	 * @param keys Array containing the keys.
	 * @param values Array containing the values.
	 * @return Map with keys and values from the specified arrays.
	 */
	public static  Map map(K[] keys, V[] values) {
		// Check for valid parameters
		if (keys.length != values.length) {
			throw new IllegalArgumentException(
					"Cannot create a Map: " +
					"The number of keys and values differs.");
		}
		// Fill map with keys and values
		Map map = new LinkedHashMap<>(keys.length);
		for (int i = 0; i < keys.length; i++) {
			K key = keys[i];
			V value = values[i];
			map.put(key, value);
		}
		return map;
	}

	/**
	 * Returns a string containing all elements concatenated by a specified
	 * separator.
	 * @param separator Separator string.
	 * @param elements List of elements that should be concatenated.
	 * @return a concatenated string.
	 */
	public static String join(String separator, List elements) {
		if (elements == null || elements.size() == 0) {
			return "";
		}
		StringBuilder sb = new StringBuilder(elements.size()*3);
		int i = 0;
		for (Object elem : elements) {
			if (separator.length() > 0 && i++ > 0) {
				sb.append(separator);
			}
			sb.append(format(elem));
		}
		return sb.toString();
	}

	/**
	 * Returns a string containing all elements concatenated by a specified
	 * separator.
	 * @param separator Separator string.
	 * @param elements Array of elements that should be concatenated.
	 * @return a concatenated string.
	 */
	public static String join(String separator, Object[] elements) {
		if (elements == null || elements.length == 0) {
			return "";
		}
		return join(separator, Arrays.asList(elements));
	}

	/**
	 * Returns a string containing all double numbers concatenated by a
	 * specified separator.
	 * @param separator Separator string.
	 * @param elements Array of double numbers that should be concatenated.
	 * @return a concatenated string.
	 */
	public static String join(String separator, double[] elements) {
		if (elements == null || elements.length == 0) {
			return "";
		}
		List list = new ArrayList<>(elements.length);
		for (Double element : elements) {
			list.add(element);
		}
		return join(separator, list);
	}

	/**
	 * Returns a string containing all float numbers concatenated by a
	 * specified separator.
	 * @param separator Separator string.
	 * @param elements Array of float numbers that should be concatenated.
	 * @return a concatenated string.
	 */
	public static String join(String separator, float[] elements) {
		if (elements == null || elements.length == 0) {
			return "";
		}
		List list = new ArrayList<>(elements.length);
		for (Float element : elements) {
			list.add(element);
		}
		return join(separator, list);
	}

	/**
	 * Returns the largest of all specified values.
	 * @param values Several integer values.
	 * @return largest value.
	 */
	public static int max(int... values) {
		if (values.length == 0) {
			throw new IllegalArgumentException("No values provided: Cannot determine maximum value.");
		}
		int max = values[0];
		for (int i = 1; i < values.length; i++) {
			if (values[i] > max) {
				max = values[i];
			}
		}
		return max;
	}

	/**
	 * Copies data from an input stream to an output stream using a buffer of
	 * specified size.
	 * @param in Input stream.
	 * @param out Output stream.
	 * @param bufferSize Size of the copy buffer.
	 * @throws IOException when an error occurs while copying.
	 */
	public static void transfer(InputStream in, OutputStream out, int bufferSize)
			throws IOException {
		byte[] buffer = new byte[bufferSize];
		int bytesRead;
		while ((bytesRead = in.read(buffer)) != -1) {
			out.write(buffer, 0, bytesRead);
		}
	}

	/**
	 * Returns a formatted string of the specified number. All trailing zeroes
	 * or decimal points will be stripped.
	 * @param number Number to convert to a string.
	 * @return A formatted string.
	 */
	public static String format(Number number) {
		String formatted;
		if (number instanceof Double) {
			formatted = DOUBLE_FORMAT.format(number.doubleValue());
		} else if (number instanceof Float) {
			formatted = FLOAT_FORMAT.format(number.floatValue());
		} else {
			formatted = number.toString();
		}
		return formatted;
	}

	/**
	 * Returns a formatted string of the specified object.
	 * @param obj Object to convert to a string.
	 * @return A formatted string.
	 */
	public static String format(Object obj) {
		if (obj instanceof Number) {
			return format((Number) obj);
		} else {
			return obj.toString();
		}
	}

	/**
	 * Converts an array of {@code float} numbers to a list of {@code Float}s.
	 * The list will be empty if the array is empty or {@code null}.
	 * @param elements Array of float numbers.
	 * @return A list with all numbers as {@code Float}.
	 */
	public static List asList(float[] elements) {
		int size = (elements != null) ? elements.length : 0;
		List list = new ArrayList<>(size);
		if (elements != null) {
			for (Float elem : elements) {
				list.add(elem);
			}
		}
		return list;
	}

	/**
	 * Converts an array of {@code double} numbers to a list of {@code Double}s.
	 * The list will be empty if the array is empty or {@code null}.
	 * @param elements Array of double numbers.
	 * @return A list with all numbers as {@code Double}.
	 */
	public static List asList(double[] elements) {
		int size = (elements != null) ? elements.length : 0;
		List list = new ArrayList<>(size);
		if (elements != null) {
			for (Double elem : elements) {
				list.add(elem);
			}
		}
		return list;
	}

	/**
	 * Removes the specified trailing pattern from a string.
	 * @param s string.
	 * @param substr trailing pattern.
	 * @return A string without the trailing pattern.
	 */
	public static String stripTrailing(String s, String substr) {
		return s.replaceAll("(" + Pattern.quote(substr) + ")+$", "");
	}
}