QLockFile Class

멤버 함수 문서

QLockFile::QLockFile(const QString &fileName)

새 잠금 파일 객체를 생성합니다. 객체는 잠금 해제된 상태로 생성됩니다. lock () 또는 tryLock()을 호출하면 fileName 이라는 잠금 파일이 아직 존재하지 않는 경우 생성됩니다.

lock() 및 unlock()도 참조하세요 .

[noexcept] QLockFile::~QLockFile()

잠금 파일 객체를 삭제합니다. 잠금을 획득한 경우 잠금 파일을 삭제하여 잠금을 해제합니다.

QLockFile::LockError QLockFile::error() const

파일 잠금 오류 상태를 반환합니다.

tryLock()가 false 을 반환하면 이 함수를 호출하여 잠금이 실패한 이유를 확인할 수 있습니다.

QString QLockFile::fileName() const

잠금 파일의 파일명을 반환합니다.

bool QLockFile::getLockInfo(qint64 *pid, QString *hostname, QString *appname) const

잠금 파일의 현재 소유자에 대한 정보를 검색합니다.

tryLock()가 false 을 반환하고 error()가 LockFailedError 을 반환하는 경우 이 함수를 호출하여 기존 잠금 파일에 대한 자세한 정보를 찾을 수 있습니다:

• 애플리케이션의 PID( pid 에 반환됨)
• 실행 중인 hostname (네트워크 파일시스템의 경우 유용함),
• 해당 파일을 생성한 애플리케이션의 이름( appname)으로 반환됩니다,

tryLock()는 실행 중인 애플리케이션이 없는 경우 자동으로 파일을 삭제하므로 LockFailedError 은 이 PID를 가진 애플리케이션이 있는 경우에만 발생할 수 있습니다(관련이 없을 수도 있음).

이는 사용자에게 기존 잠금 파일에 대해 알리고 삭제할 수 있는 선택권을 주는 데 사용할 수 있습니다. removeStaleLockFile ()를 사용하여 파일을 제거한 후 애플리케이션은 tryLock()를 다시 호출할 수 있습니다.

이 함수는 정보를 성공적으로 검색할 수 있으면 true 을 반환하고, 잠금 파일이 존재하지 않거나 예상 데이터를 포함하지 않으면 false를 반환합니다. tryLock ()가 실패한 시점과 이 함수를 호출한 시점 사이에 잠금 파일이 삭제된 경우 이런 문제가 발생할 수 있습니다. 이 경우 tryLock()를 다시 호출하면 됩니다.

bool QLockFile::isLocked() const

이 QLockFile 인스턴스가 잠금을 획득한 경우 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

lock(), unlock() 및 tryLock()도 참조하세요 .

bool QLockFile::lock()

잠금 파일을 만듭니다.

다른 프로세스(또는 다른 스레드)가 이미 잠금 파일을 생성한 경우 이 함수는 해당 프로세스(또는 스레드)가 잠금 파일을 해제할 때까지 차단됩니다.

먼저 잠금을 해제하지 않고 동일한 스레드에서 동일한 잠금에 대해 이 함수를 여러 번 호출하는 것은 허용되지 않습니다. 이 함수는 파일이 재귀적으로 잠기면 데드락됩니다.

잠금이 획득된 경우 true, 상위 디렉터리에 권한이 없는 등 복구할 수 없는 오류로 인해 잠금을 획득할 수 없는 경우 false를 반환합니다.

unlock() 및 tryLock()도 참조하세요 .

bool QLockFile::removeStaleLockFile()

기존 잠금 파일을 강제로 제거하려고 시도합니다.

QLockFile 은 이미 staleLockTime() 보다 오래된 잠금 파일 제거를 처리하므로 수명이 짧은 작업을 보호할 때는 이 메서드를 호출하지 않는 것이 좋습니다.

이 메서드는 리소스를 장기간 보호하는 경우, 즉 staleLockTime(0)으로 tryLock()가 LockFailedError 을 반환하고 사용자가 잠금 파일 제거에 동의한 후에만 호출해야 합니다.

성공하면 true 을 반환하고, 잠금 파일을 제거할 수 없으면 false를 반환합니다. 이 함수는 잠금을 소유한 애플리케이션이 계속 실행 중일 때 Windows에서 발생합니다.

void QLockFile::setStaleLockTime(int staleLockTime)

staleLockTime 을 잠금 파일이 오래된 것으로 간주되는 시간(밀리초)으로 설정합니다. 기본값은 30000, 즉 30초입니다. 애플리케이션에서 일반적으로 30초 이상 파일을 잠그는 경우(예: 2분 동안 메가바이트의 데이터를 저장하는 동안) setStaleLockTime()을 사용하여 더 큰 값을 설정해야 합니다.

staleLockTime 값은 lock() 및 tryLock()에서 기존 잠금 파일이 오래된 것으로 간주되는 시점, 즉 크래시된 프로세스에 의해 남겨진 시점을 결정하기 위해 사용됩니다. 이 함수는 그 사이에 PID가 재사용된 경우에 유용하므로 오래된 잠금 파일을 감지하는 한 가지 방법은 파일이 오랫동안 사용되었다는 사실로 확인할 수 있습니다.

이것은 호출에 해당하는 오버로드된 함수입니다:

setStaleLockTime(std::chrono::milliseconds{staleLockTime});

staleLockTime()도 참조하세요 .

[since 6.2] void QLockFile::setStaleLockTime(std::chrono::milliseconds staleLockTime)

잠금 파일이 오래된 것으로 간주되는 간격을 staleLockTime 으로 설정합니다. 기본값은 30초입니다.

애플리케이션에서 일반적으로 30초 이상 파일을 잠그는 경우(예: 2분 동안 메가바이트의 데이터를 저장하는 동안) setStaleLockTime()을 사용하여 더 큰 값을 설정해야 합니다.

staleLockTime() 값은 lock() 및 tryLock()에서 기존 잠금 파일이 오래된 것으로 간주되는 시점, 즉 충돌한 프로세스에 의해 남겨진 시점을 결정하기 위해 사용됩니다. 이 함수는 그 사이에 PID가 재사용된 경우에 유용하므로, 오래된 잠금 파일을 감지하는 한 가지 방법은 파일이 오랫동안 사용되었다는 사실로 확인할 수 있습니다.

이 기능은 Qt 6.2에 도입되었습니다.

staleLockTime()도 참조하십시오 .

int QLockFile::staleLockTime() const

잠금 파일이 오래된 것으로 간주되는 시간(밀리초)을 반환합니다.

setStaleLockTime()도 참조하세요 .

[since 6.2] std::chrono::milliseconds QLockFile::staleLockTimeAsDuration() const

이 함수는 오버로드된 함수입니다.

잠금 파일이 오래된 것으로 간주되는 시간을 나타내는 std::chrono::milliseconds 객체를 반환합니다.

이 함수는 Qt 6.2에 도입되었습니다.

setStaleLockTime()도 참조하십시오 .

bool QLockFile::tryLock(int timeout)

잠금 파일을 생성하려고 시도합니다. 이 함수는 잠금을 얻은 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 다른 프로세스(또는 다른 스레드)가 이미 잠금 파일을 생성한 경우 이 함수는 잠금 파일을 사용할 수 있을 때까지 최대 timeout 밀리초 동안 대기합니다.

참고: 음수를 timeout 으로 전달하는 것은 lock()을 호출하는 것과 같습니다. 즉, timeout 이 음수인 경우 이 함수는 잠금 파일을 잠글 수 있을 때까지 영원히 기다립니다.

잠금이 확보되면 unlock()로 잠금을 해제해야 다른 프로세스(또는 스레드)가 성공적으로 잠글 수 있습니다.

먼저 잠금을 해제하지 않고 동일한 스레드에서 동일한 잠금에 대해 이 함수를 여러 번 호출하는 것은 허용되지 않으며, 재귀적으로 파일을 잠그려고 시도할 때 이 함수는 항상 false를 반환합니다.

lock() 및 unlock()도 참조하세요 .

[since 6.2] bool QLockFile::tryLock(std::chrono::milliseconds timeout = std::chrono::milliseconds::zero())

오버로드된 함수입니다.

잠금 파일을 생성하려고 시도합니다. 이 함수는 잠금을 얻은 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 다른 프로세스(또는 다른 스레드)가 이미 잠금 파일을 생성한 경우 이 함수는 잠금 파일을 사용할 수 있게 될 때까지 최대 timeout 까지 기다립니다.

잠금을 얻은 경우 다른 프로세스(또는 스레드)가 성공적으로 잠그기 전에 unlock()로 잠금을 해제해야 합니다.

먼저 잠금을 해제하지 않고 동일한 스레드에서 동일한 잠금에 대해 이 함수를 여러 번 호출하는 것은 허용되지 않으며, 재귀적으로 파일을 잠그려고 시도할 때 이 함수는 항상 false를 반환합니다.

이 함수는 Qt 6.2에 도입되었습니다.

lock() 및 unlock()도 참조하십시오 .

void QLockFile::unlock()

잠금 파일을 삭제하여 잠금을 해제합니다.

파일을 먼저 잠그지 않고 unlock()을 호출하면 아무 일도 일어나지 않습니다.

lock() 및 tryLock()도 참조하세요 .