[Introduction] Créer une application Ruby on Rails

introduction

Je viens de faire mes débuts dans Ruby on Rails au travail l'autre jour. Quand il s'agit de Rails, j'ai eu l'impression qu'un service Web avec affichage à l'écran a été créé, mais au travail, l'API a été créée avec Rails. Donc, ici, je vais essayer à la fois de créer un service Web et une API.

environnement

Windows 10 Famille 64 bits

• Pour la construction de l'environnement, consultez «Installation de Ruby on Rails (Windows10)».

Comment fonctionne Rails

Rails fonctionne avec un mécanisme basé sur le modèle MVC. MVC provient des acronymes «Model», «View» et «Controller», respectivement, et est souvent utilisé lors du développement d'applications avec Rails.

• Pour plus de détails sur MVC, voir «Ruby on Rails - Modèle MVC et architecture REST».

Création de service Web

Créez un écran Web qui affiche le "Hello World" qui est habituel pour les débutants.

1. 1. Créer un nouveau projet

Exécutez la commande suivante pour créer un nouveau projet pour le service Web.

Ligne de commande

rails nouveau nom d'application

* À propos de la structure des dossiers

La structure des dossiers sous le dossier de l'application se trouve dans Rails Document. Vous pouvez le vérifier dans "Qu'est-ce que Ruby on Rails> Structure des dossiers> Liste des dossiers".

2. Créer un contrôleur

Exécutez la commande suivante pour créer le contrôleur. Lors de la création d'un contrôleur, accédez au dossier d'application créé précédemment, puis créez-le.

Ligne de commande

dossier d'application cd
les rails génèrent le nom du contrôleur de contrôleur

Le contrôleur "hello_world_controller.rb" a été créé dans le dossier "app / controllers". Le code source au moment de la génération est le suivant.

hello_world_controller.rb

class HelloWorldController < ApplicationController
end

3. 3. Créer une action

La méthode définie dans le contrôleur est appelée une action. Modifiez le "hello_world_controller.rb" créé précédemment et essayez de définir l'action "index".

hello_world_controller.rb

class HelloWorldController < ApplicationController
  def index
  end
end

* Création par lots de contrôleur et d'action

Ici, le contrôleur et l'action ont été créés séparément, mais il est également possible de les créer tous en même temps lors de la création du contrôleur. Pour tout créer en même temps, exécutez la commande suivante.

Ligne de commande

les rails génèrent le contrôleur Nom du contrôleur Nom de l'action 1 Nom de l'action 2...

#Exemple
rails generate controller hoge index create

4. Ajouter une vue

Dans le dossier "app / views / hello_world", ajoutez la vue "index.html.erb" correspondant à l'action d'index.

• Si rien n'est décrit dans l'action, elle est liée par défaut à "app / vue / nom du contrôleur / nom de l'action.html.erb".

Puisqu'il est supposé que "Hello World" sera affiché cette fois, décrivez comme suit dans "index.html.erb".

html:index.html.erb

<h1>Hello World</h1>

5. Ajout des paramètres de routage

Recevez une demande du navigateur et ajoutez un paramètre à distribuer au contrôleur. Le fichier à modifier est "routes.rb" dans le dossier "config".

routes.rb

Rails.application.routes.draw do
  # For details on the DSL available within this file, see https://guides.rubyonrails.org/routing.html
  get '/helloworld', to: 'hello_world#index'
end

Vous pouvez vérifier le format dans "Route Definition" dans Rails Document. Cette fois, j'ai décrit la méthode get correspondant à la requête GET.

6. Démarrer le serveur Rails

Exécutez la commande suivante pour démarrer le serveur Rails.

Ligne de commande

rails s

sept. Vérifiez le fonctionnement depuis le navigateur

Accédez à http: // localhost: 3000 / helloworld.

• "Hello world" dans l'URL est la partie de '/ hello world' définie par get dans "routes.rb". "Hello World" s'affiche en toute sécurité!

Création d'API

Créez une API qui renvoie «Hello World» au format JSON. Le flux général est le même que pour les services Web.

1. 1. Créer un nouveau projet

Exécutez la commande suivante pour créer un nouveau projet API. Ajoutez --api à une commande normale et créez un projet en mode API.

Ligne de commande

rails nouveau nom d'application--api

2. Création de contrôleurs et d'actions

La commande d'exécution est la même que le service Web. Cette fois, créons un contrôleur et une action à la fois. Le nom du contrôleur et le nom de l'action sont les mêmes que pour le service Web. Vous pouvez voir l'effet du mode API lors de la création d'un projet ici. Lorsque vous créez normalement un contrôleur, les fichiers liés aux vues telles que la vue, l'assistant et l'actif sont également créés en même temps, mais ces fichiers ne sont pas créés car l'API ne nécessite pas de vues.

3. 3. Édition du contrôleur

Ajoutez un processus pour renvoyer "Hello World" au format JSON.

hello_world_controller.rb

class HelloWorldController < ApplicationController
  def index
    render json: { data: "Hello World" }
  end
end

4. Modifier les paramètres de routage

En raison de la création par lots de contrôleurs et d'actions, les paramètres de routage sont automatiquement ajoutés, mais modifions-les.

Changer avant_routes.rb

Rails.application.routes.draw do
  get 'hello_world/index'
  # For details on the DSL available within this file, see https://guides.rubyonrails.org/routing.html
end

Après le changement_routes.rb

Rails.application.routes.draw do
  get '/helloworld', to: 'hello_world#index'
  # For details on the DSL available within this file, see https://guides.rubyonrails.org/routing.html
end

5. Démarrer le serveur Rails

Exécutez la commande suivante pour démarrer le serveur Rails.

• Puisqu'un projet de service Web est également créé en parallèle, démarrez le serveur sur un port différent du port par défaut.

Ligne de commande

rails s -p 3001

6. Exécutez la commande curl et vérifiez l'opération

Exécutez la commande suivante et confirmez que JSON est renvoyé.

Ligne de commande

curl --request GET --url http://localhost:3001/helloworld