~clint-fewbar/charms/oneiric/omgubuntu-wp/trunk

* @param Microsoft_WindowsAzure_Credentials_CredentialsAbstract $credentials Microsoft_WindowsAzure_Credentials_CredentialsAbstract instance to use for request signing.

343

344

public function setCredentials(Microsoft_WindowsAzure_Credentials_CredentialsAbstract $credentials)

345

{

346

$this->_credentials = $credentials;

347

$this->_credentials->setAccountName($this->_accountName);

348

$this->_credentials->setAccountkey($this->_accountKey);

349

$this->_credentials->setUsePathStyleUri($this->_usePathStyleUri);

350

}

351

352

/**

353

* Get Microsoft_WindowsAzure_Credentials_CredentialsAbstract instance

354

355

* @return Microsoft_WindowsAzure_Credentials_CredentialsAbstract

356

357

public function getCredentials()

358

{

359

return $this->_credentials;

360

}

361

362

/**

363

* Perform request using Microsoft_Http_Client channel

364

365

* @param string $path Path

366

* @param string $queryString Query string

367

* @param string $httpVerb HTTP verb the request will use

368

* @param array $headers x-ms headers to add

369

* @param boolean $forTableStorage Is the request for table storage?

370

* @param mixed $rawData Optional RAW HTTP data to be sent over the wire

371

* @param string $resourceType Resource type

372

* @param string $requiredPermission Required permission

373

* @return Microsoft_Http_Response

374

375

protected function _performRequest(

376

$path = '/',

377

$queryString = '',

378

$httpVerb = Microsoft_Http_Client::GET,

379

$headers = array(),

380

$forTableStorage = false,

381

$rawData = null,

382

$resourceType = Microsoft_WindowsAzure_Storage::RESOURCE_UNKNOWN,

383

$requiredPermission = Microsoft_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_READ

384

) {

385

// Clean path

386

if (strpos($path, '/') !== 0) {

387

$path = '/' . $path;

388

}

389

390

// Clean headers

391

if (is_null($headers)) {

392

$headers = array();

393

}

394

395

// Ensure cUrl will also work correctly:

396

// - disable Content-Type if required

397

// - disable Expect: 100 Continue

398

if (!isset($headers["Content-Type"])) {

399

$headers["Content-Type"] = '';

400

}

401

$headers["Expect"]= '';

402

403

// Add version header

404

$headers['x-ms-version'] = $this->_apiVersion;

405

406

// URL encoding

407

$path = self::urlencode($path);

408

$queryString = self::urlencode($queryString);

409

410

// Generate URL and sign request

411

$requestUrl = $this->_credentials

412

->signRequestUrl($this->getBaseUrl() . $path . $queryString, $resourceType, $requiredPermission);

413

$requestHeaders = $this->_credentials

414

->signRequestHeaders($httpVerb, $path, $queryString, $headers, $forTableStorage, $resourceType, $requiredPermission, $rawData);

415

416

// Prepare request

417

$this->_httpClientChannel->resetParameters(true);

418

$this->_httpClientChannel->setUri($requestUrl);

419

$this->_httpClientChannel->setHeaders($requestHeaders);

420

$this->_httpClientChannel->setRawData($rawData);

421

422

// Execute request

423

$response = $this->_retryPolicy->execute(

424

array($this->_httpClientChannel, 'request'),

425

array($httpVerb)

426

);

427

428

return $response;

429

}

430

431

/**

432

* Parse result from Microsoft_Http_Response

433

434

* @param Microsoft_Http_Response $response Response from HTTP call

435

* @return object

436

* @throws Microsoft_WindowsAzure_Exception

437

438

protected function _parseResponse(Microsoft_Http_Response $response = null)

439

{

440

if (is_null($response)) {

441

throw new Microsoft_WindowsAzure_Exception('Response should not be null.');

442

}

443

444

$xml = @simplexml_load_string($response->getBody());

445

446

if ($xml !== false) {

447

// Fetch all namespaces

448

$namespaces = array_merge($xml->getNamespaces(true), $xml->getDocNamespaces(true));

449

450

// Register all namespace prefixes

451

foreach ($namespaces as $prefix => $ns) {

452

if ($prefix != '') {

453

$xml->registerXPathNamespace($prefix, $ns);

454

}

455

}

456

}

457

458

return $xml;

459

}

460

461

/**

462

* Generate metadata headers

463

464

* @param array $metadata

465

* @return HTTP headers containing metadata

466

467

protected function _generateMetadataHeaders($metadata = array())

468

{

469

// Validate

470

if (!is_array($metadata)) {

471

return array();

472

}

473

474

// Return headers

475

$headers = array();

476

foreach ($metadata as $key => $value) {

477

if (strpos($value, "\r") !== false || strpos($value, "\n") !== false) {

478

throw new Microsoft_WindowsAzure_Exception('Metadata cannot contain newline characters.');

479

}

480

481

if (!self::isValidMetadataName($key)) {

482

throw new Microsoft_WindowsAzure_Exception('Metadata name does not adhere to metadata naming conventions. See http://msdn.microsoft.com/en-us/library/aa664670(VS.71).aspx for more information.');

483

}

484

485

$headers["x-ms-meta-" . strtolower($key)] = $value;

486

}

487

return $headers;

488

}

489

490

/**

491

* Parse metadata headers

492

493

* @param array $headers HTTP headers containing metadata

494

* @return array

495

496

protected function _parseMetadataHeaders($headers = array())

497

{

498

// Validate

499

if (!is_array($headers)) {

500

return array();

501

}

502

503

// Return metadata

504

$metadata = array();

505

foreach ($headers as $key => $value) {

506

if (substr(strtolower($key), 0, 10) == "x-ms-meta-") {

507

$metadata[str_replace("x-ms-meta-", '', strtolower($key))] = $value;

508

}

509

}

510

return $metadata;

511

}

512

513

/**

514

* Parse metadata XML

515

516

* @param SimpleXMLElement $parentElement Element containing the Metadata element.

517

* @return array

518

519

protected function _parseMetadataElement($element = null)

520

{

521

// Metadata present?

522

if (!is_null($element) && isset($element->Metadata) && !is_null($element->Metadata)) {

523

return get_object_vars($element->Metadata);

524

}

525

526

return array();

527

}

528

529

/**

530

* Generate ISO 8601 compliant date string in UTC time zone

531

532

* @param int $timestamp

533

* @return string

534

535

public function isoDate($timestamp = null)

536

{

537

$tz = @date_default_timezone_get();

538

@date_default_timezone_set('UTC');

539

540

if (is_null($timestamp)) {

541

$timestamp = time();

542

}

543

544

$returnValue = str_replace('+00:00', '.0000000Z', @date('c', $timestamp));

545

@date_default_timezone_set($tz);

546

return $returnValue;

547

}

548

549

/**

550

* URL encode function

551

552

* @param string $value Value to encode

553

* @return string Encoded value

554

555

public static function urlencode($value)

556

{

557

return str_replace(' ', '%20', $value);

558

}

559

560

/**

561

* Is valid metadata name?

562

563

* @param string $metadataName Metadata name

564

* @return boolean

565

566

public static function isValidMetadataName($metadataName = '')

567

{

568

if (preg_match("/^[a-zA-Z0-9_@][a-zA-Z0-9_]*$/", $metadataName) === 0) {

569

return false;

570

}

571

572

if ($metadataName == '') {

573

return false;

574

}

575

576

return true;

577

}

578

579

/**

580

* Builds a query string from an array of elements

581

582

* @param array Array of elements

583

* @return string Assembled query string

584

585

public static function createQueryStringFromArray($queryString)

586

{

587

return count($queryString) > 0 ? '?' . implode('&', $queryString) : '';

588

}

589

}

Older »