001: /*
002: * Copyright (c) 1998-2008 Caucho Technology -- all rights reserved
003: *
004: * This file is part of Resin(R) Open Source
005: *
006: * Each copy or derived work must preserve the copyright notice and this
007: * notice unmodified.
008: *
009: * Resin Open Source is free software; you can redistribute it and/or modify
010: * it under the terms of the GNU General Public License as published by
011: * the Free Software Foundation; either version 2 of the License, or
012: * (at your option) any later version.
013: *
014: * Resin Open Source is distributed in the hope that it will be useful,
015: * but WITHOUT ANY WARRANTY; without even the implied warranty of
016: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
017: * of NON-INFRINGEMENT. See the GNU General Public License for more
018: * details.
019: *
020: * You should have received a copy of the GNU General Public License
021: * along with Resin Open Source; if not, write to the
022: *
023: * Free Software Foundation, Inc.
024: * 59 Temple Place, Suite 330
025: * Boston, MA 02111-1307 USA
026: *
027: * @author Scott Ferguson
028: */
029:
030: package javax.persistence.spi;
031:
032: import javax.sql.DataSource;
033: import java.net.URL;
034: import java.util.List;
035: import java.util.Properties;
036:
037: /**
038: * Container interface when creating an EntityManagerFactory.
039: */
040: public interface PersistenceUnitInfo {
041: /**
042: * Returns the name.
043: */
044: public String getPersistenceUnitName();
045:
046: /**
047: * Returns the full class name of the persistence provider.
048: */
049: public String getPersistenceProviderClassName();
050:
051: /**
052: * Returns the transaction handling.
053: */
054: public PersistenceUnitTransactionType getTransactionType();
055:
056: /**
057: * Returns the jta-enabled data source.
058: */
059: public DataSource getJtaDataSource();
060:
061: /**
062: * Returns the non-jta-enabled data source.
063: */
064: public DataSource getNonJtaDataSource();
065:
066: /**
067: * Returns the mapping file names. The files are resource-loadable
068: * from the classpath.
069: */
070: public List<String> getMappingFileNames();
071:
072: /**
073: * Returns the list of jars for the managed classes.
074: */
075: public List<URL> getJarFileUrls();
076:
077: /**
078: * Returns the root persistence unit.
079: */
080: public URL getPersistenceUnitRootUrl();
081:
082: /**
083: * Returns the list of managed classes.
084: */
085: public List<String> getManagedClassNames();
086:
087: /**
088: * Returns true if only listed classes are allowed.
089: */
090: public boolean excludeUnlistedClasses();
091:
092: /**
093: * Returns a properties object.
094: */
095: public Properties getProperties();
096:
097: /**
098: * Returns the classloader the provider should use to load classes,
099: * resources or URLs.
100: */
101: public ClassLoader getClassLoader();
102:
103: /**
104: * Adds a class transformer.
105: */
106: public void addTransformer(ClassTransformer transformer);
107:
108: /**
109: * Returns a temporary class loader.
110: */
111: public ClassLoader getNewTempClassLoader();
112: }
|