آموزش API First Engineering با Spring Boot

سرفصل ها و درس ها

معرفی Introduction

• معرفی دوره Course Introduction

• معرفی مربی Instructor Introduction

• بیشترین بهره را از دوره خود ببرید Getting the Most Out of Your Course

• تنظیم محیط توسعه شما Setting Up Your Development Environment

• آیا IDE شما مانند یک توله سگ رایگان است؟ Is Your IDE Free Like A Puppy?

• آزمایشی رایگان 120 روزه IntelliJ Ultimate Free 120 Day IntelliJ Ultimate Trial

• اتاق شلوغ دوره - با مربی خود و سایر دانش آموزان گپ بزنید Course Slack Room - Chat with Your Instructor and Other Students

• گردش کار Github Github Workflow

API First چیست؟ What is API First?

• معرفی Introduction

• ابتدا تعریف API Defining API First

• API اول برای سازمان ها API First for Organizations

• API First Best Practices API First Best Practices

• آزمون اول API API First Quiz

اسناد OpenAPI API OpenAPI API Documentation

• معرفی Introduction

• مقدمه ای بر OpenAPI و Redocly Introduction to OpenAPI & Redocly

• مخزن اسناد API را ایجاد کنید Create API Documentation Repository

• به روز رسانی Dependbot GitHub GitHub Dependbot Updates

• شعبه توسعه Github Github Development Branch

• به رجیستری Redocly API اضافه کنید Add to Redocly API Registry

• سفارشی کردن مشخصات API Customize API Specification

• تکلیف - به روز رسانی مشخصات Assignment - Update Specification

طراحی دامنه محور Domain Driven Design

• معرفی Introduction

• طراحی RESTFul API RESTFul API Design

• مقدمه ای بر طراحی دامنه محور Introduction to Domain Driven Design

• بررسی اجمالی طراحی اپلیکیشن Application Design Overview

• افزودن لیست عملیات مشتریان Add List Cutomers Operation

• طرح مشتری کامل Complete Customer Schema

• عملیات دریافت مشتری با شناسه را اضافه کنید Add Get Customer By Id Operation

• واگذاری - عملیات دریافت را برای محصول اضافه کنید Assignment - Add Get Operations for Product

• اضافه کردن سفارش دریافت عملیات Add Order Get Operations

• طرح سفارش ایجاد کنید Create Order Schema

با استفاده از ویژگی های طرحواره OpenAPI Using OpenAPI Schema Attributes

• معرفی Introduction

• محدودیت های طرحواره را به مشتری اضافه کنید Add Schema Constraints to Customer

• افزودن ویژگی های مورد نیاز به مشتری Add Required Properties to Customer

• نمونه هایی را به مشتری اضافه کنید Add Examples to Customer

• ایجاد نقطه پایانی مشتری را تعریف کنید Define Create Customer Endpoint

• علامت گذاری ویژگی های باطل بر روی مشتری Mark Nullable Properties on Customer

• واگذاری محدودیت هایی را به محصول و سفارش اضافه کنید Assignment Add Constraints to Product and Order

• Refactor DateTime to Common Object Refactor DateTime to Common Object

تولید کد OpenAPI با Maven OpenAPI Code Generation with Maven

• معرفی Introduction

• معماری شش ضلعی Hexagonal Architecture

• پروژه New Maven را ایجاد کنید Create New Maven Project

• ایجاد ماژول API و OpenAPI Code Generation Create API Module and OpenAPI Code Generation

• پیکربندی امنیتی Redocly Redocly Security Configuration

• پیکربندی تولید کد Code Generation Configuration

• Maven Dependencies را اضافه کنید Add Maven Dependencies

• اعتبار سنجی Bean را فعال کنید Enable Bean Validation

• تکلیف: بسته به روز رسانی برای کلاس های مدل Assignment: Update Package for Model Classes

• JsonNullable را حذف کنید Remove JsonNullable

• پروژه Lombok را اضافه کنید Add Project Lombok

• برای استفاده از عدد صحیح، ابعاد را به روز کنید Update Dimensions to Use Integer

سرور بوت بهار Spring Boot Server

• معرفی Introduction

• اضافه کردن ماژول بوت بهار Add Spring Boot Module

• افزودن وابستگی به ماژول API Add API Module Dependency

• مخزن مشتری ایجاد کنید Create Customer Repository

• مقداردهی اولیه داده های مشتری Initialize Customer Data

• ایجاد نقطه پایانی مشتری لیست Create List Customer Endpoint

• ایجاد دریافت مشتری توسط نقطه پایانی شناسه Create Get Customer by Id Endpoint

• تکلیف - اجرای نقاط پایانی دریافت محصول Assignment - Implement Product Get Endpoints

• تکلیف - اجرای دستور دریافت نقاط پایانی Assignment - Implement Order Get Endpoints

تست با Spring MockMVC Testing With Spring MockMVC

• معرفی Introduction

• ایجاد تست برای مشتریان لیست Create Test for List Customers

• تست دریافت مشتری با شناسه Test Get Customer by Id

• وابستگی اعتبارسنجی درخواست Swagger Swagger Request Validator Dependencies

• اعتبارسنجی درخواست Swagger با MockMVC Swagger Request Validator With MockMVC

• تکلیف - اعتبار سنجی دریافت نقطه پایانی محصول Assignment - Validate Product Get Endpoints

• تکلیف - اعتبارسنجی سفارش دریافت نقاط پایانی Assignment - Validate Order Get Endpoints

ایجاد عملیات Create Operations

• معرفی Introduction

• تکلیف - به روز رسانی مشخصات به OpenAPI 3.0 Assignment - Update Specification to OpenAPI 3.0

• مشخصات API محصول را ایجاد کنید Create Product API Specification

• Create Product API را پیاده سازی کنید Implement Create Product API

• تکلیف - ایجاد API مشتری Assignment - Create Customer API

• Create Order را به OpenAPI Specification اضافه کنید Add Create Order to OpenAPI Specification

• Create Order API را پیاده سازی کنید Implement Create Order API

• تست های سفارش ناموفق را برطرف کنید Fix Failing Order Tests

• طرحواره OpenAPI Refactor Refactor OpenAPI Schema

نگاشت رابطه ای شی Object Relational Mapping

• معرفی Introduction

• نمای کلی ORM ORM Overview

• Refactor برای استفاده از نامگذاری DTO Refactor to Use DTO Naming

• وابستگی های Maven Maven Dependencies

• نهاد مشتری Customer Entity

• نهادهای جاسازی شده Embedded Entities

• روابط یک به یک One to One Relationships

• روابط یک به چند One to Many Relationships

• ممیزی مهرهای زمانی Audit Timestamps

• واگذاری: نهاد محصول Assignment: Product Entity

• روابط بسیار به بسیاری Many to Many Relationships

• موجودیت سفارش ایجاد کنید Create Order Entity

استفاده از MapStruct Mappers Using MapStruct Mappers

• معرفی Introduction

• معرفی MapStruct MapStruct Introduction

• وابستگی ها و پیکربندی Maven Maven Dependencies and Configuration

• نقشه‌بردار DTO مشتری Customer DTO Mapper

• مخازن Refactor Refactor Repositories

• تست نقشه برداری و ماندگاری Testing Mapping and Persistence

• تکلیف - مقوله های Refactor Assignment - Refactor Categories

• نقشه‌بردار محصول Product Mapper

• Refactor Product Create Endpoint Refactor Product Create Endpoint

• لیست محصولات Refactor و دریافت خدمات Refactor Product List and Get Service

• سفارش پیاده سازی Mapper Order Mapper Implementation

• روش پرداخت انتخابی را اصلاح کنید Fix Selected Payment Method

محدودیت های JPA JPA Constraints

• بررسی اجمالی محدودیت های اعتبارسنجی Validation Constraints Overview

• محدودیت های محصول Product Constraints

• تکلیف - محدودیت های باقی مانده Assignment - Remaining Constraints

• تکلیف - کد رده محصول را الزامی کنید Assignment - Make Product Category Code Required

عملیات به روز رسانی Update Operations

• مشخصات OpenAPI را برای به روز رسانی محصول به روز کنید Update OpenAPI Specification for Product Update

• رفع ماندگاری تصویر Image Persistance Fix

• ایجاد نقشه نگار تصویر Create Image Mapper

• پیاده سازی محصول در ProductUpdateDto Mapper Implement Product to ProductUpdateDto Mapper

• خدمات به روز رسانی محصول را پیاده سازی کنید Implement Update Product Service

• نقطه پایانی API به روز رسانی محصول را پیاده سازی کنید Implement Product Update API Endpoint

• تکلیف - اضافه کردن به روز رسانی عملیات مشتری Assignment - Add Update Customer Operation

• برای به‌روزرسانی سفارش، مشخصات OpenAPI را به‌روزرسانی کنید Update OpenAPI Specification for Order Update

• ایجاد نقشه به‌روزرسانی سفارش Create Order Update Mapper

• اجرای نقطه پایانی به‌روزرسانی سفارش Implement Order Update Endpoint

عملیات پچ Patch Operations

• OpenAPI را برای وصله محصول به روز کنید Update OpenAPI for Product Patch

• ProductPatchDTO را در Product Mapper پیاده سازی کنید Implement ProductPatchDTO to Product Mapper

• نقطه پایانی وصله محصول را پیاده سازی کنید Implement Product Patch Endpoint

• تکلیف افزودن عملیات وصله مشتری Assignment Add Customer Patch Operation

• انتساب افزودن سفارش عملیات وصله Assignment Add Order Patch Operation

• Refactor پارامترهای UUID به Common Component در OA3 Refactor UUID parameters to Common Component in OA3

• شناسه UUID به مؤلفه مشترک در OA3 Refactor UUID Id to Common Component in OA3

حذف عملیات Delete Operations

• حذف مشتری را به مشخصات OpenAPI اضافه کنید Add Delete Customer to OpenAPI Specification

• حذف مشتری را اجرا کنید Implement Delete Customer

• تکلیف - برای محصول و سفارش حذف را اضافه کنید Assignment - Add Delete for Product and Order

• اگر شناسه یافت نشد، 404 را در Delete برگردانید Return 404 on Delete if Id Not Found

رسیدگی به مشکل Problem Handling

• معرفی Introduction

• دریافت مشتری یافت نشد Get Customer Not Found

• تکلیف - دسته برای دریافت محصول و سفارش یافت نشد Assignment - Handle Not Found for Get Product and Order

• به روز رسانی مشتری یافت نشد Update Customer Not Found

• تکلیف - دسته برای به روز رسانی محصول و سفارش یافت نشد Assignment - Handle Not Found for Update Product and Order

• تکلیف - دسته برای پچ محصول و سفارش یافت نشد Assignment - Handle Not Found for Patch Product and Order

• 409 تضاد در نقض محدودیت های پایگاه داده با حذف 409 Conflict on Database Constraint Violations With Delete

• 409 تضاد در عملیات حذف مشتری 409 Conflict on Customer Delete Operations

• اعتبارسنجی درخواست Spring MockMVC Spring MockMVC Request Validator

• در صورت وجود سفارش، از حذف محصول جلوگیری کنید Prevent Delete of Product if Orders Exist

• Refactor برای استفاده از اعتبارسنجی درخواست Spring MockMVC Refactor to Use Spring MockMVC Request Validator

استاندارد مدیریت مشکل Standardized Problem Handling

• معرفی Introduction

• مقدمه ای بر کتابخانه مسائل زالاندو Introduction to Zalando Problem Library

• اضافه کردن مشکل شروع به پروژه Add Problem Starter to Project

• Zalando Logbook برای Spring MVC Zalando Logbook for Spring MVC

• به روز رسانی حذف مشتری Update Delete Customer

• Refactor 404 Operations to Common Component Refactor 404 Operations to Common Component

• ASSN - Refactor 4XX Operations to Common Components ASSN - Refactor 4XX Operations to Common Components

• پیکربندی مشکل برای نقض محدودیت ها Problem Configuration for Constraint Violations

• Refactor استثنا یافت نشد Refactor Not Found Exception

• درخواست بد را آزمایش کنید Test Bad Request

سرویس گیرنده API Boot Spring Spring Boot API Client

• معرفی Introduction

• نمای کلی API Client Overview of API Client

• ساختار ماژول Refactor محصول Maven Refactor Module Structure of Maven Product

• پیکربندی کد Gen Configuration را به Parent منتقل کنید Move Code Gen Configuration to Parent

• اضافه کردن ماژول برای API Client Code Gen Add Module for API Client Code Gen

• پلاگین Spring Boot را برای تست یکپارچه سازی پیکربندی کنید Configure Spring Boot Plugin for Integration Test

• اضافه کردن API Client Test Integration Add API Client Integration Test