Genie.jl实战案例：从零开始构建完整电商平台的全过程

【免费下载链接】Genie.jl 🧞The highly productive Julia web framework 项目地址: https://gitcode.com/gh_mirrors/ge/Genie.jl

Genie.jl是一款基于Julia语言的高效Web框架，能够帮助开发者快速构建功能丰富的Web应用。本文将以电商平台为例，详细介绍如何使用Genie.jl从项目初始化到部署上线的完整流程，让你轻松掌握这一强大工具的实战应用。

一、环境准备与项目初始化

要开始构建电商平台，首先需要安装Genie.jl并创建新项目。打开Julia REPL，进入包管理模式安装Genie：

pkg> add Genie

安装完成后，使用Genie的应用生成器创建一个新的MVC应用：

julia> using Genie
julia> Genie.Generator.newapp_mvc("EcommercePlatform")

Genie会自动创建项目结构并安装依赖。过程中会提示选择数据库后端，推荐新手选择SQLite，它无需额外配置即可使用。项目创建完成后，Genie会自动启动开发服务器，访问 http://127.0.0.1:8000 即可看到默认欢迎页面。

二、数据库设计与模型创建

电商平台的核心是产品数据管理，我们需要创建产品相关的数据模型。

配置数据库连接

编辑 db/connection.yml 文件，配置数据库连接信息：

env: ENV["GENIE_ENV"]

dev:
  adapter: SQLite
  database: db/ecommerce.sqlite

然后在REPL中加载数据库配置：

julia> include(joinpath("config", "initializers", "searchlight.jl"))

创建产品资源

使用Genie的资源生成器创建产品模型、控制器和视图：

julia> Genie.Generator.newresource("product")
julia> using SearchLight
julia> SearchLight.Generator.newresource("product")

定义产品表结构

编辑生成的迁移文件（位于 db/migrations/ 目录，文件名以 _create_table_products.jl 结尾），定义产品表结构：

module CreateTableProducts

import SearchLight.Migrations: create_table, column, primary_key, add_index, drop_table

function up()
  create_table(:products) do
    [
      primary_key()
      column(:name, :string, limit = 100)
      column(:description, :string, limit = 1000)
      column(:price, :decimal, precision = 10, scale = 2)
      column(:stock, :integer)
      column(:category, :string, limit = 50)
      column(:image_url, :string, limit = 255)
    ]
  end

  add_index(:products, :name)
  add_index(:products, :category)
end

function down()
  drop_table(:products)
end

end

初始化迁移系统并执行迁移：

julia> SearchLight.Migration.init()
julia> SearchLight.Migration.lastup()

完善产品模型

编辑 app/resources/products/Products.jl 文件，定义产品模型：

module Products

import SearchLight: AbstractModel, DbId
import Base: @kwdef

export Product

@kwdef mutable struct Product <: AbstractModel
  id::DbId = DbId()
  name::String = ""
  description::String = ""
  price::Float64 = 0.0
  stock::Int = 0
  category::String = ""
  image_url::String = ""
end

end

三、构建产品展示与管理功能

创建产品列表页面

首先在 routes.jl 中添加路由：

using EcommercePlatform.ProductsController
route("/products", ProductsController.index)

然后实现控制器逻辑，编辑 app/resources/products/ProductsController.jl：

module ProductsController

using Genie.Renderer.Html, SearchLight, EcommercePlatform.Products

function index()
  products = all(Product)
  html(:products, :index, products = products)
end

end

创建视图文件 app/resources/products/views/index.jl.html：

<h1 class="display-1 text-center">商品列表</h1>

<div class="container">
  <div class="row">
    <% for product in products %>
      <div class="col-md-4 mb-4">
        <div class="card h-100">
          <img src="<% product.image_url %>" class="card-img-top" alt="<% product.name %>">
          <div class="card-body">
            <h5 class="card-title"><% product.name %></h5>
            <p class="card-text"><% product.description %></p>
            <p class="card-text"><strong>价格: ¥<% product.price %></strong></p>
            <p class="card-text"><small class="text-muted">库存: <% product.stock %>件</small></p>
          </div>
          <div class="card-footer">
            <a href="/products/<% product.id %>" class="btn btn-primary">查看详情</a>
          </div>
        </div>
      </div>
    <% end %>
  </div>
</div>

添加搜索功能

在视图中添加搜索表单，修改 index.jl.html：

<div class="container" style="margin-top: 40px;">
  <form action="$( Genie.Router.linkto(:search_products) )">
    <input class="form-control form-control-lg" type="search" name="search_products" placeholder="搜索商品..." />
  </form>
</div>

添加搜索路由和控制器方法：

# routes.jl
route("/products/search", ProductsController.search, named = :search_products)

# ProductsController.jl
function search()
  isempty(strip(params(:search_products))) && redirect("/products")
  
  products = find(Product,
              SQLWhereExpression("name LIKE ? OR description LIKE ? OR category LIKE ?",
                                  repeat(['%' * params(:search_products) * '%'], 3)))
  
  html(:products, :index, products = products)
end

四、实现用户认证与购物车功能

添加用户认证

使用GenieAuthentication插件快速实现用户认证功能：

pkg> add GenieAuthentication
julia> using GenieAuthentication
julia> GenieAuthentication.install(@__DIR__)
julia> SearchLight.Migration.up("CreateTableUsers")

创建管理员用户：

julia> using EcommercePlatform.Users
julia> u = User(email = "admin@example.com", name = "Admin", password = Users.hash_password("password"), username = "admin")
julia> save!(u)

实现购物车功能

创建购物车模型和控制器，实现添加商品到购物车、查看购物车等功能。购物车可以使用Session存储临时数据，或创建数据库表存储持久化购物车信息。

五、优化前端界面

编辑布局文件 app/layouts/app.jl.html，添加Bootstrap等前端资源：

<!DOCTYPE html>
<html lang="zh-CN">
  <head>
    <meta charset="utf-8" />
    <title>Genie电商平台</title>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5/dist/css/bootstrap.min.css" rel="stylesheet">
  </head>
  <body>
    <nav class="navbar navbar-expand-lg navbar-dark bg-dark">
      <div class="container">
        <a class="navbar-brand" href="/">Genie电商</a>
        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
          <span class="navbar-toggler-icon"></span>
        </button>
        <div class="collapse navbar-collapse" id="navbarNav">
          <ul class="navbar-nav">
            <li class="nav-item">
              <a class="nav-link" href="/products">商品列表</a>
            </li>
            <li class="nav-item">
              <a class="nav-link" href="/cart">购物车</a>
            </li>
          </ul>
        </div>
      </div>
    </nav>
    
    <div class="container mt-4">
      <% @yield %>
    </div>
    
    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5/dist/js/bootstrap.bundle.min.js"></script>
  </body>
</html>

六、部署电商平台

使用Docker容器化应用

Genie提供了Docker集成支持，使用GenieDeployDocker插件可以轻松容器化应用：

pkg> add GenieDeployDocker
julia> using GenieDeployDocker
julia> GenieDeployDocker.dockerfile()

生成Dockerfile后，构建并运行容器：

julia> GenieDeployDocker.build()
julia> GenieDeployDocker.run()

部署到云服务器

以AWS为例，首先在AWS控制台创建EC2实例，然后通过SSH连接服务器，执行以下命令部署应用：

git clone https://gitcode.com/gh_mirrors/ge/Genie.jl
cd Genie.jl
julia --project -e 'using Pkg; Pkg.instantiate()'
julia --project -e 'using GenieDeployDocker; GenieDeployDocker.build()'
julia --project -e 'using GenieDeployDocker; GenieDeployDocker.run()'

部署完成后，通过服务器IP地址即可访问电商平台。

七、总结与扩展

通过本文的步骤，我们使用Genie.jl构建了一个基本的电商平台，包括产品展示、搜索、用户认证和购物车等核心功能，并成功部署到云服务器。Genie.jl的MVC架构和丰富的插件系统使得开发过程高效而简洁。

后续可以进一步扩展功能，如添加支付接口、订单管理、用户评价等，Genie.jl的灵活性和可扩展性将为这些功能的实现提供有力支持。

希望本文能帮助你快速掌握Genie.jl的实战应用，开启高效的Julia Web开发之旅！

【免费下载链接】Genie.jl 🧞The highly productive Julia web framework 项目地址: https://gitcode.com/gh_mirrors/ge/Genie.jl