1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
/*-
* See the file LICENSE for redistribution information.
*
* Copyright (c) 2000, 2012 Oracle and/or its affiliates. All rights reserved.
*
*/
package com.sleepycat.collections;
import com.sleepycat.bind.EntryBinding;
import com.sleepycat.bind.serial.ClassCatalog;
import com.sleepycat.bind.serial.TupleSerialMarshalledBinding;
import com.sleepycat.bind.serial.TupleSerialMarshalledKeyCreator;
import com.sleepycat.bind.tuple.MarshalledTupleEntry; // for javadoc
import com.sleepycat.bind.tuple.MarshalledTupleKeyEntity;
import com.sleepycat.bind.tuple.TupleBinding;
import com.sleepycat.bind.tuple.TupleMarshalledBinding;
import com.sleepycat.db.Database;
/**
* Creates stored collections having tuple keys and serialized entity values.
* The entity classes must be Serializable and must implement the
* MarshalledTupleKeyEntity interfaces. The key classes must either implement
* the MarshalledTupleEntry interface or be one of the Java primitive type
* classes. Underlying binding objects are created automatically.
*
* @author Mark Hayes
*/
public class TupleSerialFactory {
private ClassCatalog catalog;
/**
* Creates a tuple-serial factory for given environment and class catalog.
*/
public TupleSerialFactory(ClassCatalog catalog) {
this.catalog = catalog;
}
/**
* Returns the class catalog associated with this factory.
*/
public final ClassCatalog getCatalog() {
return catalog;
}
/**
* Creates a map from a previously opened Database object.
*
* @param db the previously opened Database object.
*
* @param keyClass is the class used for map keys. It must implement the
* {@link MarshalledTupleEntry} interface or be one of the Java primitive
* type classes.
*
* @param valueBaseClass the base class of the entity values for this
* store. It must implement the {@link MarshalledTupleKeyEntity}
* interface.
*
* @param writeAllowed is true to create a read-write collection or false
* to create a read-only collection.
*/
public <K, V extends MarshalledTupleKeyEntity> StoredMap<K, V>
newMap(Database db,
Class<K> keyClass,
Class<V> valueBaseClass,
boolean writeAllowed) {
return new StoredMap<K, V>(db,
getKeyBinding(keyClass),
getEntityBinding(valueBaseClass),
writeAllowed);
}
/**
* Creates a sorted map from a previously opened Database object.
*
* @param db the previously opened Database object.
*
* @param keyClass is the class used for map keys. It must implement the
* {@link MarshalledTupleEntry} interface or be one of the Java primitive
* type classes.
*
* @param valueBaseClass the base class of the entity values for this
* store. It must implement the {@link MarshalledTupleKeyEntity}
* interface.
*
* @param writeAllowed is true to create a read-write collection or false
* to create a read-only collection.
*/
public <K, V extends MarshalledTupleKeyEntity> StoredSortedMap<K, V>
newSortedMap(Database db,
Class<K> keyClass,
Class<V> valueBaseClass,
boolean writeAllowed) {
return new StoredSortedMap(db,
getKeyBinding(keyClass),
getEntityBinding(valueBaseClass),
writeAllowed);
}
/**
* Creates a <code>SecondaryKeyCreator</code> object for use in configuring
* a <code>SecondaryDatabase</code>. The returned object implements
* the {@link com.sleepycat.db.SecondaryKeyCreator} interface.
*
* @param valueBaseClass the base class of the entity values for this
* store. It must implement the {@link MarshalledTupleKeyEntity}
* interface.
*
* @param keyName is the key name passed to the {@link
* MarshalledTupleKeyEntity#marshalSecondaryKey} method to identify the
* secondary key.
*/
public <V extends MarshalledTupleKeyEntity>
TupleSerialMarshalledKeyCreator<V>
getKeyCreator(Class<V> valueBaseClass, String keyName) {
return new TupleSerialMarshalledKeyCreator<V>
(getEntityBinding(valueBaseClass), keyName);
}
public <V extends MarshalledTupleKeyEntity>
TupleSerialMarshalledBinding<V>
getEntityBinding(Class<V> baseClass) {
return new TupleSerialMarshalledBinding<V>(catalog, baseClass);
}
private <K> EntryBinding<K> getKeyBinding(Class<K> keyClass) {
EntryBinding<K> binding = TupleBinding.getPrimitiveBinding(keyClass);
if (binding == null) {
/*
* Cannot use type param <K> here because it does not implement
* MarshalledTupleEntry if it is a primitive class.
*/
binding = new TupleMarshalledBinding(keyClass);
}
return binding;
}
}
|
