Создание первой функции Azure с помощью Java и IntelliJCreate your first Azure function with Java and IntelliJ

Из этой статьи можно получить следующие сведения.This article shows you:

  • Создание проекта функции без сервера с IntelliJ идеейHow to create a serverless function project with IntelliJ IDEA
  • Шаги, которые необходимо выполнить для проверки и отладки функции в интегрированной среде разработки (IDE) на компьютереSteps for testing and debugging the function in the integrated development environment (IDE) on your own computer
  • Инструкция для развертывания проекта функции в Функциях AzureInstructions for deploying the function project to Azure Functions

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начать работу.If you don't have an Azure subscription, create a free account before you begin.

Настройка среды разработкиSet up your development environment

Чтобы разрабатывать функцию с помощью Java и IntelliJ, необходимо установить следующее программное обеспечение.To develop a function with Java and IntelliJ, install the following software:

Установка и входInstallation and Sign-in

  1. В диалоговом окне Settings/Preferences (Параметры и предпочтения) в IntelliJ IDEA (CTRL+ALT+S) выберите Plugins (Подключаемые модули).In IntelliJ IDEA's Settings/Preferences dialog (Ctrl+Alt+S), select Plugins . Затем найдите модуль Azure Toolkit for IntelliJ в Marketplace и щелкните Install (Установить).Then, find the Azure Toolkit for IntelliJ in the Marketplace and click Install . После установки щелкните Restart (Перезапуск), чтобы активировать подключаемый модуль.After installed, click Restart to activate the plugin.

    Подключаемый модуль Azure Toolkit for IntelliJ в Marketplace

  2. Чтобы войти в учетную запись Azure, откройте боковую панель Azure Explorer , а затем щелкните значок Azure Sign In (Вход в Azure) в верхней строке (или в меню IDEA Tools/Azure/Azure Sign in (Средства/Azure/Вход в Azure)).To sign in to your Azure account, open sidebar Azure Explorer , and then click the Azure Sign In icon in the bar on top (or from IDEA menu Tools/Azure/Azure Sign in ). Команда Azure Sign In (Вход в Azure) в IntelliJThe IntelliJ Azure Sign In command

  3. В окне Azure Sign In (Вход в Azure) выберите Device Login (Имя пользователя устройства) и щелкните Sign in (Вход) ( другие варианты входа).In the Azure Sign In window, select Device Login , and then click Sign in (other sign in options).

    Окно Azure Sign In (Вход в Azure) с выбранным именем пользователя устройства

  4. В диалоговом окне Azure Device Login (Вход в систему устройства Azure) щелкните Copy&Open (Копировать и открыть).Click Copy&Open in Azure Device Login dialog .

    Диалоговое окно входа Azure

  5. В браузере вставьте код устройства (скопированный при нажатии Copy&Open (Копировать и открыть) на последнем шаге), а затем нажмите кнопку Далее .In the browser, paste your device code (which has been copied when you click Copy&Open in last step) and then click Next .

    Вход в систему устройства в браузере

  6. В диалоговом окне Select Subscriptions (Выбор подписок) выберите нужные подписки и нажмите кнопку ОК .In the Select Subscriptions dialog box, select the subscriptions that you want to use, and then click OK .

    Диалоговое окно выбора подписок

Создание локального проектаCreate your local project

В этом разделе вы используете набор средств Azure для IntelliJ, чтобы создать локальный проект Функций Azure.In this section, you use Azure Toolkit for IntelliJ to create a local Azure Functions project. Далее в этой статье вы опубликуете код функции в Azure.Later in this article, you'll publish your function code to Azure.

  1. Откройте диалоговое окно приветствия IntelliJ, выберите Создать новый проект чтобы открыть мастер создания проекта, выберите Azure Functions .Open IntelliJ Welcome dialog, select Create New Project to open a new Project wizard, select Azure Functions .

    Создание проекта Функций Azure

  2. Выберите триггер HTTP , нажмите кнопку Далее и следуйте указаниям мастера, чтобы выполнить все конфигурации на следующих страницах. Подтвердите расположение проекта и нажмите кнопку Завершить ; после этого Intellj IDEA откроет новый проект.Select Http Trigger , then click Next and follow the wizard to go through all the configurations in the following pages; confirm your project location then click Finish ; Intellj IDEA will then open your new project.

    Завершение проекта Функций Azure

Локальное выполнение приложения-функцииRun the Function App locally

  1. Перейдите к src/main/java/org/example/functions/HttpTriggerFunction.java, чтобы увидеть созданный код.Navigate to src/main/java/org/example/functions/HttpTriggerFunction.java to see the code generated. Рядом со строкой 17 обратите внимание на зеленую кнопку Выполнить , щелкните ее и выберите Запустить "azure-function-exam..." . Вы увидите, что приложение-функция выполняется локально с несколькими журналами.Beside the line 17 , you will notice that there is a green Run button, click it and select Run 'azure-function-exam...' , you will see that your function app is running locally with a few logs.

    Локальный запуск проекта функций

    Выходные данные локального запуска функций

  2. Вы можете попробовать выполнить функцию, обратившись к печатной конечной точке из браузера, например http://localhost:7071/api/HttpTrigger-Java?name=Azure.You can try the function by accessing the printed endpoint from browser, like http://localhost:7071/api/HttpTrigger-Java?name=Azure.

    Результаты проверки локального выполнения функций

  3. Кроме того, журнал выводится в IDEA. Теперь эту функцию можно отключить, нажав кнопку Завершить .The log is also printed out in your IDEA, now, stop the function by clicking the stop button.

    Журнал проверки для локального запуска функций

Локальная отладка приложения-функции.Debug the Function App locally

  1. Теперь попробуем выполнить отладку приложения-функции на локальном компьютере. Нажмите кнопку Отладка на панели инструментов (если она не отображается, щелкните Вид > Представление > Панель инструментов , чтобы включить панель инструментов).Now let's try to debug your Function App locally, click the Debug button in the toolbar (if you don't see it, click View -> Appearance -> Toolbar to enable Toolbar).

    Кнопка локальной отладки функций

  2. Нажмите на строку 20 файла src/main/java/org/example/functions/HttpTriggerFunction.java, чтобы добавить точку останова. Перейдя снова к конечной точке http://localhost:7071/api/HttpTrigger-Java?name=Azure, вы обнаружите попадание в точку останова. Вы можете опробовать больше отладочных функций, таких как шаг , обзор , оценка .Click on line 20 of the file src/main/java/org/example/functions/HttpTriggerFunction.java to add a breakpoint, access the endpoint http://localhost:7071/api/HttpTrigger-Java?name=Azure again , you will find the breakpoint is hit, you can try more debug features like step , watch , evaluation . Чтобы отключить сеанс отладки, нажмите кнопку "Остановить"Stop the debug session by click the stop button.

    Прерывание локальной отладки функций

Развертывание приложения-функции в AzureDeploy your Function App to Azure

  1. Щелкните правой кнопкой мыши проект в обозревателе проектов IntelliJ и выберите Azure > Развернуть в Функциях AzureRight click your project in IntelliJ Project explorer, select Azure -> Deploy to Azure Functions

    Развертывание функций в Azure

  2. Если у вас еще нет приложения-функции, щелкните No available function, click to create a new one (Нет доступной функции, щелкните, чтобы создать новую).If you don't have any Function App yet, click No available function, click to create a new one .

    Развертывание функций для создания приложения Azure

  3. Введите имя приложения-функции и выберите соответствующую подписку (платформу, группу ресурсов или план службы приложений). Здесь также можно создать план службы "Группа ресурсов" или "Служба приложений".Type in the Function app name and choose proper subscription/platform/resource group/App Service plan, you can also create resource group/App Service plan here. Затем сохраните параметры приложения без изменений, нажмите кнопку ОК и подождите несколько минут, пока создастся новая функция.Then, keep app settings unchanged, click OK and wait some minutes for the new function to be created. После Создания нового приложения функции... индикатор выполнения исчезнет.After Creating New Function App... progress bar disappears.

    Развертывание функций для создания мастера приложений

  4. Выберите приложение-функцию, в которое вы хотите выполнить развертывание (автоматически будет выбрано новое приложение-функция, которое вы только что создали).Select the function app you want to deploy to, (the new function app you just created will be automatically selected). Щелкните Запустить , чтобы развернуть функции.Click Run to deploy your functions.

    На снимке экрана показано диалоговое окно "развертывание функций Azure".

    Развертывание функций для журнала Azure

Управление функциями Azure из IDEAManage Azure Functions from IDEA

  1. Вы можете управлять функциями с помощью Azure Explorer в своем IDEA. Щелкнув приложение функцию , вы увидите здесь все свои функции.You can manage your functions with Azure Explorer in your IDEA, click on Function App , you will see all your functions here.

    Просмотр функций в обозревателе

  2. Щелкните, чтобы выбрать одну из функций, и, нажав правой кнопкой мыши, выберите Показывать свойства , чтобы открыть страницу сведений.Click to select on one of your functions, and right click, select Show Properties to open the detail page.

    Отображение свойств функций

  3. Щелкните правой кнопкой мыши функцию HttpTrigger-Java и выберите Функция для триггеров . Вы увидите, что браузер открыт с URL-адресом триггера.Right click on your Function HttpTrigger-Java , and select Trigger Function , you will see that the browser is opened with the trigger URL.

    На снимке экрана показан браузер с U R L.

Добавление дополнительных функций в проектAdd more Functions to the project

  1. Щелкните правой кнопкой мыши пакет org.example.functions и выберите Создать > Класс Функций Azure .Right click on the package org.example.functions and select New -> Azure Function Class .

    Добавление функций в запись проекта

  2. Заполните поля имени класса HttpTest , выберите HttpTrigger в мастере создания классов функций, а затем нажмите ОК , чтобы создать. Таким образом, вы сможете создавать новые функции.Fill in the class name HttpTest and select HttpTrigger in the create function class wizard, click OK to create, in this way, you can create new functions as you want.

    На снимке экрана показано диалоговое окно Создание класса функции.

    Добавление функций в выходные данные проекта

Очистка ФункцийCleaning Up Functions

  1. Удаление Функций Azure в Azure ExplorerDeleting Azure Functions in Azure Explorer

    На снимке экрана показано удаление, выбранное из контекстного меню.

Дальнейшие действияNext steps

Итак, вы создали проект с функцией Java, активируемой по HTTP-запросу, запустили ее на своем локальном компьютере и развернули в Azure.You've created a Java functions project with an HTTP triggered function, run it on your local machine, and deployed it to Azure. Теперь расширьте свою функцию путем...Now, extend your function by...