mirror of git://gcc.gnu.org/git/gcc.git
				
				
				
			
		
			
				
	
	
		
			189 lines
		
	
	
		
			8.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
			
		
		
	
	
			189 lines
		
	
	
		
			8.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
| @deftypemethod Attributes {public String} getValue (java.lang.String@w{ }@var{name}) 
 | |
| Gets the value of an attribute name given as a String.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public String} getValue (java.util.jar.Attributes.Name@w{ }@var{name}) 
 | |
| Gets the value of the given attribute name.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public String} putValue (java.lang.String@w{ }@var{name}, java.lang.String@w{ }@var{value}) 
 | |
| Stores an attribute name (represented by a String) and value in this
 | |
|  Attributes map.
 | |
|  When the (case insensitive string) name already exists the value is
 | |
|  replaced and the old value is returned.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public Object} clone () 
 | |
| Return a clone of this attribute map.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public void} clear () 
 | |
| Removes all attributes.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public boolean} containsKey (java.lang.Object@w{ }@var{attrName}) 
 | |
| Checks to see if there is an attribute with the specified name.
 | |
|  XXX - what if the object is a String?
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public boolean} containsValue (java.lang.Object@w{ }@var{attrValue}) 
 | |
| Checks to see if there is an attribute name with the specified value.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public Set} entrySet () 
 | |
| Gives a Set of attribute name and values pairs as MapEntries.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public boolean} equals (java.lang.Object@w{ }@var{o}) 
 | |
| Checks to see if two Attributes are equal. The supplied object must be
 | |
|  a real instance of Attributes and contain the same attribute name/value
 | |
|  pairs.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public Object} get (java.lang.Object@w{ }@var{attrName}) 
 | |
| Gets the value of a specified attribute name.
 | |
|  XXX - what if the object is a String?
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public int} hashCode () 
 | |
| Returns the hashcode of the attribute name/value map.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public boolean} isEmpty () 
 | |
| Returns true if there are no attributes set, false otherwise.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public Set} keySet () 
 | |
| Gives a Set of all the values of defined attribute names.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public Object} put (java.lang.Object@w{ }@var{name}, java.lang.Object@w{ }@var{value}) 
 | |
| Adds or replaces a attribute name/value pair.
 | |
|  XXX - What if the name is a string? What if the name is neither a Name
 | |
|  nor a String? What if the value is not a string?
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public void} putAll (java.util.Map@w{ }@var{attr}) 
 | |
| Adds or replaces all attribute name/value pairs from another
 | |
|  Attributes object to this one. The supplied Map must be an instance of
 | |
|  Attributes.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public Object} remove (java.lang.Object@w{ }@var{name}) 
 | |
| Remove a attribute name/value pair.
 | |
|  XXX - What if the name is a String?
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public int} size () 
 | |
| Returns the number of defined attribute name/value pairs.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes {public Collection} values () 
 | |
| Returns all the values of the defined attribute name/value pairs as a
 | |
|  Collection.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes.Name {public int} hashCode () 
 | |
| Returns the hash code of the (lowercase) String representation of
 | |
|  this Name.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes.Name {public boolean} equals (java.lang.Object@w{ }@var{o}) 
 | |
| Checks if another object is equal to this Name object.
 | |
|  Another object is equal to this Name object if it is an instance of
 | |
|  Name and the (lowercase) string representation of the name is equal.
 | |
| @end deftypemethod
 | |
| @deftypemethod Attributes.Name {public String} toString () 
 | |
| Returns the string representation of this Name as given to the
 | |
|  constructor (not neccesarily the lower case representation).
 | |
| @end deftypemethod
 | |
| @deftypemethod JarEntry {public Attributes} getAttributes () @*throws IOException
 | |
| Returns a copy of the Attributes set for this entry.
 | |
|  When no Attributes are set in the manifest null is returned.
 | |
| @end deftypemethod
 | |
| @deftypemethod JarEntry {public Certificate} getCertificates () 
 | |
| Returns a copy of the certificates set for this entry.
 | |
|  When no certificates are set or when not all data of this entry has
 | |
|  been read null is returned.
 | |
|  
 | |
| 
 | |
| 
 | |
|  To make sure that this call returns a valid value you must read all
 | |
|  data from the JarInputStream for this entry.
 | |
|  When you don't need the data for an entry but want to know the
 | |
|  certificates that are set for the entry then you can skip all data by
 | |
|  calling @code{skip(entry.getSize())} on the JarInputStream for
 | |
|  the entry.
 | |
| @end deftypemethod
 | |
| @deftypemethod JarFile {public Enumeration} entries () @*throws IllegalStateException
 | |
| Returns a enumeration of all the entries in the JarFile.
 | |
|  Note that also the Jar META-INF entries are returned.
 | |
| @end deftypemethod
 | |
| @deftypemethod JarFile {public ZipEntry} getEntry (java.lang.String@w{ }@var{name}) 
 | |
| XXX
 | |
|  It actually returns a JarEntry not a zipEntry
 | |
| @end deftypemethod
 | |
| @deftypemethod JarFile {public synchronized InputStream} getInputStream (java.util.zip.ZipEntry@w{ }@var{entry}) @*throws ZipException, IOException
 | |
| XXX should verify the inputstream
 | |
| @end deftypemethod
 | |
| @deftypemethod JarFile {public JarEntry} getJarEntry (java.lang.String@w{ }@var{name}) 
 | |
| Returns the JarEntry that belongs to the name if such an entry
 | |
|  exists in the JarFile. Returns null otherwise
 | |
|  Convenience method that just casts the result from @code{getEntry}
 | |
|  to a JarEntry.
 | |
| @end deftypemethod
 | |
| @deftypemethod JarFile {public Manifest} getManifest () 
 | |
| Returns the manifest for this JarFile or null when the JarFile does not
 | |
|  contain a manifest file.
 | |
| @end deftypemethod
 | |
| @deftypemethod JarInputStream {protected ZipEntry} createZipEntry (java.lang.String@w{ }@var{name}) 
 | |
| Creates a JarEntry for a particular name and consults the manifest
 | |
|  for the Attributes of the entry.
 | |
|  Used by @code{ZipEntry.getNextEntry()}
 | |
| @end deftypemethod
 | |
| @deftypemethod JarInputStream {public Manifest} getManifest () 
 | |
| Returns the Manifest for the jar file or null if there was no Manifest.
 | |
| @end deftypemethod
 | |
| @deftypemethod JarInputStream {public ZipEntry} getNextEntry () @*throws IOException
 | |
| Returns the next entry or null when there are no more entries.
 | |
|  Does actually return a JarEntry, if you don't want to cast it yourself
 | |
|  use @code{getNextJarEntry()}. Does not return any entries found
 | |
|  at the beginning of the ZipFile that are special
 | |
|  (those that start with "META-INF/").
 | |
| @end deftypemethod
 | |
| @deftypemethod JarInputStream {public JarEntry} getNextJarEntry () @*throws IOException
 | |
| Returns the next jar entry or null when there are no more entries.
 | |
| @end deftypemethod
 | |
| @deftypemethod JarInputStream {public int} read (byte[]@w{ }@var{buf}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException
 | |
| XXX
 | |
| @end deftypemethod
 | |
| @deftypemethod JarOutputStream {public void} putNextEntry (java.util.zip.ZipEntry@w{ }@var{entry}) @*throws IOException
 | |
| Prepares the JarOutputStream for writing the next entry. 
 | |
|  This implementation just calls @code{super.putNextEntre()}.
 | |
| @end deftypemethod
 | |
| @deftypemethod Manifest {public Attributes} getMainAttributes () 
 | |
| Gets the main attributes of this Manifest.
 | |
| @end deftypemethod
 | |
| @deftypemethod Manifest {public Map} getEntries () 
 | |
| Gets a map of entry Strings to Attributes for all the entries described
 | |
|  in this manifest. Adding, changing or removing from this entries map
 | |
|  changes the entries of this manifest.
 | |
| @end deftypemethod
 | |
| @deftypemethod Manifest {public Attributes} getAttributes (java.lang.String@w{ }@var{entryName}) 
 | |
| Returns the Attributes associated with the Entry.
 | |
|  
 | |
| 
 | |
| 
 | |
|  Implemented as:
 | |
|  @code{return (Attributes)getEntries().get(entryName)}
 | |
| @end deftypemethod
 | |
| @deftypemethod Manifest {public void} clear () 
 | |
| Clears the main attributes and removes all the entries from the
 | |
|  manifest.
 | |
| @end deftypemethod
 | |
| @deftypemethod Manifest {public void} read (java.io.InputStream@w{ }@var{in}) @*throws IOException
 | |
| XXX
 | |
| @end deftypemethod
 | |
| @deftypemethod Manifest {public void} write (java.io.OutputStream@w{ }@var{out}) @*throws IOException
 | |
| XXX
 | |
| @end deftypemethod
 | |
| @deftypemethod Manifest {public Object} clone () 
 | |
| Makes a deep copy of the main attributes, but a shallow copy of
 | |
|  the other entries. This means that you can freely add, change or remove
 | |
|  the main attributes or the entries of the new manifest without effecting
 | |
|  the original manifest, but adding, changing or removing attributes from
 | |
|  a particular entry also changes the attributes of that entry in the
 | |
|  original manifest. Calls @code{new Manifest(this)}.
 | |
| @end deftypemethod
 | |
| @deftypemethod Manifest {public boolean} equals (java.lang.Object@w{ }@var{o}) 
 | |
| Checks if another object is equal to this Manifest object.
 | |
|  Another Object is equal to this Manifest object if it is an instance of
 | |
|  Manifest and the main attributes and the entries of the other manifest
 | |
|  are equal to this one.
 | |
| @end deftypemethod
 | |
| @deftypemethod Manifest {public int} hashCode () 
 | |
| Calculates the hash code of the manifest. Implemented by a xor of the
 | |
|  hash code of the main attributes with the hash code of the entries map.
 | |
| @end deftypemethod
 |