routing.html

<!doctype html>
<html dir="ltr" lang="en">

<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Rutas de Rails desde el Exterior hacia el Interior — Ruby on Rails Guides</title>
  <link rel="stylesheet" type="text/css" href="stylesheets/style-v2.css" data-turbo-track="reload">
  <link rel="stylesheet" type="text/css" href="stylesheets/print-v2.css" media="print">
  <link rel="stylesheet" type="text/css" href="stylesheets/highlight-v2.css" data-turbo-track="reload">

  <link rel="icon" href="images/favicon.ico" sizes="any">

  <link rel="apple-touch-icon" href="images/icon.png">

  <script src="javascripts/@hotwired--turbo.js" data-turbo-track="reload"></script>
  <script src="javascripts/clipboard.js" data-turbo-track="reload"></script>
  <script src="javascripts/guides.js" data-turbo-track="reload"></script>

  <meta property="og:title" content="Rutas de Rails desde el Exterior hacia el Interior — Ruby on Rails Guides" />
  <meta name="description" content="NO LEAS ESTE ARCHIVO EN GITHUB, LAS GUÍAS SE PUBLICAN EN https://guides.rubyonrails.org.Rutas de Rails desde el Exterior hacia el InteriorEsta guía cubre las características de las rutas de Rails orientadas al usuario.Después de leer esta guía, sabrás: Cómo interpretar el código en config/routes.rb. Cómo construir tus propias rutas, usando el estilo preferido de recursos o el método match. Cómo declarar parámetros de ruta, que se pasan a las acciones del controlador. Cómo crear automáticamente rutas y URLs usando los helpers de ruta. Técnicas avanzadas como crear restricciones y montar endpoints Rack." />
  <meta property="og:description" content="NO LEAS ESTE ARCHIVO EN GITHUB, LAS GUÍAS SE PUBLICAN EN https://guides.rubyonrails.org.Rutas de Rails desde el Exterior hacia el InteriorEsta guía cubre las características de las rutas de Rails orientadas al usuario.Después de leer esta guía, sabrás: Cómo interpretar el código en config/routes.rb. Cómo construir tus propias rutas, usando el estilo preferido de recursos o el método match. Cómo declarar parámetros de ruta, que se pasan a las acciones del controlador. Cómo crear automáticamente rutas y URLs usando los helpers de ruta. Técnicas avanzadas como crear restricciones y montar endpoints Rack." />
  <meta property="og:locale" content="en_US" />
  <meta property="og:site_name" content="Ruby on Rails Guides" />
  <meta property="og:image" content="https://avatars.githubusercontent.com/u/4223" />
  <meta property="og:type" content="website" />

  <link rel="preconnect" href="https://fonts.googleapis.com">
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  <link href="https://fonts.googleapis.com/css2?family=Noto+Sans+Arabic:wght@100..900&display=swap" rel="stylesheet">
  <link href="https://fonts.googleapis.com/css2?family=Heebo:wght@100..900&family=Noto+Sans+Arabic:wght@100..900&display=swap" rel="stylesheet">

  <meta name="theme-color" content="#C81418">
</head>

<body class="guide">
  <nav id="topNav" aria-label="Secondary">
    <div class="wrapper">
      <strong class="more-info-label">Más en <a href="https://rubyonrails.org/">rubyonrails.org:</a> </strong>
      <span class="red-button more-info-button">
        Más Ruby on Rails
      </span>
      <ul class="more-info-links s-hidden">
        <li class="more-info"><a href="https://rubyonrails.org/blog">Blog</a></li>
        <li class="more-info"><a href="https://guides.rubyonrails.org/">Guías</a></li>
        <li class="more-info"><a href="https://api.rubyonrails.org/">API</a></li>
        <li class="more-info"><a href="https://discuss.rubyonrails.org/">Foro</a></li>
        <li class="more-info"><a href="https://github.com/rails/rails">Contribuir en GitHub</a></li>
      </ul>
    </div>
  </nav>
  <header id="page_header">
    <div class="wrapper clearfix">
      <nav id="feature_nav">
        <div class="header-logo">
          <a href="index.html" title="Regresar a la página principal de Guías para Edge">Guías</a>
          <span id="version_switcher">
            Versión:
            <select class="guides-version">
              <option value="https://edgeguides.rubyonrails.org/" selected>Edge</option>
                <option value="https://guides.rubyonrails.org/v7.2/">7.2</option>
                <option value="https://guides.rubyonrails.org/v7.1/">7.1</option>
                <option value="https://guides.rubyonrails.org/v7.0/">7.0</option>
                <option value="https://guides.rubyonrails.org/v6.1/">6.1</option>
                <option value="https://guides.rubyonrails.org/v6.0/">6.0</option>
                <option value="https://guides.rubyonrails.org/v5.2/">5.2</option>
                <option value="https://guides.rubyonrails.org/v5.1/">5.1</option>
                <option value="https://guides.rubyonrails.org/v5.0/">5.0</option>
                <option value="https://guides.rubyonrails.org/v4.2/">4.2</option>
                <option value="https://guides.rubyonrails.org/v4.1/">4.1</option>
                <option value="https://guides.rubyonrails.org/v4.0/">4.0</option>
                <option value="https://guides.rubyonrails.org/v3.2/">3.2</option>
                <option value="https://guides.rubyonrails.org/v3.1/">3.1</option>
                <option value="https://guides.rubyonrails.org/v3.0/">3.0</option>
                <option value="https://guides.rubyonrails.org/v2.3/">2.3</option>
            </select>
          </span>
        </div>
        <ul class="nav">
          <li><a class="nav-item" id="home_nav" href="https://rubyonrails.org/">Inicio</a></li>
          <li class="guides-index guides-index-large">
            <a href="index.html" id="guidesMenu" class="guides-index-item nav-item">Índice de Guías</a>
            <div id="guides" class="clearfix" style="display: none;">
              <hr />
              <dl class="guides-section-container">
                  <div class="guides-section">
                    <dt>Comienza Aquí</dt>
                    <dd><a href="getting_started.html">Primeros Pasos con Rails</a></dd>
                  </div>
                  <div class="guides-section">
                    <dt>Modelos</dt>
                    <dd><a href="active_record_basics.html">Conceptos Básicos de Active Record</a></dd>
                    <dd><a href="active_record_migrations.html">Migraciones de Active Record</a></dd>
                    <dd><a href="active_record_validations.html">Validaciones de Active Record</a></dd>
                  </div>
                  <div class="guides-section">
                    <dt>Vistas</dt>
                    <dd><a href="action_view_overview.html">Resumen de Action View</a></dd>
                    <dd><a href="layouts_and_rendering.html">Diseños y Renderizado en Rails</a></dd>
                  </div>
                  <div class="guides-section">
                    <dt>Controladores</dt>
                    <dd><a href="action_controller_overview.html">Resumen de Action Controller</a></dd>
                    <dd><a href="routing.html">Enrutamiento en Rails desde el Exterior</a></dd>
                  </div>
                  <div class="guides-section">
                    <dt>Otros Componentes</dt>
                    <dd><a href="active_support_core_extensions.html">Extensiones Básicas de Active Support</a></dd>
                    <dd><a href="action_mailer_basics.html">Conceptos Básicos de Action Mailer</a></dd>
                    <dd><a href="action_mailbox_basics.html">Conceptos Básicos de Action Mailbox</a></dd>
                    <dd><a href="action_text_overview.html">Resumen de Action Text</a></dd>
                    <dd><a href="active_job_basics.html">Conceptos Básicos de Active Job</a></dd>
                  </div>
                  <div class="guides-section">
                    <dt>Políticas</dt>
                    <dd><a href="maintenance_policy.html">Política de Mantenimiento</a></dd>
                  </div>
                  <div class="guides-section">
                    <dt>Notas de Lanzamiento</dt>
                    <dd><a href="upgrading_ruby_on_rails.html">Actualizando Ruby on Rails</a></dd>
                    <dd><a href="7_2_release_notes.html">Versión 7.2 - ?</a></dd>
                    <dd><a href="7_1_release_notes.html">Versión 7.1 - Octubre 2023</a></dd>
                    <dd><a href="7_0_release_notes.html">Versión 7.0 - Diciembre 2021</a></dd>
                    <dd><a href="6_1_release_notes.html">Versión 6.1 - Diciembre 2020</a></dd>
                  </div>
              </dl>
            </div>
          </li>
          <li><a class="nav-item" href="contributing_to_ruby_on_rails.html">Contribuir</a></li>
          <li class="guides-index guides-index-small">
            <select class="guides-index-item nav-item">
              <option value="index.html">Índice de Guías</option>
                <optgroup label="Comienza Aquí">
                    <option value="getting_started.html">Primeros Pasos con Rails</option>
                </optgroup>
                <optgroup label="Modelos">
                    <option value="active_record_basics.html">Conceptos Básicos de Active Record</option>
                    <option value="active_record_migrations.html">Migraciones de Active Record</option>
                    <option value="active_record_validations.html">Validaciones de Active Record</option>
                </optgroup>
                <optgroup label="Vistas">
                    <option value="action_view_overview.html">Resumen de Action View</option>
                    <option value="layouts_and_rendering.html">Diseños y Renderizado en Rails</option>
                </optgroup>
                <optgroup label="Controladores">
                    <option value="action_controller_overview.html">Resumen de Action Controller</option>
                    <option value="routing.html">Enrutamiento en Rails desde el Exterior</option>
                </optgroup>
                <optgroup label="Otros Componentes">
                    <option value="active_support_core_extensions.html">Extensiones Básicas de Active Support</option>
                    <option value="action_mailer_basics.html">Conceptos Básicos de Action Mailer</option>
                    <option value="action_mailbox_basics.html">Conceptos Básicos de Action Mailbox</option>
                    <option value="action_text_overview.html">Resumen de Action Text</option>
                    <option value="active_job_basics.html">Conceptos Básicos de Active Job</option>
                </optgroup>
                <optgroup label="Políticas">
                    <option value="maintenance_policy.html">Política de Mantenimiento</option>
                </optgroup>
                <optgroup label="Notas de Lanzamiento">
                    <option value="upgrading_ruby_on_rails.html">Actualizando Ruby on Rails</option>
                    <option value="7_2_release_notes.html">Versión 7.2 - ?</option>
                    <option value="7_1_release_notes.html">Versión 7.1 - Octubre 2023</option>
                    <option value="7_0_release_notes.html">Versión 7.0 - Diciembre 2021</option>
                    <option value="6_1_release_notes.html">Versión 6.1 - Diciembre 2020</option>
                </optgroup>
            </select>
          </li>
      </ul>
      </nav>
    </div>
  </header>
  <hr class="hide" />

  <section id="feature">
    <div class="wrapper">
      <p><strong>NO LEAS ESTE ARCHIVO EN GITHUB, LAS GUÍAS SE PUBLICAN EN <a href="https://guides.rubyonrails.org">https://guides.rubyonrails.org</a>.</strong></p><h1>Rutas de Rails desde el Exterior hacia el Interior</h1><p>Esta guía cubre las características de las rutas de Rails orientadas al usuario.</p><p>Después de leer esta guía, sabrás:</p>
<ul>
<li>Cómo interpretar el código en <code>config/routes.rb</code>.</li>
<li>Cómo construir tus propias rutas, usando el estilo preferido de recursos o el método <code>match</code>.</li>
<li>Cómo declarar parámetros de ruta, que se pasan a las acciones del controlador.</li>
<li>Cómo crear automáticamente rutas y URLs usando los helpers de ruta.</li>
<li>Técnicas avanzadas como crear restricciones y montar endpoints Rack.</li>
</ul>


                <nav id="subCol">
            <h3 class="chapter">
              <picture>
                <!-- Using the `source`  HTML tag to set the dark theme image -->
                <source
                  srcset="images/icon_book-close-bookmark-1-wht.svg"
                  media="(prefers-color-scheme: dark)"
                />
                <img src="images/icon_book-close-bookmark-1.svg" alt="Chapter Icon" />
              </picture>
              Chapters
            </h3>
            <ol class="chapters">
<li><a href="#el-propósito-del-router-de-rails">El Propósito del Router de Rails</a>

<ul>
<li><a href="#conectando-urls-al-código">Conectando URLs al Código</a></li>
<li><a href="#generando-rutas-y-urls-desde-el-código">Generando Rutas y URLs desde el Código</a></li>
<li><a href="#configurando-el-router-de-rails">Configurando el Router de Rails</a></li>
</ul></li>
<li><a href="#rutas-de-recursos-el-predeterminado-de-rails">Rutas de Recursos: el Predeterminado de Rails</a>

<ul>
<li><a href="#recursos-en-la-web">Recursos en la Web</a></li>
<li><a href="#crud-verbos-y-acciones">CRUD, Verbos y Acciones</a></li>
<li><a href="#helpers-de-ruta-y-url">Helpers de Ruta y URL</a></li>
<li><a href="#definiendo-múltiples-recursos-al-mismo-tiempo">Definiendo Múltiples Recursos al Mismo Tiempo</a></li>
<li><a href="#recursos-singulares">Recursos Singulares</a></li>
<li><a href="#nombres-de-controladores-y-rutas">Nombres de Controladores y Rutas</a></li>
<li><a href="#recursos-anidados">Recursos Anidados</a></li>
<li><a href="#preocupaciones-de-enrutamiento">Preocupaciones de Enrutamiento</a></li>
<li><a href="#creando-rutas-y-urls-desde-objetos">Creando Rutas y URLs desde Objetos</a></li>
<li><a href="#agregando-más-acciones-restful">Agregando Más Acciones RESTful</a></li>
</ul></li>
<li><a href="#rutas-no-resursivas">Rutas No-Resursivas</a>

<ul>
<li><a href="#parámetros-vinculados">Parámetros Vinculados</a></li>
<li><a href="#segmentos-dinámicos">Segmentos Dinámicos</a></li>
<li><a href="#segmentos-estáticos">Segmentos Estáticos</a></li>
<li><a href="#la-cadena-de-consulta">La Cadena de Consulta</a></li>
<li><a href="#definiendo-valores-predeterminados">Definiendo Valores Predeterminados</a></li>
<li><a href="#nombrando-rutas">Nombrando Rutas</a></li>
<li><a href="#restricciones-de-verbos-http">Restricciones de Verbos HTTP</a></li>
<li><a href="#restricciones-de-segmentos">Restricciones de Segmentos</a></li>
<li><a href="#restricciones-basadas-en-solicitudes">Restricciones Basadas en Solicitudes</a></li>
<li><a href="#restricciones-avanzadas">Restricciones Avanzadas</a></li>
<li><a href="#globbing-de-rutas-y-segmentos-comodín">Globbing de Rutas y Segmentos Comodín</a></li>
<li><a href="#redirección">Redirección</a></li>
<li><a href="#enrutando-a-aplicaciones-rack">Enrutando a Aplicaciones Rack</a></li>
<li><a href="#usando-root">Usando <code>root</code></a></li>
<li><a href="#rutas-de-caracteres-unicode">Rutas de Caracteres Unicode</a></li>
<li><a href="#rutas-directas">Rutas Directas</a></li>
<li><a href="#usando-resolve">Usando <code>resolve</code></a></li>
</ul></li>
<li><a href="#personalizando-rutas-de-recursos">Personalizando Rutas de Recursos</a>

<ul>
<li><a href="#especificando-un-controlador-a-usar">Especificando un Controlador a Usar</a></li>
<li><a href="#especificando-restricciones">Especificando Restricciones</a></li>
<li><a href="#anulando-los-helpers-de-ruta-nombrada">Anulando los Helpers de Ruta Nombrada</a></li>
<li><a href="#anulando-los-segmentos-new-y-edit">Anulando los Segmentos <code>new</code> y <code>edit</code></a></li>
<li><a href="#prefijando-los-helpers-de-ruta-nombrada">Prefijando los Helpers de Ruta Nombrada</a></li>
<li><a href="#restringiendo-las-rutas-creadas">Restringiendo las Rutas Creadas</a></li>
<li><a href="#rutas-traducidas">Rutas Traducidas</a></li>
<li><a href="#anulando-la-forma-singular">Anulando la Forma Singular</a></li>
<li><a href="#usando-as-en-recursos-anidados">Usando <code>:as</code> en Recursos Anidados</a></li>
<li><a href="#anulando-parámetros-de-ruta-nombrados">Anulando Parámetros de Ruta Nombrados</a></li>
</ul></li>
<li><a href="#dividiendo-un-archivo-de-rutas-muy-grande-en-múltiples-archivos-pequeños">Dividiendo un Archivo de Rutas <em>Muy</em> Grande en Múltiples Archivos Pequeños</a>

<ul>
<li><a href="#no-uses-esta-función-a-menos-que-realmente-la-necesites">No Uses Esta Función a Menos que Realmente la Necesites</a></li>
</ul></li>
<li><a href="#inspeccionando-y-probando-rutas">Inspeccionando y Probando Rutas</a>

<ul>
<li><a href="#listando-rutas-existentes">Listando Rutas Existentes</a></li>
<li><a href="#probando-rutas">Probando Rutas</a></li>
</ul></li>
</ol>

          </nav>


      <hr>
    </div>
  </section>

  <main id="container">
    <div class="wrapper">
      <div id="mainCol">
        <h2 id="el-propósito-del-router-de-rails"><a class="anchorlink" href="#el-propósito-del-router-de-rails"><span>1</span> El Propósito del Router de Rails</a></h2><p>El router de Rails reconoce URLs y las envía a la acción de un controlador, o a una aplicación Rack. También puede generar rutas y URLs, evitando la necesidad de codificar cadenas en tus vistas.</p><h3 id="conectando-urls-al-código"><a class="anchorlink" href="#conectando-urls-al-código"><span>1.1</span> Conectando URLs al Código</a></h3><p>Cuando tu aplicación Rails recibe una solicitud entrante para:</p><div class="interstitial code">
<pre><code class="highlight plaintext">GET /patients/17
</code></pre>
<button class="clipboard-button" data-clipboard-text="GET /patients/17
">Copy</button>
</div>
<p>le pide al router que la empareje con una acción del controlador. Si la primera ruta coincidente es:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'/patients/:id'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'patients#show'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get '/patients/:id', to: 'patients#show'
">Copy</button>
</div>
<p>la solicitud se envía a la acción <code>show</code> del controlador <code>patients</code> con <code>{ id: '17' }</code> en <code>params</code>.</p><p>NOTA: Rails usa snake_case para los nombres de los controladores aquí, si tienes un controlador de varias palabras como <code>MonsterTrucksController</code>, querrás usar <code>monster_trucks#show</code> por ejemplo.</p><h3 id="generando-rutas-y-urls-desde-el-código"><a class="anchorlink" href="#generando-rutas-y-urls-desde-el-código"><span>1.2</span> Generando Rutas y URLs desde el Código</a></h3><p>También puedes generar rutas y URLs. Si la ruta anterior se modifica para ser:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'/patients/:id'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'patients#show'</span><span class="p">,</span> <span class="ss">as: </span><span class="s1">'patient'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get '/patients/:id', to: 'patients#show', as: 'patient'
">Copy</button>
</div>
<p>y tu aplicación contiene este código en el controlador:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="vi">@patient</span> <span class="o">=</span> <span class="no">Patient</span><span class="p">.</span><span class="nf">find</span><span class="p">(</span><span class="n">params</span><span class="p">[</span><span class="ss">:id</span><span class="p">])</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="@patient = Patient.find(params[:id])
">Copy</button>
</div>
<p>y esto en la vista correspondiente:</p><div class="interstitial code">
<pre><code class="highlight erb"><span class="cp">&lt;%=</span> <span class="n">link_to</span> <span class="s1">'Patient Record'</span><span class="p">,</span> <span class="n">patient_path</span><span class="p">(</span><span class="vi">@patient</span><span class="p">)</span> <span class="cp">%&gt;</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="<%= link_to 'Patient Record', patient_path(@patient) %>
">Copy</button>
</div>
<p>entonces el router generará la ruta <code>/patients/17</code>. Esto reduce la fragilidad de tu vista y hace que tu código sea más fácil de entender. Ten en cuenta que el id no necesita ser especificado en el helper de la ruta.</p><h3 id="configurando-el-router-de-rails"><a class="anchorlink" href="#configurando-el-router-de-rails"><span>1.3</span> Configurando el Router de Rails</a></h3><p>Las rutas para tu aplicación o motor viven en el archivo <code>config/routes.rb</code> y típicamente se ven así:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="no">Rails</span><span class="p">.</span><span class="nf">application</span><span class="p">.</span><span class="nf">routes</span><span class="p">.</span><span class="nf">draw</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:brands</span><span class="p">,</span> <span class="ss">only: </span><span class="p">[</span><span class="ss">:index</span><span class="p">,</span> <span class="ss">:show</span><span class="p">]</span> <span class="k">do</span>
    <span class="n">resources</span> <span class="ss">:products</span><span class="p">,</span> <span class="ss">only: </span><span class="p">[</span><span class="ss">:index</span><span class="p">,</span> <span class="ss">:show</span><span class="p">]</span>
  <span class="k">end</span>

  <span class="n">resource</span> <span class="ss">:basket</span><span class="p">,</span> <span class="ss">only: </span><span class="p">[</span><span class="ss">:show</span><span class="p">,</span> <span class="ss">:update</span><span class="p">,</span> <span class="ss">:destroy</span><span class="p">]</span>

  <span class="n">resolve</span><span class="p">(</span><span class="s2">"Basket"</span><span class="p">)</span> <span class="p">{</span> <span class="n">route_for</span><span class="p">(</span><span class="ss">:basket</span><span class="p">)</span> <span class="p">}</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="Rails.application.routes.draw do
  resources :brands, only: [:index, :show] do
    resources :products, only: [:index, :show]
  end

  resource :basket, only: [:show, :update, :destroy]

  resolve(&quot;Basket&quot;) { route_for(:basket) }
end
">Copy</button>
</div>
<p>Dado que este es un archivo fuente Ruby regular, puedes usar todas sus características para ayudarte a definir tus rutas, pero ten cuidado con los nombres de las variables ya que pueden chocar con los métodos DSL del router.</p><p>NOTA: El bloque <code>Rails.application.routes.draw do ... end</code> que envuelve tus definiciones de ruta es necesario para establecer el alcance del DSL del router y no debe ser eliminado.</p><h2 id="rutas-de-recursos-el-predeterminado-de-rails"><a class="anchorlink" href="#rutas-de-recursos-el-predeterminado-de-rails"><span>2</span> Rutas de Recursos: el Predeterminado de Rails</a></h2><p>Las rutas de recursos te permiten declarar rápidamente todas las rutas comunes para un controlador de recursos dado. Una sola llamada a <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Resources.html#method-i-resources"><code>resources</code></a> puede declarar todas las rutas necesarias para tus acciones <code>index</code>, <code>show</code>, <code>new</code>, <code>edit</code>, <code>create</code>, <code>update</code> y <code>destroy</code>.</p><h3 id="recursos-en-la-web"><a class="anchorlink" href="#recursos-en-la-web"><span>2.1</span> Recursos en la Web</a></h3><p>Los navegadores solicitan páginas de Rails haciendo una solicitud para una URL usando un método HTTP específico, como <code>GET</code>, <code>POST</code>, <code>PATCH</code>, <code>PUT</code> y <code>DELETE</code>. Cada método es una solicitud para realizar una operación en el recurso. Una ruta de recurso mapea una serie de solicitudes relacionadas a acciones en un solo controlador.</p><p>Cuando tu aplicación Rails recibe una solicitud entrante para:</p><div class="interstitial code">
<pre><code class="highlight plaintext">DELETE /photos/17
</code></pre>
<button class="clipboard-button" data-clipboard-text="DELETE /photos/17
">Copy</button>
</div>
<p>le pide al router que la mapee a una acción del controlador. Si la primera ruta coincidente es:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos
">Copy</button>
</div>
<p>Rails enviaría esa solicitud a la acción <code>destroy</code> en el controlador <code>photos</code> con <code>{ id: '17' }</code> en <code>params</code>.</p><h3 id="crud-verbos-y-acciones"><a class="anchorlink" href="#crud-verbos-y-acciones"><span>2.2</span> CRUD, Verbos y Acciones</a></h3><p>En Rails, una ruta de recurso proporciona un mapeo entre verbos HTTP y URLs a acciones del controlador. Por convención, cada acción también se mapea a una operación CRUD específica en una base de datos. Una sola entrada en el archivo de rutas, como:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos
">Copy</button>
</div>
<p>crea siete rutas diferentes en tu aplicación, todas mapeando al controlador <code>Photos</code>:</p>
<table><thead>
<tr>
<th>Verbo HTTP</th>
<th>Ruta</th>
<th>Controlador#Acción</th>
<th>Usado para</th>
</tr>
</thead><tbody>
<tr>
<td>GET</td>
<td>/photos</td>
<td>photos#index</td>
<td>mostrar una lista de todas las fotos</td>
</tr>
<tr>
<td>GET</td>
<td>/photos/new</td>
<td>photos#new</td>
<td>devolver un formulario HTML para crear una nueva foto</td>
</tr>
<tr>
<td>POST</td>
<td>/photos</td>
<td>photos#create</td>
<td>crear una nueva foto</td>
</tr>
<tr>
<td>GET</td>
<td>/photos/:id</td>
<td>photos#show</td>
<td>mostrar una foto específica</td>
</tr>
<tr>
<td>GET</td>
<td>/photos/:id/edit</td>
<td>photos#edit</td>
<td>devolver un formulario HTML para editar una foto</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/photos/:id</td>
<td>photos#update</td>
<td>actualizar una foto específica</td>
</tr>
<tr>
<td>DELETE</td>
<td>/photos/:id</td>
<td>photos#destroy</td>
<td>eliminar una foto específica</td>
</tr>
</tbody></table>
<p>NOTA: Debido a que el router usa el verbo HTTP y la URL para emparejar solicitudes entrantes, cuatro URLs se mapean a siete acciones diferentes.</p><p>NOTA: Las rutas de Rails se emparejan en el orden en que se especifican, por lo que si tienes un <code>resources :photos</code> encima de un <code>get 'photos/poll'</code>, la ruta de la acción <code>show</code> para la línea <code>resources</code> se emparejará antes que la línea <code>get</code>. Para solucionar esto, mueve la línea <code>get</code> <strong>encima</strong> de la línea <code>resources</code> para que se empareje primero.</p><h3 id="helpers-de-ruta-y-url"><a class="anchorlink" href="#helpers-de-ruta-y-url"><span>2.3</span> Helpers de Ruta y URL</a></h3><p>Crear una ruta de recurso también expondrá una serie de helpers a los controladores en tu aplicación. En el caso de <code>resources :photos</code>:</p>
<ul>
<li><code>photos_path</code> devuelve <code>/photos</code></li>
<li><code>new_photo_path</code> devuelve <code>/photos/new</code></li>
<li><code>edit_photo_path(:id)</code> devuelve <code>/photos/:id/edit</code> (por ejemplo, <code>edit_photo_path(10)</code> devuelve <code>/photos/10/edit</code>)</li>
<li><code>photo_path(:id)</code> devuelve <code>/photos/:id</code> (por ejemplo, <code>photo_path(10)</code> devuelve <code>/photos/10</code>)</li>
</ul>
<p>Cada uno de estos helpers tiene un helper <code>_url</code> correspondiente (como <code>photos_url</code>) que devuelve la misma ruta con el prefijo del host, puerto y prefijo de ruta actuales.</p><p>CONSEJO: Para encontrar los nombres de los helpers de ruta para tus rutas, consulta <a href="#listado-de-rutas-existentes">Listado de rutas existentes</a> a continuación.</p><h3 id="definiendo-múltiples-recursos-al-mismo-tiempo"><a class="anchorlink" href="#definiendo-múltiples-recursos-al-mismo-tiempo"><span>2.4</span> Definiendo Múltiples Recursos al Mismo Tiempo</a></h3><p>Si necesitas crear rutas para más de un recurso, puedes ahorrar un poco de escritura definiéndolos todos con una sola llamada a <code>resources</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span><span class="p">,</span> <span class="ss">:books</span><span class="p">,</span> <span class="ss">:videos</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos, :books, :videos
">Copy</button>
</div>
<p>Esto funciona exactamente igual que:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span>
<span class="n">resources</span> <span class="ss">:books</span>
<span class="n">resources</span> <span class="ss">:videos</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos
resources :books
resources :videos
">Copy</button>
</div>
<h3 id="recursos-singulares"><a class="anchorlink" href="#recursos-singulares"><span>2.5</span> Recursos Singulares</a></h3><p>A veces, tienes un recurso que los clientes siempre buscan sin hacer referencia a un ID. Por ejemplo, te gustaría que <code>/profile</code> siempre muestre el perfil del usuario actualmente conectado. En este caso, puedes usar un recurso singular para mapear <code>/profile</code> (en lugar de <code>/profile/:id</code>) a la acción <code>show</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'profile'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'users#show'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'profile', to: 'users#show'
">Copy</button>
</div>
<p>Pasar una <code>String</code> a <code>to:</code> esperará un formato <code>controller#action</code>. Al usar un <code>Symbol</code>, la opción <code>to:</code> debe ser reemplazada con <code>action:</code>. Al usar una <code>String</code> sin un <code>#</code>, la opción <code>to:</code> debe ser reemplazada con <code>controller:</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'profile'</span><span class="p">,</span> <span class="ss">action: :show</span><span class="p">,</span> <span class="ss">controller: </span><span class="s1">'users'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'profile', action: :show, controller: 'users'
">Copy</button>
</div>
<p>Esta ruta de recurso:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resource</span> <span class="ss">:geocoder</span>
<span class="n">resolve</span><span class="p">(</span><span class="s1">'Geocoder'</span><span class="p">)</span> <span class="p">{</span> <span class="p">[</span><span class="ss">:geocoder</span><span class="p">]</span> <span class="p">}</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resource :geocoder
resolve('Geocoder') { [:geocoder] }
">Copy</button>
</div>
<p>crea seis rutas diferentes en tu aplicación, todas mapeando al controlador <code>Geocoders</code>:</p>
<table><thead>
<tr>
<th>Verbo HTTP</th>
<th>Ruta</th>
<th>Controlador#Acción</th>
<th>Usado para</th>
</tr>
</thead><tbody>
<tr>
<td>GET</td>
<td>/geocoder/new</td>
<td>geocoders#new</td>
<td>devolver un formulario HTML para crear el geocoder</td>
</tr>
<tr>
<td>POST</td>
<td>/geocoder</td>
<td>geocoders#create</td>
<td>crear el nuevo geocoder</td>
</tr>
<tr>
<td>GET</td>
<td>/geocoder</td>
<td>geocoders#show</td>
<td>mostrar el único recurso geocoder</td>
</tr>
<tr>
<td>GET</td>
<td>/geocoder/edit</td>
<td>geocoders#edit</td>
<td>devolver un formulario HTML para editar el geocoder</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/geocoder</td>
<td>geocoders#update</td>
<td>actualizar el único recurso geocoder</td>
</tr>
<tr>
<td>DELETE</td>
<td>/geocoder</td>
<td>geocoders#destroy</td>
<td>eliminar el recurso geocoder</td>
</tr>
</tbody></table>
<p>NOTA: Debido a que podrías querer usar el mismo controlador para una ruta singular (<code>/account</code>) y una ruta plural (<code>/accounts/45</code>), los recursos singulares se mapean a controladores plurales. Así que, por ejemplo, <code>resource :photo</code> y <code>resources :photos</code> crean tanto rutas singulares como plurales que se mapean al mismo controlador (<code>PhotosController</code>).</p><p>Una ruta de recurso singular genera estos helpers:</p>
<ul>
<li><code>new_geocoder_path</code> devuelve <code>/geocoder/new</code></li>
<li><code>edit_geocoder_path</code> devuelve <code>/geocoder/edit</code></li>
<li><code>geocoder_path</code> devuelve <code>/geocoder</code></li>
</ul>
<p>NOTA: La llamada a <code>resolve</code> es necesaria para convertir instancias del <code>Geocoder</code> a rutas a través de <a href="form_helpers.html#relying-on-record-identification">identificación de registro</a>.</p><p>Al igual que con los recursos plurales, los mismos helpers que terminan en <code>_url</code> también incluirán el host, puerto y prefijo de ruta.</p><h3 id="nombres-de-controladores-y-rutas"><a class="anchorlink" href="#nombres-de-controladores-y-rutas"><span>2.6</span> Nombres de Controladores y Rutas</a></h3><p>Es posible que desees organizar grupos de controladores bajo un namespace. Más comúnmente, podrías agrupar varios controladores administrativos bajo un namespace <code>Admin::</code>, y colocar estos controladores bajo el directorio <code>app/controllers/admin</code>. Puedes enrutar a tal grupo usando un bloque <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Scoping.html#method-i-namespace"><code>namespace</code></a>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">namespace</span> <span class="ss">:admin</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:articles</span><span class="p">,</span> <span class="ss">:comments</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="namespace :admin do
  resources :articles, :comments
end
">Copy</button>
</div>
<p>Esto creará una serie de rutas para cada uno de los controladores <code>articles</code> y <code>comments</code>. Para <code>Admin::ArticlesController</code>, Rails creará:</p>
<table><thead>
<tr>
<th>Verbo HTTP</th>
<th>Ruta</th>
<th>Controlador#Acción</th>
<th>Helper de Ruta Nombrada</th>
</tr>
</thead><tbody>
<tr>
<td>GET</td>
<td>/admin/articles</td>
<td>admin/articles#index</td>
<td>admin_articles_path</td>
</tr>
<tr>
<td>GET</td>
<td>/admin/articles/new</td>
<td>admin/articles#new</td>
<td>new_admin_article_path</td>
</tr>
<tr>
<td>POST</td>
<td>/admin/articles</td>
<td>admin/articles#create</td>
<td>admin_articles_path</td>
</tr>
<tr>
<td>GET</td>
<td>/admin/articles/:id</td>
<td>admin/articles#show</td>
<td>admin_article_path(:id)</td>
</tr>
<tr>
<td>GET</td>
<td>/admin/articles/:id/edit</td>
<td>admin/articles#edit</td>
<td>edit_admin_article_path(:id)</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/admin/articles/:id</td>
<td>admin/articles#update</td>
<td>admin_article_path(:id)</td>
</tr>
<tr>
<td>DELETE</td>
<td>/admin/articles/:id</td>
<td>admin/articles#destroy</td>
<td>admin_article_path(:id)</td>
</tr>
</tbody></table>
<p>Si en cambio quieres enrutar <code>/articles</code> (sin el prefijo <code>/admin</code>) a <code>Admin::ArticlesController</code>, puedes especificar el módulo con un bloque <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Scoping.html#method-i-scope"><code>scope</code></a>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">scope</span> <span class="ss">module: </span><span class="s1">'admin'</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:articles</span><span class="p">,</span> <span class="ss">:comments</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="scope module: 'admin' do
  resources :articles, :comments
end
">Copy</button>
</div>
<p>Esto también se puede hacer para una sola ruta:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:articles</span><span class="p">,</span> <span class="ss">module: </span><span class="s1">'admin'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :articles, module: 'admin'
">Copy</button>
</div>
<p>Si en cambio quieres enrutar <code>/admin/articles</code> a <code>ArticlesController</code> (sin el prefijo de módulo <code>Admin::</code>), puedes especificar la ruta con un bloque <code>scope</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">scope</span> <span class="s1">'/admin'</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:articles</span><span class="p">,</span> <span class="ss">:comments</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="scope '/admin' do
  resources :articles, :comments
end
">Copy</button>
</div>
<p>Esto también se puede hacer para una sola ruta:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:articles</span><span class="p">,</span> <span class="ss">path: </span><span class="s1">'/admin/articles'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :articles, path: '/admin/articles'
">Copy</button>
</div>
<p>En ambos casos, los helpers de ruta nombrados permanecen iguales como si no hubieras usado <code>scope</code>. En el último caso, las siguientes rutas se mapean a <code>ArticlesController</code>:</p>
<table><thead>
<tr>
<th>Verbo HTTP</th>
<th>Ruta</th>
<th>Controlador#Acción</th>
<th>Helper de Ruta Nombrada</th>
</tr>
</thead><tbody>
<tr>
<td>GET</td>
<td>/admin/articles</td>
<td>articles#index</td>
<td>articles_path</td>
</tr>
<tr>
<td>GET</td>
<td>/admin/articles/new</td>
<td>articles#new</td>
<td>new_article_path</td>
</tr>
<tr>
<td>POST</td>
<td>/admin/articles</td>
<td>articles#create</td>
<td>articles_path</td>
</tr>
<tr>
<td>GET</td>
<td>/admin/articles/:id</td>
<td>articles#show</td>
<td>article_path(:id)</td>
</tr>
<tr>
<td>GET</td>
<td>/admin/articles/:id/edit</td>
<td>articles#edit</td>
<td>edit_article_path(:id)</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/admin/articles/:id</td>
<td>articles#update</td>
<td>article_path(:id)</td>
</tr>
<tr>
<td>DELETE</td>
<td>/admin/articles/:id</td>
<td>articles#destroy</td>
<td>article_path(:id)</td>
</tr>
</tbody></table>
<p>CONSEJO: Si necesitas usar un namespace de controlador diferente dentro de un bloque <code>namespace</code>, puedes especificar una ruta de controlador absoluta, por ejemplo: <code>get '/foo', to: '/foo#index'</code>.</p><h3 id="recursos-anidados"><a class="anchorlink" href="#recursos-anidados"><span>2.7</span> Recursos Anidados</a></h3><p>Es común tener recursos que son lógicamente hijos de otros recursos. Por ejemplo, supongamos que tu aplicación incluye estos modelos:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="k">class</span> <span class="nc">Magazine</span> <span class="o">&lt;</span> <span class="no">ApplicationRecord</span>
  <span class="n">has_many</span> <span class="ss">:ads</span>
<span class="k">end</span>

<span class="k">class</span> <span class="nc">Ad</span> <span class="o">&lt;</span> <span class="no">ApplicationRecord</span>
  <span class="n">belongs_to</span> <span class="ss">:magazine</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="class Magazine < ApplicationRecord
  has_many :ads
end

class Ad < ApplicationRecord
  belongs_to :magazine
end
">Copy</button>
</div>
<p>Las rutas anidadas te permiten capturar esta relación en tu enrutamiento. En este caso, podrías incluir esta declaración de ruta:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:magazines</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:ads</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :magazines do
  resources :ads
end
">Copy</button>
</div>
<p>Además de las rutas para revistas, esta declaración también enviará anuncios a un <code>AdsController</code>. Las URLs de anuncios requieren una revista:</p>
<table><thead>
<tr>
<th>Verbo HTTP</th>
<th>Ruta</th>
<th>Controlador#Acción</th>
<th>Usado para</th>
</tr>
</thead><tbody>
<tr>
<td>GET</td>
<td>/magazines/:magazine_id/ads</td>
<td>ads#index</td>
<td>mostrar una lista de todos los anuncios para una revista específica</td>
</tr>
<tr>
<td>GET</td>
<td>/magazines/:magazine_id/ads/new</td>
<td>ads#new</td>
<td>devolver un formulario HTML para crear un nuevo anuncio para una revista específica</td>
</tr>
<tr>
<td>POST</td>
<td>/magazines/:magazine_id/ads</td>
<td>ads#create</td>
<td>crear un nuevo anuncio para una revista específica</td>
</tr>
<tr>
<td>GET</td>
<td>/magazines/:magazine_id/ads/:id</td>
<td>ads#show</td>
<td>mostrar un anuncio específico para una revista específica</td>
</tr>
<tr>
<td>GET</td>
<td>/magazines/:magazine_id/ads/:id/edit</td>
<td>ads#edit</td>
<td>devolver un formulario HTML para editar un anuncio para una revista específica</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/magazines/:magazine_id/ads/:id</td>
<td>ads#update</td>
<td>actualizar un anuncio específico para una revista específica</td>
</tr>
<tr>
<td>DELETE</td>
<td>/magazines/:magazine_id/ads/:id</td>
<td>ads#destroy</td>
<td>eliminar un anuncio específico para una revista específica</td>
</tr>
</tbody></table>
<p>Esto también creará helpers de ruta como <code>magazine_ads_url</code> y <code>edit_magazine_ad_path</code>. Estos helpers toman una instancia de Magazine como el primer parámetro (<code>magazine_ads_url(@magazine)</code>).</p><h4 id="límites-de-anidación"><a class="anchorlink" href="#límites-de-anidación"><span>2.7.1</span> Límites de Anidación</a></h4><p>Puedes anidar recursos dentro de otros recursos anidados si lo deseas. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:publishers</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:magazines</span> <span class="k">do</span>
    <span class="n">resources</span> <span class="ss">:photos</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :publishers do
  resources :magazines do
    resources :photos
  end
end
">Copy</button>
</div>
<p>Los recursos anidados profundamente rápidamente se vuelven engorrosos. En este caso, por ejemplo, la aplicación reconocería rutas como:</p><div class="interstitial code">
<pre><code class="highlight plaintext">/publishers/1/magazines/2/photos/3
</code></pre>
<button class="clipboard-button" data-clipboard-text="/publishers/1/magazines/2/photos/3
">Copy</button>
</div>
<p>El helper de ruta correspondiente sería <code>publisher_magazine_photo_url</code>, requiriendo que especifiques objetos en los tres niveles. De hecho, esta situación es lo suficientemente confusa como para que un <a href="http://weblog.jamisbuck.org/2007/2/5/nesting-resources">artículo popular de Jamis Buck</a> proponga una regla empírica para un buen diseño en Rails:</p><p>CONSEJO: Los recursos nunca deben anidarse más de 1 nivel de profundidad.</p><h4 id="anidación-superficial"><a class="anchorlink" href="#anidación-superficial"><span>2.7.2</span> Anidación Superficial</a></h4><p>Una forma de evitar la anidación profunda (como se recomienda arriba) es generar las acciones de colección bajo el ámbito del padre, para obtener una idea de la jerarquía, pero no anidar las acciones de miembro. En otras palabras, construir rutas solo con la cantidad mínima de información para identificar de manera única el recurso, así:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:articles</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:comments</span><span class="p">,</span> <span class="ss">only: </span><span class="p">[</span><span class="ss">:index</span><span class="p">,</span> <span class="ss">:new</span><span class="p">,</span> <span class="ss">:create</span><span class="p">]</span>
<span class="k">end</span>
<span class="n">resources</span> <span class="ss">:comments</span><span class="p">,</span> <span class="ss">only: </span><span class="p">[</span><span class="ss">:show</span><span class="p">,</span> <span class="ss">:edit</span><span class="p">,</span> <span class="ss">:update</span><span class="p">,</span> <span class="ss">:destroy</span><span class="p">]</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :articles do
  resources :comments, only: [:index, :new, :create]
end
resources :comments, only: [:show, :edit, :update, :destroy]
">Copy</button>
</div>
<p>Esta idea encuentra un equilibrio entre rutas descriptivas y anidación profunda. Existe una sintaxis abreviada para lograr precisamente eso, a través de la opción <code>:shallow</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:articles</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:comments</span><span class="p">,</span> <span class="ss">shallow: </span><span class="kp">true</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :articles do
  resources :comments, shallow: true
end
">Copy</button>
</div>
<p>Esto generará exactamente las mismas rutas que el primer ejemplo. También puedes especificar la opción <code>:shallow</code> en el recurso padre, en cuyo caso todos los recursos anidados serán superficiales:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:articles</span><span class="p">,</span> <span class="ss">shallow: </span><span class="kp">true</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:comments</span>
  <span class="n">resources</span> <span class="ss">:quotes</span>
  <span class="n">resources</span> <span class="ss">:drafts</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :articles, shallow: true do
  resources :comments
  resources :quotes
  resources :drafts
end
">Copy</button>
</div>
<p>El recurso articles aquí tendrá las siguientes rutas generadas para él:</p>
<table><thead>
<tr>
<th>Verbo HTTP</th>
<th>Ruta</th>
<th>Controlador#Acción</th>
<th>Helper de Ruta Nombrada</th>
</tr>
</thead><tbody>
<tr>
<td>GET</td>
<td>/articles/:article_id/comments(.:format)</td>
<td>comments#index</td>
<td>article_comments_path</td>
</tr>
<tr>
<td>POST</td>
<td>/articles/:article_id/comments(.:format)</td>
<td>comments#create</td>
<td>article_comments_path</td>
</tr>
<tr>
<td>GET</td>
<td>/articles/:article_id/comments/new(.:format)</td>
<td>comments#new</td>
<td>new_article_comment_path</td>
</tr>
<tr>
<td>GET</td>
<td>/comments/:id/edit(.:format)</td>
<td>comments#edit</td>
<td>edit_comment_path</td>
</tr>
<tr>
<td>GET</td>
<td>/comments/:id(.:format)</td>
<td>comments#show</td>
<td>comment_path</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/comments/:id(.:format)</td>
<td>comments#update</td>
<td>comment_path</td>
</tr>
<tr>
<td>DELETE</td>
<td>/comments/:id(.:format)</td>
<td>comments#destroy</td>
<td>comment_path</td>
</tr>
<tr>
<td>GET</td>
<td>/articles/:article_id/quotes(.:format)</td>
<td>quotes#index</td>
<td>article_quotes_path</td>
</tr>
<tr>
<td>POST</td>
<td>/articles/:article_id/quotes(.:format)</td>
<td>quotes#create</td>
<td>article_quotes_path</td>
</tr>
<tr>
<td>GET</td>
<td>/articles/:article_id/quotes/new(.:format)</td>
<td>quotes#new</td>
<td>new_article_quote_path</td>
</tr>
<tr>
<td>GET</td>
<td>/quotes/:id/edit(.:format)</td>
<td>quotes#edit</td>
<td>edit_quote_path</td>
</tr>
<tr>
<td>GET</td>
<td>/quotes/:id(.:format)</td>
<td>quotes#show</td>
<td>quote_path</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/quotes/:id(.:format)</td>
<td>quotes#update</td>
<td>quote_path</td>
</tr>
<tr>
<td>DELETE</td>
<td>/quotes/:id(.:format)</td>
<td>quotes#destroy</td>
<td>quote_path</td>
</tr>
<tr>
<td>GET</td>
<td>/articles/:article_id/drafts(.:format)</td>
<td>drafts#index</td>
<td>article_drafts_path</td>
</tr>
<tr>
<td>POST</td>
<td>/articles/:article_id/drafts(.:format)</td>
<td>drafts#create</td>
<td>article_drafts_path</td>
</tr>
<tr>
<td>GET</td>
<td>/articles/:article_id/drafts/new(.:format)</td>
<td>drafts#new</td>
<td>new_article_draft_path</td>
</tr>
<tr>
<td>GET</td>
<td>/drafts/:id/edit(.:format)</td>
<td>drafts#edit</td>
<td>edit_draft_path</td>
</tr>
<tr>
<td>GET</td>
<td>/drafts/:id(.:format)</td>
<td>drafts#show</td>
<td>draft_path</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/drafts/:id(.:format)</td>
<td>drafts#update</td>
<td>draft_path</td>
</tr>
<tr>
<td>DELETE</td>
<td>/drafts/:id(.:format)</td>
<td>drafts#destroy</td>
<td>draft_path</td>
</tr>
<tr>
<td>GET</td>
<td>/articles(.:format)</td>
<td>articles#index</td>
<td>articles_path</td>
</tr>
<tr>
<td>POST</td>
<td>/articles(.:format)</td>
<td>articles#create</td>
<td>articles_path</td>
</tr>
<tr>
<td>GET</td>
<td>/articles/new(.:format)</td>
<td>articles#new</td>
<td>new_article_path</td>
</tr>
<tr>
<td>GET</td>
<td>/articles/:id/edit(.:format)</td>
<td>articles#edit</td>
<td>edit_article_path</td>
</tr>
<tr>
<td>GET</td>
<td>/articles/:id(.:format)</td>
<td>articles#show</td>
<td>article_path</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/articles/:id(.:format)</td>
<td>articles#update</td>
<td>article_path</td>
</tr>
<tr>
<td>DELETE</td>
<td>/articles/:id(.:format)</td>
<td>articles#destroy</td>
<td>article_path</td>
</tr>
</tbody></table>
<p>El método <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Resources.html#method-i-shallow"><code>shallow</code></a> del DSL crea un ámbito dentro del cual cada anidación es superficial. Esto genera las mismas rutas que el ejemplo anterior:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">shallow</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:articles</span> <span class="k">do</span>
    <span class="n">resources</span> <span class="ss">:comments</span>
    <span class="n">resources</span> <span class="ss">:quotes</span>
    <span class="n">resources</span> <span class="ss">:drafts</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="shallow do
  resources :articles do
    resources :comments
    resources :quotes
    resources :drafts
  end
end
">Copy</button>
</div>
<p>Existen dos opciones para <code>scope</code> para personalizar las rutas superficiales. <code>:shallow_path</code> prefija las rutas de miembro con el parámetro especificado:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">scope</span> <span class="ss">shallow_path: </span><span class="s2">"sekret"</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:articles</span> <span class="k">do</span>
    <span class="n">resources</span> <span class="ss">:comments</span><span class="p">,</span> <span class="ss">shallow: </span><span class="kp">true</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="scope shallow_path: &quot;sekret&quot; do
  resources :articles do
    resources :comments, shallow: true
  end
end
">Copy</button>
</div>
<p>El recurso comments aquí tendrá las siguientes rutas generadas para él:</p>
<table><thead>
<tr>
<th>Verbo HTTP</th>
<th>Ruta</th>
<th>Controlador#Acción</th>
<th>Helper de Ruta Nombrada</th>
</tr>
</thead><tbody>
<tr>
<td>GET</td>
<td>/articles/:article_id/comments(.:format)</td>
<td>comments#index</td>
<td>article_comments_path</td>
</tr>
<tr>
<td>POST</td>
<td>/articles/:article_id/comments(.:format)</td>
<td>comments#create</td>
<td>article_comments_path</td>
</tr>
<tr>
<td>GET</td>
<td>/articles/:article_id/comments/new(.:format)</td>
<td>comments#new</td>
<td>new_article_comment_path</td>
</tr>
<tr>
<td>GET</td>
<td>/sekret/comments/:id/edit(.:format)</td>
<td>comments#edit</td>
<td>edit_comment_path</td>
</tr>
<tr>
<td>GET</td>
<td>/sekret/comments/:id(.:format)</td>
<td>comments#show</td>
<td>comment_path</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/sekret/comments/:id(.:format)</td>
<td>comments#update</td>
<td>comment_path</td>
</tr>
<tr>
<td>DELETE</td>
<td>/sekret/comments/:id(.:format)</td>
<td>comments#destroy</td>
<td>comment_path</td>
</tr>
</tbody></table>
<p>La opción <code>:shallow_prefix</code> agrega el parámetro especificado a los helpers de ruta nombrados:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">scope</span> <span class="ss">shallow_prefix: </span><span class="s2">"sekret"</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:articles</span> <span class="k">do</span>
    <span class="n">resources</span> <span class="ss">:comments</span><span class="p">,</span> <span class="ss">shallow: </span><span class="kp">true</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="scope shallow_prefix: &quot;sekret&quot; do
  resources :articles do
    resources :comments, shallow: true
  end
end
">Copy</button>
</div>
<p>El recurso comments aquí tendrá las siguientes rutas generadas para él:</p>
<table><thead>
<tr>
<th>Verbo HTTP</th>
<th>Ruta</th>
<th>Controlador#Acción</th>
<th>Helper de Ruta Nombrada</th>
</tr>
</thead><tbody>
<tr>
<td>GET</td>
<td>/articles/:article_id/comments(.:format)</td>
<td>comments#index</td>
<td>article_comments_path</td>
</tr>
<tr>
<td>POST</td>
<td>/articles/:article_id/comments(.:format)</td>
<td>comments#create</td>
<td>article_comments_path</td>
</tr>
<tr>
<td>GET</td>
<td>/articles/:article_id/comments/new(.:format)</td>
<td>comments#new</td>
<td>new_article_comment_path</td>
</tr>
<tr>
<td>GET</td>
<td>/comments/:id/edit(.:format)</td>
<td>comments#edit</td>
<td>edit_sekret_comment_path</td>
</tr>
<tr>
<td>GET</td>
<td>/comments/:id(.:format)</td>
<td>comments#show</td>
<td>sekret_comment_path</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/comments/:id(.:format)</td>
<td>comments#update</td>
<td>sekret_comment_path</td>
</tr>
<tr>
<td>DELETE</td>
<td>/comments/:id(.:format)</td>
<td>comments#destroy</td>
<td>sekret_comment_path</td>
</tr>
</tbody></table>
<h3 id="preocupaciones-de-enrutamiento"><a class="anchorlink" href="#preocupaciones-de-enrutamiento"><span>2.8</span> Preocupaciones de Enrutamiento</a></h3><p>Las preocupaciones de enrutamiento te permiten declarar rutas comunes que pueden ser reutilizadas dentro de otros recursos y rutas. Para definir una preocupación, usa un bloque <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Concerns.html#method-i-concern"><code>concern</code></a>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">concern</span> <span class="ss">:commentable</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:comments</span>
<span class="k">end</span>

<span class="n">concern</span> <span class="ss">:image_attachable</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:images</span><span class="p">,</span> <span class="ss">only: :index</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="concern :commentable do
  resources :comments
end

concern :image_attachable do
  resources :images, only: :index
end
">Copy</button>
</div>
<p>Estas preocupaciones pueden ser usadas en recursos para evitar la duplicación de código y compartir comportamiento a través de rutas:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:messages</span><span class="p">,</span> <span class="ss">concerns: :commentable</span>

<span class="n">resources</span> <span class="ss">:articles</span><span class="p">,</span> <span class="ss">concerns: </span><span class="p">[</span><span class="ss">:commentable</span><span class="p">,</span> <span class="ss">:image_attachable</span><span class="p">]</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :messages, concerns: :commentable

resources :articles, concerns: [:commentable, :image_attachable]
">Copy</button>
</div>
<p>Lo anterior es equivalente a:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:messages</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:comments</span>
<span class="k">end</span>

<span class="n">resources</span> <span class="ss">:articles</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:comments</span>
  <span class="n">resources</span> <span class="ss">:images</span><span class="p">,</span> <span class="ss">only: :index</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :messages do
  resources :comments
end

resources :articles do
  resources :comments
  resources :images, only: :index
end
">Copy</button>
</div>
<p>También puedes usarlas en cualquier lugar llamando a <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Concerns.html#method-i-concerns"><code>concerns</code></a>. Por ejemplo, en un bloque <code>scope</code> o <code>namespace</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">namespace</span> <span class="ss">:articles</span> <span class="k">do</span>
  <span class="n">concerns</span> <span class="ss">:commentable</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="namespace :articles do
  concerns :commentable
end
">Copy</button>
</div>
<h3 id="creando-rutas-y-urls-desde-objetos"><a class="anchorlink" href="#creando-rutas-y-urls-desde-objetos"><span>2.9</span> Creando Rutas y URLs desde Objetos</a></h3><p>Además de usar los helpers de enrutamiento, Rails también puede crear rutas y URLs desde un array de parámetros. Por ejemplo, supongamos que tienes este conjunto de rutas:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:magazines</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:ads</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :magazines do
  resources :ads
end
">Copy</button>
</div>
<p>Al usar <code>magazine_ad_path</code>, puedes pasar instancias de <code>Magazine</code> y <code>Ad</code> en lugar de los IDs numéricos:</p><div class="interstitial code">
<pre><code class="highlight erb"><span class="cp">&lt;%=</span> <span class="n">link_to</span> <span class="s1">'Ad details'</span><span class="p">,</span> <span class="n">magazine_ad_path</span><span class="p">(</span><span class="vi">@magazine</span><span class="p">,</span> <span class="vi">@ad</span><span class="p">)</span> <span class="cp">%&gt;</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="<%= link_to 'Ad details', magazine_ad_path(@magazine, @ad) %>
">Copy</button>
</div>
<p>También puedes usar <a href="https://edgeapi.rubyonrails.org/classes/ActionView/RoutingUrlFor.html#method-i-url_for"><code>url_for</code></a> con un conjunto de objetos, y Rails determinará automáticamente qué ruta deseas:</p><div class="interstitial code">
<pre><code class="highlight erb"><span class="cp">&lt;%=</span> <span class="n">link_to</span> <span class="s1">'Ad details'</span><span class="p">,</span> <span class="n">url_for</span><span class="p">([</span><span class="vi">@magazine</span><span class="p">,</span> <span class="vi">@ad</span><span class="p">])</span> <span class="cp">%&gt;</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="<%= link_to 'Ad details', url_for([@magazine, @ad]) %>
">Copy</button>
</div>
<p>En este caso, Rails verá que <code>@magazine</code> es una <code>Magazine</code> y <code>@ad</code> es un <code>Ad</code> y, por lo tanto, usará el helper <code>magazine_ad_path</code>. En helpers como <code>link_to</code>, puedes especificar solo el objeto en lugar de la llamada completa a <code>url_for</code>:</p><div class="interstitial code">
<pre><code class="highlight erb"><span class="cp">&lt;%=</span> <span class="n">link_to</span> <span class="s1">'Ad details'</span><span class="p">,</span> <span class="p">[</span><span class="vi">@magazine</span><span class="p">,</span> <span class="vi">@ad</span><span class="p">]</span> <span class="cp">%&gt;</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="<%= link_to 'Ad details', [@magazine, @ad] %>
">Copy</button>
</div>
<p>Si quisieras enlazar solo a una revista:</p><div class="interstitial code">
<pre><code class="highlight erb"><span class="cp">&lt;%=</span> <span class="n">link_to</span> <span class="s1">'Magazine details'</span><span class="p">,</span> <span class="vi">@magazine</span> <span class="cp">%&gt;</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="<%= link_to 'Magazine details', @magazine %>
">Copy</button>
</div>
<p>Para otras acciones, solo necesitas insertar el nombre de la acción como el primer elemento del array:</p><div class="interstitial code">
<pre><code class="highlight erb"><span class="cp">&lt;%=</span> <span class="n">link_to</span> <span class="s1">'Edit Ad'</span><span class="p">,</span> <span class="p">[</span><span class="ss">:edit</span><span class="p">,</span> <span class="vi">@magazine</span><span class="p">,</span> <span class="vi">@ad</span><span class="p">]</span> <span class="cp">%&gt;</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="<%= link_to 'Edit Ad', [:edit, @magazine, @ad] %>
">Copy</button>
</div>
<p>Esto te permite tratar instancias de tus modelos como URLs, y es una ventaja clave de usar el estilo de recurso.</p><h3 id="agregando-más-acciones-restful"><a class="anchorlink" href="#agregando-más-acciones-restful"><span>2.10</span> Agregando Más Acciones RESTful</a></h3><p>No estás limitado a las siete rutas que el enrutamiento RESTful crea por defecto. Si lo deseas, puedes agregar rutas adicionales que se apliquen a la colección o a miembros individuales de la colección.</p><h4 id="agregando-rutas-de-miembro"><a class="anchorlink" href="#agregando-rutas-de-miembro"><span>2.10.1</span> Agregando Rutas de Miembro</a></h4><p>Para agregar una ruta de miembro, solo agrega un bloque <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Resources.html#method-i-member"><code>member</code></a> dentro del bloque de recursos:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span> <span class="k">do</span>
  <span class="n">member</span> <span class="k">do</span>
    <span class="n">get</span> <span class="s1">'preview'</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos do
  member do
    get 'preview'
  end
end
">Copy</button>
</div>
<p>Esto reconocerá <code>/photos/1/preview</code> con GET, y enrutará a la acción <code>preview</code> del <code>PhotosController</code>, con el valor de ID del recurso pasado en <code>params[:id]</code>. También creará los helpers <code>preview_photo_url</code> y <code>preview_photo_path</code>.</p><p>Dentro del bloque de rutas de miembro, cada nombre de ruta especifica el verbo HTTP que será reconocido. Puedes usar <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/HttpHelpers.html#method-i-get"><code>get</code></a>, <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/HttpHelpers.html#method-i-patch"><code>patch</code></a>, <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/HttpHelpers.html#method-i-put"><code>put</code></a>, <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/HttpHelpers.html#method-i-post"><code>post</code></a>, o <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/HttpHelpers.html#method-i-delete"><code>delete</code></a> aquí. Si no tienes múltiples rutas de <code>member</code>, también puedes pasar <code>:on</code> a una ruta, eliminando el bloque:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span> <span class="k">do</span>
  <span class="n">get</span> <span class="s1">'preview'</span><span class="p">,</span> <span class="ss">on: :member</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos do
  get 'preview', on: :member
end
">Copy</button>
</div>
<p>Puedes omitir la opción <code>:on</code>, esto creará la misma ruta de miembro, excepto que el valor de ID del recurso estará disponible en <code>params[:photo_id]</code> en lugar de <code>params[:id]</code>. Los helpers de ruta también se renombrarán de <code>preview_photo_url</code> y <code>preview_photo_path</code> a <code>photo_preview_url</code> y <code>photo_preview_path</code>.</p><h4 id="agregando-rutas-de-colección"><a class="anchorlink" href="#agregando-rutas-de-colección"><span>2.10.2</span> Agregando Rutas de Colección</a></h4><p>Para agregar una ruta a la colección, usa un bloque <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Resources.html#method-i-collection"><code>collection</code></a>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span> <span class="k">do</span>
  <span class="n">collection</span> <span class="k">do</span>
    <span class="n">get</span> <span class="s1">'search'</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos do
  collection do
    get 'search'
  end
end
">Copy</button>
</div>
<p>Esto permitirá a Rails reconocer rutas como <code>/photos/search</code> con GET, y enrutará a la acción <code>search</code> del <code>PhotosController</code>. También creará los helpers de ruta <code>search_photos_url</code> y <code>search_photos_path</code>.</p><p>Al igual que con las rutas de miembro, puedes pasar <code>:on</code> a una ruta:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span> <span class="k">do</span>
  <span class="n">get</span> <span class="s1">'search'</span><span class="p">,</span> <span class="ss">on: :collection</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos do
  get 'search', on: :collection
end
">Copy</button>
</div>
<p>NOTA: Si estás definiendo rutas de recursos adicionales con un símbolo como el primer argumento posicional, ten en cuenta que no es equivalente a usar una cadena. Los símbolos infieren acciones del controlador mientras que las cadenas infieren rutas.</p><h4 id="agregando-rutas-para-acciones-nuevas-adicionales"><a class="anchorlink" href="#agregando-rutas-para-acciones-nuevas-adicionales"><span>2.10.3</span> Agregando Rutas para Acciones Nuevas Adicionales</a></h4><p>Para agregar una acción nueva alternativa usando el atajo <code>:on</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:comments</span> <span class="k">do</span>
  <span class="n">get</span> <span class="s1">'preview'</span><span class="p">,</span> <span class="ss">on: :new</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :comments do
  get 'preview', on: :new
end
">Copy</button>
</div>
<p>Esto permitirá a Rails reconocer rutas como <code>/comments/new/preview</code> con GET, y enrutará a la acción <code>preview</code> del <code>CommentsController</code>. También creará los helpers de ruta <code>preview_new_comment_url</code> y <code>preview_new_comment_path</code>.</p><p>CONSEJO: Si te encuentras agregando muchas acciones adicionales a una ruta de recurso, es momento de detenerte y preguntarte si estás disfrazando la presencia de otro recurso.</p><h2 id="rutas-no-resursivas"><a class="anchorlink" href="#rutas-no-resursivas"><span>3</span> Rutas No-Resursivas</a></h2><p>Además del enrutamiento de recursos, Rails tiene un soporte poderoso para enrutar URLs arbitrarias a acciones. Aquí, no obtienes grupos de rutas generadas automáticamente por el enrutamiento de recursos. En cambio, configuras cada ruta por separado dentro de tu aplicación.</p><p>Si bien generalmente deberías usar el enrutamiento de recursos, todavía hay muchos lugares donde el enrutamiento más simple es más apropiado. No hay necesidad de intentar encajar hasta el último pedazo de tu aplicación en un marco de recursos si no es una buena opción.</p><p>En particular, el enrutamiento simple hace que sea muy fácil mapear URLs heredadas a nuevas acciones de Rails.</p><h3 id="parámetros-vinculados"><a class="anchorlink" href="#parámetros-vinculados"><span>3.1</span> Parámetros Vinculados</a></h3><p>Cuando configuras una ruta regular, proporcionas una serie de símbolos que Rails mapea a partes de una solicitud HTTP entrante. Por ejemplo, considera esta ruta:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'photos(/:id)'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'photos#display'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'photos(/:id)', to: 'photos#display'
">Copy</button>
</div>
<p>Si una solicitud entrante de <code>/photos/1</code> es procesada por esta ruta (porque no ha coincidido con ninguna ruta anterior en el archivo), el resultado será invocar la acción <code>display</code> del <code>PhotosController</code>, y hacer que el parámetro final <code>"1"</code> esté disponible como <code>params[:id]</code>. Esta ruta también enrutará la solicitud entrante de <code>/photos</code> al <code>PhotosController#display</code>, ya que <code>:id</code> es un parámetro opcional, denotado por paréntesis.</p><h3 id="segmentos-dinámicos"><a class="anchorlink" href="#segmentos-dinámicos"><span>3.2</span> Segmentos Dinámicos</a></h3><p>Puedes configurar tantos segmentos dinámicos dentro de una ruta regular como desees. Cualquier segmento estará disponible para la acción como parte de <code>params</code>. Si configuras esta ruta:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'photos/:id/:user_id'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'photos#show'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'photos/:id/:user_id', to: 'photos#show'
">Copy</button>
</div>
<p>Una ruta entrante de <code>/photos/1/2</code> será enviada a la acción <code>show</code> del <code>PhotosController</code>. <code>params[:id]</code> será <code>"1"</code>, y <code>params[:user_id]</code> será <code>"2"</code>.</p><p>CONSEJO: Por defecto, los segmentos dinámicos no aceptan puntos - esto se debe a que el punto se usa como un separador para rutas con formato. Si necesitas usar un punto dentro de un segmento dinámico, agrega una restricción que anule esto – por ejemplo, <code>id: /[^\/]+/</code> permite cualquier cosa excepto una barra.</p><h3 id="segmentos-estáticos"><a class="anchorlink" href="#segmentos-estáticos"><span>3.3</span> Segmentos Estáticos</a></h3><p>Puedes especificar segmentos estáticos al crear una ruta al no anteponer un colon a un segmento:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'photos/:id/with_user/:user_id'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'photos#show'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'photos/:id/with_user/:user_id', to: 'photos#show'
">Copy</button>
</div>
<p>Esta ruta respondería a rutas como <code>/photos/1/with_user/2</code>. En este caso, <code>params</code> sería <code>{ controller: 'photos', action: 'show', id: '1', user_id: '2' }</code>.</p><h3 id="la-cadena-de-consulta"><a class="anchorlink" href="#la-cadena-de-consulta"><span>3.4</span> La Cadena de Consulta</a></h3><p>Los <code>params</code> también incluirán cualquier parámetro de la cadena de consulta. Por ejemplo, con esta ruta:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'photos/:id'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'photos#show'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'photos/:id', to: 'photos#show'
">Copy</button>
</div>
<p>Una ruta entrante de <code>/photos/1?user_id=2</code> será enviada a la acción <code>show</code> del controlador <code>Photos</code>. <code>params</code> será <code>{ controller: 'photos', action: 'show', id: '1', user_id: '2' }</code>.</p><h3 id="definiendo-valores-predeterminados"><a class="anchorlink" href="#definiendo-valores-predeterminados"><span>3.5</span> Definiendo Valores Predeterminados</a></h3><p>Puedes definir valores predeterminados en una ruta proporcionando un hash para la opción <code>:defaults</code>. Esto incluso se aplica a parámetros que no especificas como segmentos dinámicos. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'photos/:id'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'photos#show'</span><span class="p">,</span> <span class="ss">defaults: </span><span class="p">{</span> <span class="ss">format: </span><span class="s1">'jpg'</span> <span class="p">}</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'photos/:id', to: 'photos#show', defaults: { format: 'jpg' }
">Copy</button>
</div>
<p>Rails emparejaría <code>photos/12</code> con la acción <code>show</code> del <code>PhotosController</code>, y establecería <code>params[:format]</code> en <code>"jpg"</code>.</p><p>También puedes usar un bloque <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Scoping.html#method-i-defaults"><code>defaults</code></a> para definir los valores predeterminados para múltiples elementos:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">defaults</span> <span class="ss">format: :json</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:photos</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="defaults format: :json do
  resources :photos
end
">Copy</button>
</div>
<p>NOTA: No puedes anular los valores predeterminados a través de parámetros de consulta - esto es por razones de seguridad. Los únicos valores predeterminados que se pueden anular son los segmentos dinámicos a través de la sustitución en la ruta de URL.</p><h3 id="nombrando-rutas"><a class="anchorlink" href="#nombrando-rutas"><span>3.6</span> Nombrando Rutas</a></h3><p>Puedes especificar un nombre para cualquier ruta usando la opción <code>:as</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'exit'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'sessions#destroy'</span><span class="p">,</span> <span class="ss">as: :logout</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'exit', to: 'sessions#destroy', as: :logout
">Copy</button>
</div>
<p>Esto creará <code>logout_path</code> y <code>logout_url</code> como helpers de ruta nombrados en tu aplicación. Llamar a <code>logout_path</code> devolverá <code>/exit</code></p><p>También puedes usar esto para anular métodos de enrutamiento definidos por recursos colocando rutas personalizadas antes de que se defina el recurso, así:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">':username'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'users#show'</span><span class="p">,</span> <span class="ss">as: :user</span>
<span class="n">resources</span> <span class="ss">:users</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get ':username', to: 'users#show', as: :user
resources :users
">Copy</button>
</div>
<p>Esto definirá un método <code>user_path</code> que estará disponible en controladores, helpers y vistas que irán a una ruta como <code>/bob</code>. Dentro de la acción <code>show</code> del <code>UsersController</code>, <code>params[:username]</code> contendrá el nombre de usuario del usuario. Cambia <code>:username</code> en la definición de la ruta si no deseas que el nombre de tu parámetro sea <code>:username</code>.</p><h3 id="restricciones-de-verbos-http"><a class="anchorlink" href="#restricciones-de-verbos-http"><span>3.7</span> Restricciones de Verbos HTTP</a></h3><p>En general, deberías usar los métodos <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/HttpHelpers.html#method-i-get"><code>get</code></a>, <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/HttpHelpers.html#method-i-post"><code>post</code></a>, <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/HttpHelpers.html#method-i-put"><code>put</code></a>, <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/HttpHelpers.html#method-i-patch"><code>patch</code></a>, y <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/HttpHelpers.html#method-i-delete"><code>delete</code></a> para restringir una ruta a un verbo en particular. Puedes usar el método <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Base.html#method-i-match"><code>match</code></a> con la opción <code>:via</code> para emparejar múltiples verbos a la vez:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">match</span> <span class="s1">'photos'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'photos#show'</span><span class="p">,</span> <span class="ss">via: </span><span class="p">[</span><span class="ss">:get</span><span class="p">,</span> <span class="ss">:post</span><span class="p">]</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="match 'photos', to: 'photos#show', via: [:get, :post]
">Copy</button>
</div>
<p>Puedes emparejar todos los verbos a una ruta en particular usando <code>via: :all</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">match</span> <span class="s1">'photos'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'photos#show'</span><span class="p">,</span> <span class="ss">via: :all</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="match 'photos', to: 'photos#show', via: :all
">Copy</button>
</div>
<p>NOTA: Enrutar tanto solicitudes <code>GET</code> como <code>POST</code> a una sola acción tiene implicaciones de seguridad. En general, deberías evitar enrutar todos los verbos a una acción a menos que tengas una buena razón para hacerlo.</p><p>NOTA: <code>GET</code> en Rails no verificará el token CSRF. Nunca deberías escribir en la base de datos desde solicitudes <code>GET</code>, para más información consulta la <a href="security.html#csrf-countermeasures">guía de seguridad</a> sobre contramedidas CSRF.</p><h3 id="restricciones-de-segmentos"><a class="anchorlink" href="#restricciones-de-segmentos"><span>3.8</span> Restricciones de Segmentos</a></h3><p>Puedes usar la opción <code>:constraints</code> para imponer un formato para un segmento dinámico:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'photos/:id'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'photos#show'</span><span class="p">,</span> <span class="ss">constraints: </span><span class="p">{</span> <span class="ss">id: </span><span class="sr">/[A-Z]\d{5}/</span> <span class="p">}</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'photos/:id', to: 'photos#show', constraints: { id: /[A-Z]\d{5}/ }
">Copy</button>
</div>
<p>Esta ruta emparejaría rutas como <code>/photos/A12345</code>, pero no <code>/photos/893</code>. Puedes expresar la misma ruta de manera más concisa de esta manera:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'photos/:id'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'photos#show'</span><span class="p">,</span> <span class="ss">id: </span><span class="sr">/[A-Z]\d{5}/</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'photos/:id', to: 'photos#show', id: /[A-Z]\d{5}/
">Copy</button>
</div>
<p><code>:constraints</code> toma expresiones regulares con la restricción de que no se pueden usar anclas de regexp. Por ejemplo, la siguiente ruta no funcionará:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'/:id'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'articles#show'</span><span class="p">,</span> <span class="ss">constraints: </span><span class="p">{</span> <span class="ss">id: </span><span class="sr">/^\d/</span> <span class="p">}</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get '/:id', to: 'articles#show', constraints: { id: /^\d/ }
">Copy</button>
</div>
<p>Sin embargo, ten en cuenta que no necesitas usar anclas porque todas las rutas están ancladas al inicio y al final.</p><p>Por ejemplo, las siguientes rutas permitirían <code>articles</code> con valores <code>to_param</code> como <code>1-hello-world</code> que siempre comienzan con un número y <code>users</code> con valores <code>to_param</code> como <code>david</code> que nunca comienzan con un número para compartir el namespace raíz:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'/:id'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'articles#show'</span><span class="p">,</span> <span class="ss">constraints: </span><span class="p">{</span> <span class="ss">id: </span><span class="sr">/\d.+/</span> <span class="p">}</span>
<span class="n">get</span> <span class="s1">'/:username'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'users#show'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get '/:id', to: 'articles#show', constraints: { id: /\d.+/ }
get '/:username', to: 'users#show'
">Copy</button>
</div>
<h3 id="restricciones-basadas-en-solicitudes"><a class="anchorlink" href="#restricciones-basadas-en-solicitudes"><span>3.9</span> Restricciones Basadas en Solicitudes</a></h3><p>También puedes restringir una ruta basada en cualquier método en el <a href="action_controller_overview.html#the-request-object">objeto Request</a> que devuelva una <code>String</code>.</p><p>Especificas una restricción basada en solicitudes de la misma manera que especificas una restricción de segmento:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'photos'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'photos#index'</span><span class="p">,</span> <span class="ss">constraints: </span><span class="p">{</span> <span class="ss">subdomain: </span><span class="s1">'admin'</span> <span class="p">}</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'photos', to: 'photos#index', constraints: { subdomain: 'admin' }
">Copy</button>
</div>
<p>También puedes especificar restricciones usando un bloque <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Scoping.html#method-i-constraints"><code>constraints</code></a>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">namespace</span> <span class="ss">:admin</span> <span class="k">do</span>
  <span class="n">constraints</span> <span class="ss">subdomain: </span><span class="s1">'admin'</span> <span class="k">do</span>
    <span class="n">resources</span> <span class="ss">:photos</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="namespace :admin do
  constraints subdomain: 'admin' do
    resources :photos
  end
end
">Copy</button>
</div>
<p>NOTA: Las restricciones de solicitud funcionan llamando a un método en el <a href="action_controller_overview.html#the-request-object">objeto Request</a> con el mismo nombre que la clave del hash y luego comparando el valor de retorno con el valor del hash. Por lo tanto, los valores de restricción deben coincidir con el tipo de retorno del método del objeto Request correspondiente. Por ejemplo: <code>constraints: { subdomain: 'api' }</code> coincidirá con un subdominio <code>api</code> como se espera. Sin embargo, usar un símbolo <code>constraints: { subdomain: :api }</code> no lo hará, porque <code>request.subdomain</code> devuelve <code>'api'</code> como una String.</p><p>NOTA: Hay una excepción para la restricción <code>format</code>: aunque es un método en el objeto Request, también es un parámetro opcional implícito en cada ruta. Las restricciones de segmento tienen prioridad y la restricción <code>format</code> solo se aplica como tal cuando se aplica a través de un hash. Por ejemplo, <code>get 'foo', constraints: { format: 'json' }</code> coincidirá con <code>GET /foo</code> porque el formato es opcional por defecto. Sin embargo, puedes <a href="#restricciones-avanzadas">usar un lambda</a> como en <code>get 'foo', constraints: lambda { |req| req.format == :json }</code> y la ruta solo coincidirá con solicitudes JSON explícitas.</p><h3 id="restricciones-avanzadas"><a class="anchorlink" href="#restricciones-avanzadas"><span>3.10</span> Restricciones Avanzadas</a></h3><p>Si tienes una restricción más avanzada, puedes proporcionar un objeto que responda a <code>matches?</code> que Rails debería usar. Digamos que querías enrutar a todos los usuarios en una lista restringida al <code>RestrictedListController</code>. Podrías hacer:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="k">class</span> <span class="nc">RestrictedListConstraint</span>
  <span class="k">def</span> <span class="nf">initialize</span>
    <span class="vi">@ips</span> <span class="o">=</span> <span class="no">RestrictedList</span><span class="p">.</span><span class="nf">retrieve_ips</span>
  <span class="k">end</span>

  <span class="k">def</span> <span class="nf">matches?</span><span class="p">(</span><span class="n">request</span><span class="p">)</span>
    <span class="vi">@ips</span><span class="p">.</span><span class="nf">include?</span><span class="p">(</span><span class="n">request</span><span class="p">.</span><span class="nf">remote_ip</span><span class="p">)</span>
  <span class="k">end</span>
<span class="k">end</span>

<span class="no">Rails</span><span class="p">.</span><span class="nf">application</span><span class="p">.</span><span class="nf">routes</span><span class="p">.</span><span class="nf">draw</span> <span class="k">do</span>
  <span class="n">get</span> <span class="s1">'*path'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'restricted_list#index'</span><span class="p">,</span>
    <span class="ss">constraints: </span><span class="no">RestrictedListConstraint</span><span class="p">.</span><span class="nf">new</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="class RestrictedListConstraint
  def initialize
    @ips = RestrictedList.retrieve_ips
  end

  def matches?(request)
    @ips.include?(request.remote_ip)
  end
end

Rails.application.routes.draw do
  get '*path', to: 'restricted_list#index',
    constraints: RestrictedListConstraint.new
end
">Copy</button>
</div>
<p>También puedes especificar restricciones como un lambda:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="no">Rails</span><span class="p">.</span><span class="nf">application</span><span class="p">.</span><span class="nf">routes</span><span class="p">.</span><span class="nf">draw</span> <span class="k">do</span>
  <span class="n">get</span> <span class="s1">'*path'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'restricted_list#index'</span><span class="p">,</span>
    <span class="ss">constraints: </span><span class="nb">lambda</span> <span class="p">{</span> <span class="o">|</span><span class="n">request</span><span class="o">|</span> <span class="no">RestrictedList</span><span class="p">.</span><span class="nf">retrieve_ips</span><span class="p">.</span><span class="nf">include?</span><span class="p">(</span><span class="n">request</span><span class="p">.</span><span class="nf">remote_ip</span><span class="p">)</span> <span class="p">}</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="Rails.application.routes.draw do
  get '*path', to: 'restricted_list#index',
    constraints: lambda { |request| RestrictedList.retrieve_ips.include?(request.remote_ip) }
end
">Copy</button>
</div>
<p>Tanto el método <code>matches?</code> como el lambda reciben el objeto <code>request</code> como argumento.</p><h4 id="restricciones-en-forma-de-bloque"><a class="anchorlink" href="#restricciones-en-forma-de-bloque"><span>3.10.1</span> Restricciones en Forma de Bloque</a></h4><p>Puedes especificar restricciones en forma de bloque. Esto es útil cuando necesitas aplicar la misma regla a varias rutas. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="k">class</span> <span class="nc">RestrictedListConstraint</span>
  <span class="c1"># ...Igual que el ejemplo anterior</span>
<span class="k">end</span>

<span class="no">Rails</span><span class="p">.</span><span class="nf">application</span><span class="p">.</span><span class="nf">routes</span><span class="p">.</span><span class="nf">draw</span> <span class="k">do</span>
  <span class="n">constraints</span><span class="p">(</span><span class="no">RestrictedListConstraint</span><span class="p">.</span><span class="nf">new</span><span class="p">)</span> <span class="k">do</span>
    <span class="n">get</span> <span class="s1">'*path'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'restricted_list#index'</span>
    <span class="n">get</span> <span class="s1">'*other-path'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'other_restricted_list#index'</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="class RestrictedListConstraint
  # ...Igual que el ejemplo anterior
end

Rails.application.routes.draw do
  constraints(RestrictedListConstraint.new) do
    get '*path', to: 'restricted_list#index'
    get '*other-path', to: 'other_restricted_list#index'
  end
end
">Copy</button>
</div>
<p>También puedes usar un <code>lambda</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="no">Rails</span><span class="p">.</span><span class="nf">application</span><span class="p">.</span><span class="nf">routes</span><span class="p">.</span><span class="nf">draw</span> <span class="k">do</span>
  <span class="n">constraints</span><span class="p">(</span><span class="nb">lambda</span> <span class="p">{</span> <span class="o">|</span><span class="n">request</span><span class="o">|</span> <span class="no">RestrictedList</span><span class="p">.</span><span class="nf">retrieve_ips</span><span class="p">.</span><span class="nf">include?</span><span class="p">(</span><span class="n">request</span><span class="p">.</span><span class="nf">remote_ip</span><span class="p">)</span> <span class="p">})</span> <span class="k">do</span>
    <span class="n">get</span> <span class="s1">'*path'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'restricted_list#index'</span>
    <span class="n">get</span> <span class="s1">'*other-path'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'other_restricted_list#index'</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="Rails.application.routes.draw do
  constraints(lambda { |request| RestrictedList.retrieve_ips.include?(request.remote_ip) }) do
    get '*path', to: 'restricted_list#index'
    get '*other-path', to: 'other_restricted_list#index'
  end
end
">Copy</button>
</div>
<h3 id="globbing-de-rutas-y-segmentos-comodín"><a class="anchorlink" href="#globbing-de-rutas-y-segmentos-comodín"><span>3.11</span> Globbing de Rutas y Segmentos Comodín</a></h3><p>El globbing de rutas es una forma de especificar que un parámetro particular debe coincidir con todas las partes restantes de una ruta. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'photos/*other'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'photos#unknown'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'photos/*other', to: 'photos#unknown'
">Copy</button>
</div>
<p>Esta ruta coincidiría con <code>photos/12</code> o <code>/photos/long/path/to/12</code>, estableciendo <code>params[:other]</code> en <code>"12"</code> o <code>"long/path/to/12"</code>. Los segmentos prefijados con un asterisco se llaman "segmentos comodín".</p><p>Los segmentos comodín pueden ocurrir en cualquier lugar de una ruta. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'books/*section/:title'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'books#show'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'books/*section/:title', to: 'books#show'
">Copy</button>
</div>
<p>coincidiría con <code>books/some/section/last-words-a-memoir</code> con <code>params[:section]</code> igual a <code>'some/section'</code>, y <code>params[:title]</code> igual a <code>'last-words-a-memoir'</code>.</p><p>Técnicamente, una ruta puede tener incluso más de un segmento comodín. El emparejador asigna segmentos a parámetros de manera intuitiva. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'*a/foo/*b'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'test#index'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get '*a/foo/*b', to: 'test#index'
">Copy</button>
</div>
<p>coincidiría con <code>zoo/woo/foo/bar/baz</code> con <code>params[:a]</code> igual a <code>'zoo/woo'</code>, y <code>params[:b]</code> igual a <code>'bar/baz'</code>.</p><p>NOTA: Al solicitar <code>'/foo/bar.json'</code>, tu <code>params[:pages]</code> será igual a <code>'foo/bar'</code> con el formato de solicitud de JSON. Si deseas el comportamiento anterior de 3.0.x de vuelta, podrías suministrar <code>format: false</code> así:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'*pages'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'pages#show'</span><span class="p">,</span> <span class="ss">format: </span><span class="kp">false</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get '*pages', to: 'pages#show', format: false
">Copy</button>
</div>
<p>NOTA: Si deseas hacer que el segmento de formato sea obligatorio, de modo que no se pueda omitir, puedes suministrar <code>format: true</code> así:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'*pages'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'pages#show'</span><span class="p">,</span> <span class="ss">format: </span><span class="kp">true</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get '*pages', to: 'pages#show', format: true
">Copy</button>
</div>
<h3 id="redirección"><a class="anchorlink" href="#redirección"><span>3.12</span> Redirección</a></h3><p>Puedes redirigir cualquier ruta a otra ruta usando el helper <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Redirection.html#method-i-redirect"><code>redirect</code></a> en tu router:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'/stories'</span><span class="p">,</span> <span class="ss">to: </span><span class="n">redirect</span><span class="p">(</span><span class="s1">'/articles'</span><span class="p">)</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get '/stories', to: redirect('/articles')
">Copy</button>
</div>
<p>También puedes reutilizar segmentos dinámicos del emparejamiento en la ruta a la que redirigir:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'/stories/:name'</span><span class="p">,</span> <span class="ss">to: </span><span class="n">redirect</span><span class="p">(</span><span class="s1">'/articles/%{name}'</span><span class="p">)</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get '/stories/:name', to: redirect('/articles/%{name}')
">Copy</button>
</div>
<p>También puedes proporcionar un bloque a <code>redirect</code>, que recibe los parámetros de ruta simbolizados y el objeto de solicitud:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'/stories/:name'</span><span class="p">,</span> <span class="ss">to: </span><span class="n">redirect</span> <span class="p">{</span> <span class="o">|</span><span class="n">path_params</span><span class="p">,</span> <span class="n">req</span><span class="o">|</span> <span class="s2">"/articles/</span><span class="si">#{</span><span class="n">path_params</span><span class="p">[</span><span class="ss">:name</span><span class="p">].</span><span class="nf">pluralize</span><span class="si">}</span><span class="s2">"</span> <span class="p">}</span>
<span class="n">get</span> <span class="s1">'/stories'</span><span class="p">,</span> <span class="ss">to: </span><span class="n">redirect</span> <span class="p">{</span> <span class="o">|</span><span class="n">path_params</span><span class="p">,</span> <span class="n">req</span><span class="o">|</span> <span class="s2">"/articles/</span><span class="si">#{</span><span class="n">req</span><span class="p">.</span><span class="nf">subdomain</span><span class="si">}</span><span class="s2">"</span> <span class="p">}</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get '/stories/:name', to: redirect { |path_params, req| &quot;/articles/#{path_params[:name].pluralize}&quot; }
get '/stories', to: redirect { |path_params, req| &quot;/articles/#{req.subdomain}&quot; }
">Copy</button>
</div>
<p>Ten en cuenta que la redirección predeterminada es una redirección 301 "Movido Permanentemente". Ten en cuenta que algunos navegadores web o servidores proxy almacenarán en caché este tipo de redirección, haciendo que la página antigua sea inaccesible. Puedes usar la opción <code>:status</code> para cambiar el estado de la respuesta:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'/stories/:name'</span><span class="p">,</span> <span class="ss">to: </span><span class="n">redirect</span><span class="p">(</span><span class="s1">'/articles/%{name}'</span><span class="p">,</span> <span class="ss">status: </span><span class="mi">302</span><span class="p">)</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get '/stories/:name', to: redirect('/articles/%{name}', status: 302)
">Copy</button>
</div>
<p>En todos estos casos, si no proporcionas el host principal (<code>http://www.example.com</code>), Rails tomará esos detalles de la solicitud actual.</p><h3 id="enrutando-a-aplicaciones-rack"><a class="anchorlink" href="#enrutando-a-aplicaciones-rack"><span>3.13</span> Enrutando a Aplicaciones Rack</a></h3><p>En lugar de una cadena como <code>'articles#index'</code>, que corresponde a la acción <code>index</code> en el <code>ArticlesController</code>, puedes especificar cualquier <a href="rails_on_rack.html">aplicación Rack</a> como el endpoint para un emparejador:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">match</span> <span class="s1">'/application.js'</span><span class="p">,</span> <span class="ss">to: </span><span class="no">MyRackApp</span><span class="p">,</span> <span class="ss">via: :all</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="match '/application.js', to: MyRackApp, via: :all
">Copy</button>
</div>
<p>Siempre que <code>MyRackApp</code> responda a <code>call</code> y devuelva un <code>[status, headers, body]</code>, el router no sabrá la diferencia entre la aplicación Rack y una acción. Este es un uso apropiado de <code>via: :all</code>, ya que querrás permitir que tu aplicación Rack maneje todos los verbos como lo considere apropiado.</p><p>NOTA: Para los curiosos, <code>'articles#index'</code> en realidad se expande a <code>ArticlesController.action(:index)</code>, que devuelve una aplicación Rack válida.</p><p>NOTA: Dado que los procs/lambdas son objetos que responden a <code>call</code>, puedes implementar rutas muy simples (por ejemplo, para verificaciones de salud) en línea:<br><code>get '/health', to: -&gt;(env) { [204, {}, ['']] }</code></p><p>Si especificas una aplicación Rack como el endpoint para un emparejador, recuerda que la ruta no cambiará en la aplicación receptora. Con la siguiente ruta, tu aplicación Rack debería esperar que la ruta sea <code>/admin</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">match</span> <span class="s1">'/admin'</span><span class="p">,</span> <span class="ss">to: </span><span class="no">AdminApp</span><span class="p">,</span> <span class="ss">via: :all</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="match '/admin', to: AdminApp, via: :all
">Copy</button>
</div>
<p>Si prefieres que tu aplicación Rack reciba solicitudes en la ruta raíz en su lugar, usa <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Base.html#method-i-mount"><code>mount</code></a>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">mount</span> <span class="no">AdminApp</span><span class="p">,</span> <span class="ss">at: </span><span class="s1">'/admin'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="mount AdminApp, at: '/admin'
">Copy</button>
</div>
<h3 id="usando-root"><a class="anchorlink" href="#usando-root"><span>3.14</span> Usando <code>root</code></a></h3><p>Puedes especificar a qué debería enrutar Rails <code>'/'</code> con el método <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Resources.html#method-i-root"><code>root</code></a>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">root</span> <span class="ss">to: </span><span class="s1">'pages#main'</span>
<span class="n">root</span> <span class="s1">'pages#main'</span> <span class="c1"># atajo para lo anterior</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="root to: 'pages#main'
root 'pages#main' # atajo para lo anterior
">Copy</button>
</div>
<p>Deberías colocar la ruta <code>root</code> en la parte superior del archivo, porque es la ruta más popular y debería coincidir primero.</p><p>NOTA: La ruta <code>root</code> solo enruta solicitudes <code>GET</code> a la acción.</p><p>También puedes usar root dentro de namespaces y scopes. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">namespace</span> <span class="ss">:admin</span> <span class="k">do</span>
  <span class="n">root</span> <span class="ss">to: </span><span class="s2">"admin#index"</span>
<span class="k">end</span>

<span class="n">root</span> <span class="ss">to: </span><span class="s2">"home#index"</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="namespace :admin do
  root to: &quot;admin#index&quot;
end

root to: &quot;home#index&quot;
">Copy</button>
</div>
<h3 id="rutas-de-caracteres-unicode"><a class="anchorlink" href="#rutas-de-caracteres-unicode"><span>3.15</span> Rutas de Caracteres Unicode</a></h3><p>Puedes especificar rutas de caracteres unicode directamente. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">get</span> <span class="s1">'こんにちは'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'welcome#index'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="get 'こんにちは', to: 'welcome#index'
">Copy</button>
</div>
<h3 id="rutas-directas"><a class="anchorlink" href="#rutas-directas"><span>3.16</span> Rutas Directas</a></h3><p>Puedes crear helpers de URL personalizados directamente llamando a <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/CustomUrls.html#method-i-direct"><code>direct</code></a>. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">direct</span> <span class="ss">:homepage</span> <span class="k">do</span>
  <span class="s2">"https://rubyonrails.org"</span>
<span class="k">end</span>

<span class="c1"># &gt;&gt; homepage_url</span>
<span class="c1"># =&gt; "https://rubyonrails.org"</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="direct :homepage do
  &quot;https://rubyonrails.org&quot;
end

# >> homepage_url
# => &quot;https://rubyonrails.org&quot;
">Copy</button>
</div>
<p>El valor de retorno del bloque debe ser un argumento válido para el método <code>url_for</code>. Por lo tanto, puedes pasar una URL de cadena válida, Hash, Array, una instancia de Active Model o una clase de Active Model.</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">direct</span> <span class="ss">:commentable</span> <span class="k">do</span> <span class="o">|</span><span class="n">model</span><span class="o">|</span>
  <span class="p">[</span> <span class="n">model</span><span class="p">,</span> <span class="ss">anchor: </span><span class="n">model</span><span class="p">.</span><span class="nf">dom_id</span> <span class="p">]</span>
<span class="k">end</span>

<span class="n">direct</span> <span class="ss">:main</span> <span class="k">do</span>
  <span class="p">{</span> <span class="ss">controller: </span><span class="s1">'pages'</span><span class="p">,</span> <span class="ss">action: </span><span class="s1">'index'</span><span class="p">,</span> <span class="ss">subdomain: </span><span class="s1">'www'</span> <span class="p">}</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="direct :commentable do |model|
  [ model, anchor: model.dom_id ]
end

direct :main do
  { controller: 'pages', action: 'index', subdomain: 'www' }
end
">Copy</button>
</div>
<h3 id="usando-resolve"><a class="anchorlink" href="#usando-resolve"><span>3.17</span> Usando <code>resolve</code></a></h3><p>El método <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/CustomUrls.html#method-i-resolve"><code>resolve</code></a> permite personalizar el mapeo polimórfico de modelos. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resource</span> <span class="ss">:basket</span>

<span class="n">resolve</span><span class="p">(</span><span class="s2">"Basket"</span><span class="p">)</span> <span class="p">{</span> <span class="p">[</span><span class="ss">:basket</span><span class="p">]</span> <span class="p">}</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resource :basket

resolve(&quot;Basket&quot;) { [:basket] }
">Copy</button>
</div>
<div class="interstitial code">
<pre><code class="highlight erb"><span class="cp">&lt;%=</span> <span class="n">form_with</span> <span class="ss">model: </span><span class="vi">@basket</span> <span class="k">do</span> <span class="o">|</span><span class="n">form</span><span class="o">|</span> <span class="cp">%&gt;</span>
  <span class="c">&lt;!-- formulario de cesta --&gt;</span>
<span class="cp">&lt;%</span> <span class="k">end</span> <span class="cp">%&gt;</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="<%= form_with model: @basket do |form| %>
  <!-- formulario de cesta -->
<% end %>
">Copy</button>
</div>
<p>Esto generará la URL singular <code>/basket</code> en lugar de la habitual <code>/baskets/:id</code>.</p><h2 id="personalizando-rutas-de-recursos"><a class="anchorlink" href="#personalizando-rutas-de-recursos"><span>4</span> Personalizando Rutas de Recursos</a></h2><p>Si bien las rutas y helpers predeterminados generados por <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Resources.html#method-i-resources"><code>resources</code></a> generalmente te servirán bien, es posible que desees personalizarlos de alguna manera. Rails te permite personalizar prácticamente cualquier parte genérica de los helpers de recursos.</p><h3 id="especificando-un-controlador-a-usar"><a class="anchorlink" href="#especificando-un-controlador-a-usar"><span>4.1</span> Especificando un Controlador a Usar</a></h3><p>La opción <code>:controller</code> te permite especificar explícitamente un controlador para usar con el recurso. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span><span class="p">,</span> <span class="ss">controller: </span><span class="s1">'images'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos, controller: 'images'
">Copy</button>
</div>
<p>reconocerá rutas entrantes que comiencen con <code>/photos</code> pero enrutará al controlador <code>Images</code>:</p>
<table><thead>
<tr>
<th>Verbo HTTP</th>
<th>Ruta</th>
<th>Controlador#Acción</th>
<th>Helper de Ruta Nombrada</th>
</tr>
</thead><tbody>
<tr>
<td>GET</td>
<td>/photos</td>
<td>images#index</td>
<td>photos_path</td>
</tr>
<tr>
<td>GET</td>
<td>/photos/new</td>
<td>images#new</td>
<td>new_photo_path</td>
</tr>
<tr>
<td>POST</td>
<td>/photos</td>
<td>images#create</td>
<td>photos_path</td>
</tr>
<tr>
<td>GET</td>
<td>/photos/:id</td>
<td>images#show</td>
<td>photo_path(:id)</td>
</tr>
<tr>
<td>GET</td>
<td>/photos/:id/edit</td>
<td>images#edit</td>
<td>edit_photo_path(:id)</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/photos/:id</td>
<td>images#update</td>
<td>photo_path(:id)</td>
</tr>
<tr>
<td>DELETE</td>
<td>/photos/:id</td>
<td>images#destroy</td>
<td>photo_path(:id)</td>
</tr>
</tbody></table>
<p>NOTA: Usa <code>photos_path</code>, <code>new_photo_path</code>, etc. para generar rutas para este recurso.</p><p>Para controladores en un namespace, puedes usar la notación de directorio. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:user_permissions</span><span class="p">,</span> <span class="ss">controller: </span><span class="s1">'admin/user_permissions'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :user_permissions, controller: 'admin/user_permissions'
">Copy</button>
</div>
<p>Esto enrutará al controlador <code>Admin::UserPermissions</code>.</p><p>NOTA: Solo se admite la notación de directorio. Especificar el controlador con la notación de constante Ruby (por ejemplo, <code>controller: 'Admin::UserPermissions'</code>) puede llevar a problemas de enrutamiento y resulta en una advertencia.</p><h3 id="especificando-restricciones"><a class="anchorlink" href="#especificando-restricciones"><span>4.2</span> Especificando Restricciones</a></h3><p>Puedes usar la opción <code>:constraints</code> para especificar un formato requerido en el <code>id</code> implícito. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span><span class="p">,</span> <span class="ss">constraints: </span><span class="p">{</span> <span class="ss">id: </span><span class="sr">/[A-Z][A-Z][0-9]+/</span> <span class="p">}</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos, constraints: { id: /[A-Z][A-Z][0-9]+/ }
">Copy</button>
</div>
<p>Esta declaración restringe el parámetro <code>:id</code> para que coincida con la expresión regular suministrada. Entonces, en este caso, el router ya no coincidiría con <code>/photos/1</code> para esta ruta. En su lugar, <code>/photos/RR27</code> coincidiría.</p><p>Puedes especificar una sola restricción para aplicar a varias rutas usando la forma de bloque:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">constraints</span><span class="p">(</span><span class="ss">id: </span><span class="sr">/[A-Z][A-Z][0-9]+/</span><span class="p">)</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:photos</span>
  <span class="n">resources</span> <span class="ss">:accounts</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="constraints(id: /[A-Z][A-Z][0-9]+/) do
  resources :photos
  resources :accounts
end
">Copy</button>
</div>
<p>NOTA: Por supuesto, puedes usar las restricciones más avanzadas disponibles en rutas no-resursivas en este contexto.</p><p>CONSEJO: Por defecto, el parámetro <code>:id</code> no acepta puntos - esto se debe a que el punto se usa como un separador para rutas con formato. Si necesitas usar un punto dentro de un <code>:id</code>, agrega una restricción que anule esto - por ejemplo, <code>id: /[^\/]+/</code> permite cualquier cosa excepto una barra.</p><h3 id="anulando-los-helpers-de-ruta-nombrada"><a class="anchorlink" href="#anulando-los-helpers-de-ruta-nombrada"><span>4.3</span> Anulando los Helpers de Ruta Nombrada</a></h3><p>La opción <code>:as</code> te permite anular la nomenclatura normal para los helpers de ruta nombrada. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span><span class="p">,</span> <span class="ss">as: </span><span class="s1">'images'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos, as: 'images'
">Copy</button>
</div>
<p>reconocerá rutas entrantes que comiencen con <code>/photos</code> y enrutará las solicitudes al <code>PhotosController</code>, pero usará el valor de la opción <code>:as</code> para nombrar los helpers.</p>
<table><thead>
<tr>
<th>Verbo HTTP</th>
<th>Ruta</th>
<th>Controlador#Acción</th>
<th>Helper de Ruta Nombrada</th>
</tr>
</thead><tbody>
<tr>
<td>GET</td>
<td>/photos</td>
<td>photos#index</td>
<td>images_path</td>
</tr>
<tr>
<td>GET</td>
<td>/photos/new</td>
<td>photos#new</td>
<td>new_image_path</td>
</tr>
<tr>
<td>POST</td>
<td>/photos</td>
<td>photos#create</td>
<td>images_path</td>
</tr>
<tr>
<td>GET</td>
<td>/photos/:id</td>
<td>photos#show</td>
<td>image_path(:id)</td>
</tr>
<tr>
<td>GET</td>
<td>/photos/:id/edit</td>
<td>photos#edit</td>
<td>edit_image_path(:id)</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/photos/:id</td>
<td>photos#update</td>
<td>image_path(:id)</td>
</tr>
<tr>
<td>DELETE</td>
<td>/photos/:id</td>
<td>photos#destroy</td>
<td>image_path(:id)</td>
</tr>
</tbody></table>
<h3 id="anulando-los-segmentos-new-y-edit"><a class="anchorlink" href="#anulando-los-segmentos-new-y-edit"><span>4.4</span> Anulando los Segmentos <code>new</code> y <code>edit</code></a></h3><p>La opción <code>:path_names</code> te permite anular los segmentos <code>new</code> y <code>edit</code> generados automáticamente en las rutas:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span><span class="p">,</span> <span class="ss">path_names: </span><span class="p">{</span> <span class="ss">new: </span><span class="s1">'make'</span><span class="p">,</span> <span class="ss">edit: </span><span class="s1">'change'</span> <span class="p">}</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos, path_names: { new: 'make', edit: 'change' }
">Copy</button>
</div>
<p>Esto haría que el enrutamiento reconozca rutas como:</p><div class="interstitial code">
<pre><code class="highlight plaintext">/photos/make
/photos/1/change
</code></pre>
<button class="clipboard-button" data-clipboard-text="/photos/make
/photos/1/change
">Copy</button>
</div>
<p>NOTA: Los nombres de acción reales no se cambian con esta opción. Las dos rutas mostradas todavía enrutarían a las acciones <code>new</code> y <code>edit</code>.</p><p>CONSEJO: Si te encuentras queriendo cambiar esta opción de manera uniforme para todas tus rutas, puedes usar un scope, como a continuación:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">scope</span> <span class="ss">path_names: </span><span class="p">{</span> <span class="ss">new: </span><span class="s1">'make'</span> <span class="p">}</span> <span class="k">do</span>
  <span class="c1"># resto de tus rutas</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="scope path_names: { new: 'make' } do
  # resto de tus rutas
end
">Copy</button>
</div>
<h3 id="prefijando-los-helpers-de-ruta-nombrada"><a class="anchorlink" href="#prefijando-los-helpers-de-ruta-nombrada"><span>4.5</span> Prefijando los Helpers de Ruta Nombrada</a></h3><p>Puedes usar la opción <code>:as</code> para prefijar los helpers de ruta nombrada que Rails genera para una ruta. Usa esta opción para evitar colisiones de nombres entre rutas usando un scope de ruta. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">scope</span> <span class="s1">'admin'</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:photos</span><span class="p">,</span> <span class="ss">as: </span><span class="s1">'admin_photos'</span>
<span class="k">end</span>

<span class="n">resources</span> <span class="ss">:photos</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="scope 'admin' do
  resources :photos, as: 'admin_photos'
end

resources :photos
">Copy</button>
</div>
<p>Esto cambia los helpers de ruta para <code>/admin/photos</code> de <code>photos_path</code>, <code>new_photos_path</code>, etc. a <code>admin_photos_path</code>, <code>new_admin_photo_path</code>, etc. Sin la adición de <code>as: 'admin_photos'</code> en el recurso <code>resources :photos</code> con scope, los recursos no con scope no tendrán ningún helper de ruta.</p><p>Para prefijar un grupo de helpers de ruta, usa <code>:as</code> con <code>scope</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">scope</span> <span class="s1">'admin'</span><span class="p">,</span> <span class="ss">as: </span><span class="s1">'admin'</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:photos</span><span class="p">,</span> <span class="ss">:accounts</span>
<span class="k">end</span>

<span class="n">resources</span> <span class="ss">:photos</span><span class="p">,</span> <span class="ss">:accounts</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="scope 'admin', as: 'admin' do
  resources :photos, :accounts
end

resources :photos, :accounts
">Copy</button>
</div>
<p>Al igual que antes, esto cambia los helpers de recurso con scope <code>/admin</code> a <code>admin_photos_path</code> y <code>admin_accounts_path</code>, y permite que los recursos sin scope usen <code>photos_path</code> y <code>accounts_path</code>.</p><p>NOTA: El scope <code>namespace</code> agregará automáticamente prefijos <code>:as</code> así como prefijos de <code>:module</code> y <code>:path</code>.</p><h4 id="scopes-paramétricos"><a class="anchorlink" href="#scopes-paramétricos"><span>4.5.1</span> Scopes Paramétricos</a></h4><p>Puedes prefijar rutas con un parámetro nombrado:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">scope</span> <span class="s1">':account_id'</span><span class="p">,</span> <span class="ss">as: </span><span class="s1">'account'</span><span class="p">,</span> <span class="ss">constraints: </span><span class="p">{</span> <span class="ss">account_id: </span><span class="sr">/\d+/</span> <span class="p">}</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:articles</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="scope ':account_id', as: 'account', constraints: { account_id: /\d+/ } do
  resources :articles
end
">Copy</button>
</div>
<p>Esto te proporcionará rutas como <code>/1/articles/9</code> y te permitirá referenciar la parte <code>account_id</code> de la ruta como <code>params[:account_id]</code> en controladores, helpers y vistas.</p><p>También generará helpers de ruta y URL prefijados con <code>account_</code>, en los que puedes pasar tus objetos como se espera:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">account_article_path</span><span class="p">(</span><span class="vi">@account</span><span class="p">,</span> <span class="vi">@article</span><span class="p">)</span> <span class="c1"># =&gt; /1/article/9</span>
<span class="n">url_for</span><span class="p">([</span><span class="vi">@account</span><span class="p">,</span> <span class="vi">@article</span><span class="p">])</span>            <span class="c1"># =&gt; /1/article/9</span>
<span class="n">form_with</span><span class="p">(</span><span class="ss">model: </span><span class="p">[</span><span class="vi">@account</span><span class="p">,</span> <span class="vi">@article</span><span class="p">])</span>   <span class="c1"># =&gt; &lt;form action="/1/article/9" ...&gt;</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="account_article_path(@account, @article) # => /1/article/9
url_for([@account, @article])            # => /1/article/9
form_with(model: [@account, @article])   # => <form action=&quot;/1/article/9&quot; ...>
">Copy</button>
</div>
<p>Estamos <a href="#restringiendo-las-rutas-creadas">usando una restricción</a> para limitar el scope para que coincida solo con cadenas similares a IDs. Puedes cambiar la restricción para adaptarla a tus necesidades, o omitirla por completo. La opción <code>:as</code> tampoco es estrictamente necesaria, pero sin ella, Rails generará un error al evaluar <code>url_for([@account, @article])</code> u otros helpers que dependen de <code>url_for</code>, como <a href="https://edgeapi.rubyonrails.org/classes/ActionView/Helpers/FormHelper.html#method-i-form_with"><code>form_with</code></a>.</p><h3 id="restringiendo-las-rutas-creadas"><a class="anchorlink" href="#restringiendo-las-rutas-creadas"><span>4.6</span> Restringiendo las Rutas Creadas</a></h3><p>Por defecto, Rails crea rutas para las siete acciones predeterminadas (<code>index</code>, <code>show</code>, <code>new</code>, <code>create</code>, <code>edit</code>, <code>update</code> y <code>destroy</code>) para cada ruta RESTful en tu aplicación. Puedes usar las opciones <code>:only</code> y <code>:except</code> para afinar este comportamiento. La opción <code>:only</code> le dice a Rails que cree solo las rutas especificadas:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span><span class="p">,</span> <span class="ss">only: </span><span class="p">[</span><span class="ss">:index</span><span class="p">,</span> <span class="ss">:show</span><span class="p">]</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos, only: [:index, :show]
">Copy</button>
</div>
<p>Ahora, una solicitud <code>GET</code> a <code>/photos</code> tendría éxito, pero una solicitud <code>POST</code> a <code>/photos</code> (que normalmente se enviaría a la acción <code>create</code>) fallará.</p><p>La opción <code>:except</code> especifica una ruta o lista de rutas que Rails <em>no</em> debería crear:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:photos</span><span class="p">,</span> <span class="ss">except: :destroy</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :photos, except: :destroy
">Copy</button>
</div>
<p>En este caso, Rails creará todas las rutas normales excepto la ruta para <code>destroy</code> (una solicitud <code>DELETE</code> a <code>/photos/:id</code>).</p><p>CONSEJO: Si tu aplicación tiene muchas rutas RESTful, usar <code>:only</code> y <code>:except</code> para generar solo las rutas que realmente necesitas puede reducir el uso de memoria y acelerar el proceso de enrutamiento.</p><h3 id="rutas-traducidas"><a class="anchorlink" href="#rutas-traducidas"><span>4.7</span> Rutas Traducidas</a></h3><p>Usando <code>scope</code>, podemos alterar los nombres de ruta generados por <code>resources</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">scope</span><span class="p">(</span><span class="ss">path_names: </span><span class="p">{</span> <span class="ss">new: </span><span class="s1">'neu'</span><span class="p">,</span> <span class="ss">edit: </span><span class="s1">'bearbeiten'</span> <span class="p">})</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:categories</span><span class="p">,</span> <span class="ss">path: </span><span class="s1">'kategorien'</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="scope(path_names: { new: 'neu', edit: 'bearbeiten' }) do
  resources :categories, path: 'kategorien'
end
">Copy</button>
</div>
<p>Rails ahora crea rutas para el <code>CategoriesController</code>.</p>
<table><thead>
<tr>
<th>Verbo HTTP</th>
<th>Ruta</th>
<th>Controlador#Acción</th>
<th>Helper de Ruta Nombrada</th>
</tr>
</thead><tbody>
<tr>
<td>GET</td>
<td>/kategorien</td>
<td>categories#index</td>
<td>categories_path</td>
</tr>
<tr>
<td>GET</td>
<td>/kategorien/neu</td>
<td>categories#new</td>
<td>new_category_path</td>
</tr>
<tr>
<td>POST</td>
<td>/kategorien</td>
<td>categories#create</td>
<td>categories_path</td>
</tr>
<tr>
<td>GET</td>
<td>/kategorien/:id</td>
<td>categories#show</td>
<td>category_path(:id)</td>
</tr>
<tr>
<td>GET</td>
<td>/kategorien/:id/bearbeiten</td>
<td>categories#edit</td>
<td>edit_category_path(:id)</td>
</tr>
<tr>
<td>PATCH/PUT</td>
<td>/kategorien/:id</td>
<td>categories#update</td>
<td>category_path(:id)</td>
</tr>
<tr>
<td>DELETE</td>
<td>/kategorien/:id</td>
<td>categories#destroy</td>
<td>category_path(:id)</td>
</tr>
</tbody></table>
<h3 id="anulando-la-forma-singular"><a class="anchorlink" href="#anulando-la-forma-singular"><span>4.8</span> Anulando la Forma Singular</a></h3><p>Si deseas anular la forma singular de un recurso, debes agregar reglas adicionales al inflector a través de <a href="https://edgeapi.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-inflections"><code>inflections</code></a>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="no">ActiveSupport</span><span class="o">::</span><span class="no">Inflector</span><span class="p">.</span><span class="nf">inflections</span> <span class="k">do</span> <span class="o">|</span><span class="n">inflect</span><span class="o">|</span>
  <span class="n">inflect</span><span class="p">.</span><span class="nf">irregular</span> <span class="s1">'tooth'</span><span class="p">,</span> <span class="s1">'teeth'</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="ActiveSupport::Inflector.inflections do |inflect|
  inflect.irregular 'tooth', 'teeth'
end
">Copy</button>
</div>
<h3 id="usando-as-en-recursos-anidados"><a class="anchorlink" href="#usando-as-en-recursos-anidados"><span>4.9</span> Usando <code>:as</code> en Recursos Anidados</a></h3><p>La opción <code>:as</code> anula el nombre generado automáticamente para el recurso en los helpers de ruta anidada. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:magazines</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:ads</span><span class="p">,</span> <span class="ss">as: </span><span class="s1">'periodical_ads'</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :magazines do
  resources :ads, as: 'periodical_ads'
end
">Copy</button>
</div>
<p>Esto creará helpers de ruta como <code>magazine_periodical_ads_url</code> y <code>edit_magazine_periodical_ad_path</code>.</p><h3 id="anulando-parámetros-de-ruta-nombrados"><a class="anchorlink" href="#anulando-parámetros-de-ruta-nombrados"><span>4.10</span> Anulando Parámetros de Ruta Nombrados</a></h3><p>La opción <code>:param</code> anula el identificador de recurso predeterminado <code>:id</code> (nombre del <a href="routing.html#dynamic-segments">segmento dinámico</a> utilizado para generar las rutas). Puedes acceder a ese segmento desde tu controlador usando <code>params[&lt;:param&gt;]</code>.</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">resources</span> <span class="ss">:videos</span><span class="p">,</span> <span class="ss">param: :identifier</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="resources :videos, param: :identifier
">Copy</button>
</div>
<div class="interstitial code">
<pre><code class="highlight plaintext">    videos GET  /videos(.:format)                  videos#index
           POST /videos(.:format)                  videos#create
 new_video GET  /videos/new(.:format)              videos#new
edit_video GET  /videos/:identifier/edit(.:format) videos#edit
</code></pre>
<button class="clipboard-button" data-clipboard-text="    videos GET  /videos(.:format)                  videos#index
           POST /videos(.:format)                  videos#create
 new_video GET  /videos/new(.:format)              videos#new
edit_video GET  /videos/:identifier/edit(.:format) videos#edit
">Copy</button>
</div>
<div class="interstitial code">
<pre><code class="highlight ruby"><span class="no">Video</span><span class="p">.</span><span class="nf">find_by</span><span class="p">(</span><span class="ss">identifier: </span><span class="n">params</span><span class="p">[</span><span class="ss">:identifier</span><span class="p">])</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="Video.find_by(identifier: params[:identifier])
">Copy</button>
</div>
<p>Puedes anular <code>ActiveRecord::Base#to_param</code> del modelo asociado para construir una URL:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="k">class</span> <span class="nc">Video</span> <span class="o">&lt;</span> <span class="no">ApplicationRecord</span>
  <span class="k">def</span> <span class="nf">to_param</span>
    <span class="n">identifier</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="class Video < ApplicationRecord
  def to_param
    identifier
  end
end
">Copy</button>
</div>
<div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">video</span> <span class="o">=</span> <span class="no">Video</span><span class="p">.</span><span class="nf">find_by</span><span class="p">(</span><span class="ss">identifier: </span><span class="s2">"Roman-Holiday"</span><span class="p">)</span>
<span class="n">edit_video_path</span><span class="p">(</span><span class="n">video</span><span class="p">)</span> <span class="c1"># =&gt; "/videos/Roman-Holiday/edit"</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="video = Video.find_by(identifier: &quot;Roman-Holiday&quot;)
edit_video_path(video) # => &quot;/videos/Roman-Holiday/edit&quot;
">Copy</button>
</div>
<h2 id="dividiendo-un-archivo-de-rutas-muy-grande-en-múltiples-archivos-pequeños"><a class="anchorlink" href="#dividiendo-un-archivo-de-rutas-muy-grande-en-múltiples-archivos-pequeños"><span>5</span> Dividiendo un Archivo de Rutas <em>Muy</em> Grande en Múltiples Archivos Pequeños</a></h2><p>Si trabajas en una aplicación grande con miles de rutas, un solo archivo <code>config/routes.rb</code> puede volverse engorroso y difícil de leer.</p><p>Rails ofrece una forma de dividir un archivo único gigantesco de <code>routes.rb</code> en múltiples archivos pequeños usando la macro <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Resources.html#method-i-draw"><code>draw</code></a>.</p><p>Podrías tener una ruta <code>admin.rb</code> que contenga todas las rutas para el área de administración, otro archivo <code>api.rb</code> para recursos relacionados con la API, etc.</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="c1"># config/routes.rb</span>

<span class="no">Rails</span><span class="p">.</span><span class="nf">application</span><span class="p">.</span><span class="nf">routes</span><span class="p">.</span><span class="nf">draw</span> <span class="k">do</span>
  <span class="n">get</span> <span class="s1">'foo'</span><span class="p">,</span> <span class="ss">to: </span><span class="s1">'foo#bar'</span>

  <span class="n">draw</span><span class="p">(</span><span class="ss">:admin</span><span class="p">)</span> <span class="c1"># Cargará otro archivo de ruta ubicado en `config/routes/admin.rb`</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="
Rails.application.routes.draw do
  get 'foo', to: 'foo#bar'

  draw(:admin) # Cargará otro archivo de ruta ubicado en `config/routes/admin.rb`
end
">Copy</button>
</div>
<div class="interstitial code">
<pre><code class="highlight ruby"><span class="c1"># config/routes/admin.rb</span>

<span class="n">namespace</span> <span class="ss">:admin</span> <span class="k">do</span>
  <span class="n">resources</span> <span class="ss">:comments</span>
<span class="k">end</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="
namespace :admin do
  resources :comments
end
">Copy</button>
</div>
<p>Llamar a <code>draw(:admin)</code> dentro del bloque <code>Rails.application.routes.draw</code> intentará cargar un archivo de ruta que tenga el mismo nombre que el argumento dado (<code>admin.rb</code> en este ejemplo). El archivo debe estar ubicado dentro del directorio <code>config/routes</code> o cualquier subdirectorio (es decir, <code>config/routes/admin.rb</code> o <code>config/routes/external/admin.rb</code>).</p><p>Puedes usar el DSL de enrutamiento normal dentro del archivo de enrutamiento <code>admin.rb</code>, pero <strong>no deberías</strong> rodearlo con el bloque <code>Rails.application.routes.draw</code> como lo hiciste en el archivo principal <code>config/routes.rb</code>.</p><h3 id="no-uses-esta-función-a-menos-que-realmente-la-necesites"><a class="anchorlink" href="#no-uses-esta-función-a-menos-que-realmente-la-necesites"><span>5.1</span> No Uses Esta Función a Menos que Realmente la Necesites</a></h3><p>Tener múltiples archivos de enrutamiento hace que la descubribilidad y comprensión sean más difíciles. Para la mayoría de las aplicaciones, incluso aquellas con algunas centenas de rutas, es más fácil para los desarrolladores tener un solo archivo de enrutamiento. El DSL de enrutamiento de Rails ya ofrece una forma de organizar rutas de manera organizada con <code>namespace</code> y <code>scope</code>.</p><h2 id="inspeccionando-y-probando-rutas"><a class="anchorlink" href="#inspeccionando-y-probando-rutas"><span>6</span> Inspeccionando y Probando Rutas</a></h2><p>Rails ofrece facilidades para inspeccionar y probar tus rutas.</p><h3 id="listando-rutas-existentes"><a class="anchorlink" href="#listando-rutas-existentes"><span>6.1</span> Listando Rutas Existentes</a></h3><p>Para obtener una lista completa de las rutas disponibles en tu aplicación, visita <a href="http://localhost:3000/rails/info/routes">http://localhost:3000/rails/info/routes</a> en tu navegador mientras tu servidor está funcionando en el entorno de <strong>desarrollo</strong>. También puedes ejecutar el comando <code>bin/rails routes</code> en tu terminal para producir la misma salida.</p><p>Ambos métodos enumerarán todas tus rutas, en el mismo orden en que aparecen en <code>config/routes.rb</code>. Para cada ruta, verás:</p>
<ul>
<li>El nombre de la ruta (si lo hay)</li>
<li>El verbo HTTP usado (si la ruta no responde a todos los verbos)</li>
<li>El patrón de URL a coincidir</li>
<li>Los parámetros de enrutamiento para la ruta</li>
</ul>
<p>Por ejemplo, aquí hay una pequeña sección de la salida <code>bin/rails routes</code> para una ruta RESTful:</p><div class="interstitial code">
<pre><code class="highlight plaintext">    users GET    /users(.:format)          users#index
          POST   /users(.:format)          users#create
 new_user GET    /users/new(.:format)      users#new
edit_user GET    /users/:id/edit(.:format) users#edit
</code></pre>
<button class="clipboard-button" data-clipboard-text="    users GET    /users(.:format)          users#index
          POST   /users(.:format)          users#create
 new_user GET    /users/new(.:format)      users#new
edit_user GET    /users/:id/edit(.:format) users#edit
">Copy</button>
</div>
<p>También puedes usar la opción <code>--expanded</code> para activar el modo de formato de tabla expandida.</p><div class="interstitial code">
<pre><code class="highlight console"><span class="gp">$</span><span class="w"> </span><span class="nb">bin/rails </span>routes <span class="nt">--expanded</span>
<span class="go">
--[ Route 1 ]----------------------------------------------------
Prefix            | users
Verb              | GET
URI               | /users(.:format)
</span><span class="gp">Controller#</span>Action | <span class="nb">users</span><span class="c">#index</span>
<span class="go">--[ Route 2 ]----------------------------------------------------
Prefix            |
Verb              | POST
URI               | /users(.:format)
</span><span class="gp">Controller#</span>Action | <span class="nb">users</span><span class="c">#create</span>
<span class="go">--[ Route 3 ]----------------------------------------------------
Prefix            | new_user
Verb              | GET
URI               | /users/new(.:format)
</span><span class="gp">Controller#</span>Action | <span class="nb">users</span><span class="c">#new</span>
<span class="go">--[ Route 4 ]----------------------------------------------------
Prefix            | edit_user
Verb              | GET
URI               | /users/:id/edit(.:format)
</span><span class="gp">Controller#</span>Action | <span class="nb">users</span><span class="c">#edit</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="bin/rails routes --expanded
">Copy</button>
</div>
<p>Puedes buscar a través de tus rutas con la opción grep: -g. Esto genera cualquier ruta que coincida parcialmente con el nombre del método helper de URL, el verbo HTTP o la ruta URL.</p><div class="interstitial code">
<pre><code class="highlight console"><span class="gp">$</span><span class="w"> </span><span class="nb">bin/rails </span>routes <span class="nt">-g</span> new_comment
<span class="gp">$</span><span class="w"> </span><span class="nb">bin/rails </span>routes <span class="nt">-g</span> POST
<span class="gp">$</span><span class="w"> </span><span class="nb">bin/rails </span>routes <span class="nt">-g</span> admin
</code></pre>
<button class="clipboard-button" data-clipboard-text="bin/rails routes -g new_comment
bin/rails routes -g POST
bin/rails routes -g admin
">Copy</button>
</div>
<p>Si solo deseas ver las rutas que mapean a un controlador específico, existe la opción -c.</p><div class="interstitial code">
<pre><code class="highlight console"><span class="gp">$</span><span class="w"> </span><span class="nb">bin/rails </span>routes <span class="nt">-c</span> <span class="nb">users</span>
<span class="gp">$</span><span class="w"> </span><span class="nb">bin/rails </span>routes <span class="nt">-c</span> admin/users
<span class="gp">$</span><span class="w"> </span><span class="nb">bin/rails </span>routes <span class="nt">-c</span> Comments
<span class="gp">$</span><span class="w"> </span><span class="nb">bin/rails </span>routes <span class="nt">-c</span> Articles::CommentsController
</code></pre>
<button class="clipboard-button" data-clipboard-text="bin/rails routes -c users
bin/rails routes -c admin/users
bin/rails routes -c Comments
bin/rails routes -c Articles::CommentsController
">Copy</button>
</div>
<p>CONSEJO: Encontrarás que la salida de <code>bin/rails routes</code> es mucho más legible si amplías la ventana de tu terminal hasta que las líneas de salida no se envuelvan.</p><h3 id="probando-rutas"><a class="anchorlink" href="#probando-rutas"><span>6.2</span> Probando Rutas</a></h3><p>Las rutas deben estar incluidas en tu estrategia de pruebas (al igual que el resto de tu aplicación). Rails ofrece tres afirmaciones integradas diseñadas para hacer que probar rutas sea más simple:</p>
<ul>
<li><a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Assertions/RoutingAssertions.html#method-i-assert_generates"><code>assert_generates</code></a></li>
<li><a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Assertions/RoutingAssertions.html#method-i-assert_recognizes"><code>assert_recognizes</code></a></li>
<li><a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Assertions/RoutingAssertions.html#method-i-assert_routing"><code>assert_routing</code></a></li>
</ul>
<h4 id="la-afirmación-assert-generates"><a class="anchorlink" href="#la-afirmación-assert-generates"><span>6.2.1</span> La Afirmación <code>assert_generates</code></a></h4><p><a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Assertions/RoutingAssertions.html#method-i-assert_generates"><code>assert_generates</code></a> afirma que un conjunto particular de opciones genera una ruta particular y puede usarse con rutas predeterminadas o rutas personalizadas. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">assert_generates</span> <span class="s1">'/photos/1'</span><span class="p">,</span> <span class="p">{</span> <span class="ss">controller: </span><span class="s1">'photos'</span><span class="p">,</span> <span class="ss">action: </span><span class="s1">'show'</span><span class="p">,</span> <span class="ss">id: </span><span class="s1">'1'</span> <span class="p">}</span>
<span class="n">assert_generates</span> <span class="s1">'/about'</span><span class="p">,</span> <span class="ss">controller: </span><span class="s1">'pages'</span><span class="p">,</span> <span class="ss">action: </span><span class="s1">'about'</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="assert_generates '/photos/1', { controller: 'photos', action: 'show', id: '1' }
assert_generates '/about', controller: 'pages', action: 'about'
">Copy</button>
</div>
<h4 id="la-afirmación-assert-recognizes"><a class="anchorlink" href="#la-afirmación-assert-recognizes"><span>6.2.2</span> La Afirmación <code>assert_recognizes</code></a></h4><p><a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Assertions/RoutingAssertions.html#method-i-assert_recognizes"><code>assert_recognizes</code></a> es el inverso de <code>assert_generates</code>. Afirma que una ruta dada es reconocida y la enruta a un lugar particular en tu aplicación. Por ejemplo:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">assert_recognizes</span><span class="p">({</span> <span class="ss">controller: </span><span class="s1">'photos'</span><span class="p">,</span> <span class="ss">action: </span><span class="s1">'show'</span><span class="p">,</span> <span class="ss">id: </span><span class="s1">'1'</span> <span class="p">},</span> <span class="s1">'/photos/1'</span><span class="p">)</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="assert_recognizes({ controller: 'photos', action: 'show', id: '1' }, '/photos/1')
">Copy</button>
</div>
<p>Puedes suministrar un argumento <code>:method</code> para especificar el verbo HTTP:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">assert_recognizes</span><span class="p">({</span> <span class="ss">controller: </span><span class="s1">'photos'</span><span class="p">,</span> <span class="ss">action: </span><span class="s1">'create'</span> <span class="p">},</span> <span class="p">{</span> <span class="ss">path: </span><span class="s1">'photos'</span><span class="p">,</span> <span class="ss">method: :post</span> <span class="p">})</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="assert_recognizes({ controller: 'photos', action: 'create' }, { path: 'photos', method: :post })
">Copy</button>
</div>
<h4 id="la-afirmación-assert-routing"><a class="anchorlink" href="#la-afirmación-assert-routing"><span>6.2.3</span> La Afirmación <code>assert_routing</code></a></h4><p>La afirmación <a href="https://edgeapi.rubyonrails.org/classes/ActionDispatch/Assertions/RoutingAssertions.html#method-i-assert_routing"><code>assert_routing</code></a> verifica la ruta en ambos sentidos: prueba que la ruta genera las opciones, y que las opciones generan la ruta. Por lo tanto, combina las funciones de <code>assert_generates</code> y <code>assert_recognizes</code>:</p><div class="interstitial code">
<pre><code class="highlight ruby"><span class="n">assert_routing</span><span class="p">({</span> <span class="ss">path: </span><span class="s1">'photos'</span><span class="p">,</span> <span class="ss">method: :post</span> <span class="p">},</span> <span class="p">{</span> <span class="ss">controller: </span><span class="s1">'photos'</span><span class="p">,</span> <span class="ss">action: </span><span class="s1">'create'</span> <span class="p">})</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="assert_routing({ path: 'photos', method: :post }, { controller: 'photos', action: 'create' })
">Copy</button>
</div>

        <hr>
        <h3>Comentarios</h3>
        <p>
          Se te anima a ayudar a mejorar la calidad de esta guía.
        </p>
        <p>
          Por favor contribuye si ves algún error tipográfico o errores fácticos.
          Para comenzar, puedes leer nuestra sección de <a href="https://edgeguides.rubyonrails.org/contributing_to_ruby_on_rails.html#contributing-to-the-rails-documentation">contribuciones a la documentación</a>.
        </p>
        <p>
          También puedes encontrar contenido incompleto o cosas que no están actualizadas.
          Por favor agrega cualquier documentación faltante para main. Asegúrate de revisar
          <a href="https://edgeguides.rubyonrails.org">Guías Edge</a> primero para verificar
          si los problemas ya están resueltos o no en la rama principal.
          Revisa las <a href="ruby_on_rails_guides_guidelines.html">Guías de Ruby on Rails</a>
          para estilo y convenciones.
        </p>
        <p>
          Si por alguna razón detectas algo que corregir pero no puedes hacerlo tú mismo, por favor
          <a href="https://github.com/rails/rails/issues">abre un issue</a>.
        </p>
        <p>Y por último, pero no menos importante, cualquier tipo de discusión sobre la
          documentación de Ruby on Rails es muy bienvenida en el <a href="https://discuss.rubyonrails.org/c/rubyonrails-docs">Foro oficial de Ruby on Rails</a>.
        </p>
      </div>
    </div>
  </main>

  <hr class="hide" />
  <footer id="page_footer">
    <div class="wrapper">
      <p>Este trabajo está bajo una <a href="https://creativecommons.org/licenses/by-sa/4.0/">Licencia Creative Commons Atribución-CompartirIgual 4.0 Internacional</a></p>
<p>"Rails", "Ruby on Rails" y el logotipo de Rails son marcas registradas de David Heinemeier Hansson. Todos los derechos reservados.</p>

<p>  Esta traducción fue generada por openAi e <a href="http://latinadeveloper.com/">Isis Harris.</a></p>
    </div>
  </footer>
</body>
</html>