Démarrage rapide de Java

Ce guide de démarrage rapide est conçu pour vous donner un aperçu rapide de quelques fonctionnalités Cloudinary courantes. Il n'utilise pas nécessairement les meilleures pratiques de codage, et le code que vous créez ici n'est pas destiné à la production.
Vous pouvez effectuer ce démarrage rapide dans un sandbox de code ou un projet propre dans l'environnement de développement de votre choix.
Vous pouvez également afficher le code complet de ce démarrage rapide dans le référentiel GitHub.

Conseil : Si vous débutez avec Cloudinary, vous voudrez peut-être d'abord consulter le Guide de démarrage du développeur pour un aperçu de haut niveau de l'intégration de Cloudinari dans votre code, ainsi qu'une introduction aux principaux concepts.
Vous pouvez également trouver notre glossaire utile pour comprendre les termes spécifiques à Cloudinary.


Prérequis
Pour effectuer les étapes de ce guide de démarrage rapide, vous avez besoin :

• Compte multimédia programmable Cloudinary. Si vous ne l'avez pas déjà fait, vous pouvez vous inscrire rapidement et gratuitement.
• vos identifiants de compte. Vous pouvez trouver vos identifiants sur la page Tableau de bord de la console Cloudinary.
• Un environnement Java fonctionnel prenant en charge la version Java.
• Un projet Java propre utilisant Maven.

1. Installez et configurez la bibliothèque
Ajoutez les dépendances cloudinary et dotenv à la liste des dépendances dans pom.xml :

<dependency>
    <groupId>com.cloudinary</groupId>
    <artifactId>cloudinary-http44</artifactId>
    <version>1.32.2</version>
</dependency>
<dependency>
    <groupId>com.cloudinary</groupId>
    <artifactId>cloudinary-taglib</artifactId>
    <version>1.32.2</version>
</dependency>
<dependency>
    <groupId>io.github.cdimascio</groupId>
    <artifactId>dotenv-java</artifactId>
    <version>2.2.4</version>
</dependency>

Ensuite, dans votre projet, créez un fichier appelé .env et ajoutez la ligne suivante aux variables d'environnement Cloudinary (remplacez Cloudinary://<API_KEY> ci-dessous par votre propre valeur de variable d'environnement : <API_SECRET>@< CLOUD_NAME>) :

// Copy and paste your API environment variable

CLOUDINARY_URL=cloudinary://<API_KEY>:<API_SECRET>@<CLOUD_NAME>

PLUS D'INFORMATIONS
IMPORTANT : lorsque vous écrivez vos propres applications, suivez la politique de confidentialité du stockage de votre organisation et ne révélez pas les secrets de l'API.

Dans le code, incluez la bibliothèque Cloudinary et la bibliothèque dotenv suivantes dans le projet. Copiez et collez le code suivant dans le fichier Main.java :

// Import the required packages

import com.cloudinary.*;
import com.cloudinary.utils.ObjectUtils;
import io.github.cdimascio.dotenv.Dotenv;

import java.util.Map;

Vous pouvez maintenant charger les informations d'identification Cloudinary à partir du fichier .env comme indiqué ci-dessous. Copiez et collez le code suivant dans la classe Main :

// Set your Cloudinary credentials

Dotenv dotenv = Dotenv.load();
Cloudinary cloudinary = new Cloudinary(dotenv.get("CLOUDINARY_URL"));
cloudinary.config.secure = true;
System.out.println(cloudinary.config.cloudName);

2. Téléchargez l'image
Copiez et collez le code suivant dans le bloc try de la classe Main :

// Upload the image
Map params1 = ObjectUtils.asMap(
    "use_filename", true,
    "unique_filename", false,
    "overwrite", true
);

System.out.println(
        cloudinary.uploader().upload("https://cloudinary-devs.github.io/cld-docs-assets/assets/images/coffee_cup.jpg", params1));

3. Obtenez les informations détaillées de l'image

// Get the asset details
Map params2 = ObjectUtils.asMap(
        "quality_analysis", true
);

System.out.println(
        cloudinary.api().resource("coffee_cup", params2));

4. Convertir les images téléchargées

// Create the image tag with the transformed image and log it to the console
System.out.println(
        cloudinary.url().transformation(new Transformation()
        .crop("pad")
        .width(300)
        .height(400)
        .background("auto:predominant"))
        .imageTag("coffee_cup"));

// The code above generates an HTML image tag similar to the following:
//  <img src='https://res.cloudinary.com/demo/image/upload/b_auto:predominant,c_pad,h_400,w_300/coffee_cup' height='400' width='300'/>

5. Exécutez le code
Exécutez le code en cliquant sur le bouton Exécuter de la classe principale.
Vous pouvez afficher des images sur votre site Web à l'aide de la balise d'image renvoyée. Maintenant, copiez et collez l'URL pour afficher l'image convertie dans votre navigateur :

https://res.cloudinary.com/demo/image/upload/b_auto:predominant,c_pad,h_400,w_300/coffee_cup

Découvrez le code terminé
Vous pouvez trouver un exemple de code complet sur GitHub.