ijadsignature.java

eclipseme的最新版本的source,欢迎j2me程序员使用

/*
 ********************************************************************
 *
 *	Filename    :   IJadSignature.java
 *	Package     :   eclipseme.core.model
 *	System      :   eclipseme.core
 *	Author      :   Kevin Hunter
 *	Description :   Interface for class used to sign JAD files
 *	                
 * Copyright (c) 2004 Kevin Hunter
 * All Rights Reserved.
 * Licensed under the Eclipse Public License - v 1.0
 * For more information see http://www.eclipse.org/legal/epl-v10.html
 *
 *
 *	CVS
 *	$$Source: /cvsroot/eclipseme/eclipseme.core/src/eclipseme/core/model/IJadSignature.java,v $$
 *	$$Author: setera $$
 *	$$Date: 2004/12/17 01:33:35 $$
 *	$$Revision: 1.3 $$
 *
 ********************************************************************
 */

package eclipseme.core.model;

import java.io.File;

import org.eclipse.core.runtime.CoreException;

/**
 * This interface provides the methods used to sign a midlet suite.
 * <p>
 * <b>Note:</b> This class/interface is part of an interim API that is still 
 * under development and expected to change before reaching stability. It is 
 * being made available at this early stage to solicit feedback from pioneering 
 * adopters on the understanding that any code that uses this API will almost
 * certainly be broken as the API evolves.
 * </p>
 */
public interface IJadSignature
{
	/**
	 * Computes the JAR file signature on the specified file.
	 * 
	 * @param jarFile		<code>File</code> of the JAR to be signed.
	 * 
	 * @throws CoreException	A variety of error conditions can occur, which are
	 * 							wrapped in a CoreException.  See the SIGNING error
	 * 							codes in EclipseMECoreErrors.
	 */
	
	public void computeSignature(File jarFile) throws CoreException;
	
	/**
	 * Returns the JAR signature string that should be added to the JAD file using the
	 * key "MIDlet-Jar-RSA-SHA1" following to a call to <code>computeSignature</code>.
	 * 
	 * @return <code>String</code> containing the encrypted JAR signature.
	 */
	public String getJarSignatureString();
	
	/**
	 * Returns an array of Strings containing the encoded certificates that can be used
	 * to verify the MIDlet suite signature  following to a call to <code>computeSignature</code>.
	 * These Strings should be added to the JAD file using 
	 * the tags "MIDlet-Certificate-1-1" through "MIDlet-Certificate-1-n" (where "n" is the
	 * number of certificates)
	 * 
	 * @return Array of <code>String</code>s containing encoded certificates.
	 */
	public String[] getCertificateStrings();
}

/*
 ********************************************************************
 *	CVS History:
 *	$$Log: IJadSignature.java,v $
 *	$Revision 1.3  2004/12/17 01:33:35  setera
 *	$Documentation updates for the 0.7.0
 *	$
 *	$Revision 1.2  2004/12/16 13:11:29  kdhunter
 *	$JavaDoc updates
 *	$
 *	$Revision 1.1  2004/11/27 21:23:43  kdhunter
 *	$Interface extracted from JadSignature object
 *	$$
 *
 ********************************************************************
 */