Resolve Bug:445 Remove freemarker from config code generator.
[controller.git] / opendaylight / config / config-manager / src / main / java / org / opendaylight / controller / config / manager / impl / ConfigRegistryImpl.java
1 /*
2  * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.
3  *
4  * This program and the accompanying materials are made available under the
5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6  * and is available at http://www.eclipse.org/legal/epl-v10.html
7  */
8 package org.opendaylight.controller.config.manager.impl;
9
10 import com.google.common.collect.Maps;
11 import org.opendaylight.controller.config.api.ConflictingVersionException;
12 import org.opendaylight.controller.config.api.ModuleIdentifier;
13 import org.opendaylight.controller.config.api.RuntimeBeanRegistratorAwareModule;
14 import org.opendaylight.controller.config.api.ServiceReferenceWritableRegistry;
15 import org.opendaylight.controller.config.api.ValidationException;
16 import org.opendaylight.controller.config.api.jmx.CommitStatus;
17 import org.opendaylight.controller.config.api.jmx.ObjectNameUtil;
18 import org.opendaylight.controller.config.manager.impl.dependencyresolver.DestroyedModule;
19 import org.opendaylight.controller.config.manager.impl.dependencyresolver.ModuleInternalTransactionalInfo;
20 import org.opendaylight.controller.config.manager.impl.dynamicmbean.DynamicReadableWrapper;
21 import org.opendaylight.controller.config.manager.impl.factoriesresolver.HierarchicalConfigMBeanFactoriesHolder;
22 import org.opendaylight.controller.config.manager.impl.factoriesresolver.ModuleFactoriesResolver;
23 import org.opendaylight.controller.config.manager.impl.jmx.BaseJMXRegistrator;
24 import org.opendaylight.controller.config.manager.impl.jmx.ModuleJMXRegistrator;
25 import org.opendaylight.controller.config.manager.impl.jmx.RootRuntimeBeanRegistratorImpl;
26 import org.opendaylight.controller.config.manager.impl.jmx.TransactionJMXRegistrator;
27 import org.opendaylight.controller.config.manager.impl.osgi.BeanToOsgiServiceManager;
28 import org.opendaylight.controller.config.manager.impl.osgi.BeanToOsgiServiceManager.OsgiRegistration;
29 import org.opendaylight.controller.config.manager.impl.util.LookupBeansUtil;
30 import org.opendaylight.controller.config.manager.impl.util.ModuleQNameUtil;
31 import org.opendaylight.controller.config.spi.Module;
32 import org.opendaylight.controller.config.spi.ModuleFactory;
33 import org.opendaylight.yangtools.yang.data.impl.codec.CodecRegistry;
34 import org.osgi.framework.BundleContext;
35 import org.slf4j.Logger;
36 import org.slf4j.LoggerFactory;
37
38 import javax.annotation.concurrent.GuardedBy;
39 import javax.annotation.concurrent.NotThreadSafe;
40 import javax.annotation.concurrent.ThreadSafe;
41 import javax.management.InstanceAlreadyExistsException;
42 import javax.management.InstanceNotFoundException;
43 import javax.management.MBeanServer;
44 import javax.management.MBeanServerFactory;
45 import javax.management.ObjectName;
46 import java.util.ArrayList;
47 import java.util.Collection;
48 import java.util.Collections;
49 import java.util.HashMap;
50 import java.util.Iterator;
51 import java.util.LinkedList;
52 import java.util.List;
53 import java.util.Map;
54 import java.util.Map.Entry;
55 import java.util.Set;
56
57 /**
58  * Singleton that is responsible for creating and committing Config
59  * Transactions. It is registered in Platform MBean Server.
60  */
61 @ThreadSafe
62 public class ConfigRegistryImpl implements AutoCloseable, ConfigRegistryImplMXBean {
63     private static final Logger logger = LoggerFactory.getLogger(ConfigRegistryImpl.class);
64
65     private final ModuleFactoriesResolver resolver;
66     private final MBeanServer configMBeanServer;
67     private final CodecRegistry codecRegistry;
68
69     @GuardedBy("this")
70     private long version = 0;
71     @GuardedBy("this")
72     private long versionCounter = 0;
73
74     /**
75      * Contains current configuration in form of {moduleName:{instanceName,read
76      * only module}} for copying state to new transaction. Each running module
77      * is present just once, no matter how many interfaces it exposes.
78      */
79     @GuardedBy("this")
80     private final ConfigHolder currentConfig = new ConfigHolder();
81
82     /**
83      * Will return true unless there was a transaction that succeeded during
84      * validation but failed in second phase of commit. In this case the server
85      * is unstable and its state is undefined.
86      */
87     @GuardedBy("this")
88     private boolean isHealthy = true;
89
90     /**
91      * Holds Map<transactionName, transactionController> and purges it each time
92      * its content is requested.
93      */
94     @GuardedBy("this")
95     private final TransactionsHolder transactionsHolder = new TransactionsHolder();
96
97     private final BaseJMXRegistrator baseJMXRegistrator;
98
99     private final BeanToOsgiServiceManager beanToOsgiServiceManager;
100
101     // internal jmx server for read only beans
102     private final MBeanServer registryMBeanServer;
103     // internal jmx server shared by all transactions
104     private final MBeanServer transactionsMBeanServer;
105
106     // Used for finding new factory instances for default module functionality
107     @GuardedBy("this")
108     private List<ModuleFactory> lastListOfFactories = Collections.emptyList();
109
110     @GuardedBy("this") // switched in every 2ndPC
111     private CloseableServiceReferenceReadableRegistry readableSRRegistry = ServiceReferenceRegistryImpl.createInitialSRLookupRegistry();
112
113     // constructor
114     public ConfigRegistryImpl(ModuleFactoriesResolver resolver,
115                               MBeanServer configMBeanServer, CodecRegistry codecRegistry) {
116         this(resolver, configMBeanServer,
117                 new BaseJMXRegistrator(configMBeanServer), codecRegistry);
118     }
119
120     // constructor
121     public ConfigRegistryImpl(ModuleFactoriesResolver resolver,
122                               MBeanServer configMBeanServer,
123                               BaseJMXRegistrator baseJMXRegistrator, CodecRegistry codecRegistry) {
124         this.resolver = resolver;
125         this.beanToOsgiServiceManager = new BeanToOsgiServiceManager();
126         this.configMBeanServer = configMBeanServer;
127         this.baseJMXRegistrator = baseJMXRegistrator;
128         this.codecRegistry = codecRegistry;
129         this.registryMBeanServer = MBeanServerFactory
130                 .createMBeanServer("ConfigRegistry" + configMBeanServer.getDefaultDomain());
131         this.transactionsMBeanServer = MBeanServerFactory
132                 .createMBeanServer("ConfigTransactions" + configMBeanServer.getDefaultDomain());
133     }
134
135     /**
136      * Create new {@link ConfigTransactionControllerImpl }
137      */
138     @Override
139     public synchronized ObjectName beginConfig() {
140         return beginConfig(false);
141     }
142
143     /**
144      * @param blankTransaction true if this transaction is created automatically by
145      *                         org.opendaylight.controller.config.manager.impl.osgi.BlankTransactionServiceTracker
146      */
147     public synchronized ObjectName beginConfig(boolean blankTransaction) {
148         return beginConfigInternal(blankTransaction).getControllerObjectName();
149     }
150
151     private synchronized ConfigTransactionControllerInternal beginConfigInternal(boolean blankTransaction) {
152         versionCounter++;
153         final String transactionName = "ConfigTransaction-" + version + "-" + versionCounter;
154
155         TransactionJMXRegistratorFactory factory = new TransactionJMXRegistratorFactory() {
156             @Override
157             public TransactionJMXRegistrator create() {
158                 return baseJMXRegistrator.createTransactionJMXRegistrator(transactionName);
159             }
160         };
161
162         Map<String, Map.Entry<ModuleFactory, BundleContext>> allCurrentFactories = Collections.unmodifiableMap(
163                 resolver.getAllFactories());
164
165         // closed by transaction controller
166         ConfigTransactionLookupRegistry txLookupRegistry = new ConfigTransactionLookupRegistry(new TransactionIdentifier(
167                 transactionName), factory, allCurrentFactories);
168         ServiceReferenceWritableRegistry writableRegistry = ServiceReferenceRegistryImpl.createSRWritableRegistry(
169                 readableSRRegistry, txLookupRegistry, allCurrentFactories);
170
171         ConfigTransactionControllerInternal transactionController = new ConfigTransactionControllerImpl(
172                 txLookupRegistry, version, codecRegistry,
173                 versionCounter, allCurrentFactories, transactionsMBeanServer,
174                 configMBeanServer, blankTransaction, writableRegistry);
175         try {
176             txLookupRegistry.registerMBean(transactionController, transactionController.getControllerObjectName());
177         } catch (InstanceAlreadyExistsException e) {
178             throw new IllegalStateException(e);
179         }
180         transactionController.copyExistingModulesAndProcessFactoryDiff(currentConfig.getEntries(), lastListOfFactories);
181         transactionsHolder.add(transactionName, transactionController, txLookupRegistry);
182         return transactionController;
183     }
184
185     /**
186      * {@inheritDoc}
187      */
188     @Override
189     @SuppressWarnings("PMD.AvoidCatchingThrowable")
190     public synchronized CommitStatus commitConfig(ObjectName transactionControllerON)
191             throws ConflictingVersionException, ValidationException {
192         final String transactionName = ObjectNameUtil
193                 .getTransactionName(transactionControllerON);
194         logger.trace("About to commit {}. Current parentVersion: {}, versionCounter {}", transactionName, version, versionCounter);
195
196         // find ConfigTransactionController
197         Map<String, Entry<ConfigTransactionControllerInternal, ConfigTransactionLookupRegistry>> transactions = transactionsHolder.getCurrentTransactions();
198         Entry<ConfigTransactionControllerInternal, ConfigTransactionLookupRegistry> configTransactionControllerEntry = transactions.get(transactionName);
199         if (configTransactionControllerEntry == null) {
200             throw new IllegalArgumentException(String.format(
201                     "Transaction with name '%s' not found", transactionName));
202         }
203         ConfigTransactionControllerInternal configTransactionController = configTransactionControllerEntry.getKey();
204         // check optimistic lock
205         if (version != configTransactionController.getParentVersion()) {
206             throw new ConflictingVersionException(
207                     String.format(
208                             "Optimistic lock failed. Expected parent version %d, was %d",
209                             version,
210                             configTransactionController.getParentVersion()));
211         }
212         // optimistic lock ok
213
214         CommitInfo commitInfo = configTransactionController.validateBeforeCommitAndLockTransaction();
215         lastListOfFactories = Collections.unmodifiableList(configTransactionController.getCurrentlyRegisteredFactories());
216         // non recoverable from here:
217         try {
218             return secondPhaseCommit(configTransactionController, commitInfo, configTransactionControllerEntry.getValue());
219         } catch (Throwable t) { // some libs throw Errors: e.g.
220             // javax.xml.ws.spi.FactoryFinder$ConfigurationError
221             isHealthy = false;
222             logger.error("Configuration Transaction failed on 2PC, server is unhealthy", t);
223             if (t instanceof RuntimeException) {
224                 throw (RuntimeException) t;
225             } else if (t instanceof Error) {
226                 throw (Error) t;
227             } else {
228                 throw new RuntimeException(t);
229             }
230         }
231     }
232
233     private CommitStatus secondPhaseCommit(ConfigTransactionControllerInternal configTransactionController,
234                                            CommitInfo commitInfo, ConfigTransactionLookupRegistry txLookupRegistry) {
235
236         // close instances which were destroyed by the user, including
237         // (hopefully) runtime beans
238         for (DestroyedModule toBeDestroyed : commitInfo
239                 .getDestroyedFromPreviousTransactions()) {
240             toBeDestroyed.close(); // closes instance (which should close
241             // runtime jmx registrator),
242             // also closes osgi registration and ModuleJMXRegistrator
243             // registration
244             currentConfig.remove(toBeDestroyed.getIdentifier());
245         }
246
247         // set RuntimeBeanRegistrators on beans implementing
248         // RuntimeBeanRegistratorAwareModule, each module
249         // should have exactly one runtime jmx registrator.
250         Map<ModuleIdentifier, RootRuntimeBeanRegistratorImpl> runtimeRegistrators = new HashMap<>();
251         for (ModuleInternalTransactionalInfo entry : commitInfo.getCommitted()
252                 .values()) {
253             RootRuntimeBeanRegistratorImpl runtimeBeanRegistrator;
254             if (entry.hasOldModule() == false) {
255                 runtimeBeanRegistrator = baseJMXRegistrator
256                         .createRuntimeBeanRegistrator(entry.getIdentifier());
257             } else {
258                 // reuse old JMX registrator
259                 runtimeBeanRegistrator = entry.getOldInternalInfo()
260                         .getRuntimeBeanRegistrator();
261             }
262             // set runtime jmx registrator if required
263             Module module = entry.getProxiedModule();
264             if (module instanceof RuntimeBeanRegistratorAwareModule) {
265                 ((RuntimeBeanRegistratorAwareModule) module)
266                         .setRuntimeBeanRegistrator(runtimeBeanRegistrator);
267             }
268             // save it to info so it is accessible afterwards
269             runtimeRegistrators.put(entry.getIdentifier(), runtimeBeanRegistrator);
270         }
271
272         // can register runtime beans
273         List<ModuleIdentifier> orderedModuleIdentifiers = configTransactionController.secondPhaseCommit();
274         txLookupRegistry.close();
275         configTransactionController.close();
276
277         // copy configuration to read only mode
278         List<ObjectName> newInstances = new LinkedList<>();
279         List<ObjectName> reusedInstances = new LinkedList<>();
280         List<ObjectName> recreatedInstances = new LinkedList<>();
281
282         Map<Module, ModuleInternalInfo> newConfigEntries = new HashMap<>();
283
284         int orderingIdx = 0;
285         for (ModuleIdentifier moduleIdentifier : orderedModuleIdentifiers) {
286             logger.trace("Registering {}", moduleIdentifier);
287             ModuleInternalTransactionalInfo entry = commitInfo.getCommitted()
288                     .get(moduleIdentifier);
289             if (entry == null) {
290                 throw new NullPointerException("Module not found "
291                         + moduleIdentifier);
292             }
293
294             ObjectName primaryReadOnlyON = ObjectNameUtil
295                     .createReadOnlyModuleON(moduleIdentifier);
296
297             // determine if current instance was recreated or reused or is new
298
299             // rules for closing resources:
300             // osgi registration - will be reused if possible.
301             // module jmx registration - will be (re)created every time, needs
302             // to be closed here
303             // runtime jmx registration - should be taken care of by module
304             // itself
305             // instance - is closed only if it was destroyed
306             ModuleJMXRegistrator newModuleJMXRegistrator = baseJMXRegistrator
307                     .createModuleJMXRegistrator();
308
309             OsgiRegistration osgiRegistration = null;
310             AutoCloseable instance = entry.getProxiedModule().getInstance();
311             if (entry.hasOldModule()) {
312                 ModuleInternalInfo oldInternalInfo = entry.getOldInternalInfo();
313                 DynamicReadableWrapper oldReadableConfigBean = oldInternalInfo.getReadableModule();
314                 currentConfig.remove(entry.getIdentifier());
315
316                 // test if old instance == new instance
317                 if (oldReadableConfigBean.getInstance().equals(instance)) {
318                     // reused old instance:
319                     // wrap in readable dynamic mbean
320                     reusedInstances.add(primaryReadOnlyON);
321                     osgiRegistration = oldInternalInfo.getOsgiRegistration();
322                 } else {
323                     // recreated instance:
324                     // it is responsibility of module to call the old instance -
325                     // we just need to unregister configbean
326                     recreatedInstances.add(primaryReadOnlyON);
327
328                     // close old osgi registration
329                     oldInternalInfo.getOsgiRegistration().close();
330                 }
331
332                 // close old module jmx registrator
333                 oldInternalInfo.getModuleJMXRegistrator().close();
334             } else {
335                 // new instance:
336                 // wrap in readable dynamic mbean
337                 newInstances.add(primaryReadOnlyON);
338             }
339             Module realModule = entry.getRealModule();
340
341             DynamicReadableWrapper newReadableConfigBean = new DynamicReadableWrapper(
342                     realModule, instance, moduleIdentifier,
343                     registryMBeanServer, configMBeanServer);
344
345             // register to JMX
346             try {
347                 newModuleJMXRegistrator.registerMBean(newReadableConfigBean,
348                         primaryReadOnlyON);
349             } catch (InstanceAlreadyExistsException e) {
350                 throw new IllegalStateException(e);
351             }
352
353             // register to OSGi
354             if (osgiRegistration == null) {
355                 ModuleFactory moduleFactory = entry.getModuleFactory();
356                 if (moduleFactory != null) {
357                     BundleContext bc = configTransactionController.
358                             getModuleFactoryBundleContext(moduleFactory.getImplementationName());
359                     osgiRegistration = beanToOsgiServiceManager.registerToOsgi(realModule.getClass(),
360                             newReadableConfigBean.getInstance(), entry.getIdentifier(), bc);
361                 } else {
362                     throw new NullPointerException(entry.getIdentifier().getFactoryName() + " ModuleFactory not found.");
363                 }
364
365             }
366
367             RootRuntimeBeanRegistratorImpl runtimeBeanRegistrator = runtimeRegistrators
368                     .get(entry.getIdentifier());
369             ModuleInternalInfo newInfo = new ModuleInternalInfo(
370                     entry.getIdentifier(), newReadableConfigBean, osgiRegistration,
371                     runtimeBeanRegistrator, newModuleJMXRegistrator,
372                     orderingIdx, entry.isDefaultBean());
373
374             newConfigEntries.put(realModule, newInfo);
375             orderingIdx++;
376         }
377         currentConfig.addAll(newConfigEntries.values());
378
379         // update version
380         version = configTransactionController.getVersion();
381
382         // switch readable Service Reference Registry
383         this.readableSRRegistry.close();
384         this.readableSRRegistry = ServiceReferenceRegistryImpl.createSRReadableRegistry(
385                 configTransactionController.getWritableRegistry(), this, baseJMXRegistrator);
386
387         return new CommitStatus(newInstances, reusedInstances,
388                 recreatedInstances);
389     }
390
391     /**
392      * {@inheritDoc}
393      */
394     @Override
395     public synchronized List<ObjectName> getOpenConfigs() {
396         Map<String, Entry<ConfigTransactionControllerInternal, ConfigTransactionLookupRegistry>> transactions = transactionsHolder
397                 .getCurrentTransactions();
398         List<ObjectName> result = new ArrayList<>(transactions.size());
399         for (Entry<ConfigTransactionControllerInternal, ConfigTransactionLookupRegistry> configTransactionControllerEntry : transactions
400                 .values()) {
401             result.add(configTransactionControllerEntry.getKey().getControllerObjectName());
402         }
403         return result;
404     }
405
406     /**
407      * Abort open transactions and unregister read only modules. Since this
408      * class is not responsible for registering itself under
409      * {@link org.opendaylight.controller.config.api.ConfigRegistry#OBJECT_NAME}, it will not unregister itself
410      * here.
411      */
412     @Override
413     public synchronized void close() {
414         // abort transactions
415         Map<String, Entry<ConfigTransactionControllerInternal, ConfigTransactionLookupRegistry>> transactions = transactionsHolder
416                 .getCurrentTransactions();
417         for (Entry<ConfigTransactionControllerInternal, ConfigTransactionLookupRegistry> configTransactionControllerEntry : transactions
418                 .values()) {
419
420             ConfigTransactionControllerInternal configTransactionController = configTransactionControllerEntry.getKey();
421             try {
422                 configTransactionControllerEntry.getValue().close();
423                 configTransactionController.abortConfig();
424             } catch (RuntimeException e) {
425                 logger.warn("Ignoring exception while aborting {}",
426                         configTransactionController, e);
427             }
428         }
429
430         // destroy all live objects one after another in order of the dependency
431         // hierarchy
432         List<DestroyedModule> destroyedModules = currentConfig
433                 .getModulesToBeDestroyed();
434         for (DestroyedModule destroyedModule : destroyedModules) {
435             destroyedModule.close();
436         }
437         // unregister MBeans that failed to unregister properly
438         baseJMXRegistrator.close();
439         // remove jmx servers
440         MBeanServerFactory.releaseMBeanServer(registryMBeanServer);
441         MBeanServerFactory.releaseMBeanServer(transactionsMBeanServer);
442
443     }
444
445     /**
446      * {@inheritDoc}
447      */
448     @Override
449     public long getVersion() {
450         return version;
451     }
452
453     /**
454      * {@inheritDoc}
455      */
456     @Override
457     public Set<String> getAvailableModuleNames() {
458         return new HierarchicalConfigMBeanFactoriesHolder(
459                 resolver.getAllFactories()).getModuleNames();
460     }
461
462     /**
463      * {@inheritDoc}
464      */
465     @Override
466     public boolean isHealthy() {
467         return isHealthy;
468     }
469
470     // filtering methods
471
472     /**
473      * {@inheritDoc}
474      */
475     @Override
476     public Set<ObjectName> lookupConfigBeans() {
477         return lookupConfigBeans("*", "*");
478     }
479
480     /**
481      * {@inheritDoc}
482      */
483     @Override
484     public Set<ObjectName> lookupConfigBeans(String moduleName) {
485         return lookupConfigBeans(moduleName, "*");
486     }
487
488     /**
489      * {@inheritDoc}
490      */
491     @Override
492     public ObjectName lookupConfigBean(String moduleName, String instanceName)
493             throws InstanceNotFoundException {
494         return LookupBeansUtil.lookupConfigBean(this, moduleName, instanceName);
495     }
496
497     /**
498      * {@inheritDoc}
499      */
500     @Override
501     public Set<ObjectName> lookupConfigBeans(String moduleName,
502                                              String instanceName) {
503         ObjectName namePattern = ObjectNameUtil.createModulePattern(moduleName,
504                 instanceName);
505         return baseJMXRegistrator.queryNames(namePattern, null);
506     }
507
508     /**
509      * {@inheritDoc}
510      */
511     @Override
512     public Set<ObjectName> lookupRuntimeBeans() {
513         return lookupRuntimeBeans("*", "*");
514     }
515
516     /**
517      * {@inheritDoc}
518      */
519     @Override
520     public Set<ObjectName> lookupRuntimeBeans(String moduleName,
521                                               String instanceName) {
522         if (moduleName == null) {
523             moduleName = "*";
524         }
525         if (instanceName == null) {
526             instanceName = "*";
527         }
528         ObjectName namePattern = ObjectNameUtil.createRuntimeBeanPattern(
529                 moduleName, instanceName);
530         return baseJMXRegistrator.queryNames(namePattern, null);
531     }
532
533     @Override
534     public void checkConfigBeanExists(ObjectName objectName) throws InstanceNotFoundException {
535         ObjectNameUtil.checkDomain(objectName);
536         ObjectNameUtil.checkType(objectName, ObjectNameUtil.TYPE_MODULE);
537         String transactionName = ObjectNameUtil.getTransactionName(objectName);
538         if (transactionName != null) {
539             throw new IllegalArgumentException("Transaction attribute not supported in registry, wrong ObjectName: " + objectName);
540         }
541         // make sure exactly one match is found:
542         LookupBeansUtil.lookupConfigBean(this, ObjectNameUtil.getFactoryName(objectName), ObjectNameUtil.getInstanceName(objectName));
543     }
544
545     // service reference functionality:
546     @Override
547     public synchronized ObjectName lookupConfigBeanByServiceInterfaceName(String serviceInterfaceQName, String refName) {
548         return readableSRRegistry.lookupConfigBeanByServiceInterfaceName(serviceInterfaceQName, refName);
549     }
550
551     @Override
552     public synchronized Map<String, Map<String, ObjectName>> getServiceMapping() {
553         return readableSRRegistry.getServiceMapping();
554     }
555
556     @Override
557     public synchronized Map<String, ObjectName> lookupServiceReferencesByServiceInterfaceName(String serviceInterfaceQName) {
558         return readableSRRegistry.lookupServiceReferencesByServiceInterfaceName(serviceInterfaceQName);
559     }
560
561     @Override
562     public synchronized Set<String> lookupServiceInterfaceNames(ObjectName objectName) throws InstanceNotFoundException {
563         return readableSRRegistry.lookupServiceInterfaceNames(objectName);
564     }
565
566     @Override
567     public synchronized String getServiceInterfaceName(String namespace, String localName) {
568         return readableSRRegistry.getServiceInterfaceName(namespace, localName);
569     }
570
571     @Override
572     public void checkServiceReferenceExists(ObjectName objectName) throws InstanceNotFoundException {
573         readableSRRegistry.checkServiceReferenceExists(objectName);
574     }
575
576     @Override
577     public ObjectName getServiceReference(String serviceInterfaceQName, String refName) throws InstanceNotFoundException {
578         return readableSRRegistry.getServiceReference(serviceInterfaceQName, refName);
579     }
580
581     @Override
582     public Set<String> getAvailableModuleFactoryQNames() {
583         return ModuleQNameUtil.getQNames(resolver.getAllFactories());
584     }
585
586     @Override
587     public String toString() {
588         return "ConfigRegistryImpl{" +
589                 "versionCounter=" + versionCounter +
590                 ", version=" + version +
591                 '}';
592     }
593 }
594
595 /**
596  * Holds currently running modules
597  */
598 @NotThreadSafe
599 class ConfigHolder {
600     private final Map<ModuleIdentifier, ModuleInternalInfo> currentConfig = new HashMap<>();
601
602     /**
603      * Add all modules to the internal map. Also add service instance to OSGi
604      * Service Registry.
605      */
606     public void addAll(Collection<ModuleInternalInfo> configInfos) {
607         if (currentConfig.size() > 0) {
608             throw new IllegalStateException(
609                     "Error - some config entries were not removed: "
610                             + currentConfig);
611         }
612         for (ModuleInternalInfo configInfo : configInfos) {
613             add(configInfo);
614         }
615     }
616
617     private void add(ModuleInternalInfo configInfo) {
618         ModuleInternalInfo oldValue = currentConfig.put(configInfo.getIdentifier(),
619                 configInfo);
620         if (oldValue != null) {
621             throw new IllegalStateException(
622                     "Cannot overwrite module with same name:"
623                             + configInfo.getIdentifier() + ":" + configInfo);
624         }
625     }
626
627     /**
628      * Remove entry from current config.
629      */
630     public void remove(ModuleIdentifier name) {
631         ModuleInternalInfo removed = currentConfig.remove(name);
632         if (removed == null) {
633             throw new IllegalStateException(
634                     "Cannot remove from ConfigHolder - name not found:" + name);
635         }
636     }
637
638     public Collection<ModuleInternalInfo> getEntries() {
639         return currentConfig.values();
640     }
641
642     public List<DestroyedModule> getModulesToBeDestroyed() {
643         List<DestroyedModule> result = new ArrayList<>();
644         for (ModuleInternalInfo moduleInternalInfo : getEntries()) {
645             result.add(moduleInternalInfo.toDestroyedModule());
646         }
647         Collections.sort(result);
648         return result;
649     }
650
651
652 }
653
654 /**
655  * Holds Map<transactionName, transactionController> and purges it each time its
656  * content is requested.
657  */
658 @NotThreadSafe
659 class TransactionsHolder {
660     /**
661      * This map keeps transaction names and
662      * {@link ConfigTransactionControllerInternal} instances, because platform
663      * MBeanServer transforms mbeans into another representation. Map is cleaned
664      * every time current transactions are requested.
665      */
666     @GuardedBy("ConfigRegistryImpl.this")
667     private final Map<String /* transactionName */,
668             Entry<ConfigTransactionControllerInternal, ConfigTransactionLookupRegistry>> transactions = new HashMap<>();
669
670     /**
671      * Can only be called from within synchronized method.
672      */
673     public void add(String transactionName,
674                     ConfigTransactionControllerInternal transactionController, ConfigTransactionLookupRegistry txLookupRegistry) {
675         Object oldValue = transactions.put(transactionName,
676                 Maps.immutableEntry(transactionController, txLookupRegistry));
677         if (oldValue != null) {
678             throw new IllegalStateException(
679                     "Error: two transactions with same name");
680         }
681     }
682
683     /**
684      * Purges closed transactions from transactions map. Can only be called from
685      * within synchronized method. Calling this method more than once within the
686      * method can modify the resulting map that was obtained in previous calls.
687      *
688      * @return current view on transactions map.
689      */
690     public Map<String, Entry<ConfigTransactionControllerInternal, ConfigTransactionLookupRegistry>> getCurrentTransactions() {
691         // first, remove closed transaction
692         for (Iterator<Entry<String, Entry<ConfigTransactionControllerInternal, ConfigTransactionLookupRegistry>>> it = transactions
693                 .entrySet().iterator(); it.hasNext(); ) {
694             Entry<String, Entry<ConfigTransactionControllerInternal, ConfigTransactionLookupRegistry>> entry = it
695                     .next();
696             if (entry.getValue().getKey().isClosed()) {
697                 it.remove();
698             }
699         }
700         return Collections.unmodifiableMap(transactions);
701     }
702 }