org.hibernate.boot.archive.spi

Interface ArchiveDescriptorFactory

All Known Implementing Classes:

AbstractArchiveDescriptorFactory, OsgiArchiveDescriptorFactory, StandardArchiveDescriptorFactory

public interface ArchiveDescriptorFactory

Contract for building ArchiveDescriptor instances.

Method Summary

Modifier and Type	Method and Description
ArchiveDescriptor	buildArchiveDescriptor(URL url) Build a descriptor of the archive indicated by the given url
ArchiveDescriptor	buildArchiveDescriptor(URL url, String path) Build a descriptor of the archive indicated by the path relative to the given url
URL	getJarURLFromURLEntry(URL url, String entry) Given a URL which defines an entry within a JAR (really any "bundled archive" such as a jar file, zip, etc) and an entry within that JAR, find the URL to the JAR itself.
URL	getURLFromPath(String jarPath) Deprecated. Not used!

Method Detail

buildArchiveDescriptor

ArchiveDescriptor buildArchiveDescriptor(URL url)

Build a descriptor of the archive indicated by the given url

Parameters:

url - The url to the archive

Returns:

The descriptor

buildArchiveDescriptor

ArchiveDescriptor buildArchiveDescriptor(URL url,
                                         String path)

Build a descriptor of the archive indicated by the path relative to the given url

Parameters:

url - The url to the archive

path - The path within the given url that refers to the archive

Returns:

The descriptor

getJarURLFromURLEntry

URL getJarURLFromURLEntry(URL url,
                          String entry)
                   throws IllegalArgumentException

Given a URL which defines an entry within a JAR (really any "bundled archive" such as a jar file, zip, etc) and an entry within that JAR, find the URL to the JAR itself.

Parameters:

url - The URL to an entry within a JAR

entry - The entry that described the thing referred to by the URL relative to the JAR

Returns:

The URL to the JAR

Throws:

IllegalArgumentException - Generally indicates a problem with malformed urls.

getURLFromPath

@Deprecated
URL getURLFromPath(String jarPath)

Deprecated. Not used!

Not used!

Parameters:

jarPath - The jar path

Returns:

The url from the path?