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
|
/*
* Copyright 2006-2012 Amazon Technologies, Inc. or its affiliates.
* Amazon, Amazon.com and Carbonado are trademarks or registered trademarks
* of Amazon Technologies, Inc. or its affiliates. All rights reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.amazon.carbonado.repo.replicated;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import com.amazon.carbonado.FetchException;
import com.amazon.carbonado.PersistException;
import com.amazon.carbonado.Query;
import com.amazon.carbonado.Storage;
import com.amazon.carbonado.Storable;
import com.amazon.carbonado.Repository;
import com.amazon.carbonado.SupportException;
import com.amazon.carbonado.RepositoryException;
import com.amazon.carbonado.Trigger;
import com.amazon.carbonado.UnsupportedTypeException;
import com.amazon.carbonado.filter.Filter;
import com.amazon.carbonado.spi.BelatedStorageCreator;
/**
* ReplicatedStorage
*
* @author Don Schneider
* @author Brian S O'Neill
*/
class ReplicatedStorage<S extends Storable> implements Storage<S> {
final Storage<S> mReplicaStorage;
final Storage<S> mMasterStorage;
final ReplicationTrigger<S> mReplicationTrigger;
/**
* @throws UnsupportedTypeException if master doesn't support Storable, but
* it is marked as Independent
*/
public ReplicatedStorage(ReplicatedRepository aRepository, Storage<S> replicaStorage)
throws SupportException, RepositoryException, UnsupportedTypeException
{
mReplicaStorage = replicaStorage;
// Create master using BelatedStorageCreator such that we can start up
// and read from replica even if master is down.
Log log = LogFactory.getLog(getClass());
BelatedStorageCreator<S> creator = new BelatedStorageCreator<S>
(log, aRepository.getMasterRepository(), replicaStorage.getStorableType(),
ReplicatedRepositoryBuilder.DEFAULT_RETRY_MILLIS);
mMasterStorage = creator.get(ReplicatedRepositoryBuilder.DEFAULT_MASTER_TIMEOUT_MILLIS);
// ReplicationTrigger contains internal TriggerManager, and all other
// triggers should register with the ReplicationTrigger. This allows
// all triggers to be easily disabled during resync and repairs.
mReplicationTrigger = new ReplicationTrigger<S>
(aRepository, mReplicaStorage, mMasterStorage);
}
/**
* Exposed for testing only.
*/
ReplicatedStorage(ReplicatedRepository aRepository,
Storage<S> replicaStorage,
Storage<S> masterStorage)
{
mReplicaStorage = replicaStorage;
mMasterStorage = masterStorage;
mReplicationTrigger = new ReplicationTrigger<S>
(aRepository, mReplicaStorage, masterStorage);
}
public Class<S> getStorableType() {
return mReplicaStorage.getStorableType();
}
public S prepare() {
return mReplicaStorage.prepare();
}
public Query<S> query() throws FetchException {
return mReplicaStorage.query();
}
public Query<S> query(String filter) throws FetchException {
return mReplicaStorage.query(filter);
}
public Query<S> query(Filter<S> filter) throws FetchException {
return mReplicaStorage.query(filter);
}
/**
* @since 1.2
*/
public void truncate() throws PersistException {
mMasterStorage.truncate();
mReplicaStorage.truncate();
}
public boolean addTrigger(Trigger<? super S> trigger) {
return mReplicationTrigger.addTrigger(trigger);
}
public boolean removeTrigger(Trigger<? super S> trigger) {
return mReplicationTrigger.removeTrigger(trigger);
}
ReplicationTrigger<S> getReplicationTrigger() {
return mReplicationTrigger;
}
}
|
