| OLD | NEW |
| 1 // Copyright 2015 The Chromium Authors. All rights reserved. | 1 // Copyright 2015 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 [DartPackage="mojo_services"] | 5 [DartPackage="mojo_services"] |
| 6 module mojo; | 6 module mojo; |
| 7 | 7 |
| 8 import "mojo/public/interfaces/network/url_response.mojom"; | 8 import "mojo/public/interfaces/network/url_response.mojom"; |
| 9 | 9 |
| 10 // This service allows client to efficiently cache and retrieve url response | 10 // This service allows client to efficiently cache and retrieve url response |
| 11 // content on disk. In particular, it allows the shell and content handlers to | 11 // content on disk. In particular, it allows the shell and content handlers to |
| 12 // efficiently cache and retrieve mojo applications. | 12 // efficiently cache and retrieve mojo applications. |
| 13 // TODO(qsr): At the moment, the url response disk cache only handles ETag. If | 13 // TODO(qsr): At the moment, the url response disk cache only handles ETag. If |
| 14 // either the cached version or the given response do not contain | 14 // either the cached version or the given response do not contain |
| 15 // ETags, the entry will be invalidated. It should be extended to | 15 // ETags, the entry will be invalidated. It should be extended to |
| 16 // handle all the other http cache mechanisms for better performance | 16 // handle all the other http cache mechanisms for better performance |
| 17 // with http servers that do not support ETags. | 17 // with http servers that do not support ETags. |
| 18 [ServiceName="mojo::URLResponseDiskCache"] | 18 [ServiceName="mojo::URLResponseDiskCache"] |
| 19 interface URLResponseDiskCache { | 19 interface URLResponseDiskCache { |
| 20 // Given an URL, returns a tuple. If the |url| is not in the cache, all the |
| 21 // response parameters are null. Otherwise |response| is the cached response |
| 22 // stripped of the body, |file_path| is a file containing the body of the |
| 23 // response and |cache_dir_path| is a directory that the applicaton can use |
| 24 // to store content. This service guarantee that |cache_dir_path| will be |
| 25 // emptied when |file_path| content changes. For example, a content handler |
| 26 // that is backed by a VM that compiles files could have the VM use this |
| 27 // directory to cache the compiled files. After |Get| has been called and a |
| 28 // response is returned, the caller must call |Validate| or |Update| to |
| 29 // revalidate the entry. If this is not done, a future call to |Get| may |
| 30 // return null. |
| 31 Get(string url) |
| 32 => (mojo.URLResponse? response, |
| 33 array<uint8>? file_path, |
| 34 array<uint8>? cache_dir_path); |
| 20 | 35 |
| 21 // Given an URL, returns a tuple. If the |url| is not in the cache, all the | 36 // Validate the cache for the given |url|. This will enforce that |Get| will |
| 22 // response parameters are null. Otherwise |response| is the cached response | 37 // return an entry if it exists. |
| 23 // stripped of the body, |file_path| is a file containing the body of the | 38 Validate(string url); |
| 24 // response and |cache_dir_path| is a directory that the applicaton can use | |
| 25 // to store content. This service guarantee that |cache_dir_path| will be | |
| 26 // emptied when |file_path| content changes. For example, a content handler | |
| 27 // that is backed by a VM that compiles files could have the VM use this | |
| 28 // directory to cache the compiled files. After |Get| has been called and a | |
| 29 // response is returned, the caller must call |Validate| or |Update| to | |
| 30 // revalidate the entry. If this is not done, a future call to |Get| may | |
| 31 // return null. | |
| 32 Get(string url) => (mojo.URLResponse? response, | |
| 33 array<uint8>? file_path, | |
| 34 array<uint8>? cache_dir_path); | |
| 35 | 39 |
| 36 // Validate the cache for the given |url|. This will enforce that |Get| will | 40 // Update the cache with the given response. |
| 37 // return an entry if it exists. | 41 Update(mojo.URLResponse response); |
| 38 Validate(string url); | |
| 39 | 42 |
| 40 // Update the cache with the given response. | 43 // Given a URLResponse, updates the cache and returns a pair of paths. |
| 41 Update(mojo.URLResponse response); | 44 // |file_path| is a file containing the body of the response. |
| 45 // |cache_dir_path| is a directory that the applicaton can use to store |
| 46 // content. This service guarantee that |cache_dir_path| will be emptied |
| 47 // when |file_path| content changes. For example, a content handler that is |
| 48 // backed by a VM that compiles files could have the VM use this directory |
| 49 // to cache the compiled files. |
| 50 UpdateAndGet(mojo.URLResponse response) |
| 51 => (array<uint8>? file_path, array<uint8>? cache_dir_path); |
| 42 | 52 |
| 43 // Given a URLResponse, updates the cache and returns a pair of paths. | 53 // Given a URLResponse that is expected to have a zipped body, updates the |
| 44 // |file_path| is a file containing the body of the response. | 54 // cache and returns a pair of paths. |extracted_dir_path| is a directory |
| 45 // |cache_dir_path| is a directory that the applicaton can use to store | 55 // containing the unzipped body of the response. |cache_dir_path| is a |
| 46 // content. This service guarantee that |cache_dir_path| will be emptied | 56 // directory that the applicaton can use to store content. This service |
| 47 // when |file_path| content changes. For example, a content handler that is | 57 // guarantee that |cache_dir_path| will be emptied when |extracted_dir_path| |
| 48 // backed by a VM that compiles files could have the VM use this directory | 58 // content changes. |
| 49 // to cache the compiled files. | 59 UpdateAndGetExtracted(mojo.URLResponse response) |
| 50 UpdateAndGet(mojo.URLResponse response) => | 60 => (array<uint8>? extracted_dir_path, array<uint8>? cache_dir_path); |
| 51 (array<uint8>? file_path, array<uint8>? cache_dir_path); | |
| 52 | |
| 53 // Given a URLResponse that is expected to have a zipped body, updates the | |
| 54 // cache and returns a pair of paths. |extracted_dir_path| is a directory | |
| 55 // containing the unzipped body of the response. |cache_dir_path| is a | |
| 56 // directory that the applicaton can use to store content. This service | |
| 57 // guarantee that |cache_dir_path| will be emptied when |extracted_dir_path| | |
| 58 // content changes. | |
| 59 UpdateAndGetExtracted(mojo.URLResponse response) => | |
| 60 (array<uint8>? extracted_dir_path, array<uint8>? cache_dir_path); | |
| 61 }; | 61 }; |
| OLD | NEW |