{"id":340893,"date":"2022-11-07T15:00:56","date_gmt":"2022-11-07T15:00:56","guid":{"rendered":"http:\/\/savepearlharbor.com\/?p=340893"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=340893","title":{"rendered":"ogen: OpenAPI v3 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u0434\u043b\u044f Go<\/span>"},"content":{"rendered":"
<\/div>\n
\n
\n
\n
\n

\u0427\u0435\u043c \u0431\u043e\u043b\u044c\u0448\u0435 \u043a\u043e\u0434\u0430, \u0442\u0435\u043c \u0431\u043e\u043b\u044c\u0448\u0435 \u0431\u0430\u0433\u043e\u0432. \u041f\u0440\u043e\u0435\u043a\u0442 ogen<\/a> \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442 \u043a\u043e\u0434 \u043f\u043e OpenAPI \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438, \u0438\u0437\u0431\u0430\u0432\u043b\u044f\u044f \u043e\u0442 \u0441\u043e\u0442\u0435\u043d (\u0438\u043b\u0438 \u0434\u0430\u0436\u0435 \u0442\u044b\u0441\u044f\u0447) \u0441\u0442\u0440\u043e\u043a \u0441\u043a\u0443\u0447\u043d\u043e\u0433\u043e \u0448\u0430\u0431\u043b\u043e\u043d\u043d\u043e\u0433\u043e \u043a\u043e\u0434\u0430 \u043d\u0430 Go, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u043f\u0438\u0441\u0430\u0442\u044c \u0432\u0440\u0443\u0447\u043d\u0443\u044e \u0441 \u0440\u0438\u0441\u043a\u043e\u043c \u0434\u043e\u043f\u0443\u0441\u0442\u0438\u0442\u044c \u043e\u043f\u0435\u0447\u0430\u0442\u043a\u0443 \u0438\u043b\u0438 \u043e\u0448\u0438\u0431\u043a\u0443.<\/p>\n

<\/p>\n

\u0413\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u043f\u0438\u0448\u0435\u0442 \u043a\u043b\u0438\u0435\u043d\u0442 \u0438 \u0441\u0435\u0440\u0432\u0435\u0440, \u0430 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0443 \u043e\u0441\u0442\u0430\u0451\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0440\u0435\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u0442\u044c \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441 \u0434\u043b\u044f \u0441\u0435\u0440\u0432\u0435\u0440\u0430. \u0418 \u043d\u0438\u043a\u0430\u043a\u0438\u0445 interface{}<\/code> \u0438 \u0440\u0435\u0444\u043b\u0435\u043a\u0441\u0438\u0438, \u0442\u043e\u043b\u044c\u043a\u043e \u0441\u0442\u0440\u043e\u0433\u0430\u044f \u0442\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u044f \u0438 \u043a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f.<\/p>\n

<\/p>\n

\u042f \u0440\u0430\u0441\u0441\u043a\u0430\u0436\u0443, \u0447\u0435\u043c ogen \u043e\u0442\u043b\u0438\u0447\u0430\u0435\u0442\u0441\u044f \u043e\u0442 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0445 \u0440\u0435\u0448\u0435\u043d\u0438\u0439 \u0438 \u043f\u043e\u0447\u0435\u043c\u0443 \u0441\u0442\u043e\u0438\u0442 \u0435\u0433\u043e \u043f\u043e\u043f\u0440\u043e\u0431\u043e\u0432\u0430\u0442\u044c.<\/p>\n

<\/a> <\/p>\n

\u0421\u0442\u0440\u043e\u0433\u0430\u044f \u0442\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u044f<\/h2>\n

<\/p>\n

\u0413\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0441\u0442\u0440\u043e\u0433\u043e-\u0442\u0438\u043f\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u043a\u043b\u0438\u0435\u043d\u0442 \u0438 \u0441\u0435\u0440\u0432\u0435\u0440, \u0447\u0435\u043c-\u0442\u043e \u043f\u043e\u0445\u043e\u0436\u0435 \u043d\u0430 gRPC. \u0414\u043e\u043f\u043e\u043b\u043d\u044f\u0435\u0442\u0441\u044f \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435\u043c \u0438\u0437 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0432 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u0445.<\/p>\n

<\/p>\n

\u0414\u043b\u044f \u0441\u0435\u0440\u0432\u0435\u0440\u0430 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043d\u0443\u0436\u043d\u043e \u0438\u043c\u043f\u043b\u0435\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c:<\/p>\n

<\/p>\n

\/\/ Handler handles operations described by OpenAPI v3 specification. type Handler interface {     \/\/ AddPet implements addPet operation.     \/\/     \/\/ Creates a new pet in the store. Duplicates are allowed.     \/\/     \/\/ POST \/pets     AddPet(ctx context.Context, req NewPet) (AddPetRes, error)     \/\/ DeletePet implements deletePet operation.     \/\/     \/\/ Deletes a single pet based on the ID supplied.     \/\/     \/\/ DELETE \/pets\/{id}     DeletePet(ctx context.Context, params DeletePetParams) (DeletePetRes, error)     \/\/ FindPetByID implements find pet by id operation.     \/\/     \/\/ Returns a user based on a single ID, if the user does not have access to the pet.     \/\/     \/\/ GET \/pets\/{id}     FindPetByID(ctx context.Context, params FindPetByIDParams) (FindPetByIDRes, error)     \/\/ FindPets implements findPets operation.     \/\/     \/\/ Returns all pets from the system that the user has access to     \/\/     \/\/ GET \/pets     FindPets(ctx context.Context, params FindPetsParams) (FindPetsRes, error)     \/\/ PatchPet implements patchPet operation.     \/\/     \/\/ Patch a pet.     \/\/     \/\/ PATCH \/pets\/{id}     PatchPet(ctx context.Context, req UpdatePet, params PatchPetParams) (PatchPetRes, error) }<\/code><\/pre>\n
  <\/p>\n
\u041a\u043b\u0438\u0435\u043d\u0442 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0430\u043d\u0430\u043b\u043e\u0433\u0438\u0447\u043d\u043e:<\/p>\n
  <\/p>\n
func (c *Client) AddPet(ctx context.Context, request NewPet) (res AddPetRes, err error) {}  \/\/ PatchPet invokes patchPet operation. \/\/ \/\/ Patch a pet. \/\/ \/\/ PATCH \/pets\/{id}   func (c *Client) PatchPet(ctx context.Context, request UpdatePet, params PatchPetParams) (res PatchPetRes, err error) {} <\/code><\/pre>\n
  <\/p>\n
\u0412\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f<\/h2>\n
  <\/p>\n
\u0412 ogen \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0430\u043d\u044b maxLength<\/code>, minLength<\/code>, pattern<\/code> (regex), minimum<\/code>, maximum<\/code> \u0438 \u0434\u0440\u0443\u0433\u0438\u0435 \u0432\u0430\u043b\u0438\u0434\u0430\u0442\u043e\u0440\u044b \u0441\u0442\u0440\u043e\u043a, \u043c\u0430\u0441\u0441\u0438\u0432\u043e\u0432, \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432 \u0438 \u0447\u0438\u0441\u0435\u043b, \u0434\u043b\u044f \u043a\u043e\u0442\u043e\u0440\u044b\u0445 \u0441\u0442\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u044e\u0442\u0441\u044f \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 \u043d\u0430 \u043a\u043b\u0438\u0435\u043d\u0442\u0435 \u0438 \u0441\u0435\u0440\u0432\u0435\u0440\u0435.<\/p>\n
  <\/p>\n
UpdatePet:     type: object     properties:       name:         type: string         maxLength: 25         minLength: 3         pattern: '^[a-zA-Z0-9]+$'       tag:         maxLength: 10         minLength: 1         pattern: '^[a-zA-Z0-9]+$'         nullable: true         type: string<\/code><\/pre>\n
  <\/p>\n
\u041d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0435 \u0438 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u043e\u043b\u044f<\/h3>\n
  <\/p>\n
\u0411\u043e\u043b\u0435\u0435 \u0442\u043e\u0433\u043e, \u044d\u0444\u0444\u0435\u043a\u0442\u0438\u0432\u043d\u043e \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442\u0441\u044f, \u0447\u0442\u043e \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u043e\u043b\u044f \u0437\u0430\u0434\u0430\u043d\u044b, \u0430 \u043d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0435 (\u0435\u0441\u043b\u0438 \u043d\u0435 \u0440\u0430\u0437\u0440\u0435\u0448\u0435\u043d\u044b) \u043d\u0435 \u043f\u0435\u0440\u0435\u0434\u0430\u044e\u0442\u0441\u044f:<\/p>\n
  <\/p>\n
\/\/ Validate required fields. var failures []validate.FieldError for i, mask := range [1]uint8{     0b00000001, } {     if result := (requiredBitSet[i] & mask) ^ mask; result != 0 {         \/\/ Mask only required fields and check equality to mask using XOR.         \/\/         \/\/ If XOR result is not zero, result is not equal to expected, so some fields are missed.         \/\/ Bits of fields which would be set are actually bits of missed fields.         missed := bits.OnesCount8(result)         for bitN := 0; bitN < missed; bitN++ {             bitIdx := bits.TrailingZeros8(result)             fieldIdx := i*8 + bitIdx             var name string             if fieldIdx < len(jsonFieldsNameOfNewPet) {                 name = jsonFieldsNameOfNewPet[fieldIdx]             } else {                 name = strconv.Itoa(fieldIdx)             }             failures = append(failures, validate.FieldError{                 Name:  name,                 Error: validate.ErrFieldRequired,             })             \/\/ Reset bit.             result &^= 1 << bitIdx         }     } }<\/code><\/pre>\n
  <\/p>\n
Enum<\/h3>\n
  <\/p>\n
\u041f\u043e\u0434\u0434\u0435\u0440\u0436\u0430\u043d\u044b \u043f\u043e\u043b\u043d\u043e\u0441\u0442\u044c\u044e, \u0434\u043b\u044f \u043d\u0438\u0445 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u044e\u0442\u0441\u044f \u043a\u043e\u043d\u0441\u0442\u0430\u043d\u0442\u044b \u0438 \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u044e\u0442\u0441\u044f \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f \u0438 \u043d\u0430 \u043a\u043b\u0438\u0435\u043d\u0442\u0435, \u0438 \u043d\u0430 \u0441\u0435\u0440\u0432\u0435\u0440\u0435:<\/p>\n
  <\/p>\n
\/\/ Ref: #\/components\/schemas\/Kind   type Kind string    const (      KindCat   Kind = \"Cat\"      KindDog   Kind = \"Dog\"      KindFish  Kind = \"Fish\"      KindBird  Kind = \"Bird\"      KindOther Kind = \"Other\"   )  func (s Kind) Validate() error {     switch s {     case \"Cat\":         return nil     case \"Dog\":         return nil     case \"Fish\":         return nil     case \"Bird\":         return nil     case \"Other\":         return nil     default:         return errors.Errorf(\"invalid value: %v\", s)     } }  \/\/ Decode decodes Kind from json. func (s *Kind) Decode(d *jx.Decoder) error {     if s == nil {         return errors.New(\"invalid: unable to decode Kind to nil\")     }     v, err := d.StrBytes()     if err != nil {         return err     }     \/\/ Try to use constant string.     switch Kind(v) {     case KindCat:         *s = KindCat     case KindDog:         *s = KindDog     case KindFish:         *s = KindFish     case KindBird:         *s = KindBird     case KindOther:         *s = KindOther     default:         *s = Kind(v)     }      return nil } <\/code><\/pre>\n
  <\/p>\n
\u0422\u043e\u0442 \u0436\u0435 deepmap\/oapi-codegen<\/code> \u043d\u0435 \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f enum<\/code>-\u043e\u0432, \u0442\u043e\u043b\u044c\u043a\u043e \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u044f \u043d\u043e\u0432\u044b\u0439 \u0442\u0438\u043f \u0438 \u043a\u043e\u043d\u0441\u0442\u0430\u043d\u0442\u044b.<\/p>\n
  <\/p>\n
\u0411\u0435\u0437 \u0443\u043a\u0430\u0437\u0430\u0442\u0435\u043b\u0435\u0439<\/h2>\n
  <\/p>\n
\u0422\u0430\u043c, \u0433\u0434\u0435 \u044d\u0442\u043e \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e.<\/p>\n
  <\/p>\n
\u0412 \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u0435 \u0441\u043b\u0443\u0447\u0430\u0435\u0432, \u0434\u043b\u044f \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0445 (\u0438\u043b\u0438 nullable) \u043f\u043e\u043b\u0435\u0439 \u0432 Go \u043f\u0440\u0438\u043d\u044f\u0442\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0443\u043a\u0430\u0437\u0430\u0442\u0435\u043b\u0438:<\/p>\n
  <\/p>\n
type Pet struct {     \/\/ Name of the pet     Name string `json:\"name\"`      \/\/ Type of the pet     Tag *string `json:\"tag,omitempty\"` }<\/code><\/pre>\n
  <\/p>\n
\u042d\u0442\u043e \u043f\u0443\u0441\u0442\u044c \u0438 \u043f\u0440\u0438\u0432\u044b\u0447\u043d\u044b\u0439, \u043d\u043e \u0441\u0435\u043c\u0430\u043d\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u043a\u043e\u0441\u0442\u044b\u043b\u044c:<\/p>\n
  <\/p>\n