io.apigee.trireme.core

Class Utils

java.lang.Object

io.apigee.trireme.core.Utils

public class Utils
extends Object

A few utility functions, mainly for Rhino, that are useful when writing Node modules in Java.

Constructor Summary

Constructors

Constructor and Description
Utils()

Method Summary

Methods

Modifier and Type	Method and Description
static String	bufferToString(ByteBuffer[] bufs, Charset cs) Like bufferToString, but read multiple buffers.
static String	bufferToString(ByteBuffer buf, Charset cs) Using a CharsetDecoder, translate the ByteBuffer into a stream, updating the buffer's position as we go.
static ByteBuffer	catBuffers(ByteBuffer b1, ByteBuffer b2) Concatenate two byte buffers into one, updating their position.
static ByteBuffer	doubleBuffer(ByteBuffer b) Double the capacity of the specified buffer so that more data may be added.
static CharBuffer	doubleBuffer(CharBuffer b) Double the capacity of the specified buffer so that more data may be added.
static ByteBuffer	duplicateBuffer(ByteBuffer b) Make a duplicate of a ByteBuffer.
static Method	findMethod(Class<?> klass, String name) Given a class, find the first method named "name".
static org.mozilla.javascript.RhinoException	makeError(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, int code)
static org.mozilla.javascript.RhinoException	makeError(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, NodeOSException e) Create an exception that may be thrown from Java code, causing an exception and an Error object to be thrown in JavaScript.
static org.mozilla.javascript.RhinoException	makeError(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, OSException e) Create an exception that may be thrown from Java code, causing an exception and an Error object to be thrown in JavaScript.
static org.mozilla.javascript.RhinoException	makeError(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message) Create an exception that may be thrown from Java code, causing an exception and an Error object to be thrown in JavaScript.
static org.mozilla.javascript.RhinoException	makeError(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message, int code)
static org.mozilla.javascript.RhinoException	makeError(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message, int code, String path)
static org.mozilla.javascript.RhinoException	makeError(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message, org.mozilla.javascript.RhinoException re) Create an exception that may be thrown from Java code, causing an exception and an Error object to be thrown in JavaScript.
static org.mozilla.javascript.RhinoException	makeError(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message, String code) Create an exception that may be thrown from Java code, causing an exception and an Error object to be thrown in JavaScript.
static org.mozilla.javascript.Scriptable	makeErrorObject(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, int code)
static org.mozilla.javascript.Scriptable	makeErrorObject(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, NodeOSException e) Create a JavaScript Error object, which may be passed to a function that is expecting one.
static org.mozilla.javascript.Scriptable	makeErrorObject(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, OSException e) Create a JavaScript Error object, which may be passed to a function that is expecting one.
static org.mozilla.javascript.Scriptable	makeErrorObject(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message) Create a JavaScript Error object, which may be passed to a function that is expecting one.
static org.mozilla.javascript.Scriptable	makeErrorObject(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message, int code)
static org.mozilla.javascript.Scriptable	makeErrorObject(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message, int code, String path)
static org.mozilla.javascript.Scriptable	makeErrorObject(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message, org.mozilla.javascript.RhinoException re) Create a JavaScript Error object, which may be passed to a function that is expecting one.
static org.mozilla.javascript.Scriptable	makeErrorObject(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message, String code) Create a JavaScript Error object, which may be passed to a function that is expecting one.
static org.mozilla.javascript.Scriptable	makeErrorObject(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message, String code, String path) Create a JavaScript Error object, which may be passed to a function that is expecting one.
static org.mozilla.javascript.RhinoException	makeRangeError(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message) Create a JavaScript RangeError object, which may be passed to a function that is expecting one.
static org.mozilla.javascript.RhinoException	makeTypeError(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, String message) Create a JavaScript TypeError object, which may be passed to a function that is expecting one.
static String	readFile(File f) Read an entire file into a single string, and interpret it as UTF-8.
static String	readStream(InputStream in) Read an entire input stream into a single string, and interpret it as UTF-8.
static ByteBuffer	stringToBuffer(String str, Charset cs) Using a CharsetEncoder, translate a string to a ByteBuffer, allocating a new buffer as necessary.
static List<String>	toStringList(org.mozilla.javascript.Scriptable o) Convert each value in the JavaScript object to a string array element.
static String	unquote(String s) Remove leading and trailing strings from a quoted string that has both leading and trailing quotes on it.
static void	zeroBuffer(ByteBuffer b) Fill a ByteBuffer with zeros, useful if it has been used to store a password or something.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Utils

public Utils()

Method Detail

readStream

public static String readStream(InputStream in)
                         throws IOException

Read an entire input stream into a single string, and interpret it as UTF-8.

Throws:

IOException

readFile

public static String readFile(File f)
                       throws IOException

Read an entire file into a single string, and interpret it as UTF-8.

Throws:

IOException

findMethod

public static Method findMethod(Class<?> klass,
                String name)

Given a class, find the first method named "name". Since this doesn't handle operator overloading, it should be handled with care.

bufferToString

public static String bufferToString(ByteBuffer buf,
                    Charset cs)

Using a CharsetDecoder, translate the ByteBuffer into a stream, updating the buffer's position as we go. Unmappable characters and incomplete input characters will be replaced by Java's standard replacement value.

bufferToString

public static String bufferToString(ByteBuffer[] bufs,
                    Charset cs)

Like bufferToString, but read multiple buffers. Unmappable characters and incomplete input characters will be replaced by Java's standard replacement value.

stringToBuffer

public static ByteBuffer stringToBuffer(String str,
                        Charset cs)

Using a CharsetEncoder, translate a string to a ByteBuffer, allocating a new buffer as necessary. Unmappable characters and incomplete input characters will be replaced by Java's standard replacement value.

makeErrorObject

public static org.mozilla.javascript.Scriptable makeErrorObject(org.mozilla.javascript.Context cx,
                                                org.mozilla.javascript.Scriptable scope,
                                                String message)

Create a JavaScript Error object, which may be passed to a function that is expecting one.

makeErrorObject

public static org.mozilla.javascript.Scriptable makeErrorObject(org.mozilla.javascript.Context cx,
                                                org.mozilla.javascript.Scriptable scope,
                                                String message,
                                                org.mozilla.javascript.RhinoException re)

Create a JavaScript Error object, which may be passed to a function that is expecting one.

makeError

public static org.mozilla.javascript.RhinoException makeError(org.mozilla.javascript.Context cx,
                                              org.mozilla.javascript.Scriptable scope,
                                              String message)

Create an exception that may be thrown from Java code, causing an exception and an Error object to be thrown in JavaScript.

makeError

public static org.mozilla.javascript.RhinoException makeError(org.mozilla.javascript.Context cx,
                                              org.mozilla.javascript.Scriptable scope,
                                              String message,
                                              org.mozilla.javascript.RhinoException re)

Create an exception that may be thrown from Java code, causing an exception and an Error object to be thrown in JavaScript.

makeErrorObject

public static org.mozilla.javascript.Scriptable makeErrorObject(org.mozilla.javascript.Context cx,
                                                org.mozilla.javascript.Scriptable scope,
                                                String message,
                                                String code)

Create a JavaScript Error object, which may be passed to a function that is expecting one.

makeErrorObject

public static org.mozilla.javascript.Scriptable makeErrorObject(org.mozilla.javascript.Context cx,
                                                org.mozilla.javascript.Scriptable scope,
                                                String message,
                                                String code,
                                                String path)

Create a JavaScript Error object, which may be passed to a function that is expecting one.

Parameters:

code - this will be used to set the "code" property of the new object. "errno" will also be set if the code is a known error code from the "ErrorCodes" class.

path - this will be used to set the "path" property of the new object

makeErrorObject

public static org.mozilla.javascript.Scriptable makeErrorObject(org.mozilla.javascript.Context cx,
                                                org.mozilla.javascript.Scriptable scope,
                                                String message,
                                                int code,
                                                String path)

makeError

public static org.mozilla.javascript.RhinoException makeError(org.mozilla.javascript.Context cx,
                                              org.mozilla.javascript.Scriptable scope,
                                              String message,
                                              int code,
                                              String path)

makeErrorObject

public static org.mozilla.javascript.Scriptable makeErrorObject(org.mozilla.javascript.Context cx,
                                                org.mozilla.javascript.Scriptable scope,
                                                String message,
                                                int code)

makeError

public static org.mozilla.javascript.RhinoException makeError(org.mozilla.javascript.Context cx,
                                              org.mozilla.javascript.Scriptable scope,
                                              String message,
                                              int code)

makeErrorObject

public static org.mozilla.javascript.Scriptable makeErrorObject(org.mozilla.javascript.Context cx,
                                                org.mozilla.javascript.Scriptable scope,
                                                int code)

makeError

public static org.mozilla.javascript.RhinoException makeError(org.mozilla.javascript.Context cx,
                                              org.mozilla.javascript.Scriptable scope,
                                              int code)

makeError

public static org.mozilla.javascript.RhinoException makeError(org.mozilla.javascript.Context cx,
                                              org.mozilla.javascript.Scriptable scope,
                                              String message,
                                              String code)

Create an exception that may be thrown from Java code, causing an exception and an Error object to be thrown in JavaScript.

makeError

public static org.mozilla.javascript.RhinoException makeError(org.mozilla.javascript.Context cx,
                                              org.mozilla.javascript.Scriptable scope,
                                              NodeOSException e)

Create an exception that may be thrown from Java code, causing an exception and an Error object to be thrown in JavaScript.

makeError

public static org.mozilla.javascript.RhinoException makeError(org.mozilla.javascript.Context cx,
                                              org.mozilla.javascript.Scriptable scope,
                                              OSException e)

Create an exception that may be thrown from Java code, causing an exception and an Error object to be thrown in JavaScript.

makeErrorObject

public static org.mozilla.javascript.Scriptable makeErrorObject(org.mozilla.javascript.Context cx,
                                                org.mozilla.javascript.Scriptable scope,
                                                NodeOSException e)

Create a JavaScript Error object, which may be passed to a function that is expecting one.

makeErrorObject

public static org.mozilla.javascript.Scriptable makeErrorObject(org.mozilla.javascript.Context cx,
                                                org.mozilla.javascript.Scriptable scope,
                                                OSException e)

Create a JavaScript Error object, which may be passed to a function that is expecting one.

makeRangeError

public static org.mozilla.javascript.RhinoException makeRangeError(org.mozilla.javascript.Context cx,
                                                   org.mozilla.javascript.Scriptable scope,
                                                   String message)

Create a JavaScript RangeError object, which may be passed to a function that is expecting one.

makeTypeError

public static org.mozilla.javascript.RhinoException makeTypeError(org.mozilla.javascript.Context cx,
                                                  org.mozilla.javascript.Scriptable scope,
                                                  String message)

Create a JavaScript TypeError object, which may be passed to a function that is expecting one.

toStringList

public static List<String> toStringList(org.mozilla.javascript.Scriptable o)

Convert each value in the JavaScript object to a string array element. This is used to process an array of strings from JavaScript.

catBuffers

public static ByteBuffer catBuffers(ByteBuffer b1,
                    ByteBuffer b2)

Concatenate two byte buffers into one, updating their position. This method is very flexible in that either or both, buffer may be null.

doubleBuffer

public static CharBuffer doubleBuffer(CharBuffer b)

Double the capacity of the specified buffer so that more data may be added.

doubleBuffer

public static ByteBuffer doubleBuffer(ByteBuffer b)

Double the capacity of the specified buffer so that more data may be added.

zeroBuffer

public static void zeroBuffer(ByteBuffer b)

Fill a ByteBuffer with zeros, useful if it has been used to store a password or something.

duplicateBuffer

public static ByteBuffer duplicateBuffer(ByteBuffer b)

Make a duplicate of a ByteBuffer.

unquote

public static String unquote(String s)

Remove leading and trailing strings from a quoted string that has both leading and trailing quotes on it.