La clase SortExpression
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La clase SortExpression te permite personalizar el modo en que se ordenan los resultados de la búsqueda.
SortExpression se define en el módulo google.appengine.api.search.
Constructor
El constructor para la clase SortExpression se define de la siguiente manera:
-
class SortExpression(expression=None, direction=DESCENDING, default_value=None)
Ordena los resultados por la expresión de la puntuación.
Argumentos
- expression
Una expresión que se evalúa cuando se ordenan los resultados de cada documento coincidente. La expresión puede ser un nombre de campo o una expresión compuesta, como _score + count(likes) * 0.1, que agregará la puntuación de un calificador a un recuento de los valores de un campo likes ponderado por un factor de 0.1.
- direction
La dirección en la que se deben ordenar los resultados de la búsqueda, puede ser ASCENDING o DESCENDING.
- default_value
El valor predeterminado de la expresión, si no hay ningún campo presente y no puede calcularse para el documento. Debe especificarse un valor de texto para los órdenes de texto. Se debe especificar un valor numérico para tipos numéricos.
Valor del resultado
Una instancia nueva de la clase SortExpression.
Excepciones
- TypeError
Si alguno de los parámetros tiene un tipo no válido o si se pasa un atributo desconocido.
- ValueError
Si algún parámetro tiene un valor no válido.
Propiedades
Una instancia de la clase SortExpression tiene las siguientes propiedades:
- expression
Muestra la expresión usada para ordenar los resultados coincidentes.
- direction
Muestra la dirección la expresión de orden: ASCENDING o DESCENDING.
- default_value
Muestra el valor predeterminado de la expresión si no se pudo calcular ningún otro valor.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-04 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
