You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2016/08/01 00:07:54 UTC
[05/51] [partial] incubator-juneau git commit: Initial Juno contents
from IBM JazzHub repo
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ProcBuilder.java
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ProcBuilder.java b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ProcBuilder.java
new file mode 100755
index 0000000..3050209
--- /dev/null
+++ b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ProcBuilder.java
@@ -0,0 +1,382 @@
+/*******************************************************************************
+ * Licensed Materials - Property of IBM
+ * (c) Copyright IBM Corporation 2015. All Rights Reserved.
+ *
+ * The source code for this program is not published or otherwise
+ * divested of its trade secrets, irrespective of what has been
+ * deposited with the U.S. Copyright Office.
+ *******************************************************************************/
+package com.ibm.juno.core.utils;
+
+import java.io.*;
+import java.lang.reflect.*;
+import java.util.*;
+import java.util.logging.*;
+
+import com.ibm.juno.core.utils.IOPipe.LineProcessor;
+
+/**
+ * Utility class for running operating system processes.
+ * <p>
+ * Similar to {@link java.lang.ProcessBuilder} but with additional features.
+ *
+ * @author James Bognar (jbognar@us.ibm.com)
+ */
+@SuppressWarnings("hiding")
+public class ProcBuilder {
+
+ private java.lang.ProcessBuilder pb = new java.lang.ProcessBuilder();
+ private TeeWriter outWriters = new TeeWriter(), logWriters = new TeeWriter();
+ private LineProcessor lp;
+ private Process p;
+ private int maxExitStatus = 0;
+ private boolean byLines;
+ private String divider = "--------------------------------------------------------------------------------";
+
+ /**
+ * Creates a process builder with the specified arguments.
+ * Equivalent to calling <code>ProcessBuilder.create().command(args);</code>
+ *
+ * @param args The command-line arguments.
+ * @return A new process builder.
+ */
+ public static ProcBuilder create(Object...args) {
+ return new ProcBuilder().command(args);
+ }
+
+ /**
+ * Creates an empty process builder.
+ *
+ * @return A new process builder.
+ */
+ public static ProcBuilder create() {
+ return new ProcBuilder().command();
+ }
+
+ /**
+ * Command arguments.
+ * Arguments can be collections or arrays and will be automatically expanded.
+ *
+ * @param args The command-line arguments.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder command(Object...args) {
+ return commandIf(ANY, args);
+ }
+
+ /**
+ * Command arguments if the specified matcher matches.
+ * Can be used for specifying os-specific commands.
+ * Example:
+ * <p class='bcode'>
+ * ProcessBuilder pb = ProcessBuilder
+ * .create()
+ * .commandIf(<jsf>WINDOWS</jsf>, <js>"cmd /c dir"</js>)
+ * .commandIf(<jsf>UNIX</jsf>, <js>"bash -c ls"</js>)
+ * .merge()
+ * .execute();
+ * </p>
+ *
+ * @param m The matcher.
+ * @param args The command line arguments if matcher matches.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder commandIf(Matcher m, Object...args) {
+ if (m.matches())
+ pb.command(toList(args));
+ return this;
+ }
+
+ /**
+ * Append to the command arguments.
+ * Arguments can be collections or arrays and will be automatically expanded.
+ *
+ * @param args The command-line arguments.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder append(Object...args) {
+ return appendIf(ANY, args);
+ }
+
+ /**
+ * Append to the command arguments if the specified matcher matches.
+ * Arguments can be collections or arrays and will be automatically expanded.
+ *
+ * @param m The matcher.
+ * @param args The command line arguments if matcher matches.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder appendIf(Matcher m, Object...args) {
+ if (m.matches())
+ pb.command().addAll(toList(args));
+ return this;
+ }
+
+ /**
+ * Merge STDOUT and STDERR into a single stream.
+ *
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder merge() {
+ pb.redirectErrorStream(true);
+ return this;
+ }
+
+ /**
+ * Use by-lines mode.
+ * Flushes output after every line of input.
+ *
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder byLines() {
+ this.byLines = true;
+ return this;
+ }
+
+ /**
+ * Pipe output to the specified writer.
+ * The method can be called multiple times to write to multiple writers.
+ *
+ * @param w The writer to pipe to.
+ * @param close Close the writer afterwards.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder pipeTo(Writer w, boolean close) {
+ this.outWriters.add(w, close);
+ return this;
+ }
+
+ /**
+ * Pipe output to the specified writer, but don't close the writer.
+ *
+ * @param w The writer to pipe to.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder pipeTo(Writer w) {
+ return pipeTo(w, false);
+ }
+
+ /**
+ * Pipe output to the specified writer, including the command and return code.
+ * The method can be called multiple times to write to multiple writers.
+ *
+ * @param w The writer to pipe to.
+ * @param close Close the writer afterwards.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder logTo(Writer w, boolean close) {
+ this.logWriters.add(w, close);
+ this.outWriters.add(w, close);
+ return this;
+ }
+
+ /**
+ * Pipe output to the specified writer, including the command and return code.
+ * The method can be called multiple times to write to multiple writers.
+ * Don't close the writer afterwards.
+ *
+ * @param w The writer to pipe to.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder logTo(Writer w) {
+ return logTo(w, false);
+ }
+
+ /**
+ * Pipe output to the specified writer, including the command and return code.
+ * The method can be called multiple times to write to multiple writers.
+ *
+ * @param level The log level.
+ * @param logger The logger to log to.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder logTo(final Level level, final Logger logger) {
+ if (logger.isLoggable(level)) {
+ logTo(new StringWriter() {
+ private boolean isClosed; // Prevents messages from being written twice.
+ @Override /* Writer */
+ public void close() {
+ if (! isClosed)
+ logger.log(level, this.toString());
+ isClosed = true;
+ }
+ }, true);
+ }
+ return this;
+ }
+
+ /**
+ * Line processor to use to process/convert lines of output returned by the process.
+ *
+ * @param lp The new line processor.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder lp(LineProcessor lp) {
+ this.lp = lp;
+ return this;
+ }
+
+ /**
+ * Append the specified environment variables to the process.
+ *
+ * @param env The new set of environment variables.
+ * @return This object (for method chaining).
+ */
+ @SuppressWarnings({"rawtypes", "unchecked"})
+ public ProcBuilder env(Map env) {
+ if (env != null)
+ for (Map.Entry e : (Set<Map.Entry>)env.entrySet())
+ environment(e.getKey().toString(), e.getValue() == null ? null : e.getValue().toString());
+ return this;
+ }
+
+ /**
+ * Append the specified environment variable.
+ *
+ * @param key The environment variable name.
+ * @param val The environment variable value.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder environment(String key, String val) {
+ pb.environment().put(key, val);
+ return this;
+ }
+
+ /**
+ * Sets the directory where the command will be executed.
+ *
+ * @param directory The directory.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder directory(File directory) {
+ pb.directory(directory);
+ return this;
+ }
+
+ /**
+ * Sets the maximum allowed return code on the process call.
+ * If the return code exceeds this value, an IOException is returned on the {@link #run()} command.
+ * The default value is '0'.
+ *
+ * @param maxExitStatus The maximum exit status.
+ * @return This object (for method chaining).
+ */
+ public ProcBuilder maxExitStatus(int maxExitStatus) {
+ this.maxExitStatus = maxExitStatus;
+ return this;
+ }
+
+ /**
+ * Run this command and pipes the output to the specified writer or output stream.
+ *
+ * @return The exit code from the process.
+ * @throws IOException
+ * @throws InterruptedException
+ */
+ public int run() throws IOException, InterruptedException {
+ if (pb.command().size() == 0)
+ throw new IOException("No command specified in ProcBuilder.");
+ try {
+ logWriters.append(divider).append("\n").flush();
+ logWriters.append(StringUtils.join(pb.command(), " ")).append("\n").flush();
+ p = pb.start();
+ IOPipe.create(p.getInputStream(), outWriters).lineProcessor(lp).byLines(byLines).run();
+ int rc = p.waitFor();
+ logWriters.append("Exit: ").append(String.valueOf(p.exitValue())).append("\n").flush();
+ if (rc > maxExitStatus)
+ throw new IOException("Return code "+rc+" from command " + StringUtils.join(pb.command(), " "));
+ return rc;
+ } finally {
+ close();
+ }
+ }
+
+ /**
+ * Run this command and returns the output as a simple string.
+ *
+ * @return The output from the command.
+ * @throws IOException
+ * @throws InterruptedException
+ */
+ public String getOutput() throws IOException, InterruptedException {
+ StringWriter sw = new StringWriter();
+ pipeTo(sw).run();
+ return sw.toString();
+ }
+
+ /**
+ * Returns the output from this process as a {@link Scanner}.
+ *
+ * @return The output from the process as a Scanner object.
+ * @throws IOException
+ * @throws InterruptedException
+ */
+ public Scanner getScanner() throws IOException, InterruptedException {
+ StringWriter sw = new StringWriter();
+ pipeTo(sw, true);
+ run();
+ return new Scanner(sw.toString());
+ }
+
+ /**
+ * Destroys the underlying process.
+ * This method is only needed if the {@link #getScanner()} method was used.
+ */
+ private void close() {
+ IOUtils.closeQuietly(logWriters, outWriters);
+ if (p != null)
+ p.destroy();
+ }
+
+ /**
+ * Specifies interface for defining OS-specific commands.
+ */
+ public abstract static class Matcher {
+ abstract boolean matches();
+ }
+
+ private static String OS = System.getProperty("os.name").toLowerCase();
+
+ /** Operating system matcher: Any operating system. */
+ public final static Matcher ANY = new Matcher() {
+ @Override boolean matches() {
+ return true;
+ }
+ };
+
+ /** Operating system matcher: Any Windows system. */
+ public final static Matcher WINDOWS = new Matcher() {
+ @Override boolean matches() {
+ return OS.indexOf("win") >= 0;
+ }
+ };
+
+ /** Operating system matcher: Any Mac system. */
+ public final static Matcher MAC = new Matcher() {
+ @Override boolean matches() {
+ return OS.indexOf("mac") >= 0;
+ }
+ };
+
+ /** Operating system matcher: Any Unix or Linux system. */
+ public final static Matcher UNIX = new Matcher() {
+ @Override boolean matches() {
+ return OS.indexOf("nix") >= 0 || OS.indexOf("nux") >= 0 || OS.indexOf("aix") > 0;
+ }
+ };
+
+ private static List<String> toList(Object...args) {
+ List<String> l = new LinkedList<String>();
+ for (Object o : args) {
+ if (o.getClass().isArray())
+ for (int i = 0; i < Array.getLength(o); i++)
+ l.add(Array.get(o, i).toString());
+ else if (o instanceof Collection)
+ for (Object o2 : (Collection<?>)o)
+ l.add(o2.toString());
+ else
+ l.add(o.toString());
+ }
+ return l;
+ }
+}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ReflectionUtils.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ReflectionUtils.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ReflectionUtils.class
new file mode 100755
index 0000000..2088152
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ReflectionUtils.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ReflectionUtils.java
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ReflectionUtils.java b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ReflectionUtils.java
new file mode 100755
index 0000000..b8ddc56
--- /dev/null
+++ b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/ReflectionUtils.java
@@ -0,0 +1,159 @@
+/*******************************************************************************
+ * Licensed Materials - Property of IBM
+ * (c) Copyright IBM Corporation 2014, 2015. All Rights Reserved.
+ *
+ * The source code for this program is not published or otherwise
+ * divested of its trade secrets, irrespective of what has been
+ * deposited with the U.S. Copyright Office.
+ *******************************************************************************/
+package com.ibm.juno.core.utils;
+
+import static com.ibm.juno.core.utils.CollectionUtils.*;
+
+import java.io.*;
+import java.lang.annotation.*;
+import java.util.*;
+
+/**
+ * Reflection utilities.
+ *
+ * @author James Bognar (jbognar@us.ibm.com)
+ */
+public final class ReflectionUtils {
+
+ /**
+ * Similar to {@link Class#getAnnotation(Class)} except also searches annotations on interfaces.
+ *
+ * @param <T> The annotation class type.
+ * @param a The annotation class.
+ * @param c The annotated class.
+ * @return The annotation, or <jk>null</jk> if not found.
+ */
+ public static <T extends Annotation> T getAnnotation(Class<T> a, Class<?> c) {
+ if (c == null)
+ return null;
+
+ T t = getDeclaredAnnotation(a, c);
+ if (t != null)
+ return t;
+
+ t = getAnnotation(a, c.getSuperclass());
+ if (t != null)
+ return t;
+
+ for (Class<?> c2 : c.getInterfaces()) {
+ t = getAnnotation(a, c2);
+ if (t != null)
+ return t;
+ }
+ return null;
+ }
+
+ /**
+ * Returns the specified annotation only if it's been declared on the specified class.
+ * <p>
+ * More efficient than calling {@link Class#getAnnotation(Class)} since it doesn't
+ * recursively look for the class up the parent chain.
+ *
+ * @param <T> The annotation class type.
+ * @param a The annotation class.
+ * @param c The annotated class.
+ * @return The annotation, or <jk>null</jk> if not found.
+ */
+ @SuppressWarnings("unchecked")
+ public static <T extends Annotation> T getDeclaredAnnotation(Class<T> a, Class<?> c) {
+ for (Annotation a2 : c.getDeclaredAnnotations())
+ if (a2.annotationType() == a)
+ return (T)a2;
+ return null;
+ }
+
+ /**
+ * Returns all instances of the specified annotation on the specified class.
+ * <p>
+ * Searches all superclasses and superinterfaces.
+ * <p>
+ * Results are ordered child-to-parent.
+ *
+ * @param <T> The annotation class type.
+ * @param a The annotation class type.
+ * @param c The class being searched.
+ * @return The found matches, or an empty array if annotation was not found.
+ */
+ public static <T extends Annotation> List<T> findAnnotations(Class<T> a, Class<?> c) {
+ List<T> l = new LinkedList<T>();
+ appendAnnotations(a, c, l);
+ return l;
+ }
+
+ /**
+ * Sames as {@link #findAnnotations(Class, Class)} except returns the annotations as a map
+ * with the keys being the class on which the annotation was found.
+ * <p>
+ * Results are ordered child-to-parent.
+ *
+ * @param <T> The annotation class type.
+ * @param a The annotation class type.
+ * @param c The class being searched.
+ * @return The found matches, or an empty array if annotation was not found.
+ */
+ public static <T extends Annotation> LinkedHashMap<Class<?>,T> findAnnotationsMap(Class<T> a, Class<?> c) {
+ LinkedHashMap<Class<?>,T> m = new LinkedHashMap<Class<?>,T>();
+ findAnnotationsMap(a, c, m);
+ return m;
+ }
+
+ private static <T extends Annotation> void findAnnotationsMap(Class<T> a, Class<?> c, Map<Class<?>,T> m) {
+ if (c == null)
+ return;
+
+ T t = getDeclaredAnnotation(a, c);
+ if (t != null)
+ m.put(c, t);
+
+ findAnnotationsMap(a, c.getSuperclass(), m);
+
+ for (Class<?> c2 : c.getInterfaces())
+ findAnnotationsMap(a, c2, m);
+ }
+
+ /**
+ * Finds and appends the specified annotation on the specified class and superclasses/interfaces to the specified list.
+ *
+ * @param a The annotation.
+ * @param c The class.
+ * @param l The list of annotations.
+ */
+ public static <T extends Annotation> void appendAnnotations(Class<T> a, Class<?> c, List<T> l) {
+ if (c == null)
+ return;
+
+ addIfNotNull(l, getDeclaredAnnotation(a, c));
+
+ if (c.getPackage() != null)
+ addIfNotNull(l, c.getPackage().getAnnotation(a));
+
+ appendAnnotations(a, c.getSuperclass(), l);
+
+ for (Class<?> c2 : c.getInterfaces())
+ appendAnnotations(a, c2, l);
+ }
+
+ /**
+ * Similar to {@link Class#getResourceAsStream(String)} except looks up the
+ * parent hierarchy for the existence of the specified resource.
+ *
+ * @param c The class to return the resource on.
+ * @param name The resource name.
+ * @return An input stream on the specified resource, or <jk>null</jk> if the resource could not be found.
+ */
+ public static InputStream getResource(Class<?> c, String name) {
+ while (c != null) {
+ InputStream is = c.getResourceAsStream(name);
+ if (is != null)
+ return is;
+ c = c.getSuperclass();
+ }
+ return null;
+ }
+}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceBundle.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceBundle.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceBundle.class
new file mode 100755
index 0000000..5509806
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceBundle.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceBundle.java
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceBundle.java b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceBundle.java
new file mode 100755
index 0000000..a19a76d
--- /dev/null
+++ b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceBundle.java
@@ -0,0 +1,132 @@
+/*******************************************************************************
+ * Licensed Materials - Property of IBM
+ * (c) Copyright IBM Corporation 2014, 2015. All Rights Reserved.
+ *
+ * The source code for this program is not published or otherwise
+ * divested of its trade secrets, irrespective of what has been
+ * deposited with the U.S. Copyright Office.
+ *******************************************************************************/
+package com.ibm.juno.core.utils;
+
+import java.text.*;
+import java.util.*;
+
+/**
+ * Wraps a {@link ResourceBundle} to gracefully handle missing bundles and entries.
+ * <p>
+ * If the bundle isn't found, <code>getString(key)</code> returns <js>"{!!key}"</js>.
+ * <p>
+ * If the key isn't found, <code>getString(key)</code> returns <js>"{!key}"</js>.
+ *
+ * @author James Bognar (jbognar@us.ibm.com)
+ */
+public class SafeResourceBundle extends ResourceBundle {
+
+ private ResourceBundle rb;
+ private String className = null;
+ Map<String,String> classPrefixedKeys = new HashMap<String,String>();
+
+ SafeResourceBundle() {}
+
+ /**
+ * Constructor.
+ *
+ * @param rb The resource bundle to wrap. Can be <jk>null</jk> to indicate a missing bundle.
+ * @param forClass The class using this resource bundle.
+ */
+ public SafeResourceBundle(ResourceBundle rb, Class<?> forClass) {
+ this.rb = rb;
+ if (forClass != null)
+ className = forClass.getSimpleName();
+ if (rb != null) {
+ String c = className + '.';
+ for (Enumeration<String> e = getKeys(); e.hasMoreElements();) {
+ String key = e.nextElement();
+ if (key.startsWith(c))
+ classPrefixedKeys.put(key.substring(className.length() + 1), key);
+ }
+ }
+ }
+
+ @Override /* ResourceBundle */
+ public boolean containsKey(String key) {
+ return rb != null && (rb.containsKey(key) || classPrefixedKeys.containsKey(key));
+ }
+
+ /**
+ * Similar to {@link ResourceBundle#getString(String)} except allows you to pass in {@link MessageFormat} objects.
+ *
+ * @param key The resource bundle key.
+ * @param args Optional variable replacement arguments.
+ * @return The resolved value. Never <jk>null</jk>. <js>"{!!key}"</j> if the bundle is missing. <js>"{!key}"</j> if the key is missing.
+ */
+ public String getString(String key, Object...args) {
+ if (rb == null)
+ return "{!!"+key+"}";
+ if (! containsKey(key))
+ return "{!" + key + "}";
+ String val = getString(key);
+ if (args.length > 0)
+ return MessageFormat.format(val, args);
+ return val;
+ }
+
+ /**
+ * Looks for all the specified keys in the resource bundle and returns the first value that exists.
+ *
+ * @param keys
+ * @return The resolved value, or <jk>null</jk> if no value is found or the resource bundle is missing.
+ */
+ public String findFirstString(String...keys) {
+ if (rb == null)
+ return null;
+ for (String k : keys) {
+ if (containsKey(k))
+ return getString(k);
+ }
+ return null;
+ }
+
+ @SuppressWarnings("unchecked")
+ @Override /* ResourceBundle */
+ public Set<String> keySet() {
+ if (rb == null)
+ return Collections.emptySet();
+ return new MultiSet<String>(rb.keySet(), classPrefixedKeys.keySet()) ;
+ }
+
+ /**
+ * Returns all keys in this resource bundle with the specified prefix.
+ *
+ * @param prefix The prefix.
+ * @return The set of all keys in the resource bundle with the prefix.
+ */
+ public Set<String> keySet(String prefix) {
+ Set<String> set = new HashSet<String>();
+ for (String s : keySet()) {
+ if (s.equals(prefix) || (s.startsWith(prefix) && s.charAt(prefix.length()) == '.'))
+ set.add(s);
+ }
+ return set;
+ }
+
+ @Override /* ResourceBundle */
+ public Enumeration<String> getKeys() {
+ if (rb == null)
+ return new Vector<String>(0).elements();
+ return rb.getKeys();
+ }
+
+ @Override /* ResourceBundle */
+ protected Object handleGetObject(String key) {
+ if (rb == null)
+ return "{!!"+key+"}";
+ try {
+ if (classPrefixedKeys.containsKey(key))
+ key = classPrefixedKeys.get(key);
+ return rb.getObject(key);
+ } catch (Exception e) {
+ return "{!"+key+"}";
+ }
+ }
+}
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceMultiBundle.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceMultiBundle.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceMultiBundle.class
new file mode 100755
index 0000000..5e239a4
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceMultiBundle.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceMultiBundle.java
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceMultiBundle.java b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceMultiBundle.java
new file mode 100755
index 0000000..fcf4ccc
--- /dev/null
+++ b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SafeResourceMultiBundle.java
@@ -0,0 +1,82 @@
+/*******************************************************************************
+ * Licensed Materials - Property of IBM
+ * (c) Copyright IBM Corporation 2014, 2015. All Rights Reserved.
+ *
+ * The source code for this program is not published or otherwise
+ * divested of its trade secrets, irrespective of what has been
+ * deposited with the U.S. Copyright Office.
+ *******************************************************************************/
+package com.ibm.juno.core.utils;
+
+import java.util.*;
+
+/**
+ * A collection of {@link SafeResourceBundle} objects.
+ * Allows servlets to define resource bundles for different classes in the class hierarchy.
+ *
+ * @author James Bognar (jbognar@us.ibm.com)
+ */
+public final class SafeResourceMultiBundle extends SafeResourceBundle {
+
+ private List<SafeResourceBundle> bundles = new ArrayList<SafeResourceBundle>();
+
+ /**
+ * Constructor.
+ *
+ * @param bundles The resource bundles to wrap. Can be <jk>null</jk> to indicate a missing bundle.
+ */
+ public SafeResourceMultiBundle(Collection<SafeResourceBundle> bundles) {
+ this.bundles.addAll(bundles);
+ }
+
+ @Override /* SafeResourceBundle */
+ public String findFirstString(String...keys) {
+ for (String key : keys)
+ for (SafeResourceBundle srb : bundles)
+ if (srb.containsKey(key))
+ return srb.getString(key);
+ return null;
+ }
+
+ @Override /* ResourceBundle */
+ public boolean containsKey(String key) {
+ for (SafeResourceBundle srb : bundles)
+ if (srb.containsKey(key))
+ return true;
+ return false;
+ }
+
+ @Override /* SafeResourceBundle */
+ public String getString(String key, Object...args) {
+ for (SafeResourceBundle srb : bundles)
+ if (srb.containsKey(key))
+ return srb.getString(key, args);
+ return "{!" + key + "}";
+ }
+
+ @Override /* ResourceBundle */
+ @SuppressWarnings("unchecked")
+ public Set<String> keySet() {
+ MultiSet<String> s = new MultiSet<String>();
+ for (SafeResourceBundle rb : bundles)
+ s.append(rb.keySet());
+ return s;
+ }
+
+ @Override /* ResourceBundle */
+ @SuppressWarnings("unchecked")
+ public Enumeration<String> getKeys() {
+ MultiSet<String> s = new MultiSet<String>();
+ for (SafeResourceBundle rb : bundles)
+ s.append(rb.keySet());
+ return s.enumerator();
+ }
+
+ @Override /* ResourceBundle */
+ protected Object handleGetObject(String key) {
+ for (SafeResourceBundle srb : bundles)
+ if (srb.containsKey(key))
+ return srb.handleGetObject(key);
+ return "{!"+key+"}";
+ }
+}
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap$1.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap$1.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap$1.class
new file mode 100755
index 0000000..e935d78
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap$1.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap$SimpleMapEntry.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap$SimpleMapEntry.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap$SimpleMapEntry.class
new file mode 100755
index 0000000..c515bc1
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap$SimpleMapEntry.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap.class
new file mode 100755
index 0000000..03c32ce
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap.java
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap.java b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap.java
new file mode 100755
index 0000000..21bd047
--- /dev/null
+++ b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/SimpleMap.java
@@ -0,0 +1,112 @@
+/*******************************************************************************
+ * Licensed Materials - Property of IBM
+ * (c) Copyright IBM Corporation 2014, 2015. All Rights Reserved.
+ *
+ * The source code for this program is not published or otherwise
+ * divested of its trade secrets, irrespective of what has been
+ * deposited with the U.S. Copyright Office.
+ *******************************************************************************/
+package com.ibm.juno.core.utils;
+
+import static com.ibm.juno.core.utils.ArrayUtils.*;
+import static com.ibm.juno.core.utils.ThrowableUtils.*;
+
+import java.text.*;
+import java.util.*;
+
+/**
+ * An instance of a <code>Map</code> where the keys and values
+ * are simple <code>String[]</code> and <code>Object[]</code> arrays.
+ * <p>
+ * Typically more efficient than <code>HashMaps</code> for small maps (e.g. <10 entries).
+ * <p>
+ * Does not support adding or removing entries.
+ * <p>
+ * Setting values overwrites the value on the underlying value array.
+ *
+ * @author James Bognar (jbognar@us.ibm.com)
+ */
+public final class SimpleMap extends AbstractMap<String,Object> {
+
+ private final String[] keys;
+ private final Object[] values;
+ private final Map.Entry<String,Object>[] entries;
+
+ /**
+ * Constructor.
+ *
+ * @param keys The map keys. Must not be <jk>null</jk>.
+ * @param values The map values. Must not be <jk>null</jk>.
+ */
+ public SimpleMap(String[] keys, Object[] values) {
+ assertFieldNotNull(keys, "keys");
+ assertFieldNotNull(values, "values");
+ if (keys.length != values.length)
+ illegalArg("keys ''{0}'' and values ''{1}'' array lengths differ", keys.length, values.length);
+
+ this.keys = keys;
+ this.values = values;
+ entries = new SimpleMapEntry[keys.length];
+ for (int i = 0; i < keys.length; i++) {
+ if (keys[i] == null)
+ illegalArg("Keys array cannot contain a null value.");
+ entries[i] = new SimpleMapEntry(i);
+ }
+ }
+
+ @Override /* Map */
+ public Set<Map.Entry<String,Object>> entrySet() {
+ return asSet(entries);
+ }
+
+ @Override /* Map */
+ public Object get(Object key) {
+ for (int i = 0; i < keys.length; i++)
+ if (keys[i].equals(key))
+ return values[i];
+ return null;
+ }
+
+ @Override /* Map */
+ public Set<String> keySet() {
+ return asSet(keys);
+ }
+
+ @Override /* Map */
+ public Object put(String key, Object value) {
+ for (int i = 0; i < keys.length; i++) {
+ if (keys[i].equals(key)) {
+ Object v = values[i];
+ values[i] = value;
+ return v;
+ }
+ }
+ throw new IllegalArgumentException(MessageFormat.format("No key ''{0}'' defined in map", key));
+ }
+
+ private class SimpleMapEntry implements Map.Entry<String,Object> {
+
+ private int index;
+
+ private SimpleMapEntry(int index) {
+ this.index = index;
+ }
+
+ @Override /* Map.Entry */
+ public String getKey() {
+ return keys[index];
+ }
+
+ @Override /* Map.Entry */
+ public Object getValue() {
+ return values[index];
+ }
+
+ @Override /* Map.Entry */
+ public Object setValue(Object val) {
+ Object v = values[index];
+ values[index] = val;
+ return v;
+ }
+ }
+}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringBuilderWriter.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringBuilderWriter.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringBuilderWriter.class
new file mode 100755
index 0000000..c1f9118
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringBuilderWriter.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringBuilderWriter.java
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringBuilderWriter.java b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringBuilderWriter.java
new file mode 100755
index 0000000..8fffbdb
--- /dev/null
+++ b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringBuilderWriter.java
@@ -0,0 +1,95 @@
+/*******************************************************************************
+ * Licensed Materials - Property of IBM
+ * (c) Copyright IBM Corporation 2014, 2015. All Rights Reserved.
+ *
+ * The source code for this program is not published or otherwise
+ * divested of its trade secrets, irrespective of what has been
+ * deposited with the U.S. Copyright Office.
+ *******************************************************************************/
+package com.ibm.juno.core.utils;
+
+import java.io.*;
+
+/**
+ * Similar to {@link StringWriter}, but uses a {@link StringBuilder} instead to avoid synchronization overhead.
+ * <p>
+ * Note that this class is NOT thread safe.
+ *
+ * @author James Bognar (jbognar@us.ibm.com)
+ */
+public final class StringBuilderWriter extends Writer {
+
+ private StringBuilder sb;
+
+ /**
+ * Create a new string writer using the default initial string-builder size.
+ */
+ public StringBuilderWriter() {
+ sb = new StringBuilder();
+ lock = null;
+ }
+
+ /**
+ * Create a new string writer using the specified initial string-builder size.
+ *
+ * @param initialSize The number of <tt>char</tt> values that will fit into this buffer before it is automatically expanded
+ * @throws IllegalArgumentException If <tt>initialSize</tt> is negative
+ */
+ public StringBuilderWriter(int initialSize) {
+ sb = new StringBuilder(initialSize);
+ lock = null;
+ }
+
+ @Override /* Writer */
+ public void write(int c) {
+ sb.append((char) c);
+ }
+
+ @Override /* Writer */
+ public void write(char cbuf[], int start, int length) {
+ sb.append(cbuf, start, length);
+ }
+
+ @Override /* Writer */
+ public void write(String str) {
+ sb.append(str);
+ }
+
+ @Override /* Writer */
+ public void write(String str, int off, int len) {
+ sb.append(str.substring(off, off + len));
+ }
+
+ @Override /* Writer */
+ public StringBuilderWriter append(CharSequence csq) {
+ if (csq == null)
+ write("null");
+ else
+ write(csq.toString());
+ return this;
+ }
+
+ @Override /* Writer */
+ public StringBuilderWriter append(CharSequence csq, int start, int end) {
+ CharSequence cs = (csq == null ? "null" : csq);
+ write(cs.subSequence(start, end).toString());
+ return this;
+ }
+
+ @Override /* Writer */
+ public StringBuilderWriter append(char c) {
+ write(c);
+ return this;
+ }
+
+ @Override /* Object */
+ public String toString() {
+ return sb.toString();
+ }
+
+ @Override /* Writer */
+ public void flush() {}
+
+ @Override /* Writer */
+ public void close() throws IOException {}
+}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringUtils.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringUtils.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringUtils.class
new file mode 100755
index 0000000..82ed33f
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringUtils.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringUtils.java
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringUtils.java b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringUtils.java
new file mode 100755
index 0000000..4621af4
--- /dev/null
+++ b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringUtils.java
@@ -0,0 +1,873 @@
+/*******************************************************************************
+ * Licensed Materials - Property of IBM
+ * (c) Copyright IBM Corporation 2014, 2015. All Rights Reserved.
+ *
+ * The source code for this program is not published or otherwise
+ * divested of its trade secrets, irrespective of what has been
+ * deposited with the U.S. Copyright Office.
+ *******************************************************************************/
+package com.ibm.juno.core.utils;
+
+import static com.ibm.juno.core.utils.ThrowableUtils.*;
+
+import java.io.*;
+import java.math.*;
+import java.util.*;
+import java.util.concurrent.atomic.*;
+import java.util.regex.*;
+
+import javax.xml.bind.*;
+
+import com.ibm.juno.core.parser.*;
+
+/**
+ * Reusable string utility methods.
+ */
+public final class StringUtils {
+
+ private static final AsciiSet numberChars = new AsciiSet("-xX.+-#pP0123456789abcdefABCDEF");
+ private static final AsciiSet firstNumberChars = new AsciiSet("+-.#0123456789");
+ private static final AsciiSet octChars = new AsciiSet("01234567");
+ private static final AsciiSet decChars = new AsciiSet("0123456789");
+ private static final AsciiSet hexChars = new AsciiSet("0123456789abcdefABCDEF");
+
+ // Maps 6-bit nibbles to BASE64 characters.
+ private static final char[] base64m1 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".toCharArray();
+
+ // Maps BASE64 characters to 6-bit nibbles.
+ private static final byte[] base64m2 = new byte[128];
+ static {
+ for (int i = 0; i < 64; i++)
+ base64m2[base64m1[i]] = (byte)i;
+ }
+
+ /**
+ * Parses a number from the specified reader stream.
+ *
+ * @param r The reader to parse the string from.
+ * @param type The number type to created. <br>
+ * Can be any of the following:
+ * <ul>
+ * <li> Integer
+ * <li> Double
+ * <li> Float
+ * <li> Long
+ * <li> Short
+ * <li> Byte
+ * <li> BigInteger
+ * <li> BigDecimal
+ * </ul>
+ * If <jk>null</jk>, uses the best guess.
+ * @throws IOException If a problem occurred trying to read from the reader.
+ * @return The parsed number.
+ * @throws ParseException
+ */
+ public static Number parseNumber(ParserReader r, Class<? extends Number> type) throws IOException, ParseException {
+ return parseNumber(parseNumberString(r), type);
+ }
+
+ /**
+ * Reads a numeric string from the specified reader.
+ *
+ * @param r The reader to read form.
+ * @return The parsed number string.
+ * @throws IOException
+ */
+ public static String parseNumberString(ParserReader r) throws IOException {
+ r.mark();
+ int c = 0;
+ while (true) {
+ c = r.read();
+ if (c == -1)
+ break;
+ if (! numberChars.contains((char)c)) {
+ r.unread();
+ break;
+ }
+ }
+ return r.getMarked();
+ }
+
+ /**
+ * Parses a number from the specified string.
+ *
+ * @param s The string to parse the number from.
+ * @param type The number type to created. <br>
+ * Can be any of the following:
+ * <ul>
+ * <li> Integer
+ * <li> Double
+ * <li> Float
+ * <li> Long
+ * <li> Short
+ * <li> Byte
+ * <li> BigInteger
+ * <li> BigDecimal
+ * </ul>
+ * If <jk>null</jk>, uses the best guess.
+ * @return The parsed number.
+ * @throws ParseException
+ */
+ public static Number parseNumber(String s, Class<? extends Number> type) throws ParseException {
+
+ if (s.isEmpty())
+ s = "0";
+ if (type == null)
+ type = Number.class;
+
+ try {
+ // Determine the data type if it wasn't specified.
+ boolean isAutoDetect = (type == Number.class);
+ boolean isDecimal = false;
+ if (isAutoDetect) {
+ // If we're auto-detecting, then we use either an Integer, Long, or Double depending on how
+ // long the string is.
+ // An integer range is -2,147,483,648 to 2,147,483,647
+ // An long range is -9,223,372,036,854,775,808 to +9,223,372,036,854,775,807
+ isDecimal = isDecimal(s);
+ if (isDecimal) {
+ if (s.length() > 20)
+ type = Double.class;
+ else if (s.length() >= 10)
+ type = Long.class;
+ else
+ type = Integer.class;
+ }
+ else if (isFloat(s))
+ type = Double.class;
+ else
+ throw new NumberFormatException(s);
+ }
+
+ if (type == Double.class || type == Double.TYPE) {
+ Double d = Double.valueOf(s);
+ if (isAutoDetect && (! isDecimal) && d >= -Float.MAX_VALUE && d <= Float.MAX_VALUE)
+ return d.floatValue();
+ return d;
+ }
+ if (type == Float.class || type == Float.TYPE)
+ return Float.valueOf(s);
+ if (type == BigDecimal.class)
+ return new BigDecimal(s);
+ if (type == Long.class || type == Long.TYPE || type == AtomicLong.class) {
+ try {
+ Long l = Long.decode(s);
+ if (type == AtomicLong.class)
+ return new AtomicLong(l);
+ if (isAutoDetect && l >= Integer.MIN_VALUE && l <= Integer.MAX_VALUE) {
+ // This occurs if the string is 10 characters long but is still a valid integer value.
+ return l.intValue();
+ }
+ return l;
+ } catch (NumberFormatException e) {
+ if (isAutoDetect) {
+ // This occurs if the string is 20 characters long but still falls outside the range of a valid long.
+ return Double.valueOf(s);
+ }
+ throw e;
+ }
+ }
+ if (type == Integer.class || type == Integer.TYPE)
+ return Integer.decode(s);
+ if (type == Short.class || type == Short.TYPE)
+ return Short.decode(s);
+ if (type == Byte.class || type == Byte.TYPE)
+ return Byte.decode(s);
+ if (type == BigInteger.class)
+ return new BigInteger(s);
+ if (type == AtomicInteger.class)
+ return new AtomicInteger(Integer.decode(s));
+ throw new ParseException("Unsupported Number type: {0}", type.getName());
+ } catch (NumberFormatException e) {
+ throw new ParseException("Could not convert string ''{0}'' to class ''{1}''", s, type.getName()).initCause(e);
+ }
+ }
+
+ private final static Pattern fpRegex = Pattern.compile(
+ "[+-]?(NaN|Infinity|((((\\p{Digit}+)(\\.)?((\\p{Digit}+)?)([eE][+-]?(\\p{Digit}+))?)|(\\.((\\p{Digit}+))([eE][+-]?(\\p{Digit}+))?)|(((0[xX](\\p{XDigit}+)(\\.)?)|(0[xX](\\p{XDigit}+)?(\\.)(\\p{XDigit}+)))[pP][+-]?(\\p{Digit}+)))[fFdD]?))[\\x00-\\x20]*"
+ );
+
+ /**
+ * Returns <jk>true</jk> if this string can be parsed by {@link #parseNumber(String, Class)}.
+ *
+ * @param s The string to check.
+ * @return <jk>true</jk> if this string can be parsed without causing an exception.
+ */
+ public static boolean isNumeric(String s) {
+ if (s == null || s.isEmpty())
+ return false;
+ if (! firstNumberChars.contains(s.charAt(0)))
+ return false;
+ return isDecimal(s) || isFloat(s);
+ }
+
+ /**
+ * Returns <jk>true</jk> if the specified string is a floating point number.
+ *
+ * @param s The string to check.
+ * @return <jk>true</jk> if the specified string is a floating point number.
+ */
+ public static boolean isFloat(String s) {
+ if (s == null || s.isEmpty())
+ return false;
+ if (! firstNumberChars.contains(s.charAt(0)))
+ return (s.equals("NaN") || s.equals("Infinity"));
+ int i = 0;
+ int length = s.length();
+ char c = s.charAt(0);
+ if (c == '+' || c == '-')
+ i++;
+ if (i == length)
+ return false;
+ c = s.charAt(i++);
+ if (c == '.' || decChars.contains(c)) {
+ return fpRegex.matcher(s).matches();
+ }
+ return false;
+ }
+
+ /**
+ * Returns <jk>true</jk> if the specified string is numeric.
+ *
+ * @param s The string to check.
+ * @return <jk>true</jk> if the specified string is numeric.
+ */
+ public static boolean isDecimal(String s) {
+ if (s == null || s.isEmpty())
+ return false;
+ if (! firstNumberChars.contains(s.charAt(0)))
+ return false;
+ int i = 0;
+ int length = s.length();
+ char c = s.charAt(0);
+ boolean isPrefixed = false;
+ if (c == '+' || c == '-') {
+ isPrefixed = true;
+ i++;
+ }
+ if (i == length)
+ return false;
+ c = s.charAt(i++);
+ if (c == '0' && length > (isPrefixed ? 2 : 1)) {
+ c = s.charAt(i++);
+ if (c == 'x' || c == 'X') {
+ for (int j = i; j < length; j++) {
+ if (! hexChars.contains(s.charAt(j)))
+ return false;
+ }
+ } else if (octChars.contains(c)) {
+ for (int j = i; j < length; j++)
+ if (! octChars.contains(s.charAt(j)))
+ return false;
+ } else {
+ return false;
+ }
+ } else if (c == '#') {
+ for (int j = i; j < length; j++) {
+ if (! hexChars.contains(s.charAt(j)))
+ return false;
+ }
+ } else if (decChars.contains(c)) {
+ for (int j = i; j < length; j++)
+ if (! decChars.contains(s.charAt(j)))
+ return false;
+ } else {
+ return false;
+ }
+ return true;
+ }
+
+ /**
+ * Convenience method for getting a stack trace as a string.
+ *
+ * @param t The throwable to get the stack trace from.
+ * @return The same content that would normally be rendered via <code>t.printStackTrace()</code>
+ */
+ public static String getStackTrace(Throwable t) {
+ StringWriter sw = new StringWriter();
+ PrintWriter pw = new PrintWriter(sw);
+ t.printStackTrace(pw);
+ pw.flush();
+ pw.close();
+ return sw.toString();
+ }
+
+ /**
+ * Join the specified tokens into a delimited string.
+ *
+ * @param tokens The tokens to join.
+ * @param separator The delimiter.
+ * @return The delimited string. If <code>tokens</code> is <jk>null</jk>, returns <jk>null</jk>.
+ */
+ public static String join(Object[] tokens, String separator) {
+ if (tokens == null)
+ return null;
+ StringBuilder sb = new StringBuilder();
+ for (int i = 0; i < tokens.length; i++) {
+ if (i > 0)
+ sb.append(separator);
+ sb.append(tokens[i]);
+ }
+ return sb.toString();
+ }
+
+ /**
+ * Join the specified tokens into a delimited string.
+ *
+ * @param tokens The tokens to join.
+ * @param d The delimiter.
+ * @return The delimited string. If <code>tokens</code> is <jk>null</jk>, returns <jk>null</jk>.
+ */
+ public static String join(int[] tokens, String d) {
+ if (tokens == null)
+ return null;
+ StringBuilder sb = new StringBuilder();
+ for (int i = 0; i < tokens.length; i++) {
+ if (i > 0)
+ sb.append(d);
+ sb.append(tokens[i]);
+ }
+ return sb.toString();
+ }
+
+ /**
+ * Join the specified tokens into a delimited string.
+ *
+ * @param tokens The tokens to join.
+ * @param d The delimiter.
+ * @return The delimited string. If <code>tokens</code> is <jk>null</jk>, returns <jk>null</jk>.
+ */
+ public static String join(Collection<?> tokens, String d) {
+ if (tokens == null)
+ return null;
+ StringBuilder sb = new StringBuilder();
+ for (Iterator<?> iter = tokens.iterator(); iter.hasNext();) {
+ sb.append(iter.next());
+ if (iter.hasNext())
+ sb.append(d);
+ }
+ return sb.toString();
+ }
+
+ /**
+ * Join the specified tokens into a delimited string.
+ *
+ * @param tokens The tokens to join.
+ * @param d The delimiter.
+ * @return The delimited string. If <code>tokens</code> is <jk>null</jk>, returns <jk>null</jk>.
+ */
+ public static String join(Object[] tokens, char d) {
+ if (tokens == null)
+ return null;
+ StringBuilder sb = new StringBuilder();
+ for (int i = 0; i < tokens.length; i++) {
+ if (i > 0)
+ sb.append(d);
+ sb.append(tokens[i]);
+ }
+ return sb.toString();
+ }
+
+ /**
+ * Join the specified tokens into a delimited string.
+ *
+ * @param tokens The tokens to join.
+ * @param d The delimiter.
+ * @return The delimited string. If <code>tokens</code> is <jk>null</jk>, returns <jk>null</jk>.
+ */
+ public static String join(int[] tokens, char d) {
+ if (tokens == null)
+ return null;
+ StringBuilder sb = new StringBuilder();
+ for (int i = 0; i < tokens.length; i++) {
+ if (i > 0)
+ sb.append(d);
+ sb.append(tokens[i]);
+ }
+ return sb.toString();
+ }
+
+ /**
+ * Join the specified tokens into a delimited string.
+ *
+ * @param tokens The tokens to join.
+ * @param d The delimiter.
+ * @return The delimited string. If <code>tokens</code> is <jk>null</jk>, returns <jk>null</jk>.
+ */
+ public static String join(Collection<?> tokens, char d) {
+ if (tokens == null)
+ return null;
+ StringBuilder sb = new StringBuilder();
+ for (Iterator<?> iter = tokens.iterator(); iter.hasNext();) {
+ sb.append(iter.next());
+ if (iter.hasNext())
+ sb.append(d);
+ }
+ return sb.toString();
+ }
+
+ /**
+ * Splits a character-delimited string into a string array.
+ * Does not split on escaped-delimiters (e.g. "\,");
+ * Resulting tokens are trimmed of whitespace.
+ * NOTE: This behavior is different than the Jakarta equivalent.
+ * split("a,b,c",',') -> {"a","b","c"}
+ * split("a, b ,c ",',') -> {"a","b","c"}
+ * split("a,,c",',') -> {"a","","c"}
+ * split(",,",',') -> {"","",""}
+ * split("",',') -> {}
+ * split(null,',') -> null
+ * split("a,b\,c,d", ',', false) -> {"a","b\,c","d"}
+ * split("a,b\\,c,d", ',', false) -> {"a","b\","c","d"}
+ * split("a,b\,c,d", ',', true) -> {"a","b,c","d"}
+ *
+ * @param s The string to split. Can be <jk>null</jk>.
+ * @param c The character to split on.
+ * @return The tokens.
+ */
+ public static String[] split(String s, char c) {
+
+ char[] unEscapeChars = new char[]{'\\', c};
+
+ if (s == null)
+ return null;
+ if (isEmpty(s))
+ return new String[0];
+
+ List<String> l = new LinkedList<String>();
+ char[] sArray = s.toCharArray();
+ int x1 = 0, escapeCount = 0;
+ for (int i = 0; i < sArray.length; i++) {
+ if (sArray[i] == '\\') escapeCount++;
+ else if (sArray[i]==c && escapeCount % 2 == 0) {
+ String s2 = new String(sArray, x1, i-x1);
+ String s3 = unEscapeChars(s2, unEscapeChars);
+ l.add(s3.trim());
+ x1 = i+1;
+ }
+ if (sArray[i] != '\\') escapeCount = 0;
+ }
+ String s2 = new String(sArray, x1, sArray.length-x1);
+ String s3 = unEscapeChars(s2, unEscapeChars);
+ l.add(s3.trim());
+
+ return l.toArray(new String[l.size()]);
+ }
+
+ /**
+ * Returns <jk>true</jk> if specified string is <jk>null</jk> or empty.
+ *
+ * @param s The string to check.
+ * @return <jk>true</jk> if specified string is <jk>null</jk> or empty.
+ */
+ public static boolean isEmpty(String s) {
+ return s == null || s.isEmpty();
+ }
+
+ /**
+ * Returns <jk>true</jk> if specified string is <jk>null</jk> or it's {@link #toString()} method returns an empty string.
+ *
+ * @param s The string to check.
+ * @return <jk>true</jk> if specified string is <jk>null</jk> or it's {@link #toString()} method returns an empty string.
+ */
+ public static boolean isEmpty(Object s) {
+ return s == null || s.toString().isEmpty();
+ }
+
+ /**
+ * Returns <jk>null</jk> if the specified string is <jk>null</jk> or empty.
+ *
+ * @param s The string to check.
+ * @return <jk>null</jk> if the specified string is <jk>null</jk> or empty, or the same string if not.
+ */
+ public static String nullIfEmpty(String s) {
+ if (s == null || s.isEmpty())
+ return null;
+ return s;
+ }
+
+ /**
+ * Removes escape characters (\) from the specified characters.
+ *
+ * @param s The string to remove escape characters from.
+ * @param toEscape The characters escaped.
+ * @return A new string if characters were removed, or the same string if not or if the input was <jk>null</jk>.
+ */
+ public static String unEscapeChars(String s, char[] toEscape) {
+ return unEscapeChars(s, toEscape, '\\');
+ }
+
+ /**
+ * Removes escape characters (specified by escapeChar) from the specified characters.
+ *
+ * @param s The string to remove escape characters from.
+ * @param toEscape The characters escaped.
+ * @param escapeChar The escape character.
+ * @return A new string if characters were removed, or the same string if not or if the input was <jk>null</jk>.
+ */
+ public static String unEscapeChars(String s, char[] toEscape, char escapeChar) {
+ if (s == null) return null;
+ if (s.length() == 0 || toEscape == null || toEscape.length == 0 || escapeChar == 0) return s;
+ StringBuffer sb = new StringBuffer(s.length());
+ char[] sArray = s.toCharArray();
+ for (int i = 0; i < sArray.length; i++) {
+ char c = sArray[i];
+
+ if (c == escapeChar) {
+ if (i+1 != sArray.length) {
+ char c2 = sArray[i+1];
+ boolean isOneOf = false;
+ for (int j = 0; j < toEscape.length && ! isOneOf; j++)
+ isOneOf = (c2 == toEscape[j]);
+ if (isOneOf) {
+ i++;
+ } else if (c2 == escapeChar) {
+ sb.append(escapeChar);
+ i++;
+ }
+ }
+ }
+ sb.append(sArray[i]);
+ }
+ return sb.toString();
+ }
+
+ /**
+ * Debug method for rendering non-ASCII character sequences.
+ *
+ * @param s The string to decode.
+ * @return A string with non-ASCII characters converted to <js>"[hex]"</js> sequences.
+ */
+ public static String decodeHex(String s) {
+ if (s == null)
+ return null;
+ StringBuilder sb = new StringBuilder();
+ for (char c : s.toCharArray()) {
+ if (c < ' ' || c > '~')
+ sb.append("["+Integer.toHexString(c)+"]");
+ else
+ sb.append(c);
+ }
+ return sb.toString();
+ }
+
+ /**
+ * An efficient method for checking if a string starts with a character.
+ *
+ * @param s The string to check. Can be <jk>null</jk>.
+ * @param c The character to check for.
+ * @return <jk>true</jk> if the specified string is not <jk>null</jk> and starts with the specified character.
+ */
+ public static boolean startsWith(String s, char c) {
+ if (s != null) {
+ int i = s.length();
+ if (i > 0)
+ return s.charAt(0) == c;
+ }
+ return false;
+ }
+
+ /**
+ * An efficient method for checking if a string ends with a character.
+ *
+ * @param s The string to check. Can be <jk>null</jk>.
+ * @param c The character to check for.
+ * @return <jk>true</jk> if the specified string is not <jk>null</jk> and ends with the specified character.
+ */
+ public static boolean endsWith(String s, char c) {
+ if (s != null) {
+ int i = s.length();
+ if (i > 0)
+ return s.charAt(i-1) == c;
+ }
+ return false;
+ }
+
+ /**
+ * Tests two strings for equality, but gracefully handles nulls.
+ *
+ * @param s1 String 1.
+ * @param s2 String 2.
+ * @return <jk>true</jk> if the strings are equal.
+ */
+ public static boolean isEquals(String s1, String s2) {
+ if (s1 == null)
+ return s2 == null;
+ if (s2 == null)
+ return false;
+ return s1.equals(s2);
+ }
+
+ /**
+ * Shortcut for calling <code>base64Encode(in.getBytes(<js>"UTF-8"</js>))</code>
+ *
+ * @param in The input string to convert.
+ * @return The string converted to BASE-64 encoding.
+ */
+ public static String base64EncodeToString(String in) {
+ if (in == null)
+ return null;
+ return base64Encode(in.getBytes(IOUtils.UTF8));
+ }
+
+ /**
+ * BASE64-encodes the specified byte array.
+ *
+ * @param in The input byte array to convert.
+ * @return The byte array converted to a BASE-64 encoded string.
+ */
+ public static String base64Encode(byte[] in) {
+ int outLength = (in.length * 4 + 2) / 3; // Output length without padding
+ char[] out = new char[((in.length + 2) / 3) * 4]; // Length includes padding.
+ int iIn = 0;
+ int iOut = 0;
+ while (iIn < in.length) {
+ int i0 = in[iIn++] & 0xff;
+ int i1 = iIn < in.length ? in[iIn++] & 0xff : 0;
+ int i2 = iIn < in.length ? in[iIn++] & 0xff : 0;
+ int o0 = i0 >>> 2;
+ int o1 = ((i0 & 3) << 4) | (i1 >>> 4);
+ int o2 = ((i1 & 0xf) << 2) | (i2 >>> 6);
+ int o3 = i2 & 0x3F;
+ out[iOut++] = base64m1[o0];
+ out[iOut++] = base64m1[o1];
+ out[iOut] = iOut < outLength ? base64m1[o2] : '=';
+ iOut++;
+ out[iOut] = iOut < outLength ? base64m1[o3] : '=';
+ iOut++;
+ }
+ return new String(out);
+ }
+
+ /**
+ * Shortcut for calling <code>base64Decode(String)</code> and converting the
+ * result to a UTF-8 encoded string.
+ *
+ * @param in The BASE-64 encoded string to decode.
+ * @return The decoded string.
+ */
+ public static String base64DecodeToString(String in) {
+ byte[] b = base64Decode(in);
+ if (b == null)
+ return null;
+ return new String(b, IOUtils.UTF8);
+ }
+
+ /**
+ * BASE64-decodes the specified string.
+ *
+ * @param in The BASE-64 encoded string.
+ * @return The decoded byte array.
+ */
+ public static byte[] base64Decode(String in) {
+ if (in == null)
+ return null;
+
+ byte bIn[] = in.getBytes(IOUtils.UTF8);
+
+ if (bIn.length % 4 != 0)
+ illegalArg("Invalid BASE64 string length. Must be multiple of 4.");
+
+ // Strip out any trailing '=' filler characters.
+ int inLength = bIn.length;
+ while (inLength > 0 && bIn[inLength - 1] == '=')
+ inLength--;
+
+ int outLength = (inLength * 3) / 4;
+ byte[] out = new byte[outLength];
+ int iIn = 0;
+ int iOut = 0;
+ while (iIn < inLength) {
+ int i0 = bIn[iIn++];
+ int i1 = bIn[iIn++];
+ int i2 = iIn < inLength ? bIn[iIn++] : 'A';
+ int i3 = iIn < inLength ? bIn[iIn++] : 'A';
+ int b0 = base64m2[i0];
+ int b1 = base64m2[i1];
+ int b2 = base64m2[i2];
+ int b3 = base64m2[i3];
+ int o0 = (b0 << 2) | (b1 >>> 4);
+ int o1 = ((b1 & 0xf) << 4) | (b2 >>> 2);
+ int o2 = ((b2 & 3) << 6) | b3;
+ out[iOut++] = (byte)o0;
+ if (iOut < outLength)
+ out[iOut++] = (byte)o1;
+ if (iOut < outLength)
+ out[iOut++] = (byte)o2;
+ }
+ return out;
+ }
+
+ /**
+ * Generated a random UUID with the specified number of characters.
+ * Characters are composed of lower-case ASCII letters and numbers only.
+ * This method conforms to the restrictions for hostnames as specified in <a href='https://tools.ietf.org/html/rfc952'>RFC 952</a>
+ * Since each character has 36 possible values, the square approximation formula for
+ * the number of generated IDs that would produce a 50% chance of collision is:
+ * <code>sqrt(36^N)</code>.
+ * Dividing this number by 10 gives you an approximation of the number of generated IDs
+ * needed to produce a <1% chance of collision.
+ * For example, given 5 characters, the number of generated IDs need to produce a <1% chance of
+ * collision would be:
+ * <code>sqrt(36^5)/10=777</code>
+ *
+ * @param numchars The number of characters in the generated UUID.
+ * @return A new random UUID.
+ */
+ public static String generateUUID(int numchars) {
+ Random r = new Random();
+ StringBuilder sb = new StringBuilder(numchars);
+ for (int i = 0; i < numchars; i++) {
+ int c = r.nextInt(36) + 97;
+ if (c > 'z')
+ c -= ('z'-'0'+1);
+ sb.append((char)c);
+ }
+ return sb.toString();
+ }
+
+ /**
+ * Same as {@link String#trim()} but prevents <code>NullPointerExceptions</code>.
+ *
+ * @param s The string to trim.
+ * @return The trimmed string, or <jk>null</jk> if the string was <jk>null</jk>.
+ */
+ public static String trim(String s) {
+ if (s == null)
+ return null;
+ return s.trim();
+ }
+
+ /**
+ * Parses an ISO8601 string into a date.
+ *
+ * @param date The date string.
+ * @return The parsed date.
+ * @throws IllegalArgumentException
+ */
+ @SuppressWarnings("nls")
+ public static Date parseISO8601Date(String date) throws IllegalArgumentException {
+ if (isEmpty(date))
+ return null;
+ date = date.trim().replace(' ', 'T'); // Convert to 'standard' ISO8601
+ if (date.indexOf(',') != -1) // Trim milliseconds
+ date = date.substring(0, date.indexOf(','));
+ if (date.matches("\\d{4}"))
+ date += "-01-01T00:00:00";
+ else if (date.matches("\\d{4}\\-\\d{2}"))
+ date += "-01T00:00:00";
+ else if (date.matches("\\d{4}\\-\\d{2}\\-\\d{2}"))
+ date += "T00:00:00";
+ else if (date.matches("\\d{4}\\-\\d{2}\\-\\d{2}T\\d{2}"))
+ date += ":00:00";
+ else if (date.matches("\\d{4}\\-\\d{2}\\-\\d{2}T\\d{2}\\:\\d{2}"))
+ date += ":00";
+ return DatatypeConverter.parseDateTime(date).getTime();
+ }
+
+ /**
+ * Simple utility for replacing variables of the form <js>"{key}"</js> with values
+ * in the specified map.
+ * <p>
+ * Nested variables are supported in both the input string and map values.
+ * <p>
+ * If the map does not contain the specified value, the variable is not replaced.
+ * <p>
+ * <jk>null</jk> values in the map are treated as blank strings.
+ *
+ * @param s The string containing variables to replace.
+ * @param m The map containing the variable values.
+ * @return The new string with variables replaced, or the original string if it didn't have variables in it.
+ */
+ public static String replaceVars(String s, Map<String,Object> m) {
+
+ if (s.indexOf('{') == -1)
+ return s;
+
+ int S1 = 1; // Not in variable, looking for {
+ int S2 = 2; // Found {, Looking for }
+
+ int state = S1;
+ boolean hasInternalVar = false;
+ int x = 0;
+ int depth = 0;
+ int length = s.length();
+ StringBuilder out = new StringBuilder();
+ for (int i = 0; i < length; i++) {
+ char c = s.charAt(i);
+ if (state == S1) {
+ if (c == '{') {
+ state = S2;
+ x = i;
+ } else {
+ out.append(c);
+ }
+ } else /* state == S2 */ {
+ if (c == '{') {
+ depth++;
+ hasInternalVar = true;
+ } else if (c == '}') {
+ if (depth > 0) {
+ depth--;
+ } else {
+ String key = s.substring(x+1, i);
+ key = (hasInternalVar ? replaceVars(key, m) : key);
+ hasInternalVar = false;
+ if (! m.containsKey(key))
+ out.append('{').append(key).append('}');
+ else {
+ Object val = m.get(key);
+ if (val == null)
+ val = "";
+ String v = val.toString();
+ // If the replacement also contains variables, replace them now.
+ if (v.indexOf('{') != -1)
+ v = replaceVars(v, m);
+ out.append(v);
+ }
+ state = 1;
+ }
+ }
+ }
+ }
+ return out.toString();
+ }
+
+ /**
+ * Returns <jk>true</jk> if the specified path string is prefixed with the specified prefix.
+ * <p>
+ * Examples:
+ * <p class='bcode'>
+ * pathStartsWith(<js>"foo"</js>, <js>"foo"</js>); <jc>// true</jc>
+ * pathStartsWith(<js>"foo/bar"</js>, <js>"foo"</js>); <jc>// true</jc>
+ * pathStartsWith(<js>"foo2"</js>, <js>"foo"</js>); <jc>// false</jc>
+ * pathStartsWith(<js>"foo2"</js>, <js>""</js>); <jc>// false</jc>
+ * </p>
+ *
+ * @param path The path to check.
+ * @param pathPrefix The prefix.
+ * @return <jk>true</jk> if the specified path string is prefixed with the specified prefix.
+ */
+ public static boolean pathStartsWith(String path, String pathPrefix) {
+ if (path == null || pathPrefix == null)
+ return false;
+ if (path.startsWith(pathPrefix))
+ return path.length() == pathPrefix.length() || path.charAt(pathPrefix.length()) == '/';
+ return false;
+ }
+
+ /**
+ * Same as {@link #pathStartsWith(String, String)} but returns <jk>true</jk> if at least one prefix matches.
+ * <p>
+ *
+ * @param path The path to check.
+ * @param pathPrefixes The prefixes.
+ * @return <jk>true</jk> if the specified path string is prefixed with any of the specified prefixes.
+ */
+ public static boolean pathStartsWith(String path, String[] pathPrefixes) {
+ for (String p : pathPrefixes)
+ if (pathStartsWith(path, p))
+ return true;
+ return false;
+ }
+}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVar.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVar.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVar.class
new file mode 100755
index 0000000..3aa5049
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVar.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVar.java
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVar.java b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVar.java
new file mode 100755
index 0000000..c09e88b
--- /dev/null
+++ b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVar.java
@@ -0,0 +1,37 @@
+/*******************************************************************************
+ * Licensed Materials - Property of IBM
+ * (c) Copyright IBM Corporation 2014, 2015. All Rights Reserved.
+ *
+ * The source code for this program is not published or otherwise
+ * divested of its trade secrets, irrespective of what has been
+ * deposited with the U.S. Copyright Office.
+ *******************************************************************************/
+package com.ibm.juno.core.utils;
+
+/**
+ * Interface for the resolution of string variables using the {@link StringVarResolver} API.
+ *
+ * @author jbognar
+ */
+public abstract class StringVar {
+
+ /**
+ * The method called from {@link StringVarResolver}.
+ * Can be overridden to intercept the request and do special handling.
+ * Default implementation simply calls resolve(String).
+ *
+ * @param arg The inside argument of the variable.
+ * @return The resolved value.
+ */
+ protected String doResolve(String arg) {
+ return resolve(arg);
+ }
+
+ /**
+ * The interface that needs to be implemented for string vars.
+ *
+ * @param arg The inside argument of the variable.
+ * @return The resolved value.
+ */
+ public abstract String resolve(String arg);
+}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarMultipart.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarMultipart.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarMultipart.class
new file mode 100755
index 0000000..3d6cef6
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarMultipart.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarMultipart.java
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarMultipart.java b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarMultipart.java
new file mode 100755
index 0000000..5f9b8be
--- /dev/null
+++ b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarMultipart.java
@@ -0,0 +1,32 @@
+/*******************************************************************************
+ * Licensed Materials - Property of IBM
+ * (c) Copyright IBM Corporation 2015. All Rights Reserved.
+ *
+ * The source code for this program is not published or otherwise
+ * divested of its trade secrets, irrespective of what has been
+ * deposited with the U.S. Copyright Office.
+ *******************************************************************************/
+package com.ibm.juno.core.utils;
+
+
+/**
+ * Interface for the resolution of string vars that consist of a comma-delimited list.
+ * <p>
+ * (e.g. <js>"$X{foo, bar, baz}"</js>)
+ */
+public abstract class StringVarMultipart extends StringVar {
+
+ /**
+ * The interface that needs to be implemented for this interface.
+ *
+ * @param args The arguments inside the variable.
+ * @return The resolved variable.
+ */
+ public abstract String resolve(String[] args);
+
+ @Override /* StringVar*/
+ public String resolve(String s) {
+ String[] s2 = s.indexOf(',') == -1 ? new String[]{s} : StringUtils.split(s, ',');
+ return resolve(s2);
+ }
+}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver$1.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver$1.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver$1.class
new file mode 100755
index 0000000..91f4947
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver$1.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver$2.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver$2.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver$2.class
new file mode 100755
index 0000000..18f9577
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver$2.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver.class
new file mode 100755
index 0000000..f65f3b7
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver.java
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver.java b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver.java
new file mode 100755
index 0000000..5abffd7
--- /dev/null
+++ b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarResolver.java
@@ -0,0 +1,357 @@
+/*******************************************************************************
+ * Licensed Materials - Property of IBM
+ * (c) Copyright IBM Corporation 2014, 2015. All Rights Reserved.
+ *
+ * The source code for this program is not published or otherwise
+ * divested of its trade secrets, irrespective of what has been
+ * deposited with the U.S. Copyright Office.
+ *******************************************************************************/
+package com.ibm.juno.core.utils;
+
+import static com.ibm.juno.core.utils.StringUtils.*;
+import static com.ibm.juno.core.utils.ThrowableUtils.*;
+
+import java.io.*;
+import java.util.*;
+
+/**
+ * Utility class for resolving variables of the form <code>$X{key}</code> in strings.
+ * <p>
+ * This class implements the following two methods for resolving variables in strings:
+ * <ul>
+ * <li>{@link #resolve(String)} - Returns a new string with variables replaced.
+ * <li>{@link #writeTo(String,Writer)} - Resolves variables in the string and sends the result to the writer.
+ * </ul>
+ * <p>
+ * Variables are of the form <code>$X{key}</code>, where <code>X</code> can consist of zero or more ASCII characters.<br>
+ * The variable key can contain anything, even nested variables that get recursively resolved.
+ * <p>
+ * Variable types are defined through the {@link #addVar(String, StringVar)} method.
+ * <p>
+ * The {@link StringVar} interface defines a simple method for replacing a variable key with a value.
+ * <p>
+ * <h6 class='topic'>Example:</h6>
+ * <p class='bcode'>
+ * <jc>// Create a variable resolver that resolves system properties (e.g. "$S{java.home}")</jc>
+ * StringVarResolver r = <jk>new</jk> StringVarResolver()
+ * .addVar(<js>"S"</js>, <jk>new</jk> StringVar() {
+ * <ja>@Override</ja>
+ * <jk>public</jk> String resolve(String varVal) {
+ * <jk>return</jk> System.<jsm>getProperty</jsm>(varVal);
+ * }
+ * });
+ *
+ * System.<jsf>out</jsf>.println(r.resolve(<js>"java.home is set to $S{java.home}"</js>));
+ * </p>
+ * <p>
+ * Subclasses of {@link StringVar} are provided for special purposes:
+ * <ul>
+ * <li>{@link StringVarMultipart} - Interface for the resolution of vars that consist of a comma-delimited list (e.g. <js>"$X{foo, bar, baz}"</js>)
+ * <li>{@link StringVarWithDefault} - Interface for the resolution of vars with a default value if the <code>resolve(String)</code> method returns <jk>null</jk> (e.g. <js>"$S{myProperty,not found}"</js>).
+ * </ul>
+ * <p>
+ * The {@link #DEFAULT} instance is a reusable variable resolver that includes support for system properties and environment variables.
+ * <p>
+ * <code>StringVarResolvers</code> can be extended by using the {@link #StringVarResolver(StringVarResolver)} constructor.
+ * <p>
+ * <h6 class='topic'>Example:</h6>
+ * <p class='bcode'>
+ * <jc>// Create a var resolver that extends the default resolver and appends our own "$URLEncode{...}" variable</jc>
+ * StringVarResolver r = <jk>new</jk> StringVarResolver(StringVarResolver.<jsf>DEFAULT</jsf>)
+ * .addVar(<js>"URLEncode"</js>, <jk>new</jk> StringVar() {
+ * <ja>@Override</ja>
+ * <jk>public</jk> String resolve(String varVal) {
+ * <jk>return</jk> URLEncoder.<jsm>encode</jsm>(varVal, <js>"UTF-8"</js>);
+ * }
+ * });
+ *
+ * <jc>// Retrieve a system property and URL-encode it if necessary.</jc>
+ * String myProperty = r.resolve(<js>"$URLEncode{$S{my.property}}"</js>);
+ * <p>
+ * Variables can be nested arbitrarily deep.
+ * <p>
+ * <h6 class='topic'>Example:</h6>
+ * <p class='bcode'>
+ * <jc>// Look up a property in the following order:
+ * // 1) MYPROPERTY environment variable.
+ * // 2) 'my.property' system property if environment variable not found.
+ * // 3) 'not found' string if system property not found.</jc>
+ * String myproperty = StringVarResolver.<jsf>DEFAULT</jsf>.resolve(<js>"$E{MYPROPERTY,$S{my.property,not found}}"</js>);
+ * </p>
+ * <p>
+ * Resolved variables can also contain variables.
+ * <p class='bcode'>
+ * <jc>// If MYPROPERTY is "$S{my.property}", and the system property "my.property" is "foo",
+ * // then the following resolves to "foo".</jc>
+ * String myproperty = StringVarResolver.<jsf>DEFAULT</jsf>.resolve(<js>"$E{MYPROPERTY}"</js>);
+ * </p>
+ * <p>
+ * <h6 class='topic'>Other notes:</h6>
+ * <ul class='spaced-list'>
+ * <li>The escape character <js>'\'</js> can be used when necessary to escape the following characters: <code>$ , { }</code>
+ * <li><b>WARNING:</b> It is possible to cause {@link StackOverflowError StackOverflowErrors} if your nested variables result in
+ * a recursive loop (e.g. the environment variable <code>'MYPROPERTY'</code> has the value <code>'$E{MYPROPERTY}'</code>).
+ * So don't do that!
+ * <li>As a general rule, this class tries to be as efficient as possible by not creating new strings when not needed.<br>
+ * For example, calling the resolve method on a string that doesn't contain variables (e.g. <code>resolver.resolve(<js>"foobar"</js>)</code>)
+ * will simply be a no-op and return the same string.
+ *
+ *
+ * @author James Bognar (jbognar@us.ibm.com)
+ */
+public class StringVarResolver {
+
+ /**
+ * Default string variable resolver with support for system properties and environment variables:
+ * <p>
+ * <ul>
+ * <li><code>$S{key}</code>,<code>$S{key,default}</code> - System properties.
+ * <li><code>$E{key}</code>,<code>$E{key,default}</code> - Environment variables.
+ * </ul>
+ */
+ public static final StringVarResolver DEFAULT = new StringVarResolver()
+ // System properties.
+ .addVar("S", new StringVarWithDefault() {
+ @Override /* StringVar */
+ public String resolve(String varVal) {
+ return System.getProperty(varVal);
+ }
+ })
+ // Environment variables.
+ .addVar("E", new StringVarWithDefault() {
+ @Override /* StringVar */
+ public String resolve(String varVal) {
+ return System.getenv(varVal);
+ }
+ })
+ ;
+
+ // Map of Vars added through addVar() method.
+ private Map<String,StringVar> varMap = new TreeMap<String,StringVar>();
+
+ private StringVarResolver parent;
+
+ /**
+ * Construct an empty var resolver.
+ */
+ public StringVarResolver() {}
+
+ /**
+ * Construct an empty var resolver with the specified parent.
+ *
+ * @param parent The parent string variable resolver. Can be <jk>null</jk>.
+ */
+ public StringVarResolver(StringVarResolver parent) {
+ this.parent = parent;
+ }
+
+ /**
+ * Register a new variable with this resolver.
+ *
+ * @param varName The variable name (e.g. <js>"X"</js> resolves <js>"$X{...}"</js> variables).
+ * @param v The variable resolver.
+ * @return This object (for method chaining).
+ */
+ public StringVarResolver addVar(String varName, StringVar v) {
+ assertFieldNotNull(v, "v");
+
+ // Need to make sure only ASCII characters are used.
+ for (int i = 0; i < varName.length(); i++) {
+ char c = varName.charAt(i);
+ if (c < 'A' || c > 'z' || (c > 'Z' && c < 'a'))
+ illegalArg("Invalid var name. Must consist of only uppercase and lowercase ASCII letters.");
+ }
+ varMap.put(varName, v);
+ return this;
+ }
+
+ /**
+ * Resolve all variables in the specified string.
+ *
+ * @param s The string to resolve variables in.
+ * @return The new string with all variables resolved, or the same string if no variables were found.
+ * Null input results in a blank string.
+ */
+ public String resolve(String s) {
+
+ if (s == null)
+ return "";
+ if (s.indexOf('$') == -1 && s.indexOf('\\') == -1)
+ return s;
+
+ // Special case where value consists of a single variable with no embedded variables (e.g. "$X{...}").
+ // This is a common case, so we want an optimized solution that doesn't involve string builders.
+ if (isSimpleVar(s)) {
+ String var = s.substring(1, s.indexOf('{'));
+ String val = s.substring(s.indexOf('{')+1, s.length()-1);
+ StringVar v = getVar(var);
+ if (v != null) {
+ s = v.doResolve(val);
+ return resolve(s);
+ }
+ return s;
+ }
+
+ try {
+ return writeTo(s, new StringWriter()).toString();
+ } catch (IOException e) {
+ throw new RuntimeException(e); // Never happens.
+ }
+ }
+
+ /**
+ * Checks to see if string is of the simple form "$X{...}" with no embedded variables.
+ * This is a common case, and we can avoid using StringWriters.
+ */
+ private boolean isSimpleVar(String s) {
+ int S1 = 1; // Not in variable, looking for $
+ int S2 = 2; // Found $, Looking for {
+ int S3 = 3; // Found {, Looking for }
+ int S4 = 4; // Found }
+
+ int length = s.length();
+ int state = S1;
+ for (int i = 0; i < length; i++) {
+ char c = s.charAt(i);
+ if (state == S1) {
+ if (c == '$') {
+ state = S2;
+ } else {
+ return false;
+ }
+ } else if (state == S2) {
+ if (c == '{') {
+ state = S3;
+ } else if (c < 'A' || c > 'z' || (c > 'Z' && c < 'a')) { // False trigger "$X "
+ return false;
+ }
+ } else if (state == S3) {
+ if (c == '}')
+ state = S4;
+ else if (c == '{' || c == '$')
+ return false;
+ } else if (state == S4) {
+ return false;
+ }
+ }
+ return state == S4;
+ }
+
+ /**
+ * Resolves variables in the specified string and sends the output to the specified writer.
+ * More efficient than first parsing to a string and then serializing to the writer since this
+ * method doesn't need to construct a large string.
+ *
+ * @param s The string to resolve variables in.
+ * @param out The writer to write to.
+ * @return The same writer.
+ * @throws IOException
+ */
+ public Writer writeTo(String s, Writer out) throws IOException {
+
+ int S1 = 1; // Not in variable, looking for $
+ int S2 = 2; // Found $, Looking for {
+ int S3 = 3; // Found {, Looking for }
+
+ int state = S1;
+ boolean isInEscape = false;
+ boolean hasInternalVar = false;
+ boolean hasInnerEscapes = false;
+ String varType = null;
+ String varVal = null;
+ int x = 0, x2 = 0;
+ int depth = 0;
+ int length = s.length();
+ for (int i = 0; i < length; i++) {
+ char c = s.charAt(i);
+ if (state == S1) {
+ if (isInEscape) {
+ if (c == '\\' || c == '$') {
+ out.append(c);
+ } else {
+ out.append('\\').append(c);
+ }
+ isInEscape = false;
+ } else if (c == '\\') {
+ isInEscape = true;
+ } else if (c == '$') {
+ x = i;
+ x2 = i;
+ state = S2;
+ } else {
+ out.append(c);
+ }
+ } else if (state == S2) {
+ if (isInEscape) {
+ isInEscape = false;
+ } else if (c == '\\') {
+ hasInnerEscapes = true;
+ isInEscape = true;
+ } else if (c == '{') {
+ varType = s.substring(x+1, i);
+ x = i;
+ state = S3;
+ } else if (c < 'A' || c > 'z' || (c > 'Z' && c < 'a')) { // False trigger "$X "
+ if (hasInnerEscapes)
+ out.append(unEscapeChars(s.substring(x, i+1), new char[]{'\\','{'}));
+ else
+ out.append(s, x, i+1);
+ x = i + 1;
+ state = S1;
+ hasInnerEscapes = false;
+ }
+ } else if (state == S3) {
+ if (isInEscape) {
+ isInEscape = false;
+ } else if (c == '\\') {
+ isInEscape = true;
+ hasInnerEscapes = true;
+ } else if (c == '{') {
+ depth++;
+ hasInternalVar = true;
+ } else if (c == '}') {
+ if (depth > 0) {
+ depth--;
+ } else {
+ varVal = s.substring(x+1, i);
+ varVal = (hasInternalVar ? resolve(varVal) : varVal);
+ StringVar r = getVar(varType);
+ if (r == null) {
+ if (hasInnerEscapes)
+ out.append(unEscapeChars(s.substring(x2, i+1), new char[]{'\\','$','{','}'}));
+ else
+ out.append(s, x2, i+1);
+ x = i+1;
+ } else {
+ String replacement = r.doResolve(varVal);
+ if (replacement == null)
+ replacement = "";
+ // If the replacement also contains variables, replace them now.
+ if (replacement.indexOf('$') != -1)
+ replacement = resolve(replacement);
+ out.append(replacement);
+ x = i+1;
+ }
+ state = 1;
+ hasInnerEscapes = false;
+ }
+ }
+ }
+ }
+ if (isInEscape)
+ out.append("\\");
+ else if (state == S2)
+ out.append("$").append(unEscapeChars(s.substring(x+1), new char[]{'{', '\\'}));
+ else if (state == S3)
+ out.append("$").append(varType).append('{').append(unEscapeChars(s.substring(x+1), new char[]{'\\','$','{','}'}));
+ return out;
+ }
+
+ private StringVar getVar(String varType) {
+ StringVar v = varMap.get(varType);
+ if (v == null && parent != null)
+ v = parent.getVar(varType);
+ return v;
+ }
+}
+
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarWithDefault.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarWithDefault.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarWithDefault.class
new file mode 100755
index 0000000..901efeb
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarWithDefault.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarWithDefault.java
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarWithDefault.java b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarWithDefault.java
new file mode 100755
index 0000000..e1f63eb
--- /dev/null
+++ b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/StringVarWithDefault.java
@@ -0,0 +1,31 @@
+/*******************************************************************************
+ * Licensed Materials - Property of IBM
+ * (c) Copyright IBM Corporation 2015. All Rights Reserved.
+ *
+ * The source code for this program is not published or otherwise
+ * divested of its trade secrets, irrespective of what has been
+ * deposited with the U.S. Copyright Office.
+ *******************************************************************************/
+package com.ibm.juno.core.utils;
+
+
+/**
+ * Interface for the resolution of string vars with a default value if the <code>resolve(String)</code> method returns <jk>null</jk>.
+ * <p>
+ * For example, to resolve the system property <js>"myProperty"</js> but resolve to <js>"not found"</js> if the property doesn't exist:
+ * <js>"$S{myProperty,not found}"</js>
+ */
+public abstract class StringVarWithDefault extends StringVar {
+
+ @Override /* StringVar*/
+ public String doResolve(String s) {
+ int i = s.indexOf(',');
+ if (i == -1)
+ return resolve(s);
+ String[] s2 = StringUtils.split(s, ',');
+ String v = resolve(s2[0]);
+ if (v == null)
+ v = s2[1];
+ return v;
+ }
+}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream$1.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream$1.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream$1.class
new file mode 100755
index 0000000..6ca8b6e
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream$1.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream$NoCloseOutputStream.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream$NoCloseOutputStream.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream$NoCloseOutputStream.class
new file mode 100755
index 0000000..d759a42
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream$NoCloseOutputStream.class differ
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/7e4f63e6/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream.class b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream.class
new file mode 100755
index 0000000..edffdca
Binary files /dev/null and b/com.ibm.team.juno.releng/bin/core/com/ibm/juno/core/utils/TeeOutputStream.class differ