Java Photo API Service

minio_JAVA1

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

基于REST的应用通常是给移动端和web客户端提供服务。我们在本示例中创建的PhotoAPI Service将会给Android Photo AppSwift 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. <projectxmlns="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-appxmlns: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>
  21. </web-app>

3. 创建一个Service - PhotoService.java

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

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

4. 操作数据 - AlbumDao.java

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

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

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

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

5. 创建Root Element - Album.java

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

  1. package com.minio.photoapiservice;
  2. import java.util.ArrayList;
  3. import javax.xml.bind.annotation.XmlRootElement;
  4. @XmlRootElement(name ="Album")
  5. publicclassAlbum{
  6. privateString url;
  7. privateString description;
  8. publicString getUrl(){
  9. return url;
  10. }
  11. publicvoid setUrl(String url){
  12. this.url = url;
  13. }
  14. publicString getDescription(){
  15. return description;
  16. }
  17. publicvoid setDescription(String description){
  18. this.description = description;
  19. }
  20. }

6. 构建

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

  1. Project->Run->MavenClean
  2. Project->Run->MavenInstall

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