io.apigee.trireme.kernel

Class PathTranslator

java.lang.Object

io.apigee.trireme.kernel.PathTranslator

public class PathTranslator
extends Object

This class performs a "chroot." Given a root path, it translates all paths relative to that root. If a translated path would be "above" that root, then it simply returns null.

Constructor Summary

Constructors

Constructor and Description
PathTranslator()
PathTranslator(String root)

Method Summary

Methods

Modifier and Type	Method and Description
String	getRoot()
void	mount(String prefix, File path) Mount an actual filesystem path on the virtual file system.
String	reverseTranslate(String path) Convert a native (Java) path to a Node.js path based on the root.
void	setRoot(String root)
void	setWorkingDir(String wd)
File	translate(String pathStr) Convert a Node.js path to a native (Java) path based on the specified root.

Methods inherited from class java.lang.Object

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

Constructor Detail

PathTranslator

public PathTranslator()

PathTranslator

public PathTranslator(String root)
               throws IOException

Throws:

IOException

Method Detail

setWorkingDir

public void setWorkingDir(String wd)

setRoot

public void setRoot(String root)
             throws IOException

Throws:

IOException

getRoot

public String getRoot()

mount

public void mount(String prefix,
         File path)

Mount an actual filesystem path on the virtual file system. This method works just like "mount" on a real OS -- the filesystem tree under "path" appears on "prefix". (For instance, you can mount "./foo/bar" as "/usr/lib/bar". This method does not account for absolutely every permutation of path -- in order for it to work, "prefix" should be an absolute path delimited by "/" characters.

translate

public File translate(String pathStr)

Convert a Node.js path to a native (Java) path based on the specified root. If the path is "above" the current root, then return null -- the caller must treat this as "file not found".

reverseTranslate

public String reverseTranslate(String path)
                        throws IOException

Convert a native (Java) path to a Node.js path based on the root.

Throws:

IOException