Struct PathInfo 

pub struct PathInfo {
    pub method: String,
    pub summary: String,
    pub description: Option<String>,
    pub tags: Vec<String>,
    pub parameters: Vec<Value>,
    pub request_body: Option<RequestBody>,
    pub responses: HashMap<String, Value>,
    pub security: Vec<SecurityRequirement>,
    pub operation_id: Option<String>,
    pub deprecated: Option<bool>,
}

Describes a single (path, method) operation in an OpenAPI spec.

Fields

method: String

summary: String

description: Option<String>

tags: Vec<String>

parameters: Vec<Value>

request_body: Option<RequestBody>

responses: HashMap<String, Value>

security: Vec<SecurityRequirement>

operation_id: Option<String>

deprecated: Option<bool>

Implementations

impl PathInfo

pub fn new(method: &str, summary: &str) -> Self

pub fn with_response(self, code: &str, desc: &str) -> Self

pub fn with_response_schema( self, code: &str, desc: &str, schema_ref: &str, ) -> Self

添加带 Schema 的响应

pub fn with_parameter(self, param: Value) -> Self

pub fn with_path_param(self, name: &str, desc: &str, required: bool) -> Self

添加路径参数

pub fn with_query_param(self, name: &str, desc: &str, required: bool) -> Self

添加查询参数

pub fn with_tag(self, tag: &str) -> Self

添加标签

pub fn with_request_body(self, body: RequestBody) -> Self

设置请求体

pub fn with_request_body_ref( self, desc: &str, schema_ref: &str, required: bool, ) -> Self

设置请求体（简化版：引用 Schema）

pub fn with_operation_id(self, id: &str) -> Self

设置操作 ID

pub fn with_security(self, req: SecurityRequirement) -> Self

设置安全要求

pub fn deprecated(self) -> Self

标记为已弃用

pub fn with_description(self, desc: &str) -> Self

设置描述

Trait Implementations

impl Clone for PathInfo

fn clone(&self) -> PathInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PathInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PathInfo

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PathInfo

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.