Java Photo API Service

minio_JAVA1

本示例将会指导你如何使用Minio Server和Minio Java Client SDK构建一个非常简单的Java RESTful服务。

基于REST的应用通常是给移动端和web客户端提供服务。我们在本示例中创建的PhotoAPI Service将会给Android Photo App和Swift Photo App提供服务。

你可以通过这里获取完整的代码，代码是以Apache 2.0 License发布的。

1. 依赖

我们将使用Ecilpese IDE进行开发，同时需要用到Jersey，JSON和asm这几个包。

  • Eclipse
  • Jersey Bundle
  • Jersey Server
  • Jersey Core

  • JSON and asm

    2. 设置

  • 步骤1 - 创建你的album存储桶

mc mb play/album

mc cp ~/Downloads/Pic-1.jpg play/album/
mc cp ~/Downloads/Pic-2.jpg play/album/
mc cp ~/Downloads/Pic-3.jpg play/album/

  • 步骤2 - 使用mc policy命令可以将存储桶设为可公开读写。更多关于mc policy命令的细节，请参考这里。

mc policy public play/album

minio-album.png

  • 步骤3 - 启动Eclipse -> New Project -> Create a Dynamic Web Project。
    将你的工程命名为PhotoAPIService

minio-server-TomCatv8.5.png

  • 步骤4 - 将你的项目设为Maven项目
    minio_JAVA3

  • 步骤5 - 创建一个新的pom.xml。
    这个pom.xml需要有Maven需要的所有配置信息。

minio_JAVA4

  • 步骤6 - 按下面所示在pom.xml中引入minio和其它需要的依赖。

下面是全部配置好的pom.xml。

minio-dependencies3.0.6

  1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  2.   <modelVersion>4.0.0</modelVersion>
  3.   <groupId>PhotoAPIService</groupId>
  4.   <artifactId>PhotoAPIService</artifactId>
  5.   <version>0.0.1-SNAPSHOT</version>
  6.   <packaging>war</packaging>
  7.   <build>
  8.     <sourceDirectory>src</sourceDirectory>
  9.     <plugins>
  10.       <plugin>
  11.         <artifactId>maven-compiler-plugin</artifactId>
  12.         <version>3.1</version>
  13.         <configuration>
  14.           <source>1.8</source>
  15.           <target>1.8</target>
  16.         </configuration>
  17.       </plugin>
  18.       <plugin>
  19.         <artifactId>maven-war-plugin</artifactId>
  20.         <version>2.4</version>
  21.         <configuration>
  22.           <warSourceDirectory>WebContent</warSourceDirectory>
  23.           <failOnMissingWebXml>false</failOnMissingWebXml>
  24.         </configuration>
  25.       </plugin>
  26.     </plugins>
  27.   </build>
  28.    <dependencies>
  29.         <dependency>
  30.             <groupId>asm</groupId>
  31.             <artifactId>asm</artifactId>
  32.             <version>3.3.1</version>
  33.         </dependency>
  34.         <dependency>
  35.             <groupId>com.sun.jersey</groupId>
  36.             <artifactId>jersey-bundle</artifactId>
  37.             <version>1.19</version>
  38.         </dependency>
  39.         <dependency>
  40.             <groupId>org.json</groupId>
  41.             <artifactId>json</artifactId>
  42.             <version>20140107</version>
  43.         </dependency>
  44.         <dependency>
  45.             <groupId>com.sun.jersey</groupId>
  46.             <artifactId>jersey-server</artifactId>
  47.             <version>1.19</version>
  48.         </dependency>
  49.         <dependency>
  50.             <groupId>com.sun.jersey</groupId>
  51.             <artifactId>jersey-core</artifactId>
  52.             <version>1.19</version>
  53.         </dependency>
  54.         <dependency>
  55.             <groupId>io.minio</groupId>
  56.             <artifactId>minio</artifactId>
  57.             <version>3.0.6</version>
  58.         </dependency>
  59.   </dependencies>
  60. </project>
  • 步骤7 - 设置web.xml
    web.xml在\WebContent\WEB-INF\目录下。如果你那没有，你可以通过PhotoAPIService -> 右键单击 -> Java EE Tools -> Generate Deployment Descriptor Stub生成一个。

minio_JAVA6

修改web.xml，按下面所示添加servlet配置。

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" version="3.1">
  3.   <display-name>PhotoAPIService</display-name>
  4.   <welcome-file-list>
  5.     <welcome-file>index.html</welcome-file>
  6.     <welcome-file>index.htm</welcome-file>
  7.     <welcome-file>index.jsp</welcome-file>
  8.     <welcome-file>default.html</welcome-file>
  9.     <welcome-file>default.htm</welcome-file>
  10.     <welcome-file>default.jsp</welcome-file>
  11.   </welcome-file-list>
  12.   <servlet>
  13.         <servlet-name>Jersey Web Application</servlet-name>
  14.         <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>
  15.         <load-on-startup>1</load-on-startup>
  16.     </servlet>
  17.     <servlet-mapping>
  18.         <servlet-name>Jersey Web Application</servlet-name>
  19.         <url-pattern>/minio/*</url-pattern>
  20.     </servlet-mapping>
  22. </web-app>

3. 创建一个Service - PhotoService.java

创建一个PhotoService.java文件，添加listAlbums方法，调用这个方法返回图片url的json数组。

  1. package com.minio.photoapiservice;
  3. import java.io.IOException;
  4. import java.security.InvalidKeyException;
  5. import java.security.NoSuchAlgorithmException;
  6. import java.util.List;
  8. import javax.ws.rs.GET;
  9. import javax.ws.rs.Path;
  10. import javax.ws.rs.Produces;
  11. import javax.ws.rs.core.Context;
  12. import javax.ws.rs.core.MediaType;
  13. import javax.ws.rs.core.UriInfo;
  15. import org.xmlpull.v1.XmlPullParserException;
  17. import io.minio.errors.MinioException;
  19. @Path("/photoservice")
  20. public class PhotoService {
  21.     // Initialize new album service.
  22.     AlbumDao albumDao = new AlbumDao();
  24.     // Define GET method and resource.
  25.     @GET
  26.     @Path("/list")
  27.     @Produces({MediaType.APPLICATION_JSON})
  28.     public List<Album> listAlbums() throws InvalidKeyException,
  29.             NoSuchAlgorithmException, IOException,
  30.             XmlPullParserException, MinioException {
  32.         // Return list of albums.
  33.         return albumDao.listAlbums();
  34.     }
  35. }

4. 操作数据 - AlbumDao.java

为了简单起见，在本示例中我们没有用到数据库。listAlbums()是连接到Minio Server并调用listObjects方法，并包装成Album对象的List。album对象里含有过期时间为一天的presigned URL。

每次调用这个list接口，我们都会生成一个新的过期时间为一天的presigned URL。presigned URL很适合用于分享的应用场景，我们推荐你在合适的应用场景下使用。

更多关于presignedGetObject的细节，请看这里。

  1. package com.minio.photoapiservice;
  3. import java.util.ArrayList;
  4. import java.util.List;
  5. import java.util.ArrayList;
  6. import java.util.Iterator;
  7. import java.util.List;
  8. import java.io.IOException;
  9. import java.security.NoSuchAlgorithmException;
  10. import java.security.InvalidKeyException;
  12. import org.json.JSONArray;
  13. import org.xmlpull.v1.XmlPullParserException;
  15. import io.minio.MinioClient;
  16. import io.minio.Result;
  17. import io.minio.messages.Bucket;
  18. import io.minio.messages.Item;
  19. import io.minio.errors.MinioException;
  21. public class AlbumDao {
  22.     public List<Album> listAlbums() throws NoSuchAlgorithmException,
  23.             IOException, InvalidKeyException, XmlPullParserException, MinioException {
  25.         List<Album> list = new ArrayList<Album>();
  26.         final String minioBucket = "albums";
  28.         // Initialize minio client object.
  29.         MinioClient minioClient = new MinioClient("play.minio.io", 9000,
  30.                                                   "Q3AM3UQ867SPQQA43P2F",
  31.                                                   "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG");
  33.         // List all objects.
  34.         Iterable<Result<Item>> myObjects = minioClient.listObjects(minioBucket);
  36.         // Iterate over each elements and set album url.
  37.         for (Result<Item> result : myObjects) {
  38.             Item item = result.get();
  39.             System.out.println(item.lastModified() + ", " + item.size() + ", " + item.objectName());
  41.             // Create a new Album Object
  42.             Album album = new Album();
  44.             // Set the presigned URL in the album object
  45.             album.setUrl(minioClient.presignedGetObject(minioBucket, item.objectName(), 60 * 60 * 24));
  47.             // Add the album object to the list holding Album objects
  48.             list.add(album);
  50.         }
  52.         // Return list of albums.
  53.         return list;
  54.     }
  55. }

5. 创建Root Element - Album.java

Root element用于持有Album的数据，url是它的一个属性。

  1. package com.minio.photoapiservice;
  3. import java.util.ArrayList;
  4. import javax.xml.bind.annotation.XmlRootElement;
  6. @XmlRootElement(name = "Album")
  7. public class Album {
  8.     private String url;
  9.     private String description;
  11.     public String getUrl() {
  12.         return url;
  13.     }
  15.     public void setUrl(String url) {
  16.         this.url = url;
  17.     }
  19.     public String getDescription() {
  20.         return description;
  21.     }
  23.     public void setDescription(String description) {
  24.         this.description = description;
  25.     }
  26. }

6. 构建

选中项目，运行mvn clean install进行构建。 

  1. Project -> Run -> Maven Clean
  2. Project -> Run -> Maven Install

minio_JAVA7

maven install成功后，你应该可以在控制台中看见"BUILD SUCCESS"的信息，这时候我们就可以进行部署了。

minio_JAVA8

7. 运行

  • 步骤1 - 配置Tomcat

    • 点击Servers -> New
    • 选中Tomcat v8.5.16 Server将点击Next
      minio-server-TomCatv8.5

  • 步骤2 - 将你的项目加入到Server中

    • 点击Server-> Add / Remove Projects。
    • 选中项目并点击Add。
      minio_JAVA10

  • 步骤3 - 运行Server

minio_JAVA11

8. 了解更多。

原文: https://docs.minio.io/cn/java-photo-api-service.html