oracle.jdeveloper.compiler
Class JarStorage

java.lang.Object
  oracle.jdeveloper.compiler.JarStorage

All Implemented Interfaces:

Storage

public class JarStorage

extends java.lang.Object

implements Storage

Implementation of Storage interface for jar entries. This is basically a wrapper for URLFileSystem.

Constructor Summary

JarStorage(java.net.URL jarURL)
The implementation assumes that the jar URL uses the "file" protocol for the jar file.

Method Summary

void	close() Closes a storage that previously opened for data access.
Storage	create(java.lang.String name) Creates a new storage for data access if doesn't exists yet.
Storage	createDir(java.lang.String name) Creates a new directory storage if doesn't exists yet.
boolean	equals(java.lang.Object o)
java.lang.String	getCanonicalPath() Return the canonical path name of this storage.
java.lang.String	getName() Return the name of this storage (without leading directories).
java.lang.String	getParent()
java.lang.String	getPath() Return the path name of this storage.
java.lang.Object	getProperty(java.lang.String property) Queries custom property associated with this storage.
java.net.URL	getURL()
int	hashCode()
boolean	isDirectory() Indicates whether this is a directory storage.
boolean	isInJar() is this store contained in a zip/jar file?
java.lang.String[]	list() Lists all names of storages within this directory storage.
java.util.ArrayList	listStorage() Lists all storages within this directory storage.
long	modDate() Return date of last modification of this storage.
void	open() Opens a storage for access.
Storage	open(java.lang.String name) Opens a storage for access.
Storage	openDir(java.lang.String name)
byte[]	read() Reads the entire contents of this data storage.
int	read(byte[] buf) Tries to fill a buffer with data from contents of this storage.
Storage	setContext(Storage newContext)
void	setPackage(java.lang.String packageName)
void	setProperty(java.lang.String property, java.lang.Object value) Allows association of custom properties with this storage.
int	size() Return the size of contents of this data storage.
java.lang.String	toString()
void	write(byte[] xs, int start, int len) Write the contents of a byte array into this storage.

Methods inherited from class java.lang.Object

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

Constructor Detail

JarStorage

public JarStorage(java.net.URL jarURL)

The implementation assumes that the jar URL uses the "file" protocol for the jar file. This code will need to be updated if other protocols need to be supported.

Method Detail

equals

public boolean equals(java.lang.Object o)

hashCode

public int hashCode()

toString

public java.lang.String toString()

modDate

public long modDate()

Description copied from interface: Storage

Return date of last modification of this storage.

Specified by:

modDate in interface Storage

Returns:

date of modification

getURL

public java.net.URL getURL()

getName

public java.lang.String getName()

Description copied from interface: Storage

Return the name of this storage (without leading directories).

Specified by:

getName in interface Storage

Returns:

name

getPath

public java.lang.String getPath()

Description copied from interface: Storage

Return the path name of this storage.

Specified by:

getPath in interface Storage

Returns:

path

getCanonicalPath

public java.lang.String getCanonicalPath()

Description copied from interface: Storage

Return the canonical path name of this storage.

Specified by:

getCanonicalPath in interface Storage

Returns:

canonical path

getParent

public java.lang.String getParent()

getProperty

public java.lang.Object getProperty(java.lang.String property)

Description copied from interface: Storage

Queries custom property associated with this storage.

Specified by:

getProperty in interface Storage

Parameters:

property - property key

Returns:

property value

setProperty

public void setProperty(java.lang.String property,
                        java.lang.Object value)

Description copied from interface: Storage

Allows association of custom properties with this storage.

Specified by:

setProperty in interface Storage

Parameters:

property - property key

value - property value

isDirectory

public boolean isDirectory()

Description copied from interface: Storage

Indicates whether this is a directory storage.

Specified by:

isDirectory in interface Storage

Returns:

true if directory else false

isInJar

public boolean isInJar()

is this store contained in a zip/jar file?

Specified by:

isInJar in interface Storage

Returns:

true if in jar/zip file else false

close

public void close()

Description copied from interface: Storage

Closes a storage that previously opened for data access.

Specified by:

close in interface Storage

size

public int size()
         throws java.io.IOException

Description copied from interface: Storage

Return the size of contents of this data storage. Note that this must not be a directory storage.

Specified by:

size in interface Storage

Returns:

size of storage data in byte

Throws:

java.io.IOException

listStorage

public java.util.ArrayList listStorage()

Description copied from interface: Storage

Lists all storages within this directory storage. Note that this must be a directory storage.

Specified by:

listStorage in interface Storage

list

public java.lang.String[] list()

Description copied from interface: Storage

Lists all names of storages within this directory storage. Note that this must be a directory storage.

Specified by:

list in interface Storage

open

public void open()
          throws java.io.IOException

Description copied from interface: Storage

Opens a storage for access.

Specified by:

open in interface Storage

Throws:

java.io.IOException

open

public Storage open(java.lang.String name)

Description copied from interface: Storage

Opens a storage for access.

Specified by:

open in interface Storage

Parameters:

name - of storage to be accessed

Returns:

storage to be accessed

openDir

public Storage openDir(java.lang.String name)

read

public byte[] read()
            throws java.io.IOException

Description copied from interface: Storage

Reads the entire contents of this data storage. Note that this must not be a directory storage.

Specified by:

read in interface Storage

Returns:

byte buffer containing all data of the storage

Throws:

java.io.IOException

read

public int read(byte[] buf)
         throws java.io.IOException

Description copied from interface: Storage

Tries to fill a buffer with data from contents of this storage. Note that this storage must not be a directory storage and must have been opened before attempting to read.

Specified by:

read in interface Storage

Parameters:

buf - buffer to be filled

Returns:

actual number of bytes read

Throws:

java.io.IOException

setContext

public Storage setContext(Storage newContext)

setPackage

public void setPackage(java.lang.String packageName)

write

public void write(byte[] xs,
                  int start,
                  int len)
           throws java.io.IOException

Description copied from interface: Storage

Write the contents of a byte array into this storage. Note that this storage must not be a directory storage, support write access and been opened before attempting to write.

Specified by:

write in interface Storage

Parameters:

xs - buffer to be written

start - offset within buffer where data starts

len - amount of data from buffer to be written

Throws:

java.io.IOException

create

public Storage create(java.lang.String name)
               throws java.io.IOException

Description copied from interface: Storage

Creates a new storage for data access if doesn't exists yet. Note that this must be a directory storage and support write access.

Specified by:

create in interface Storage

Parameters:

name - of storage to be created

Returns:

storage created

Throws:

java.io.IOException

createDir

public Storage createDir(java.lang.String name)
                  throws java.io.IOException

Description copied from interface: Storage

Creates a new directory storage if doesn't exists yet. Note that this must be a directory storage and support write access.

Specified by:

createDir in interface Storage

Parameters:

name - of storage to be created

Returns:

storage created

Throws:

java.io.IOException