001: /*
002: *
003: *
004: * Copyright 1990-2007 Sun Microsystems, Inc. All Rights Reserved.
005: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
006: *
007: * This program is free software; you can redistribute it and/or
008: * modify it under the terms of the GNU General Public License version
009: * 2 only, as published by the Free Software Foundation.
010: *
011: * This program is distributed in the hope that it will be useful, but
012: * WITHOUT ANY WARRANTY; without even the implied warranty of
013: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
014: * General Public License version 2 for more details (a copy is
015: * included at /legal/license.txt).
016: *
017: * You should have received a copy of the GNU General Public License
018: * version 2 along with this work; if not, write to the Free Software
019: * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
020: * 02110-1301 USA
021: *
022: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
023: * Clara, CA 95054 or visit www.sun.com if you need additional
024: * information or have any questions.
025: */
026:
027: package com.sun.cldc.isolate;
028:
029: import com.sun.cldchi.jvm.JVM;
030:
031: public final class Util {
032: /**
033: * Use VM verifier to make sure that supplied jar is correct.
034: *
035: * <p><i>Note:</i> for this API to function, compilation time flag
036: * ENABLE_VERIFY_ONLY=true must be specified
037: *
038: * @param jarPath path to JAR file to verify
039: * @return true if supplied JAR is correct, false otherwise
040: **/
041: public static boolean verify(String jarPath) {
042: return verify(jarPath, Integer.MAX_VALUE);
043: }
044:
045: /**
046: * Use VM verifier to make sure that supplied jar is correct.
047: * <p>
048: * The verification of a JAR is performed in chunks.
049: * During verification of a chunk no other isolates can execute.
050: * Each chunk consists of one or more class files.
051: * The size of a chunk is the total compressed size of JAR entries
052: * in the chunk. Verification of a chunk stops when either the
053: * size of a chunk exceeds the specified <code>chunkSize</code> or
054: * there are no more entries in the JAR. Larger values of
055: * <code>chunkSize</code> ensure faster verification of the JAR,
056: * but other active isolates will have less chances to execute
057: * while the verification is in progress.
058: * <p>
059: * This method is multitask-safe, i.e. it can be invoked from multiple
060: * tasks at the same time.
061: * <p>
062: * The method returns after the whole JAR is verified and the return value
063: * indicates if the JAR is correct.
064: *
065: * <p><i>Note:</i> for this API to function, compilation time flag
066: * ENABLE_VERIFY_ONLY=true must be specified
067: *
068: * @param jarPath path to JAR file to verify
069: * @param chunkSize size of the JAR file chunk
070: * @return true if supplied JAR is correct, false otherwise
071: * @throws IllegalArgumentException if <code>chunkSize</code> is not
072: * positive
073: */
074: public static boolean verify(String jarPath, int chunkSize) {
075: if (chunkSize <= 0) {
076: throw new IllegalArgumentException();
077: }
078: String[] classpath = new String[1];
079: String[] mainArgs = new String[2];
080: classpath[0] = jarPath;
081: mainArgs[0] = jarPath;
082: mainArgs[1] = new Integer(chunkSize).toString();
083: int status = 0;
084:
085: try {
086: Isolate iso = new Isolate("com.sun.cldc.isolate.Verifier",
087: mainArgs, classpath);
088: iso.setAPIAccess(true);
089: iso.start();
090: iso.waitForExit();
091:
092: status = iso.exitCode();
093: } catch (IsolateStartupException ise) {
094: ise.printStackTrace();
095: return false;
096: }
097: return status == JVM.STATUS_VERIFY_SUCCEEDED;
098: }
099: }
100:
101: final class Verifier {
102: public static void main(String[] args) {
103: int chunkSize = Integer.parseInt(args[1]);
104: Isolate.currentIsolate()
105: .exit(JVM.verifyJar(args[0], chunkSize));
106: }
107:
108: }
|