• Java Photo API Service
    • 1. 依赖
    • 2. 设置
    • 3. 创建一个Service - PhotoService.java
    • 4. 操作数据 - AlbumDao.java
    • 5. 创建Root Element - Album.java
    • 6. 构建
    • 7. 运行
    • 8. 了解更多。

    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

      • 点击Run按钮，并选择Run on Server。这将会在eclipse中打开一个浏览器，访问http://localhost:8080/PhotoAPIService/ 。

      • 在URL后面加上minio/photoservice/list，来查看json结果。完整的URL是http://localhost:8080/PhotoAPIService/minio/photoservice/list 。

      • 你也可以直接访问我们在play server上的示例。

    minio_JAVA11

    8. 了解更多。

    • Using minio-java library with Minio Server
    • Minio Java Client SDK API Reference

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