1
0
mirror of https://github.com/php/doc-es.git synced 2026-04-27 17:14:09 +02:00
Files
archived-doc-es/reference/mongo/mongocursor/immortal.xml
T
Pedro Antonio Gil Rodríguez 567146163c Updated to the most recent version
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@330706 c90b9560-bf6c-de11-be94-00142212c4b1
2013-06-28 16:32:20 +00:00

88 lines
2.8 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 53281c346b4bfc0691998e14b48d3aaa6e3ab6f8 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mongocursor.immortal" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>MongoCursor::immortal</refname>
<refpurpose>Establece si este cursor expirará</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>MongoCursor</type><methodname>MongoCursor::immortal</methodname>
<methodparam choice="opt"><type>bool</type><parameter>liveForever</parameter><initializer>true</initializer></methodparam>
</methodsynopsis>
<para>
Después de permanecer inactivo en el servidor por algún tiempo, los cursores, por
omisión, "mueren". Este es el compotamiento general que se desea. La base de datos
limpia un cursor una vez que todos sus resultados han sido enviados al cliente,
pero si el cliente no solicita todos los resultados, el cursor decaerá en ese
momento, tomando recursos. Por lo tanto, después de unos minutos, el cursor
"expira" y la base de datos asume que el cliente ha obtenido todo lo que necesita,
y limpia los recursos del cursor.
</para>
<para>
Si, por cualquier motivo, fuera necesario que un cursor espere durante más tiempo,
se puede evitar que la base de datos lo limpie usando este método. Sin embargo,
si se hace inmortal a un cursor, es necesario iterar a través de todos sus
resultados (o al menos hasta que <methodname>MongoCursor::dead</methodname>
devuelva &true;) o el cursor esperará a la base de datos
<emphasis>para siempre</emphasis>, tomando recursos.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term>
<parameter>liveForever</parameter>
</term>
<listitem>
<para>
Si el cursor debería ser inmortal.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve este cursor.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Lanza una <classname>MongoCursorException</classname> si este cursor ha empezado a iterar.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->