2 * Copyright (c) 2013 Cisco Systems, Inc. and others. All rights reserved.
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
9 package org.opendaylight.controller.netconf.confignetconfconnector.operations.editconfig;
11 import com.google.common.annotations.VisibleForTesting;
12 import com.google.common.base.Optional;
13 import com.google.common.base.Preconditions;
14 import com.google.common.collect.Maps;
15 import com.google.common.collect.Multimap;
16 import java.util.Date;
17 import java.util.HashMap;
20 import javax.management.InstanceNotFoundException;
21 import javax.management.ObjectName;
22 import org.opendaylight.controller.config.api.ValidationException;
23 import org.opendaylight.controller.config.util.ConfigRegistryClient;
24 import org.opendaylight.controller.config.util.ConfigTransactionClient;
25 import org.opendaylight.controller.config.yangjmxgenerator.ModuleMXBeanEntry;
26 import org.opendaylight.controller.netconf.api.NetconfDocumentedException;
27 import org.opendaylight.controller.netconf.api.NetconfDocumentedException.ErrorSeverity;
28 import org.opendaylight.controller.netconf.api.NetconfDocumentedException.ErrorTag;
29 import org.opendaylight.controller.netconf.api.NetconfDocumentedException.ErrorType;
30 import org.opendaylight.controller.netconf.confignetconfconnector.mapping.config.Config;
31 import org.opendaylight.controller.netconf.confignetconfconnector.mapping.config.InstanceConfig;
32 import org.opendaylight.controller.netconf.confignetconfconnector.mapping.config.InstanceConfigElementResolved;
33 import org.opendaylight.controller.netconf.confignetconfconnector.mapping.config.ModuleConfig;
34 import org.opendaylight.controller.netconf.confignetconfconnector.mapping.config.ModuleElementDefinition;
35 import org.opendaylight.controller.netconf.confignetconfconnector.mapping.config.ModuleElementResolved;
36 import org.opendaylight.controller.netconf.confignetconfconnector.mapping.config.Services;
37 import org.opendaylight.controller.netconf.confignetconfconnector.operations.AbstractConfigNetconfOperation;
38 import org.opendaylight.controller.netconf.confignetconfconnector.operations.editconfig.EditConfigXmlParser.EditConfigExecution;
39 import org.opendaylight.controller.netconf.confignetconfconnector.osgi.YangStoreSnapshot;
40 import org.opendaylight.controller.netconf.confignetconfconnector.transactions.TransactionProvider;
41 import org.opendaylight.controller.netconf.util.xml.XmlElement;
42 import org.opendaylight.controller.netconf.util.xml.XmlNetconfConstants;
43 import org.opendaylight.controller.netconf.util.xml.XmlUtil;
44 import org.opendaylight.yangtools.yang.model.api.IdentitySchemaNode;
45 import org.opendaylight.yangtools.yang.model.api.Module;
46 import org.slf4j.Logger;
47 import org.slf4j.LoggerFactory;
48 import org.w3c.dom.Document;
49 import org.w3c.dom.Element;
51 public class EditConfig extends AbstractConfigNetconfOperation {
53 private static final Logger logger = LoggerFactory.getLogger(EditConfig.class);
55 private final YangStoreSnapshot yangStoreSnapshot;
57 private final TransactionProvider transactionProvider;
58 private EditConfigXmlParser editConfigXmlParser;
60 public EditConfig(YangStoreSnapshot yangStoreSnapshot, TransactionProvider transactionProvider,
61 ConfigRegistryClient configRegistryClient, String netconfSessionIdForReporting) {
62 super(configRegistryClient, netconfSessionIdForReporting);
63 this.yangStoreSnapshot = yangStoreSnapshot;
64 this.transactionProvider = transactionProvider;
65 this.editConfigXmlParser = new EditConfigXmlParser();
69 Element getResponseInternal(final Document document,
70 final EditConfigXmlParser.EditConfigExecution editConfigExecution) throws NetconfDocumentedException {
72 if (editConfigExecution.shouldTest()) {
73 executeTests(getConfigRegistryClient(), editConfigExecution);
76 if (editConfigExecution.shouldSet()) {
77 executeSet(getConfigRegistryClient(), editConfigExecution);
80 logger.trace("Operation {} successful", EditConfigXmlParser.EDIT_CONFIG);
82 return XmlUtil.createElement(document, XmlNetconfConstants.OK, Optional.<String>absent());
85 private void executeSet(ConfigRegistryClient configRegistryClient,
86 EditConfigXmlParser.EditConfigExecution editConfigExecution) throws NetconfDocumentedException {
87 set(configRegistryClient, editConfigExecution);
88 logger.debug("Set phase for {} operation successful", EditConfigXmlParser.EDIT_CONFIG);
91 private void executeTests(ConfigRegistryClient configRegistryClient,
92 EditConfigExecution editConfigExecution) throws NetconfDocumentedException {
94 test(configRegistryClient, editConfigExecution, editConfigExecution.getDefaultStrategy());
95 } catch (final ValidationException e) {
96 logger.warn("Test phase for {} failed", EditConfigXmlParser.EDIT_CONFIG, e);
97 final Map<String, String> errorInfo = new HashMap<>();
98 errorInfo.put(ErrorTag.operation_failed.name(), e.getMessage());
99 throw new NetconfDocumentedException("Test phase: " + e.getMessage(), e, ErrorType.application,
100 ErrorTag.operation_failed, ErrorSeverity.error, errorInfo);
102 logger.debug("Test phase for {} operation successful", EditConfigXmlParser.EDIT_CONFIG);
105 private void test(ConfigRegistryClient configRegistryClient, EditConfigExecution execution,
106 EditStrategyType editStrategyType) throws ValidationException, NetconfDocumentedException {
107 ObjectName taON = transactionProvider.getTestTransaction();
109 // default strategy = replace wipes config
110 if (editStrategyType == EditStrategyType.replace) {
111 transactionProvider.wipeTestTransaction(taON);
114 ConfigTransactionClient ta = configRegistryClient.getConfigTransactionClient(taON);
116 handleMisssingInstancesOnTransaction(ta, execution);
117 setServicesOnTransaction(ta, execution);
118 setOnTransaction(ta, execution);
119 transactionProvider.validateTestTransaction(taON);
121 transactionProvider.abortTestTransaction(taON);
125 private void set(ConfigRegistryClient configRegistryClient,
126 EditConfigXmlParser.EditConfigExecution editConfigExecution) throws NetconfDocumentedException {
127 ObjectName taON = transactionProvider.getOrCreateTransaction();
129 // default strategy = replace wipes config
130 if (editConfigExecution.getDefaultStrategy() == EditStrategyType.replace) {
131 transactionProvider.wipeTransaction();
134 ConfigTransactionClient ta = configRegistryClient.getConfigTransactionClient(taON);
136 handleMisssingInstancesOnTransaction(ta, editConfigExecution);
137 setServicesOnTransaction(ta, editConfigExecution);
138 setOnTransaction(ta, editConfigExecution);
141 private void setServicesOnTransaction(ConfigTransactionClient ta, EditConfigExecution execution) throws NetconfDocumentedException {
143 Services services = execution.getServices();
145 Map<String, Map<String, Map<String, Services.ServiceInstance>>> namespaceToServiceNameToRefNameToInstance = services
146 .getNamespaceToServiceNameToRefNameToInstance();
148 for (String serviceNamespace : namespaceToServiceNameToRefNameToInstance.keySet()) {
149 for (String serviceName : namespaceToServiceNameToRefNameToInstance.get(serviceNamespace).keySet()) {
151 String qnameOfService = getQname(ta, serviceNamespace, serviceName);
152 Map<String, Services.ServiceInstance> refNameToInstance = namespaceToServiceNameToRefNameToInstance
153 .get(serviceNamespace).get(serviceName);
155 for (String refName : refNameToInstance.keySet()) {
156 ObjectName on = refNameToInstance.get(refName).getObjectName(ta.getTransactionName());
158 ObjectName saved = ta.saveServiceReference(qnameOfService, refName, on);
159 logger.debug("Saving service {} with on {} under name {} with service on {}", qnameOfService,
161 } catch (InstanceNotFoundException e) {
162 throw new NetconfDocumentedException(String.format("Unable to save ref name " + refName + " for instance " + on, e),
163 ErrorType.application,
164 ErrorTag.operation_failed,
165 ErrorSeverity.error);
172 private String getQname(ConfigTransactionClient ta, String namespace, String serviceName) {
173 return ta.getServiceInterfaceName(namespace, serviceName);
176 private void setOnTransaction(ConfigTransactionClient ta, EditConfigExecution execution) throws NetconfDocumentedException {
178 for (Multimap<String, ModuleElementResolved> modulesToResolved : execution.getResolvedXmlElements(ta).values()) {
180 for (Map.Entry<String, ModuleElementResolved> moduleToResolved : modulesToResolved.entries()) {
181 String moduleName = moduleToResolved.getKey();
183 ModuleElementResolved moduleElementResolved = moduleToResolved.getValue();
184 String instanceName = moduleElementResolved.getInstanceName();
186 InstanceConfigElementResolved ice = moduleElementResolved.getInstanceConfigElementResolved();
187 EditConfigStrategy strategy = ice.getEditStrategy();
188 strategy.executeConfiguration(moduleName, instanceName, ice.getConfiguration(), ta, execution.getServiceRegistryWrapper(ta));
193 private void handleMisssingInstancesOnTransaction(ConfigTransactionClient ta,
194 EditConfigExecution execution) throws NetconfDocumentedException {
196 for (Multimap<String,ModuleElementDefinition> modulesToResolved : execution.getModulesDefinition(ta).values()) {
197 for (Map.Entry<String, ModuleElementDefinition> moduleToResolved : modulesToResolved.entries()) {
198 String moduleName = moduleToResolved.getKey();
200 ModuleElementDefinition moduleElementDefinition = moduleToResolved.getValue();
202 EditConfigStrategy strategy = moduleElementDefinition.getEditStrategy();
203 strategy.executeConfiguration(moduleName, moduleElementDefinition.getInstanceName(), null, ta, execution.getServiceRegistryWrapper(ta));
208 public static Config getConfigMapping(ConfigRegistryClient configRegistryClient, YangStoreSnapshot yangStoreSnapshot) {
209 Map<String, Map<String, ModuleConfig>> factories = transformMbeToModuleConfigs(configRegistryClient,
210 yangStoreSnapshot.getModuleMXBeanEntryMap());
211 Map<String, Map<Date, IdentityMapping>> identitiesMap = transformIdentities(yangStoreSnapshot.getModules());
212 return new Config(factories, identitiesMap);
216 public static class IdentityMapping {
217 private final Map<String, IdentitySchemaNode> identityNameToSchemaNode;
220 this.identityNameToSchemaNode = Maps.newHashMap();
223 void addIdSchemaNode(IdentitySchemaNode node) {
224 String name = node.getQName().getLocalName();
225 Preconditions.checkState(!identityNameToSchemaNode.containsKey(name));
226 identityNameToSchemaNode.put(name, node);
229 public boolean containsIdName(String idName) {
230 return identityNameToSchemaNode.containsKey(idName);
235 private static Map<String, Map<Date, IdentityMapping>> transformIdentities(Set<Module> modules) {
236 Map<String, Map<Date, IdentityMapping>> mappedIds = Maps.newHashMap();
237 for (Module module : modules) {
238 String namespace = module.getNamespace().toString();
239 Map<Date, IdentityMapping> revisionsByNamespace= mappedIds.get(namespace);
240 if(revisionsByNamespace == null) {
241 revisionsByNamespace = Maps.newHashMap();
242 mappedIds.put(namespace, revisionsByNamespace);
245 Date revision = module.getRevision();
246 Preconditions.checkState(!revisionsByNamespace.containsKey(revision),
247 "Duplicate revision %s for namespace %s", revision, namespace);
249 IdentityMapping identityMapping = revisionsByNamespace.get(revision);
250 if(identityMapping == null) {
251 identityMapping = new IdentityMapping();
252 revisionsByNamespace.put(revision, identityMapping);
255 for (IdentitySchemaNode identitySchemaNode : module.getIdentities()) {
256 identityMapping.addIdSchemaNode(identitySchemaNode);
264 public static Map<String/* Namespace from yang file */,
265 Map<String /* Name of module entry from yang file */, ModuleConfig>> transformMbeToModuleConfigs
266 (final ConfigRegistryClient configRegistryClient, Map<String/* Namespace from yang file */,
267 Map<String /* Name of module entry from yang file */, ModuleMXBeanEntry>> mBeanEntries) {
269 Map<String, Map<String, ModuleConfig>> namespaceToModuleNameToModuleConfig = Maps.newHashMap();
271 for (String namespace : mBeanEntries.keySet()) {
272 for (Map.Entry<String, ModuleMXBeanEntry> moduleNameToMbe : mBeanEntries.get(namespace).entrySet()) {
273 String moduleName = moduleNameToMbe.getKey();
274 ModuleMXBeanEntry moduleMXBeanEntry = moduleNameToMbe.getValue();
276 ModuleConfig moduleConfig = new ModuleConfig(moduleName,
277 new InstanceConfig(configRegistryClient,moduleMXBeanEntry.getAttributes(), moduleMXBeanEntry.getNullableDummyContainerName()));
279 Map<String, ModuleConfig> moduleNameToModuleConfig = namespaceToModuleNameToModuleConfig.get(namespace);
280 if(moduleNameToModuleConfig == null) {
281 moduleNameToModuleConfig = Maps.newHashMap();
282 namespaceToModuleNameToModuleConfig.put(namespace, moduleNameToModuleConfig);
285 moduleNameToModuleConfig.put(moduleName, moduleConfig);
289 return namespaceToModuleNameToModuleConfig;
293 protected String getOperationName() {
294 return EditConfigXmlParser.EDIT_CONFIG;
298 protected Element handleWithNoSubsequentOperations(Document document, XmlElement xml) throws NetconfDocumentedException {
300 EditConfigXmlParser.EditConfigExecution editConfigExecution;
301 Config cfg = getConfigMapping(getConfigRegistryClient(), yangStoreSnapshot);
302 editConfigExecution = editConfigXmlParser.fromXml(xml, cfg);
304 Element responseInternal;
305 responseInternal = getResponseInternal(document, editConfigExecution);
306 return responseInternal;