mirror of
				https://github.com/OpenAPITools/openapi-generator.git
				synced 2025-11-03 18:23:44 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			247 lines
		
	
	
		
			5.7 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			247 lines
		
	
	
		
			5.7 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
---
 | 
						|
title: Documentation for the n4js Generator
 | 
						|
---
 | 
						|
 | 
						|
## METADATA
 | 
						|
 | 
						|
| Property | Value | Notes |
 | 
						|
| -------- | ----- | ----- |
 | 
						|
| generator name | n4js | pass this to the generate command after -g |
 | 
						|
| generator stability | BETA | |
 | 
						|
| generator type | CLIENT | |
 | 
						|
| generator language | Java | |
 | 
						|
| generator default templating engine | mustache | |
 | 
						|
| helpTxt | Generates a n4js client. | |
 | 
						|
 | 
						|
## CONFIG OPTIONS
 | 
						|
These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to [configuration docs](https://openapi-generator.tech/docs/configuration) for more details.
 | 
						|
 | 
						|
| Option | Description | Values | Default |
 | 
						|
| ------ | ----------- | ------ | ------- |
 | 
						|
|apiNamePrefix|Prefix that will be appended to all API names ('tags'). Default: empty string. e.g. Pet => Pet.| |null|
 | 
						|
|apiPackage|package for generated api classes| |null|
 | 
						|
|checkRequiredParamsNotNull|Iff true null-checks are performed for required parameters.| |null|
 | 
						|
|checkSuperfluousBodyProps|Iff true a new copy of the given body object is transmitted. This copy only contains those properties defined in its model specification.| |null|
 | 
						|
|generateDefaultApiExecuter|Iff true a default implementation of the api executer interface is generated.| |null|
 | 
						|
|modelPackage|package for generated models| |null|
 | 
						|
 | 
						|
## IMPORT MAPPING
 | 
						|
 | 
						|
| Type/Alias | Imports |
 | 
						|
| ---------- | ------- |
 | 
						|
 | 
						|
 | 
						|
## INSTANTIATION TYPES
 | 
						|
 | 
						|
| Type/Alias | Instantiated By |
 | 
						|
| ---------- | --------------- |
 | 
						|
 | 
						|
 | 
						|
## LANGUAGE PRIMITIVES
 | 
						|
 | 
						|
<ul class="column-ul">
 | 
						|
<li>Array</li>
 | 
						|
<li>Error</li>
 | 
						|
<li>Object</li>
 | 
						|
<li>String</li>
 | 
						|
<li>any</li>
 | 
						|
<li>any+</li>
 | 
						|
<li>boolean</li>
 | 
						|
<li>int</li>
 | 
						|
<li>number</li>
 | 
						|
<li>object</li>
 | 
						|
<li>string</li>
 | 
						|
</ul>
 | 
						|
 | 
						|
## RESERVED WORDS
 | 
						|
 | 
						|
<ul class="column-ul">
 | 
						|
<li>abstract</li>
 | 
						|
<li>await</li>
 | 
						|
<li>boolean</li>
 | 
						|
<li>break</li>
 | 
						|
<li>byte</li>
 | 
						|
<li>case</li>
 | 
						|
<li>catch</li>
 | 
						|
<li>char</li>
 | 
						|
<li>class</li>
 | 
						|
<li>const</li>
 | 
						|
<li>continue</li>
 | 
						|
<li>debugger</li>
 | 
						|
<li>default</li>
 | 
						|
<li>delete</li>
 | 
						|
<li>do</li>
 | 
						|
<li>double</li>
 | 
						|
<li>else</li>
 | 
						|
<li>enum</li>
 | 
						|
<li>export</li>
 | 
						|
<li>extends</li>
 | 
						|
<li>false</li>
 | 
						|
<li>final</li>
 | 
						|
<li>finally</li>
 | 
						|
<li>float</li>
 | 
						|
<li>for</li>
 | 
						|
<li>formParams</li>
 | 
						|
<li>function</li>
 | 
						|
<li>goto</li>
 | 
						|
<li>headerParams</li>
 | 
						|
<li>if</li>
 | 
						|
<li>implements</li>
 | 
						|
<li>import</li>
 | 
						|
<li>in</li>
 | 
						|
<li>instanceof</li>
 | 
						|
<li>int</li>
 | 
						|
<li>interface</li>
 | 
						|
<li>let</li>
 | 
						|
<li>long</li>
 | 
						|
<li>native</li>
 | 
						|
<li>new</li>
 | 
						|
<li>null</li>
 | 
						|
<li>package</li>
 | 
						|
<li>private</li>
 | 
						|
<li>protected</li>
 | 
						|
<li>public</li>
 | 
						|
<li>queryParameters</li>
 | 
						|
<li>requestOptions</li>
 | 
						|
<li>return</li>
 | 
						|
<li>short</li>
 | 
						|
<li>static</li>
 | 
						|
<li>super</li>
 | 
						|
<li>switch</li>
 | 
						|
<li>synchronized</li>
 | 
						|
<li>this</li>
 | 
						|
<li>throw</li>
 | 
						|
<li>transient</li>
 | 
						|
<li>true</li>
 | 
						|
<li>try</li>
 | 
						|
<li>typeof</li>
 | 
						|
<li>useFormData</li>
 | 
						|
<li>var</li>
 | 
						|
<li>varLocalDeferred</li>
 | 
						|
<li>varLocalPath</li>
 | 
						|
<li>void</li>
 | 
						|
<li>volatile</li>
 | 
						|
<li>while</li>
 | 
						|
<li>with</li>
 | 
						|
<li>yield</li>
 | 
						|
</ul>
 | 
						|
 | 
						|
## FEATURE SET
 | 
						|
 | 
						|
 | 
						|
### Client Modification Feature
 | 
						|
| Name | Supported | Defined By |
 | 
						|
| ---- | --------- | ---------- |
 | 
						|
|BasePath|✗|ToolingExtension
 | 
						|
|Authorizations|✗|ToolingExtension
 | 
						|
|UserAgent|✗|ToolingExtension
 | 
						|
|MockServer|✗|ToolingExtension
 | 
						|
 | 
						|
### Data Type Feature
 | 
						|
| Name | Supported | Defined By |
 | 
						|
| ---- | --------- | ---------- |
 | 
						|
|Custom|✗|OAS2,OAS3
 | 
						|
|Int32|✓|OAS2,OAS3
 | 
						|
|Int64|✓|OAS2,OAS3
 | 
						|
|Float|✓|OAS2,OAS3
 | 
						|
|Double|✓|OAS2,OAS3
 | 
						|
|Decimal|✓|ToolingExtension
 | 
						|
|String|✓|OAS2,OAS3
 | 
						|
|Byte|✓|OAS2,OAS3
 | 
						|
|Binary|✓|OAS2,OAS3
 | 
						|
|Boolean|✓|OAS2,OAS3
 | 
						|
|Date|✓|OAS2,OAS3
 | 
						|
|DateTime|✓|OAS2,OAS3
 | 
						|
|Password|✓|OAS2,OAS3
 | 
						|
|File|✓|OAS2
 | 
						|
|Uuid|✗|
 | 
						|
|Array|✓|OAS2,OAS3
 | 
						|
|Null|✗|OAS3
 | 
						|
|AnyType|✗|OAS2,OAS3
 | 
						|
|Object|✓|OAS2,OAS3
 | 
						|
|Maps|✓|ToolingExtension
 | 
						|
|CollectionFormat|✓|OAS2
 | 
						|
|CollectionFormatMulti|✓|OAS2
 | 
						|
|Enum|✓|OAS2,OAS3
 | 
						|
|ArrayOfEnum|✓|ToolingExtension
 | 
						|
|ArrayOfModel|✓|ToolingExtension
 | 
						|
|ArrayOfCollectionOfPrimitives|✓|ToolingExtension
 | 
						|
|ArrayOfCollectionOfModel|✓|ToolingExtension
 | 
						|
|ArrayOfCollectionOfEnum|✓|ToolingExtension
 | 
						|
|MapOfEnum|✓|ToolingExtension
 | 
						|
|MapOfModel|✓|ToolingExtension
 | 
						|
|MapOfCollectionOfPrimitives|✓|ToolingExtension
 | 
						|
|MapOfCollectionOfModel|✓|ToolingExtension
 | 
						|
|MapOfCollectionOfEnum|✓|ToolingExtension
 | 
						|
 | 
						|
### Documentation Feature
 | 
						|
| Name | Supported | Defined By |
 | 
						|
| ---- | --------- | ---------- |
 | 
						|
|Readme|✗|ToolingExtension
 | 
						|
|Model|✓|ToolingExtension
 | 
						|
|Api|✓|ToolingExtension
 | 
						|
 | 
						|
### Global Feature
 | 
						|
| Name | Supported | Defined By |
 | 
						|
| ---- | --------- | ---------- |
 | 
						|
|Host|✓|OAS2,OAS3
 | 
						|
|BasePath|✓|OAS2,OAS3
 | 
						|
|Info|✓|OAS2,OAS3
 | 
						|
|Schemes|✗|OAS2,OAS3
 | 
						|
|PartialSchemes|✓|OAS2,OAS3
 | 
						|
|Consumes|✓|OAS2
 | 
						|
|Produces|✓|OAS2
 | 
						|
|ExternalDocumentation|✓|OAS2,OAS3
 | 
						|
|Examples|✓|OAS2,OAS3
 | 
						|
|XMLStructureDefinitions|✗|OAS2,OAS3
 | 
						|
|MultiServer|✗|OAS3
 | 
						|
|ParameterizedServer|✗|OAS3
 | 
						|
|ParameterStyling|✗|OAS3
 | 
						|
|Callbacks|✓|OAS3
 | 
						|
|LinkObjects|✗|OAS3
 | 
						|
 | 
						|
### Parameter Feature
 | 
						|
| Name | Supported | Defined By |
 | 
						|
| ---- | --------- | ---------- |
 | 
						|
|Path|✓|OAS2,OAS3
 | 
						|
|Query|✓|OAS2,OAS3
 | 
						|
|Header|✓|OAS2,OAS3
 | 
						|
|Body|✓|OAS2
 | 
						|
|FormUnencoded|✓|OAS2
 | 
						|
|FormMultipart|✓|OAS2
 | 
						|
|Cookie|✓|OAS3
 | 
						|
 | 
						|
### Schema Support Feature
 | 
						|
| Name | Supported | Defined By |
 | 
						|
| ---- | --------- | ---------- |
 | 
						|
|Simple|✓|OAS2,OAS3
 | 
						|
|Composite|✓|OAS2,OAS3
 | 
						|
|Polymorphism|✓|OAS2,OAS3
 | 
						|
|Union|✗|OAS3
 | 
						|
|allOf|✗|OAS2,OAS3
 | 
						|
|anyOf|✗|OAS3
 | 
						|
|oneOf|✗|OAS3
 | 
						|
|not|✗|OAS3
 | 
						|
 | 
						|
### Security Feature
 | 
						|
| Name | Supported | Defined By |
 | 
						|
| ---- | --------- | ---------- |
 | 
						|
|BasicAuth|✓|OAS2,OAS3
 | 
						|
|ApiKey|✓|OAS2,OAS3
 | 
						|
|OpenIDConnect|✗|OAS3
 | 
						|
|BearerToken|✓|OAS3
 | 
						|
|OAuth2_Implicit|✓|OAS2,OAS3
 | 
						|
|OAuth2_Password|✓|OAS2,OAS3
 | 
						|
|OAuth2_ClientCredentials|✓|OAS2,OAS3
 | 
						|
|OAuth2_AuthorizationCode|✓|OAS2,OAS3
 | 
						|
|SignatureAuth|✗|OAS3
 | 
						|
|AWSV4Signature|✗|ToolingExtension
 | 
						|
 | 
						|
### Wire Format Feature
 | 
						|
| Name | Supported | Defined By |
 | 
						|
| ---- | --------- | ---------- |
 | 
						|
|JSON|✓|OAS2,OAS3
 | 
						|
|XML|✓|OAS2,OAS3
 | 
						|
|PROTOBUF|✗|ToolingExtension
 | 
						|
|Custom|✗|OAS2,OAS3
 |