kiwi-oss dec8a430df
[Microprofile] Add option to use tags a client keys and server generator (#16673)
* [Java/Microprofile] Add support for Jackson serialization & async interfaces using Mutiny in Java Microprofile library

* Regenerate samples & docs

* Add server generator

* Update client to set configKey by classname

* Remove debug remains and comments

* Adapt method override to upstream changes

* Regenerate samples

* Revert "Regenerate samples"

This reverts commit b5bcbdea90c71a2819a3ea6339c3878f249f97b4.

* Move additional 2xx response to dedicated OpenAPI document

Some other generators than those for Micronaut don't seem to be able to
handle this case, so we don't add it to the general pet store document.

* Make filename consistent with other files in the folder

* Regenerate Microprofile client and server samples

* Generate samples

* Update documentation

* Generate samples

* Remove left-over `*.orig` files from Git merges

* Regenerate samples

* Regenerated samples

* changed generator name to "java-microprofile"

* added the new folder to .github/workflows/samples-java-server-jdk8.yaml so that CI will test it moving forward

* Renamed JavaMicroprofileServerCodegen.java

* regenerated samples

* only enable configKeyFromClassName if configKey is not set

* Updated documentation

* Change samples to use junit 4

* Fix junit 4 test classes

* run ensure up-to-date script

* fix kotlin test errors

---------

Co-authored-by: pravussum <pravussum@users.noreply.github.com>
Co-authored-by: frank <frank.buechel@kiwigrid.com>
Co-authored-by: Oscar <oscar.obrien@kiwigrid.com>
Co-authored-by: oscarobr <133783370+oscarobr@users.noreply.github.com>
2024-05-07 16:24:23 +08:00
..
2024-04-17 19:05:37 +08:00
2021-09-09 12:49:03 +08:00
2020-05-26 09:55:00 +08:00
2024-04-17 19:05:37 +08:00

open_api_petstore

OpenApiPetstore - JavaScript client for open_api_petstore This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: " \ This SDK is automatically generated by the OpenAPI Generator project:

  • API version: 1.0.0
  • Package version: 1.0.0
  • Generator version: 7.6.0-SNAPSHOT
  • Build package: org.openapitools.codegen.languages.JavascriptClientCodegen

Installation

For Node.js

npm

To publish the library as a npm, please follow the procedure in "Publishing npm packages".

Then install it via:

npm install open_api_petstore --save

Finally, you need to build the module:

npm run build
Local development

To use the library locally without publishing to a remote npm registry, first install the dependencies by changing into the directory containing package.json (and this README). Let's call this JAVASCRIPT_CLIENT_DIR. Then run:

npm install

Next, link it globally in npm with the following, also from JAVASCRIPT_CLIENT_DIR:

npm link

To use the link you just defined in your project, switch to the directory you want to use your open_api_petstore from, and run:

npm link /path/to/<JAVASCRIPT_CLIENT_DIR>

Finally, you need to build the module:

npm run build

git

If the library is hosted at a git repository, e.g.https://github.com/GIT_USER_ID/GIT_REPO_ID then install it via:

    npm install GIT_USER_ID/GIT_REPO_ID --save

For browser

The library also works in the browser environment via npm and browserify. After following the above steps with Node.js and installing browserify with npm install -g browserify, perform the following (assuming main.js is your entry file):

browserify main.js > bundle.js

Then include bundle.js in the HTML pages.

Webpack Configuration

Using Webpack you may encounter the following error: "Module not found: Error: Cannot resolve module", most certainly you should disable AMD loader. Add/merge the following section to your webpack config:

module: {
  rules: [
    {
      parser: {
        amd: false
      }
    }
  ]
}

Getting Started

Please follow the installation instruction and execute the following JS code:

var OpenApiPetstore = require('open_api_petstore');


var api = new OpenApiPetstore.AnotherFakeApi()
var client = new OpenApiPetstore.Client(); // {Client} client model
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.call123testSpecialTags(client, callback);

Documentation for API Endpoints

All URIs are relative to http://petstore.swagger.io:80/v2

Class Method HTTP request Description
OpenApiPetstore.AnotherFakeApi call123testSpecialTags PATCH /another-fake/dummy To test special tags
OpenApiPetstore.DefaultApi fooGet GET /foo
OpenApiPetstore.FakeApi fakeHealthGet GET /fake/health Health check endpoint
OpenApiPetstore.FakeApi fakeHttpSignatureTest GET /fake/http-signature-test test http signature authentication
OpenApiPetstore.FakeApi fakeOuterBooleanSerialize POST /fake/outer/boolean
OpenApiPetstore.FakeApi fakeOuterCompositeSerialize POST /fake/outer/composite
OpenApiPetstore.FakeApi fakeOuterNumberSerialize POST /fake/outer/number
OpenApiPetstore.FakeApi fakeOuterStringSerialize POST /fake/outer/string
OpenApiPetstore.FakeApi fakePropertyEnumIntegerSerialize POST /fake/property/enum-int
OpenApiPetstore.FakeApi testAdditionalPropertiesReference POST /fake/additionalProperties-reference test referenced additionalProperties
OpenApiPetstore.FakeApi testBodyWithBinary PUT /fake/body-with-binary
OpenApiPetstore.FakeApi testBodyWithFileSchema PUT /fake/body-with-file-schema
OpenApiPetstore.FakeApi testBodyWithQueryParams PUT /fake/body-with-query-params
OpenApiPetstore.FakeApi testClientModel PATCH /fake To test &quot;client&quot; model
OpenApiPetstore.FakeApi testEndpointParameters POST /fake Fake endpoint for testing various parameters 假端點 偽のエンドポイント 가짜 엔드 포인트
OpenApiPetstore.FakeApi testEnumParameters GET /fake To test enum parameters
OpenApiPetstore.FakeApi testGroupParameters DELETE /fake Fake endpoint to test group parameters (optional)
OpenApiPetstore.FakeApi testInlineAdditionalProperties POST /fake/inline-additionalProperties test inline additionalProperties
OpenApiPetstore.FakeApi testInlineFreeformAdditionalProperties POST /fake/inline-freeform-additionalProperties test inline free-form additionalProperties
OpenApiPetstore.FakeApi testJsonFormData GET /fake/jsonFormData test json serialization of form data
OpenApiPetstore.FakeApi testQueryParameterCollectionFormat PUT /fake/test-query-parameters
OpenApiPetstore.FakeApi testStringMapReference POST /fake/stringMap-reference test referenced string map
OpenApiPetstore.FakeClassnameTags123Api testClassname PATCH /fake_classname_test To test class name in snake case
OpenApiPetstore.PetApi addPet POST /pet Add a new pet to the store
OpenApiPetstore.PetApi deletePet DELETE /pet/{petId} Deletes a pet
OpenApiPetstore.PetApi findPetsByStatus GET /pet/findByStatus Finds Pets by status
OpenApiPetstore.PetApi findPetsByTags GET /pet/findByTags Finds Pets by tags
OpenApiPetstore.PetApi getPetById GET /pet/{petId} Find pet by ID
OpenApiPetstore.PetApi updatePet PUT /pet Update an existing pet
OpenApiPetstore.PetApi updatePetWithForm POST /pet/{petId} Updates a pet in the store with form data
OpenApiPetstore.PetApi uploadFile POST /pet/{petId}/uploadImage uploads an image
OpenApiPetstore.PetApi uploadFileWithRequiredFile POST /fake/{petId}/uploadImageWithRequiredFile uploads an image (required)
OpenApiPetstore.StoreApi deleteOrder DELETE /store/order/{order_id} Delete purchase order by ID
OpenApiPetstore.StoreApi getInventory GET /store/inventory Returns pet inventories by status
OpenApiPetstore.StoreApi getOrderById GET /store/order/{order_id} Find purchase order by ID
OpenApiPetstore.StoreApi placeOrder POST /store/order Place an order for a pet
OpenApiPetstore.UserApi createUser POST /user Create user
OpenApiPetstore.UserApi createUsersWithArrayInput POST /user/createWithArray Creates list of users with given input array
OpenApiPetstore.UserApi createUsersWithListInput POST /user/createWithList Creates list of users with given input array
OpenApiPetstore.UserApi deleteUser DELETE /user/{username} Delete user
OpenApiPetstore.UserApi getUserByName GET /user/{username} Get user by user name
OpenApiPetstore.UserApi loginUser GET /user/login Logs user into the system
OpenApiPetstore.UserApi logoutUser GET /user/logout Logs out current logged in user session
OpenApiPetstore.UserApi updateUser PUT /user/{username} Updated user

Documentation for Models

Documentation for Authorization

Authentication schemes defined for the API:

petstore_auth

api_key

  • Type: API key
  • API key parameter name: api_key
  • Location: HTTP header

api_key_query

  • Type: API key
  • API key parameter name: api_key_query
  • Location: URL query string

http_basic_test

  • Type: HTTP basic authentication

bearer_test

  • Type: Bearer authentication (JWT)

http_signature_test

  • Type: HTTP signature authentication