/*
 *  Copyright (c) 2011-2015 The original author or authors
 *
 *  All rights reserved. This program and the accompanying materials
 *  are made available under the terms of the Eclipse Public License v1.0
 *  and Apache License v2.0 which accompanies this distribution.
 *
 *       The Eclipse Public License is available at
 *       http://www.eclipse.org/legal/epl-v10.html
 *
 *       The Apache License v2.0 is available at
 *       http://www.opensource.org/licenses/apache2.0.php
 *
 *  You may elect to redistribute this code under either of these licenses.
 */

package io.vertx.ext.mail.impl;

import io.vertx.core.MultiMap;
import io.vertx.core.json.JsonArray;
import io.vertx.core.json.JsonObject;

import java.net.InetAddress;
import java.net.UnknownHostException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashSet;
import java.util.List;
import java.util.Set;

Author:Alexander Lehmann
/** * @author <a href="http://oss.lehmann.cx/">Alexander Lehmann</a> */
public final class Utils {
utility class only
/** * utility class only */
private Utils() { }
parse the capabilities string (single line) into a Set of auth String
Params:
  • auths – list of auth methods as String (e.g. "PLAIN LOGIN CRAM-MD5")
Returns:Set of supported auth methods
/** * parse the capabilities string (single line) into a Set of auth String * * @param auths list of auth methods as String (e.g. "PLAIN LOGIN CRAM-MD5") * @return Set of supported auth methods */
public static Set<String> parseCapaAuth(final String auths) { return new HashSet<>(splitByChar(auths, ' ')); }
split string at each occurrence of a character (e.g. \n)
Params:
  • message – the string to split
  • ch – the char between which we split
Returns:the list lines
/** * split string at each occurrence of a character (e.g. \n) * * @param message the string to split * @param ch the char between which we split * @return the list lines */
static List<String> splitByChar(final String message, final char ch) { List<String> lines = new ArrayList<>(); int index = 0; int nextIndex; while ((nextIndex = message.indexOf(ch, index)) != -1) { lines.add(message.substring(index, nextIndex)); index = nextIndex + 1; } lines.add(message.substring(index)); return lines; }
get the hostname by resolving our own address this method is not async due to possible dns call, we run this with executeBlocking
Returns:the hostname
/** * get the hostname by resolving our own address * * this method is not async due to possible dns call, we run this with executeBlocking * * @return the hostname */
public static String getHostname() { try { InetAddress ip = InetAddress.getLocalHost(); return ip.getCanonicalHostName(); } catch (UnknownHostException e) { // as a last resort, use localhost // another common convention would be to use the clients ip address // like [192.168.1.1] or [127.0.0.1] return "localhost"; } } public static JsonObject multiMapToJson(final MultiMap headers) { JsonObject json = new JsonObject(); for (String key : headers.names()) { json.put(key, headers.getAll(key)); } return json; } public static void putIfNotNull(final JsonObject json, final String key, final Object value) { if (value != null) { json.put(key, value); } } public static MultiMap jsonToMultiMap(final JsonObject jsonHeaders) { MultiMap headers = MultiMap.caseInsensitiveMultiMap();; for (String key : jsonHeaders.getMap().keySet()) { headers.add(key, getKeyAsStringOrList(jsonHeaders, key)); } return headers; } @SuppressWarnings("unchecked") public static List<String> getKeyAsStringOrList(JsonObject json, String key) { Object value = json.getValue(key); if (value == null) { return null; } else { if (value instanceof String) { return asList((String) value); } else if (value instanceof JsonArray) { return (List<String>) ((JsonArray) value).getList(); } else { throw new IllegalArgumentException("invalid attachment type"); } } } public static <T> List<T> asList(T element) { return Collections.singletonList(element); } }