bearer/qnetworksession.cpp

executed: }

Execution Count:40

281 -

282 /*! -

283 Frees the resources associated with the QNetworkSession object. -

284 */ -

285 QNetworkSession::~QNetworkSession() -

286 { -

287

delete d;

executed (the execution status of this line is deduced): delete d;

288

executed: }

Execution Count:38

289 -

290 /*! -

291 Creates an open session which increases the session counter on the underlying network interface. -

292 The system will not terminate a network interface until the session reference counter reaches zero. -

293 Therefore an open session allows an application to register its use of the interface. -

294 -

295 As a result of calling open() the interface will be started if it is not connected/up yet. -

296 Some platforms may not provide support for out-of-process sessions. On such platforms the session -

297 counter ignores any sessions held by another process. The platform capabilities can be -

298 detected via QNetworkConfigurationManager::capabilities(). -

299 -

300 Note that this call is asynchronous. Depending on the outcome of this call the results can be enquired -

301 by connecting to the stateChanged(), opened() or error() signals. -

302 -

303 It is not a requirement to open a session in order to monitor the underlying network interface. -

304 -

305 \sa close(), stop(), isOpen() -

306 */ -

307 void QNetworkSession::open() -

308 { -

309

emit error(InvalidConfigurationError);

evaluated: d

TRUE	FALSE
yes Evaluation Count:27	yes Evaluation Count:1

1-27

310

d->open();

executed: d->open();

Execution Count:27

311 else -

312

executed: error(InvalidConfigurationError);

Execution Count:1

313 } -

314 -

315 /*! -

316 Waits until the session has been opened, up to \a msecs milliseconds. If the session has been opened, this -

317 function returns true; otherwise it returns false. In the case where it returns false, you can call error() -

318 to determine the cause of the error. -

319 -

320 The following example waits up to one second for the session to be opened: -

321 -

322 \code -

323 session->open(); -

324 if (session->waitForOpened(1000)) -

325 qDebug("Open!"); -

326 \endcode -

327 -

328 If \a msecs is -1, this function will not time out. -

329 -

330 \sa open(), error() -

331 */ -

332 bool QNetworkSession::waitForOpened(int msecs) -

333 { -

334

if (!(d->state == Connecting || d->state == Connected)) {

evaluated: !d

TRUE	FALSE
yes Evaluation Count:1	yes Evaluation Count:17

1-17

335

return false;

executed: return false;

Execution Count:1

336 -

337

if (d->isOpen)

partially evaluated: d->isOpen

TRUE	FALSE
yes Evaluation Count:17	no Evaluation Count:0

0-17

338

return true;

executed: return true;

Execution Count:17

339 -

340

never evaluated: d->state == Connecting

never evaluated: d->state == Connected

341

return false;

never executed: return false;

342 } -

343 -

344

QEventLoop loop;

never executed (the execution status of this line is deduced): QEventLoop loop;

345

QObject::connect(d, SIGNAL(quitPendingWaitsForOpened()), &loop, SLOT(quit()));

never executed (the execution status of this line is deduced): QObject::connect(d, "2""quitPendingWaitsForOpened()", &loop, "1""quit()");

346

QObject::connect(this, SIGNAL(error(QNetworkSession::SessionError)), &loop, SLOT(quit()));

never executed (the execution status of this line is deduced): QObject::connect(this, "2""error(QNetworkSession::SessionError)", &loop, "1""quit()");

347 -

348 //final call -

349

if (msecs >= 0)

never evaluated: msecs >= 0

350

QTimer::singleShot(msecs, &loop, SLOT(quit()));

never executed: QTimer::singleShot(msecs, &loop, "1""quit()");

351 -

352 // enter the event loop and wait for opened/error/timeout -

353

loop.exec(QEventLoop::ExcludeUserInputEvents | QEventLoop::WaitForMoreEvents);

never executed (the execution status of this line is deduced): loop.exec(QEventLoop::ExcludeUserInputEvents | QEventLoop::WaitForMoreEvents);

354 -

355

return d->isOpen;

never executed: return d->isOpen;

356 } -

357 -

358 /*! -

359 Decreases the session counter on the associated network configuration. If the session counter reaches zero -

360 the active network interface is shut down. This also means that state() will only change from \l Connected to -

361 \l Disconnected if the current session was the last open session. -

362 -

363 If the platform does not support out-of-process sessions calling this function does not stop the -

364 interface. In this case \l{stop()} has to be used to force a shut down. -

365 The platform capabilities can be detected via QNetworkConfigurationManager::capabilities(). -

366 -

367 Note that this call is asynchronous. Depending on the outcome of this call the results can be enquired -

368 by connecting to the stateChanged(), opened() or error() signals. -

369 -

370 \sa open(), stop(), isOpen() -

371 */ -

372 void QNetworkSession::close() -

373 { -

374

partially evaluated: d

TRUE	FALSE
yes Evaluation Count:8	no Evaluation Count:0

0-8

375

d->close();

executed: d->close();

Execution Count:8

376

executed: }

Execution Count:8

377 -

378 /*! -

379 Invalidates all open sessions against the network interface and therefore stops the -

380 underlying network interface. This function always changes the session's state() flag to -

381 \l Disconnected. -

382 -

383 \sa open(), close() -

384 */ -

385 void QNetworkSession::stop() -

386 { -

387

partially evaluated: d

TRUE	FALSE
yes Evaluation Count:3	no Evaluation Count:0

0-3

388

d->stop();

executed: d->stop();

Execution Count:3

389

return d ? d->publicConfig : QNetworkConfiguration();

executed: }

Execution Count:3

390 -

391 /*! -

392 Returns the QNetworkConfiguration that this network session object is based on. -

393 -

394 \sa QNetworkConfiguration -

395 */ -

396 QNetworkConfiguration QNetworkSession::configuration() const -

397 { -

398

executed: return d ? d->publicConfig : QNetworkConfiguration();

Execution Count:25

399 } -

400 -

401 #ifndef QT_NO_NETWORKINTERFACE -

402 /*! -

403 Returns the network interface that is used by this session. -

404 -

405 This function only returns a valid QNetworkInterface when this session is \l Connected. -

406 -

407 The returned interface may change as a result of a roaming process. -

408 -

409 \sa state() -

410 */ -

411 QNetworkInterface QNetworkSession::interface() const -

412 { -

413

return d ? d->currentInterface() : QNetworkInterface();

executed: return d ? d->currentInterface() : QNetworkInterface();

Execution Count:56

414 } -

415 #endif -

416 -

417 /*! -

418 Returns true if this session is open. If the number of all open sessions is greater than -

419 zero the underlying network interface will remain connected/up. -

420 -

421 The session can be controlled via open() and close(). -

422 */ -

423 bool QNetworkSession::isOpen() const -

424 { -

425

return d ? d->isOpen : false;

executed: return d ? d->isOpen : false;

Execution Count:75

426 } -

427 -

428 /*! -

429 Returns the state of the session. -

430 -

431 If the session is based on a single access point configuration the state of the -

432 session is the same as the state of the associated network interface. Therefore -

433 a network session object can be used to monitor network interfaces. -

434 -

435 A \l QNetworkConfiguration::ServiceNetwork based session summarizes the state of all its children -

436 and therefore returns the \l Connected state if at least one of the service network's -

437 \l {QNetworkConfiguration::children()}{children()} configurations is active. -

438 -

439 Note that it is not required to hold an open session in order to obtain the network interface state. -

440 A connected but closed session may be used to monitor network interfaces whereas an open and connected -

441 session object may prevent the network interface from being shut down. -

442 -

443 \sa error(), stateChanged() -

444 */ -

445 QNetworkSession::State QNetworkSession::state() const -

446 { -

447

return d ? d->state : QNetworkSession::Invalid;

executed: return d ? d->state : QNetworkSession::Invalid;

Execution Count:997

997

448 } -

449 -

450 /*! -

451 Returns the type of error that last occurred. -

452 -

453 \sa state(), errorString() -

454 */ -

455 QNetworkSession::SessionError QNetworkSession::error() const -

456 { -

457

return d ? d->error() : InvalidConfigurationError;

executed: return d ? d->error() : InvalidConfigurationError;

Execution Count:16

458 } -

459 -

460 /*! -

461 Returns a human-readable description of the last device error that -

462 occurred. -

463 -

464 \sa error() -

465 */ -

466 QString QNetworkSession::errorString() const -

467 { -

468

return d ? d->errorString() : tr("Invalid configuration.");

executed: return d ? d->errorString() : tr("Invalid configuration.");

Execution Count:1

469 } -

470 -

471 /*! -

472 Returns the value for property \a key. -

473 -

474 A network session can have properties attached which may describe the session in more details. -

475 This function can be used to gain access to those properties. -

476 -

477 The following property keys are guaranteed to be specified on all platforms: -

478 -

479 \table -

480 \header -

481 \li Key \li Description -

482 \row -

483 \li ActiveConfiguration -

484 \li If the session \l isOpen() this property returns the identifier of the -

485 QNetworkConfiguration that is used by this session; otherwise an empty string. -

486 -

487 The main purpose of this key is to determine which Internet access point is used -

488 if the session is based on a \l{QNetworkConfiguration::ServiceNetwork}{ServiceNetwork}. -

489 The following code snippet highlights the difference: -

490 \code -

491 QNetworkConfigurationManager mgr; -

492 QNetworkConfiguration ap = mgr.defaultConfiguration(); -

493 QNetworkSession *session = new QNetworkSession(ap); -

494 ... //code activates session -

495 -

496 QString ident = session->sessionProperty("ActiveConfiguration").toString(); -

497 if ( ap.type() == QNetworkConfiguration::ServiceNetwork ) { -

498 Q_ASSERT( ap.identifier() != ident ); -

499 Q_ASSERT( ap.children().contains( mgr.configurationFromIdentifier(ident) ) ); -

500 } else if ( ap.type() == QNetworkConfiguration::InternetAccessPoint ) { -

501 Q_ASSERT( ap.identifier() == ident ); -

502 } -

503 \endcode -

504 \row -

505 \li UserChoiceConfiguration -

506 \li If the session \l isOpen() and is bound to a QNetworkConfiguration of type -

507 UserChoice, this property returns the identifier of the QNetworkConfiguration that the -

508 configuration resolved to when \l open() was called; otherwise an empty string. -

509 -

510 The purpose of this key is to determine the real QNetworkConfiguration that the -

511 session is using. This key is different from \e ActiveConfiguration in that -

512 this key may return an identifier for either a -

513 \l {QNetworkConfiguration::ServiceNetwork}{service network} or a -

514 \l {QNetworkConfiguration::InternetAccessPoint}{Internet access points} configurations, -

515 whereas \e ActiveConfiguration always returns identifiers to -

516 \l {QNetworkConfiguration::InternetAccessPoint}{Internet access points} configurations. -

517 \row -

518 \li ConnectInBackground -

519 \li Setting this property to \e true before calling \l open() implies that the connection attempt -

520 is made but if no connection can be established, the user is not connsulted and asked to select -

521 a suitable connection. This property is not set by default and support for it depends on the platform. -

522 -

523 \row -

524 \li AutoCloseSessionTimeout -

525 \li If the session requires polling to keep its state up to date, this property holds -

526 the timeout in milliseconds before the session will automatically close. If the -

527 value of this property is -1 the session will not automatically close. This property -

528 is set to -1 by default. -

529 -

530 The purpose of this property is to minimize resource use on platforms that use -

531 polling to update the state of the session. Applications can set the value of this -

532 property to the desired timeout before the session is closed. In response to the -

533 closed() signal the network session should be deleted to ensure that all polling is -

534 stopped. The session can then be recreated once it is required again. This property -

535 has no effect for sessions that do not require polling. -

536 \endtable -

537 */ -

538 QVariant QNetworkSession::sessionProperty(const QString &key) const -

539 { -

540

if (!d || !d->publicConfig.isValid())

partially evaluated: !d

TRUE	FALSE
no Evaluation Count:0	yes Evaluation Count:9

partially evaluated: !d->publicConfig.isValid()

TRUE	FALSE
no Evaluation Count:0	yes Evaluation Count:9

0-9

541

return QVariant();

never executed: return QVariant();

542 -

543

if (key == QLatin1String("ActiveConfiguration"))

partially evaluated: key == QLatin1String("ActiveConfiguration")

TRUE	FALSE
no Evaluation Count:0	yes Evaluation Count:9

0-9

544

return d->isOpen ? d->activeConfig.identifier() : QString();

never executed: return d->isOpen ? d->activeConfig.identifier() : QString();

545 -

546

if (key == QLatin1String("UserChoiceConfiguration")) {

partially evaluated: key == QLatin1String("UserChoiceConfiguration")

TRUE	FALSE
no Evaluation Count:0	yes Evaluation Count:9

0-9

547

if (!d->isOpen || d->publicConfig.type() != QNetworkConfiguration::UserChoice)

never evaluated: !d->isOpen

never evaluated: d->publicConfig.type() != QNetworkConfiguration::UserChoice

548

return QString();

never executed: return QString();

549 -

550

if (d->serviceConfig.isValid())

never evaluated: d->serviceConfig.isValid()

551

return d->serviceConfig.identifier();

never executed: return d->serviceConfig.identifier();

552 else -

553

return d->activeConfig.identifier();

never executed: return d->activeConfig.identifier();

554 } -

555 -

556

return d->sessionProperty(key);

executed: return d->sessionProperty(key);

Execution Count:9

557 } -

558 -

559 /*! -

560 Sets the property \a value on the session. The property is identified using -

561 \a key. Removing an already set property can be achieved by passing an -

562 invalid QVariant. -

563 -

564 Note that the \e UserChoiceConfiguration and \e ActiveConfiguration -

565 properties are read only and cannot be changed using this method. -

566 */ -

567 void QNetworkSession::setSessionProperty(const QString &key, const QVariant &value) -

568 { -

569

partially evaluated: !d

TRUE	FALSE
no Evaluation Count:0	yes Evaluation Count:7

0-7

570

if (key == QLatin1String("ActiveConfiguration") ||

never executed: return;

571 -

572

partially evaluated: key == QLatin1String("ActiveConfiguration")

TRUE	FALSE
no Evaluation Count:0	yes Evaluation Count:7

0-7

573

key == QLatin1String("UserChoiceConfiguration")) {

partially evaluated: key == QLatin1String("UserChoiceConfiguration")

TRUE	FALSE
no Evaluation Count:0	yes Evaluation Count:7

0-7

574

d->setSessionProperty(key, value);

never executed: return;

575 } -

576 -

577

executed (the execution status of this line is deduced): d->setSessionProperty(key, value);

578

executed: }

Execution Count:7

579 -

580 /*! -

581 Instructs the session to roam to the new access point. The old access point remains active -

582 until the application calls accept(). -

583 -

584 The newConfigurationActivated() signal is emitted once roaming has been completed. -

585 -

586 \sa accept() -

587 */ -

588 void QNetworkSession::migrate() -

589 { -

590

partially evaluated: d

TRUE	FALSE
yes Evaluation Count:1	no Evaluation Count:0

0-1

591

d->migrate();

executed: d->migrate();

Execution Count:1

592

executed: }

Execution Count:1

593 -

594 /*! -

595 This function indicates that the application does not wish to roam the session. -

596 -

597 \sa migrate() -

598 */ -

599 void QNetworkSession::ignore() -

600 { -

601

partially evaluated: d

TRUE	FALSE
yes Evaluation Count:1	no Evaluation Count:0

0-1

602

d->ignore();

executed: d->ignore();

Execution Count:1

603

executed: }

Execution Count:1

604 -

605 /*! -

606 Instructs the session to permanently accept the new access point. Once this function -

607 has been called the session may not return to the old access point. -

608 -

609 The old access point may be closed in the process if there are no other network sessions for it. -

610 Therefore any open socket that still uses the old access point -

611 may become unusable and should be closed before completing the migration. -

612 */ -

613 void QNetworkSession::accept() -

614 { -

615

partially evaluated: d

TRUE	FALSE
yes Evaluation Count:1	no Evaluation Count:0

0-1

616

d->accept();

executed: d->accept();

Execution Count:1

617

executed: }

Execution Count:1

618 -

619 /*! -

620 The new access point is not suitable for the application. By calling this function the -

621 session returns to the previous access point/configuration. This action may invalidate -

622 any socket that has been created via the not desired access point. -

623 -

624 \sa accept() -

625 */ -

626 void QNetworkSession::reject() -

627 { -

628

partially evaluated: d

TRUE	FALSE
yes Evaluation Count:1	no Evaluation Count:0

0-1

629

d->reject();

executed: d->reject();

Execution Count:1

630

return d ? d->bytesWritten() : Q_UINT64_C(0);

executed: }

Execution Count:1

631 -

632 -

633 /*! -

634 Returns the amount of data sent in bytes; otherwise 0. -

635 -

636 This field value includes the usage across all open network -

637 sessions which use the same network interface. -

638 -

639 If the session is based on a service network configuration the number of -

640 sent bytes across all active member configurations are returned. -

641 -

642 This function may not always be supported on all platforms and returns 0. -

643 The platform capability can be detected via QNetworkConfigurationManager::DataStatistics. -

644 -

645 \note On some platforms this function may run the main event loop. -

646 */ -

647 quint64 QNetworkSession::bytesWritten() const -

648 { -

649

never executed: return d ? d->bytesWritten() : static_cast<unsigned long long>(0ULL);

650 } -

651 -

652 /*! -

653 Returns the amount of data received in bytes; otherwise 0. -

654 -

655 This field value includes the usage across all open network -

656 sessions which use the same network interface. -

657 -

658 If the session is based on a service network configuration the number of -

659 sent bytes across all active member configurations are returned. -

660 -

661 This function may not always be supported on all platforms and returns 0. -

662 The platform capability can be detected via QNetworkConfigurationManager::DataStatistics. -

663 -

664 \note On some platforms this function may run the main event loop. -

665 */ -

666 quint64 QNetworkSession::bytesReceived() const -

667 { -

668

return d ? d->bytesReceived() : Q_UINT64_C(0);

never executed: return d ? d->bytesReceived() : static_cast<unsigned long long>(0ULL);

669 } -

670 -

671 /*! -

672 Returns the number of seconds that the session has been active. -

673 */ -

674 quint64 QNetworkSession::activeTime() const -

675 { -

676

return d ? d->activeTime() : Q_UINT64_C(0);

never executed: return d ? d->activeTime() : static_cast<unsigned long long>(0ULL);

677 } -

678 -

679 /*! -

680 Returns the network usage policies currently in force by the system. -

681 */ -

682 QNetworkSession::UsagePolicies QNetworkSession::usagePolicies() const -

683 { -

684

return d ? d->usagePolicies() : QNetworkSession::NoPolicy;

executed: return d ? d->usagePolicies() : QNetworkSession::NoPolicy;

Execution Count:3

685 } -

686 -

687 /*! -

688 \internal -

689 Change usage policies for unit testing. -

690 In normal use, the policies are published by the bearer plugin -

691 */ -

692 void QNetworkSessionPrivate::setUsagePolicies(QNetworkSession &session, QNetworkSession::UsagePolicies policies) -

693 { -

694

if (!session.d)

partially evaluated: !session.d

TRUE	FALSE
no Evaluation Count:0	yes Evaluation Count:2

0-2

695

session.d->setUsagePolicies(policies);

never executed: return;

696

executed (the execution status of this line is deduced): session.d->setUsagePolicies(policies);

697

QObject::connectNotify(signal);

executed: }

Execution Count:2

698 -

699 /*! -

700 \internal -

701 -

702 This function is required to detect whether the client wants to control -

703 the roaming process. If he connects to preferredConfigurationChanged() signal -

704 he intends to influence it. Otherwise QNetworkSession always roams -

705 without registering this session as a stakeholder in the roaming process. -

706 -

707 For more details check the Forced vs ALR roaming section in the QNetworkSession -

708 class description. -

709 */ -

710 void QNetworkSession::connectNotify(const QMetaMethod &signal) -

711 { -

712

executed (the execution status of this line is deduced): QObject::connectNotify(signal);

713 -

714

evaluated: !d

TRUE	FALSE
yes Evaluation Count:1	yes Evaluation Count:74

1-74

715

if (signal == preferredConfigurationChangedSignal)

executed: return;

Execution Count:1

716 -

717 //check for preferredConfigurationChanged() signal connect notification -

718 //This is not required on all platforms -

719 static const QMetaMethod preferredConfigurationChangedSignal = -

720 QMetaMethod::fromSignal(&QNetworkSession::preferredConfigurationChanged); -

721

partially evaluated: signal == preferredConfigurationChangedSignal

TRUE	FALSE
no Evaluation Count:0	yes Evaluation Count:74

0-74

722

d->setALREnabled(true);

never executed: d->setALREnabled(true);

723

QObject::disconnectNotify(signal);

executed: }

Execution Count:74

724 -

725 /*! -

726 \internal -

727 -

728 This function is called when the client disconnects from the -

729 preferredConfigurationChanged() signal. -

730 -

731 \sa connectNotify() -

732 */ -

733 void QNetworkSession::disconnectNotify(const QMetaMethod &signal) -

734 { -

735

executed (the execution status of this line is deduced): QObject::disconnectNotify(signal);

736 -

737

evaluated: !d

TRUE	FALSE
yes Evaluation Count:1	yes Evaluation Count:74

1-74

738

if (signal == preferredConfigurationChangedSignal)

executed: return;

Execution Count:1

739 -

740 //check for preferredConfigurationChanged() signal disconnect notification -

741 //This is not required on all platforms -

742 static const QMetaMethod preferredConfigurationChangedSignal = -

743 QMetaMethod::fromSignal(&QNetworkSession::preferredConfigurationChanged); -

744

partially evaluated: signal == preferredConfigurationChangedSignal

TRUE	FALSE
no Evaluation Count:0	yes Evaluation Count:74

0-74

745

d->setALREnabled(false);

never executed: d->setALREnabled(false);

746