1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
|
// Copyright 2011 The Closure Library Authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS-IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
/**
* @fileoverview Provides factory methods for selecting the best storage
* mechanism, depending on availability and needs.
*
*/
goog.provide('goog.storage.mechanism.mechanismfactory');
goog.require('goog.storage.mechanism.HTML5LocalStorage');
goog.require('goog.storage.mechanism.HTML5SessionStorage');
goog.require('goog.storage.mechanism.IEUserData');
goog.require('goog.storage.mechanism.IterableMechanism');
goog.require('goog.storage.mechanism.PrefixedMechanism');
/**
* The key to shared userData storage.
* @type {string}
*/
goog.storage.mechanism.mechanismfactory.USER_DATA_SHARED_KEY =
'UserDataSharedStore';
/**
* Returns the best local storage mechanism, or null if unavailable.
* Local storage means that the database is placed on user's computer.
* The key-value database is normally shared between all the code paths
* that request it, so using an optional namespace is recommended. This
* provides separation and makes key collisions unlikely.
*
* @param {string=} opt_namespace Restricts the visibility to given namespace.
* @return {goog.storage.mechanism.IterableMechanism} Created mechanism or null.
*/
goog.storage.mechanism.mechanismfactory.create = function(opt_namespace) {
var factory = goog.storage.mechanism.mechanismfactory;
return factory.createHTML5LocalStorage(opt_namespace) ||
factory.createIEUserData(opt_namespace);
};
/**
* Returns an HTML5 local storage mechanism, or null if unavailable.
* Since the HTML5 local storage does not support namespaces natively,
* and the key-value database is shared between all the code paths
* that request it, it is recommended that an optional namespace is
* used to provide key separation employing a prefix.
*
* @param {string=} opt_namespace Restricts the visibility to given namespace.
* @return {goog.storage.mechanism.IterableMechanism} Created mechanism or null.
*/
goog.storage.mechanism.mechanismfactory.createHTML5LocalStorage = function(
opt_namespace) {
var storage = new goog.storage.mechanism.HTML5LocalStorage();
if (storage.isAvailable()) {
return opt_namespace ? new goog.storage.mechanism.PrefixedMechanism(
storage, opt_namespace) : storage;
}
return null;
};
/**
* Returns an HTML5 session storage mechanism, or null if unavailable.
* Since the HTML5 session storage does not support namespaces natively,
* and the key-value database is shared between all the code paths
* that request it, it is recommended that an optional namespace is
* used to provide key separation employing a prefix.
*
* @param {string=} opt_namespace Restricts the visibility to given namespace.
* @return {goog.storage.mechanism.IterableMechanism} Created mechanism or null.
*/
goog.storage.mechanism.mechanismfactory.createHTML5SessionStorage = function(
opt_namespace) {
var storage = new goog.storage.mechanism.HTML5SessionStorage();
if (storage.isAvailable()) {
return opt_namespace ? new goog.storage.mechanism.PrefixedMechanism(
storage, opt_namespace) : storage;
}
return null;
};
/**
* Returns an IE userData local storage mechanism, or null if unavailable.
* Using an optional namespace is recommended to provide separation and
* avoid key collisions.
*
* @param {string=} opt_namespace Restricts the visibility to given namespace.
* @return {goog.storage.mechanism.IterableMechanism} Created mechanism or null.
*/
goog.storage.mechanism.mechanismfactory.createIEUserData = function(
opt_namespace) {
var storage = new goog.storage.mechanism.IEUserData(opt_namespace ||
goog.storage.mechanism.mechanismfactory.USER_DATA_SHARED_KEY);
if (storage.isAvailable()) {
return storage;
}
return null;
};
|