-
- Enclosing class:
- Pack200
public static interface Pack200.Unpacker
The unpacker engine converts the packed stream to a JAR file. An instance of the engine can be obtained usingPack200.newUnpacker()
.Every JAR file produced by this engine will include the string "PACK200" as a zip file comment. This allows a deployer to detect if a JAR archive was packed and unpacked.
Note: Unless otherwise noted, passing a null argument to a constructor or method in this class will cause a
NullPointerException
to be thrown.This version of the unpacker is compatible with all previous versions.
- Since:
- 1.5
-
-
Field Summary
Fields Modifier and Type Field and Description static String
DEFLATE_HINT
static String
FALSE
The string "false", a possible value for certain properties.static String
KEEP
The string "keep", a possible value for certain properties.static String
PROGRESS
The unpacker's progress as a percentage, as periodically updated by the unpacker.static String
TRUE
The string "true", a possible value for certain properties.
-
Method Summary
Methods Modifier and Type Method and Description void
addPropertyChangeListener(PropertyChangeListener listener)
Registers a listener for PropertyChange events on the properties map.SortedMap<String,String>
properties()
Get the set of this engine's properties.void
removePropertyChangeListener(PropertyChangeListener listener)
Remove a listener for PropertyChange events, added by theaddPropertyChangeListener(java.beans.PropertyChangeListener)
.void
unpack(File in, JarOutputStream out)
Read a Pack200 archive, and write the encoded JAR to a JarOutputStream.void
unpack(InputStream in, JarOutputStream out)
Read a Pack200 archive, and write the encoded JAR to a JarOutputStream.
-
-
-
Field Detail
-
KEEP
static final String KEEP
The string "keep", a possible value for certain properties.- See Also:
DEFLATE_HINT
, Constant Field Values
-
TRUE
static final String TRUE
The string "true", a possible value for certain properties.- See Also:
DEFLATE_HINT
, Constant Field Values
-
FALSE
static final String FALSE
The string "false", a possible value for certain properties.- See Also:
DEFLATE_HINT
, Constant Field Values
-
DEFLATE_HINT
static final String DEFLATE_HINT
Property indicating that the unpacker should ignore all transmitted values for DEFLATE_HINT, replacing them by the given value,TRUE
orFALSE
. The default value is the special stringKEEP
, which asks the unpacker to preserve all transmitted deflation hints.- See Also:
- Constant Field Values
-
PROGRESS
static final String PROGRESS
The unpacker's progress as a percentage, as periodically updated by the unpacker. Values of 0 - 100 are normal, and -1 indicates a stall. Observe this property with aPropertyChangeListener
.At a minimum, the unpacker must set progress to 0 at the beginning of a packing operation, and to 100 at the end.
-
-
Method Detail
-
properties
SortedMap<String,String> properties()
Get the set of this engine's properties. This set is a "live view", so that changing its contents immediately affects the Packer engine, and changes from the engine (such as progress indications) are immediately visible in the map.The property map may contain pre-defined implementation specific and default properties. Users are encouraged to read the information and fully understand the implications, before modifying pre-existing properties.
Implementation specific properties are prefixed with a package name associated with the implementor, beginning with com. or a similar prefix. All property names beginning with pack. and unpack. are reserved for use by this API.
Unknown properties may be ignored or rejected with an unspecified error, and invalid entries may cause an unspecified error to be thrown.
- Returns:
- A sorted association of option key strings to option values.
-
unpack
void unpack(InputStream in, JarOutputStream out) throws IOException
Read a Pack200 archive, and write the encoded JAR to a JarOutputStream. The entire contents of the input stream will be read. It may be more efficient to read the Pack200 archive to a file and pass the File object, using the alternate method described below.Closes its input but not its output. (The output can accumulate more elements.)
- Parameters:
in
- an InputStream.out
- a JarOutputStream.- Throws:
IOException
- if an error is encountered.
-
unpack
void unpack(File in, JarOutputStream out) throws IOException
Read a Pack200 archive, and write the encoded JAR to a JarOutputStream.Does not close its output. (The output can accumulate more elements.)
- Parameters:
in
- a File.out
- a JarOutputStream.- Throws:
IOException
- if an error is encountered.
-
addPropertyChangeListener
void addPropertyChangeListener(PropertyChangeListener listener)
Registers a listener for PropertyChange events on the properties map. This is typically used by applications to update a progress bar.- Parameters:
listener
- An object to be invoked when a property is changed.- See Also:
properties()
,PROGRESS
-
removePropertyChangeListener
void removePropertyChangeListener(PropertyChangeListener listener)
Remove a listener for PropertyChange events, added by theaddPropertyChangeListener(java.beans.PropertyChangeListener)
.- Parameters:
listener
- The PropertyChange listener to be removed.- See Also:
addPropertyChangeListener(java.beans.PropertyChangeListener)
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/util/jar/pack200.unpacker.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.