Blobstore API允许你的应用程序使用（serve）叫做Blobs的数据对象。这种数据对象比Datastore服务所允许的对象的尺寸大得多。Blobs能有效地为大文件比如视频、图片提供服务，允许用户上传大数据文件。通过HTTP请求上传一个文件来创建Blobs。通常，你的应用程序通过向用户呈现一个表格(form)和一个文件上传区域（a file upload field）来实现。当这个表格被提交的时候，Blobstore会从文件的内容来创建一个Blob，并且返回一个指向blob的叫做blob key的不透明引用。在之后可以使用它使用（serve）这个blob。应用程序可以提供（serve）这个完整的blob值来响应用户的请求，或者可以使用一个类流文件接口（streaming file-like interface）直接读取blob值。

Blobstore简介

GAE包含了Blobstore服务，它允许应用使用（serve）数据对象，仅受限于数据的数量，可以通过一个HTTP连接上传下载。这些对象被叫做Blobstore values或blobs。Blobstore values 被作为来自请求处理的响应，通过Web forms上传时被创建（Blobstore values are served as response from request handlers and are created as uploads via web forms）。应用不直接创建Blob数据；blobs通过一个被提交的web form或HTTP post请求来间接创建的。Blobstore values可以被用户使用或者在类文件流中被应用访问。（使用Blobstore API）

注意：Blobstore服务创建的Blobs与datastore使用的blob属性值没有关系。

你的应用通过呈现一个web form和文件上传区域来提示用户上传一个Blobstore value。应用通过调用Blobstore API来产生表格的action URL。用户的浏览器通过这个生成的URL直接将文件上传到Blobstore。然后Blobstore存储这个blob，重写这个请求来包含这个blob key，将它传递到你的应用的一个路径。在你的应用的那个路径的一个请求处理可以执行额外的表格处理。

为了使用（serve）一个blob，你的应用在输出响应设置一个头部，App Engine会用这个blob value 取代这个响应。

Blobs在创建之后不能够被修改，但是可以被删除。每个blob有一个相应的blob info record。它被存储在datastore,包含了这个Blob的详细，比如它的创建时间和文本类型。你可以使用这个blob key去获取blob info record和查询他们的属性。

应用可以使用一个API调用，一次读取一个Blobstore value一部分。这个部分的尺寸可以是一个API返回值的最大尺寸。这个尺寸小于32M，在Java中由com.google.appengine.api.blobstore.BlobstoreService.MAX_BLOB_FETCH_SIZE表示。应用不能够创建和修改Blobstore values，除非用户上传文件。

使用Blobstore

应用可以使用Blobstore来接受来自用户上传的大文件以及使用（serve）这些文件。文件一旦被上传，其就被称为blobs。应用不直接访问blobs。而是通过在datastore中的blob info 实体一起工作（呈现为BlobInfo类）。

用户通过提交一个包含了一个或多个文件输入字段的HTML表格创建一个blob。你的应用设置 blobstoreService.createUploadUrl() 作为这个表格的目标地址（action），在应用中传递给这个函数一个处理（handler）的URL路径。当用户提交这个表格时，用户的浏览器直接上传指定的文件到Blobstore中。Blobstore重写用户的请求并且存储上传的文件数据，用一个或多个相应的blob key取代上传的文件数据，然后传递这个重写的请求到在你提供给blobstoreService.createUploadUrl()的URL上的处理（handler）。这个处理（handler）可以基于blob key来处理额外的处理（processing）。

应用可以使用类文件流接口读取Blobstore value的部分。参见BlobstoreInputStream类。

上传一个Blob

为了创建和上传一个blob，遵循以下步骤。

1.创建一个upload URL

调用blobstoreService.createUploadUrl() 来为用户将会填充的表格创建一个upload URL，当表格的Post完成时，传递这个应用的路径来加载。

  1. <body>
  2.     <form action="<%= blobstoreService.createUploadUrl("/upload") %>" method="post" enctype="multipart/form-data">
  3.         <input type="file" name="myFile">
  4.         <input type="submit" value="Submit">
  5.     </form>
  6. </body>

注意如果它是用JSP创建的话，这就是上传表格的样子。

2.创建一个上传表格

这个表格必须包含文件上传字段，表格的enctype必须被设置为multipart/form-data。当用户提交这个表格时，这个POST被Blobstore API处理，创建blob。这个API也为blob创建一个info record，并且将这个record存储在datastore中，在给定的路径上以blob key的形式传递这个重写请求到你的应用。

3.实现上传处理。

在这个处理中，你可以用你的应用的数据模型的其余部分存储blob key。这个blob key可以访问在datastore中的blob info实体。注意在用户提交表格以及你的处理被调用之后，这个blob已经被保存了，blob info被添加到了datastore。如果你的应用不想保留这个blob，你应当立即删除这个blob，防止它成为孤立的。

在下面的代码中，getUploads返回了已经上传的blobs集合。Map对象是一个列表，关联了上传字段的名字和blobs。

  1. Map<String, List<BlobKey>> blobs = blobstoreService.getUploads(req);
  2. List<BlobKey> blobKeys = blobs.get("myFile");
  3.  
  4. if (blobKeys == null || blobKeys.isEmpty()) {
  5.     res.sendRedirect("/");
  6. } else {
  7.     res.sendRedirect("/serve?blob-key=" + blobKeys.get(0).getKeyString());
  8. }

当Blobstore重写用户的请求时，上传文件的MIME部分使他们的bodies清空，这个blob key被添加作为MIME部分的头。所有的其他表格字段和部分被保存、传递给上传处理（upload handler）。如果你不指定文本类型，Blobstore会尝试从文件的扩展名来推断。如果文本类型不能确定，这个新建的blob的文本类型被分配为application/octet-stream。

使用（serve）一个blob

注意：如果你使用（serve）图片，一个更有效、可能更便宜的方法是使用getServingUrl()使用App Engine images API而不是blobstoreService.serve().这个getServingUrl()方法可让你直接使用（serve）图片，不必通过你的App Engine实例。

为了使用（serve）blobs，在应用中你必须包含一个下载处理[as a path]。这个处理应当传递想要的blob的blob key到blobstoreService.serve(blobKey, res)。在这个例子中，这个blob key作为URL参数被传递给下载处理(req.getParameter('blob-key'))。在实践中，下载处理可以通过多种方式获得blob key。比如通过其他方法或用户操作（user action）。

  1. public void doGet(HttpServletRequest req, HttpServletResponse res)
  2.     throws IOException {
  3.         BlobKey blobKey = new BlobKey(req.getParameter("blob-key"));
  4.         blobstoreService.serve(blobKey, res);

Blobs can be served from any application URL. To serve a blob in your application, 在包含blob key的响应中放置一个特别的头。App Engine使用blob的文本取代响应的body。

Blob字节范围

Blobstore支持提供（serve）一个大值的部分而不是值的全部来响应一个请求。为了提供部分值，在输出响应中包含X-AppEngine-BlobRange头部。它的值是一个标准的HTTP字节范围。这个字节编号从0开始。空白的X-AppEngine-BlobRange指示API忽略这个范围头，提供整个blob。例子范围包括：

0-499提供value的前500字节。

500-999提供从第501个字节开始的500个字节。

500-提供从第501个字节开始到最后的所有字节。

-500提供value的最后500个字节。

如果这个字节范围对Blobstore value来讲是有效的话，那么Blobstore会发出一个206 partial Content状态代码和请求的字节范围到客户端。如果这个范围不是有效的，Blobstore会发出416 Requested Range Not Satisfiable。

Blobstore不支持在一个请求中的多字节范围（比如，100-199,200-299），无论他们是否重叠。

完整的例子应用

在接下来的例子应用中，应用的主URL加载向用户寻求文件上传的表格，上传处理立即调用下载处理来提供（serve）数据。这是为了简化例子应用。在实践中，你可能不使用主URL来请求上传数据，也不立即提供你刚刚上传的blob。

  1. // file Upload.java
  2.  
  3. import java.io.IOException;
  4. import java.util.List;
  5. import java.util.Map;
  6.  
  7. import javax.servlet.ServletException;
  8. import javax.servlet.http.HttpServlet;
  9. import javax.servlet.http.HttpServletRequest;
  10. import javax.servlet.http.HttpServletResponse;
  11.  
  12. import com.google.appengine.api.blobstore.BlobKey;
  13. import com.google.appengine.api.blobstore.BlobstoreService;
  14. import com.google.appengine.api.blobstore.BlobstoreServiceFactory;
  15.  
  16. public class Upload extends HttpServlet {
  17.     private BlobstoreService blobstoreService = BlobstoreServiceFactory.getBlobstoreService();
  18.  
  19.     @Override
  20.     public void doPost(HttpServletRequest req, HttpServletResponse res)
  21.         throws ServletException, IOException {
  22.  
  23.         Map<String, List<BlobKey>> blobs = blobstoreService.getUploads(req);
  24.         List<BlobKey> blobKeys = blobs.get("myFile");
  25.  
  26.         if (blobKeys == null || blobKeys.isEmpty()) {
  27.             res.sendRedirect("/");
  28.         } else {
  29.             res.sendRedirect("/serve?blob-key=" + blobKeys.get(0).getKeyString());
  30.         }
  31.     }
  32. }
  33.  
  34. // file Serve.java
  35.  
  36. import java.io.IOException;
  37.  
  38. import javax.servlet.http.HttpServlet;
  39. import javax.servlet.http.HttpServletRequest;
  40. import javax.servlet.http.HttpServletResponse;
  41.  
  42. import com.google.appengine.api.blobstore.BlobKey;
  43. import com.google.appengine.api.blobstore.BlobstoreService;
  44. import com.google.appengine.api.blobstore.BlobstoreServiceFactory;
  45.  
  46. public class Serve extends HttpServlet {
  47.     private BlobstoreService blobstoreService = BlobstoreServiceFactory.getBlobstoreService();
  48.  
  49.     @Override
  50.     public void doGet(HttpServletRequest req, HttpServletResponse res)
  51.         throws IOException {
  52.             BlobKey blobKey = new BlobKey(req.getParameter("blob-key"));
  53.             blobstoreService.serve(blobKey, res);
  54.         }
  55. }
  56.  
  57. // file index.jsp
  58.  
  59. <%@ page import="com.google.appengine.api.blobstore.BlobstoreServiceFactory" %>
  60. <%@ page import="com.google.appengine.api.blobstore.BlobstoreService" %>
  61.  
  62. <%
  63.     BlobstoreService blobstoreService = BlobstoreServiceFactory.getBlobstoreService();
  64. %>
  65.  
  66. <html>
  67.     <head>
  68.         <title>Upload Test</title>
  69.     </head>
  70.     <body>
  71.         <form action="<%= blobstoreService.createUploadUrl("/upload") %>" method="post" enctype="multipart/form-data">
  72.             <input type="text" name="foo">
  73.             <input type="file" name="myFile">
  74.             <input type="submit" value="Submit">
  75.         </form>
  76.     </body>
  77. </html>
  78.  
  79. // web.xml
  80.  
  81. <?xml version="1.0" encoding="utf-8"?>
  82. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  83.    xmlns="http://java.sun.com/xml/ns/javaee"
  84.    xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
  85.    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
  86.    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5">
  87.  
  88.   <servlet>
  89.     <servlet-name>Upload</servlet-name>
  90.     <servlet-class>Upload</servlet-class>
  91.   </servlet>
  92.  
  93.   <servlet>
  94.     <servlet-name>Serve</servlet-name>
  95.     <servlet-class>Serve</servlet-class>
  96.   </servlet>
  97.  
  98.   <servlet-mapping>
  99.     <servlet-name>Upload</servlet-name>
  100.     <url-pattern>/upload</url-pattern>
  101.   </servlet-mapping>
  102.  
  103.   <servlet-mapping>
  104.     <servlet-name>Serve</servlet-name>
  105.     <url-pattern>/serve</url-pattern>
  106.   </servlet-mapping>
  107.  
  108. </web-app>

和Blobstore一起使用Images服务

Images服务可以使用Blobstore value作为转换的源。源图像（source image）可以和Blobstore value的最大尺寸一样大。Image服务依然返回转换后的图像到应用，所以转换后的图像必须小于32M。这对于生成用户上传的大图像的缩略图是有用的。

关于和Blobstore一起使用Image服务的信息，参见Image Service documentation。

和Google Cloud Storage一起使用Blobstore API

你可以使用Blobstore API将blobs存在在Google Cloud Storage而不是Blobstore中。你需要创建一个在Google Cloud Storage文档中称为bucket的东西。在BlobstoreService createUploadUrl中指定这个bucket,在UploadOptions参数中指定bucket名称。在你的上传处理（upload handler）中，你需要处理这个返回的FileInfo元数据，以及显示地存储Google Cloud Storage文件名。这个文件名在之后需要用来取回blob。

你也可以使用Blobstore API使用Google Cloud Storage。下面的代码片段展示了如何实现：

这个例子是在一个请求处理中，在这个请求中获取了bucket名字和对象名。它创建了Blobstore service，使用它以及提供的bucket和对象名创建用于Google Cloud Storage的blob key。

  1. BlobstoreService blobstoreService = BlobstoreServiceFactory.getBlobstoreService();
  2. BlobKey blobKey = blobstoreService.createGsBlobKey(
  3.     "/gs/" + fileName.getBucketName() + "/" + fileName.getObjectName());
  4. blobstoreService.serve(blobKey, resp);

Note: Once you obtain a blobKey for the Google Cloud Storage object, you can pass it around, serialize it, and otherwise use it interchangeably anywhere you can use a blobKey for objects stored in Blobstore. This allows for usage where an app stores some data in blobstore and some in Google Cloud Storage, but treats the data otherwise identically by the rest of the app. (However, BlobInfo objects are currently not available for Google Cloud Storage objects.)

使用Files API将文件写到Blobstore（已过时）

警告：此处使用的写文件到Blobstore的Files API已经过时了，将会被移除。参见Files API Service Turndown

。。。。。。

配额和限制

Blobstore values的使用空间contributes to Stored Data（计费）的配额。

在datastore中的Blob info entities 数量是datastore相关的限制。

整个系统的安全配额参见Quotas,the Administration Console的Quota Details部分。

为了整个系统的安全配额，对于Blobstore的使用有一个限制。可以被应用一次API调用读取的Blobstore数据的最大尺寸是32M。

源地址：Blobstore Java API Overview

Blobstore Java API overview的更多相关文章

  1. jboss7 Java API for RESTful Web Services (JAX-RS) 官方文档

    原文:https://docs.jboss.org/author/display/AS7/Java+API+for+RESTful+Web+Services+(JAX-RS) Content Tuto ...

  2. Java NIO Overview

    Java NIO Overview Channels and Buffers Selectors   Jakob JenkovLast update: 2014-06-23

  3. 教你查阅Java API 英文文档（JDK 11）

    JAVA Document:https://docs.oracle.com/en/java/javase/11/ 然后找到“Specifications”并点击 API Documentation 比 ...

  4. Atitit 图像处理 调用opencv 通过java  api   attilax总结

    Atitit 图像处理 调用opencv 通过java  api   attilax总结 1.1. Opencv java api的支持 opencv2.4.2 就有了对java api的支持1 1. ...

  5. 【分布式】Zookeeper使用--Java API

    一.前言 上一篇博客我们通过命令行来操作Zookeper的客户端和服务端并进行相应的操作,这篇主要介绍如何通过API(JAVA)来操作Zookeeper. 二.开发环境配置 首先打开Zookeeper ...

  6. Elasticsearch的CRUD：REST与Java API

    CRUD(Create, Retrieve, Update, Delete)是数据库系统的四种基本操作,分别表示创建.查询.更改.删除,俗称"增删改查".Elasticsearch ...

  7. [转]HDFS中JAVA API的使用

    HDFS是一个分布式文件系统,既然是文件系统,就可以对其文件进行操作,比如说新建文件.删除文件.读取文件内容等操作.下面记录一下使用JAVA API对HDFS中的文件进行操作的过程. 对分HDFS中的 ...

  8. HDFS中JAVA API的使用

    HDFS中JAVA API的使用   HDFS是一个分布式文件系统,既然是文件系统,就可以对其文件进行操作,比如说新建文件.删除文件.读取文件内容等操作.下面记录一下使用JAVA API对HDFS中的 ...

  9. java安全沙箱（四）之安全管理器及Java API

    java是一种类型安全的语言,它有四类称为安全沙箱机制的安全机制来保证语言的安全性,这四类安全沙箱分别是: 类加载体系 .class文件检验器 内置于Java虚拟机(及语言)的安全特性 安全管理器及J ...

随机推荐

  1. python——操作符重载（重要）

    类可以重载python的操作符   旧认识:__X__的名字 是系统定义的名字:是python特殊方法专用标识.   操作符重载使我们的对象与内置的一样.__X__的名字的方法是特殊的挂钩(hook) ...

  2. Linux——环境变量的文件及配置

    环境变量是包含关于系统及当前登录用户的环境信息的字符串,一些软件程序使用此信息确定在何处放置文件(如临时文件). 一.环境变量文件介绍 转自:http://blog.csdn.net/cscmaker ...

  3. web前端性能优化汇总

    一.概述 web前端性能优化主要点为:减少HTTP请求,减小请求文件大小.其他优化. 二.优化细节 1.减少HTTP请求 (1)使用缓存 (2)雪碧图 (3)合并文件 (4)将javascript和c ...

  4. KeePass 不能复制账号密码

    最近一段时间发现 KeePass 不能复制账号密码了, 程序也没有任何错误提示, 没有办法定位原因, 这个就难办了. 网上搜索后发现这个帖子 Can't paste in gnome-terminal ...

  5. 51单片机 | 模拟PWM调制控制实验

    ———————————————————————————————————————————— PWM(脉冲宽度调制) 对模拟信号电平进行数字编码的方法 - - - - - - - - - - - - - ...

  6. rabbit 函数参数详解

    http://blog.csdn.net/chwshuang/article/details/50512057 http://www.cnblogs.com/LiangSW/p/6224333.htm ...

  7. LoadRunner调用md5方法

    LoadRunner调用md5方法 上一篇 / 下一篇  2011-04-29 11:25:12 / 个人分类:Loadrunner 查看( 958 ) / 评论( 0 ) / 评分( 0 / 0 ) ...

  8. [linux]netstat命令详解-显示linux中各种网络相关信息

    1.功能与说明 netstat 用于显示linux中各种网络相关信息.如网络链接 路由表  接口状态链接 多播成员等等. 2.参数含义介绍 -a (all)显示所有选项,默认不显示LISTEN相关-t ...

  9. UVa 437 The Tower of Babylon(DP 最长条件子序列)

     题意  给你n种长方体  每种都有无穷个  当一个长方体的长和宽都小于还有一个时  这个长方体能够放在还有一个上面  要求输出这样累积起来的最大高度 由于每一个长方体都有3种放法  比較不好控制 ...

  10. jar包解压与打包

    首先感谢大神的指导:https://blog.csdn.net/mr_pang/article/details/47028921 1.首先准备一个能运行的jar文件,我们使用第三方解压工具进行解压wi ...