View Javadoc

1   /**
2    *
3    * Copyright (C) 2011 Cloud Conscious, LLC. <info@cloudconscious.com>
4    *
5    * ====================================================================
6    * Licensed under the Apache License, Version 2.0 (the "License");
7    * you may not use this file except in compliance with the License.
8    * You may obtain a copy of the License at
9    *
10   * http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing, software
13   * distributed under the License is distributed on an "AS IS" BASIS,
14   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15   * See the License for the specific language governing permissions and
16   * limitations under the License.
17   * ====================================================================
18   */
19  package org.jclouds.blobstore;
20  
21  import org.jclouds.blobstore.domain.Blob;
22  import org.jclouds.blobstore.domain.BlobBuilder;
23  import org.jclouds.blobstore.internal.BlobMapImpl;
24  import org.jclouds.blobstore.options.ListContainerOptions;
25  
26  import com.google.inject.ImplementedBy;
27  
28  /**
29   * This allows you to access the underlying {@link Blob} so that you can manually set metadata such
30   * as length, content-type, or eTag hash.
31   * 
32   * @author Adrian Cole
33   * 
34   */
35  @ImplementedBy(BlobMapImpl.class)
36  public interface BlobMap extends ListableMap<String, Blob> {
37     /**
38      * @see #blobBuilder
39      * @param name
40      */
41     @Deprecated
42     Blob newBlob(String name);
43  
44     /**
45      * 
46      * @return builder for creating new {@link Blob}s
47      */
48     BlobBuilder blobBuilder();
49  
50     public static interface Factory {
51        BlobMap create(String containerName, ListContainerOptions options);
52     }
53  
54  }