在您或您的用户将图像资产上传到Cloudinary后,您可以通过动态URL交付它们。您可以在动态URL中包含指令,告诉Cloudinary使用一组转换参数转换资产。所有转换都是在云中自动执行的,您的转换资产在通过快速CDN路由到最终用户以获得最佳用户体验之前会自动优化。
例如,您可以调整大小和裁剪,添加覆盖图像,模糊或像素化面部,应用各种特殊效果和过滤器,并应用设置来优化图像并做出响应。
Cloudinary的Java SDK简化了转换URL的生成,便于在Java应用程序中嵌入资产。
交付和转换图像
您可以使用生成图像标记的方法或通过直接的URL构建指令来交付图像。
图像标签
您可以使用Cloudinary的image标签或核心Java库的imageTag方法将图像添加到Java Enterprise Edition视图中。这两种方法都基于给定的转换参数生成完整的图像资源URL,并用具有适当属性的HTML图像标签包装它:
例如,使用示例公共ID显示上载的图像,同时提供备用文本:
<%@taglib uri="https://cloudinary.com/jsp/taglib" prefix="cl" %>
...
<cl:image src="sample.jpg" alt="Sample Image"/>
// Or using the core Java library:
Cloudinary cloudinary = new Cloudinary(); //configured using an environment variable
cloudinary.url().imageTag("sample.jpg", Cloudinary.asMap("alt","Sample Image"));
如果将cloud_name配置为demo,则此标记相当于:
<img src="https://res.cloudinary.com/demo/image/upload/sample.jpg"/>
您可以使用image标签或imageTag方法,通过添加转换说明来显示上传图像的转换版本。例如,显示调整大小以填充100x150区域的“示例”图像:
<cl:image src="sample.jpg" width="100" height="150" crop="fill"/>
// or
cloudinary.url()
.transformation(new Transformation().width(100).height(150).crop("fill"))
.imageTag("sample.jpg");
这将生成以下HTML:
<img src='https://res.cloudinary.com/demo/image/upload/c_fill,h_150,w_100/sample.jpg'
height='150' width='100'/>
此外,您可以向图像标签添加其他非转换参数,如资产版本、配置参数和HTML5图像标签属性。使用核心Java库,将任何HTML5图像标记属性直接传递给imageTag方法中的映射,并将其他非转换参数传递给url类的方法。
版本参数将添加到交付URL,如资产版本中所述。
您在此处指定的配置参数将覆盖您全局设置的任何参数。
HTML5图像标签属性(例如alt或class)被添加到生成的<img>标签中。
<cl:image src="docs/casual" width="500" height="500" crop="fill" cloudName="demo" secure="true" version="1573726751" alt="Casual Jacket" />
// or
cloudinary.url()
.transformation(new Transformation().width(500).height(500).crop("fill"))
.cloudName("demo")
.secure(true)
.version(1573726751)
.imageTag("docs/casual", Cloudinary.asMap(
"alt","Casual Jacket"));
编译为:
<img src="https://res.cloudinary.com/demo/image/upload/c_fill,h_500,w_500/v1573726751/docs/casual" height="500" alt="Casual Jacket">