Classe SortExpression
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La classe SortExpression vous permet de personnaliser le tri des résultats de recherche.
La classe SortExpression est définie dans le module google.appengine.api.search.
Constructeur
Le constructeur de la classe SortExpression est défini comme suit :
-
class SortExpression(expression=None, direction=DESCENDING, default_value=None)
Trie les résultats en fonction de l'expression de notation spécifiée.
Arguments
- expression
Expression à évaluer lors du tri des résultats pour chaque document correspondant. L'expression peut être un simple nom de champ, ou une expression composée telle que _score + count(likes) * 0.1, qui ajoute le score d'un marqueur au nombre de décompte des valeurs d'un champ likes, pondéré par un coefficient de 0,1.
- direction
Ordre de tri des résultats de la recherche, soit ASCENDING (croissant) ou DESCENDING (décroissant).
- default_value
Valeur par défaut de l'expression, si aucun champ n'est présent et ne peut être calculé pour un document. Une valeur de texte doit être spécifiée pour les tris de texte. Une valeur numérique doit être spécifiée pour les tris numériques.
Result value
Nouvelle instance de la classe SortExpression.
Exceptions
- TypeError
Si l'un des paramètres contient un type non valide ou si un attribut inconnu est transmis.
- ValueError
Si un paramètre contient une valeur non valide.
Propriétés
Une instance de la classe SortExpression possède les propriétés suivantes :
- expression
Renvoie l'expression utilisée pour trier les résultats correspondants.
- direction
Renvoie l'ordre de tri de l'expression : ASCENDING ou DESCENDING.
- default_value
Renvoie une valeur par défaut pour l'expression si aucune autre valeur ne peut être calculée.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003eSortExpression\u003c/code\u003e class enables customization of search result sorting using an expression.\u003c/p\u003e\n"],["\u003cp\u003eIt can be used with first-generation runtimes and is applicable when upgrading to second-generation runtimes.\u003c/p\u003e\n"],["\u003cp\u003eThe class constructor accepts \u003ccode\u003eexpression\u003c/code\u003e, \u003ccode\u003edirection\u003c/code\u003e (\u003ccode\u003eASCENDING\u003c/code\u003e or \u003ccode\u003eDESCENDING\u003c/code\u003e), and \u003ccode\u003edefault_value\u003c/code\u003e to define how results are sorted.\u003c/p\u003e\n"],["\u003cp\u003eProperties \u003ccode\u003eexpression\u003c/code\u003e, \u003ccode\u003edirection\u003c/code\u003e, and \u003ccode\u003edefault_value\u003c/code\u003e can be retrieved from an instance of \u003ccode\u003eSortExpression\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# The SortExpression Class\n\nClass `SortExpression` allows you to customize how your search results are sorted.\n| This API is supported for first-generation runtimes and can be used when [upgrading to corresponding second-generation runtimes](/appengine/docs/standard/\n| python3\n|\n| /services/access). If you are updating to the App Engine Python 3 runtime, refer to the [migration guide](/appengine/migration-center/standard/migrate-to-second-gen/python-differences) to learn about your migration options for legacy bundled services.\n\n`SortExpression` is defined in the `google.appengine.api.search` module.\n\nConstructor\n-----------\n\nThe constructor for class `SortExpression` is defined as follows:\n\n\nclass SortExpression(expression=None, direction=DESCENDING, default_value=None)\n\n:\n Sort results by the specified scoring expression.\n\n:\n\n Arguments\n\n expression\n\n : An expression to be evaluated when sorting results for each matching document. The expression can simply be a field name, or some compound expression such as\n `_score + count(likes) * 0.1`\n which will add the score from a scorer to a count of the values of a\n `likes` field weighted by a factor of 0.1.\n\n direction\n\n : The direction to sort the search results, either ASCENDING or DESCENDING.\n\n default_value\n\n : The default value of the expression, if no field is present and cannot be calculated for a document. A text value must be specified for text sorts. A numeric value must be specified for numeric sorts.\n\n Result value\n\n : A new instance of class `SortExpression`.\n\n Exceptions\n\n TypeError\n\n : If any of the parameters have an invalid type, or an unknown attribute is passed.\n\n ValueError\n\n : If any parameter has an invalid value.\n\n \u003cbr /\u003e\n\nProperties\n----------\n\nAn instance of class `SortExpression` has the following properties:\n\nexpression\n\n: Returns the expression used to sort matched results.\n\ndirection\n\n: Returns the direction of sort expression: `ASCENDING` or `DESCENDING`.\n\ndefault_value\n\n: Returns a default value for the expression if no other value could be computed."]]
