Creare la prima funzione con Java ed EclipseCreate your first function with Java and Eclipse

Questo articolo illustra come creare un progetto per funzioni senza server con l'IDE Eclipse e Apache Maven, testarlo ed eseguirne il debug e infine distribuirlo in Funzioni di 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.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Configurazione dell'ambiente di sviluppoSet up your development environment

Per sviluppare un'app per le funzioni con Java ed Eclipse, è necessario che siano installati gli elementi seguenti:To develop a functions app with Java and Eclipse, you must have the following installed:

Importante

Per completare questa guida introduttiva, è necessario impostare la variabile di ambiente JAVA_HOME sul percorso di installazione di JDK.The JAVA_HOME environment variable must be set to the install location of the JDK to complete this quickstart.

È altamente consigliabile installare anche gli strumenti di base di Funzioni di Azure, versione 2 che offrono un ambiente locale per l'esecuzione e il debug di Funzioni di 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.

Creare un progetto di FunzioniCreate a Functions project

  1. In Eclipse selezionare il menu file e quindi selezionare New- > Maven Project.In Eclipse, select the File menu, then select New -> Maven Project.
  2. Nella finestra di dialogo New Maven Project (Nuovo progetto Maven) accettare i valori predefiniti e scegliere Next (Avanti).Accept the defaults in the New Maven Project dialogue and select Next.
  3. Trovare e selezionare Azure-Functions-archetipo , quindi fare clic su Avanti.Find and select the azure-functions-archetype and click Next.
  4. Assicurarsi di inserire i valori per tutti i campi, ad esempio resourceGroup , appName e appRegion (usare un diverso AppName diverso da fabrikam-Function-20170920120101928) e infine terminare.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. Create2 di Eclipse MavenEclipse Maven create2

Maven crea i file di progetto in una nuova cartella denominata artifactId.Maven creates the project files in a new folder with a name of artifactId. Il codice generato nel progetto è una semplice funzione attivata tramite HTTP che restituisce il corpo della richiesta di attivazione dell'HTTP.The generated code in the project is a simple HTTP triggered function that echoes the body of the triggering HTTP request.

Eseguire le funzioni in locale nell'IDERun functions locally in the IDE

Nota

Per l'esecuzione e il debug delle funzioni in locale, è necessario che siano installati gli strumenti di base di Funzioni di Azure, versione 2.Azure Functions Core Tools, version 2 must be installed to run and debug functions locally.

  1. Fare clic con il pulsante destro del mouse sul progetto generato e quindi scegliere RunAs e Maven build (Compilazione di Maven).Right-click on the generated project, then choose Run As and Maven build.
  2. Nella finestra di dialogo Edit Configuration (Modifica configurazione) specificare package nei campi Goals (Obiettivi) e Name (Nome) e quindi selezionare Run (Esegui).In the Edit Configuration dialog, Enter package in the Goals and Name fields, then select Run. In questo modo verrà compilato e creato il pacchetto del codice funzione.This will build and package the function code.
  3. Una volta completata la compilazione, creare un'altra configurazione di esecuzione usando azure-functions:run come obiettivo e nome.Once the build is complete, create another Run configuration as above, using azure-functions:run as the goal and name. Selezionare Run (Esegui) per eseguire la funzione nell'ambiente IDE.Select Run to run the function in the IDE.

Dopo aver completato la procedura di test della funzione, terminare il runtime nella finestra della console.Terminate the runtime in the console window when you're done testing your function. Può essere attivo e in esecuzione in locale un solo host di funzioni alla volta.Only one function host can be active and running locally at a time.

Eseguire il debug della funzione in EclipseDebug the function in Eclipse

Nella procedura di configurazione Run As descritta nel passaggio precedente, sostituire azure-functions:run con azure-functions:run -DenableDebug ed eseguire la configurazione aggiornata per avviare l'app per le funzioni in modalità di debug.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.

Selezionare il menu Run (Esegui) e aprire Debug Configurations (Configurazioni di debug).Select the Run menu and open Debug Configurations. Scegliere Remote Java Application (Applicazione Java remota) e crearne una nuova.Choose Remote Java Application and create a new one. Assegnare un nome alla configurazione e specificare le impostazioni.Give your configuration a name and fill in the settings. La porta deve essere coerente con la porta di debug aperta dall'host di funzioni, che per impostazione predefinita è 5005.The port should be consistent with the debug port opened by function host, which by default is 5005. Al termine dell'installazione, fare clic su Debug per avviare il debug.After setup, click on Debug to start debugging.

Funzioni di debug in Eclipse

Impostare i punti di interruzione ed esaminare gli oggetti presenti nella funzione usando l'IDE.Set breakpoints and inspect objects in your function using the IDE. Al termine, arrestare il debugger e l'host di funzione in esecuzione.When finished, stop the debugger and the running function host. Può essere attivo e in esecuzione in locale un solo host di funzioni alla volta.Only one function host can be active and running locally at a time.

Distribuire la funzione in AzureDeploy the function to Azure

Il processo di distribuzione in Funzioni di Azure usa le credenziali dell'account dell'interfaccia della riga di comando di Azure.The deploy process to Azure Functions uses account credentials from the Azure CLI. Prima di continuare, accedere all'interfaccia della riga di comando di Azure usando il prompt dei comandi del computer.Log in with the Azure CLI before continuing using your computer's command prompt.

az login

Distribuire il codice in una nuova app per le funzioni usando la destinazione Maven azure-functions:deploy in una nuova configurazione RunAs.Deploy your code into a new Function app using the azure-functions:deploy Maven goal in a new Run As configuration.

Quando la distribuzione è stata completata, viene visualizzato l'URL da usare per accedere all'app per le funzioni di 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] ------------------------------------------------------------------------

Passaggi successiviNext steps

  • Vedere il manuale dello sviluppatore di funzioni Java per altre informazioni sullo sviluppo di funzioni Java.Review the Java Functions developer guide for more information on developing Java functions.
  • Al progetto aggiungere altre funzioni con trigger diversi usando la destinazione Maven azure-functions:add.Add additional functions with different triggers to your project using the azure-functions:add Maven target.