fabric.common

Class SysUtil

java.lang.Object

fabric.common.SysUtil

public final class SysUtil
extends java.lang.Object

Convenience class containing generally useful methods such as functional programming idioms and hashing methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SysUtil.Thunk<T> A Thunk represents a delayed execution resulting in type T.

Constructor Summary

Constructors

Constructor and Description
SysUtil()

Method Summary

Modifier and Type	Method and Description
static <T> java.lang.Iterable<T>	chain(java.lang.Iterable<T>... iters) Returns an iterable that iterates over the elements of the iterables passed in.
static java.lang.Object	deserialize(byte[] bytes) Turns an array of bytes into an object using Java serialization.
static java.lang.Class<? extends Object._Impl>	getImplClass(java.lang.Class<? extends Object> clazz) Returns the _Impl class for the given Fabric class.
static java.lang.String	getNodeCN(java.lang.String nodeName, long principalOnum)
static java.lang.String	getNodeName(java.lang.String nodeCN)
static long	getPrincipalOnum(java.lang.String nodeCN)
static byte[]	hashFClass(ClassRef.FabricClassRef fcr) Returns the class hash for the Fabric class referred by the given FabricClassRef.
static byte[]	hashPlatformClass(java.lang.Class<?> c) Generates a cryptographically secure hash of a platform class.
static java.net.URL	locateClass(java.lang.String className)
static byte[]	serialize(java.lang.Object obj) Turns an object into an array of bytes using Java serialization.

Methods inherited from class java.lang.Object

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

Constructor Detail

SysUtil

public SysUtil()

Method Detail

getNodeCN

public static java.lang.String getNodeCN(java.lang.String nodeName,
                                         long principalOnum)

getPrincipalOnum

public static long getPrincipalOnum(java.lang.String nodeCN)

getNodeName

public static java.lang.String getNodeName(java.lang.String nodeCN)

hashPlatformClass

public static byte[] hashPlatformClass(java.lang.Class<?> c)
                                throws java.io.IOException

Generates a cryptographically secure hash of a platform class.

Parameters:

c - the Class object for a class that is not stored in Fabric. If it's a Fabric class, this is the interface corresponding to the Fabric type, and not the _Proxy or _Impl classes.

Throws:

java.io.IOException

hashFClass

public static byte[] hashFClass(ClassRef.FabricClassRef fcr)

Returns the class hash for the Fabric class referred by the given FabricClassRef.

getImplClass

public static java.lang.Class<? extends Object._Impl> getImplClass(java.lang.Class<? extends Object> clazz)

Returns the _Impl class for the given Fabric class.

Parameters:

clazz - the Class object for a Fabric class. This is the interface corresponding to the Fabric type, and not the _Proxy or _Impl classes.

Returns:

the _Impl corresponding to clazz. If no _Impl class is found (i.e., clazz represents a Fabric interface), null is returned.

locateClass

public static java.net.URL locateClass(java.lang.String className)
                                throws java.lang.ClassNotFoundException

Throws:

java.lang.ClassNotFoundException

chain

@SafeVarargs
public static <T> java.lang.Iterable<T> chain(java.lang.Iterable<T>... iters)

Returns an iterable that iterates over the elements of the iterables passed in. The common use is:

 for (T o : Utils.chain(a, b, c))
  o.f()
 

which will call f() on each element of a, then each element of b, then each element of c.

This is intended to be more efficient and easier than creating a new collection containing the contents.

Type Parameters:

T - the types of the elements of the iterables

Parameters:

iters - the iterables to chain

Returns:

an object that can be used to traverse iters in order

serialize

public static byte[] serialize(java.lang.Object obj)
                        throws java.io.IOException

Turns an object into an array of bytes using Java serialization.

Throws:

java.io.IOException

deserialize

public static java.lang.Object deserialize(byte[] bytes)
                                    throws java.io.IOException,
                                           java.lang.ClassNotFoundException

Turns an array of bytes into an object using Java serialization.

Throws:

java.io.IOException

java.lang.ClassNotFoundException