Find Objects
Overview
Retrieve the list of objects according to a set of filters specified with query parameters:
- The objects are sorted by name.
URI
GET /rest/applications/{name}/objects?limit={number}
Path parameters
name (string)
This parameter identifies the analyzed application. The application name must be properly encoded if it is required. Character back-quote is not allowed.
Query parameters
limit (integer)
Required. The maximum number of objects to return.
skip (integer)
Optional. The number of objects to skip before including objects in the search limit.
name (string)
Optional. A substring of the object name to match. The matching is case insensitive. The string must be properly encoded if it is required (character &
must be encoded with %26
).
fullname (string)
Optional. A substring of the object full name to match. The matching is case insensitive. The string must be properly encoded if it is required (character &
must be encoded with %26
). Repeat the query parameter to search by list of fullnames: fullname=Vector&fullname=Cell
.
filepath (string)
Optional. A substring of the object file path to match. The matching is case insensitive.
mangling (string)
Optional. A substring of the object mangling to match. The matching is case insensitive.
type (string)
Optional. A substring of the object type (display name) to match. The matching is case insensitive. The string must be properly encoded if it is required.
select (string)
Optional.
select=source-locations
: The source location is added for each caller object. The response relies on the Source Code Service, it this service is disabled, or misconfigured then an HTTP 500 status code is returned.
Responses
application/json
The response includes a total number of objects macthing the input filters, and the list of objects matching the input filters according to the limit
and skip
input parameters. Example:
{
"totalObjects": 50,
"objects: [
{
"id": "2597057",
"name": "OrderUpdateComponent",
"fullName": "...\\src\\app\\feature\\order\\order\\order-details\\order-update\\order-update.component.ts.OrderUpdateComponent",
"type": "Angular Component",
"filePath": "...\\src\\app\\feature\\order\\order\\order-details\\order-update\\order-update.component.ts",
"mangling": ""
},
...
]
}
JSON representation
Property | Type | Description |
---|---|---|
totalObjects | integer | The total number of objects matching the filters |
objects[].id | string | The object ID. |
objects[].name | string | The object name. |
objects[].fullName | string | The object long name, usually locates the object in a software architecture. |
objects[].filePath | string | The analyzed source file path. In case of multiple file paths, this is the first one. It may be null if not applicable (ex: a table column). |
objects[].mangling | string | The function signature or an empty string if not applicable. |
objects[].type | string | The object type for a display. |
objects[].typeId | string | The object type identifier is the type reference key. |
objects[].sourceLocations[].fileId | string | The source file ID. |
objects[].sourceLocations[].fileName | string | The source file short name. |
objects[].sourceLocations[].filePath | string | The source file absolute path. |
objects[].sourceLocations[].relativePath | string | The source file relative path to the delivery deployment folder itself deduced from the application original name. |
objects[].sourceLocations[].nbLines | integer | The number of lines of the source file. |
objects[].sourceLocations[].startLine | integer | The first line number of the object within the source file. Ex: 4 means the 4th line within the source file. |
objects[].sourceLocations[].endLine | integer | The last line number of the object within the source file. Ex: 14 means the 14th line within the source file. |