ilibrary.java

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

/**
 * Copyright (c) 2003-2005 Craig Setera
 * All Rights Reserved.
 * Licensed under the Eclipse Public License - v 1.0
 * For more information see http://www.eclipse.org/legal/epl-v10.html
 */
package eclipseme.core.model;

import java.io.File;
import java.net.URL;

import org.eclipse.jdt.core.IClasspathEntry;

import eclipseme.core.persistence.IPersistable;

/**
 * Represents a library in the device's classpath.  A library
 * is capable of providing further metadata about that specified
 * jar file.
 * <p />
 * Copyright (c) 2003-2005 Craig Setera<br>
 * All Rights Reserved.<br>
 * Licensed under the Eclipse Public License - v 1.0<p/>
 * <br>
 * $Revision: 1.2 $
 * <br>
 * $Date: 2006/02/13 01:16:53 $
 * <br>
 * @author Craig Setera
 */
public interface ILibrary extends IPersistable {
	/**
	 * Return the APIs associated with this library instance.
	 * 
	 * @return
	 */
	public API[] getAPIs();
	
	/**
	 * Return the first API with a type matching the specified API type
	 * or <code>null</code> if none can be found.
	 * 
	 * @param apiType
	 * @return
	 */
	public API getAPI(APIType apiType);
	
	/**
	 * Return the configuration API or <code>null</code> if this
	 * library does not provide a configuration.
	 * 
	 * @return
	 */
	public API getConfiguration();
	
	/**
	 * Return the profile API or <code>null</code> if this
	 * library does not provide a configuration.
	 * 
	 * @return
	 */
	public API getProfile();
	
	/**
	 * Return a boolean indicating whether this library
	 * contains a configuration.
	 * 
	 * @return
	 */
	public boolean hasConfiguration();
	
	/**
	 * Return a boolean indicating whether this library
	 * contains a profile.
	 * 
	 * @return
	 */
	public boolean hasProfile();
	
	/**
	 * Return the library as an instance of IClasspathEntry.
	 * 
	 * @return
	 */
	public IClasspathEntry toClasspathEntry();
	
	/**
	 * Return the library as an instance of java.io.File.
	 * 
	 * @return
	 */
	public File toFile();
	
	/**
	 * Return the library as an instance of java.net.URL.
	 * 
	 * @return
	 */
	public URL toURL();
}