com.helger.photon.basic.app.io

Interface IPathRelativeIO

All Superinterfaces:

Serializable

All Known Subinterfaces:

IFileRelativeIO, IMutableFileRelativeIO

All Known Implementing Classes:

FileRelativeIO, PathRelativeIO

public interface IPathRelativeIO
extends Serializable

A read-only version of a path-relative IO component. For a version with explicitly modifying methods see IMutableFileRelativeIO.

Author:

Philip Helger

Method Summary

Modifier and Type	Method and Description
String	getBasePath()
default InputStream	getInputStream(String sRelativePath) Get the InputStream relative to the base path
default Reader	getReader(String sRelativePath, Charset aCharset) Get the Reader relative to the base path
com.helger.commons.io.resource.IReadableResource	getResource(String sRelativePath) Get the file system resource relative to the base path

Method Detail

getBasePath

@Nonnull
 @Nonempty
String getBasePath()

Returns:

The base path. May be a file path, a URL or whatever. Never null.

getResource

@Nonnull
com.helger.commons.io.resource.IReadableResource getResource(@Nonnull
                                                                       String sRelativePath)

Get the file system resource relative to the base path

Parameters:

sRelativePath - the relative path

Returns:

The "absolute" IReadableResource and never null.

getInputStream

@Nullable
default InputStream getInputStream(@Nonnull
                                              String sRelativePath)

Get the InputStream relative to the base path

Parameters:

sRelativePath - the relative path

Returns:

null if the path does not exist

getReader

@Nullable
default Reader getReader(@Nonnull
                                    String sRelativePath,
                                    @Nonnull
                                    Charset aCharset)

Get the Reader relative to the base path

Parameters:

sRelativePath - the relative path

aCharset - The charset to use. May not be null.

Returns:

null if the path does not exist