suitesigner.java

来自「cqME :java framework for TCK test.」· Java 代码 · 共 69 行

/*
 * $Id$
 *
 * Copyright 1996-2007 Sun Microsystems, Inc. All Rights Reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License version
 * 2 only, as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * General Public License version 2 for more details (a copy is
 * included at /legal/license.txt).
 *
 * You should have received a copy of the GNU General Public License
 * version 2 along with this work; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA
 *
 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
 * Clara, CA 95054 or visit www.sun.com if you need additional
 * information or have any questions.
 *
 */

package com.sun.cldc.communication.midp;

/**
 * This interface defines a general contract for MIDlet suite signers to be
 * used by the test execution infrastructure. Signers modify MIDlet suites so
 * that MIDP implementation will consider the suites as trusted.
 * <p>
 * Implementations of this interface should provide a no-arguments public
 * constructor.
 * <p>
 * It can be assumed that {@link #init(String[])} will be invoked first, to
 * initialize the signer, and then {@link #sign(String, String)} will be
 * called for every TCK MIDlet suite that needs to be signed.
 */
public interface SuiteSigner {

    /**
     * Initializes the SuiteSigner with the specified arguments.
     * <p>
     * This method is called immediately after instantiating the SuiteSigner.
     *
     * @param args
     *            initialization arguments.
     * @throws IllegalArgumentException if the arguments are invalid.
     */
    public void init(String[] args);

    /**
     * Modifies the specified jad/jar pair so that a MIDP implementation will
     * consider the MIDlet suite as trusted.
     *
     * @param jarFileName
     *            The name of a jar file to sign.
     * @param jadFileName
     *            The name of a jad file.
     * @throws SignerException
     *             in case of any problems with signing.
     */
    public void sign(String jarFileName, String jadFileName)
        throws SignerException;
}