Query

The Query Helper gives you the ability to manipulate the vCloud SDK Query Service with ease. It provides abstraction for pagination.

Methods

Create a new Query Helper

__construct(\VMware_VCloud_SDK_Query $queryService, int $pageSize = self::DEFAULT_PAGE_SIZE) 

Arguments

$queryService

\VMware_VCloud_SDK_Query

The vCloud Director SDK for PHP Query Service

$pageSize

int

Page size

Create a new Query Helper and returns it without modifications. This form allow chaining in ALL versions of PHP:

create(\VMware_VCloud_SDK_Query $queryService, int $pageSize = self::DEFAULT_PAGE_SIZE) : \VCloud\Helpers\Query
static

\VCloud\Helpers\Query::create($service)->queryRecords(...)

Since PHP 5.4, Class member access on instantiation is allowed:

new (\VCloud\Helpers\Query($service))->queryRecords(...)

Arguments

$queryService

\VMware_VCloud_SDK_Query

The vCloud Director SDK for PHP Query Service

$pageSize

int

Page size

Response

\VCloud\Helpers\Query

Returns a new Query Handler

Determine whether a query page (VMware_VCloud_API_QueryResultRecordsType) is the last page or not.

isLastPage(\VMware_VCloud_API_ResourceType $records) : boolean

Arguments

$records

\VMware_VCloud_API_ResourceType

Response

boolean

Returns true if it's the last page, false otherwise

Send a query for a specific page and get records

queryRecordsPage(string $type, string $filter, int $page) : \VMware_VCloud_API_QueryResultRecordsType

Arguments

$type

string

The query type

$filter

string

The query filter

$page

int

The page to retrieve

Response

\VMware_VCloud_API_QueryResultRecordsType

Returns the query records

Send a query and get records

queryRecords(string $type, string $filter = null) : array

Arguments

$type

string

The query type

$filter

string

The query filter

Response

array

Returns an array of VMware_VCloud_API_QueryResultRecordType

Send a query and get the first record

queryRecord(string $type, string $filter = null) : \VMware_VCloud_API_QueryResultRecordType|boolean

Arguments

$type

string

The query type

$filter

string

The query filter

Response

\VMware_VCloud_API_QueryResultRecordType|boolean

Returns the first record of the query, or false if there isn't any result.

Send a query for a specific page and get references

queryReferencesPage(string $type, string $filter, int $page) : \VMware_VCloud_API_QueryResultReferencesType

Arguments

$type

string

The query type

$filter

string

The query filter

$page

int

The page to retrieve

Response

\VMware_VCloud_API_QueryResultReferencesType

Returns the query references

Send a query and get references

queryReferences(string $type, string $filter = null) : array

Arguments

$type

string

The query type

$filter

string

The query filter

Response

array

Returns an array of VMware_VCloud_API_QueryResultReferenceType

Send a query and get the first reference

queryReference(string $type, string $filter = null) : \VMware_VCloud_API_QueryResultReferenceType|boolean

Arguments

$type

string

The query type

$filter

string

The query filter

Response

\VMware_VCloud_API_QueryResultReferenceType|boolean

Returns the first reference of the query, or false if there isn't any result.

Constants

Default page size for queries

DEFAULT_PAGE_SIZE

Properties

vCloud Director SDK for PHP Query Service

queryService : \VMware_VCloud_SDK_Query
var

vCloud Director SDK for PHP Query Service

Type(s)

\VMware_VCloud_SDK_Query

Page size

pageSize : int
var

Page size

Type(s)

int