Классы
API, предоставляемый модулем HW_API, полностью объектно-ориентирован.
Он очень похожи на интерфейс C++ Hyperwave SDK.
Состоит из следующих классов.
-
HW_API
-
HW_API_Object
-
HW_API_Attribute
-
HW_API_Error
-
HW_API_Content
-
HW_API_Reason
Некоторые базовые классы, такие как
HW_API_String,
HW_API_String_Array и т.д., которые существуют
в Hyperwave SDK, не были реализованы, поскольку PHP имеет мощные аналоги.
У каждого класса есть определенный метод, имена которого идентичны его
аналогам в Hyperwave SDK. Передача аргументов в эту функцию
отличается от всех других модулей PHP, но близка к C++ API
HW SDK. Вместо передачи нескольких параметров все они помещаются в
связанный массив и передаются как один параметр. Названия ключей
идентичны тем, которые задокументированы в HW SDK. Общие параметры
перечислены ниже. Если требуются другие параметры, они будут
документированы при необходимости.
-
objectIdentifier Имя или идентификатор объекта,
например, "rootcollection", "0x873A8768 0x00000002".
-
parentIdentifier Имя или идентификатор объекта,
который считается родительским.
-
object Экземпляр класса HW_API_Object.
-
parameters Экземпляр класса HW_API_Object.
-
version Версия объекта.
-
mode Целочисленное значение определяет
способ выполнения операции.
-
attributeSelector Любой массив строк, каждая
из которых содержит имя атрибута. Используется, если вы извлекаете запись
объекта и хотите включить определенные атрибуты.
-
objectQuery Запрос на выбор определенного объекта
из списка объектов. Используется для уменьшения количества объектов,
которые были доставлены такой функцией, как
hw_api::children() или hw_api::find().
Замечание:
Методы возвращают логическое значение (boolean), могут вернуть TRUE
, FALSE
или
объект HW_API_Error.