这个快速入门旨在让您快速尝试使用几个常见的Cloudinary特性。它不一定采用编码最佳实践,您在这里创建的代码也不是用于生产的。
您可以在代码沙盒或您选择的开发环境中的干净项目中执行此快速启动。
您还可以在GitHub repo中查看此快速入门的完整代码。
提示:如果您不熟悉Cloudinary,您可能需要先看一看开发人员入门指南,了解将Cloudinari集成到您的代码中的高级概述,以及主要概念的介绍。
您还可能会发现我们的词汇表有助于理解Cloudinary特定的术语。
先决条件
要执行此快速入门中的步骤,您需要:
1.设置和配置库
将cloudinary和dotenv依赖项添加到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>
然后,在您的项目中,创建一个名为.env的文件,并在Cloudinary环境变量中添加以下行(用您自己的环境变量值替换下面的Cloudinary://
- // Copy and paste your API environment variable
-
- CLOUDINARY_URL=cloudinary://<API_KEY>:<API_SECRET>@<CLOUD_NAME>
更多信息
重要信息:编写自己的应用程序时,请遵守组织的存储机密政策,不要泄露API机密。
在代码中,在项目中包括以下Cloudinary库和dotenv库。将以下代码复制并粘贴到Main.java文件:
- // Import the required packages
-
- import com.cloudinary.*;
- import com.cloudinary.utils.ObjectUtils;
- import io.github.cdimascio.dotenv.Dotenv;
-
- import java.util.Map;
您现在可以从.env文件加载Cloudinary凭据,如下所示。将以下代码复制并粘贴到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.上传图像
将以下代码复制并粘贴到Main类中的try块中:
- // 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.获取图像的详细信息
- // Get the asset details
- Map params2 = ObjectUtils.asMap(
- "quality_analysis", true
- );
-
- System.out.println(
- cloudinary.api().resource("coffee_cup", params2));
4.转换上传的图像
- // 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.运行代码
通过单击主类上的Run按钮来运行代码。
您可以使用返回的图像标签在您的网站上显示图像。现在,复制并粘贴URL以在浏览器中查看转换后的图像:
https://res.cloudinary.com/demo/image/upload/b_auto:predominant,c_pad,h_400,w_300/coffee_cup
查看完成的代码
您可以在GitHub上找到完整的代码示例。