| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687 |
- <?php
- /**
- * PostApiV3AgentFeedbackRequest
- *
- * PHP version 8.1
- *
- * @category Class
- * @package WikipaliApi
- * @author OpenAPI Generator team
- * @link https://openapi-generator.tech
- */
- /**
- * MINT API
- *
- * International Academy Of Pali Tipitaka(国际巴利三藏学院) 由 `php openapi/scripts/generate.php` 依据 api-v13 的路由与控制器源码生成。 响应统一封装为 `{ok, message, data}`;`ok=false` 时 `message` 为错误信息。
- *
- * The version of the OpenAPI document: 2026.11.12
- * Generated by: https://openapi-generator.tech
- * Generator version: 7.25.0
- */
- /**
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
- namespace WikipaliApi\Model;
- use \ArrayAccess;
- use \WikipaliApi\ObjectSerializer;
- /**
- * PostApiV3AgentFeedbackRequest Class Doc Comment
- *
- * @category Class
- * @package WikipaliApi
- * @author OpenAPI Generator team
- * @link https://openapi-generator.tech
- * @implements \ArrayAccess<string, mixed>
- */
- class PostApiV3AgentFeedbackRequest implements ModelInterface, ArrayAccess, \JsonSerializable
- {
- public const DISCRIMINATOR = null;
- /**
- * The original name of the model.
- *
- * @var string
- */
- protected static $openAPIModelName = 'post_api_v3_agent_feedback_request';
- /**
- * Array of property to type mappings. Used for (de)serialization
- *
- * @var string[]
- */
- protected static $openAPITypes = [
- 'message_id' => 'string',
- 'thread_id' => 'string',
- 'rating' => 'int',
- 'tags' => 'string[]',
- 'comment' => 'string',
- 'asked' => 'bool',
- 'device_id' => 'string',
- 'client' => 'string'
- ];
- /**
- * Array of property to format mappings. Used for (de)serialization
- *
- * @var string[]
- * @phpstan-var array<string, string|null>
- * @psalm-var array<string, string|null>
- */
- protected static $openAPIFormats = [
- 'message_id' => null,
- 'thread_id' => null,
- 'rating' => null,
- 'tags' => null,
- 'comment' => null,
- 'asked' => null,
- 'device_id' => null,
- 'client' => null
- ];
- /**
- * Array of nullable properties. Used for (de)serialization
- *
- * @var boolean[]
- */
- protected static array $openAPINullables = [
- 'message_id' => false,
- 'thread_id' => false,
- 'rating' => false,
- 'tags' => false,
- 'comment' => false,
- 'asked' => false,
- 'device_id' => false,
- 'client' => false
- ];
- /**
- * If a nullable field gets set to null, insert it here
- *
- * @var boolean[]
- */
- protected array $openAPINullablesSetToNull = [];
- /**
- * Array of property to type mappings. Used for (de)serialization
- *
- * @return array
- */
- public static function openAPITypes()
- {
- return self::$openAPITypes;
- }
- /**
- * Array of property to format mappings. Used for (de)serialization
- *
- * @return array
- */
- public static function openAPIFormats()
- {
- return self::$openAPIFormats;
- }
- /**
- * Array of nullable properties
- *
- * @return array
- */
- protected static function openAPINullables(): array
- {
- return self::$openAPINullables;
- }
- /**
- * Array of nullable field names deliberately set to null
- *
- * @return boolean[]
- */
- private function getOpenAPINullablesSetToNull(): array
- {
- return $this->openAPINullablesSetToNull;
- }
- /**
- * Setter - Array of nullable field names deliberately set to null
- *
- * @param boolean[] $openAPINullablesSetToNull
- */
- private function setOpenAPINullablesSetToNull(array $openAPINullablesSetToNull): void
- {
- $this->openAPINullablesSetToNull = $openAPINullablesSetToNull;
- }
- /**
- * Checks if a property is nullable
- *
- * @param string $property
- * @return bool
- */
- public static function isNullable(string $property): bool
- {
- return self::openAPINullables()[$property] ?? false;
- }
- /**
- * Checks if a nullable property is set to null.
- *
- * @param string $property
- * @return bool
- */
- public function isNullableSetToNull(string $property): bool
- {
- return in_array($property, $this->getOpenAPINullablesSetToNull(), true);
- }
- /**
- * Array of attributes where the key is the local name,
- * and the value is the original name
- *
- * @var string[]
- */
- protected static $attributeMap = [
- 'message_id' => 'message_id',
- 'thread_id' => 'thread_id',
- 'rating' => 'rating',
- 'tags' => 'tags',
- 'comment' => 'comment',
- 'asked' => 'asked',
- 'device_id' => 'device_id',
- 'client' => 'client'
- ];
- /**
- * Array of attributes to setter functions (for deserialization of responses)
- *
- * @var string[]
- */
- protected static $setters = [
- 'message_id' => 'setMessageId',
- 'thread_id' => 'setThreadId',
- 'rating' => 'setRating',
- 'tags' => 'setTags',
- 'comment' => 'setComment',
- 'asked' => 'setAsked',
- 'device_id' => 'setDeviceId',
- 'client' => 'setClient'
- ];
- /**
- * Array of attributes to getter functions (for serialization of requests)
- *
- * @var string[]
- */
- protected static $getters = [
- 'message_id' => 'getMessageId',
- 'thread_id' => 'getThreadId',
- 'rating' => 'getRating',
- 'tags' => 'getTags',
- 'comment' => 'getComment',
- 'asked' => 'getAsked',
- 'device_id' => 'getDeviceId',
- 'client' => 'getClient'
- ];
- /**
- * Array of attributes where the key is the local name,
- * and the value is the original name
- *
- * @return array
- */
- public static function attributeMap()
- {
- return self::$attributeMap;
- }
- /**
- * Array of attributes to setter functions (for deserialization of responses)
- *
- * @return array
- */
- public static function setters()
- {
- return self::$setters;
- }
- /**
- * Array of attributes to getter functions (for serialization of requests)
- *
- * @return array
- */
- public static function getters()
- {
- return self::$getters;
- }
- /**
- * The original name of the model.
- *
- * @return string
- */
- public function getModelName()
- {
- return self::$openAPIModelName;
- }
- public const CLIENT_MOBILE = 'mobile';
- public const CLIENT_WEB = 'web';
- /**
- * Gets allowable values of the enum
- *
- * @return string[]
- */
- public function getClientAllowableValues()
- {
- return [
- self::CLIENT_MOBILE,
- self::CLIENT_WEB,
- ];
- }
- /**
- * Associative array for storing property values
- *
- * @var mixed[]
- */
- protected $container = [];
- /**
- * Constructor
- *
- * @param mixed[]|null $data Associated array of property values
- * initializing the model
- */
- public function __construct(?array $data = null)
- {
- $this->setIfExists('message_id', $data ?? [], null);
- $this->setIfExists('thread_id', $data ?? [], null);
- $this->setIfExists('rating', $data ?? [], null);
- $this->setIfExists('tags', $data ?? [], null);
- $this->setIfExists('comment', $data ?? [], null);
- $this->setIfExists('asked', $data ?? [], null);
- $this->setIfExists('device_id', $data ?? [], null);
- $this->setIfExists('client', $data ?? [], null);
- }
- /**
- * Sets $this->container[$variableName] to the given data or to the given default Value; if $variableName
- * is nullable and its value is set to null in the $fields array, then mark it as "set to null" in the
- * $this->openAPINullablesSetToNull array
- *
- * @param string $variableName
- * @param array $fields
- * @param mixed $defaultValue
- */
- private function setIfExists(string $variableName, array $fields, $defaultValue): void
- {
- if (self::isNullable($variableName) && array_key_exists($variableName, $fields) && is_null($fields[$variableName])) {
- $this->openAPINullablesSetToNull[] = $variableName;
- }
- $this->container[$variableName] = $fields[$variableName] ?? $defaultValue;
- }
- /**
- * Show all the invalid properties with reasons.
- *
- * @return array invalid properties with reasons
- */
- public function listInvalidProperties()
- {
- $invalidProperties = [];
- if ($this->container['message_id'] === null) {
- $invalidProperties[] = "'message_id' can't be null";
- }
- if ($this->container['rating'] === null) {
- $invalidProperties[] = "'rating' can't be null";
- }
- $allowedValues = $this->getClientAllowableValues();
- if (!is_null($this->container['client']) && !in_array($this->container['client'], $allowedValues, true)) {
- $invalidProperties[] = sprintf(
- "invalid value '%s' for 'client', must be one of '%s'",
- $this->container['client'],
- implode("', '", $allowedValues)
- );
- }
- return $invalidProperties;
- }
- /**
- * Validate all the properties in the model
- * return true if all passed
- *
- * @return bool True if all properties are valid
- */
- public function valid()
- {
- return count($this->listInvalidProperties()) === 0;
- }
- /**
- * Gets message_id
- *
- * @return string
- */
- public function getMessageId()
- {
- return $this->container['message_id'];
- }
- /**
- * Sets message_id
- *
- * @param string $message_id AG-UI 回答消息 id
- *
- * @return self
- */
- public function setMessageId($message_id)
- {
- if (is_null($message_id)) {
- throw new \InvalidArgumentException('non-nullable message_id cannot be null');
- }
- $this->container['message_id'] = $message_id;
- return $this;
- }
- /**
- * Gets thread_id
- *
- * @return string|null
- */
- public function getThreadId()
- {
- return $this->container['thread_id'];
- }
- /**
- * Sets thread_id
- *
- * @param string|null $thread_id 会话 id(uuid)
- *
- * @return self
- */
- public function setThreadId($thread_id)
- {
- if (is_null($thread_id)) {
- throw new \InvalidArgumentException('non-nullable thread_id cannot be null');
- }
- $this->container['thread_id'] = $thread_id;
- return $this;
- }
- /**
- * Gets rating
- *
- * @return int
- */
- public function getRating()
- {
- return $this->container['rating'];
- }
- /**
- * Sets rating
- *
- * @param int $rating 1 赞 / -1 踩(只能是这两个值)
- *
- * @return self
- */
- public function setRating($rating)
- {
- if (is_null($rating)) {
- throw new \InvalidArgumentException('non-nullable rating cannot be null');
- }
- $this->container['rating'] = $rating;
- return $this;
- }
- /**
- * Gets tags
- *
- * @return string[]|null
- */
- public function getTags()
- {
- return $this->container['tags'];
- }
- /**
- * Sets tags
- *
- * @param string[]|null $tags 点赞标签或点踩原因
- *
- * @return self
- */
- public function setTags($tags)
- {
- if (is_null($tags)) {
- throw new \InvalidArgumentException('non-nullable tags cannot be null');
- }
- $this->container['tags'] = $tags;
- return $this;
- }
- /**
- * Gets comment
- *
- * @return string|null
- */
- public function getComment()
- {
- return $this->container['comment'];
- }
- /**
- * Sets comment
- *
- * @param string|null $comment 选了 other 时的文字说明,最长 1000 字
- *
- * @return self
- */
- public function setComment($comment)
- {
- if (is_null($comment)) {
- throw new \InvalidArgumentException('non-nullable comment cannot be null');
- }
- $this->container['comment'] = $comment;
- return $this;
- }
- /**
- * Gets asked
- *
- * @return bool|null
- */
- public function getAsked()
- {
- return $this->container['asked'];
- }
- /**
- * Sets asked
- *
- * @param bool|null $asked 是否主动询问问出来的
- *
- * @return self
- */
- public function setAsked($asked)
- {
- if (is_null($asked)) {
- throw new \InvalidArgumentException('non-nullable asked cannot be null');
- }
- $this->container['asked'] = $asked;
- return $this;
- }
- /**
- * Gets device_id
- *
- * @return string|null
- */
- public function getDeviceId()
- {
- return $this->container['device_id'];
- }
- /**
- * Sets device_id
- *
- * @param string|null $device_id 设备匿名 id(uuid)。未登录时必填
- *
- * @return self
- */
- public function setDeviceId($device_id)
- {
- if (is_null($device_id)) {
- throw new \InvalidArgumentException('non-nullable device_id cannot be null');
- }
- $this->container['device_id'] = $device_id;
- return $this;
- }
- /**
- * Gets client
- *
- * @return string|null
- */
- public function getClient()
- {
- return $this->container['client'];
- }
- /**
- * Sets client
- *
- * @param string|null $client 客户端
- *
- * @return self
- */
- public function setClient($client)
- {
- if (is_null($client)) {
- throw new \InvalidArgumentException('non-nullable client cannot be null');
- }
- $allowedValues = $this->getClientAllowableValues();
- if (!in_array($client, $allowedValues, true)) {
- throw new \InvalidArgumentException(
- sprintf(
- "Invalid value '%s' for 'client', must be one of '%s'",
- $client,
- implode("', '", $allowedValues)
- )
- );
- }
- $this->container['client'] = $client;
- return $this;
- }
- /**
- * Returns true if offset exists. False otherwise.
- *
- * @param integer|string $offset Offset
- *
- * @return boolean
- */
- public function offsetExists(mixed $offset): bool
- {
- return isset($this->container[$offset]);
- }
- /**
- * Gets offset.
- *
- * @param integer|string $offset Offset
- *
- * @return mixed|null
- */
- #[\ReturnTypeWillChange]
- public function offsetGet(mixed $offset)
- {
- return $this->container[$offset] ?? null;
- }
- /**
- * Sets value based on offset.
- *
- * @param int|null $offset Offset
- * @param mixed $value Value to be set
- *
- * @return void
- */
- public function offsetSet($offset, $value): void
- {
- if (is_null($offset)) {
- $this->container[] = $value;
- } else {
- $this->container[$offset] = $value;
- }
- }
- /**
- * Unsets offset.
- *
- * @param integer|string $offset Offset
- *
- * @return void
- */
- public function offsetUnset(mixed $offset): void
- {
- unset($this->container[$offset]);
- }
- /**
- * Serializes the object to a value that can be serialized natively by json_encode().
- * @link https://www.php.net/manual/en/jsonserializable.jsonserialize.php
- *
- * @return mixed Returns data which can be serialized by json_encode(), which is a value
- * of any type other than a resource.
- */
- #[\ReturnTypeWillChange]
- public function jsonSerialize()
- {
- return ObjectSerializer::sanitizeForSerialization($this);
- }
- /**
- * Gets the string presentation of the object
- *
- * @return string
- */
- public function __toString()
- {
- return json_encode(
- ObjectSerializer::sanitizeForSerialization($this),
- JSON_PRETTY_PRINT
- );
- }
- /**
- * Gets a header-safe presentation of the object
- *
- * @return string
- */
- public function toHeaderValue()
- {
- return json_encode(ObjectSerializer::sanitizeForSerialization($this));
- }
- }
|