FileDocCategorySizeDatePackage
JarReader.javaAPI DocphoneME MR2 API (J2ME)4504Wed May 02 18:00:04 BST 2007com.sun.midp.installer

JarReader

public class JarReader extends Object
This class provides a Java API for reading an entry from a Jar file stored on the file system.

Fields Summary
Constructors Summary
Methods Summary
public static byte[]readJarEntry(com.sun.midp.security.SecurityToken securityToken, java.lang.String jarFilePath, java.lang.String entryName)
Returns the content of the given entry in the JAR file on the file system given by jarFilePath.

param
securityToken token with permission to install software
param
jarFilePath file pathname of the JAR file to read. May be a relative pathname.
param
entryName name of the entry to return.
return
the content of the given entry in a byte array or null if the entry was not found
exception
IOException if JAR is corrupt or not found
exception
IOException if the entry does not exist.
exception
SecurityException if the caller does not have permission to install software.


        if (securityToken == null) {
            MIDletStateHandler midletStateHandler =
                MIDletStateHandler.getMidletStateHandler();
            MIDletSuite midletSuite = midletStateHandler.getMIDletSuite();

            midletSuite.checkIfPermissionAllowed(Permissions.AMS);
        } else {
            securityToken.checkIfPermissionAllowed(Permissions.AMS);
        }

        if (entryName.charAt(0) == '/") { 
            /*
             * Strip off the leading directory separator, or the
             * resource will not be found in the JAR.
             */
            entryName = entryName.substring(1, entryName.length());
        }

        return readJarEntry0(jarFilePath, entryName);
    
public static byte[]readJarEntry(java.lang.String jarFilePath, java.lang.String entryName)
Returns the content of the given entry in the JAR file on the file system given by jarFilePath.

param
jarFilePath file pathname of the JAR file to read. May be a relative pathname.
param
entryName name of the entry to return.
return
the content of the given entry in a byte array or null if the entry was not found
exception
IOException if JAR is corrupt or not found
exception
IOException if the entry does not exist.
exception
SecurityException if the caller does not have permission to install software.


        return readJarEntry(null, jarFilePath, entryName);
    
private static native byte[]readJarEntry0(java.lang.String localJarFilePath, java.lang.String localEntryName)
Performs the same function as readJarEntry.

param
localJarFilePath file pathname of the JAR file to read. May be a relative pathname.
param
localEntryName name of the entry to return.
return
the content of the given entry in a byte array or null if the entry was not found
exception
IOException if JAR is corrupt or not found