Package org.jruby.util

Class URLResource

java.lang.Object

org.jruby.util.URLResource

All Implemented Interfaces:

DummyResourceStat.FileResourceExt, FileResource

public class URLResource
extends Object
implements FileResource, DummyResourceStat.FileResourceExt

Field Summary

Fields

Modifier and Type	Field	Description
private final ClassLoader	cl
static final String	CLASSLOADER
private final String[]	list
private final String	pathname
private final String	uri
static final String	URI
static final String	URI_CLASSLOADER
private final URL	url

Constructor Summary

Constructors

Modifier	Constructor	Description
(package private)	URLResource(String uri, ClassLoader cl, String pathname, String[] files)
private	URLResource(String uri, URL url, ClassLoader cl, String pathname, String[] files)
(package private)	URLResource(String uri, URL url, String[] files)

Method Summary

Modifier and Type	Method	Description
String	absolutePath()
private static boolean	addDirectoriesFromClassloader(ClassLoader cl, Set<String> list, String pathname, boolean isDirectory)
private static boolean	addDirectoryEntries(Set<String> entries, URL url, boolean isDirectory)
boolean	canExecute()
String	canonicalPath()
boolean	canRead()
boolean	canWrite()
private static void	close(Closeable resource)
static FileResource	create(Ruby runtime, String pathname, boolean asFile)
static FileResource	createClassloaderURI(Ruby runtime, String pathname, boolean asFile)
private static FileResource	createRegularURI(String pathname, boolean asFile)
FileTime	creationTime()
boolean	equals(Object obj)
int	errno()
boolean	exists()
static URL	getResourceURL(Ruby runtime, String location)
int	hashCode()
boolean	isDirectory()
boolean	isFile()
boolean	isSymLink()
FileTime	lastAccessTime()
long	lastModified()
FileTime	lastModifiedTime()
long	length()
String[]	list()
private static String[]	listClassLoaderFiles(ClassLoader classloader, String pathname)
private static String[]	listFiles(String pathname)
private static String[]	listFilesFromInputStream(InputStream is)
jnr.posix.FileStat	lstat()
Channel	openChannel(int flags, int perm)
InputStream	openInputStream()	Opens a new input stream to read the contents of a resource and returns it.
String	path()
jnr.posix.FileStat	stat()
String	toString()
<T> T	unwrap(Class<T> type)	Unwrap the resource backend (replacement for FileResource.hackyGetJRubyFile()).

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.jruby.util.FileResource

hackyGetJRubyFile, inputStream, isNull, openChannel

Field Details

URI

public static final String URI

See Also:

• Constant Field Values

CLASSLOADER

public static final String CLASSLOADER

See Also:

• Constant Field Values

URI_CLASSLOADER

public static final String URI_CLASSLOADER

See Also:

• Constant Field Values

uri

private final String uri

list

private final String[] list

url

private final URL url

pathname

private final String pathname

cl

private final ClassLoader cl

Constructor Details

URLResource

URLResource(String uri,
 URL url,
 String[] files)

URLResource

URLResource(String uri,
 ClassLoader cl,
 String pathname,
 String[] files)

URLResource

private URLResource(String uri,
 URL url,
 ClassLoader cl,
 String pathname,
 String[] files)

Method Details

absolutePath

public String absolutePath()

Specified by:

absolutePath in interface FileResource

canonicalPath

public String canonicalPath()

Specified by:

canonicalPath in interface FileResource

path

public String path()

Specified by:

path in interface FileResource

exists

public boolean exists()

Specified by:

exists in interface FileResource

isDirectory

public boolean isDirectory()

Specified by:

isDirectory in interface FileResource

isFile

public boolean isFile()

Specified by:

isFile in interface FileResource

length

public long length()

Specified by:

length in interface FileResource

canRead

public boolean canRead()

Specified by:

canRead in interface FileResource

canWrite

public boolean canWrite()

Specified by:

canWrite in interface FileResource

canExecute

public boolean canExecute()

Specified by:

canExecute in interface FileResource

list

public String[] list()

Specified by:

list in interface FileResource

See Also:

• File.list()

isSymLink

public boolean isSymLink()

Specified by:

isSymLink in interface FileResource

lastModified

public long lastModified()

Specified by:

lastModified in interface FileResource

lastModifiedTime

public FileTime lastModifiedTime()

Specified by:

lastModifiedTime in interface DummyResourceStat.FileResourceExt

lastAccessTime

public FileTime lastAccessTime()

Specified by:

lastAccessTime in interface DummyResourceStat.FileResourceExt

creationTime

public FileTime creationTime()

Specified by:

creationTime in interface DummyResourceStat.FileResourceExt

errno

public int errno()

Specified by:

errno in interface FileResource

stat

public jnr.posix.FileStat stat()

Specified by:

stat in interface FileResource

lstat

public jnr.posix.FileStat lstat()

Specified by:

lstat in interface FileResource

unwrap

public <T> T unwrap(Class<T> type)
             throws UnsupportedOperationException

Description copied from interface: FileResource

Unwrap the resource backend (replacement for FileResource.hackyGetJRubyFile()).

Specified by:

unwrap in interface FileResource

Returns:

backend if supported

Throws:

UnsupportedOperationException

openInputStream

public InputStream openInputStream()
                            throws IOException

Description copied from interface: FileResource

Opens a new input stream to read the contents of a resource and returns it. Note that implementations may be allocating native memory for the stream, so callers need to close this when they are done with it. users of this method should follow the pattern: close the stream where you open it.

Specified by:

openInputStream in interface FileResource

Returns:

InputStream

Throws:

IOException

openChannel

public Channel openChannel(int flags,
 int perm)
                    throws IOException

Specified by:

openChannel in interface FileResource

Throws:

IOException

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

createClassloaderURI

public static FileResource createClassloaderURI(Ruby runtime,
 String pathname,
 boolean asFile)

addDirectoriesFromClassloader

private static boolean addDirectoriesFromClassloader(ClassLoader cl,
 Set<String> list,
 String pathname,
 boolean isDirectory)
                                              throws IOException

Throws:

IOException

addDirectoryEntries

private static boolean addDirectoryEntries(Set<String> entries,
 URL url,
 boolean isDirectory)

create

public static FileResource create(Ruby runtime,
 String pathname,
 boolean asFile)

createRegularURI

private static FileResource createRegularURI(String pathname,
 boolean asFile)

listFilesFromInputStream

private static String[] listFilesFromInputStream(InputStream is)

listClassLoaderFiles

private static String[] listClassLoaderFiles(ClassLoader classloader,
 String pathname)

listFiles

private static String[] listFiles(String pathname)

close

private static void close(Closeable resource)

getResourceURL

public static URL getResourceURL(Ruby runtime,
 String location)