opendaylight/netconf/config-netconf-connector/src/main/java/org/opendaylight/controller/netconf/confignetconfconnector/operations/UnLock.java

   1 /*
   2  * Copyright (c) 2014 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
   9 package org.opendaylight.controller.netconf.confignetconfconnector.operations;
  10
  11 import com.google.common.base.Optional;
  12 import org.opendaylight.controller.config.facade.xml.Datastore;
  13 import org.opendaylight.controller.config.util.xml.DocumentedException;
  14 import org.opendaylight.controller.config.util.xml.XmlElement;
  15 import org.opendaylight.controller.config.util.xml.XmlUtil;
  16 import org.opendaylight.controller.netconf.api.xml.XmlNetconfConstants;
  17 import org.opendaylight.controller.netconf.util.mapping.AbstractLastNetconfOperation;
  18 import org.slf4j.Logger;
  19 import org.slf4j.LoggerFactory;
  20 import org.w3c.dom.Document;
  21 import org.w3c.dom.Element;
  22
  23 /**
  24  * Simple unlock implementation that pretends to unlock candidate datastore.
  25  * Candidate datastore is allocated per session and is private so no real locking is needed (JMX is the only possible interference)
  26  */
  27 public class UnLock extends AbstractLastNetconfOperation {
  28
  29     private static final Logger LOG = LoggerFactory.getLogger(UnLock.class);
  30
  31     private static final String UNLOCK = "unlock";
  32
  33     public UnLock(final String netconfSessionIdForReporting) {
  34         super(netconfSessionIdForReporting);
  35     }
  36
  37     @Override
  38     protected Element handleWithNoSubsequentOperations(final Document document, final XmlElement operationElement) throws DocumentedException {
  39         final Datastore targetDatastore = Lock.extractTargetParameter(operationElement);
  40         if(targetDatastore == Datastore.candidate) {
  41             // Since candidate datastore instances are allocated per session and not accessible anywhere else, no need to lock
  42             LOG.debug("Unlocking {} datastore on session: {}", targetDatastore, getNetconfSessionIdForReporting());
  43             // TODO this should fail if we are not locked
  44             return XmlUtil.createElement(document, XmlNetconfConstants.OK, Optional.<String>absent());
  45         }
  46
  47         // Not supported running lock
  48         throw new DocumentedException("Unable to unlock " + Datastore.running + " datastore", DocumentedException.ErrorType.application,
  49                 DocumentedException.ErrorTag.operation_not_supported, DocumentedException.ErrorSeverity.error);
  50     }
  51
  52     @Override
  53     protected String getOperationName() {
  54         return UNLOCK;
  55     }
  56 }