org.springframework.boot.loader.archive

Interface Archive

All Superinterfaces:

java.lang.AutoCloseable, java.lang.Iterable<Archive.Entry>

All Known Implementing Classes:

ExplodedArchive, JarFileArchive

public interface Archive
extends java.lang.Iterable<Archive.Entry>, java.lang.AutoCloseable

An archive that can be launched by the Launcher.

Since:

1.0.0

See Also:

JarFileArchive

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Archive.Entry Represents a single entry in the archive.
static interface	Archive.EntryFilter Strategy interface to filter Entries.

Method Summary

Modifier and Type	Method and Description
default void	close() Closes the Archive, releasing any open resources.
default void	forEach(java.util.function.Consumer<? super Archive.Entry> action) Deprecated. since 2.3.0 for removal in 2.5.0 in favor of using JarFile to access entries and getNestedArchives(EntryFilter, EntryFilter) for accessing nested archives.
java.util.jar.Manifest	getManifest() Returns the manifest of the archive.
default java.util.List<Archive>	getNestedArchives(Archive.EntryFilter filter) Deprecated. since 2.3.0 for removal in 2.5.0 in favor of getNestedArchives(EntryFilter, EntryFilter)
default java.util.Iterator<Archive>	getNestedArchives(Archive.EntryFilter searchFilter, Archive.EntryFilter includeFilter) Returns nested Archives for entries that match the specified filters.
java.net.URL	getUrl() Returns a URL that can be used to load the archive.
default boolean	isExploded() Return if the archive is exploded (already unpacked).
java.util.Iterator<Archive.Entry>	iterator() Deprecated. since 2.3.0 for removal in 2.5.0 in favor of using JarFile to access entries and getNestedArchives(EntryFilter, EntryFilter) for accessing nested archives.
default java.util.Spliterator<Archive.Entry>	spliterator() Deprecated. since 2.3.0 for removal in 2.5.0 in favor of using JarFile to access entries and getNestedArchives(EntryFilter, EntryFilter) for accessing nested archives.

Method Detail

getUrl

java.net.URL getUrl()
             throws java.net.MalformedURLException

Returns a URL that can be used to load the archive.

Returns:

the archive URL

Throws:

java.net.MalformedURLException - if the URL is malformed

getManifest

java.util.jar.Manifest getManifest()
                            throws java.io.IOException

Returns the manifest of the archive.

Returns:

the manifest

Throws:

java.io.IOException - if the manifest cannot be read

getNestedArchives

default java.util.Iterator<Archive> getNestedArchives(Archive.EntryFilter searchFilter,
                                                      Archive.EntryFilter includeFilter)
                                               throws java.io.IOException

Returns nested Archives for entries that match the specified filters.

Parameters:

searchFilter - filter used to limit when additional sub-entry searching is required or null if all entries should be considered.

includeFilter - filter used to determine which entries should be included in the result or null if all entries should be included

Returns:

the nested archives

Throws:

java.io.IOException - on IO error

Since:

2.3.0

getNestedArchives

@Deprecated
default java.util.List<Archive> getNestedArchives(Archive.EntryFilter filter)
                                                       throws java.io.IOException

Deprecated. since 2.3.0 for removal in 2.5.0 in favor of getNestedArchives(EntryFilter, EntryFilter)

Returns nested Archives for entries that match the specified filter.

Parameters:

filter - the filter used to limit entries

Returns:

nested archives

Throws:

java.io.IOException - if nested archives cannot be read

iterator

@Deprecated
java.util.Iterator<Archive.Entry> iterator()

Deprecated. since 2.3.0 for removal in 2.5.0 in favor of using JarFile to access entries and getNestedArchives(EntryFilter, EntryFilter) for accessing nested archives.

Return a new iterator for the archive entries.

Specified by:

iterator in interface java.lang.Iterable<Archive.Entry>

See Also:

Iterable.iterator()

forEach

@Deprecated
default void forEach(java.util.function.Consumer<? super Archive.Entry> action)

Deprecated. since 2.3.0 for removal in 2.5.0 in favor of using JarFile to access entries and getNestedArchives(EntryFilter, EntryFilter) for accessing nested archives.

Performs the given action for each element of the Iterable until all elements have been processed or the action throws an exception.

Specified by:

forEach in interface java.lang.Iterable<Archive.Entry>

See Also:

Iterable.forEach(java.util.function.Consumer<? super T>)

spliterator

@Deprecated
default java.util.Spliterator<Archive.Entry> spliterator()

Deprecated. since 2.3.0 for removal in 2.5.0 in favor of using JarFile to access entries and getNestedArchives(EntryFilter, EntryFilter) for accessing nested archives.

Creates a Spliterator over the elements described by this Iterable.

Specified by:

spliterator in interface java.lang.Iterable<Archive.Entry>

See Also:

Iterable.spliterator()

isExploded

default boolean isExploded()

Return if the archive is exploded (already unpacked).

Returns:

if the archive is exploded

Since:

2.3.0

close

default void close()
            throws java.lang.Exception

Closes the Archive, releasing any open resources.

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.lang.Exception - if an error occurs during close processing

Since:

2.2.0