/*
* Hibernate, Relational Persistence for Idiomatic Java
*
* License: GNU Lesser General Public License (LGPL), version 2.1 or later.
* See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
*/
package org.hibernate.boot.archive.spi;
import java.net.URL;
Contract for building ArchiveDescriptor instances.
Author: Steve Ebersole
/**
* Contract for building ArchiveDescriptor instances.
*
* @author Steve Ebersole
*/
public interface ArchiveDescriptorFactory {
Build a descriptor of the archive indicated by the given url
Params: - url – The url to the archive
Returns: The descriptor
/**
* Build a descriptor of the archive indicated by the given url
*
* @param url The url to the archive
*
* @return The descriptor
*/
public ArchiveDescriptor buildArchiveDescriptor(URL url);
Build a descriptor of the archive indicated by the path relative to the given url
Params: - url – The url to the archive
- path – The path within the given url that refers to the archive
Returns: The descriptor
/**
* Build a descriptor of the archive indicated by the path relative to the given url
*
* @param url The url to the archive
* @param path The path within the given url that refers to the archive
*
* @return The descriptor
*/
public ArchiveDescriptor buildArchiveDescriptor(URL url, String path);
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.
Params: - 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
Throws: - IllegalArgumentException – Generally indicates a problem with malformed urls.
Returns: The URL to the JAR
/**
* 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.
*
* @param url The URL to an entry within a JAR
* @param entry The entry that described the thing referred to by the URL relative to the JAR
*
* @return The URL to the JAR
*
* @throws IllegalArgumentException Generally indicates a problem with malformed urls.
*/
public URL getJarURLFromURLEntry(URL url, String entry) throws IllegalArgumentException;
Not used!
Params: - jarPath – The jar path
Returns: The url from the path? Deprecated: Not used!
/**
* Not used!
*
* @param jarPath The jar path
*
* @return The url from the path?
*
* @deprecated Not used!
*/
@Deprecated
@SuppressWarnings("UnusedDeclaration")
public URL getURLFromPath(String jarPath);
}