/*=========================================================================
 *
 *  Copyright NumFOCUS
 *
 *  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
 *
 *         https://www.apache.org/licenses/LICENSE-2.0.txt
 *
 *  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.
 *
 *=========================================================================*/
/*=========================================================================
 *
 *  Portions of this file are subject to the VTK Toolkit Version 3 copyright.
 *
 *  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
 *
 *  For complete copyright, license and disclaimer of warranty information
 *  please refer to the NOTICE file at the top of the ITK source tree.
 *
 *=========================================================================*/
#ifndef itkMutexLock_h
#define itkMutexLock_h

#include "itkObject.h"
#include "itkObjectFactory.h"
#include "itkThreadSupport.h"
#include "ITKDeprecatedExport.h"

namespace itk
{

/**
 * \class SimpleMutexLock
 * \brief Simple mutual exclusion locking class.

 * SimpleMutexLock allows the locking of variables which are accessed
 * through different threads.  This header file also defines
 * SimpleMutexLock which is not a subclass of Object.
 *
 * \ingroup OSSystemObjects
 * \ingroup ITKDeprecated
 */
class ITKDeprecated_EXPORT SimpleMutexLock
{
public:
  /** Standard class type aliases.  */
  using Self = SimpleMutexLock;

  /** Constructor and destructor left public purposely. */
  SimpleMutexLock();
  virtual ~SimpleMutexLock();

  /** Methods for creation and destruction through the object factory. */
  static SimpleMutexLock *
  New();

  void
  Delete()
  {
    delete this;
  }

  /** Used for debugging and other run-time purposes. */
  virtual const char *
  GetNameOfClass()
  {
    return "itkSimpleMutexLock";
  }

  /** Lock the MutexLock. */
  void
  Lock();

  /** Non-blocking Lock access.
   \return bool - true if lock is captured, false if it was already held by someone else.
   */
  bool
  TryLock();

  /** Unlock the MutexLock. */
  void
  Unlock();

  /** Access the MutexType member variable from outside this class */
  MutexType &
  GetMutexLock()
  {
    return m_MutexLock;
  }

  MutexType
  GetMutexLock() const
  {
    return *(const_cast<MutexType *>(&m_MutexLock));
  }

protected:
  MutexType m_MutexLock{};
};

/**
 * \class MutexLock
 * \brief Mutual exclusion locking class.
 *
 * MutexLock allows the locking of variables which are accessed
 * through different threads.  This header file also defines
 * SimpleMutexLock which is not a subclass of itkObject.
 *
 * \ingroup OSSystemObjects
 * \ingroup ITKDeprecated
 */
class ITKDeprecated_EXPORT MutexLock : public Object
{
public:
  ITK_DISALLOW_COPY_AND_MOVE(MutexLock);

  /** Standard class type aliases. */
  using Self = MutexLock;
  using Superclass = Object;
  using Pointer = SmartPointer<Self>;
  using ConstPointer = SmartPointer<const Self>;

  /** Method for creation. */
  itkNewMacro(Self);

  /** \see LightObject::GetNameOfClass() */
  itkOverrideGetNameOfClassMacro(MutexLock);

  /** Lock the itkMutexLock. */
  void
  Lock();

  /** Non-blocking Lock access.
   \return bool - true if lock is captured, false if it was already held by someone else.
   */
  bool
  TryLock();

  /** Unlock the MutexLock. */
  void
  Unlock();

protected:
  MutexLock() = default;
  ~MutexLock() override = default;

  SimpleMutexLock m_SimpleMutexLock{};
  void
  PrintSelf(std::ostream & os, Indent indent) const override;
};

inline void
MutexLock::Lock()
{
  m_SimpleMutexLock.Lock();
}

inline bool
MutexLock::TryLock()
{
  return m_SimpleMutexLock.TryLock();
}

inline void
MutexLock::Unlock()
{
  m_SimpleMutexLock.Unlock();
}
} // namespace itk
#endif