io.apigee.trireme.kernel

Class PathTranslator

java.lang.Object

io.apigee.trireme.kernel.PathTranslator

public class PathTranslator
extends java.lang.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(java.lang.String root)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getRoot()
void	mount(java.lang.String prefix, java.io.File path) Mount an actual filesystem path on the virtual file system.
java.lang.String	reverseTranslate(java.lang.String path) Convert a native (Java) path to a Node.js path based on the root.
void	setRoot(java.lang.String root)
void	setWorkingDir(java.lang.String wd)
java.io.File	translate(java.lang.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(java.lang.String root)
               throws java.io.IOException

Throws:

java.io.IOException

Method Detail

setWorkingDir

public void setWorkingDir(java.lang.String wd)

setRoot

public void setRoot(java.lang.String root)
             throws java.io.IOException

Throws:

java.io.IOException

getRoot

public java.lang.String getRoot()

mount

public void mount(java.lang.String prefix,
                  java.io.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 java.io.File translate(java.lang.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 java.lang.String reverseTranslate(java.lang.String path)
                                  throws java.io.IOException

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

Throws:

java.io.IOException