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

В этой статье показано, как создать проект бессерверной функции с помощью Eclipse IDE и Apache Maven, протестировать и отладить его и развернуть в решении "Функции Azure".This article shows you how to create a serverless function project with the Eclipse IDE and Apache Maven, test and debug it, then deploy it 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 и Eclipse должны быть установлены следующие компоненты:To develop a functions app with Java and Eclipse, you must have the following installed:

Важно!

Переменной среде JAVA_HOME необходимо присвоить расположение установки JDK, чтобы завершить выполнение заданий этого краткого руководства.The JAVA_HOME environment variable must be set to the install location of the JDK to complete this quickstart.

Рекомендуется установить основные инструменты решения "Функции Azure" версии 2, которые предоставляют локальную среду для выполнения и отладки Функций Azure.It's highly recommended to also install Azure Functions Core Tools, version 2, which provide a local environment for running and debugging Azure Functions.

Создание проекта Функций AzureCreate a Functions project

  1. В Eclipse откройте меню файл и выберите создать- > Maven проект.In Eclipse, select the File menu, then select New -> Maven Project.
  2. Примите значения по умолчанию в диалоговом окне New Maven Project (Новый проект Maven) и щелкните Next (Далее).Accept the defaults in the New Maven Project dialogue and select Next.
  3. Найдите и выберите Azure-functions-архетипа и нажмите кнопку Далее.Find and select the azure-functions-archetype and click Next.
  4. Обязательно заполните значения для всех полей resourceGroup , включая, appName и appRegion (используйте другое AppName, отличное от fabrikam-Function-20170920120101928), и в конечном итоге завершите работу.Be sure to fill in values for all of the fields including resourceGroup, appName, and appRegion (please use a different appName other than fabrikam-function-20170920120101928), and eventually Finish. Eclipse Maven Create2Eclipse Maven create2

Maven создает файлы проекта в новой папке с именем artifactId.Maven creates the project files in a new folder with a name of artifactId. Созданный код проекта представляет собой простую функциюактивации HTTP, которая возвращает текст HTTP-запроса.The generated code in the project is a simple HTTP triggered function that echoes the body of the triggering HTTP request.

Запуск функций в локальной среде IDERun functions locally in the IDE

Примечание

Для локальных запуска и отладки функций, нужно установить Azure Functions Core Tools версии 2.Azure Functions Core Tools, version 2 must be installed to run and debug functions locally.

  1. Щелкните правой кнопкой мыши созданный проект, а затем выберите Run As (Выполнить как) и Maven build (Сборка Maven).Right-click on the generated project, then choose Run As and Maven build.
  2. В диалоговом окне Edit Configuration (Изменение конфигурации) введите package в поля Goals (Целевые объекты) и Name (Имя), затем щелкните Run (Выполнить).In the Edit Configuration dialog, Enter package in the Goals and Name fields, then select Run. В результате будет создан и упакован код функции.This will build and package the function code.
  3. После завершения сборки создайте другую конфигурацию запуска так, как показано выше, используя azure-functions:run для целевого объекта и имени.Once the build is complete, create another Run configuration as above, using azure-functions:run as the goal and name. Щелкните Run (Выполнить), чтобы запустить функцию в интегрированной среде разработки.Select Run to run the function in the IDE.

Когда закончите тестировать функцию, завершите работу среды выполнения в окне консоли.Terminate the runtime in the console window when you're done testing your function. Только один узел функции может быть активным и работать локально одновременно.Only one function host can be active and running locally at a time.

Отладка функции в EclipseDebug the function in Eclipse

В конфигурации запуска от имени , настроенной на предыдущем шаге, измените azure-functions:run на azure-functions:run -DenableDebug и запустите обновленную конфигурацию, чтобы запустить приложение функции в режиме отладки.In your Run As configuration set up in the previous step, change azure-functions:run to azure-functions:run -DenableDebug and run the updated configuration to start the function app in debug mode.

Выберите меню запуска и откройте Debug Configurations (Конфигурации отладки).Select the Run menu and open Debug Configurations. Выберите пункт Remote Java Application (Удаленное приложение Java) и создайте новое.Choose Remote Java Application and create a new one. Присвойте конфигурации имя и задайте параметры.Give your configuration a name and fill in the settings. Порт должен соответствовать порту отладки, открытому узлом функции, который по умолчанию равен 5005.The port should be consistent with the debug port opened by function host, which by default is 5005. После завершения установки щелкните Debug, чтобы запустить отладку.After setup, click on Debug to start debugging.

Функции отладки в Eclipse

Установите точки останова и проверьте объекты в функции, используя интегрированную среду разработки.Set breakpoints and inspect objects in your function using the IDE. По завершении остановите отладчик и запущенный узел функции.When finished, stop the debugger and the running function host. Только один узел функции может быть активным и работать локально одновременно.Only one function host can be active and running locally at a time.

Развертывание функции для AzureDeploy the function to Azure

В процессе развертывания для Функций Azure используются данные учетной записи из Azure CLI.The deploy process to Azure Functions uses account credentials from the Azure CLI. Войдите с помощью Azure CLI прежде чем продолжить, используя командную строку компьютера.Log in with the Azure CLI before continuing using your computer's command prompt.

az login

Разверните свой код в новом приложении-функции, используя целевой объект Maven azure-functions:deploy в новой конфигурации Run As (Выполнить как).Deploy your code into a new Function app using the azure-functions:deploy Maven goal in a new Run As configuration.

После завершения развертывания появится URL-адрес, который можно использовать для доступа к приложению-функции Azure:When the deploy is complete, you see the URL you can use to access your Azure function app:

[INFO] Successfully deployed Function App with package.
[INFO] Deleting deployment package from Azure Storage...
[INFO] Successfully deleted deployment package fabrikam-function-20170920120101928.20170920143621915.zip
[INFO] Successfully deployed Function App at https://fabrikam-function-20170920120101928.azurewebsites.net
[INFO] ------------------------------------------------------------------------

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

  • Дополнительные сведения о разработке функции Java см. в статье Azure Functions Java developer guide (Руководство разработчика Java для Функций Azure).Review the Java Functions developer guide for more information on developing Java functions.
  • Добавьте в проект дополнительные функции с помощью различных триггеров целевого объекта Mavenazure-functions:add.Add additional functions with different triggers to your project using the azure-functions:add Maven target.