REST APIStereotype REST API is to used define a REST API for a Designer service. Multiexcerpt |
---|
MultiExcerptName | RESTAPI |
---|
shouldDisplayInlineCommentsInIncludes | false |
---|
| Tagged Value | Description | Allowed Values |
---|
port | Defines the machine port number the service is binding to. | any number Using ports below 1024 may require additional privileges. | tracePort | Defines the shadow port of the service used for tracing. | any number (default is service port + 40000) | maxRequestBodySize | Multiexcerpt include |
---|
SpaceWithExcerpt | INTERNAL |
---|
MultiExcerptName | maxrequestbodysize |
---|
PageWithExcerpt | INTERNAL:_designer_excerpts |
---|
shouldDisplayInlineCommentsInIncludes | false |
---|
|
| any positive integer | 0 | Accept unlimited requests (default of services compiled with Builder versions < 7.12.0). | 2048 | 2MB, default if not specified | maxRequestHeaderSize | Multiexcerpt include |
---|
SpaceWithExcerpt | INTERNAL |
---|
MultiExcerptName | maxrequestheadersize |
---|
PageWithExcerpt | INTERNAL:_designer_excerpts |
---|
shouldDisplayInlineCommentsInIncludes | false |
---|
|
| any positive integer | 8 | 8 KB (default if not specified). | maxParallelConnections | Defines the maximum number of request that can be processed in parallel. | any positive integer | tokenType | Mark the service as to use token authorization. The REST Test Tool (API Management) will then present a field to enter the token and put the value into the HTTP headers. Refer also to tokenHeaderName for more information. You can use both in a REST service: basic authorization and token authorization, see useBasicAuth. | none | Do not use token authorization. | API Key | Use API key authorization. | tokenHeaderName | Defines the name of the header that will transport the token. This tagged value is only relevant, if token authorization is enabled at all. The token header name will be presented as the name of the header field that can be entered in the Bridge REST Test Tool. Refer also to tokenType for more information. | A valid HTTP header name (according to RFC2616/RFC7230). | useBasicAuth | Mark the service as to use basic authentication mechanisms. The REST Test Tool (API Management) will then present fields to enter the credentials and put the values into the HTTP headers. You can use both in a REST service: basic authorization and token authorization, see tokeType and tokenHeaderName. | true | Enable basic authentication. | false | Disable basic authentication (default). | jsonKeepNulls | Multiexcerpt |
---|
MultiExcerptName | jsonKeepNulls |
---|
| When jsonKeepNulls is true, attributes of the REST response object having NULL values will be rendered to the REST response, otherwise they will be left out completely (see also chapter NULL Values). |
| true | Render attributes with NULL values to the REST response. | false | Leave out attributes with NULL values in the REST response (default). | jsonCompact | Multiexcerpt |
---|
MultiExcerptName | jsonCompact |
---|
| When jsonCompact is true, the JSON composer will generate compact JSON, otherwise it will generate pretty JSON. |
| true | Generate compact JSON (default). | false | Generate pretty JSON. | jsonWriteTypeDiscriminator | Multiexcerpt |
---|
MultiExcerptName | jsonWriteTypeDiscriminator |
---|
| If jsonCompact is true, the JSON composer will generate xUML type properties ("e2e:type") to the generated JSON. If this option is true, the Runtime will write the original xUML type to the generated JSON in form of "e2e:type": "<name of the original xUML type>" if the type being serialized does not match the expected metadata. This is necessary if you want to convert the generated JSON back to an xUML class using jsonToClass(). |
| true | Write xUML type discriminator. | false | Do not write xUML type discriminator. | |
REST PortStereotype REST Port is used on a class to mark it as REST port, the root element of a REST service structure. Multiexcerpt |
---|
MultiExcerptName | RESTPort |
---|
shouldDisplayInlineCommentsInIncludes | false |
---|
| Tagged Value | Description | Allowed Values |
---|
path | Defines the path to this rest interface. If empty, the path is derived from the package structure. | none | path of the package structure will be used, e.g. /API/SupportCase/SupportAPI | any valid path string | path string starting with "/", e.g. /support | errorClass | Assigns a user-defined RESTError class to the REST interface. This class should be set in case of error and given back via the REST response. For more information on REST error classes, see RESTError. | any complex type describing the structure of the error | apiVersion | Defines the API version this port type provides (for documentation purposes only). | any string | |
REST ResourceStereotype REST Resource is used on a class to mark it as REST resource, part of a REST service structure. Multiexcerpt |
---|
MultiExcerptName | RESTResource |
---|
| Attribute (Name of Setting) | Description | Allowed Values |
---|
Relative Path (relativePath) | Defines the path of the REST resource or collection in relation to the parent resource. You can provide a static path, or a dynamic path using the notation : <name of a REST Parameter>. You may also provide a combination of both. | none | the name of the REST resource will be used, e.g. /supportcases | any valid string | the given name will be used | a dynamic path supplying a REST parameter | dynamic path, the value of the REST parameter will be passed to the REST methods, e.g. :id | Is Verbatim Path (isVerbatimPath)
| Multiexcerpt include |
---|
SpaceWithExcerpt | INTERNAL |
---|
MultiExcerptName | isVerbatimPath |
---|
PageWithExcerpt | INTERNAL:_designer_excerpts_stereotypes |
---|
shouldDisplayInlineCommentsInIncludes | false |
---|
|
| true | Path should be treated as verbatim, path normalization is disabled. | false (default) | Path should be URL encoded. | |
RESTStereotype REST is used on a REST resource class method to mark it as REST method, part of a REST service structure. If the method name is one of GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS (with optional trailing '/'), it will be invoked automatically on its parent resource when an corresponding request is received. Refer Implementing REST Methods to for more details and some examples. Multiexcerpt |
---|
| Attribute (Name of Setting) | Description | Allowed Values |
---|
Http Method (httpMethod) | Provide the HTTP method of this REST method should respond to. | a valid HTTP method | GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS | none | - method name, if it is one of: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS (with optional trailing '/')
- GET otherwise
| Relative Path (relativePath) | Defines the path of the REST method in relation to the parent resource. | none | The name of the REST method will be used. | any valid string | The given name will be used. The relative path may also contain variables (REST path parameters, specified as :<variable name>) and can be segmented like e.g. /date=:<a date variable> . | Is Verbatim Path (isVerbatimPath) | Multiexcerpt include |
---|
SpaceWithExcerpt | INTERNAL |
---|
MultiExcerptName | isVerbatimPath |
---|
PageWithExcerpt | INTERNAL:_designer_excerpts_stereotypes |
---|
shouldDisplayInlineCommentsInIncludes | false |
---|
|
| true | Path should be treated as verbatim, path normalization is disabled. | false (default) | Path should be URL encoded. | Blob Body Content Type (blobBodyContentType) | | |
|