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(java.net.URL url) Build a descriptor of the archive indicated by the given url
ArchiveDescriptor	buildArchiveDescriptor(java.net.URL url, java.lang.String path) Build a descriptor of the archive indicated by the path relative to the given url
java.net.URL	getJarURLFromURLEntry(java.net.URL url, java.lang.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.
java.net.URL	getURLFromPath(java.lang.String jarPath) Deprecated. Not used!

Method Detail

buildArchiveDescriptor

ArchiveDescriptor buildArchiveDescriptor(java.net.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(java.net.URL url,
                                         java.lang.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

java.net.URL getJarURLFromURLEntry(java.net.URL url,
                                   java.lang.String entry)
                            throws java.lang.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:

java.lang.IllegalArgumentException - Generally indicates a problem with malformed urls.

getURLFromPath

@Deprecated
java.net.URL getURLFromPath(java.lang.String jarPath)

Deprecated. Not used!

Not used!

Parameters:

jarPath - The jar path

Returns:

The url from the path?