FileSystemAPI (OpenComputers MC1.6.4-1.3.6.682-dev API)

```
public interface FileSystemAPI
```

Method Summary

Methods
Modifier and Type	Method and Description
`ManagedEnvironment`	`asManagedEnvironment(FileSystem fileSystem)` Like `asManagedEnvironment(li.cil.oc.api.fs.FileSystem, Label)`, but creates an unlabeled file system (i.e.
`ManagedEnvironment`	`asManagedEnvironment(FileSystem fileSystem, Label label)` Like `asManagedEnvironment(li.cil.oc.api.fs.FileSystem, Label, Container)`, but does not provide a container.
`ManagedEnvironment`	`asManagedEnvironment(FileSystem fileSystem, Label label, Container container)` Creates a network node that makes the specified file system available via the common file system driver.
`ManagedEnvironment`	`asManagedEnvironment(FileSystem fileSystem, java.lang.String label)` Like `asManagedEnvironment(li.cil.oc.api.fs.FileSystem, Label)`, but creates a read-only label initialized to the specified value.
`ManagedEnvironment`	`asManagedEnvironment(FileSystem fileSystem, java.lang.String label, Container container)` Like `asManagedEnvironment(li.cil.oc.api.fs.FileSystem, Label, Container)`, but creates a read-only label initialized to the specified value.
`FileSystem`	`fromClass(java.lang.Class<?> clazz, java.lang.String domain, java.lang.String root)` Creates a new file system based on the location of a class.
`FileSystem`	`fromComputerCraft(java.lang.Object mount)` Creates a new file system based on a read-only ComputerCraft mount.
`FileSystem`	`fromMemory(long capacity)` Creates a new writable file system that resides in memory.
`FileSystem`	`fromSaveDirectory(java.lang.String root, long capacity, boolean buffered)` Creates a new writable file system in the save folder.

- Method Detail
  - fromClass
```
FileSystem fromClass(java.lang.Class<?> clazz,
                   java.lang.String domain,
                   java.lang.String root)
```
    Creates a new file system based on the location of a class.
    This can be used to wrap a folder in the assets folder of your mod's JAR. The actual path is built like this:
```
"/assets/" + domain + "/" + root
```
    If the class is located in a JAR file, this will create a read-only file system based on that JAR file. If the class file is located in the native file system, this will create a read-only file system first trying from the actual location of the class file, and failing that by searching the class path (i.e. it'll look for a path constructed as described above).
    If the specified path cannot be located, the creation fails and this returns null.
    Parameters:
    clazz - the class whose containing JAR to wrap.
    domain - the domain, usually your mod's ID.
    root - an optional subdirectory.
    
    Returns:
    a file system wrapping the specified folder.
  - fromSaveDirectory
```
FileSystem fromSaveDirectory(java.lang.String root,
                           long capacity,
                           boolean buffered)
```
    Creates a new writable file system in the save folder.
    This will create a folder, if necessary, and create a writable virtual file system based in that folder. The actual path is based in a sub- folder of the save folder. The actual path is built like this:
```
"saves/" + WORLD_NAME + "/opencomputers/" + root
```
    The first part may differ, in particular for servers.
    Usually the name will be the address of the node used to represent the file system.
    Note that by default file systems are "buffered", meaning that any changes made to them are only saved to disk when the world is saved. This ensured that the file system contents do not go "out of sync" when the game crashes, but introduces additional memory overhead, since all files in the file system have to be kept in memory.
    Parameters:
    root - the name of the file system.
    capacity - the amount of space in bytes to allow being used.
    buffered - whether data should only be written to disk when saving.
    
    Returns:
    a file system wrapping the specified folder.
  - fromMemory
```
FileSystem fromMemory(long capacity)
```
    Creates a new writable file system that resides in memory.
    Any contents created and written on this file system will be lost when the node is removed from the network.
    This is used for computers' /tmp mount, for example.
    
    Parameters:
    capacity - the capacity of the file system.
    
    Returns:
    a file system residing in memory.
  - fromComputerCraft
```
FileSystem fromComputerCraft(java.lang.Object mount)
```
    Creates a new file system based on a read-only ComputerCraft mount.
    This supports read-only and writable mounts from either CC 1.5x or CC 1.6x. The argument is kept untyped to avoid having the OC API depend on the CC API.
    If the passed type is unsupported, this will return null.
    
    Parameters:
    mount - the mount to wrap with a file system.
    
    Returns:
    a file system wrapping the specified mount.
  - asManagedEnvironment
```
ManagedEnvironment asManagedEnvironment(FileSystem fileSystem,
                                      Label label,
                                      Container container)
```
    Creates a network node that makes the specified file system available via the common file system driver.
    This can be useful for providing some data if you don't wish to implement your own driver. Which will probably be most of the time. If you need more control over the node, implement your own, and connect this one to it. In that case you will have to forward any disk driver messages to the node, though.
    The container parameter is used to give the file system some physical relation to the world, for example this is used by hard drives to send the disk event notifications to the client that are used to play disk access sounds.
    The container may be null, if no such context can be provided.
    
    Parameters:
    fileSystem - the file system to wrap.
    label - the label of the file system.
    container - the tile entity containing the file system.
    
    Returns:
    the network node wrapping the file system.
  - asManagedEnvironment
```
ManagedEnvironment asManagedEnvironment(FileSystem fileSystem,
                                      java.lang.String label,
                                      Container container)
```
    Like asManagedEnvironment(li.cil.oc.api.fs.FileSystem, Label, Container), but creates a read-only label initialized to the specified value.
    
    Parameters:
    fileSystem - the file system to wrap.
    label - the read-only label of the file system.
    
    Returns:
    the network node wrapping the file system.
  - asManagedEnvironment
```
ManagedEnvironment asManagedEnvironment(FileSystem fileSystem,
                                      Label label)
```
    Like asManagedEnvironment(li.cil.oc.api.fs.FileSystem, Label, Container), but does not provide a container.
    
    Parameters:
    fileSystem - the file system to wrap.
    label - the label of the file system.
    
    Returns:
    the network node wrapping the file system.
  - asManagedEnvironment
```
ManagedEnvironment asManagedEnvironment(FileSystem fileSystem,
                                      java.lang.String label)
```
    Like asManagedEnvironment(li.cil.oc.api.fs.FileSystem, Label), but creates a read-only label initialized to the specified value.
    
    Parameters:
    fileSystem - the file system to wrap.
    label - the read-only label of the file system.
    
    Returns:
    the network node wrapping the file system.
  - asManagedEnvironment
```
ManagedEnvironment asManagedEnvironment(FileSystem fileSystem)
```
    Like asManagedEnvironment(li.cil.oc.api.fs.FileSystem, Label), but creates an unlabeled file system (i.e. the label can neither be read nor written).
    
    Parameters:
    fileSystem - the file system to wrap.
    
    Returns:
    the network node wrapping the file system.

Interface FileSystemAPI

Method Summary

Method Detail

fromClass

fromSaveDirectory

fromMemory

fromComputerCraft

asManagedEnvironment

asManagedEnvironment

asManagedEnvironment

asManagedEnvironment

asManagedEnvironment