Cvičení – vývoj funkcí kódu pomocí nástrojů GitHub Copilot

Dokončeno

Vy a váš spolupracovník se scházíte a proberete své cíle pro aplikaci knihovny. Chcete zlepšit uživatelské prostředí pro knihovníky a patrony. Proberete několik nových funkcí, které je možné přidat do aplikace.

Souhlasíte s prací na následujících funkcích:

• Dostupnost knihy: Povolte knihovníku, aby určil stav dostupnosti knihy. Tato funkce by měla zobrazit zprávu, že je kniha k dispozici pro půjčku nebo termín splatnosti, pokud je kniha aktuálně na půjčce jinému patronu.

• Knihy půjčky: Povolit knihovníku zapůjčení knihy pro patrona (pokud je kniha k dispozici). Tato funkce by měla zobrazit možnost pro patrona dostat knihu o půjčce, aktualizovat Loans.json s novou půjčkou a zobrazit aktualizované podrobnosti o půjčce pro patrona.

• Rezervace knih: Umožňuje knihovníku rezervovat knihu pro patrona (pokud není kniha již rezervována). Tato funkce by měla implementovat nový proces rezervace knih. Tato funkce může vyžadovat vytvoření nového souboru Reservations.json spolu s novými třídami a rozhraními potřebnými k podpoře procesu rezervace.

Každý z vás bude pracovat na jedné z nových funkcí a pak znovu seskupí. Na této funkci budete pracovat a určíte stav dostupnosti knihy. Váš spolupracovník bude pracovat na funkci půjčování knihy pro patrona. Poslední funkce, která si rezervuje knihu pro patrona, bude vyvinuta po dokončení dalších dvou funkcí.

Během tohoto cvičení provedete následující úkoly:

1. Vytvořte větev "dostupnost knihy" v úložišti kódu.

2. Vytvořte novou funkci "dostupnost knih".

   • Pomocí návrhů GitHub Copilotu můžete kód implementovat rychleji a přesněji.
   • Synchronizujte aktualizace kódu do větve "dostupnost knih" vzdáleného úložiště.

3. Vytvořte žádost o přijetí změn pro sloučení změn do hlavní větve úložiště.

Vytvoření nové větve v úložišti

Než začnete s vývojem nové funkce "dostupnost knih", musíte v úložišti vytvořit novou větev. To vám umožní pracovat na nové funkci, aniž by to mělo vliv na hlavní větev úložiště. Až bude nová funkce připravená, můžete ji sloučit do hlavní větve.

K dokončení této části cvičení použijte následující kroky:

1. Ujistěte se, že máte otevřené řešení AccelerateDevGitHubCopilot v editoru Visual Studio Code.

2. Vyberte zobrazení správy zdrojového kódu a ujistěte se, že je místní úložiště synchronizované se vzdáleným úložištěm (vyžádat nebo synchronizovat).

3. V levém dolním rohu okna vyberte hlavní.

4. Pokud chcete vytvořit novou větev, zadejte dostupnost knihy a pak vyberte + Vytvořit novou větev.

5. Pokud chcete novou větev odeslat do vzdáleného úložiště, vyberte Publikovat větev.

Vývoj funkce, která knihovníku umožňuje určit stav dostupnosti knihy

V této části cvičení použijete GitHub Copilot k implementaci nové funkce pro aplikaci knihovny. Nová funkce umožňuje knihovníku určit stav dostupnosti knihy.

Funkce dostupnosti knihy by měla obsahovat následující aktualizace kódu:

• Přidat novou SearchBooks akci do CommonActions.
• Aktualizujte metodu WriteInputOptions v ConsoleApp.cs. Přidání podpory pro novou CommonActions.SearchBooks možnost Umožňuje zobrazit možnost zkontrolovat, jestli je kniha k dispozici pro půjčku.
• Aktualizujte metodu ReadInputOptions v ConsoleApp.cs. Přidání podpory pro novou CommonActions.SearchBooks možnost
• Aktualizujte metodu PatronDetails v ConsoleApp.cs. Přidat CommonActions.SearchBooks před options voláním ReadInputOptions. Přidejte objekt else if pro zpracování SearchBooks akce. Blok else if by měl volat novou metodu s názvem SearchBooks.
• V ConsoleApp.cs vytvořte novou SearchBooks metodu. Metoda SearchBooks by měla přečíst název knihy poskytnuté uživatelem. Zkontrolujte, jestli je kniha k dispozici pro půjčku, a zobrazte zprávu s informací, že "book.title je k dispozici pro půjčku", nebo "book.title je na půjčku jinému patronu. Termín vrácení splatnosti je loan.DueDate.

K dokončení této části cvičení použijte následující kroky:

1. Otevřete zobrazení PRŮZKUMNÍKA ŘEŠENÍ.

2. Otevřete soubor CommonActions.cs a vyberte výčt CommonActions .

   Je třeba přidat novou SearchBooks akci do CommonActions.

3. Otevřete vložený chat a zadejte následující výzvu:

   Update selection to include a new `SearchBooks` action.
   

   GitHub Copilot by měl navrhnout aktualizaci kódu, která přidá novou SearchBooks akci do výčtu CommonActions .

4. Zkontrolujte navrženou aktualizaci a pak vyberte Přijmout.

   public enum CommonActions
   {
       Repeat = 0,
       Select = 1,
       Quit = 2,
       SearchPatrons = 4,
       RenewPatronMembership = 8,
       ReturnLoanedBook = 16,
       ExtendLoanedBook = 32,
       SearchBooks = 64
   }
   

5. Otevřete soubor ConsoleApp.cs.

6. Vyhledejte a pak vyberte metodu WriteInputOptions .

   Pro novou CommonActions.SearchBooks možnost je potřeba přidat podporu. Umožňuje zobrazit možnost zkontrolovat, jestli je kniha k dispozici pro půjčku.

7. Otevřete vložený chat a zadejte následující výzvu:

   Update selection to include an option for the `CommonActions.SearchBooks` action. Use the letter "b" and the message "to check for book availability".
   

   GitHub Copilot by měl navrhnout aktualizaci kódu, která přidá nový if blok akce SearchBooks .

8. Zkontrolujte navrženou aktualizaci a pak vyberte Přijmout.

   Navrhovaná aktualizace by měla být podobná následujícímu fragmentu kódu:

   static void WriteInputOptions(CommonActions options)
   {
       Console.WriteLine("Input Options:");
       if (options.HasFlag(CommonActions.ReturnLoanedBook))
       {
           Console.WriteLine(" - \"r\" to mark as returned");
       }
       if (options.HasFlag(CommonActions.ExtendLoanedBook))
       {
           Console.WriteLine(" - \"e\" to extend the book loan");
       }
       if (options.HasFlag(CommonActions.RenewPatronMembership))
       {
           Console.WriteLine(" - \"m\" to extend patron's membership");
       }
       if (options.HasFlag(CommonActions.SearchPatrons))
       {
           Console.WriteLine(" - \"s\" for new search");
       }
       if (options.HasFlag(CommonActions.SearchBooks))
       {
           Console.WriteLine(" - \"b\" to check for book availability");
       }
       if (options.HasFlag(CommonActions.Quit))
       {
           Console.WriteLine(" - \"q\" to quit");
       }
       if (options.HasFlag(CommonActions.Select))
       {
           Console.WriteLine("Or type a number to select a list item.");
       }
   }
   

9. Posuňte se mírně nahoru, abyste našli a pak vyberte metodu ReadInputOptions .

   Pro novou CommonActions.SearchBooks možnost je potřeba přidat podporu. Uveďte případ, který zpracovává uživatele, který SearchBooks akci vybere.

10. Otevřete vložený chat a zadejte následující výzvu:

    Update selection to include an option for the `CommonActions.SearchBooks` action.
    

    GitHub Copilot by měl navrhnout aktualizaci kódu, která přidá nový case , který zpracovává uživatele, SearchBooks který akci vybere.

11. Zkontrolujte navrženou aktualizaci a pak vyberte Přijmout.

    Navrhovaná aktualizace by měla být podobná následujícímu fragmentu kódu:

    static CommonActions ReadInputOptions(CommonActions options, out int optionNumber)
    {
        CommonActions action;
        optionNumber = 0;
        do
        {
            Console.WriteLine();
            WriteInputOptions(options);
            string? userInput = Console.ReadLine();
    
            action = userInput switch
            {
                "q" when options.HasFlag(CommonActions.Quit) => CommonActions.Quit,
                "s" when options.HasFlag(CommonActions.SearchPatrons) => CommonActions.SearchPatrons,
                "m" when options.HasFlag(CommonActions.RenewPatronMembership) => CommonActions.RenewPatronMembership,
                "e" when options.HasFlag(CommonActions.ExtendLoanedBook) => CommonActions.ExtendLoanedBook,
                "r" when options.HasFlag(CommonActions.ReturnLoanedBook) => CommonActions.ReturnLoanedBook,
                "b" when options.HasFlag(CommonActions.SearchBooks) => CommonActions.SearchBooks,
                _ when int.TryParse(userInput, out optionNumber) => CommonActions.Select,
                _ => CommonActions.Repeat
            };
    
            if (action == CommonActions.Repeat)
            {
                Console.WriteLine("Invalid input. Please try again.");
            }
        } while (action == CommonActions.Repeat);
        return action;
    }
    

12. Posuňte se dolů a vyhledejte a vyberte metodu PatronDetails .

    Je potřeba udělat dvě věci:

    • Před voláním musíte přidat CommonActions.SearchBooksoptions .ReadInputOptions
    • Musíte také přidat pro else if zpracování SearchBooks akce. Blok else if by měl volat novou metodu s názvem SearchBooks.

    Obě tyto možnosti můžete řešit společně.

13. Otevřete vložený chat a zadejte následující výzvu:

    Update selection to add `CommonActions.SearchBooks` to `options` before calling `ReadInputOptions`. Add an `else if` block to handle the `SearchBooks` action. The `else if` block should call a new method named `SearchBooks`.
    

    GitHub Copilot by měl navrhnout aktualizaci kódu, která se přidá CommonActions.SearchBooks před options voláním ReadInputOptions.

14. Zkontrolujte navrženou aktualizaci a pak vyberte Přijmout.

    async Task<ConsoleState> PatronDetails()
    {
        Console.WriteLine($"Name: {selectedPatronDetails.Name}");
        Console.WriteLine($"Membership Expiration: {selectedPatronDetails.MembershipEnd}");
        Console.WriteLine();
        Console.WriteLine("Book Loans:");
        int loanNumber = 1;
        foreach (Loan loan in selectedPatronDetails.Loans)
        {
            Console.WriteLine($"{loanNumber}) {loan.BookItem!.Book!.Title} - Due: {loan.DueDate} - Returned: {(loan.ReturnDate != null).ToString()}");
            loanNumber++;
        }
    
        CommonActions options = CommonActions.SearchPatrons | CommonActions.Quit | CommonActions.Select | CommonActions.RenewPatronMembership | CommonActions.SearchBooks;
        CommonActions action = ReadInputOptions(options, out int selectedLoanNumber);
        if (action == CommonActions.Select)
        {
            if (selectedLoanNumber >= 1 && selectedLoanNumber <= selectedPatronDetails.Loans.Count())
            {
                var selectedLoan = selectedPatronDetails.Loans.ElementAt(selectedLoanNumber - 1);
                selectedLoanDetails = selectedPatronDetails.Loans.Where(l => l.Id == selectedLoan.Id).Single();
                return ConsoleState.LoanDetails;
            }
            else
            {
                Console.WriteLine("Invalid book loan number. Please try again.");
                return ConsoleState.PatronDetails;
            }
        }
        else if (action == CommonActions.Quit)
        {
            return ConsoleState.Quit;
        }
        else if (action == CommonActions.SearchPatrons)
        {
            return ConsoleState.PatronSearch;
        }
        else if (action == CommonActions.RenewPatronMembership)
        {
            var status = await _patronService.RenewMembership(selectedPatronDetails.Id);
            Console.WriteLine(EnumHelper.GetDescription(status));
            // reloading after renewing membership
            selectedPatronDetails = (await _patronRepository.GetPatron(selectedPatronDetails.Id))!;
            return ConsoleState.PatronDetails;
        }
        else if (action == CommonActions.SearchBooks)
        {
            return await SearchBooks();
        }
    
        throw new InvalidOperationException("An input option is not handled.");
    }
    

    Poznámka:

    Návrhy vloženého chatu mohou také vytvořit zástupný kód pro metodu SearchBooks .

15. Zvažte požadavky na proces pro metodu za minutu SearchBooks .

    Co tato metoda potřebuje? Co by se mělo vrátit? Vyžaduje parametry?

    Metoda SearchBooks by měla implementovat následující proces:

    1. Vyzvat uživatele k zadání názvu knihy.

    2. Přečtěte si název knihy zadaný uživatelem.

    3. Kontrola, jestli je kniha k dispozici pro půjčku

    4. Zobrazí zprávu s jednou z následujících možností:

       • "book.title je k dispozici pro půjčku"
       • " jebook.title na půjčce jinému patronu. Termín vrácení splatnosti je loan.DueDate.

    Pokud chcete vytvořit možnosti zprávy, bude váš kód potřebovat přístup k následujícím souborům JSON:

    • Books.json je zapotřebí k nalezení shody Title a BookId.
    • Loans.json je zapotřebí k nalezení ReturnDate shody DueDate a pro odpovídající BookItemId. Je BookItemId to stejné jako v BookIdBooks.json.

16. Ujistěte se, že jste v souboru ConsoleApp.cs vytvořili následující SearchBooks metodu:

    async Task<ConsoleState> SearchBooks()
    {
    
        return ConsoleState.PatronDetails;
    }
    

    Poznámka:

    Nezapomeňte odebrat všechny komentáře ke kódu vytvořené GitHub Copilotem. Nepotřebné a nepřesné komentáře můžou negativně ovlivnit návrhy GitHub Copilotu.

17. Vyberte metodu SearchBooks.

18. Otevřete vložený chat a zadejte následující výzvu:

    Update selection to obtain a book title. Prompt the user to "Enter a book title to search for". Read the user input and ensure the book title isn't null.
    

    GitHub Copilot by měl navrhnout aktualizaci kódu, která zachycuje název knihy zadané uživatelem.

19. Zkontrolujte navrženou aktualizaci a pak vyberte Přijmout.

    async Task<ConsoleState> SearchBooks()
    {
        string? bookTitle = null;
        while (String.IsNullOrWhiteSpace(bookTitle))
        {
            Console.Write("Enter a book title to search for: ");
            bookTitle = Console.ReadLine();
        }
    
        // Perform book search logic here
    
        return ConsoleState.PatronDetails;
    }
    

20. Vyberte metodu SearchBooks.

    Poznámka:

    GitHub Copilot může vytvořit samostatnou metodu pro zpracování uživatelského vstupu názvu knihy. V metodě můžete pokračovat v vývoji primární logiky SearchBooks .

21. Otevřete zobrazení chatu.

22. Do kontextu chatu přidejte následující soubory: ConsoleApp.cs, JsonData.cs, JsonLoanRepository.cs, Books.json, Loans.json, BookItems.json, .

23. Zadejte následující výzvu:

    @workspace  Explain how to update the `SearchBooks` method and ConsoleApps class to find a matching book title in the `Books.json` file. Use the user supplied book title to find a matching book. If a book is found, use Loans.json to check if the book is available for loan. If the book has been returned, display a message stating "`book.title` is available for loan". If the book is on loan, display a message stating "`book.title` is on loan to another patron. The return due date is `loan.DueDate`".
    

24. Projděte si navrhované aktualizace.

    GitHub Copilot by měl navrhnout aktualizace podobné následujícím návrhům:

    Pokud chcete aktualizovat metodu SearchBooks a ConsoleApp třídu, aby v souboru našli odpovídající název Books.json knihy a zkontrolovali, jestli je kniha k dispozici pro půjčku, postupujte takto:

    a. Přidejte metodu pro hledání knih podle názvu ve JsonData třídě. b) Aktualizujte metodu SearchBooksConsoleApp ve třídě tak, aby používala tuto novou metodu. c. Zkontrolujte stav půjčky knihy a zobrazte příslušnou zprávu.

    Tady je aktualizovaný kód:

    Krok 1: Přidání metody pro vyhledávání knih podle názvu ve třídě JsonData

    public class JsonData
    {
        // Existing code...
    
        public Book? SearchBookByTitle(string title)
        {
            return Books?.FirstOrDefault(b => b.Title.Equals(title, StringComparison.OrdinalIgnoreCase));
        }
    }
    

    Krok 2: Aktualizace metody SearchBooks ve třídě ConsoleApp

    public class ConsoleApp
    {
        // Existing fields...
    
        JsonData _jsonData;
    
        public ConsoleApp(ILoanService loanService, IPatronService patronService, IPatronRepository patronRepository, ILoanRepository loanRepository, JsonData jsonData)
        {
            _patronRepository = patronRepository;
            _loanRepository = loanRepository;
            _loanService = loanService;
            _patronService = patronService;
            _jsonData = jsonData;
        }
    
        // Existing methods...
    
        async Task<ConsoleState> SearchBooks()
        {
            string bookTitle = ReadBookTitle();
    
            Book? book = _jsonData.SearchBookByTitle(bookTitle);
    
            if (book == null)
            {
                Console.WriteLine($"No book found with title: {bookTitle}");
                return ConsoleState.PatronDetails;
            }
    
            Loan? loan = _jsonData.Loans?.FirstOrDefault(l => l.BookItemId == book.Id && l.ReturnDate == null);
    
            if (loan == null)
            {
                Console.WriteLine($"{book.Title} is available for loan.");
            }
            else
            {
                Console.WriteLine($"{book.Title} is on loan to another patron. The return due date is {loan.DueDate}.");
            }
    
            return ConsoleState.PatronDetails;
        }
    
        // Existing methods...
    }
    

    Krok 3: Aktualizace Program.cs tak, aby předávala JsonData do ConsoleAppu

    using Microsoft.Extensions.DependencyInjection;
    using Library.Infrastructure.Data;
    using Library.ApplicationCore;
    using Microsoft.Extensions.Configuration;
    
    var services = new ServiceCollection();
    
    var configuration = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appSettings.json")
    .Build();
    
    services.AddSingleton<IConfiguration>(configuration);
    
    services.AddScoped<IPatronRepository, JsonPatronRepository>();
    services.AddScoped<ILoanRepository, JsonLoanRepository>();
    services.AddScoped<ILoanService, LoanService>();
    services.AddScoped<IPatronService, PatronService>();
    
    services.AddSingleton<JsonData>();
    services.AddSingleton<ConsoleApp>();
    
    var servicesProvider = services.BuildServiceProvider();
    
    var consoleApp = servicesProvider.GetRequiredService<ConsoleApp>();
    consoleApp.Run().Wait();
    

    S těmito změnami SearchBooks teď metoda ve ConsoleApp třídě vyhledá knihu podle názvu v Books.json souboru a zkontroluje stav půjčky Loans.json v souboru. Pokud je kniha k dispozici pro půjčku, zobrazí se zpráva oznamující, že kniha je k dispozici. Pokud je kniha na půjčku, zobrazí se zpráva s informací, že kniha je na půjčku, a poskytne termín vrácení splatnosti.

25. Přidejte navrženou metodu JsonData na konec třídy.

    public Book? SearchBookByTitle(string title)
    {
        return Books?.FirstOrDefault(b => b.Title.Equals(title, StringComparison.OrdinalIgnoreCase));
    }
    

26. Aktualizujte soubor Program.cs pomocí navrhovaných aktualizací.

    using Microsoft.Extensions.DependencyInjection;
    using Library.Infrastructure.Data;
    using Library.ApplicationCore;
    using Microsoft.Extensions.Configuration;
    
    var services = new ServiceCollection();
    
    var configuration = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appSettings.json")
    .Build();
    
    services.AddSingleton<IConfiguration>(configuration);
    
    services.AddScoped<IPatronRepository, JsonPatronRepository>();
    services.AddScoped<ILoanRepository, JsonLoanRepository>();
    services.AddScoped<ILoanService, LoanService>();
    services.AddScoped<IPatronService, PatronService>();
    
    services.AddSingleton<JsonData>();
    services.AddSingleton<ConsoleApp>();
    
    var servicesProvider = services.BuildServiceProvider();
    
    var consoleApp = servicesProvider.GetRequiredService<ConsoleApp>();
    consoleApp.Run().Wait();
    

27. JsonData _jsonData; Před konstruktor třídy přidejte deklaraci pole do ConsoleApp třídy.

28. JsonData jsonData Přidejte parametr do konstruktoru ConsoleApp třídy a použijte ho _jsonData k inicializaci pole uvnitř konstruktoru.

    Aktualizovaný konstruktor třídy by měl vypadat jako následující fragment kódu:

    public ConsoleApp(ILoanService loanService, IPatronService patronService, IPatronRepository patronRepository, ILoanRepository loanRepository, JsonData jsonData)
    {
        _patronRepository = patronRepository;
        _loanRepository = loanRepository;
        _loanService = loanService;
        _patronService = patronService;
        _jsonData = jsonData;
    }
    

29. Všimněte si, že JsonData se ve ConsoleApp třídě nerozpozná.

    Musíte přidat using Library.Infrastructure.Data; na začátek ConsoleApp.cs souboru.

30. Ujistěte se, že se using Library.Infrastructure.Data; příkaz přidá do horní části ConsoleApp.cs souboru.

31. Pomocí návrhů kódu aktualizujte metodu SearchBooks :

    Navrhovaný kód by měl použít dotaz LINQ k vyhledání knihy podle názvu. Pokud se kniha najde, použije se jiný dotaz LINQ k určení, jestli je kniha na půjčce. Kód také obsahuje logiku pro zobrazení stavu dostupnosti knihy na základě výsledků hledání. Logiku použitou k zobrazení zpráv odpovědí je možné implementovat několika způsoby. Příklad je uvedený v následujícím fragmentu kódu.

    Následující fragment kódu ukazuje jednu z možných implementací SearchBooks metody:

    async Task<ConsoleState> SearchBooks()
    {
        string bookTitle = ReadBookTitle();
    
        Book? book = _jsonData.SearchBookByTitle(bookTitle);
    
        if (book == null)
        {
            Console.WriteLine($"No book found with title: {bookTitle}");
            return ConsoleState.PatronDetails;
        }
    
        Loan? loan = _jsonData.Loans?.FirstOrDefault(l => l.BookItemId == book.Id && l.ReturnDate == null);
    
        if (loan == null)
        {
            Console.WriteLine($"{book.Title} is available for loan.");
        }
        else
        {
            Console.WriteLine($"{book.Title} is on loan to another patron. The return due date is {loan.DueDate}.");
        }
    
        return ConsoleState.PatronDetails;
    }
    

32. Vyberte metodu SearchBooks.

33. Otevřete zobrazení chatu a zadejte následující výzvu:

    Explain the LINQ queries and the evaluation of the book's availability status.
    

34. Projděte si vysvětlení, které poskytuje GitHub Copilot.

    U dotazu, který zkontroluje, jestli je kniha na půjčce, by se měl zobrazit popis podobný následujícímu vysvětlení:

    **Search for the Loan Status of the Book**
    

    Loan? loan = _jsonData.Loans?.FirstOrDefault(l => l.BookItemId == book.Id && l.ReturnDate == null);
    

    - _jsonData.Loans: Accesses the list of loans from the JsonData class.
    
    - ?.: The null-conditional operator ensures that if _jsonData.Loans is null, the entire expression will return null without throwing a NullReferenceException.
    
    - FirstOrDefault: A LINQ method that returns the first element in the collection that matches the specified condition, or null if no such element is found.
    
    - Lambda Expression: l => l.BookItemId == book.Id && l.ReturnDate == null
    
        - l.BookItemId == book.Id: Checks if the BookItemId of the loan matches the Id of the book being searched.
    
        - l.ReturnDate == null: Checks if the loan's ReturnDate is null, indicating that the book is currently on loan and has not been returned.
    
    - Result: If a matching loan is found, it is assigned to the loan variable. If no matching loan is found, loan is null.
    
    **Evaluation of the Book's Availability Status**
    
    After executing the LINQ queries, the method evaluates the availability status of the book:
    
      - If `loan` is `null`, the book has been returned. The method prints that the book is available for loan.
      - If `loan` is not `null`, the book is currently on loan (no return date). The method prints that the book is on loan and provides the date when the book should be returned.
    
    

35. Ověřte logiku implementovanou dotazem kontrolující, zda je kniha vypůjčená.

    Operátor s podmínkou null: Operátor ?. je podmíněný operátorem s hodnotou null. Zajišťuje, že pokud _jsonData.Loans je null, celý výraz se vyhodnotí jako null bez vyvolání znaku NullReferenceException.

    Výraz lambda: Výraz l => l.BookItemId == book.Id && l.ReturnDate == null lambda definuje podmínku pro metodu FirstOrDefault . Kontroluje každý loan objektl, aby zjistil, zda jeho BookItemId odpovídá objektu Idbook a zda je jeho .ReturnDatenull

    Tento kód se pokusí najít první loan v _jsonData.Loans kolekci, kde BookItemId odpovídá Id danému book a ReturnDate je null. Pokud taková loan nebyla nalezena nebo pokud _jsonData.Loans je null, loan bude nastavena na null.

    Poznámka:

    Většina moderních knihoven má více kopií stejné knihy. Tento kód předpokládá, že existuje pouze jedna kopie každé knihy. Pokud knihovna obsahuje více kopií stejné knihy, bude nutné kód aktualizovat, aby zvládl více půjček pro stejnou knihu. Pro účely tohoto trénování předpokládáme, že existuje pouze jedna kopie každé knihy a že je dostatečná logika.

36. Sestavte řešení, abyste zajistili, že nedojde k žádným chybám.

    Zobrazí se zprávy s upozorněním, ale neměly by se zde vyskytovat žádné chyby.

    Chcete-li sestavit řešení v zobrazení Průzkumník řešení, klikněte pravým tlačítkem myši na AccelerateDevGitHubCopilot a pak vyberte Sestavit.

Synchronizace změn se vzdáleným úložištěm

1. Vyberte zobrazení Správy zdrojového kódu.

2. Ujistěte se, že soubory, které jste aktualizovali, jsou uvedené v části Změny.

3. K vygenerování zprávy pro potvrzení použijte GitHub Copilot.

4. Chcete-li provést fázi a potvrzení změn, vyberte Potvrdit a pak vyberte Ano.

5. Synchronizace (nebo nasdílení změn) do vzdáleného úložiště

Kontrola práce

V této části cvičení provedete následující úkoly:

1. Ověřte, že nová funkce správně určuje stav dostupnosti knihy.
2. Vytvořte žádost o přijetí změn pro sloučení změn do hlavní větve úložiště.

Ověřte, že nová funkce funguje podle očekávání.

Vzhledem k tomu, že nemáte automatizované testy, můžete ruční testování použít k ověření, že nová funkce funguje podle očekávání. Použití zdroje dat, který je možné ověřit, je důležité. V takovém případě pomocí Books.json souborů a Loans.json souborů ověříte, že nová funkce hlásí stav dostupnosti knihy správně.

K dokončení této části cvičení použijte následující kroky:

1. Otevřete zobrazení Průzkumník řešení.

2. Aplikaci spustíte tak, že kliknete pravým tlačítkem na Library.Console, vyberete Ladit a pak vyberete Spustit novou instanci.

3. Po zobrazení výzvy k zadání jména patrona zadejte 1 a stiskněte Enter.

   Měl by se zobrazit seznam patronů, kteří odpovídají vyhledávacímu dotazu.

4. Na příkazovém řádku Vstupní možnosti zadejte 2 a stiskněte Enter.

   Zadáním 2 vyberete druhého patrona v seznamu.

   Měli byste vidět jméno a členství patrona a stav členství následovaný podrobnostmi o knihách půjčky.

5. Na příkazovém řádku Vstupní možnosti zadejte b a stiskněte Enter.

   Zadáním příkazu b vyberete možnost vyhledat stav dostupnosti knihy.

   Měla by se zobrazit výzva k zadání názvu knihy.

6. Zadejte Book One a stiskněte Enter.

   V původních datech, která jste si stáhli, je Book One aktuálně vypůjčen Patron Forty-Nine, takže by neměl být k dispozici.

7. Ověřte, že aplikace zobrazí zprávu, že kniha je na půjčce jinému patronu.

8. Ověřte, že Book Nine byla vrácena Patronem One.

   V předchozím cvičení jste při testu aplikace Knihovna nechali Patron One vrátit Book Nine. Pokud aplikace ukazuje, že Kniha Devět nebyla vrácena Patronem One, použijte vstupní možnosti k výběru a vrácení Knihy Devět předtím, než budete pokračovat.

   Poznámka:

   Soubor Library.Console.csproj zajistí, že se datové soubory JSON při sestavení aplikace zkopírují do výstupního adresáře. Provádění operací vyčištění nebo opětovného sestavení však v podstatě resetuje data. Opakované operace sestavení neobnovují data ve výstupním adresáři (/bin/Debug/net8.0/).

9. Na příkazovém řádku Vstupní možnosti zadejte b a stiskněte Enter.

10. Zadejte Book Nine a stiskněte Enter.

11. Ověřte, že aplikace zobrazí zprávu, že kniha je k dispozici pro půjčku.

12. Na příkazovém řádku Vstupní možnosti zadejte q a stiskněte Enter.

13. Zastavte ladicí relaci.

14. Otevřete soubor Loans.json.

    Soubor Loans.json slouží ke sledování stavu půjčky každé knihy. Pomocí tohoto souboru můžete Loans.json ověřit, jestli je stav dostupnosti knihy One a Book Nine správný.

    Aktualizovaný Loans.json soubor by se měl nacházet ve Library.Console\bin\Debug\net8.0\Json složce nebo Library.Console\Json ve složce.

    • Pokud ke spuštění aplikace používáte ladicí program editoru Visual Studio Code, měl by se aktualizovaný Loans.json soubor nacházet ve Library.Console\bin\Debug\net8.0\Json složce.

    • Pokud ke spuštění aplikace používáte dotnet run příkaz ze AccelerateDevGitHubCopilot\src\Library.Console> složky, měl by se aktualizovaný Loans.json soubor nacházet ve Library.Console\Json složce.

15. Ověřte, že ID půjčky 37 a ID půjčky 46 jsou obě pro Book One ("BookItemId": 1).

    • ID půjčky 37 by mělo mít ReturnDate hodnotu (2024-01-17)
    • ID půjčky 46 by nemělo mít ReturnDate hodnotu. Hodnota ReturnDate by měla být null.

    Hodnota ReturnDate se používá k určení, zda je kniha aktuálně na půjčku. Pokud je ReturnDatehodnota null , kniha je považována za půjčku.

16. Ověřte, že ID půjčky 22 je pro Book Nine ("BookItemId": 9) a že ReturnDate hodnota je nastavena na dnešní datum.

    Pokud používáte ladicí program a po provedení změn Loans.json v souboru jste řešení vyčistili, tyto změny se ztratí. Po vyčištění řešení Loans.json se soubor resetuje na původní data při příštím spuštění aplikace. Soubor můžete aktualizovat ručně Loans.json a otestovat stav dostupnosti booku One a Book Nine.

Vytvoření žádosti o přijetí změn pro sloučení změn do hlavní větve

Dokončili jste novou funkci, která knihovniči umožňuje určit stav dostupnosti knihy. Teď potřebujete sloučit změny do hlavní větve úložiště. Můžete vytvořit žádost o přijetí změn pro sloučení změn do hlavní větve.

K dokončení této části cvičení použijte následující kroky:

1. Otevřete úložiště GitHub ve webovém prohlížeči.

2. Otevřete kartu Pull Requesty.

3. Vyberte Nový pull request.

4. V části Porovnat změny se ujistěte, že je základ nakonfigurovaný pro hlavní větev.

5. Ujistěte se, že porovnání je nakonfigurované pro větev dostupnost knihy.

   Po nakonfigurování větví se zobrazí porovnání změn mezi main a book-availability. Měly by se zobrazit změny jednotlivých souborů, které jste aktualizovali.

6. Vyberte Vytvořit pull request.

7. Zadejte název a popis žádosti o přijetí změn.

   Můžete použít následující název a popis:

   • Název: feat: Přidat funkci vyhledávání pro knihy v ConsoleApp
   • Popis: Tato žádost o přijetí změn přidá novou funkci, která knihovnii umožňuje určit stav dostupnosti knihy. Tato funkce obsahuje novou SearchBooks akci v CommonActions, aktualizace WriteInputOptions, ReadInputOptionsa PatronDetails metody v ConsoleApp, a přidá novou SearchBooks metodu do ConsoleApp.

   Poznámka:

   Členové podniku s předplatným GitHub Copilot Enterprise můžou pomocí GitHub Copilotu vygenerovat souhrn žádosti o přijetí změn na GitHub.com. Souhrn můžete použít k tomu, abyste revidujícím pomohli porozumět vašim změnám nebo rychle pochopit změny v žádosti o přijetí změn, kterou kontrolujete. Vyberte GitHub Actions a pak vyberte Souhrn k vygenerování souhrnu žádosti o přijetí změn.

   Tady je příklad souhrnu žádostí o přijetí změn vygenerovaného pomocí účtu GitHub Copilot Enterprise:

   

8. Ujistěte se, že název a popis odrážejí aktualizace kódu, a pak vyberte Vytvořit žádost o přijetí změn.

9. Počkejte, než se kontroly dokončí, a pak ověřte, že všechny kontroly proběhly a že nedošlo ke konfliktům se základní větví.

   Dokončení kontrol může chvíli trvat. Před sloučením změn do hlavní větve je potřeba vyřešit všechny zjištěné problémy.

10. Pokud chcete sloučit změny do hlavní větve, vyberte Sloučit žádost o přijetí změn a pak vyberte Potvrdit sloučení.

    Všimněte si, že větev můžete odstranit book-availability po sloučení změn.

11. Otevřete Visual Studio Code.

12. Přepněte do hlavní větve úložiště.

13. Přetáhněte změny ze vzdáleného úložiště.

14. Ověřte, že změny provedené ve větvi dostupnosti knih jsou teď v hlavní větvi.