KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > eclipse > jdt > ui > jarpackager > IJarDescriptionReader


1 /*******************************************************************************
2  * Copyright (c) 2000, 2005 IBM Corporation and others.
3  * All rights reserved. This program and the accompanying materials
4  * are made available under the terms of the Eclipse Public License v1.0
5  * which accompanies this distribution, and is available at
6  * http://www.eclipse.org/legal/epl-v10.html
7  *
8  * Contributors:
9  * IBM Corporation - initial API and implementation
10  *******************************************************************************/
11 package org.eclipse.jdt.ui.jarpackager;
12
13 import org.eclipse.core.runtime.CoreException;
14 import org.eclipse.core.runtime.IStatus;
15
16 /**
17  * Reads the description file of a JAR package data object
18  * into such an object.
19  * <p>
20  * The format is defined by the client who implements the
21  * reader/writer pair.
22  * </p>
23  *
24  * @see org.eclipse.jdt.ui.jarpackager.JarPackageData
25  * @see org.eclipse.jdt.ui.jarpackager.IJarDescriptionWriter
26  * @since 2.0
27  */
28 public interface IJarDescriptionReader {
29
30     /**
31      * Reads Jar Package description and fills data into
32      * the JAR Package data object.
33      * <p>
34      * It is the client's responsibility to close this reader.
35      * </p>
36      *
37      * @param jarPackageData the object into which data is filled
38      * @throws CoreException if read failed, e.g. I/O error during read operation
39      */
40     public void read(JarPackageData jarPackageData) throws CoreException;
41     
42     /**
43      * Closes this reader.
44      * <p>
45      * It is the client's responsibility to close this reader.
46      * </p>
47      *
48      * @throws CoreException if closing fails, e.g. I/O error during close operation
49      */
50     public void close() throws CoreException;
51
52     /**
53      * Returns the status of this reader.
54      * If there were any errors, the result is a status object containing
55      * individual status objects for each error.
56      * If there were no errors, the result is a status object with error code <code>OK</code>.
57      *
58      * @return the status of this operation
59      */
60     public IStatus getStatus();
61 }
62
Popular Tags