/*============================================================================= Library: XNAT/Core Copyright (c) University College London, Centre for Medical Image Computing 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 http://www.apache.org/licenses/LICENSE-2.0 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. =============================================================================*/ #include "ctkXnatSession.h" #include "ctkXnatAssessor.h" #include "ctkXnatDataModel.h" #include "ctkXnatDefaultSchemaTypes.h" #include "ctkXnatException.h" #include "ctkXnatExperiment.h" #include "ctkXnatFile.h" #include "ctkXnatLoginProfile.h" #include "ctkXnatObject.h" #include "ctkXnatProject.h" #include "ctkXnatReconstruction.h" #include "ctkXnatResource.h" #include "ctkXnatScan.h" #include "ctkXnatSubject.h" #include #include #include #include #include #include #include #include #include #include //---------------------------------------------------------------------------- static const char* HEADER_AUTHORIZATION = "Authorization"; static const char* HEADER_USER_AGENT = "User-Agent"; static const char* HEADER_COOKIE = "Cookie"; static QString SERVER_VERSION = "version"; static QString SESSION_EXPIRATION_DATE = "expires"; //---------------------------------------------------------------------------- class ctkXnatSessionPrivate { public: const ctkXnatLoginProfile loginProfile; QScopedPointer xnat; QScopedPointer dataModel; QString sessionId; QString defaultDownloadDir; QMap sessionProperties; ctkXnatSession* q; QTimer* timer; // The time in milliseconds until the signal aboutToTimeOut gets emitted // XNAT sessions time out after 15 minutes (=900000 ms) by default // i.e. by default this signal will be emitted after 840000 ms int timeOutWarningPeriod; // The time in milliseconds until the signal timedOut gets emitted // Default XNAT session timeout setting. This value will be updated after // "updateExpirationDate" is called the first time. int timeOutPeriod; ctkXnatSessionPrivate(const ctkXnatLoginProfile& loginProfile, ctkXnatSession* q); ~ctkXnatSessionPrivate(); void throwXnatException(const QString& msg); void createConnections(); void setDefaultHttpHeaders(); void checkSession() const; void setSessionProperties(); QDateTime updateExpirationDate(qRestResult* restResult); void close(); static QList results(qRestResult* restResult, QString schemaType); }; //---------------------------------------------------------------------------- ctkXnatSessionPrivate::ctkXnatSessionPrivate(const ctkXnatLoginProfile& loginProfile, ctkXnatSession* q) : loginProfile(loginProfile) , xnat(new ctkXnatAPI()) , defaultDownloadDir(".") , q(q) , timer(new QTimer(q)) , timeOutWarningPeriod (840000) , timeOutPeriod(60000) { // TODO This is a workaround for connecting to sites with self-signed // certificate. Should be replaced with something more clever. xnat->setSuppressSslErrors(true); createConnections(); } //---------------------------------------------------------------------------- ctkXnatSessionPrivate::~ctkXnatSessionPrivate() { } //---------------------------------------------------------------------------- void ctkXnatSessionPrivate::throwXnatException(const QString& msg) { QString errorMsg = msg.trimmed(); if (!errorMsg.isEmpty()) { errorMsg.append(' '); } errorMsg.append(xnat->errorString()); switch (xnat->error()) { case qRestAPI::TimeoutError: throw ctkXnatTimeoutException(errorMsg); case qRestAPI::ResponseParseError: throw ctkXnatProtocolFailureException(errorMsg); case qRestAPI::UnknownUuidError: throw ctkInvalidArgumentException(errorMsg); case qRestAPI::AuthenticationError: // This signals either an initial authentication error // or a session timeout. this->close(); throw ctkXnatAuthenticationException(errorMsg); default: throw ctkRuntimeException(errorMsg); } } //---------------------------------------------------------------------------- void ctkXnatSessionPrivate::createConnections() { // Q_D(ctkXnatSession); // connect(d->xnat, SIGNAL(resultReceived(QUuid,QList)), // this, SLOT(processResult(QUuid,QList))); // connect(d->xnat, SIGNAL(progress(QUuid,double)), // this, SLOT(progress(QUuid,double))); } //---------------------------------------------------------------------------- void ctkXnatSessionPrivate::setDefaultHttpHeaders() { ctkXnatAPI::RawHeaders rawHeaders; rawHeaders[HEADER_USER_AGENT] = "Qt"; /* rawHeaders["Authorization"] = "Basic " + QByteArray(QString("%1:%2").arg(d->loginProfile.userName()) .arg(d->loginProfile.password()).toAscii()).toBase64(); */ if (!sessionId.isEmpty()) { rawHeaders[HEADER_COOKIE] = QString("JSESSIONID=%1").arg(sessionId).toLatin1(); } xnat->setDefaultRawHeaders(rawHeaders); } //---------------------------------------------------------------------------- void ctkXnatSessionPrivate::checkSession() const { if (sessionId.isEmpty()) { throw ctkXnatInvalidSessionException("Session closed."); } } //---------------------------------------------------------------------------- void ctkXnatSessionPrivate::setSessionProperties() { sessionProperties.clear(); QUuid uuid = xnat->get("/data/version"); QScopedPointer restResult(xnat->takeResult(uuid)); if (restResult) { QString version = restResult->result()["content"].toString(); if (version.isEmpty()) { throw ctkXnatProtocolFailureException("No version information available."); } sessionProperties[SERVER_VERSION] = version; } else { this->throwXnatException("Retrieving session properties failed."); } } //---------------------------------------------------------------------------- QDateTime ctkXnatSessionPrivate::updateExpirationDate(qRestResult* restResult) { QByteArray cookieHeader = restResult->rawHeader("Set-Cookie"); QDateTime expirationDate = QDateTime::currentDateTime(); if (!cookieHeader.isEmpty()) { QList cookies = QNetworkCookie::parseCookies(cookieHeader); foreach(const QNetworkCookie& cookie, cookies) { if (cookie.name() == "SESSION_EXPIRATION_TIME") { QList expirationCookie = cookie.value().split(','); if (expirationCookie.size() == 2) { unsigned long long startTime = expirationCookie[0].mid(1).toULongLong(); if (startTime > 0) { expirationDate = QDateTime::fromTime_t(startTime / 1000); } QByteArray timeSpan = expirationCookie[1]; timeSpan.chop(1); this->timeOutWarningPeriod = timeSpan.toLong() - this->timeOutPeriod; expirationDate = expirationDate.addMSecs(timeSpan.toLong()); sessionProperties[SESSION_EXPIRATION_DATE] = expirationDate.toString(Qt::ISODate); this->timer->start(this->timeOutWarningPeriod); emit q->sessionRenewed(expirationDate); } } } } return expirationDate; } //---------------------------------------------------------------------------- void ctkXnatSessionPrivate::close() { sessionProperties.clear(); sessionId.clear(); this->setDefaultHttpHeaders(); dataModel.reset(); } //---------------------------------------------------------------------------- QList ctkXnatSessionPrivate::results(qRestResult* restResult, QString schemaType) { QList results; foreach (const QVariantMap& propertyMap, restResult->results()) { QString customSchemaType; if (propertyMap.contains("xsiType")) { customSchemaType = propertyMap["xsiType"].toString(); } int typeId = 0; // try to create an object based on the custom schema type first if (!customSchemaType.isEmpty()) { typeId = QMetaType::type(qPrintable(customSchemaType)); } // Fall back. Create the default class according to the default schema type if (!typeId) { if (!customSchemaType.isEmpty()) { qWarning() << QString("No ctkXnatObject sub-class registered for the schema %1. Falling back to the default class %2.").arg(customSchemaType).arg(schemaType); } typeId = QMetaType::type(qPrintable(schemaType)); } if (!typeId) { qWarning() << QString("No ctkXnatObject sub-class registered as a meta-type for the schema %1. Skipping result.").arg(schemaType); continue; } #if (QT_VERSION < QT_VERSION_CHECK(5,0,0)) ctkXnatObject* object = reinterpret_cast(QMetaType::construct(typeId)); #else ctkXnatObject* object = reinterpret_cast(QMetaType(typeId).create()); #endif if (!customSchemaType.isEmpty()) { // We might have created the default ctkXnatObject sub-class, but can still set // the custom schema type. object->setSchemaType(customSchemaType); } // Fill in the properties QMapIterator it(propertyMap); QString description; while (it.hasNext()) { it.next(); QString str = it.key().toLatin1().data(); QVariant var = it.value(); object->setProperty(str, var); description.append (str + QString ("\t::\t") + var.toString() + "\n"); } QVariant lastModifiedHeader = restResult->rawHeader("Last-Modified"); QDateTime lastModifiedTime; if (lastModifiedHeader.isValid()) { lastModifiedTime = lastModifiedHeader.toDateTime(); } if (lastModifiedTime.isValid()) { object->setLastModifiedTime(lastModifiedTime); } object->setDescription(description); results.push_back(object); } return results; } //---------------------------------------------------------------------------- // ctkXnatSession class //---------------------------------------------------------------------------- ctkXnatSession::ctkXnatSession(const ctkXnatLoginProfile& loginProfile) : d_ptr(new ctkXnatSessionPrivate(loginProfile, this)) { Q_D(ctkXnatSession); qRegisterMetaType(qPrintable(ctkXnatDefaultSchemaTypes::XSI_PROJECT)); qRegisterMetaType(qPrintable(ctkXnatDefaultSchemaTypes::XSI_SUBJECT)); qRegisterMetaType(qPrintable(ctkXnatDefaultSchemaTypes::XSI_EXPERIMENT)); qRegisterMetaType(qPrintable(ctkXnatDefaultSchemaTypes::XSI_SCAN)); qRegisterMetaType(qPrintable(ctkXnatDefaultSchemaTypes::XSI_RECONSTRUCTION)); qRegisterMetaType(qPrintable(ctkXnatDefaultSchemaTypes::XSI_RESOURCE)); qRegisterMetaType(qPrintable(ctkXnatDefaultSchemaTypes::XSI_ASSESSOR)); qRegisterMetaType(qPrintable(ctkXnatDefaultSchemaTypes::XSI_FILE)); QString url = d->loginProfile.serverUrl().toString(); d->xnat->setServerUrl(url); // QObject::connect(d->xnat.data(), SIGNAL(uploadFinished()), this, SIGNAL(uploadFinished())); QObject::connect(d->xnat.data(), SIGNAL(progress(QUuid,double)), this, SIGNAL(progress(QUuid,double))); // QObject::connect(d->xnat.data(), SIGNAL(progress(QUuid,double)), // this, SLOT(onProgress(QUuid,double))); d->setDefaultHttpHeaders(); } //---------------------------------------------------------------------------- ctkXnatSession::~ctkXnatSession() { this->close(); } //---------------------------------------------------------------------------- void ctkXnatSession::open() { Q_D(ctkXnatSession); if (this->isOpen()) return; qRestAPI::RawHeaders headers; headers[HEADER_AUTHORIZATION] = "Basic " + QByteArray(QString("%1:%2").arg(this->userName()) .arg(this->password()).toLatin1()).toBase64(); QUuid uuid = d->xnat->get("/data/JSESSION", qRestAPI::Parameters(), headers); QScopedPointer restResult(d->xnat->takeResult(uuid)); if (restResult) { QObject::connect(d->timer, SIGNAL(timeout()), this, SLOT(emitTimeOut())); QString sessionId = restResult->result()["content"].toString(); d->sessionId = sessionId; d->setDefaultHttpHeaders(); d->setSessionProperties(); d->updateExpirationDate(restResult.data()); } else { d->throwXnatException("Could not get a session id."); } d->dataModel.reset(new ctkXnatDataModel(this)); d->dataModel->setProperty(ctkXnatObject::LABEL, this->url().toString()); emit sessionOpened(); } //---------------------------------------------------------------------------- void ctkXnatSession::close() { Q_D(ctkXnatSession); if (!this->isOpen()) return; emit sessionAboutToBeClosed(); d->close(); } //---------------------------------------------------------------------------- bool ctkXnatSession::isOpen() const { Q_D(const ctkXnatSession); return !d->sessionId.isEmpty(); } //---------------------------------------------------------------------------- QString ctkXnatSession::version() const { Q_D(const ctkXnatSession); if (d->sessionProperties.contains(SERVER_VERSION)) { return d->sessionProperties[SERVER_VERSION]; } else { return QString::null; } } //---------------------------------------------------------------------------- QDateTime ctkXnatSession::expirationDate() const { Q_D(const ctkXnatSession); d->checkSession(); return QDateTime::fromString(d->sessionProperties[SESSION_EXPIRATION_DATE], Qt::ISODate); } //---------------------------------------------------------------------------- QDateTime ctkXnatSession::renew() { Q_D(ctkXnatSession); d->checkSession(); QUuid uuid = d->xnat->get("/data/auth"); QScopedPointer restResult(d->xnat->takeResult(uuid)); if (!restResult) { d->throwXnatException("Session renewal failed."); } return d->updateExpirationDate(restResult.data()); } //---------------------------------------------------------------------------- ctkXnatLoginProfile ctkXnatSession::loginProfile() const { Q_D(const ctkXnatSession); return d->loginProfile; } //---------------------------------------------------------------------------- void ctkXnatSession::onProgress(QUuid /*queryId*/, double /*progress*/) { // qDebug() << "ctkXnatSession::progress(QUuid queryId, double progress)"; // qDebug() << "query id:" << queryId; // qDebug() << "progress:" << (progress * 100.0) << "%"; } //---------------------------------------------------------------------------- QUrl ctkXnatSession::url() const { Q_D(const ctkXnatSession); return d->loginProfile.serverUrl(); } //---------------------------------------------------------------------------- QString ctkXnatSession::userName() const { Q_D(const ctkXnatSession); return d->loginProfile.userName(); } //---------------------------------------------------------------------------- QString ctkXnatSession::password() const { Q_D(const ctkXnatSession); return d->loginProfile.password(); } //---------------------------------------------------------------------------- QString ctkXnatSession::sessionId() const { Q_D(const ctkXnatSession); return d->sessionId; } //---------------------------------------------------------------------------- void ctkXnatSession::setDefaultDownloadDir(const QString &path) { Q_D(ctkXnatSession); QDir directory(path); if (directory.exists()) { d->defaultDownloadDir = path; } else { d->defaultDownloadDir = QDir::currentPath(); qWarning() << "Specified directory: ["<defaultDownloadDir; } } //---------------------------------------------------------------------------- QString ctkXnatSession::defaultDownloadDir() const { Q_D(const ctkXnatSession); return d->defaultDownloadDir; } //---------------------------------------------------------------------------- ctkXnatDataModel* ctkXnatSession::dataModel() const { Q_D(const ctkXnatSession); d->checkSession(); return d->dataModel.data(); } //---------------------------------------------------------------------------- QUuid ctkXnatSession::httpGet(const QString& resource, const ctkXnatSession::UrlParameters& parameters, const ctkXnatSession::HttpRawHeaders& rawHeaders) { Q_D(ctkXnatSession); d->checkSession(); d->timer->start(d->timeOutWarningPeriod); return d->xnat->get(resource, parameters, rawHeaders); } //---------------------------------------------------------------------------- QList ctkXnatSession::httpResults(const QUuid& uuid, const QString& schemaType) { Q_D(ctkXnatSession); d->checkSession(); QScopedPointer restResult(d->xnat->takeResult(uuid)); if (restResult == NULL) { d->throwXnatException("Http request failed."); } d->timer->start(d->timeOutWarningPeriod); return d->results(restResult.data(), schemaType); } QUuid ctkXnatSession::httpPut(const QString& resource, const ctkXnatSession::UrlParameters& parameters, const ctkXnatSession::HttpRawHeaders& /*rawHeaders*/) { Q_D(ctkXnatSession); d->checkSession(); d->timer->start(d->timeOutWarningPeriod); return d->xnat->put(resource, parameters); } //---------------------------------------------------------------------------- QList ctkXnatSession::httpSync(const QUuid& uuid) { Q_D(ctkXnatSession); d->checkSession(); QList result; qRestResult* restResult = d->xnat->takeResult(uuid); if (restResult == NULL) { d->throwXnatException("Syncing with http request failed."); } else { d->updateExpirationDate(restResult); // restarts session timer as well result = restResult->results(); } return result; } //---------------------------------------------------------------------------- const QMap ctkXnatSession::httpHeadSync(const QUuid &uuid) { Q_D(ctkXnatSession); QScopedPointer result (d->xnat->takeResult(uuid)); d->timer->start(d->timeOutWarningPeriod); if (result == NULL) { d->throwXnatException("Sending HEAD request failed."); } return result->rawHeaders(); } //---------------------------------------------------------------------------- QUuid ctkXnatSession::httpHead(const QString& resourceUri) { Q_D(ctkXnatSession); QUuid queryId = d->xnat->head(resourceUri); d->timer->start(d->timeOutWarningPeriod); return queryId; } //---------------------------------------------------------------------------- bool ctkXnatSession::exists(const ctkXnatObject* object) { Q_D(ctkXnatSession); QString query = object->resourceUri(); bool success = d->xnat->sync(d->xnat->get(query)); d->timer->start(d->timeOutWarningPeriod); return success; } //---------------------------------------------------------------------------- void ctkXnatSession::remove(ctkXnatObject* object) { Q_D(ctkXnatSession); QString query = object->resourceUri(); bool success = d->xnat->sync(d->xnat->del(query)); d->timer->start(d->timeOutWarningPeriod); if (!success) { d->throwXnatException("Error occurred while removing the data."); } } //---------------------------------------------------------------------------- void ctkXnatSession::download(const QString& fileName, const QString& resource, const UrlParameters& parameters, const HttpRawHeaders& rawHeaders) { Q_D(ctkXnatSession); QUuid queryId = d->xnat->download(fileName, resource, parameters, rawHeaders); d->xnat->sync(queryId); d->timer->start(d->timeOutWarningPeriod); } //---------------------------------------------------------------------------- void ctkXnatSession::upload(ctkXnatFile *xnatFile, const UrlParameters ¶meters, const HttpRawHeaders &/*rawHeaders*/) { Q_D(ctkXnatSession); QFile file(xnatFile->localFilePath()); if (!file.exists()) { QString msg = "Error uploading file! "; msg.append(QString("File \"%1\" does not exist!").arg(xnatFile->localFilePath())); throw ctkXnatException(msg); } QUuid queryId = d->xnat->upload(xnatFile->localFilePath(), xnatFile->resourceUri(), parameters); d->xnat->sync(queryId); // Validating the file upload by requesting the catalog XML // of the parent resource. Unfortunately for XNAT versions <= 1.6.4 // this is the only way to get the file's MD5 hash form the server. QString md5Query = xnatFile->parent()->resourceUri(); QUuid md5QueryID = this->httpGet(md5Query); QList result = this->httpSync(md5QueryID); d->timer->start(d->timeOutWarningPeriod); QString md5ChecksumRemote ("0"); // Newly added files are usually at the end of the catalog // and hence at the end of the result list. // So iterating backward is for performance reasons. QList::const_iterator it = result.constEnd()-1; while (it != result.constBegin()-1) { QVariantMap::const_iterator it2 = (*it).find(xnatFile->name()); if (it2 != (*it).constEnd()) { md5ChecksumRemote = it2.value().toString(); break; } --it; } QFile localFile(xnatFile->localFilePath()); if (localFile.open(QFile::ReadOnly) && md5ChecksumRemote != "0") { QCryptographicHash hash(QCryptographicHash::Md5); #if QT_VERSION >= QT_VERSION_CHECK(5,0,0) hash.addData(&localFile); #else hash.addData(localFile.readAll()); #endif QString md5ChecksumLocal(hash.result().toHex()); // Retrieving the md5 checksum on the server and comparing // it with the local file md5 sum if (md5ChecksumLocal != md5ChecksumRemote) { // Remove corrupted file from server xnatFile->erase(); d->timer->start(d->timeOutWarningPeriod); throw ctkXnatException("Upload failed! An error occurred during file upload."); } } else { qWarning()<<"Could not validate file upload! Remote MD5: "< parameters) { Q_UNUSED(queryId) Q_UNUSED(parameters) } //---------------------------------------------------------------------------- void ctkXnatSession::emitTimeOut() { Q_D(ctkXnatSession); if (d->timer->interval() == d->timeOutWarningPeriod) { d->timer->start(d->timeOutPeriod); emit aboutToTimeOut(); } else if (d->timer->interval() == d->timeOutPeriod) { d->timer->stop(); emit timedOut(); } } //---------------------------------------------------------------------------- void ctkXnatSession::setHttpNetworkProxy(const QNetworkProxy& proxy) { Q_D(ctkXnatSession); d->xnat->setHttpNetworkProxy(proxy); }