程序包 org.hibernate.boot

类 MetadataSources

  • 所有已实现的接口:
    Serializable
    public class MetadataSources
extends Object
implements Serializable
    Entry point into working with sources of metadata information (mapping XML, annotations). Tell Hibernate about sources and then call buildMetadata(), or use getMetadataBuilder() to customize how sources are processed (naming strategies, etc).
    从以下版本开始:
    5.0
    作者:
    Steve Ebersole
    另请参阅:
    序列化表格

    • 构造器详细资料

      • MetadataSources

        public MetadataSources()

      • MetadataSources

        public MetadataSources​(ServiceRegistry serviceRegistry)
        Create a metadata sources using the specified service registry.
        参数:
        serviceRegistry - The service registry to use.

    • 方法详细资料

      • isExpectedServiceRegistryType

        protected static boolean isExpectedServiceRegistryType​(ServiceRegistry serviceRegistry)

      • getXmlBindings

        public List<Binding> getXmlBindings()

      • getMetadataBuilder

        public MetadataBuilder getMetadataBuilder()
        Get a builder for metadata where non-default options can be specified.
        返回:
        The built metadata.

      • addAnnotatedClass

        public MetadataSources addAnnotatedClass​(Class annotatedClass)
        Read metadata from the annotations attached to the given class.
        参数:
        annotatedClass - The class containing annotations
        返回:
        this (for method chaining)

      • addAnnotatedClassName

        public MetadataSources addAnnotatedClassName​(String annotatedClassName)
        Read metadata from the annotations attached to the given class. The important distinction here is that the Class will not be accessed until later which is important for on-the-fly bytecode-enhancement
        参数:
        annotatedClassName - The name of a class containing annotations
        返回:
        this (for method chaining)

      • addPackage

        public MetadataSources addPackage​(String packageName)
        Read package-level metadata.
        参数:
        packageName - java package name without trailing '.', cannot be null
        返回:
        this (for method chaining)

      • addPackage

        public MetadataSources addPackage​(Package packageRef)
        Read package-level metadata.
        参数:
        packageRef - Java Package reference
        返回:
        this (for method chaining)

      • addClass

        @Deprecated
public MetadataSources addClass​(Class entityClass)
        已过时。
        hbm.xml is a legacy mapping format now considered deprecated.
        Read a mapping as an application resource using the convention that a class named foo.bar.Foo is mapped by a file named foo/bar/Foo.hbm.xml which can be resolved as a classpath resource.
        参数:
        entityClass - The mapped class. Cannot be null null.
        返回:
        this (for method chaining purposes)

      • addResource

        public MetadataSources addResource​(String name)
        Read mappings as an application resourceName (i.e. classpath lookup).
        参数:
        name - The resource name
        返回:
        this (for method chaining purposes)

      • addFile

        public MetadataSources addFile​(File file)
        Read mappings from a particular XML file
        参数:
        file - The reference to the XML file
        返回:
        this (for method chaining purposes)

      • addCacheableFile

        public MetadataSources addCacheableFile​(File file)
        Add a cached mapping file. A cached file is a serialized representation of the DOM structure of a particular mapping. It is saved from a previous call as a file with the name {xmlFile}.bin where {xmlFile} is the name of the original mapping file.

        If a cached {xmlFile}.bin exists and is newer than {xmlFile}, the {xmlFile}.bin file will be read directly. Otherwise {xmlFile} is read and then serialized to {xmlFile}.bin for use the next time.
        参数:
        file - The cacheable mapping file to be added, {xmlFile} in above discussion.
        返回:
        this (for method chaining purposes)

      • addInputStream

        public MetadataSources addInputStream​(InputStreamAccess xmlInputStreamAccess)
        Read metadata from an InputStream access
        参数:
        xmlInputStreamAccess - Access to an input stream containing a DOM.
        返回:
        this (for method chaining purposes)

      • addInputStream

        public MetadataSources addInputStream​(InputStream xmlInputStream)
        Read metadata from an InputStream.
        参数:
        xmlInputStream - The input stream containing a DOM.
        返回:
        this (for method chaining purposes)

      • addURL

        public MetadataSources addURL​(URL url)
        Read mappings from a URL
        参数:
        url - The url for the mapping document to be read.
        返回:
        this (for method chaining purposes)

      • addDocument

        @Deprecated
public MetadataSources addDocument​(Document document)
        已过时。
        since 5.0. Use one of the other methods for passing mapping source(s).
        Read mappings from a DOM Document
        参数:
        document - The DOM document
        返回:
        this (for method chaining purposes)

      • addJar

        public MetadataSources addJar​(File jar)
        Read all mappings from a jar file.

        Assumes that any file named *.hbm.xml is a mapping document.

        参数:
        jar - a jar file
        返回:
        this (for method chaining purposes)

      • addDirectory

        public MetadataSources addDirectory​(File dir)
        Read all mapping documents from a directory tree.

        Assumes that any file named *.hbm.xml is a mapping document.

        参数:
        dir - The directory
        返回:
        this (for method chaining purposes)
        抛出:
        MappingException - Indicates problems reading the jar file or processing the contained mapping documents.