01: /* Copyright (C) 2004 - 2007 db4objects Inc. http://www.db4o.com
02:
03: This file is part of the db4o open source object database.
04:
05: db4o is free software; you can redistribute it and/or modify it under
06: the terms of version 2 of the GNU General Public License as published
07: by the Free Software Foundation and as clarified by db4objects' GPL
08: interpretation policy, available at
09: http://www.db4o.com/about/company/legalpolicies/gplinterpretation/
10: Alternatively you can write to db4objects, Inc., 1900 S Norfolk Street,
11: Suite 350, San Mateo, CA 94403, USA.
12:
13: db4o is distributed in the hope that it will be useful, but WITHOUT ANY
14: WARRANTY; without even the implied warranty of MERCHANTABILITY or
15: FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16: for more details.
17:
18: You should have received a copy of the GNU General Public License along
19: with this program; if not, write to the Free Software Foundation, Inc.,
20: 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
21: package com.db4o.ext;
22:
23: import com.db4o.*;
24: import com.db4o.config.*;
25:
26: /**
27: * extended factory class with static methods to open special db4o sessions.
28: *
29: * @sharpen.rename ExtDb4oFactory
30: */
31: public class ExtDb4o extends Db4o {
32: /**
33: * Operates just like {@link ExtDb4o#openMemoryFile(Configuration, MemoryFile)}, but uses
34: * the global db4o {@link Configuration Configuration} context.
35: *
36: * opens an {@link ObjectContainer} for in-memory use .
37: * <br><br>In-memory ObjectContainers are useful for maximum performance
38: * on small databases, for swapping objects or for storing db4o format data
39: * to other media or other databases.<br><br>Be aware of the danger of running
40: * into OutOfMemory problems or complete loss of all data, in case of hardware
41: * or JVM failures.<br><br>
42: * @param memoryFile a {@link MemoryFile MemoryFile}
43: * to store the raw byte data.
44: * @return an open {@link com.db4o.ObjectContainer ObjectContainer}
45: * @see MemoryFile
46: */
47: public static final ObjectContainer openMemoryFile(
48: MemoryFile memoryFile) {
49: return openMemoryFile1(Db4o.newConfiguration(), memoryFile);
50: }
51:
52: /**
53: * opens an {@link ObjectContainer} for in-memory use .
54: * <br><br>In-memory ObjectContainers are useful for maximum performance
55: * on small databases, for swapping objects or for storing db4o format data
56: * to other media or other databases.<br><br>Be aware of the danger of running
57: * into OutOfMemory problems or complete loss of all data, in case of hardware
58: * or JVM failures.<br><br>
59: * @param config a custom {@link Configuration Configuration} instance to be obtained via {@link Db4o#newConfiguration()}
60: * @param memoryFile a {@link MemoryFile MemoryFile}
61: * to store the raw byte data.
62: * @return an open {@link com.db4o.ObjectContainer ObjectContainer}
63: * @see MemoryFile
64: */
65: public static final ObjectContainer openMemoryFile(
66: Configuration config, MemoryFile memoryFile) {
67: return openMemoryFile1(config, memoryFile);
68: }
69: }
|