OpenVeo Core server

API Docs for: 7.0.0
Show:

TaxonomyController

Extends EntityController
Module: core-controllers

Summary

Defines an entity controller to handle requests relative to taxonomies' entities.

Constructor

TaxonomyController

Syntax

TaxonomyController

()

Summary

Methods

getEntitiesAction

Syntax

getEntitiesAction

(
  • request
  • response
  • next
)

Summary

Gets a list of taxonomies.

Parameters:

  • request Request

    ExpressJS HTTP Request

    • [query] Object optional

      Request's query parameters

      • [include] String | Array optional
        The list of fields to include from returned taxonomies
      • [exclude] String | Array optional
        The list of fields to exclude from returned taxonomies. Ignored if include is also specified.
      • [query] String optional
        Search query to search on taxonomy name
      • [useSmartSearch=1] Number optional
        1 to use a more advanced search mechanism, 0 to use a simple search based on a regular expression
      • [page=0] Number optional
        The expected page in pagination system
      • [limit=10] Number optional
        The maximum number of expected results
      • [sortBy="name"] String optional
        The field to sort by (only "name" is available right now)
      • [sortOrder="desc"] String optional
        The sort order (either "asc" or "desc")
  • response Response

    ExpressJS HTTP Response

  • next Function

    Function to defer execution to the next registered middleware

Example:

// Response example
{
  "entities" : [ ... ],
  "pagination" : {
    "limit": ..., // The limit number of taxonomies by page
    "page": ..., // The actual page
    "pages": ..., // The total number of pages
    "size": ... // The total number of taxonomies
}

getProvider

Syntax

getProvider

() TaxonomyProvider

Summary

Gets an instance of the provider associated to the controller.

Returns:

TaxonomyProvider:

The provider

getTaxonomyTermsAction

Syntax

getTaxonomyTermsAction

(
  • request
  • response
  • next
)

Summary

Gets the list of terms of a taxonomy.

Parameters:

  • request Request

    ExpressJS HTTP Request

    • params Object

      Request's parameters

      • id String
        The id of the taxonomy to get terms from
  • response Response

    ExpressJS HTTP Response

  • next Function

    Function to defer execution to the next registered middleware

Example:

// Response example
{
  "terms" : [ ... ]
}